ts-procedures 7.3.0 → 8.0.0

package/build/create-stream.test.js

@@ -0,0 +1,428 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import { describe, expect, test } from 'vitest';
+import { Procedures } from './index.js';
+import { v } from 'suretype';
+import { Type } from 'typebox';
+import { ProcedureError, ProcedureValidationError } from './errors.js';
+describe('Streaming Procedures - CreateStream', () => {
+    test('CreateStream creates a streaming procedure', async () => {
+        const { CreateStream } = Procedures();
+        const { StreamTest, procedure, info } = CreateStream('StreamTest', {
+            description: 'Test streaming procedure',
+            schema: {
+                params: v.object({ count: v.number().required() }),
+                yieldType: v.object({ value: v.number().required() }),
+            },
+        }, async function* (ctx, params) {
+            for (let i = 0; i < params.count; i++) {
+                yield { value: i };
+            }
+        });
+        expect(StreamTest).toBeDefined();
+        expect(procedure).toBeDefined();
+        expect(info.isStream).toBe(true);
+        expect(info.name).toBe('StreamTest');
+        expect(info.description).toBe('Test streaming procedure');
+        expect(info.schema.params).toEqual({
+            type: 'object',
+            properties: { count: { type: 'number' } },
+            required: ['count'],
+        });
+        expect(info.schema.yieldType).toEqual({
+            type: 'object',
+            properties: { value: { type: 'number' } },
+            required: ['value'],
+        });
+        // Collect yielded values
+        const values = [];
+        for await (const val of StreamTest({}, { count: 3 })) {
+            values.push(val);
+        }
+        expect(values).toEqual([{ value: 0 }, { value: 1 }, { value: 2 }]);
+    });
+    test('CreateStream validates params', async () => {
+        const { CreateStream } = Procedures();
+        const { StreamWithParams } = CreateStream('StreamWithParams', {
+            schema: {
+                params: v.object({ name: v.string().required() }),
+                yieldType: v.string(),
+            },
+        }, async function* (ctx, params) {
+            yield params.name;
+        });
+        // Missing required param should throw ProcedureValidationError
+        try {
+            // @ts-expect-error - intentionally passing invalid params
+            for await (const _val of StreamWithParams({}, {})) {
+                // Should not reach here
+            }
+            expect.fail('Should have thrown');
+        }
+        catch (e) {
+            expect(e).toBeInstanceOf(ProcedureValidationError);
+            expect(e.message).toContain('Validation error for StreamWithParams');
+        }
+    });
+    test('CreateStream with validateYields validates each yielded value', async () => {
+        const { CreateStream } = Procedures();
+        const { ProcedureYieldValidationError } = await import('./errors.js');
+        const { StreamValidateYields } = CreateStream('StreamValidateYields', {
+            schema: {
+                yieldType: v.object({ id: v.number().required() }),
+            },
+            validateYields: true,
+        }, async function* () {
+            yield { id: 1 }; // Valid
+            yield { id: 'not-a-number' }; // Invalid - should throw
+        });
+        const values = [];
+        try {
+            for await (const val of StreamValidateYields({}, {})) {
+                values.push(val);
+            }
+            expect.fail('Should have thrown on invalid yield');
+        }
+        catch (e) {
+            expect(e).toBeInstanceOf(ProcedureYieldValidationError);
+            expect(e.message).toContain('Yield validation error for StreamValidateYields');
+            expect(values).toEqual([{ id: 1 }]); // First value was valid
+        }
+    });
+    test('CreateStream without validateYields does not validate yields', async () => {
+        const { CreateStream } = Procedures();
+        const { StreamNoValidate } = CreateStream('StreamNoValidate', {
+            schema: {
+                yieldType: v.object({ id: v.number().required() }),
+            },
+            // validateYields defaults to false
+        }, async function* () {
+            yield { id: 1 };
+            yield { id: 'not-a-number' }; // Invalid but won't throw
+        });
+        const values = [];
+        for await (const val of StreamNoValidate({}, {})) {
+            values.push(val);
+        }
+        expect(values).toEqual([{ id: 1 }, { id: 'not-a-number' }]);
+    });
+    test('CreateStream ctx.error throws ProcedureError', async () => {
+        const { CreateStream } = Procedures();
+        const { StreamError } = CreateStream('StreamError', {}, async function* (ctx) {
+            yield 'first';
+            throw ctx.error('Custom stream error', { code: 'STREAM_ERR' });
+        });
+        const values = [];
+        try {
+            for await (const val of StreamError({}, {})) {
+                values.push(val);
+            }
+            expect.fail('Should have thrown');
+        }
+        catch (e) {
+            expect(e).toBeInstanceOf(ProcedureError);
+            expect(e.message).toBe('Custom stream error');
+            expect(e.procedureName).toBe('StreamError');
+            expect(e.meta).toEqual({ code: 'STREAM_ERR' });
+            expect(values).toEqual(['first']);
+        }
+    });
+    test('CreateStream provides ctx.signal for abort handling', async () => {
+        const { CreateStream } = Procedures();
+        let signalReceived = false;
+        const { StreamWithSignal } = CreateStream('StreamWithSignal', {}, async function* (ctx) {
+            expect(ctx.signal).toBeDefined();
+            expect(ctx.signal).toBeInstanceOf(AbortSignal);
+            signalReceived = true;
+            yield 'value';
+        });
+        for await (const _val of StreamWithSignal({}, {})) {
+            // consume
+        }
+        expect(signalReceived).toBe(true);
+    });
+    test('CreateStream onCreate callback receives isStream flag', () => new Promise((done) => {
+        let receivedProc;
+        const { CreateStream } = Procedures({
+            onCreate: (proc) => {
+                receivedProc = proc;
+            },
+        });
+        CreateStream('OnCreateStream', {}, async function* () {
+            yield 'test';
+        });
+        expect(receivedProc).toBeDefined();
+        expect(receivedProc.isStream).toBe(true);
+        expect(receivedProc.name).toBe('OnCreateStream');
+        done();
+    }));
+    test('CreateStream duplicate registration throws', () => {
+        const { CreateStream } = Procedures();
+        CreateStream('DuplicateStream', {}, async function* () {
+            yield 'first';
+        });
+        expect(() => {
+            CreateStream('DuplicateStream', {}, async function* () {
+                yield 'second';
+            });
+        }).toThrow('Procedure with name DuplicateStream is already registered');
+    });
+    test('CreateStream error includes definition location', async () => {
+        const { CreateStream } = Procedures();
+        const { StreamErrorLocation } = CreateStream('StreamErrorLocation', {
+            schema: {
+                params: v.object({ id: v.number().required() }),
+            },
+        }, async function* () {
+            yield 'test';
+        });
+        try {
+            // @ts-expect-error - intentionally passing invalid params
+            for await (const _val of StreamErrorLocation({}, {})) {
+                // consume
+            }
+            expect.fail('Should have thrown');
+        }
+        catch (e) {
+            expect(e.definedAt).toBeDefined();
+            expect(e.definedAt.file).toContain('create-stream.test.ts');
+            expect(e.stack).toContain('--- Procedure "StreamErrorLocation" defined at ---');
+        }
+    });
+    test('CreateStream with Typebox schema', async () => {
+        const { CreateStream } = Procedures();
+        const { TypeboxStream } = CreateStream('TypeboxStream', {
+            schema: {
+                params: Type.Object({ limit: Type.Number() }),
+                yieldType: Type.Object({ data: Type.String() }),
+            },
+        }, async function* (ctx, params) {
+            for (let i = 0; i < params.limit; i++) {
+                yield { data: `item-${i}` };
+            }
+        });
+        const values = [];
+        for await (const val of TypeboxStream({}, { limit: 2 })) {
+            values.push(val);
+        }
+        expect(values).toEqual([{ data: 'item-0' }, { data: 'item-1' }]);
+    });
+    test('CreateStream with context type', async () => {
+        const { CreateStream } = Procedures();
+        const { ContextStream } = CreateStream('ContextStream', {}, async function* (ctx) {
+            // ctx should have both userId and error
+            expect(ctx.userId).toBe('user-123');
+            expect(ctx.error).toBeDefined();
+            expect(ctx.signal).toBeDefined();
+            yield ctx.userId;
+        });
+        const values = [];
+        for await (const val of ContextStream({ userId: 'user-123' }, {})) {
+            values.push(val);
+        }
+        expect(values).toEqual(['user-123']);
+    });
+    test('CreateStream rethrows the original error preserving class identity', async () => {
+        // The streaming wrapper must NOT box user errors inside ProcedureError —
+        // doing so would defeat route-declared typed-error dispatch on the client
+        // (the HTTP builder's taxonomy would see `ProcedureError` instead of the
+        // user's class). Stack annotation is added in place; class identity and
+        // custom properties are preserved.
+        class MyDomainError extends Error {
+            name = 'MyDomainError';
+            code = 'STREAM_FAIL';
+        }
+        const { CreateStream } = Procedures();
+        const originalError = new MyDomainError('Stream underlying error');
+        const { StreamCause } = CreateStream('StreamCause', {}, 
+        // eslint-disable-next-line require-yield
+        async function* () {
+            throw originalError;
+        });
+        try {
+            for await (const _val of StreamCause({}, {})) {
+                // consume
+            }
+            expect.fail('Should have thrown');
+        }
+        catch (e) {
+            expect(e).toBe(originalError);
+            expect(e).toBeInstanceOf(MyDomainError);
+            expect(e.code).toBe('STREAM_FAIL');
+        }
+    });
+    test('CreateStream propagates .return() to the user generator', async () => {
+        // Consumers that close a stream early (via `iterator.return()` or breaking
+        // out of for-await) must trigger the user generator's `finally` block so
+        // cleanup (db handles, subscriptions, signal-driven teardown) runs.
+        const { CreateStream } = Procedures();
+        let finallyRan = false;
+        const { EarlyClose } = CreateStream('EarlyClose', {}, async function* () {
+            try {
+                yield 1;
+                yield 2;
+                yield 3;
+            }
+            finally {
+                finallyRan = true;
+            }
+        });
+        const iter = EarlyClose({}, {});
+        const first = await iter.next();
+        expect(first.value).toBe(1);
+        await iter.return(undefined);
+        expect(finallyRan).toBe(true);
+    });
+    test('CreateStream with extended config', () => {
+        const { CreateStream } = Procedures();
+        const { info } = CreateStream('ExtendedStream', {
+            scope: 'api',
+            version: 1,
+            description: 'Extended config stream',
+        }, async function* () {
+            yield 'data';
+        });
+        expect(info.scope).toBe('api');
+        expect(info.version).toBe(1);
+        expect(info.description).toBe('Extended config stream');
+        expect(info.isStream).toBe(true);
+    });
+    test('CreateStream signal.aborted becomes true after generator completes', async () => {
+        const { CreateStream } = Procedures();
+        let capturedSignal = null;
+        const { AbortStream } = CreateStream('AbortStream', {}, async function* (ctx) {
+            capturedSignal = ctx.signal;
+            yield 'value';
+        });
+        // Consume the generator
+        for await (const _val of AbortStream({}, {})) {
+            // consume
+        }
+        // After generator completes, signal should be aborted
+        expect(capturedSignal).not.toBeNull();
+        expect(capturedSignal.aborted).toBe(true);
+    });
+    test('CreateStream signal.reason is stream-completed after normal completion', async () => {
+        const { CreateStream } = Procedures();
+        let capturedSignal = null;
+        const { ReasonStream } = CreateStream('ReasonStream', {}, async function* (ctx) {
+            capturedSignal = ctx.signal;
+            yield 'value';
+        });
+        for await (const _val of ReasonStream({}, {})) {
+            // consume
+        }
+        expect(capturedSignal.reason).toBe('stream-completed');
+    });
+    test('CreateStream combines external signal with internal signal', async () => {
+        const { CreateStream } = Procedures();
+        const externalAc = new AbortController();
+        let capturedSignal = null;
+        const { CombinedStream } = CreateStream('CombinedStream', {}, async function* (ctx) {
+            capturedSignal = ctx.signal;
+            // Combined signal is a new object, not the raw external signal
+            expect(ctx.signal).not.toBe(externalAc.signal);
+            yield 'value';
+        });
+        // Abort external before consuming — combined signal should reflect it
+        externalAc.abort('client-disconnected');
+        for await (const _val of CombinedStream({ signal: externalAc.signal }, {})) {
+            // consume
+        }
+        expect(capturedSignal.aborted).toBe(true);
+        // Reason comes from external abort, not internal 'stream-completed'
+        expect(capturedSignal.reason).toBe('client-disconnected');
+    });
+});
+describe('isPrevalidated context property', () => {
+    test('CreateStream skips validation when ctx.isPrevalidated is true', async () => {
+        const { CreateStream } = Procedures();
+        const { StreamSkipValidation } = CreateStream('StreamSkipValidation', {
+            schema: {
+                params: v.object({ count: v.number().required() }),
+            },
+        }, async function* (ctx, params) {
+            yield { received: params };
+        });
+        // With isPrevalidated: true, validation is skipped even with invalid params
+        const values = [];
+        for await (const val of StreamSkipValidation({ isPrevalidated: true }, {})) {
+            values.push(val);
+        }
+        expect(values).toEqual([{ received: {} }]);
+    });
+    test('CreateStream validates when ctx.isPrevalidated is false', async () => {
+        const { CreateStream } = Procedures();
+        const { StreamValidate } = CreateStream('StreamValidate', {
+            schema: {
+                params: v.object({ count: v.number().required() }),
+            },
+        }, async function* (ctx, params) {
+            yield { received: params };
+        });
+        // With isPrevalidated: false, validation should run
+        try {
+            for await (const _val of StreamValidate({ isPrevalidated: false }, {})) {
+                // consume
+            }
+            expect.fail('Should have thrown validation error');
+        }
+        catch (e) {
+            expect(e).toBeInstanceOf(ProcedureValidationError);
+        }
+    });
+    test('CreateStream validates when ctx.isPrevalidated is undefined', async () => {
+        const { CreateStream } = Procedures();
+        const { StreamValidateUndefined } = CreateStream('StreamValidateUndefined', {
+            schema: {
+                params: v.object({ value: v.string().required() }),
+            },
+        }, async function* (ctx, params) {
+            yield params;
+        });
+        // Without isPrevalidated property, validation should run
+        try {
+            for await (const _val of StreamValidateUndefined({}, {})) {
+                // consume
+            }
+            expect.fail('Should have thrown validation error');
+        }
+        catch (e) {
+            expect(e).toBeInstanceOf(ProcedureValidationError);
+        }
+    });
+});
+describe('builder.config.noRuntimeValidation', () => {
+    test('CreateStream skips params validation when noRuntimeValidation is true', async () => {
+        const { CreateStream } = Procedures({ config: { noRuntimeValidation: true } });
+        const { StreamSkipParams } = CreateStream('StreamSkipParams', {
+            schema: {
+                params: Type.Object({ count: Type.Number() }),
+            },
+        }, async function* (_ctx, params) {
+            yield { received: params };
+        });
+        const values = [];
+        for await (const val of StreamSkipParams({}, {})) {
+            values.push(val);
+        }
+        expect(values).toEqual([{ received: {} }]);
+    });
+    // migrated to schema.req in Phase 3+ (CreateHttpStream)
+    test.todo('CreateStream skips input channel validation when noRuntimeValidation is true');
+    test('CreateStream still validates when noRuntimeValidation is omitted', async () => {
+        const { CreateStream } = Procedures({ config: {} });
+        const { StreamValidateDefault } = CreateStream('StreamValidateDefault', {
+            schema: {
+                params: Type.Object({ count: Type.Number() }),
+            },
+        }, async function* (_ctx, params) {
+            yield params;
+        });
+        await expect(async () => {
+            for await (const _v of StreamValidateDefault({}, {})) {
+                // consume
+            }
+        }).rejects.toBeInstanceOf(ProcedureValidationError);
+    });
+});
+//# sourceMappingURL=create-stream.test.js.map

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

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

