ts-procedures 8.6.0 → 9.1.0

package/build/codegen/emit/context.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shared per-route emission contracts for the TS scope emitter.
+ *
+ * `EmitRouteContext` is threaded through every route emitter and formatting
+ * helper; `RouteChunks` is what each per-kind emitter returns to
+ * `emitScopeFile` for final assembly.
+ */
+import type { AjscOptions } from '../emit-types.js';
+export interface RouteChunks {
+    typeDeclarations: string[];
+    callable: string;
+    hasStream: boolean;
+    /** True when this route emitted an `Errors` type (drives the `_errors` import at the top of the scope file). */
+    hasErrors: boolean;
+}
+export interface EmitRouteContext {
+    ajsc?: AjscOptions;
+    namespaceTypes: boolean;
+    scopePascal: string;
+    serviceName: string;
+    errorKeys?: Set<string>;
+    /** `$id` → shared model type name; drives the substitute wrappers. */
+    idToModelName?: Map<string, string>;
+    /**
+     * Accumulates the model names ajsc reported as `referencedNamedTypes` across
+     * every route in the scope. Drives the `import type { … } from './_models'`
+     * line assembled in `emitScopeFile`.
+     */
+    referencedModels: Set<string>;
+}

package/build/codegen/emit/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/build/codegen/emit/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/codegen/emit/context.ts"],"names":[],"mappings":""}

package/build/codegen/emit/declarations.d.ts

@@ -0,0 +1,24 @@
+/** Indent each line of a multi-line string by a given prefix. */
+export declare function indent(text: string, prefix: string): string;
+/**
+ * Tracks extracted declarations emitted into a single namespace, guarding
+ * against duplicate identifiers (defense-in-depth on top of the rename pass).
+ *
+ * - Exact-string duplicates (the same sub-type extracted from two schemas) are
+ *   silently skipped.
+ * - A same-name-but-different-body declaration is a genuine collision the
+ *   rename pass failed to resolve; emitting it would produce an opaque
+ *   `TS2300: Duplicate identifier` in the consumer's build. We fail fast at
+ *   codegen with a message that names the offending identifier instead.
+ *
+ * Returns the indented declaration line to push, or `null` when it should be
+ * skipped (exact duplicate).
+ */
+export declare class DeclarationCollector {
+    private readonly context;
+    private readonly seenStrings;
+    private readonly seenNames;
+    constructor(context: string);
+    /** Returns the indented line to emit, or `null` for an exact duplicate. */
+    accept(decl: string, indentPrefix: string): string | null;
+}

package/build/codegen/emit/declarations.js

@@ -0,0 +1,48 @@
+/**
+ * Declaration bookkeeping for namespace-mode emission: the `indent` text
+ * helper and the `DeclarationCollector` duplicate-identifier guard.
+ */
+import { extractedDeclName } from '../emit-types.js';
+/** Indent each line of a multi-line string by a given prefix. */
+export function indent(text, prefix) {
+    return text.split('\n').map((line) => (line ? prefix + line : line)).join('\n');
+}
+/**
+ * Tracks extracted declarations emitted into a single namespace, guarding
+ * against duplicate identifiers (defense-in-depth on top of the rename pass).
+ *
+ * - Exact-string duplicates (the same sub-type extracted from two schemas) are
+ *   silently skipped.
+ * - A same-name-but-different-body declaration is a genuine collision the
+ *   rename pass failed to resolve; emitting it would produce an opaque
+ *   `TS2300: Duplicate identifier` in the consumer's build. We fail fast at
+ *   codegen with a message that names the offending identifier instead.
+ *
+ * Returns the indented declaration line to push, or `null` when it should be
+ * skipped (exact duplicate).
+ */
+export class DeclarationCollector {
+    context;
+    seenStrings = new Set();
+    seenNames = new Map();
+    constructor(context) {
+        this.context = context;
+    }
+    /** Returns the indented line to emit, or `null` for an exact duplicate. */
+    accept(decl, indentPrefix) {
+        if (this.seenStrings.has(decl))
+            return null;
+        const name = extractedDeclName(decl);
+        if (name != null) {
+            if (this.seenNames.has(name)) {
+                throw new Error(`[ts-procedures-codegen] duplicate identifier '${name}' while emitting ${this.context}. ` +
+                    `An extracted sub-type collided with another of the same name and could not be renamed. ` +
+                    `This is a codegen bug — please report it with the offending schema.`);
+            }
+            this.seenNames.set(name, decl);
+        }
+        this.seenStrings.add(decl);
+        return indent(decl, indentPrefix);
+    }
+}
+//# sourceMappingURL=declarations.js.map

