ts-procedures 7.2.0 → 8.0.0

package/build/create-http-stream.test.js

@@ -0,0 +1,88 @@
+import { describe, it, expect } from 'vitest';
+import { Procedures } from './index.js';
+import { Type } from 'typebox';
+import { ProcedureValidationError } from './errors.js';
+describe('CreateHttpStream basic generator', () => {
+    it('registers with kind: http-stream', () => {
+        const procs = Procedures();
+        procs.CreateHttpStream('Tail', {
+            path: '/streams/logs', method: 'get',
+            schema: {
+                req: { query: Type.Object({ source: Type.String() }) },
+                yield: Type.Object({ line: Type.String() }),
+            },
+        }, async function* () { yield { line: 'a' }; });
+        expect(procs.getProcedure('Tail')?.kind).toBe('http-stream');
+    });
+    it('yields and returns', async () => {
+        const procs = Procedures();
+        const { Tail } = procs.CreateHttpStream('Tail', {
+            path: '/streams/logs', method: 'get',
+            schema: {
+                req: { query: Type.Object({ source: Type.String() }) },
+                yield: Type.Object({ line: Type.String() }),
+                returnType: Type.Object({ totalLines: Type.Number() }),
+            },
+        }, async function* (_, { query }) {
+            yield { line: `from-${query.source}-1` };
+            yield { line: `from-${query.source}-2` };
+            return { totalLines: 2 };
+        });
+        const lines = [];
+        let returnVal;
+        const { stream } = await Tail({}, { query: { source: 'app' } });
+        let result = await stream.next();
+        while (!result.done) {
+            lines.push(result.value.line);
+            result = await stream.next();
+        }
+        returnVal = result.value;
+        expect(lines).toEqual(['from-app-1', 'from-app-2']);
+        expect(returnVal).toEqual({ totalLines: 2 });
+    });
+    it('rejects req.query validation error before opening stream', async () => {
+        const procs = Procedures();
+        const { Tail } = procs.CreateHttpStream('Tail', {
+            path: '/streams/logs', method: 'get',
+            schema: {
+                req: { query: Type.Object({ source: Type.String() }) },
+                yield: Type.Object({ line: Type.String() }),
+            },
+        }, async function* () { yield { line: 'should not run' }; });
+        // Two independent async calls — each rejects before a stream is produced.
+        await expect(Tail({}, { query: {} })).rejects.toThrow(ProcedureValidationError);
+        await expect(Tail({}, { query: {} })).rejects.toThrow(/req\.query/);
+    });
+});
+describe('CreateHttpStream async-preamble shape (res.headers)', () => {
+    it('handler returning Promise<{ headers, stream }> surfaces headers in initialHeaders', async () => {
+        const procs = Procedures();
+        const { Tail } = procs.CreateHttpStream('Tail', {
+            path: '/streams/logs', method: 'get',
+            schema: {
+                req: { query: Type.Object({ source: Type.String() }) },
+                yield: Type.Object({ line: Type.String() }),
+                res: { headers: Type.Object({ 'x-stream-id': Type.String() }) },
+            },
+        }, async (_, { query }) => ({
+            headers: { 'x-stream-id': `id-${query.source}` },
+            stream: (async function* () { yield { line: 'a' }; })(),
+        }));
+        const { stream, initialHeaders } = await Tail({}, { query: { source: 'app' } });
+        expect(initialHeaders).toEqual({ 'x-stream-id': 'id-app' });
+        const first = await stream.next();
+        expect(first.value).toEqual({ line: 'a' });
+    });
+    it('throws when handler returns malformed shape', async () => {
+        const procs = Procedures();
+        const { Bad } = procs.CreateHttpStream('Bad', {
+            path: '/streams', method: 'get',
+            schema: {
+                yield: Type.Number(),
+                res: { headers: Type.Object({}) },
+            },
+        }, (async () => 'not-a-shape'));
+        await expect(Bad({}, undefined)).rejects.toThrow(/did not resolve to/);
+    });
+});
+//# sourceMappingURL=create-http-stream.test.js.map

package/build/create-http-stream.test.js.map

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

package/build/create-http.d.ts

