@apollo-deploy/tesseract 0.4.3 → 0.5.0

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"}

package/dist/nestjs.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Tesseract NestJS integration.
+ *
+ * Provides:
+ * - `@SDKMethod(config)` — method decorator to attach SDK metadata to a controller handler
+ * - `@SDKDomain(config)` — class decorator to attach domain metadata to a controller
+ * - `collectFromNestControllers(controllers, collector)` — reads decorator metadata and
+ *   registers routes with an `SDKCollector`
+ *
+ * Requires `reflect-metadata` (already a standard NestJS dependency) and
+ * `emitDecoratorMetadata: true` in `tsconfig.json`.
+ *
+ * ```ts
+ * // users.controller.ts
+ * import { Controller, Get, Post, Param, Body } from '@nestjs/common';
+ * import { SDKMethod, SDKDomain } from '@apollo-deploy/tesseract/nestjs';
+ *
+ * @Controller('users')
+ * @SDKDomain({ domain: 'users', description: 'User management' })
+ * export class UsersController {
+ *   @Get(':id')
+ *   @SDKMethod({ methodName: 'getUser', schema: { response: { 200: { $ref: 'User' } } } })
+ *   getUser(@Param('id') id: string) { ... }
+ *
+ *   @Post()
+ *   @SDKMethod({ methodName: 'createUser' })
+ *   createUser(@Body() body: CreateUserDto) { ... }
+ * }
+ *
+ * // main.ts
+ * import { NestFactory } from '@nestjs/core';
+ * import { AppModule } from './app.module';
+ * import { SDKCollector, collectFromNestControllers } from '@apollo-deploy/tesseract/nestjs';
+ * import { UsersController } from './users/users.controller';
+ *
+ * async function bootstrap() {
+ *   const app = await NestFactory.create(AppModule);
+ *   await app.init();
+ *
+ *   if (process.env.TESSERACT_GENERATE) {
+ *     const collector = new SDKCollector({
+ *       info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+ *       output: './packages/api-sdk',
+ *     });
+ *     collectFromNestControllers([UsersController], collector);
+ *     await collector.generate();
+ *     await app.close();
+ *     process.exit(0);
+ *   }
+ *
+ *   await app.listen(3000);
+ * }
+ * bootstrap();
+ * ```
+ *
+ * **Triggering generation:**
+ * ```bash
+ * TESSERACT_GENERATE=1 node dist/main.js
+ * ```
+ */
+declare global {
+    namespace Reflect {
+        function defineMetadata(key: unknown, value: unknown, target: object, propertyKey?: string | symbol): void;
+        function getMetadata(key: unknown, target: object, propertyKey?: string | symbol): unknown;
+    }
+}
+import { SDKCollector } from './collector.js';
+import type { SDKRouteConfig, SDKModuleConfig } from './types/sdk-module.js';
+import type { ManifestRouteSchema } from './types/manifest.js';
+export { SDKCollector } from './collector.js';
+export type { CollectorOptions, CollectorRouteConfig } from './collector.js';
+export interface SDKMethodConfig extends SDKRouteConfig {
+    /** Explicit JSON Schema for this route — params, querystring, body, headers, response. */
+    schema?: ManifestRouteSchema;
+}
+/**
+ * Method decorator — attach SDK generation config to a NestJS controller handler.
+ *
+ * ```ts
+ * @Get(':id')
+ * @SDKMethod({ methodName: 'getUser', schema: { response: { 200: { $ref: 'User' } } } })
+ * getUser(@Param('id') id: string) { ... }
+ * ```
+ */
+export declare function SDKMethod(config: SDKMethodConfig): MethodDecorator;
+/**
+ * Class decorator — attach domain metadata to a NestJS controller.
+ *
+ * ```ts
+ * @Controller('users')
+ * @SDKDomain({ domain: 'users', description: 'User management' })
+ * export class UsersController { ... }
+ * ```
+ */
+export declare function SDKDomain(config: Omit<SDKModuleConfig, 'prefix'>): ClassDecorator;
+/**
+ * Read `@SDKMethod` and `@SDKDomain` metadata from the given controller classes
+ * and register each decorated route with the provided `SDKCollector`.
+ *
+ * Pass the controller **classes** (not instances).
+ *
+ * ```ts
+ * collectFromNestControllers([UsersController, OrdersController], collector);
+ * ```
+ */
+export declare function collectFromNestControllers(controllers: Function[], collector: SDKCollector): void;
+//# sourceMappingURL=nestjs.d.ts.map