package/build/codegen/emit/declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declarations.js","sourceRoot":"","sources":["../../../src/codegen/emit/declarations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,iEAAiE;AACjE,MAAM,UAAU,MAAM,CAAC,IAAY,EAAE,MAAc;IACjD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACjF,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,oBAAoB;IAIF;IAHZ,WAAW,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEtD,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEhD,2EAA2E;IAC3E,MAAM,CAAC,IAAY,EAAE,YAAoB;QACvC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QAC3C,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CACb,iDAAiD,IAAI,oBAAoB,IAAI,CAAC,OAAO,IAAI;oBACvF,yFAAyF;oBACzF,qEAAqE,CACxE,CAAA;YACH,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAChC,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC1B,OAAO,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;IACnC,CAAC;CACF"}

package/build/codegen/emit/format-types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Schema → TypeScript conversion layer for the scope emitter: shared-model
+ * conversion wrappers (`convertExtracted` / `convertBody`), the
+ * `assertNoModelNameCollision` guard, and the `formatTypes` /
+ * `formatSubNamespace` declaration builders used by the per-kind route
+ * emitters.
+ */
+import { type ExtractedTypeOutput } from '../emit-types.js';
+import type { EmitRouteContext } from './context.js';
+/**
+ * Drop-in replacement for `jsonSchemaToExtractedTypes` that, when shared models
+ * are in play, rewrites every `$id` subschema into an `x-named-type` node before
+ * ajsc. ajsc emits each as a bare verbatim reference and reports it via
+ * `referencedNamedTypes`; this wrapper folds those names into
+ * `ctx.referencedModels` so `emitScopeFile` can build the `_models` import.
+ *
+ * Short-circuits to the exact original call when no models are configured, so
+ * output is byte-identical for envelopes without `$id` models.
+ */
+export declare function convertExtracted(schema: Record<string, unknown>, ctx: EmitRouteContext): Promise<ExtractedTypeOutput | undefined>;
+/**
+ * Drop-in replacement for `jsonSchemaToTypeBody` mirroring {@link convertExtracted}
+ * for the bare-body (flat / merged-alias) conversion path.
+ */
+export declare function convertBody(schema: Record<string, unknown>, ctx: EmitRouteContext): Promise<string | undefined>;
+export interface NamedType {
+    /** Short name for namespace mode (e.g., 'Params', 'Response'). */
+    shortName: string;
+    /** Schema to convert, or undefined if not present. */
+    schema: Record<string, unknown> | undefined;
+}
+export interface FormattedTypes {
+    /** Type declarations to add to the file. */
+    declarations: string[];
+    /** Map of shortName → qualified type reference (for callables). */
+    refs: Record<string, string>;
+}
+/**
+ * Converts multiple schemas into type declarations and type references.
+ * In flat mode: `export type ${routePascal}${shortName} = <body>`
+ * In namespace mode: extracted sub-types + named types inside `export namespace ${routePascal} { ... }`
+ *
+ * `extraReserved` lets the caller pre-reserve identifier names that the route
+ * will inject AFTER formatTypes returns (e.g. emitApiRoute's structured
+ * `Params`). Without this, an ajsc-extracted sub-type could shadow the
+ * injected one and produce duplicate `export type Params` declarations.
+ */
+export declare function formatTypes(routePascal: string, types: NamedType[], ctx: EmitRouteContext, extraReserved?: ReadonlySet<string>): Promise<FormattedTypes>;
+/**
+ * Formats a group of named types into a nested sub-namespace block (for namespace mode).
+ * Returns an array of lines to be inserted into the parent namespace, and a map of
+ * shortName → qualified type reference for use in callables.
+ *
+ * In flat mode, returns declarations like `export type ${prefix}${shortName} = ...`
+ * and refs like `${prefix}${shortName}`.
+ */
+export declare function formatSubNamespace(routePascal: string, nsName: string, // e.g. 'Req' or 'Response'
+types: NamedType[], ctx: EmitRouteContext, taken: Set<string>): Promise<{
+    nsBlock: string | null;
+    refs: Record<string, string>;
+}>;

package/build/codegen/emit/format-types.js