@@ -0,0 +1,49 @@
+import { Prettify, TSchemaLib } from './schema/types.js';
+import { captureDefinitionInfo } from './stack-utils.js';
+import { HttpMethod, TBuilderConfig, TCreateHttpConfig, TLocalContext, THttpProcedureRegistration, THttpStreamProcedureRegistration, TProcedureRegistration, TStreamProcedureRegistration } from './types.js';
+type Infer<T> = TSchemaLib<T>;
+export type HttpReturn<TRes> = TRes extends {
+    body: infer B;
+    headers: infer H;
+} ? {
+    body: Infer<B>;
+    headers: Infer<H>;
+} : TRes extends {
+    headers: infer H;
+} ? {
+    headers: Infer<H>;
+} : TRes extends {
+    body: infer B;
+} ? Infer<B> : void;
+export declare function checkPathParamConsistency(procedureName: string, path: string, pathParamsSchema: Record<string, unknown> | undefined, definitionInfo: ReturnType<typeof captureDefinitionInfo>): void;
+export declare function makeCreateHttp<TContext>(procedures: Map<string, TProcedureRegistration<TContext, any> | TStreamProcedureRegistration<TContext, any> | THttpProcedureRegistration<TContext> | THttpStreamProcedureRegistration<TContext>>, builder?: {
+    config?: TBuilderConfig;
+    onCreate?: (procedure: any) => void;
+}): <TName extends string, TReq extends Record<string, unknown> | undefined, TRes extends {
+    body?: unknown;
+    headers?: unknown;
+} | undefined = undefined, TErrorKey extends string = string>(name: TName, config: TCreateHttpConfig<TReq, TRes, TErrorKey>, handler: (ctx: Prettify<TContext & TLocalContext>, req: TReq extends Record<string, unknown> ? Prettify<{ [K in keyof TReq]: TSchemaLib<TReq[K]>; }> : undefined) => Promise<HttpReturn<TRes>>) => { [K in TName]: (ctx: Prettify<TContext>, req: TReq extends Record<string, unknown> ? Prettify<{ [K_1 in keyof TReq]: TSchemaLib<TReq[K_1]>; }> : undefined) => Promise<HttpReturn<TRes>>; } & {
+    procedure: (ctx: Prettify<TContext>, req: TReq extends Record<string, unknown> ? Prettify<{ [K in keyof TReq]: TSchemaLib<TReq[K]>; }> : undefined) => Promise<HttpReturn<TRes>>;
+    info: {
+        path: string;
+        method: HttpMethod;
+        successStatus?: number;
+        scope?: string;
+        errors?: string[];
+        description?: string;
+        schema?: {
+            req?: Record<string, import("./schema/types.js").TJSONSchema>;
+            res?: {
+                body?: import("./schema/types.js").TJSONSchema;
+                headers?: import("./schema/types.js").TJSONSchema;
+            };
+        };
+        validation?: {
+            req?: Record<string, (value: any) => {
+                errors?: any[];
+            }>;
+        };
+        name: TName;
+    };
+};
+export {};

package/build/create-http.js