package/dist/nestjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nestjs.d.ts","sourceRoot":"","sources":["../src/nestjs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AAKH,OAAO,CAAC,MAAM,CAAC;IAEb,UAAU,OAAO,CAAC;QAChB,SAAS,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;QAC3G,SAAS,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;KAC5F;CACF;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAyB7E,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,0FAA0F;IAC1F,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,CAIlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,cAAc,CAIjF;AAID;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,QAAQ,EAAE,EACvB,SAAS,EAAE,YAAY,GACtB,IAAI,CAkCN"}

package/dist/nestjs.js

@@ -0,0 +1,143 @@
+/**
+ * Tesseract NestJS integration.
+ *
+ * Provides:
+ * - `@SDKMethod(config)` — method decorator to attach SDK metadata to a controller handler
+ * - `@SDKDomain(config)` — class decorator to attach domain metadata to a controller
+ * - `collectFromNestControllers(controllers, collector)` — reads decorator metadata and
+ *   registers routes with an `SDKCollector`
+ *
+ * Requires `reflect-metadata` (already a standard NestJS dependency) and
+ * `emitDecoratorMetadata: true` in `tsconfig.json`.
+ *
+ * ```ts
+ * // users.controller.ts
+ * import { Controller, Get, Post, Param, Body } from '@nestjs/common';
+ * import { SDKMethod, SDKDomain } from '@apollo-deploy/tesseract/nestjs';
+ *
+ * @Controller('users')
+ * @SDKDomain({ domain: 'users', description: 'User management' })
+ * export class UsersController {
+ *   @Get(':id')
+ *   @SDKMethod({ methodName: 'getUser', schema: { response: { 200: { $ref: 'User' } } } })
+ *   getUser(@Param('id') id: string) { ... }
+ *
+ *   @Post()
+ *   @SDKMethod({ methodName: 'createUser' })
+ *   createUser(@Body() body: CreateUserDto) { ... }
+ * }
+ *
+ * // main.ts
+ * import { NestFactory } from '@nestjs/core';
+ * import { AppModule } from './app.module';
+ * import { SDKCollector, collectFromNestControllers } from '@apollo-deploy/tesseract/nestjs';
+ * import { UsersController } from './users/users.controller';
+ *
+ * async function bootstrap() {
+ *   const app = await NestFactory.create(AppModule);
+ *   await app.init();
+ *
+ *   if (process.env.TESSERACT_GENERATE) {
+ *     const collector = new SDKCollector({
+ *       info: { title: 'My API', version: '1.0.0', baseUrl: 'https://api.example.com' },
+ *       output: './packages/api-sdk',
+ *     });
+ *     collectFromNestControllers([UsersController], collector);
+ *     await collector.generate();
+ *     await app.close();
+ *     process.exit(0);
+ *   }
+ *
+ *   await app.listen(3000);
+ * }
+ * bootstrap();
+ * ```
+ *
+ * **Triggering generation:**
+ * ```bash
+ * TESSERACT_GENERATE=1 node dist/main.js
+ * ```
+ */
+export { SDKCollector } from './collector.js';
+// ── Metadata keys ─────────────────────────────────────────────────────────────
+const SDK_METHOD_META = Symbol('tesseract:sdkMethod');
+const SDK_DOMAIN_META = Symbol('tesseract:sdkDomain');
+// NestJS stores route metadata under these well-known string keys
+const NEST_PATH_META = 'path';
+const NEST_METHOD_META = 'method';
+// NestJS RequestMethod enum values
+const NEST_HTTP_METHODS = {
+    0: 'GET',
+    1: 'POST',
+    2: 'PUT',
+    3: 'DELETE',
+    4: 'PATCH',
+    5: 'ALL',
+    6: 'OPTIONS',
+    7: 'HEAD',
+};
+/**
+ * Method decorator — attach SDK generation config to a NestJS controller handler.
+ *
+ * ```ts
+ * @Get(':id')
+ * @SDKMethod({ methodName: 'getUser', schema: { response: { 200: { $ref: 'User' } } } })
+ * getUser(@Param('id') id: string) { ... }
+ * ```
+ */
+export function SDKMethod(config) {
+    return (target, propertyKey) => {
+        Reflect.defineMetadata(SDK_METHOD_META, config, target, propertyKey);
+    };
+}
+/**
+ * Class decorator — attach domain metadata to a NestJS controller.
+ *
+ * ```ts
+ * @Controller('users')
+ * @SDKDomain({ domain: 'users', description: 'User management' })
+ * export class UsersController { ... }
+ * ```
+ */
+export function SDKDomain(config) {
+    return (target) => {
+        Reflect.defineMetadata(SDK_DOMAIN_META, config, target);
+    };
+}
+// ── Route collector ───────────────────────────────────────────────────────────
+/**
+ * Read `@SDKMethod` and `@SDKDomain` metadata from the given controller classes
+ * and register each decorated route with the provided `SDKCollector`.
+ *
+ * Pass the controller **classes** (not instances).
+ *
+ * ```ts
+ * collectFromNestControllers([UsersController, OrdersController], collector);
+ * ```
+ */
+export function collectFromNestControllers(controllers, collector) {
+    for (const ControllerClass of controllers) {
+        // NestJS stores the controller path prefix under 'path' metadata on the class
+        const rawPrefix = (Reflect.getMetadata(NEST_PATH_META, ControllerClass) ?? '');
+        const prefix = rawPrefix.startsWith('/') ? rawPrefix : '/' + rawPrefix;
+        const domainMeta = Reflect.getMetadata(SDK_DOMAIN_META, ControllerClass);
+        collector.domain(prefix, domainMeta);
+        const prototype = ControllerClass.prototype;
+        for (const key of Object.getOwnPropertyNames(prototype)) {
+            if (key === 'constructor')
+                continue;
+            const sdkConfig = Reflect.getMetadata(SDK_METHOD_META, prototype, key);
+            if (!sdkConfig || sdkConfig.exclude)
+                continue;
+            const nestMethod = Reflect.getMetadata(NEST_METHOD_META, prototype, key);
+            const nestPath = (Reflect.getMetadata(NEST_PATH_META, prototype, key) ?? '');
+            const method = nestMethod !== undefined ? (NEST_HTTP_METHODS[nestMethod] ?? 'GET') : 'GET';
+            const rawTail = nestPath.startsWith('/') ? nestPath : '/' + nestPath;
+            const url = prefix === '/' ? rawTail : prefix + (rawTail === '/' ? '' : rawTail);
+            const { schema, ...routeSdk } = sdkConfig;
+            const routeConfig = { sdk: routeSdk, schema };
+            collector.route(url, method, routeConfig);
+        }
+    }
+}
+//# sourceMappingURL=nestjs.js.map