package/build/create.d.ts

@@ -0,0 +1,28 @@
+import { Prettify, TSchemaLib } from './schema/types.js';
+import { TBuilderConfig, THttpProcedureRegistration, THttpStreamProcedureRegistration, TLocalContext, TProcedureRegistration, TStreamProcedureRegistration } from './types.js';
+export type CreateBuilderArg<TContext, TExtendedConfig> = {
+    config?: TBuilderConfig;
+    onCreate?: (procedure: TProcedureRegistration<TContext, TExtendedConfig> | TStreamProcedureRegistration<TContext, TExtendedConfig>) => void;
+};
+export declare function makeCreate<TContext, TExtendedConfig>(procedures: Map<string, TProcedureRegistration<TContext, TExtendedConfig> | TStreamProcedureRegistration<TContext, TExtendedConfig> | THttpProcedureRegistration<TContext> | THttpStreamProcedureRegistration<TContext>>, builder?: CreateBuilderArg<TContext, TExtendedConfig>): <TName extends string, TParams, TReturnType>(name: TName, config: {
+    description?: string;
+    schema?: {
+        params?: TParams;
+        returnType?: TReturnType;
+    };
+} & TExtendedConfig, handler: (ctx: Prettify<TContext & TLocalContext>, params: TSchemaLib<TParams>) => Promise<TSchemaLib<TReturnType>>) => { [K in TName]: (ctx: Prettify<TContext>, params: TSchemaLib<TParams>) => Promise<TSchemaLib<TReturnType>>; } & {
+    procedure: (ctx: Prettify<TContext>, params: TSchemaLib<TParams>) => Promise<TSchemaLib<TReturnType>>;
+    info: {
+        name: TName;
+        description?: string;
+        schema: {
+            params?: TParams;
+            returnType?: TReturnType;
+        };
+        validation?: {
+            params?: (params: any) => {
+                errors?: any[];
+            };
+        };
+    } & TExtendedConfig;
+};

