ts-procedures 5.9.1 → 5.10.2

package/build/src/errors.js

@@ -0,0 +1,91 @@
+import { formatDefinitionInfo } from './stack-utils.js';
+import { kebabCase } from 'es-toolkit/string';
+export class ProcedureError extends Error {
+    procedureName;
+    message;
+    meta;
+    cause;
+    definedAt;
+    definitionStack;
+    constructor(procedureName, message, meta, 
+    // Used for error stack trace details
+    definitionInfo) {
+        super(message);
+        this.procedureName = procedureName;
+        this.message = message;
+        this.meta = meta;
+        this.name = 'ProcedureError';
+        if (definitionInfo) {
+            this.definedAt = definitionInfo.definedAt;
+            this.definitionStack = definitionInfo.definitionStack;
+            this.enhanceStack();
+        }
+        // https://www.dannyguo.com/blog/how-to-fix-instanceof-not-working-for-custom-errors-in-typescript/
+        Object.setPrototypeOf(this, ProcedureError.prototype);
+    }
+    /**
+     * Returns a formatted string showing where the procedure was defined.
+     */
+    getDefinitionLocation() {
+        if (!this.definedAt) {
+            return undefined;
+        }
+        return `${this.definedAt.file}:${this.definedAt.line}:${this.definedAt.column}`;
+    }
+    /**
+     * Enhances the error stack with definition location information.
+     */
+    enhanceStack() {
+        if (!this.stack || !this.definedAt) {
+            return;
+        }
+        const definitionSection = formatDefinitionInfo({ definedAt: this.definedAt, definitionStack: this.definitionStack }, this.procedureName);
+        if (definitionSection) {
+            this.stack = this.stack + definitionSection;
+        }
+    }
+}
+export class ProcedureValidationError extends ProcedureError {
+    procedureName;
+    errors;
+    constructor(procedureName, message, errors, 
+    // Used for error stack trace details
+    definitionInfo) {
+        const readableErrors = errors
+            ?.map((err) => `- ${kebabCase(err.instancePath).replace('-', '.')} ${err.message}`)
+            .join(', ');
+        super(procedureName, message + ' ' + readableErrors, { errors }, definitionInfo);
+        this.procedureName = procedureName;
+        this.errors = errors;
+        this.name = 'ProcedureValidationError';
+        // https://www.dannyguo.com/blog/how-to-fix-instanceof-not-working-for-custom-errors-in-typescript/
+        Object.setPrototypeOf(this, ProcedureValidationError.prototype);
+    }
+}
+export class ProcedureRegistrationError extends ProcedureError {
+    procedureName;
+    constructor(procedureName, message, 
+    // Used for error stack trace details
+    definitionInfo) {
+        super(procedureName, message, undefined, definitionInfo);
+        this.procedureName = procedureName;
+        this.name = 'ProcedureRegistrationError';
+        // https://www.dannyguo.com/blog/how-to-fix-instanceof-not-working-for-custom-errors-in-typescript/
+        Object.setPrototypeOf(this, ProcedureRegistrationError.prototype);
+    }
+}
+export class ProcedureYieldValidationError extends ProcedureError {
+    procedureName;
+    errors;
+    constructor(procedureName, message, errors, 
+    // Used for error stack trace details
+    definitionInfo) {
+        super(procedureName, message, undefined, definitionInfo);
+        this.procedureName = procedureName;
+        this.errors = errors;
+        this.name = 'ProcedureYieldValidationError';
+        // https://www.dannyguo.com/blog/how-to-fix-instanceof-not-working-for-custom-errors-in-typescript/
+        Object.setPrototypeOf(this, ProcedureYieldValidationError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/build/src/errors.js.map

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

package/build/src/errors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/src/errors.test.js

@@ -0,0 +1,122 @@
+import { describe, expect, test } from 'vitest';
+import { ProcedureError, ProcedureValidationError, ProcedureRegistrationError, } from './errors.js';
+describe('Error Classes', () => {
+    test('ProcedureError has correct properties', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', { code: 123 });
+        expect(err.name).toBe('ProcedureError');
+        expect(err.procedureName).toBe('TestProc');
+        expect(err.message).toBe('Something failed');
+        expect(err.meta).toEqual({ code: 123 });
+        expect(err instanceof Error).toBe(true);
+    });
+    test('ProcedureValidationError extends ProcedureError', () => {
+        const err = new ProcedureValidationError('TestProc', 'Validation failed', []);
+        expect(err instanceof ProcedureError).toBe(true);
+        expect(err instanceof Error).toBe(true);
+        expect(err.name).toBe('ProcedureValidationError');
+    });
+    test('ProcedureRegistrationError extends ProcedureError', () => {
+        const err = new ProcedureRegistrationError('TestProc', 'Registration failed');
+        expect(err instanceof ProcedureError).toBe(true);
+        expect(err instanceof Error).toBe(true);
+        expect(err.name).toBe('ProcedureRegistrationError');
+        expect(err.procedureName).toBe('TestProc');
+    });
+    test('ProcedureError supports cause property', () => {
+        const cause = new Error('Original error');
+        const err = new ProcedureError('TestProc', 'Wrapped error');
+        err.cause = cause;
+        expect(err.cause).toBe(cause);
+    });
+    test('All error types have consistent procedureName property', () => {
+        const baseErr = new ProcedureError('Proc1', 'message');
+        const validationErr = new ProcedureValidationError('Proc2', 'message', []);
+        const registrationErr = new ProcedureRegistrationError('Proc3', 'message');
+        expect(baseErr.procedureName).toBe('Proc1');
+        expect(validationErr.procedureName).toBe('Proc2');
+        expect(registrationErr.procedureName).toBe('Proc3');
+    });
+});
+describe('Error Classes - Definition Info', () => {
+    const mockDefinitionInfo = {
+        definedAt: {
+            file: '/app/procedures/user.ts',
+            line: 25,
+            column: 3,
+            raw: 'at Object.<anonymous> (/app/procedures/user.ts:25:3)',
+        },
+        definitionStack: 'Error\n    at Object.<anonymous> (/app/procedures/user.ts:25:3)',
+    };
+    test('ProcedureError includes definedAt when provided', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', undefined, mockDefinitionInfo);
+        expect(err.definedAt).toBeDefined();
+        expect(err.definedAt?.file).toBe('/app/procedures/user.ts');
+        expect(err.definedAt?.line).toBe(25);
+        expect(err.definedAt?.column).toBe(3);
+    });
+    test('ProcedureError includes definitionStack when provided', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', undefined, mockDefinitionInfo);
+        expect(err.definitionStack).toBeDefined();
+        expect(err.definitionStack).toContain('/app/procedures/user.ts');
+    });
+    test('ProcedureError works without definitionInfo (backward compat)', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', { code: 123 });
+        expect(err.definedAt).toBeUndefined();
+        expect(err.definitionStack).toBeUndefined();
+        expect(err.procedureName).toBe('TestProc');
+        expect(err.message).toBe('Something failed');
+        expect(err.meta).toEqual({ code: 123 });
+    });
+    test('ProcedureValidationError includes definedAt when provided', () => {
+        const err = new ProcedureValidationError('TestProc', 'Validation failed', [], mockDefinitionInfo);
+        expect(err.definedAt).toBeDefined();
+        expect(err.definedAt?.file).toBe('/app/procedures/user.ts');
+        expect(err.definedAt?.line).toBe(25);
+    });
+    test('ProcedureValidationError works without definitionInfo (backward compat)', () => {
+        const err = new ProcedureValidationError('TestProc', 'Validation failed', []);
+        expect(err.definedAt).toBeUndefined();
+        expect(err.definitionStack).toBeUndefined();
+        expect(err.name).toBe('ProcedureValidationError');
+    });
+    test('ProcedureRegistrationError includes definedAt when provided', () => {
+        const err = new ProcedureRegistrationError('TestProc', 'Registration failed', mockDefinitionInfo);
+        expect(err.definedAt).toBeDefined();
+        expect(err.definedAt?.file).toBe('/app/procedures/user.ts');
+    });
+    test('ProcedureRegistrationError works without definitionInfo (backward compat)', () => {
+        const err = new ProcedureRegistrationError('TestProc', 'Registration failed');
+        expect(err.definedAt).toBeUndefined();
+        expect(err.definitionStack).toBeUndefined();
+        expect(err.name).toBe('ProcedureRegistrationError');
+    });
+    test('getDefinitionLocation returns formatted location string', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', undefined, mockDefinitionInfo);
+        const location = err.getDefinitionLocation();
+        expect(location).toBe('/app/procedures/user.ts:25:3');
+    });
+    test('getDefinitionLocation returns undefined when no definedAt', () => {
+        const err = new ProcedureError('TestProc', 'Something failed');
+        const location = err.getDefinitionLocation();
+        expect(location).toBeUndefined();
+    });
+    test('enhanced stack contains definition location', () => {
+        const err = new ProcedureError('TestProc', 'Something failed', undefined, mockDefinitionInfo);
+        expect(err.stack).toContain('--- Procedure "TestProc" defined at ---');
+        expect(err.stack).toContain('/app/procedures/user.ts:25:3');
+    });
+    test('stack is not modified when no definitionInfo', () => {
+        const err = new ProcedureError('TestProc', 'Something failed');
+        expect(err.stack).toBeDefined();
+        expect(err.stack).not.toContain('--- Procedure');
+    });
+    test('all error types enhance stack with definition location', () => {
+        const baseErr = new ProcedureError('Proc1', 'message', undefined, mockDefinitionInfo);
+        const validationErr = new ProcedureValidationError('Proc2', 'message', [], mockDefinitionInfo);
+        const registrationErr = new ProcedureRegistrationError('Proc3', 'message', mockDefinitionInfo);
+        expect(baseErr.stack).toContain('--- Procedure "Proc1" defined at ---');
+        expect(validationErr.stack).toContain('--- Procedure "Proc2" defined at ---');
+        expect(registrationErr.stack).toContain('--- Procedure "Proc3" defined at ---');
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/build/src/errors.test.js.map

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

package/build/src/exports.d.ts

@@ -0,0 +1,7 @@
+export * from './index.js';
+export * from './errors.js';
+export * from './stack-utils.js';
+export * from './schema/extract-json-schema.js';
+export * from './schema/parser.js';
+export * from './schema/resolve-schema-lib.js';
+export * from './schema/types.js';

package/build/src/exports.js

@@ -0,0 +1,8 @@
+export * from './index.js';
+export * from './errors.js';
+export * from './stack-utils.js';
+export * from './schema/extract-json-schema.js';
+export * from './schema/parser.js';
+export * from './schema/resolve-schema-lib.js';
+export * from './schema/types.js';
+//# sourceMappingURL=exports.js.map

package/build/src/exports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../../src/exports.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oBAAoB,CAAA;AAClC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,mBAAmB,CAAA"}

package/build/src/implementations/http/doc-registry.d.ts

@@ -0,0 +1,12 @@
+import type { AnyHttpRouteDoc, DocEnvelope, DocRegistryConfig, DocRegistryOutputOptions, DocSource, ErrorDoc } from '../types.js';
+export type { AnyHttpRouteDoc, DocEnvelope, DocRegistryConfig, DocRegistryOutputOptions, DocSource, ErrorDoc, HeaderDoc, } from '../types.js';
+export declare class DocRegistry {
+    private readonly basePath;
+    private readonly headers;
+    private readonly errors;
+    private readonly sources;
+    constructor(config?: DocRegistryConfig);
+    from(source: DocSource<AnyHttpRouteDoc>): this;
+    toJSON<T = DocEnvelope>(options?: DocRegistryOutputOptions<T>): T;
+    static defaultErrors(): ErrorDoc[];
+}

package/build/src/implementations/http/doc-registry.js

@@ -0,0 +1,114 @@
+export class DocRegistry {
+    basePath;
+    headers;
+    errors;
+    sources = [];
+    constructor(config) {
+        this.basePath = config?.basePath ?? '';
+        this.headers = config?.headers ?? [];
+        this.errors = config?.errors ?? [];
+    }
+    from(source) {
+        this.sources.push(source);
+        return this;
+    }
+    toJSON(options) {
+        let routes = this.sources.flatMap((source) => source.docs);
+        if (options?.filter) {
+            routes = routes.filter(options.filter);
+        }
+        const envelope = {
+            basePath: this.basePath,
+            headers: [...this.headers],
+            errors: [...this.errors],
+            routes,
+        };
+        if (options?.transform) {
+            return options.transform(envelope);
+        }
+        return envelope;
+    }
+    // Keep in sync with src/errors.ts
+    static defaultErrors() {
+        return [
+            {
+                name: 'ProcedureError',
+                statusCode: 500,
+                description: 'An error thrown from within a procedure handler via ctx.error().',
+                schema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', const: 'ProcedureError' },
+                        procedureName: { type: 'string' },
+                        message: { type: 'string' },
+                        meta: { type: 'object' },
+                    },
+                    required: ['name', 'procedureName', 'message'],
+                },
+            },
+            {
+                name: 'ProcedureValidationError',
+                statusCode: 400,
+                description: 'Schema validation failed for the procedure input parameters.',
+                schema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', const: 'ProcedureValidationError' },
+                        procedureName: { type: 'string' },
+                        message: { type: 'string' },
+                        errors: {
+                            type: 'array',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    instancePath: { type: 'string' },
+                                    message: { type: 'string' },
+                                },
+                            },
+                        },
+                    },
+                    required: ['name', 'procedureName', 'message'],
+                },
+            },
+            {
+                name: 'ProcedureYieldValidationError',
+                statusCode: 500,
+                description: 'Schema validation failed for a yielded value in a streaming procedure.',
+                schema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', const: 'ProcedureYieldValidationError' },
+                        procedureName: { type: 'string' },
+                        message: { type: 'string' },
+                        errors: {
+                            type: 'array',
+                            items: {
+                                type: 'object',
+                                properties: {
+                                    instancePath: { type: 'string' },
+                                    message: { type: 'string' },
+                                },
+                            },
+                        },
+                    },
+                    required: ['name', 'procedureName', 'message'],
+                },
+            },
+            {
+                name: 'ProcedureRegistrationError',
+                statusCode: 500,
+                description: 'An invalid schema or configuration was detected at procedure registration time.',
+                schema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string', const: 'ProcedureRegistrationError' },
+                        procedureName: { type: 'string' },
+                        message: { type: 'string' },
+                    },
+                    required: ['name', 'procedureName', 'message'],
+                },
+            },
+        ];
+    }
+}
+//# sourceMappingURL=doc-registry.js.map

package/build/src/implementations/http/doc-registry.js.map

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

package/build/src/implementations/http/doc-registry.test.d.ts

@@ -0,0 +1 @@
+export {};