@@ -0,0 +1,108 @@
+import { ProcedureError, ProcedureRegistrationError, ProcedureValidationError } from './errors.js';
+import { computeSchema } from './schema/compute-schema.js';
+import { captureDefinitionInfo } from './stack-utils.js';
+const PATH_PARAM_RE = /:([a-zA-Z_][a-zA-Z0-9_]*)/g;
+function extractPathParamNames(path) {
+    const matches = path.match(PATH_PARAM_RE);
+    return matches ? matches.map((m) => m.slice(1)) : [];
+}
+export function checkPathParamConsistency(procedureName, path, pathParamsSchema, definitionInfo) {
+    const pathParamNames = extractPathParamNames(path);
+    const hasPathParams = pathParamNames.length > 0;
+    const hasSchema = pathParamsSchema !== undefined;
+    if (hasPathParams && !hasSchema) {
+        throw new ProcedureRegistrationError(procedureName, `Path "${path}" has path parameters [${pathParamNames.join(', ')}] but schema.req.pathParams is not defined.`, definitionInfo);
+    }
+    if (!hasPathParams && hasSchema) {
+        throw new ProcedureRegistrationError(procedureName, `schema.req.pathParams is defined but path "${path}" has no path parameters.`, definitionInfo);
+    }
+    if (hasPathParams && hasSchema) {
+        const schemaProperties = pathParamsSchema.properties;
+        if (schemaProperties) {
+            const schemaKeys = Object.keys(schemaProperties);
+            const missing = pathParamNames.filter((p) => !schemaKeys.includes(p));
+            const extra = schemaKeys.filter((k) => !pathParamNames.includes(k));
+            if (missing.length > 0 || extra.length > 0) {
+                const parts = [];
+                if (missing.length > 0)
+                    parts.push(`path has [${missing.join(', ')}] missing from schema`);
+                if (extra.length > 0)
+                    parts.push(`schema has [${extra.join(', ')}] not in path`);
+                throw new ProcedureRegistrationError(procedureName, `Path param mismatch for "${procedureName}": ${parts.join('; ')}.`, definitionInfo);
+            }
+        }
+    }
+}
+export function makeCreateHttp(procedures, builder) {
+    return function CreateHttp(name, config, handler) {
+        const definitionInfo = captureDefinitionInfo();
+        if (procedures.has(name)) {
+            throw new Error(`Procedure with name ${name} is already registered`);
+        }
+        if (config.schema?.params) {
+            throw new ProcedureRegistrationError(name, `Use schema.req.body (or schema.req.query) instead of schema.params on CreateHttp. Procedure: "${name}".`, definitionInfo);
+        }
+        const { jsonSchema, validations } = computeSchema(name, {
+            req: config.schema.req,
+            res: config.schema.res,
+        }, definitionInfo);
+        const pathParamsSchema = jsonSchema.req?.pathParams;
+        checkPathParamConsistency(name, config.path, pathParamsSchema, definitionInfo);
+        const errorFactory = (message, meta) => new ProcedureError(name, message, meta, definitionInfo);
+        const registeredProcedure = {
+            name,
+            kind: 'http',
+            config: {
+                path: config.path,
+                method: config.method,
+                successStatus: config.successStatus,
+                scope: config.scope,
+                errors: config.errors,
+                description: config.description,
+                schema: jsonSchema,
+                validation: { req: validations.req },
+            },
+            handler: async (ctx, req) => {
+                try {
+                    const skipValidation = ctx.isPrevalidated ||
+                        builder?.config?.noRuntimeValidation;
+                    if (validations?.req && !skipValidation) {
+                        for (const [channel, validator] of Object.entries(validations.req)) {
+                            const channelValue = req?.[channel];
+                            const { errors } = validator(channelValue);
+                            if (errors) {
+                                throw new ProcedureValidationError(name, `Validation error for ${name} in req.${channel}`, errors, definitionInfo);
+                            }
+                        }
+                    }
+                    const localCtx = { error: errorFactory };
+                    return await handler({ ...ctx, ...localCtx }, req);
+                }
+                catch (error) {
+                    if (error instanceof ProcedureError)
+                        throw error;
+                    const err = new ProcedureError(name, `Error in handler for ${name} - ${error?.message}`, undefined, definitionInfo);
+                    err.cause = error;
+                    if (error.stack && definitionInfo.definedAt) {
+                        const { file, line, column } = definitionInfo.definedAt;
+                        err.stack =
+                            error.stack + `\n--- Procedure "${name}" defined at ---\n    at ${file}:${line}:${column}`;
+                    }
+                    else if (error.stack) {
+                        err.stack = error.stack;
+                    }
+                    throw err;
+                }
+            },
+        };
+        procedures.set(name, registeredProcedure);
+        builder?.onCreate?.(registeredProcedure);
+        const info = { name, ...registeredProcedure.config };
+        return {
+            [name]: registeredProcedure.handler,
+            procedure: registeredProcedure.handler,
+            info,
+        };
+    };
+}
+//# sourceMappingURL=create-http.js.map

package/build/create-http.js.map

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

package/build/create-http.test.js

