@apollo-deploy/tesseract 0.4.4 → 0.5.1

package/dist/fastify.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Tesseract Fastify integration.
+ *
+ * Provides a Fastify plugin that collects annotated routes at runtime and
+ * generates an SDK when triggered by `TESSERACT_GENERATE=1`.
+ *
+ * ```ts
+ * // app.ts
+ * import { tesseractPlugin } from '@apollo-deploy/tesseract/fastify';
+ *
+ * app.register(tesseractPlugin, {
+ *   info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+ *   output: './packages/api-sdk',
+ * });
+ * ```
+ *
+ * Then run: `TESSERACT_GENERATE=1 node dist/app.js`
+ * Or via CLI: `tesseract run dist/app.js`
+ */
+import type { FastifyInstance, FastifyPluginAsync } from 'fastify';
+import type { SDKModuleConfig, SDKRouteConfig } from './types/sdk-module.js';
+declare module 'fastify' {
+    interface RouteOptions {
+        /** SDK generation configuration for this route. Sibling to `schema`. */
+        sdk?: SDKRouteConfig;
+    }
+    interface RouteShorthandOptions {
+        /** SDK generation configuration for this route. Sibling to `schema`. */
+        sdk?: SDKRouteConfig;
+    }
+}
+export interface TesseractPluginOptions {
+    /** API metadata written into the generated SDK's package.json and README. */
+    info: {
+        title: string;
+        version: string;
+        baseUrl?: string;
+        description?: string;
+    };
+    /** Output directory for the generated SDK. */
+    output: string;
+    /**
+     * Shared type package used across your backend and generated SDK.
+     *
+     * When set, bare `$ref` values in route schemas (e.g. `{ $ref: 'Deployment' }`)
+     * are treated as type names from this package. Tesseract emits
+     * `import type { Deployment } from '<name>'` instead of regenerating types.
+     *
+     * @example
+     * ```ts
+     * app.register(tesseractPlugin, {
+     *   info: { ... },
+     *   output: './packages/api-sdk',
+     *   schemaPackage: { name: '@apollo-deploy/schemas', version: '^2.1.0' },
+     * });
+     * ```
+     */
+    schemaPackage?: {
+        name: string;
+        version?: string;
+        importPath?: string;
+    };
+    /**
+     * Function to convert framework-specific schema objects to JSON Schema at generation time.
+     *
+     * Required when using `fastify-type-provider-zod` (or similar): Fastify exposes raw Zod
+     * schema objects in the `onRoute` hook, not compiled JSON Schema. Pass `toJSONSchema` from
+     * `zod` here so Tesseract can read parameter and response types correctly.
+     *
+     * @example
+     * ```ts
+     * import { toJSONSchema } from 'zod';
+     * app.register(tesseractPlugin, { ..., schemaConverter: toJSONSchema });
+     * ```
+     */
+    schemaConverter?: (schema: unknown) => unknown;
+    /**
+     * `'public'` strips routes marked `internal: true` from the SDK.
+     * `'internal'` includes all routes. Defaults to `'internal'`.
+     */
+    clientType?: 'public' | 'internal';
+    /** Override the generated npm package name. */
+    packageName?: string;
+    /** Override the generated package version. */
+    packageVersion?: string;
+    /** `'functional'` (default) or `'class'` (Resend-style `new MySDK('key')`). */
+    sdkStyle?: 'functional' | 'class';
+}
+/**
+ * Declare SDK domain metadata for the current Fastify plugin scope.
+ *
+ * Call at the top of a plugin function to name the domain and set a
+ * description. The prefix is read automatically from `fastify.prefix`.
+ *
+ * ```ts
+ * import fp from 'fastify-plugin';
+ * import { sdkDomain } from '@apollo-deploy/tesseract/fastify';
+ *
+ * export default fp(async (fastify) => {
+ *   sdkDomain(fastify, { domain: 'users', description: 'User management' });
+ *
+ *   fastify.get('/:id', {
+ *     schema: { response: { 200: UserSchema } },
+ *     config: { sdk: { methodName: 'get' } },
+ *   }, handler);
+ * });
+ * ```
+ *
+ * Not needed when using the `@SDKModule()` class decorator — it registers
+ * domain metadata automatically.
+ */
+export declare function sdkDomain(fastify: FastifyInstance, config: Omit<SDKModuleConfig, 'prefix'> & {
+    prefix?: string;
+}): void;
+/**
+ * Fastify plugin that collects SDK-annotated routes and generates an SDK
+ * when `TESSERACT_GENERATE=1` is set in the environment.
+ *
+ * Wrapped with `fastify-plugin` so the `onRoute` hook is registered at the
+ * root scope and captures routes from all sibling plugins.
+ *
+ * Register once at the application root — it is a complete no-op unless the
+ * env var is set, so it is safe to register unconditionally.
+ *
+ * ```ts
+ * import { tesseractPlugin } from '@apollo-deploy/tesseract/fastify';
+ *
+ * app.register(tesseractPlugin, {
+ *   info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+ *   output: './packages/api-sdk',
+ * });
+ * ```
+ */
+export declare const tesseractPlugin: FastifyPluginAsync<TesseractPluginOptions>;
+//# sourceMappingURL=fastify.d.ts.map

