Add `extensions/v1` API service backed by Cloudflare D1 by admdly · Pull Request #132 · FOSSBilling/api

admdly · 2026-06-25T16:38:02Z

Migrates the 4 extension registry endpoints from fossbilling/extension-directory into this Hono Worker, making api.fossbilling.net the canonical host for all FOSSBilling APIs.

New endpoints:
GET /extensions/v1/list[?type=...] → Extension[]
GET /extensions/v1/:id → Extension
GET /extensions/v1/:id/version → plain-text semver tag
GET /extensions/v1/:id/badges/:type → image/svg+xml badge

Data is stored in a new D1 database (DB_EXTENSIONS). Nested fields (releases, license, source) are serialised as JSON TEXT.

Migrates the 4 extension registry endpoints from fossbilling/extension-directory into this Hono Worker, making api.fossbilling.net the canonical host for all FOSSBilling APIs. New endpoints: GET /extensions/v1/list[?type=...] → Extension[] GET /extensions/v1/:id → Extension GET /extensions/v1/:id/version → plain-text semver tag GET /extensions/v1/:id/badges/:type → image/svg+xml badge Data is stored in a new D1 database (DB_EXTENSIONS). Nested fields (author, releases, license, source) are serialised as JSON TEXT. A one-shot seed script at src/services/extensions/v1/scripts/seed-db.ts populates the database from the existing TypeScript data. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AHT7incwQNb5yWbCNwi2a2

Replaces the placeholder UUID for DB_EXTENSIONS with the real Cloudflare D1 database ID (c81c21db-2b8b-40da-9ad5-9eda5ec24015, database: extensions_data). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AHT7incwQNb5yWbCNwi2a2

Auto-generated by seed-db.ts from extensions-data.ts. Contains INSERT OR REPLACE statements for all 15 extensions in the registry. Used as the reference seed file; remote execution was performed directly via the Cloudflare D1 MCP connector. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AHT7incwQNb5yWbCNwi2a2

- Add `authors` table to schema with id, type, name, url columns - Change `extensions.author` JSON column to `author_id` FK referencing authors(id) - Add idx_extensions_author index - Update database.ts to JOIN authors on SELECT queries and build Author object from joined columns instead of parsing embedded JSON - Update seed-db.ts to insert authors first then use author_id in extensions - Regenerate seed.sql with new schema (12 authors + 15 extensions) - Re-seed D1 remote database with normalized data Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AHT7incwQNb5yWbCNwi2a2

authors-data.ts, extensions-data.ts, seed-db.ts, and seed.sql were one-time migration artifacts. D1 is now authoritative; schema.sql remains as the canonical DDL for recreating the database structure. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AHT7incwQNb5yWbCNwi2a2

Add argsIgnorePattern/varsIgnorePattern to globally ignore _-prefixed identifiers, which is the conventional TypeScript pattern for intentionally unused parameters. Remove now-redundant eslint-disable-next-line comments from d1-mock.ts. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AHT7incwQNb5yWbCNwi2a2

Update testExtensions rows to use the new JOIN-based column layout (author_id, author_type, author_name, author_url instead of the old author JSON blob), and update query string matching to use the aliased column references (e.type, LOWER(e.id)) that the new SELECT uses. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AHT7incwQNb5yWbCNwi2a2

…de adapter NOT_FOUND errors from getExtensionById now produce HTTP 404 instead of 500 across all three /:id route handlers. The node platform adapter also lacked DB_EXTENSIONS in its databases map, causing an immediate throw on any extensions route in non-Cloudflare environments; wired in createDefaultAdapter() to match the existing pattern used by other services. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AHT7incwQNb5yWbCNwi2a2

cloudflare-workers-and-pages · 2026-06-25T16:38:08Z

Deploying with Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	api	`a7af245`	Commit Preview URL Branch Preview URL	Jun 25 2026, 04:47 PM

The createNodeBindings test was asserting databases equals {} but the adapter now includes DB_EXTENSIONS. Updated assertion to verify the key exists and holds a SQLiteAdapter instance. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AHT7incwQNb5yWbCNwi2a2

Copilot

Pull request overview