package/build/create.js

@@ -0,0 +1,82 @@
+import { ProcedureError, ProcedureRegistrationError, ProcedureValidationError } from './errors.js';
+import { computeSchema } from './schema/compute-schema.js';
+import { captureDefinitionInfo } from './stack-utils.js';
+export function makeCreate(procedures, builder) {
+    return function Create(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 Create.`, 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) => new ProcedureError(name, message, meta, definitionInfo);
+        const registeredProcedure = {
+            name,
+            kind: 'rpc',
+            config: {
+                ...config,
+                description: config.description,
+                schema: jsonSchema,
+                validation: {
+                    params: validations.params,
+                },
+            },
+            handler: async (ctx, params) => {
+                try {
+                    // Skip validation if caller has already validated 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);
+                        }
+                    }
+                    const localCtx = {
+                        error: errorFactory,
+                    };
+                    // params is correctly typed at the public API boundary;
+                    // cast here because TS cannot narrow generics inside implementations
+                    return await handler({ ...ctx, ...localCtx }, params);
+                }
+                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;
+                    // Preserve original stack but append definition info
+                    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 so can be called directly (ie: int/unit tests)
+        return {
+            [name]: registeredProcedure.handler,
+            procedure: registeredProcedure.handler,
+            info,
+        };
+    };
+}
+//# sourceMappingURL=create.js.map

package/build/create.js.map

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