package/dist/fastify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../src/fastify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAS7E,OAAO,QAAQ,SAAS,CAAC;IACvB,UAAU,YAAY;QACpB,wEAAwE;QACxE,GAAG,CAAC,EAAE,cAAc,CAAC;KACtB;IACD,UAAU,qBAAqB;QAC7B,wEAAwE;QACxE,GAAG,CAAC,EAAE,cAAc,CAAC;KACtB;CACF;AAYD,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAC/C;;;OAGG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACnC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC;CACnC;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,IAAI,CAGN;AA6HD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,4CAG1B,CAAC"}

package/dist/fastify.js

@@ -0,0 +1,188 @@
+/**
+ * Tesseract Fastify integration.
+ *
+ * Provides a Fastify plugin that collects annotated routes at runtime and
+ * generates an SDK when triggered by `TESSERACT_GENERATE=1`.
+ *
+ * ```ts
+ * // app.ts
+ * import { tesseractPlugin } from '@apollo-deploy/tesseract/fastify';
+ *
+ * app.register(tesseractPlugin, {
+ *   info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+ *   output: './packages/api-sdk',
+ * });
+ * ```
+ *
+ * Then run: `TESSERACT_GENERATE=1 node dist/app.js`
+ * Or via CLI: `tesseract run dist/app.js`
+ */
+import fp from 'fastify-plugin';
+import { _domainRegistry } from './types/sdk-module.js';
+import { buildManifestFromRoutes } from './collector.js';
+// ── Domain registration helper ────────────────────────────────────────────────
+/**
+ * Declare SDK domain metadata for the current Fastify plugin scope.
+ *
+ * Call at the top of a plugin function to name the domain and set a
+ * description. The prefix is read automatically from `fastify.prefix`.
+ *
+ * ```ts
+ * import fp from 'fastify-plugin';
+ * import { sdkDomain } from '@apollo-deploy/tesseract/fastify';
+ *
+ * export default fp(async (fastify) => {
+ *   sdkDomain(fastify, { domain: 'users', description: 'User management' });
+ *
+ *   fastify.get('/:id', {
+ *     schema: { response: { 200: UserSchema } },
+ *     config: { sdk: { methodName: 'get' } },
+ *   }, handler);
+ * });
+ * ```
+ *
+ * Not needed when using the `@SDKModule()` class decorator — it registers
+ * domain metadata automatically.
+ */
+export function sdkDomain(fastify, config) {
+    const prefix = config.prefix ?? fastify.prefix ?? '/';
+    _domainRegistry.set(prefix, { prefix, ...config });
+}
+// ── Plugin ────────────────────────────────────────────────────────────────────
+/** Returns true if `value` is a Zod v4 schema instance. */
+function isZodSchema(value) {
+    return !!value && typeof value === 'object' && '_zod' in value;
+}
+function convertSchemaValue(value, toJSONSchema) {
+    if (isZodSchema(value)) {
+        try {
+            return toJSONSchema(value);
+        }
+        catch {
+            return value;
+        }
+    }
+    return value;
+}
+function convertRouteSchema(schema, toJSONSchema) {
+    if (!schema)
+        return schema;
+    const result = {};
+    for (const [key, val] of Object.entries(schema)) {
+        if (key === 'response' && val && typeof val === 'object') {
+            const serialized = {};
+            for (const [status, responseSchema] of Object.entries(val)) {
+                serialized[status] = convertSchemaValue(responseSchema, toJSONSchema);
+            }
+            result[key] = serialized;
+        }
+        else {
+            result[key] = convertSchemaValue(val, toJSONSchema);
+        }
+    }
+    return result;
+}
+const _tesseractPlugin = async (fastify, opts) => {
+    if (!process.env.TESSERACT_GENERATE)
+        return;
+    const collectedRoutes = [];
+    fastify.addHook('onRoute', (routeOptions) => {
+        const sdk = routeOptions.sdk;
+        if (!sdk || sdk.exclude)
+            return;
+        // Fastify auto-generates HEAD for every GET; skip to avoid duplicates.
+        const method = Array.isArray(routeOptions.method)
+            ? routeOptions.method[0]
+            : routeOptions.method;
+        if (method === 'HEAD')
+            return;
+        collectedRoutes.push({
+            url: routeOptions.url,
+            method,
+            schema: routeOptions.schema,
+            sdk,
+            sse: routeOptions.sse,
+        });
+    });
+    fastify.addHook('onReady', async () => {
+        if (collectedRoutes.length === 0) {
+            console.error('\n[tesseract] No SDK routes found. Add `sdk: { ... }` to routes or use `@SDKModule` + `sdkDomain()`.');
+            process.exit(1);
+        }
+        // Convert Zod v4 schemas to JSON Schema (dynamic import so Tesseract doesn't
+        // need zod as a hard dependency — it resolves via the host app's node_modules).
+        let resolvedRoutes = collectedRoutes;
+        const toJSONSchema = opts.schemaConverter;
+        if (typeof toJSONSchema === 'function') {
+            resolvedRoutes = collectedRoutes.map((r) => ({
+                ...r,
+                schema: convertRouteSchema(r.schema, toJSONSchema),
+            }));
+        }
+        else {
+            // Attempt automatic detection via dynamic import as fallback.
+            try {
+                const zodPkg = 'zod';
+                const zodModule = await import(zodPkg);
+                const zodConverter = zodModule.toJSONSchema;
+                if (typeof zodConverter === 'function') {
+                    resolvedRoutes = collectedRoutes.map((r) => ({
+                        ...r,
+                        schema: convertRouteSchema(r.schema, zodConverter),
+                    }));
+                }
+            }
+            catch {
+                // zod not available — schemas stay as-is (JSON Schema passed directly)
+            }
+        }
+        const manifest = buildManifestFromRoutes(resolvedRoutes, _domainRegistry, opts.info, opts.schemaPackage);
+        console.log(`\n[tesseract] ${manifest.domains.length} domain(s), ${collectedRoutes.length} route(s) → ${opts.output}`);
+        // Dynamic import keeps the generation pipeline out of the user's app bundle
+        // when TESSERACT_GENERATE is not set (the plugin returns early above).
+        try {
+            const { generate } = await import('./index.js');
+            const result = await generate({
+                manifest,
+                output: opts.output,
+                clientType: opts.clientType,
+                packageName: opts.packageName,
+                packageVersion: opts.packageVersion,
+                sdkStyle: opts.sdkStyle,
+            });
+            for (const w of result.warnings) {
+                console.warn(`  ⚠  ${w}`);
+            }
+            console.log(`[tesseract] ✓ ${result.filesWritten} files written\n`);
+            process.exit(0);
+        }
+        catch (err) {
+            console.error('[tesseract] Generation failed:', err);
+            process.exit(1);
+        }
+    });
+};
+/**
+ * Fastify plugin that collects SDK-annotated routes and generates an SDK
+ * when `TESSERACT_GENERATE=1` is set in the environment.
+ *
+ * Wrapped with `fastify-plugin` so the `onRoute` hook is registered at the
+ * root scope and captures routes from all sibling plugins.
+ *
+ * Register once at the application root — it is a complete no-op unless the
+ * env var is set, so it is safe to register unconditionally.
+ *
+ * ```ts
+ * import { tesseractPlugin } from '@apollo-deploy/tesseract/fastify';
+ *
+ * app.register(tesseractPlugin, {
+ *   info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+ *   output: './packages/api-sdk',
+ * });
+ * ```
+ */
+export const tesseractPlugin = fp(_tesseractPlugin, {
+    name: 'tesseract',
+    fastify: '>=4',
+});
+//# sourceMappingURL=fastify.js.map