Adds a new extensions/v1 service to the Hono worker, intended to make api.fossbilling.net the canonical host for the extension registry API, backed by a new Cloudflare D1 binding.

Changes:

Introduces src/services/extensions/v1 with list/detail/version/badge endpoints and a small DB access layer + schema.
Wires the new service into the worker router and Cloudflare/Node platform bindings (DB_EXTENSIONS), and adds badge-maker dependency.
Adds a dedicated Vitest suite for the new endpoints and updates ESLint unused-vars handling (underscore-prefixed args/vars).

Reviewed changes

Copilot reviewed 13 out of 15 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
wrangler.jsonc	Adds the `DB_EXTENSIONS` D1 binding configuration.
worker-configuration.d.ts	Regenerates Wrangler/workerd types to include `DB_EXTENSIONS` in bindings.
eslint.config.ts	Configures `@typescript-eslint/no-unused-vars` to ignore underscore-prefixed args/vars.
src/app/index.ts	Routes `/extensions/v1` to the new extensions service.
src/lib/adapters/cloudflare/index.ts	Exposes `DB_EXTENSIONS` via the Cloudflare D1 adapter.
src/lib/adapters/node/index.ts	Adds a default Node `DB_EXTENSIONS` database binding (in-memory SQLite adapter).
src/services/extensions/v1/index.ts	Implements the new extensions API endpoints, including badge rendering.
src/services/extensions/v1/interfaces.ts	Defines extension/release domain types and semver-based helpers.
src/services/extensions/v1/database.ts	Implements SQL access + row parsing for extensions.
src/services/extensions/v1/db/schema.sql	Defines the D1 schema for authors/extensions tables and indexes.
test/services/extensions/v1/index.test.ts	Adds endpoint-level tests for list/detail/version/badges behavior.
test/utils/d1-mock.ts	Removes now-unneeded eslint disable comments (underscore args).
package.json	Adds `badge-maker` dependency.
package-lock.json	Locks `badge-maker` and its transitive dependencies.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

admdly · 2026-06-25T16:53:40Z

@codex review

chatgpt-codex-connector · 2026-06-25T16:59:43Z

Codex Review: Didn't find any major issues. You're on a roll.

Reviewed commit: a7af245baa

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

claude added 8 commits June 25, 2026 01:38

Copilot AI review requested due to automatic review settings June 25, 2026 16:38

Copilot started reviewing on behalf of admdly June 25, 2026 16:38 View session

Copilot AI reviewed Jun 25, 2026

View reviewed changes

Comment thread src/lib/adapters/node/index.ts

Comment thread src/services/extensions/v1/db/schema.sql

Comment thread src/services/extensions/v1/database.ts

Comment thread src/services/extensions/v1/interfaces.ts

admdly and others added 2 commits June 25, 2026 18:46

Fix for pull request finding

e786644

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Fix for pull request finding

a7af245

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

Copilot started work on behalf of admdly June 25, 2026 16:51 View session

Copilot finished work on behalf of admdly June 25, 2026 16:52

admdly changed the title ~~feat: add extensions/v1 API service backed by Cloudflare D1~~ Add extensions/v1 API service backed by Cloudflare D1 Jun 25, 2026

admdly merged commit 3359fe3 into main Jun 25, 2026
9 checks passed

admdly deleted the claude/extension-api-migration-o14xey branch June 25, 2026 18:34

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Add `extensions/v1` API service backed by Cloudflare D1#132

Add `extensions/v1` API service backed by Cloudflare D1#132
admdly merged 11 commits into
mainfrom
claude/extension-api-migration-o14xey

admdly commented Jun 25, 2026 •

edited

Loading

Uh oh!

cloudflare-workers-and-pages Bot commented Jun 25, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

admdly commented Jun 25, 2026

Uh oh!

chatgpt-codex-connector Bot commented Jun 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Uh oh!

Uh oh!

Conversation

admdly commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

cloudflare-workers-and-pages Bot commented Jun 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying with Cloudflare Workers

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

admdly commented Jun 25, 2026

Uh oh!

chatgpt-codex-connector Bot commented Jun 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

admdly commented Jun 25, 2026 •

edited

Loading

cloudflare-workers-and-pages Bot commented Jun 25, 2026 •

edited

Loading