@@ -0,0 +1,137 @@
+import { describe, it, expect, expectTypeOf } from 'vitest';
+import { Procedures } from './index.js';
+import { ProcedureValidationError } from './errors.js';
+import { Type } from 'typebox';
+describe('CreateHttp registration', () => {
+    it('registers with kind: http', () => {
+        const procs = Procedures();
+        procs.CreateHttp('GetUser', {
+            path: '/users/:id',
+            method: 'get',
+            schema: { req: { pathParams: Type.Object({ id: Type.String() }) } },
+        }, async (_, { pathParams }) => ({ id: pathParams.id }));
+        const reg = procs.getProcedure('GetUser');
+        expect(reg?.kind).toBe('http');
+    });
+    it('rejects schema.params with v8 message', () => {
+        const procs = Procedures();
+        expect(() => procs.CreateHttp('Bad', {
+            path: '/x', method: 'get',
+            schema: { params: Type.Object({}) },
+        }, async () => undefined)).toThrow(/Use schema.req.body \(or schema.req.query\) instead of schema.params/);
+    });
+    it('rejects path with params but no pathParams schema', () => {
+        const procs = Procedures();
+        expect(() => procs.CreateHttp('Bad', {
+            path: '/users/:id', method: 'get',
+            schema: { req: {} },
+        }, async () => undefined)).toThrow(/path parameters \[id\] but schema.req.pathParams is not defined/);
+    });
+    it('rejects pathParams schema with no path params', () => {
+        const procs = Procedures();
+        expect(() => procs.CreateHttp('Bad', {
+            path: '/users', method: 'get',
+            schema: { req: { pathParams: Type.Object({ id: Type.String() }) } },
+        }, async () => undefined)).toThrow(/has no path parameters/);
+    });
+    it('rejects pathParams key mismatch', () => {
+        const procs = Procedures();
+        expect(() => procs.CreateHttp('Bad', {
+            path: '/users/:id', method: 'get',
+            schema: { req: { pathParams: Type.Object({ wrongKey: Type.String() }) } },
+        }, async () => undefined)).toThrow(/Path param mismatch/);
+    });
+});
+describe('CreateHttp res.body', () => {
+    it('handler returns body bare when only res.body declared', async () => {
+        const procs = Procedures();
+        const { GetUser } = procs.CreateHttp('GetUser', {
+            path: '/users/:id', method: 'get',
+            schema: {
+                req: { pathParams: Type.Object({ id: Type.String() }) },
+                res: { body: Type.Object({ id: Type.String(), name: Type.String() }) },
+            },
+        }, async (_, { pathParams }) => ({ id: pathParams.id, name: 'Alice' }));
+        const result = await GetUser({}, { pathParams: { id: '1' } });
+        expect(result).toEqual({ id: '1', name: 'Alice' });
+    });
+});
+describe('CreateHttp conditional return shape', () => {
+    it('res: { body, headers } → returns { body, headers }', async () => {
+        const procs = Procedures();
+        const { GetUser } = procs.CreateHttp('GetUser', {
+            path: '/users/:id', method: 'get',
+            schema: {
+                req: { pathParams: Type.Object({ id: Type.String() }) },
+                res: {
+                    body: Type.Object({ id: Type.String() }),
+                    headers: Type.Object({ 'x-rate-limit': Type.String() }),
+                },
+            },
+        }, async (_, { pathParams }) => ({
+            body: { id: pathParams.id },
+            headers: { 'x-rate-limit': '99' },
+        }));
+        const result = await GetUser({}, { pathParams: { id: '1' } });
+        expect(result).toEqual({ body: { id: '1' }, headers: { 'x-rate-limit': '99' } });
+    });
+    it('res: { headers } only → returns { headers }', async () => {
+        const procs = Procedures();
+        const { Healthcheck } = procs.CreateHttp('Healthcheck', {
+            path: '/health', method: 'get',
+            schema: {
+                res: { headers: Type.Object({ 'x-version': Type.String() }) },
+            },
+        }, async () => ({ headers: { 'x-version': '8.0.0' } }));
+        const result = await Healthcheck({}, undefined);
+        expect(result).toEqual({ headers: { 'x-version': '8.0.0' } });
+    });
+    it('no res → returns void', async () => {
+        const procs = Procedures();
+        const { Ping } = procs.CreateHttp('Ping', {
+            path: '/ping', method: 'post',
+            schema: { req: { body: Type.Object({}) } },
+        }, async () => undefined);
+        const result = await Ping({}, { body: {} });
+        expect(result).toBeUndefined();
+    });
+});
+describe('CreateHttp HttpReturn type inference', () => {
+    it('infers correct return shapes', () => {
+        const procs = Procedures();
+        const { GetUser } = procs.CreateHttp('GetUser', {
+            path: '/users/:id', method: 'get',
+            schema: {
+                req: { pathParams: Type.Object({ id: Type.String() }) },
+                res: {
+                    body: Type.Object({ id: Type.String() }),
+                    headers: Type.Object({ 'x-rate-limit': Type.String() }),
+                },
+            },
+        }, async () => ({ body: { id: '1' }, headers: { 'x-rate-limit': '99' } }));
+        expectTypeOf().toEqualTypeOf();
+    });
+});
+describe('CreateHttp req channel validation', () => {
+    it('validates each channel independently with channel-tagged error', async () => {
+        const procs = Procedures();
+        const { GetUser } = procs.CreateHttp('GetUser', {
+            path: '/users/:id', method: 'get',
+            schema: {
+                req: {
+                    pathParams: Type.Object({ id: Type.String() }),
+                    query: Type.Object({ limit: Type.Number() }),
+                },
+            },
+        }, async (_, { pathParams, query }) => ({ id: pathParams.id, limit: query.limit }));
+        await expect(GetUser({}, {
+            pathParams: { id: 'abc' },
+            query: { limit: 'not-a-number' },
+        })).rejects.toThrow(ProcedureValidationError);
+        await expect(GetUser({}, {
+            pathParams: { id: 'abc' },
+            query: { limit: 'not-a-number' },
+        })).rejects.toThrow(/req\.query/);
+    });
+});
+//# sourceMappingURL=create-http.test.js.map