package/dist/fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.js","sourceRoot":"","sources":["../src/fastify.ts"],"names":[],"mappings":"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"}

package/dist/hono.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Tesseract Hono integration.
+ *
+ * Re-exports `SDKCollector` and adds a `HonoSDKCollector` subclass with a
+ * `.honoMiddleware()` helper that registers a route with the collector and
+ * returns a no-op Hono middleware handler for inline placement.
+ *
+ * Because Hono has no route-registration hook, routes are registered with the
+ * collector explicitly. Generation is triggered by calling
+ * `collector.tryGenerate()` after all routes are set up.
+ *
+ * ```ts
+ * import { Hono } from 'hono';
+ * import { HonoSDKCollector } from '@apollo-deploy/tesseract/hono';
+ *
+ * const app = new Hono();
+ * const collector = new HonoSDKCollector({
+ *   info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+ *   output: './packages/api-sdk',
+ * });
+ *
+ * collector.domain('/users', { domain: 'users', description: 'User management' });
+ *
+ * app.get('/users/:id',
+ *   collector.honoMiddleware('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+ *   (c) => c.json(getUser(c.req.param('id'))),
+ * );
+ *
+ * // After all routes are registered:
+ * if (await collector.tryGenerate()) process.exit(0);
+ *
+ * export default app;
+ * ```
+ *
+ * **Triggering generation:**
+ * ```bash
+ * TESSERACT_GENERATE=1 node dist/app.js
+ * ```
+ */
+import { SDKCollector } from './collector.js';
+import type { CollectorRouteConfig } from './collector.js';
+export { SDKCollector } from './collector.js';
+export type { CollectorOptions, CollectorRouteConfig } from './collector.js';
+/** Minimal Hono middleware type — avoids a hard import of the `hono` package. */
+type HonoMiddleware = (c: unknown, next: () => Promise<void>) => Promise<void> | void;
+/**
+ * `SDKCollector` subclass with a Hono-specific `.honoMiddleware()` helper.
+ *
+ * `.honoMiddleware()` registers a route with the collector **and** returns a
+ * no-op Hono middleware for inline placement in `app.get()` / `app.post()` etc.
+ */
+export declare class HonoSDKCollector extends SDKCollector {
+    /**
+     * Register a route with the collector and return a no-op Hono middleware.
+     *
+     * ```ts
+     * app.get('/users/:id',
+     *   collector.honoMiddleware('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+     *   (c) => c.json(getUser(c.req.param('id'))),
+     * );
+     * ```
+     */
+    honoMiddleware(url: string, method: string, config: CollectorRouteConfig): HonoMiddleware;
+}
+//# sourceMappingURL=hono.d.ts.map