@@ -0,0 +1,188 @@
+/**
+ * Schema → TypeScript conversion layer for the scope emitter: shared-model
+ * conversion wrappers (`convertExtracted` / `convertBody`), the
+ * `assertNoModelNameCollision` guard, and the `formatTypes` /
+ * `formatSubNamespace` declaration builders used by the per-kind route
+ * emitters.
+ */
+import { jsonSchemaToTypeBody, jsonSchemaToTypeBodyWithRefs, jsonSchemaToExtractedTypes, renameExtractedTypes, } from '../emit-types.js';
+import { substituteModelRefs } from '../model-refs.js';
+import { DeclarationCollector } from './declarations.js';
+// ---------------------------------------------------------------------------
+// Shared-model conversion wrappers (ajsc x-named-type)
+// ---------------------------------------------------------------------------
+/**
+ * Drop-in replacement for `jsonSchemaToExtractedTypes` that, when shared models
+ * are in play, rewrites every `$id` subschema into an `x-named-type` node before
+ * ajsc. ajsc emits each as a bare verbatim reference and reports it via
+ * `referencedNamedTypes`; this wrapper folds those names into
+ * `ctx.referencedModels` so `emitScopeFile` can build the `_models` import.
+ *
+ * Short-circuits to the exact original call when no models are configured, so
+ * output is byte-identical for envelopes without `$id` models.
+ */
+export async function convertExtracted(schema, ctx) {
+    if (ctx.idToModelName == null || ctx.idToModelName.size === 0) {
+        return jsonSchemaToExtractedTypes(schema, ctx.ajsc);
+    }
+    const { schema: sub } = substituteModelRefs(schema, ctx.idToModelName);
+    const result = await jsonSchemaToExtractedTypes(sub, ctx.ajsc);
+    if (result != null) {
+        assertNoModelNameCollision(result);
+        for (const name of result.referencedNamedTypes)
+            ctx.referencedModels.add(name);
+    }
+    return result;
+}
+/**
+ * Guards ajsc's documented `x-named-type` collision caveat. If a shared-model
+ * name (referenced via `x-named-type`) also matches the name ajsc derives for a
+ * sibling *structural* sub-type, ajsc silently MERGES them — the model reference
+ * resolves to the unrelated structural type. The merge happens inside ajsc's own
+ * pass, so it can't be disentangled afterward (a post-hoc rename would rewrite
+ * the model reference too, producing a silently-wrong type). Instead we detect
+ * the collision — a name present in BOTH `referencedNamedTypes` AND
+ * `extractedTypeNames` (ajsc's own documented collision signal) — and fail fast
+ * with an actionable message. The throw is wrapped with the route's name/scope
+ * by `emitScopeFile`.
+ */
+function assertNoModelNameCollision(result) {
+    if (result.referencedNamedTypes.length === 0 || result.extractedTypeNames.length === 0)
+        return;
+    const extracted = new Set(result.extractedTypeNames);
+    const collisions = result.referencedNamedTypes.filter((name) => extracted.has(name));
+    if (collisions.length === 0)
+        return;
+    const names = collisions.map((n) => `'${n}'`).join(', ');
+    throw new Error(`shared model ${names} collides with a generated type of the same name derived ` +
+        `from a property in this route's schema — ajsc would silently merge them. Rename ` +
+        `the colliding property, or change the model's $id/title so the generated names differ`);
+}
+/**
+ * Drop-in replacement for `jsonSchemaToTypeBody` mirroring {@link convertExtracted}
+ * for the bare-body (flat / merged-alias) conversion path.
+ */
+export async function convertBody(schema, ctx) {
+    if (ctx.idToModelName == null || ctx.idToModelName.size === 0) {
+        return jsonSchemaToTypeBody(schema, ctx.ajsc);
+    }
+    const { schema: sub } = substituteModelRefs(schema, ctx.idToModelName);
+    const result = await jsonSchemaToTypeBodyWithRefs(sub, ctx.ajsc);
+    if (result == null)
+        return undefined;
+    for (const name of result.referencedNamedTypes)
+        ctx.referencedModels.add(name);
+    return result.body;
+}
+/**
+ * Converts multiple schemas into type declarations and type references.
+ * In flat mode: `export type ${routePascal}${shortName} = <body>`
+ * In namespace mode: extracted sub-types + named types inside `export namespace ${routePascal} { ... }`
+ *
+ * `extraReserved` lets the caller pre-reserve identifier names that the route
+ * will inject AFTER formatTypes returns (e.g. emitApiRoute's structured
+ * `Params`). Without this, an ajsc-extracted sub-type could shadow the
+ * injected one and produce duplicate `export type Params` declarations.
+ */
+export async function formatTypes(routePascal, types, ctx, extraReserved) {
+    const declarations = [];
+    const refs = {};
+    if (ctx.namespaceTypes) {
+        const nsLines = [];
+        const collector = new DeclarationCollector(`namespace ${routePascal}`);
+        // Pre-reserve every name the route will declare itself (each shortName +
+        // any caller-supplied extras). Extracted sub-types whose names land in
+        // this set get renamed (e.g. `Params` → `Params_`) by renameExtractedTypes,
+        // and the body string is patched in lockstep so the reference still
+        // resolves. The set is mutated as we go, so a sub-type renamed in schema A
+        // is also reserved against schema B.
+        const taken = new Set(extraReserved ?? []);
+        for (const t of types) {
+            if (t.schema != null)
+                taken.add(t.shortName);
+        }
+        for (const { shortName, schema } of types) {
+            if (schema == null)
+                continue;
+            const rawResult = await convertExtracted(schema, ctx);
+            if (rawResult == null)
+                continue;
+            const result = renameExtractedTypes(rawResult, taken);
+            // Collect extracted sub-types (dedupe exact dups; throw on real collisions)
+            for (const decl of result.declarations) {
+                const line = collector.accept(decl, '    ');
+                if (line != null)
+                    nsLines.push(line);
+            }
+            nsLines.push(`    export type ${shortName} = ${result.body}`);
+            refs[shortName] = `${ctx.scopePascal}.${routePascal}.${shortName}`;
+        }
+        if (nsLines.length > 0) {
+            declarations.push(`  export namespace ${routePascal} {\n${nsLines.join('\n')}\n  }`);
+        }
+    }
+    else {
+        for (const { shortName, schema } of types) {
+            if (schema == null)
+                continue;
+            const flatName = `${routePascal}${shortName}`;
+            const body = await convertBody(schema, ctx);
+            if (body == null)
+                continue;
+            declarations.push(`export type ${flatName} = ${body}`);
+            refs[shortName] = flatName;
+        }
+    }
+    return { declarations, refs };
+}
+/**
+ * Formats a group of named types into a nested sub-namespace block (for namespace mode).
+ * Returns an array of lines to be inserted into the parent namespace, and a map of
+ * shortName → qualified type reference for use in callables.
+ *
+ * In flat mode, returns declarations like `export type ${prefix}${shortName} = ...`
+ * and refs like `${prefix}${shortName}`.
+ */
+export async function formatSubNamespace(routePascal, nsName, // e.g. 'Req' or 'Response'
+types, ctx, taken) {
+    const refs = {};
+    const nsLines = [];
+    const collector = new DeclarationCollector(`namespace ${routePascal}.${nsName}`);
+    // Pre-reserve short names to prevent sub-type extraction collision
+    for (const t of types) {
+        if (t.schema != null)
+            taken.add(t.shortName);
+    }
+    for (const { shortName, schema } of types) {
+        if (schema == null)
+            continue;
+        if (ctx.namespaceTypes) {
+            const rawResult = await convertExtracted(schema, ctx);
+            if (rawResult == null)
+                continue;
+            const result = renameExtractedTypes(rawResult, taken);
+            for (const decl of result.declarations) {
+                const line = collector.accept(decl, '      ');
+                if (line != null)
+                    nsLines.push(line);
+            }
+            nsLines.push(`      export type ${shortName} = ${result.body}`);
+            refs[shortName] = `${ctx.scopePascal}.${routePascal}.${nsName}.${shortName}`;
+        }
+        else {
+            const flatName = `${routePascal}${nsName}${shortName}`;
+            const body = await convertBody(schema, ctx);
+            if (body == null)
+                continue;
+            refs[shortName] = flatName;
+        }
+    }
+    if (ctx.namespaceTypes) {
+        if (nsLines.length === 0)
+            return { nsBlock: null, refs };
+        const nsBlock = `    export namespace ${nsName} {\n${nsLines.join('\n')}\n    }`;
+        return { nsBlock, refs };
+    }
+    return { nsBlock: null, refs };
+}
+//# sourceMappingURL=format-types.js.map