package/build/create-http.test.js.map

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

package/build/create-stream.d.ts

@@ -0,0 +1,35 @@
+import { Prettify, TSchemaLib } from './schema/types.js';
+import { TBuilderConfig, THttpProcedureRegistration, THttpStreamProcedureRegistration, TStreamContext, TProcedureRegistration, TStreamProcedureRegistration } from './types.js';
+export type CreateStreamBuilderArg<TContext, TExtendedConfig> = {
+    config?: TBuilderConfig;
+    onCreate?: (procedure: TProcedureRegistration<TContext, TExtendedConfig> | TStreamProcedureRegistration<TContext, TExtendedConfig>) => void;
+};
+export declare function makeCreateStream<TContext, TExtendedConfig>(procedures: Map<string, TProcedureRegistration<TContext, TExtendedConfig> | TStreamProcedureRegistration<TContext, TExtendedConfig> | THttpProcedureRegistration<TContext> | THttpStreamProcedureRegistration<TContext>>, builder?: CreateStreamBuilderArg<TContext, TExtendedConfig>): <TName extends string, TParams, TYieldType, TReturnType = void>(name: TName, config: {
+    description?: string;
+    schema?: {
+        params?: TParams;
+        yieldType?: TYieldType;
+        returnType?: TReturnType;
+    };
+    validateYields?: boolean;
+} & TExtendedConfig, handler: (ctx: Prettify<TContext & TStreamContext>, params: TSchemaLib<TParams>) => AsyncGenerator<TSchemaLib<TYieldType>, TSchemaLib<TReturnType> | void, unknown>) => { [K in TName]: (ctx: Prettify<TContext>, params: TSchemaLib<TParams>) => AsyncGenerator<TSchemaLib<TYieldType>, TSchemaLib<TReturnType> | void, unknown>; } & {
+    procedure: (ctx: Prettify<TContext>, params: TSchemaLib<TParams>) => AsyncGenerator<TSchemaLib<TYieldType>, TSchemaLib<TReturnType> | void, unknown>;
+    info: {
+        name: TName;
+        isStream: true;
+        description?: string;
+        schema: {
+            params?: TParams;
+            yieldType?: TYieldType;
+            returnType?: TReturnType;
+        };
+        validation?: {
+            params?: (params: any) => {
+                errors?: any[];
+            };
+            yield?: (value: any) => {
+                errors?: any[];
+            };
+        };
+    } & TExtendedConfig;
+};

package/build/create-stream.js