package/dist/hono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../src/hono.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,iFAAiF;AACjF,KAAK,cAAc,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEtF;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD;;;;;;;;;OASG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,cAAc;CAI1F"}

package/dist/hono.js

@@ -0,0 +1,64 @@
+/**
+ * Tesseract Hono integration.
+ *
+ * Re-exports `SDKCollector` and adds a `HonoSDKCollector` subclass with a
+ * `.honoMiddleware()` helper that registers a route with the collector and
+ * returns a no-op Hono middleware handler for inline placement.
+ *
+ * Because Hono has no route-registration hook, routes are registered with the
+ * collector explicitly. Generation is triggered by calling
+ * `collector.tryGenerate()` after all routes are set up.
+ *
+ * ```ts
+ * import { Hono } from 'hono';
+ * import { HonoSDKCollector } from '@apollo-deploy/tesseract/hono';
+ *
+ * const app = new Hono();
+ * const collector = new HonoSDKCollector({
+ *   info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+ *   output: './packages/api-sdk',
+ * });
+ *
+ * collector.domain('/users', { domain: 'users', description: 'User management' });
+ *
+ * app.get('/users/:id',
+ *   collector.honoMiddleware('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+ *   (c) => c.json(getUser(c.req.param('id'))),
+ * );
+ *
+ * // After all routes are registered:
+ * if (await collector.tryGenerate()) process.exit(0);
+ *
+ * export default app;
+ * ```
+ *
+ * **Triggering generation:**
+ * ```bash
+ * TESSERACT_GENERATE=1 node dist/app.js
+ * ```
+ */
+import { SDKCollector } from './collector.js';
+export { SDKCollector } from './collector.js';
+/**
+ * `SDKCollector` subclass with a Hono-specific `.honoMiddleware()` helper.
+ *
+ * `.honoMiddleware()` registers a route with the collector **and** returns a
+ * no-op Hono middleware for inline placement in `app.get()` / `app.post()` etc.
+ */
+export class HonoSDKCollector extends SDKCollector {
+    /**
+     * Register a route with the collector and return a no-op Hono middleware.
+     *
+     * ```ts
+     * app.get('/users/:id',
+     *   collector.honoMiddleware('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+     *   (c) => c.json(getUser(c.req.param('id'))),
+     * );
+     * ```
+     */
+    honoMiddleware(url, method, config) {
+        this.route(url, method, config);
+        return (_c, next) => next();
+    }
+}
+//# sourceMappingURL=hono.js.map