package/build/codegen/emit/format-types.js.map

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

package/build/codegen/emit/http-stream-route.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Emitter for `kind: 'http-stream'` routes — structured multi-channel `Req`
+ * types plus `Yield` / `ReturnType` and a `client.stream(...)` callable.
+ */
+import type { HttpStreamRouteDoc } from '../../server/types.js';
+import type { EmitRouteContext, RouteChunks } from './context.js';
+export declare function emitHttpStreamRoute(route: HttpStreamRouteDoc, ctx: EmitRouteContext): Promise<RouteChunks>;

package/build/codegen/emit/http-stream-route.js

@@ -0,0 +1,138 @@
+import { renameExtractedTypes } from '../emit-types.js';
+import { toPascalCase } from '../naming.js';
+import { DeclarationCollector } from './declarations.js';
+import { convertBody, convertExtracted, formatSubNamespace } from './format-types.js';
+import { buildCallableJsDoc, buildErrorUnion, injectRouteErrors } from './route-shared.js';
+export async function emitHttpStreamRoute(route, ctx) {
+    const pascal = toPascalCase(route.name);
+    const req = route.jsonSchema.req ?? {};
+    const res = route.jsonSchema.res ?? {};
+    // Request channels
+    const reqChannelKeys = ['pathParams', 'query', 'body', 'headers'];
+    const reqTypes = [];
+    const presentChannels = [];
+    for (const channel of reqChannelKeys) {
+        const schema = req[channel];
+        if (schema != null) {
+            reqTypes.push({ shortName: toPascalCase(channel), schema });
+            presentChannels.push(channel);
+        }
+    }
+    // Yield + ReturnType
+    const yieldSchema = route.jsonSchema.yield;
+    const returnSchema = route.jsonSchema.returnType;
+    const resHeadersSchema = res.headers;
+    const scopeStr = route.scope ?? 'default';
+    const declarations = [];
+    let paramsTypeName = 'void';
+    let yieldTypeName = 'unknown';
+    let returnTypeName = 'void';
+    const taken = new Set(['Req', 'Response', 'Yield', 'ReturnType']);
+    if (ctx.namespaceTypes) {
+        const nsLines = [];
+        // Req sub-namespace
+        const { nsBlock: reqBlock, refs: reqRefs } = await formatSubNamespace(pascal, 'Req', reqTypes, ctx, taken);
+        if (reqBlock) {
+            nsLines.push(reqBlock);
+            // Merged type alias so Req can be used as a generic type arg (same pattern as emitApiRoute)
+            const reqFields = presentChannels
+                .map((ch) => `${ch}: Req.${toPascalCase(ch)}`)
+                .join('; ');
+            nsLines.push(`    export type Req = { ${reqFields} }`);
+        }
+        // Response sub-namespace (headers only for http-stream)
+        const resTypes = [{ shortName: 'Headers', schema: resHeadersSchema }];
+        const { nsBlock: resBlock } = await formatSubNamespace(pascal, 'Response', resTypes, ctx, taken);
+        if (resBlock)
+            nsLines.push(resBlock);
+        // Yield and ReturnType directly in the route namespace
+        const directTypes = [
+            { shortName: 'Yield', schema: yieldSchema },
+            { shortName: 'ReturnType', schema: returnSchema },
+        ];
+        const collector = new DeclarationCollector(`namespace ${pascal}`);
+        for (const { shortName, schema } of directTypes) {
+            if (schema == null)
+                continue;
+            const rawResult = await convertExtracted(schema, ctx);
+            if (rawResult == null)
+                continue;
+            const result = renameExtractedTypes(rawResult, taken);
+            for (const decl of result.declarations) {
+                const line = collector.accept(decl, '    ');
+                if (line != null)
+                    nsLines.push(line);
+            }
+            nsLines.push(`    export type ${shortName} = ${result.body}`);
+        }
+        if (nsLines.length > 0) {
+            declarations.push(`  export namespace ${pascal} {\n${nsLines.join('\n')}\n  }`);
+        }
+        if (presentChannels.length > 0) {
+            paramsTypeName = `${ctx.scopePascal}.${pascal}.Req`;
+        }
+        if (yieldSchema != null)
+            yieldTypeName = `${ctx.scopePascal}.${pascal}.Yield`;
+        if (returnSchema != null)
+            returnTypeName = `${ctx.scopePascal}.${pascal}.ReturnType`;
+    }
+    else {
+        // Flat mode
+        for (const { shortName, schema } of reqTypes) {
+            if (schema == null)
+                continue;
+            const flatName = `${pascal}Req${shortName}`;
+            const body = await convertBody(schema, ctx);
+            if (body == null)
+                continue;
+            declarations.push(`export type ${flatName} = ${body}`);
+        }
+        if (presentChannels.length > 0) {
+            const structureFields = presentChannels
+                .map((ch) => `${ch}: ${pascal}Req${toPascalCase(ch)}`)
+                .join('; ');
+            declarations.push(`export type ${pascal}Req = { ${structureFields} }`);
+            paramsTypeName = `${pascal}Req`;
+        }
+        if (resHeadersSchema != null) {
+            const body = await convertBody(resHeadersSchema, ctx);
+            if (body != null)
+                declarations.push(`export type ${pascal}ResponseHeaders = ${body}`);
+        }
+        if (yieldSchema != null) {
+            const body = await convertBody(yieldSchema, ctx);
+            if (body != null) {
+                declarations.push(`export type ${pascal}Yield = ${body}`);
+                yieldTypeName = `${pascal}Yield`;
+            }
+        }
+        if (returnSchema != null) {
+            const body = await convertBody(returnSchema, ctx);
+            if (body != null) {
+                declarations.push(`export type ${pascal}ReturnType = ${body}`);
+                returnTypeName = `${pascal}ReturnType`;
+            }
+        }
+    }
+    const callable = [
+        buildCallableJsDoc({
+            methodLabel: route.method.toUpperCase(),
+            path: route.fullPath,
+            errorsRef: null,
+        }),
+        `    ${route.name}(req: ${paramsTypeName}, options?: ProcedureCallOptions): TypedStream<${yieldTypeName}, ${returnTypeName}> {`,
+        `      return client.stream<${yieldTypeName}, ${returnTypeName}>({`,
+        `        name: '${route.name}',`,
+        `        scope: '${scopeStr}',`,
+        `        path: '${route.fullPath}',`,
+        `        method: '${route.method}',`,
+        `        kind: 'http-stream',`,
+        `        streamMode: '${route.streamMode}',`,
+        `        params: req,`,
+        `      }, options)`,
+        `    },`,
+    ].join('\n');
+    const hasErrors = injectRouteErrors(declarations, pascal, buildErrorUnion(route.errors, ctx), ctx.namespaceTypes);
+    return { typeDeclarations: declarations, callable, hasStream: true, hasErrors };
+}
+//# sourceMappingURL=http-stream-route.js.map