package/dist/nestjs.js.map

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

package/dist/pipeline/intake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intake.d.ts","sourceRoot":"","sources":["../../src/pipeline/intake.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAIV,UAAU,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,KAAK,EAQN,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CA4EpD;AA+JD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA2D3D"}
+{"version":3,"file":"intake.d.ts","sourceRoot":"","sources":["../../src/pipeline/intake.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAIV,UAAU,EACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,KAAK,EAQN,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAKzD,wBAAgB,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,KAAK,CA+EpD;AAmKD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CA2D3D"}

package/dist/pipeline/intake.js

@@ -10,16 +10,21 @@ import { validateManifest } from '../types/manifest.js';
 // ── Entry point ──────────────────────────────────────────────────────────────
 export function intake(config) {
     let manifest;
-    try {
-        const raw = readFileSync(config.input, 'utf-8');
-        manifest = JSON.parse(raw);
+    if (config.manifest) {
+        manifest = config.manifest;
     }
-    catch (err) {
-        throw new Error(`Failed to read manifest at "${config.input}": ${err instanceof Error ? err.message : String(err)}`);
-    }
-    const validation = validateManifest(manifest);
-    if (!validation.valid) {
-        throw new Error(`Invalid manifest:\n  ${validation.errors.join('\n  ')}`);
+    else {
+        try {
+            const raw = readFileSync(config.input, 'utf-8');
+            manifest = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new Error(`Failed to read manifest at "${config.input}": ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const validation = validateManifest(manifest);
+        if (!validation.valid) {
+            throw new Error(`Invalid manifest:\n  ${validation.errors.join('\n  ')}`);
+        }
     }
     const schemaPackage = manifest.schemaPackage;
     const importPath = schemaPackage?.importPath ?? schemaPackage?.name;
@@ -47,7 +52,7 @@ export function intake(config) {
     const schemas = [...externalSchemas, ...buildSchemas(localDefinitions)];
     const groups = [];
     const allInlineSchemas = [];
-    for (const domain of manifest.domains.filter((d) => d.stability !== 'internal')) {
+    for (const domain of manifest.domains) {
         const { group, inlineSchemas } = buildOperationGroup(domain, schemas);
         groups.push(group);
         allInlineSchemas.push(...inlineSchemas);
@@ -87,6 +92,10 @@ function collectExternalRefNames(manifest) {
                     scanSchemaForExternalRefs(resp, names);
                 }
             }
+            // Register sseReturnType as an external ref so it gets an import stub
+            if (route.sdk?.sseReturnType) {
+                names.add(pascalCase(route.sdk.sseReturnType));
+            }
         }
     }
     return names;
@@ -176,7 +185,7 @@ function jsonSchemaToDefinition(name, schema) {
         };
     }
     if (s.type === 'object') {
-        const required = new Set(s.required ?? []);
+        const required = new Set(Array.isArray(s.required) ? s.required : []);
         const rawProps = s.properties ?? {};
         const properties = Object.entries(rawProps).map(([propName, propSchema]) => {
             const ps = propSchema;
@@ -226,7 +235,7 @@ export function jsonSchemaToType(schema) {
         return s.anyOf.map(jsonSchemaToType).join(' | ');
     const type = s.type;
     if (type === 'object') {
-        const required = new Set(s.required ?? []);
+        const required = new Set(Array.isArray(s.required) ? s.required : []);
         const rawProps = s.properties;
         if (rawProps) {
             const entries = Object.entries(rawProps)
@@ -298,14 +307,14 @@ function isNullableRefUnion(members) {
 function buildOperationGroup(domain, _schemas) {
     const domainName = domain.domain ?? domain.prefix;
     const name = camelCase(domainName);
-    const fileName = kebabCase(domainName);
+    const fileName = domain.fileName ?? kebabCase(domainName);
     const allInlineSchemas = [];
     const operations = [];
     for (const route of domain.routes) {
-        if (route.sdk?.exclude || route.sdk?.internal)
+        if (route.sdk?.exclude)
             continue;
         const { operation, inlineSchemas } = buildOperation(route, name, domain.prefix);
-        operations.push(operation);
+        operations.push({ ...operation, visibility: route.sdk?.internal ? 'internal' : 'public' });
         for (const s of inlineSchemas) {
             allInlineSchemas.push({
                 ...s,
@@ -320,6 +329,7 @@ function buildOperationGroup(domain, _schemas) {
             interfaceName: pascalCase(domainName) + 'API',
             factoryName: 'create' + pascalCase(domainName) + 'API',
             description: domain.description,
+            visibility: domain.stability === 'internal' ? 'internal' : 'public',
             operations,
         },
         inlineSchemas: allInlineSchemas,
@@ -336,7 +346,7 @@ function buildOperation(route, groupName, domainPrefix) {
     const inlineSchemas = [];
     const name = route.sdk?.methodName ??
         deriveCleanMethodName({
-            operationId: route.schema?.operationId,
+            operationId: route.schema?.operationId ?? route.sdk?.operationId,
             summary: route.schema?.summary,
             path: route.url.replace(/:([a-zA-Z_][a-zA-Z0-9_]*)/g, '{$1}'),
             httpMethod: httpMethod.toLowerCase(),
@@ -379,7 +389,11 @@ function buildOperation(route, groupName, domainPrefix) {
         requestBody = {
             type: bodyType,
             required: true,
-            contentType: route.sdk?.transport === 'multipart' ? 'multipart/form-data' : 'application/json',
+            contentType: route.sdk?.transport === 'multipart'
+                ? 'multipart/form-data'
+                : route.sdk?.transport === 'binary'
+                    ? 'application/octet-stream'
+                    : 'application/json',
         };
     }
     // Query type
@@ -431,7 +445,10 @@ function buildOperation(route, groupName, domainPrefix) {
             responseType,
             statusCode,
             deprecated: route.sdk?.deprecated ? true : undefined,
+            deprecationMessage: typeof route.sdk?.deprecated === 'string' ? route.sdk.deprecated : undefined,
+            timeout: route.sdk?.timeout,
             isEventStream: route.sse ?? route.sdk?.transport === 'stream',
+            sseReturnType: route.sdk?.sseReturnType,
         },
         inlineSchemas,
     };
@@ -458,8 +475,10 @@ function extractPathParams(url, paramsSchema) {
     if (urlParams.length === 0)
         return [];
     const s = paramsSchema;
-    const props = s?.properties;
-    const required = new Set(s?.required ?? []);
+    const props = typeof s?.properties === 'object' && !Array.isArray(s?.properties)
+        ? s.properties
+        : undefined;
+    const required = new Set(Array.isArray(s?.required) ? s.required : []);
     return urlParams.map((paramName) => {
         const propSchema = props?.[paramName];
         return {
@@ -479,7 +498,7 @@ function extractQueryParams(querySchema) {
     const s = querySchema;
     if (s.type !== 'object' || !s.properties)
         return [];
-    const required = new Set(s.required ?? []);
+    const required = new Set(Array.isArray(s.required) ? s.required : []);
     const props = s.properties;
     return Object.entries(props).map(([name, schema]) => ({
         name: camelCase(name),
@@ -504,7 +523,7 @@ function extractHeaderParams(headersSchema) {
     const s = headersSchema;
     if (s.type !== 'object' || !s.properties)
         return [];
-    const required = new Set(s.required ?? []);
+    const required = new Set(Array.isArray(s.required) ? s.required : []);
     const props = s.properties;
     return Object.entries(props)
         .filter(([name]) => !SYSTEM_HEADERS.has(name.toLowerCase()))