package/dist/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../src/hono.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C;;;;;GAKG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAChD;;;;;;;;;OASG;IACH,cAAc,CAAC,GAAW,EAAE,MAAc,EAAE,MAA4B;QACtE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/index.d.ts

@@ -15,5 +15,10 @@ export declare function generate(config: TesseractConfig): Promise<GenerateResul
 export type { TesseractConfig } from './types/config.js';
 export type { SDKIR, EnrichedSDKIR } from './types/ir.js';
 export type { LanguageAdapter, EmitResult } from './adapters/types.js';
+export type { SDKModuleConfig, SDKRouteConfig } from './types/sdk-module.js';
+export { SDKModule, SDK_MODULE_CONFIG } from './types/sdk-module.js';
+export type { BackendManifest } from './types/manifest.js';
 export type { EmittedFile } from './pipeline/write.js';
+export { SDKCollector } from './collector.js';
+export type { CollectorOptions, CollectorRouteConfig } from './collector.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,wBAAsB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA0C/E;AAGD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,wBAAsB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA0C/E;AAGD,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -24,7 +24,7 @@ export async function generate(config) {
     }
     const adapter = adapterFactory();
     const outputDir = resolve(resolved.output);
-    const emitResult = await adapter.emit(enriched, outputDir);
+    const emitResult = await adapter.emit(enriched, outputDir, resolved);
     if (resolved.dryRun || resolved.check) {
         const compareResult = compare(emitResult.files, outputDir);
         return {
@@ -47,4 +47,7 @@ export async function generate(config) {
         changedFiles: writeResult.written,
     };
 }
+export { SDKModule, SDK_MODULE_CONFIG } from './types/sdk-module.js';
+// Framework-agnostic collector
+export { SDKCollector } from './collector.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAanE,MAAM,QAAQ,GAA0C;IACtD,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE;CAC1C,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAuB;IACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEvC,8BAA8B;IAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE5B,mCAAmC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IAE5B,iCAAiC;IACjC,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,QAAQ,iBAAiB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClH,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAE3D,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAE3D,OAAO;YACL,YAAY,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM;YAC1C,YAAY,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM;YAC1C,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAC5C,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YAC1C,YAAY,EAAE,aAAa,CAAC,OAAO;SACpC,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAEvD,OAAO;QACL,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM;QACxC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM;QACxC,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC1C,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,WAAW,CAAC,OAAO;KAClC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAanE,MAAM,QAAQ,GAA0C;IACtD,UAAU,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE;CAC1C,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAuB;IACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEvC,8BAA8B;IAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE5B,mCAAmC;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;IAE5B,iCAAiC;IACjC,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,QAAQ,iBAAiB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClH,CAAC;IACD,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAErE,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtC,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAE3D,OAAO;YACL,YAAY,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM;YAC1C,YAAY,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM;YAC1C,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAC5C,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YAC1C,YAAY,EAAE,aAAa,CAAC,OAAO;SACpC,CAAC;IACJ,CAAC;IAED,yBAAyB;IACzB,MAAM,WAAW,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAEvD,OAAO;QACL,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM;QACxC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM;QACxC,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC1C,IAAI,EAAE,OAAO;QACb,YAAY,EAAE,WAAW,CAAC,OAAO;KAClC,CAAC;AACJ,CAAC;AAOD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAIrE,+BAA+B;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/koa.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Tesseract Koa integration.
+ *
+ * Re-exports `SDKCollector` and adds a `KoaSDKCollector` subclass with a
+ * `.koaMiddleware()` helper that registers a route with the collector and
+ * returns a no-op Koa middleware for inline placement with `@koa/router`.
+ *
+ * Because Koa has no route-registration hook, routes are registered with the
+ * collector explicitly. Generation is triggered by calling
+ * `collector.tryGenerate()` after all routes are set up.
+ *
+ * ```ts
+ * import Koa from 'koa';
+ * import Router from '@koa/router';
+ * import { KoaSDKCollector } from '@apollo-deploy/tesseract/koa';
+ *
+ * const app = new Koa();
+ * const router = new Router();
+ * const collector = new KoaSDKCollector({
+ *   info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+ *   output: './packages/api-sdk',
+ * });
+ *
+ * collector.domain('/users', { domain: 'users', description: 'User management' });
+ *
+ * router.get('/users/:id',
+ *   collector.koaMiddleware('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+ *   getUserHandler,
+ * );
+ *
+ * app.use(router.routes());
+ *
+ * // After all routes are registered:
+ * if (await collector.tryGenerate()) process.exit(0);
+ *
+ * app.listen(3000);
+ * ```
+ *
+ * **Triggering generation:**
+ * ```bash
+ * TESSERACT_GENERATE=1 node dist/app.js
+ * ```
+ */
+import { SDKCollector } from './collector.js';
+import type { CollectorRouteConfig } from './collector.js';
+export { SDKCollector } from './collector.js';
+export type { CollectorOptions, CollectorRouteConfig } from './collector.js';
+/** Minimal Koa middleware type — avoids a hard import of the `koa` package. */
+type KoaMiddleware = (ctx: unknown, next: () => Promise<void>) => Promise<void> | void;
+/**
+ * `SDKCollector` subclass with a Koa-specific `.koaMiddleware()` helper.
+ *
+ * `.koaMiddleware()` registers a route with the collector **and** returns a
+ * no-op Koa middleware for inline placement with `@koa/router`.
+ */
+export declare class KoaSDKCollector extends SDKCollector {
+    /**
+     * Register a route with the collector and return a no-op Koa middleware.
+     *
+     * ```ts
+     * router.get('/users/:id',
+     *   collector.koaMiddleware('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+     *   getUserHandler,
+     * );
+     * ```
+     */
+    koaMiddleware(url: string, method: string, config: CollectorRouteConfig): KoaMiddleware;
+}
+//# sourceMappingURL=koa.d.ts.map

package/dist/koa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"koa.d.ts","sourceRoot":"","sources":["../src/koa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE7E,+EAA+E;AAC/E,KAAK,aAAa,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAEvF;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C;;;;;;;;;OASG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,aAAa;CAIxF"}

package/dist/koa.js

@@ -0,0 +1,68 @@
+/**
+ * Tesseract Koa integration.
+ *
+ * Re-exports `SDKCollector` and adds a `KoaSDKCollector` subclass with a
+ * `.koaMiddleware()` helper that registers a route with the collector and
+ * returns a no-op Koa middleware for inline placement with `@koa/router`.
+ *
+ * Because Koa has no route-registration hook, routes are registered with the
+ * collector explicitly. Generation is triggered by calling
+ * `collector.tryGenerate()` after all routes are set up.
+ *
+ * ```ts
+ * import Koa from 'koa';
+ * import Router from '@koa/router';
+ * import { KoaSDKCollector } from '@apollo-deploy/tesseract/koa';
+ *
+ * const app = new Koa();
+ * const router = new Router();
+ * const collector = new KoaSDKCollector({
+ *   info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+ *   output: './packages/api-sdk',
+ * });
+ *
+ * collector.domain('/users', { domain: 'users', description: 'User management' });
+ *
+ * router.get('/users/:id',
+ *   collector.koaMiddleware('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+ *   getUserHandler,
+ * );
+ *
+ * app.use(router.routes());
+ *
+ * // After all routes are registered:
+ * if (await collector.tryGenerate()) process.exit(0);
+ *
+ * app.listen(3000);
+ * ```
+ *
+ * **Triggering generation:**
+ * ```bash
+ * TESSERACT_GENERATE=1 node dist/app.js
+ * ```
+ */
+import { SDKCollector } from './collector.js';
+export { SDKCollector } from './collector.js';
+/**
+ * `SDKCollector` subclass with a Koa-specific `.koaMiddleware()` helper.
+ *
+ * `.koaMiddleware()` registers a route with the collector **and** returns a
+ * no-op Koa middleware for inline placement with `@koa/router`.
+ */
+export class KoaSDKCollector extends SDKCollector {
+    /**
+     * Register a route with the collector and return a no-op Koa middleware.
+     *
+     * ```ts
+     * router.get('/users/:id',
+     *   collector.koaMiddleware('/users/:id', 'GET', { sdk: { methodName: 'getUser' } }),
+     *   getUserHandler,
+     * );
+     * ```
+     */
+    koaMiddleware(url, method, config) {
+        this.route(url, method, config);
+        return (_ctx, next) => next();
+    }
+}
+//# sourceMappingURL=koa.js.map

package/dist/koa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"koa.js","sourceRoot":"","sources":["../src/koa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG9C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,YAAY;IAC/C;;;;;;;;;OASG;IACH,aAAa,CAAC,GAAW,EAAE,MAAc,EAAE,MAA4B;QACrE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;IAChC,CAAC;CACF"}