package/build/codegen/emit/http-stream-route.js.map

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

package/build/codegen/emit/route-shared.d.ts

@@ -0,0 +1,37 @@
+import type { EmitRouteContext } from './context.js';
+/**
+ * Returns the PascalCase display name for a route, appending `V{version}`
+ * when version > 1. Version 1 produces no suffix for backward compatibility.
+ */
+export declare function versionedPascal(name: string, version: number | undefined): string;
+/**
+ * Builds the body of an `Errors` type union from the route's declared error
+ * keys. Filters to keys actually emitted in `_errors.ts` so generated code
+ * never references undefined types.
+ *
+ * In namespace mode the union uses qualified names (`ApiErrors.UseCaseError`);
+ * in flat mode it uses the bundled wildcard import alias (`_errors.UseCaseError`).
+ * Returns `null` when no keys remain.
+ */
+export declare function buildErrorUnion(routeErrors: string[] | undefined, ctx: EmitRouteContext): string | null;
+/**
+ * Injects `export type Errors = ...` into an existing route namespace block
+ * (namespace mode) or appends a flat `export type ${pascal}Errors = ...` in
+ * flat mode. An errors-only route (no req/res/params types) has no namespace
+ * block yet, so one is created to house the union — the typed callable always
+ * references `Scope.Route.Errors`, which must resolve (DX #6). Mutates the
+ * `declarations` array in place and returns whether an injection happened.
+ */
+export declare function injectRouteErrors(declarations: string[], routePascal: string, errorUnion: string | null, namespaceTypes: boolean): boolean;
+/**
+ * Builds the multi-line JSDoc comment for a route callable. Surfaces the
+ * second `options` argument (the per-call AbortSignal/timeout seam — DX #8) and,
+ * for routes that declare typed errors, points at the route's `Errors` type and
+ * how to narrow it on the throwing path (DX #10). Indented for placement inside
+ * the bind-object (4 spaces).
+ */
+export declare function buildCallableJsDoc(opts: {
+    methodLabel: string;
+    path: string;
+    errorsRef: string | null;
+}): string;