@@ -0,0 +1,123 @@
+import { ProcedureError, ProcedureRegistrationError, ProcedureValidationError, ProcedureYieldValidationError } from './errors.js';
+import { computeSchema } from './schema/compute-schema.js';
+import { captureDefinitionInfo } from './stack-utils.js';
+export function makeCreateStream(procedures, builder) {
+    return function CreateStream(name, config, handler) {
+        // Capture definition location as first action
+        const definitionInfo = captureDefinitionInfo();
+        const HTTP_FIELDS = ['path', 'method', 'req', 'res', 'successStatus'];
+        const presentHttpFields = HTTP_FIELDS.filter((f) => config[f] !== undefined);
+        if (presentHttpFields.length > 0) {
+            throw new ProcedureRegistrationError(name, `HTTP fields require CreateHttp / CreateHttpStream. Procedure "${name}" has [${presentHttpFields.join(', ')}] which are not valid on CreateStream.`, definitionInfo);
+        }
+        // BEFORE computeSchema - fail fast on duplicate
+        if (procedures.has(name)) {
+            throw new Error(`Procedure with name ${name} is already registered`);
+        }
+        const { jsonSchema, validations } = computeSchema(name, config.schema, definitionInfo);
+        // Create error factory once at registration time (outside handler)
+        const errorFactory = (message, meta) => {
+            return new ProcedureError(name, message, meta, definitionInfo);
+        };
+        const validateYields = config.validateYields ?? false;
+        const registeredProcedure = {
+            name,
+            kind: 'rpc-stream',
+            isStream: true,
+            config: {
+                ...config,
+                description: config.description,
+                schema: jsonSchema,
+                validation: {
+                    params: validations.params,
+                    yield: validations.yield,
+                },
+            },
+            handler: async function* wrappedHandler(ctx, params) {
+                // Create abort controller for this stream
+                const abortController = new AbortController();
+                // Skip validation if caller has already validated (e.g., HonoAppBuilder) or if builder config dictates noRuntimeValidation
+                const skipValidation = ctx.isPrevalidated ||
+                    builder?.config?.noRuntimeValidation;
+                if (validations?.params && !skipValidation) {
+                    const { errors } = validations.params(params);
+                    if (errors) {
+                        throw new ProcedureValidationError(name, `Validation error for ${name}`, errors, definitionInfo);
+                    }
+                }
+                // Combine with external signal (e.g., from HTTP request) if provided
+                const incomingSignal = ctx.signal;
+                const signal = incomingSignal
+                    ? AbortSignal.any([incomingSignal, abortController.signal])
+                    : abortController.signal;
+                const streamCtx = {
+                    error: errorFactory,
+                    signal,
+                };
+                // params is correctly typed at the public API boundary via conditional type;
+                // cast here because TS cannot narrow conditional generics inside implementations
+                const userGenerator = handler({
+                    ...ctx,
+                    ...streamCtx,
+                }, params);
+                const userIterator = userGenerator[Symbol.asyncIterator]();
+                try {
+                    let userIterResult = await userIterator.next();
+                    while (!userIterResult.done) {
+                        const value = userIterResult.value;
+                        // Only validate if explicitly enabled via validateYields: true
+                        if (validateYields && validations.yield) {
+                            const { errors } = validations.yield(value);
+                            if (errors) {
+                                throw new ProcedureYieldValidationError(name, `Yield validation error for ${name}`, errors, definitionInfo);
+                            }
+                        }
+                        yield value;
+                        userIterResult = await userIterator.next();
+                    }
+                    // Propagate the generator's return value so consumers (e.g. HonoAppBuilder)
+                    // can send it as a special 'return' SSE event
+                    return userIterResult.value;
+                }
+                catch (error) {
+                    // Preserve the original error class so HTTP builders' taxonomies and
+                    // `onMidStreamError` callbacks see the actual thrown type — boxing
+                    // user-defined errors inside ProcedureError defeats route-declared
+                    // typed-error dispatch on the client. Augment the stack trace in
+                    // place with the procedure's definition site when available.
+                    if (definitionInfo.definedAt && error && typeof error.stack === 'string') {
+                        const { file, line, column } = definitionInfo.definedAt;
+                        error.stack = `${error.stack}\n--- Procedure "${name}" defined at ---\n    at ${file}:${line}:${column}`;
+                    }
+                    throw error;
+                }
+                finally {
+                    // Propagate `.return()` to the user generator so its `finally`
+                    // blocks (and any `signal`-driven cleanup) run when the consumer
+                    // closes the stream early. No-op when iteration already completed.
+                    try {
+                        await userIterator.return?.(undefined);
+                    }
+                    catch {
+                        // Swallow — cleanup must not mask the primary error path
+                    }
+                    abortController.abort('stream-completed');
+                }
+            },
+        };
+        procedures.set(name, registeredProcedure);
+        builder?.onCreate?.(registeredProcedure);
+        const info = {
+            name,
+            isStream: true,
+            ...registeredProcedure.config,
+        };
+        // return so can be called directly (ie: int/unit tests)
+        return {
+            [name]: registeredProcedure.handler,
+            procedure: registeredProcedure.handler,
+            info,
+        };
+    };
+}
+//# sourceMappingURL=create-stream.js.map

package/build/create-stream.js.map

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