@kb-labs/marketplace-api 0.1.1

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { FastifyInstance } from 'fastify';
+import { ILogger } from '@kb-labs/core-platform';
+import { MarketplaceService } from '@kb-labs/marketplace-core';
+
+/**
+ * @module @kb-labs/marketplace-api/server
+ * Fastify server factory for marketplace service.
+ */
+
+interface CreateServerOptions {
+    service: MarketplaceService;
+    logger?: ILogger;
+    port?: number;
+    host?: string;
+}
+declare function createServer(opts: CreateServerOptions): Promise<FastifyInstance>;
+
+/**
+ * @module @kb-labs/marketplace-api/routes
+ * Register all marketplace API routes.
+ */
+
+declare function registerRoutes(server: FastifyInstance): Promise<void>;
+
+export { type CreateServerOptions, createServer, registerRoutes };

package/dist/index.js

@@ -0,0 +1,342 @@
+import Fastify from 'fastify';
+import { HttpObservabilityCollector, registerOpenAPI, createCorrelatedLogger, createServiceReadyResponse } from '@kb-labs/shared-http';
+import { randomUUID } from 'crypto';
+
+// src/server.ts
+
+// src/routes/install.ts
+function installRoute(app) {
+  app.post("/install", {
+    schema: {
+      tags: ["Marketplace"],
+      summary: "Install package(s)",
+      body: {
+        type: "object",
+        required: ["specs"],
+        properties: {
+          specs: { type: "array", items: { type: "string" } },
+          dev: { type: "boolean" }
+        }
+      }
+    }
+  }, async (request, reply) => {
+    const { specs, dev } = request.body;
+    const service = app.marketplace;
+    const result = await app.observability.observeOperation("marketplace.install", () => service.install(specs, { dev }));
+    return reply.send(result);
+  });
+}
+
+// src/routes/uninstall.ts
+function uninstallRoute(app) {
+  app.post("/uninstall", {
+    schema: {
+      tags: ["Marketplace"],
+      summary: "Uninstall package(s)",
+      body: {
+        type: "object",
+        required: ["packageIds"],
+        properties: {
+          packageIds: { type: "array", items: { type: "string" } }
+        }
+      }
+    }
+  }, async (request, reply) => {
+    const { packageIds } = request.body;
+    const service = app.marketplace;
+    await app.observability.observeOperation("marketplace.uninstall", () => service.uninstall(packageIds));
+    return reply.send({ ok: true, removed: packageIds });
+  });
+}
+
+// src/routes/update.ts
+function updateRoute(app) {
+  app.post("/update", {
+    schema: {
+      tags: ["Marketplace"],
+      summary: "Update installed package(s)",
+      body: {
+        type: "object",
+        properties: {
+          packageIds: { type: "array", items: { type: "string" } }
+        }
+      }
+    }
+  }, async (request, reply) => {
+    const { packageIds } = request.body ?? {};
+    const service = app.marketplace;
+    const result = await app.observability.observeOperation("marketplace.update", () => service.update(packageIds));
+    return reply.send(result);
+  });
+}
+
+// src/routes/list.ts
+function listRoute(app) {
+  app.get("/list", {
+    schema: {
+      tags: ["Marketplace"],
+      summary: "List installed packages",
+      querystring: {
+        type: "object",
+        properties: {
+          kind: { type: "string" }
+        }
+      }
+    }
+  }, async (request, reply) => {
+    const { kind } = request.query;
+    const service = app.marketplace;
+    const entries = await app.observability.observeOperation(
+      "marketplace.list",
+      () => service.list(kind ? { kind } : void 0)
+    );
+    return reply.send({ entries, total: entries.length });
+  });
+}
+
+// src/routes/enable-disable.ts
+function enableDisableRoute(app) {
+  app.post("/enable", {
+    schema: {
+      tags: ["Marketplace"],
+      summary: "Enable a package",
+      body: {
+        type: "object",
+        required: ["packageId"],
+        properties: {
+          packageId: { type: "string" }
+        }
+      }
+    }
+  }, async (request, reply) => {
+    const { packageId } = request.body;
+    const service = app.marketplace;
+    await app.observability.observeOperation("marketplace.enable", () => service.enable(packageId));
+    return reply.send({ ok: true, packageId, enabled: true });
+  });
+  app.post("/disable", {
+    schema: {
+      tags: ["Marketplace"],
+      summary: "Disable a package",
+      body: {
+        type: "object",
+        required: ["packageId"],
+        properties: {
+          packageId: { type: "string" }
+        }
+      }
+    }
+  }, async (request, reply) => {
+    const { packageId } = request.body;
+    const service = app.marketplace;
+    await app.observability.observeOperation("marketplace.disable", () => service.disable(packageId));
+    return reply.send({ ok: true, packageId, enabled: false });
+  });
+}
+
+// src/routes/link-unlink.ts
+function linkUnlinkRoute(app) {
+  app.post("/link", {
+    schema: {
+      tags: ["Marketplace"],
+      summary: "Link a local package for development",
+      body: {
+        type: "object",
+        required: ["path"],
+        properties: {
+          path: { type: "string" }
+        }
+      }
+    }
+  }, async (request, reply) => {
+    const { path } = request.body;
+    const service = app.marketplace;
+    const result = await app.observability.observeOperation("marketplace.link", () => service.link(path));
+    return reply.send({ ok: true, ...result });
+  });
+  app.post("/unlink", {
+    schema: {
+      tags: ["Marketplace"],
+      summary: "Unlink a package",
+      body: {
+        type: "object",
+        required: ["packageId"],
+        properties: {
+          packageId: { type: "string" }
+        }
+      }
+    }
+  }, async (request, reply) => {
+    const { packageId } = request.body;
+    const service = app.marketplace;
+    await app.observability.observeOperation("marketplace.unlink", () => service.unlink(packageId));
+    return reply.send({ ok: true, packageId });
+  });
+}
+
+// src/routes/doctor.ts
+function doctorRoute(app) {
+  app.get("/doctor", {
+    schema: {
+      tags: ["Marketplace"],
+      summary: "Diagnose marketplace health"
+    }
+  }, async (_request, reply) => {
+    const service = app.marketplace;
+    const report = await app.observability.observeOperation("marketplace.doctor", () => service.doctor());
+    return reply.send(report);
+  });
+}
+
+// src/routes/sync.ts
+function syncRoute(app) {
+  app.post("/sync", {
+    schema: {
+      tags: ["Marketplace"],
+      summary: "Sync workspace \u2014 scan for plugins/adapters and populate lock",
+      body: {
+        type: "object",
+        required: ["include"],
+        properties: {
+          include: { type: "array", items: { type: "string" }, description: "Glob patterns to scan (relative to workspace root)" },
+          exclude: { type: "array", items: { type: "string" }, description: "Optional patterns to skip" },
+          autoEnable: { type: "boolean", description: "Enable new entries (default: false, safe for prod)" }
+        }
+      }
+    }
+  }, async (request, reply) => {
+    const body = request.body;
+    const result = await app.observability.observeOperation("marketplace.sync", () => app.marketplace.sync(body));
+    return reply.send(result);
+  });
+}
+
+// src/routes/index.ts
+async function registerRoutes(server) {
+  await server.register(async (app) => {
+    installRoute(app);
+    uninstallRoute(app);
+    updateRoute(app);
+    listRoute(app);
+    enableDisableRoute(app);
+    linkUnlinkRoute(app);
+    doctorRoute(app);
+    syncRoute(app);
+  }, { prefix: "/api/v1/marketplace" });
+}
+var DEFAULT_PORT = 5070;
+function createFallbackLogger() {
+  const child = (_bindings) => createFallbackLogger();
+  return {
+    trace: () => {
+    },
+    debug: () => {
+    },
+    info: () => {
+    },
+    warn: () => {
+    },
+    error: () => {
+    },
+    fatal: () => {
+    },
+    child
+  };
+}
+async function createServer(opts) {
+  const port = opts.port ?? DEFAULT_PORT;
+  const logger = opts.logger ?? createFallbackLogger();
+  const observability = new HttpObservabilityCollector({
+    serviceId: "marketplace",
+    serviceType: "http-api",
+    version: "0.1.0",
+    logsSource: "marketplace"
+  });
+  const server = Fastify({
+    logger: false
+    // using platform.logger
+  });
+  await registerOpenAPI(server, {
+    title: "KB Labs Marketplace",
+    version: "0.1.0",
+    description: "Unified marketplace for plugins, adapters, workflows, and more",
+    servers: [
+      { url: `http://localhost:${port}`, description: "Local dev" }
+    ],
+    ui: process.env.NODE_ENV !== "production"
+  });
+  server.decorate("marketplace", opts.service);
+  server.decorate("observability", observability);
+  observability.register(server);
+  server.addHook("onRequest", async (request, reply) => {
+    const requestId = request.headers["x-request-id"] || randomUUID();
+    const traceId = request.headers["x-trace-id"] || randomUUID();
+    request.id = requestId;
+    reply.header("X-Request-Id", requestId);
+    reply.header("X-Trace-Id", traceId);
+    request.kbLogger = createCorrelatedLogger(logger, {
+      serviceId: "marketplace",
+      logsSource: "marketplace",
+      layer: "marketplace",
+      service: "request",
+      requestId,
+      traceId,
+      method: request.method,
+      url: request.url,
+      operation: "http.request"
+    });
+    request.kbLogger.info(`\u2192 ${request.method.toUpperCase()} ${request.url}`);
+  });
+  server.addHook("onResponse", async (request, reply) => {
+    const logger2 = request.kbLogger;
+    if (!logger2) {
+      return;
+    }
+    logger2.info(`\u2713 ${request.method.toUpperCase()} ${request.url} ${reply.statusCode}`, {
+      statusCode: reply.statusCode
+    });
+  });
+  server.get("/health", async () => ({
+    status: "ok",
+    service: "marketplace",
+    ts: Date.now()
+  }));
+  server.get(
+    "/ready",
+    async () => createServiceReadyResponse({
+      ready: true,
+      components: {
+        marketplaceService: {
+          ready: true
+        }
+      }
+    })
+  );
+  server.get("/metrics", async (_request, reply) => {
+    reply.header("Content-Type", "text/plain; version=0.0.4; charset=utf-8");
+    return observability.renderPrometheusMetrics("healthy");
+  });
+  server.get("/observability/describe", async () => observability.buildDescribe());
+  server.get(
+    "/observability/health",
+    async () => observability.buildHealth({
+      status: "healthy",
+      checks: [
+        {
+          id: "marketplace-service",
+          status: "ok",
+          message: "Marketplace service registered"
+        }
+      ],
+      meta: {
+        serviceHealthEndpoint: "/health"
+      }
+    })
+  );
+  await observability.observeOperation("marketplace.bootstrap", () => registerRoutes(server));
+  return server;
+}
+
+export { createServer, registerRoutes };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/routes/install.ts","../src/routes/uninstall.ts","../src/routes/update.ts","../src/routes/list.ts","../src/routes/enable-disable.ts","../src/routes/link-unlink.ts","../src/routes/doctor.ts","../src/routes/sync.ts","../src/routes/index.ts","../src/server.ts"],"names":["logger"],"mappings":"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","file":"index.js","sourcesContent":["import '../types.js';\nimport type { FastifyInstance } from 'fastify';\n\nexport function installRoute(app: FastifyInstance): void {\n  app.post('/install', {\n    schema: {\n      tags: ['Marketplace'],\n      summary: 'Install package(s)',\n      body: {\n        type: 'object',\n        required: ['specs'],\n        properties: {\n          specs: { type: 'array', items: { type: 'string' } },\n          dev: { type: 'boolean' },\n        },\n      },\n    },\n  }, async (request, reply) => {\n    const { specs, dev } = request.body as { specs: string[]; dev?: boolean };\n    const service = app.marketplace;\n    const result = await app.observability.observeOperation('marketplace.install', () => service.install(specs, { dev }));\n    return reply.send(result);\n  });\n}\n","import '../types.js';\nimport type { FastifyInstance } from 'fastify';\n\nexport function uninstallRoute(app: FastifyInstance): void {\n  app.post('/uninstall', {\n    schema: {\n      tags: ['Marketplace'],\n      summary: 'Uninstall package(s)',\n      body: {\n        type: 'object',\n        required: ['packageIds'],\n        properties: {\n          packageIds: { type: 'array', items: { type: 'string' } },\n        },\n      },\n    },\n  }, async (request, reply) => {\n    const { packageIds } = request.body as { packageIds: string[] };\n    const service = app.marketplace;\n    await app.observability.observeOperation('marketplace.uninstall', () => service.uninstall(packageIds));\n    return reply.send({ ok: true, removed: packageIds });\n  });\n}\n","import '../types.js';\nimport type { FastifyInstance } from 'fastify';\n\nexport function updateRoute(app: FastifyInstance): void {\n  app.post('/update', {\n    schema: {\n      tags: ['Marketplace'],\n      summary: 'Update installed package(s)',\n      body: {\n        type: 'object',\n        properties: {\n          packageIds: { type: 'array', items: { type: 'string' } },\n        },\n      },\n    },\n  }, async (request, reply) => {\n    const { packageIds } = (request.body as { packageIds?: string[] }) ?? {};\n    const service = app.marketplace;\n    const result = await app.observability.observeOperation('marketplace.update', () => service.update(packageIds));\n    return reply.send(result);\n  });\n}\n","import '../types.js';\nimport type { FastifyInstance } from 'fastify';\nimport type { EntityKind } from '@kb-labs/core-discovery';\n\nexport function listRoute(app: FastifyInstance): void {\n  app.get('/list', {\n    schema: {\n      tags: ['Marketplace'],\n      summary: 'List installed packages',\n      querystring: {\n        type: 'object',\n        properties: {\n          kind: { type: 'string' },\n        },\n      },\n    },\n  }, async (request, reply) => {\n    const { kind } = request.query as { kind?: string };\n    const service = app.marketplace;\n    const entries = await app.observability.observeOperation(\n      'marketplace.list',\n      () => service.list(kind ? { kind: kind as EntityKind } : undefined),\n    );\n    return reply.send({ entries, total: entries.length });\n  });\n}\n","import '../types.js';\nimport type { FastifyInstance } from 'fastify';\n\nexport function enableDisableRoute(app: FastifyInstance): void {\n  app.post('/enable', {\n    schema: {\n      tags: ['Marketplace'],\n      summary: 'Enable a package',\n      body: {\n        type: 'object',\n        required: ['packageId'],\n        properties: {\n          packageId: { type: 'string' },\n        },\n      },\n    },\n  }, async (request, reply) => {\n    const { packageId } = request.body as { packageId: string };\n    const service = app.marketplace;\n    await app.observability.observeOperation('marketplace.enable', () => service.enable(packageId));\n    return reply.send({ ok: true, packageId, enabled: true });\n  });\n\n  app.post('/disable', {\n    schema: {\n      tags: ['Marketplace'],\n      summary: 'Disable a package',\n      body: {\n        type: 'object',\n        required: ['packageId'],\n        properties: {\n          packageId: { type: 'string' },\n        },\n      },\n    },\n  }, async (request, reply) => {\n    const { packageId } = request.body as { packageId: string };\n    const service = app.marketplace;\n    await app.observability.observeOperation('marketplace.disable', () => service.disable(packageId));\n    return reply.send({ ok: true, packageId, enabled: false });\n  });\n}\n","import '../types.js';\nimport type { FastifyInstance } from 'fastify';\n\nexport function linkUnlinkRoute(app: FastifyInstance): void {\n  app.post('/link', {\n    schema: {\n      tags: ['Marketplace'],\n      summary: 'Link a local package for development',\n      body: {\n        type: 'object',\n        required: ['path'],\n        properties: {\n          path: { type: 'string' },\n        },\n      },\n    },\n  }, async (request, reply) => {\n    const { path } = request.body as { path: string };\n    const service = app.marketplace;\n    const result = await app.observability.observeOperation('marketplace.link', () => service.link(path));\n    return reply.send({ ok: true, ...result });\n  });\n\n  app.post('/unlink', {\n    schema: {\n      tags: ['Marketplace'],\n      summary: 'Unlink a package',\n      body: {\n        type: 'object',\n        required: ['packageId'],\n        properties: {\n          packageId: { type: 'string' },\n        },\n      },\n    },\n  }, async (request, reply) => {\n    const { packageId } = request.body as { packageId: string };\n    const service = app.marketplace;\n    await app.observability.observeOperation('marketplace.unlink', () => service.unlink(packageId));\n    return reply.send({ ok: true, packageId });\n  });\n}\n","import '../types.js';\nimport type { FastifyInstance } from 'fastify';\n\nexport function doctorRoute(app: FastifyInstance): void {\n  app.get('/doctor', {\n    schema: {\n      tags: ['Marketplace'],\n      summary: 'Diagnose marketplace health',\n    },\n  }, async (_request, reply) => {\n    const service = app.marketplace;\n    const report = await app.observability.observeOperation('marketplace.doctor', () => service.doctor());\n    return reply.send(report);\n  });\n}\n","import '../types.js';\nimport type { FastifyInstance } from 'fastify';\n\nexport function syncRoute(app: FastifyInstance): void {\n  app.post('/sync', {\n    schema: {\n      tags: ['Marketplace'],\n      summary: 'Sync workspace — scan for plugins/adapters and populate lock',\n      body: {\n        type: 'object',\n        required: ['include'],\n        properties: {\n          include: { type: 'array', items: { type: 'string' }, description: 'Glob patterns to scan (relative to workspace root)' },\n          exclude: { type: 'array', items: { type: 'string' }, description: 'Optional patterns to skip' },\n          autoEnable: { type: 'boolean', description: 'Enable new entries (default: false, safe for prod)' },\n        },\n      },\n    },\n  }, async (request, reply) => {\n    const body = request.body as {\n      include: string[];\n      exclude?: string[];\n      autoEnable?: boolean;\n    };\n    const result = await app.observability.observeOperation('marketplace.sync', () => app.marketplace.sync(body));\n    return reply.send(result);\n  });\n}\n","/**\n * @module @kb-labs/marketplace-api/routes\n * Register all marketplace API routes.\n */\n\nimport type { FastifyInstance } from 'fastify';\nimport { installRoute } from './install.js';\nimport { uninstallRoute } from './uninstall.js';\nimport { updateRoute } from './update.js';\nimport { listRoute } from './list.js';\nimport { enableDisableRoute } from './enable-disable.js';\nimport { linkUnlinkRoute } from './link-unlink.js';\nimport { doctorRoute } from './doctor.js';\nimport { syncRoute } from './sync.js';\n\nexport async function registerRoutes(server: FastifyInstance): Promise<void> {\n  await server.register(async (app) => {\n    installRoute(app);\n    uninstallRoute(app);\n    updateRoute(app);\n    listRoute(app);\n    enableDisableRoute(app);\n    linkUnlinkRoute(app);\n    doctorRoute(app);\n    syncRoute(app);\n  }, { prefix: '/api/v1/marketplace' });\n}\n","/**\n * @module @kb-labs/marketplace-api/server\n * Fastify server factory for marketplace service.\n */\n\nimport Fastify, { type FastifyInstance } from 'fastify';\nimport {\n  createCorrelatedLogger,\n  HttpObservabilityCollector,\n  createServiceReadyResponse,\n  registerOpenAPI,\n} from '@kb-labs/shared-http';\nimport type { ILogger } from '@kb-labs/core-platform';\nimport { registerRoutes } from './routes/index.js';\nimport type { MarketplaceService } from '@kb-labs/marketplace-core';\nimport { randomUUID } from 'node:crypto';\n\nconst DEFAULT_PORT = 5070;\n\nfunction createFallbackLogger(): ILogger {\n  const child = (_bindings: Record<string, unknown>): ILogger => createFallbackLogger();\n  return {\n    trace: () => {},\n    debug: () => {},\n    info: () => {},\n    warn: () => {},\n    error: () => {},\n    fatal: () => {},\n    child,\n  };\n}\n\nexport interface CreateServerOptions {\n  service: MarketplaceService;\n  logger?: ILogger;\n  port?: number;\n  host?: string;\n}\n\nexport async function createServer(opts: CreateServerOptions): Promise<FastifyInstance> {\n  const port = opts.port ?? DEFAULT_PORT;\n  const logger = opts.logger ?? createFallbackLogger();\n  const observability = new HttpObservabilityCollector({\n    serviceId: 'marketplace',\n    serviceType: 'http-api',\n    version: '0.1.0',\n    logsSource: 'marketplace',\n  });\n  const server = Fastify({\n    logger: false, // using platform.logger\n  });\n\n  // OpenAPI docs\n  await registerOpenAPI(server, {\n    title: 'KB Labs Marketplace',\n    version: '0.1.0',\n    description: 'Unified marketplace for plugins, adapters, workflows, and more',\n    servers: [\n      { url: `http://localhost:${port}`, description: 'Local dev' },\n    ],\n    ui: process.env.NODE_ENV !== 'production',\n  });\n\n  // Decorate with service instance\n  server.decorate('marketplace', opts.service);\n  server.decorate('observability', observability);\n  observability.register(server);\n\n  server.addHook('onRequest', async (request, reply) => {\n    const requestId = (request.headers['x-request-id'] as string | undefined) || randomUUID();\n    const traceId = (request.headers['x-trace-id'] as string | undefined) || randomUUID();\n\n    request.id = requestId;\n    reply.header('X-Request-Id', requestId);\n    reply.header('X-Trace-Id', traceId);\n\n    (request as any).kbLogger = createCorrelatedLogger(logger, {\n      serviceId: 'marketplace',\n      logsSource: 'marketplace',\n      layer: 'marketplace',\n      service: 'request',\n      requestId,\n      traceId,\n      method: request.method,\n      url: request.url,\n      operation: 'http.request',\n    });\n    (request as any).kbLogger.info(`→ ${request.method.toUpperCase()} ${request.url}`);\n  });\n\n  server.addHook('onResponse', async (request, reply) => {\n    const logger = (request as any).kbLogger as { info: (message: string, meta?: Record<string, unknown>) => void } | undefined;\n    if (!logger) {\n      return;\n    }\n\n    logger.info(`✓ ${request.method.toUpperCase()} ${request.url} ${reply.statusCode}`, {\n      statusCode: reply.statusCode,\n    });\n  });\n\n  server.get('/health', async () => ({\n    status: 'ok',\n    service: 'marketplace',\n    ts: Date.now(),\n  }));\n\n  server.get('/ready', async () =>\n    createServiceReadyResponse({\n      ready: true,\n      components: {\n        marketplaceService: {\n          ready: true,\n        },\n      },\n    })\n  );\n\n  server.get('/metrics', async (_request, reply) => {\n    reply.header('Content-Type', 'text/plain; version=0.0.4; charset=utf-8');\n    return observability.renderPrometheusMetrics('healthy');\n  });\n\n  server.get('/observability/describe', async () => observability.buildDescribe());\n\n  server.get('/observability/health', async () =>\n    observability.buildHealth({\n      status: 'healthy',\n      checks: [\n        {\n          id: 'marketplace-service',\n          status: 'ok',\n          message: 'Marketplace service registered',\n        },\n      ],\n      meta: {\n        serviceHealthEndpoint: '/health',\n      },\n    })\n  );\n\n  // Register routes\n  await observability.observeOperation('marketplace.bootstrap', () => registerRoutes(server));\n\n  return server;\n}\n"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@kb-labs/marketplace-api",
+  "version": "0.1.1",
+  "description": "Fastify routes for KB Labs marketplace service",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "vitest run --passWithNoTests -c ../../vitest.config.ts"
+  },
+  "dependencies": {
+    "@kb-labs/core-contracts": "^1.5.0",
+    "@kb-labs/core-discovery": "^1.5.0",
+    "@kb-labs/core-platform": "^1.5.0",
+    "@kb-labs/marketplace-contracts": "^0.1.1",
+    "@kb-labs/marketplace-core": "^0.1.1",
+    "@kb-labs/shared-http": "^1.3.0",
+    "fastify": "^5.3.3",
+    "@fastify/swagger": ">=9.5.1",
+    "@fastify/swagger-ui": "^5.2.0",
+    "fastify-type-provider-zod": "^6.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "vitest": "^3.2.4",
+    "@kb-labs/devkit": "link:../../../../infra/kb-labs-devkit",
+    "@types/node": "^24.3.3"
+  }
+}