ts-procedures 2.1.0 → 3.0.0

package/build/implementations/http/express/example/server.js

@@ -1,49 +0,0 @@
-import express from 'express';
-import { PublicFactory, ProtectedFactory } from './factories.js';
-import { registerExpressRoutes } from '../index.js';
-// Import procedures for their side effects (they register with the factories)
-import './procedures/auth.js';
-import './procedures/users.js';
-const authTokenService = (authToken) => {
-    // Dummy implementation - replace with real token validation logic
-    return {
-        isValid: authToken === 'valid-token',
-        userId: authToken === 'valid-token' ? 'user-123' : null,
-    };
-};
-export const app = express();
-app.use(express.json());
-registerExpressRoutes(app, {
-    getContext: async (req, res) => {
-        return {
-            ipAddress: '',
-            requestId: '',
-            headers: {},
-        };
-    }
-}, PublicFactory.getProcedures());
-registerExpressRoutes(app, {
-    getContext: async (req, res) => {
-        const authServiceResult = authTokenService(req.headers['authorization']?.toString() || '');
-        if (authServiceResult.isValid) {
-            return {
-                userId: authServiceResult.userId,
-                ipAddress: '',
-                requestId: '',
-                headers: {}
-            };
-        }
-        res.status(401).json({
-            error: 'Unauthorized'
-        });
-        throw new Error('Unauthorized');
-    }
-}, ProtectedFactory.getProcedures());
-// Only start server when run directly (not when imported for testing)
-const isMainModule = import.meta.url.endsWith(process.argv[1]?.replace(/\\/g, '/') || '');
-if (isMainModule) {
-    app.listen(4841, () => {
-        console.log('Server is running on http://localhost:4841');
-    });
-}
-//# sourceMappingURL=server.js.map

package/build/implementations/http/express/example/server.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../src/implementations/http/express/example/server.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAA;AAC7B,OAAO,EACL,aAAa,EACb,gBAAgB,EACjB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAEnD,8EAA8E;AAC9E,OAAO,sBAAsB,CAAA;AAC7B,OAAO,uBAAuB,CAAA;AAE9B,MAAM,gBAAgB,GAAG,CAAC,SAAiB,EAAE,EAAE;IAC7C,kEAAkE;IAClE,OAAO;QACL,OAAO,EAAE,SAAS,KAAK,aAAa;QACpC,MAAM,EAAE,SAAS,KAAK,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;KACxD,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,EAAE,CAAA;AAC5B,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AAEvB,qBAAqB,CACnB,GAAG,EACH;IACE,UAAU,EAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC5B,OAAO;YACL,SAAS,EAAC,EAAE;YACZ,SAAS,EAAC,EAAE;YACZ,OAAO,EAAC,EAAE;SACX,CAAA;IACH,CAAC;CACF,EACD,aAAa,CAAC,aAAa,EAAE,CAC9B,CAAA;AAED,qBAAqB,CACnB,GAAG,EACH;IACE,UAAU,EAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QAE1F,IAAI,iBAAiB,CAAC,OAAO,EAAE,CAAC;YAC9B,OAAO;gBACL,MAAM,EAAC,iBAAiB,CAAC,MAAO;gBAChC,SAAS,EAAC,EAAE;gBACZ,SAAS,EAAC,EAAE;gBACZ,OAAO,EAAC,EAAE;aACX,CAAA;QACH,CAAC;QAED,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,KAAK,EAAE,cAAc;SACtB,CAAC,CAAA;QACF,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA;IACjC,CAAC;CACF,EACD,gBAAgB,CAAC,aAAa,EAAE,CACjC,CAAA;AAED,sEAAsE;AACtE,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;AACzF,IAAI,YAAY,EAAE,CAAC;IACjB,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QACpB,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAA;IAC3D,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/build/implementations/http/express/example/server.test.d.ts

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

package/build/implementations/http/express/example/server.test.js

@@ -1,110 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import supertest from 'supertest';
-import { app } from './server.js';
-describe('Express Server Tests', () => {
-    describe('Public Endpoints', () => {
-        describe('POST /authenticate', () => {
-            it('should return token with valid credentials', async () => {
-                const response = await supertest(app)
-                    .post('/authenticate')
-                    .send({ username: 'john', password: 'secret123' });
-                expect(response.status).toBe(200);
-                expect(response.body).toEqual({ token: 'fake-jwt-token' });
-            });
-            it('should return 422 when username is missing', async () => {
-                const response = await supertest(app).post('/authenticate').send({ password: 'secret123' });
-                expect(response.status).toBe(422);
-                expect(response.body).toHaveProperty('error');
-            });
-            it('should return 422 when username is too short (minLength: 3)', async () => {
-                const response = await supertest(app)
-                    .post('/authenticate')
-                    .send({ username: 'ab', password: 'secret123' });
-                expect(response.status).toBe(422);
-                expect(response.body).toHaveProperty('error');
-            });
-            it('should return 422 when password is missing', async () => {
-                const response = await supertest(app).post('/authenticate').send({ username: 'john' });
-                expect(response.status).toBe(422);
-                expect(response.body).toHaveProperty('error');
-            });
-            it('should return 422 when password is too short (minLength: 6)', async () => {
-                const response = await supertest(app)
-                    .post('/authenticate')
-                    .send({ username: 'john', password: '12345' });
-                expect(response.status).toBe(422);
-                expect(response.body).toHaveProperty('error');
-            });
-            it('should return 422 when body is empty', async () => {
-                const response = await supertest(app).post('/authenticate').send({});
-                expect(response.status).toBe(422);
-                expect(response.body).toHaveProperty('error');
-            });
-        });
-    });
-    describe('Protected Endpoints', () => {
-        describe('GET /users/user-profile/:id', () => {
-            it('should return 401 when no authorization header is provided', async () => {
-                const response = await supertest(app).get('/users/user-profile/123');
-                expect(response.status).toBe(401);
-                expect(response.body).toEqual({ error: 'Unauthorized' });
-            });
-            it('should return 401 when authorization token is invalid', async () => {
-                const response = await supertest(app)
-                    .get('/users/user-profile/123')
-                    .set('Authorization', 'invalid-token');
-                expect(response.status).toBe(401);
-                expect(response.body).toEqual({ error: 'Unauthorized' });
-            });
-            it('should return user profile with valid token', async () => {
-                const response = await supertest(app)
-                    .get('/users/user-profile/123')
-                    .set('Authorization', 'valid-token');
-                expect(response.status).toBe(200);
-                expect(response.body).toEqual({
-                    user: {
-                        id: '123',
-                        name: 'Jane Doe',
-                        email: 'test@gmail.com',
-                    },
-                });
-            });
-            it('should return user profile with different id from path', async () => {
-                const response = await supertest(app)
-                    .get('/users/user-profile/abc')
-                    .set('Authorization', 'valid-token');
-                expect(response.status).toBe(200);
-                expect(response.body).toEqual({
-                    user: {
-                        id: 'abc',
-                        name: 'Jane Doe',
-                        email: 'test@gmail.com',
-                    },
-                });
-            });
-        });
-    });
-    describe('Response Structure', () => {
-        it('authenticate returns correct token structure', async () => {
-            const response = await supertest(app)
-                .post('/authenticate')
-                .send({ username: 'testuser', password: 'password123' });
-            expect(response.status).toBe(200);
-            expect(response.body).toHaveProperty('token');
-            expect(typeof response.body.token).toBe('string');
-        });
-        it('user profile returns correct nested user object with id, name, email', async () => {
-            const response = await supertest(app)
-                .get('/users/user-profile/test-id')
-                .set('Authorization', 'valid-token');
-            expect(response.status).toBe(200);
-            expect(response.body).toHaveProperty('user');
-            expect(response.body.user).toHaveProperty('id', 'test-id');
-            expect(response.body.user).toHaveProperty('name');
-            expect(response.body.user).toHaveProperty('email');
-            expect(typeof response.body.user.name).toBe('string');
-            expect(typeof response.body.user.email).toBe('string');
-        });
-    });
-});
-//# sourceMappingURL=server.test.js.map

package/build/implementations/http/express/example/server.test.js.map

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

package/build/implementations/http/express/index.d.ts

@@ -1,35 +0,0 @@
-import express from 'express';
-import { TProcedureRegistration } from '../../../index.js';
-import { ExpressHttpRouteHelpersContext } from './types.js';
-/**
- * Maps path parameters from Express route to an object
- *
- * Path /users/:id with /users/123 => { id: '123' }
- *
- * @param path
- * @param url
- */
-export declare function mapPathParamsToObject(path: string, url: string): Record<string, string>;
-/**
- * A convenience function to register multiple procedures as Express routes.
- *
- * Provide the Express app, a context generator function, and an array of procedure registrations.
- *
- * @param app
- * @param callbacks
- * @param procedures
- */
-export declare function registerExpressRoutes<ProceduresContext>(app: express.Application, callbacks: {
-    /** Get procedure factory context for handler */
-    getContext: (req: express.Request, res: express.Response) => Promise<ProceduresContext & ExpressHttpRouteHelpersContext>;
-    /** Optional error handler for procedure handler errors */
-    onHandlerError?: (error: Error, req: express.Request, res: express.Response) => void;
-    /** Optional validation error handler */
-    onValidationError?: (errors: Array<{
-        message: string;
-        path: string[];
-    }>, req: express.Request, res: express.Response) => void;
-}, procedures: Array<TProcedureRegistration<ProceduresContext, {
-    method: 'get' | 'post' | 'patch' | 'delete' | 'put';
-    path: string;
-}>>): void;

package/build/implementations/http/express/index.js

@@ -1,75 +0,0 @@
-/**
- * Maps path parameters from Express route to an object
- *
- * Path /users/:id with /users/123 => { id: '123' }
- *
- * @param path
- * @param url
- */
-export function mapPathParamsToObject(path, url) {
-    const urlObj = new URL(url, 'http://localhost'); // Base URL is required but irrelevant here
-    const pathSegments = path.split('/').filter(Boolean);
-    const urlSegments = urlObj.pathname.split('/').filter(Boolean);
-    const params = {};
-    pathSegments.forEach((segment, index) => {
-        if (segment.startsWith(':')) {
-            const paramName = segment.slice(1);
-            params[paramName] = urlSegments[index] || '';
-        }
-    });
-    return params;
-}
-/**
- * Combines path, query, and body parameters from an Express request into a single object
- * @param req
- */
-function getAllParamsFromExpressRequest(req) {
-    const pathParams = mapPathParamsToObject(req.route.path, req.url);
-    const queryParams = req.query || {};
-    const bodyParams = req.body || {};
-    return { ...pathParams, ...queryParams, ...bodyParams };
-}
-/**
- * A convenience function to register multiple procedures as Express routes.
- *
- * Provide the Express app, a context generator function, and an array of procedure registrations.
- *
- * @param app
- * @param callbacks
- * @param procedures
- */
-export function registerExpressRoutes(app, callbacks, 
-// The procedure extended config must include method and path
-procedures) {
-    procedures.forEach(({ handler, config }) => {
-        const { method, path } = config;
-        app[method](path, async (req, res) => {
-            const context = await callbacks.getContext(req, res);
-            const allParams = getAllParamsFromExpressRequest(req);
-            if (config.validation?.params) {
-                const { errors } = config.validation.params(allParams);
-                if (errors && errors.length > 0) {
-                    if (callbacks.onValidationError) {
-                        callbacks.onValidationError(errors, req, res);
-                    }
-                    else {
-                        res.status(422).json({ error: 'Validation Error', details: errors });
-                    }
-                    return;
-                }
-            }
-            try {
-                const result = await handler(context, allParams);
-                res.json(result);
-            }
-            catch (error) {
-                if (callbacks.onHandlerError) {
-                    callbacks.onHandlerError(error, req, res);
-                    return;
-                }
-                res.status(500).json({ error: error.message });
-            }
-        });
-    });
-}
-//# sourceMappingURL=index.js.map

package/build/implementations/http/express/index.js.map

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

package/build/implementations/http/express/index.test.js

@@ -1,329 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from 'vitest';
-import supertest from 'supertest';
-import express from 'express';
-import { registerExpressRoutes, mapPathParamsToObject } from './index.js';
-import { Procedures } from '../../../index.js';
-import { Type } from 'typebox';
-describe('mapPathParamsToObject', () => {
-    it('extracts single path param', () => {
-        const result = mapPathParamsToObject('/users/:id', '/users/123');
-        expect(result).toEqual({ id: '123' });
-    });
-    it('extracts multiple path params', () => {
-        const result = mapPathParamsToObject('/users/:userId/posts/:postId', '/users/42/posts/99');
-        expect(result).toEqual({ userId: '42', postId: '99' });
-    });
-    it('returns empty object when no params', () => {
-        const result = mapPathParamsToObject('/users', '/users');
-        expect(result).toEqual({});
-    });
-    it('handles trailing slashes', () => {
-        const result = mapPathParamsToObject('/users/:id/', '/users/123/');
-        expect(result).toEqual({ id: '123' });
-    });
-    it('handles missing segment with empty string', () => {
-        const result = mapPathParamsToObject('/users/:id/:name', '/users/123');
-        expect(result).toEqual({ id: '123', name: '' });
-    });
-    it('ignores query string in URL', () => {
-        const result = mapPathParamsToObject('/users/:id', '/users/123?foo=bar');
-        expect(result).toEqual({ id: '123' });
-    });
-    it('handles nested paths with params', () => {
-        const result = mapPathParamsToObject('/api/v1/users/:id/profile', '/api/v1/users/abc/profile');
-        expect(result).toEqual({ id: 'abc' });
-    });
-});
-describe('registerExpressRoutes', () => {
-    let app;
-    beforeEach(() => {
-        app = express();
-        app.use(express.json());
-    });
-    describe('Route Registration', () => {
-        it('registers GET route and returns JSON response', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('GetUsers', { method: 'get', path: '/users' }, async () => ({
-                users: ['alice', 'bob'],
-            }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app).get('/users');
-            expect(response.status).toBe(200);
-            expect(response.body).toEqual({ users: ['alice', 'bob'] });
-        });
-        it('registers POST route and returns JSON response', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('CreateUser', {
-                method: 'post',
-                path: '/users',
-                schema: {
-                    params: Type.Object({ name: Type.Optional(Type.String()) }),
-                },
-            }, async (_ctx, params) => ({ created: true, name: params?.name }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app).post('/users').send({ name: 'charlie' });
-            expect(response.status).toBe(200);
-            expect(response.body).toEqual({ created: true, name: 'charlie' });
-        });
-        it('registers PUT route', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('UpdateUser', {
-                method: 'put',
-                path: '/users/:id',
-                schema: {
-                    params: Type.Object({ id: Type.Optional(Type.String()) }),
-                },
-            }, async (_ctx, params) => ({ updated: true, id: params?.id }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app).put('/users/123').send({ name: 'updated' });
-            expect(response.status).toBe(200);
-            expect(response.body).toEqual({ updated: true, id: '123' });
-        });
-        it('registers PATCH route', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('PatchUser', {
-                method: 'patch',
-                path: '/users/:id',
-                schema: {
-                    params: Type.Object({ id: Type.Optional(Type.String()) }),
-                },
-            }, async (_ctx, params) => ({ patched: true, id: params?.id }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app).patch('/users/456').send({ status: 'active' });
-            expect(response.status).toBe(200);
-            expect(response.body).toEqual({ patched: true, id: '456' });
-        });
-        it('registers DELETE route', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('DeleteUser', {
-                method: 'delete',
-                path: '/users/:id',
-                schema: {
-                    params: Type.Object({ id: Type.Optional(Type.String()) }),
-                },
-            }, async (_ctx, params) => ({ deleted: true, id: params?.id }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app).delete('/users/789');
-            expect(response.status).toBe(200);
-            expect(response.body).toEqual({ deleted: true, id: '789' });
-        });
-    });
-    describe('Parameter Handling', () => {
-        it('passes path params to handler', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('GetUser', {
-                method: 'get',
-                path: '/users/:userId',
-                schema: {
-                    params: Type.Object({ userId: Type.Optional(Type.String()) }),
-                },
-            }, async (_ctx, params) => ({ userId: params?.userId }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app).get('/users/abc123');
-            expect(response.body).toEqual({ userId: 'abc123' });
-        });
-        it('passes query params to handler', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('SearchUsers', {
-                method: 'get',
-                path: '/users',
-                schema: {
-                    params: Type.Object({
-                        q: Type.Optional(Type.String()),
-                        limit: Type.Optional(Type.String()),
-                    }),
-                },
-            }, async (_ctx, params) => ({ query: params?.q, limit: params?.limit }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app).get('/users?q=test&limit=10');
-            expect(response.body).toEqual({ query: 'test', limit: '10' });
-        });
-        it('passes body params to handler', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('CreatePost', {
-                method: 'post',
-                path: '/posts',
-                schema: {
-                    params: Type.Object({
-                        title: Type.Optional(Type.String()),
-                        content: Type.Optional(Type.String()),
-                    }),
-                },
-            }, async (_ctx, params) => ({ title: params?.title, content: params?.content }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app)
-                .post('/posts')
-                .send({ title: 'Hello', content: 'World' });
-            expect(response.body).toEqual({ title: 'Hello', content: 'World' });
-        });
-        it('merges path, query, and body params', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('UpdatePost', {
-                method: 'put',
-                path: '/users/:userId/posts/:postId',
-                schema: {
-                    params: Type.Object({
-                        userId: Type.Optional(Type.String()),
-                        postId: Type.Optional(Type.String()),
-                        filter: Type.Optional(Type.String()),
-                        title: Type.Optional(Type.String()),
-                    }),
-                },
-            }, async (_ctx, params) => ({
-                userId: params?.userId,
-                postId: params?.postId,
-                filter: params?.filter,
-                title: params?.title,
-            }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app)
-                .put('/users/u1/posts/p2?filter=active')
-                .send({ title: 'Updated Title' });
-            expect(response.body).toEqual({
-                userId: 'u1',
-                postId: 'p2',
-                filter: 'active',
-                title: 'Updated Title',
-            });
-        });
-    });
-    describe('Context Generation', () => {
-        it('calls getContext with req and res', async () => {
-            const getContext = vi.fn().mockResolvedValue({ user: 'testuser' });
-            const { Create, getProcedures } = Procedures();
-            Create('GetData', { method: 'get', path: '/data' }, async () => ({ ok: true }));
-            registerExpressRoutes(app, { getContext }, getProcedures());
-            await supertest(app).get('/data');
-            expect(getContext).toHaveBeenCalledTimes(1);
-            expect(getContext).toHaveBeenCalledWith(expect.objectContaining({ method: 'GET' }), expect.objectContaining({ statusCode: 200 }));
-        });
-        it('passes context to handler', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('GetProfile', { method: 'get', path: '/profile' }, async (ctx) => ({
-                user: ctx.user,
-                permissions: ctx.permissions,
-            }));
-            registerExpressRoutes(app, {
-                getContext: async () => ({
-                    user: 'alice',
-                    permissions: ['read', 'write'],
-                }),
-            }, getProcedures());
-            const response = await supertest(app).get('/profile');
-            expect(response.body).toEqual({
-                user: 'alice',
-                permissions: ['read', 'write'],
-            });
-        });
-    });
-    describe('Validation Error Handling', () => {
-        it('returns 422 with default handler when validation fails', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('CreateItem', {
-                method: 'post',
-                path: '/items',
-                schema: {
-                    params: Type.Object({
-                        name: Type.String({ minLength: 1 }),
-                        quantity: Type.Number({ minimum: 1 }),
-                    }),
-                },
-            }, async (_ctx, params) => ({ created: params }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app).post('/items').send({ name: '', quantity: 0 });
-            expect(response.status).toBe(422);
-            expect(response.body.error).toBe('Validation Error');
-            expect(response.body.details).toBeDefined();
-            expect(Array.isArray(response.body.details)).toBe(true);
-        });
-        it('calls custom onValidationError callback', async () => {
-            const onValidationError = vi.fn((errors, _req, res) => {
-                res.status(400).json({ custom: 'validation error', errors });
-            });
-            const { Create, getProcedures } = Procedures();
-            Create('ValidateItem', {
-                method: 'post',
-                path: '/validate',
-                schema: {
-                    params: Type.Object({
-                        required: Type.String(),
-                    }),
-                },
-            }, async () => ({ ok: true }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }), onValidationError }, getProcedures());
-            const response = await supertest(app).post('/validate').send({});
-            expect(onValidationError).toHaveBeenCalledTimes(1);
-            expect(response.status).toBe(400);
-            expect(response.body.custom).toBe('validation error');
-        });
-        it('does not call handler when validation fails', async () => {
-            const handlerFn = vi.fn().mockResolvedValue({ ok: true });
-            const { Create, getProcedures } = Procedures();
-            Create('NoCall', {
-                method: 'post',
-                path: '/nocall',
-                schema: {
-                    params: Type.Object({
-                        required: Type.String(),
-                    }),
-                },
-            }, handlerFn);
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            await supertest(app).post('/nocall').send({});
-            expect(handlerFn).not.toHaveBeenCalled();
-        });
-    });
-    describe('Handler Error Handling', () => {
-        it('returns 500 with default handler when handler throws', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('ThrowError', { method: 'get', path: '/error' }, async () => {
-                throw new Error('Something went wrong');
-            });
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app).get('/error');
-            expect(response.status).toBe(500);
-            expect(response.body.error).toContain('Something went wrong');
-        });
-        it('calls custom onHandlerError callback', async () => {
-            const onHandlerError = vi.fn((error, _req, res) => {
-                res.status(503).json({ custom: 'error handler', message: error.message });
-            });
-            const { Create, getProcedures } = Procedures();
-            Create('CustomError', { method: 'get', path: '/custom-error' }, async () => {
-                throw new Error('Custom failure');
-            });
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }), onHandlerError }, getProcedures());
-            const response = await supertest(app).get('/custom-error');
-            expect(onHandlerError).toHaveBeenCalledTimes(1);
-            expect(response.status).toBe(503);
-            expect(response.body).toEqual({
-                custom: 'error handler',
-                message: 'Custom failure',
-            });
-        });
-    });
-    describe('Success Response', () => {
-        it('returns handler result as JSON', async () => {
-            const { Create, getProcedures } = Procedures();
-            Create('ComplexResult', { method: 'get', path: '/complex' }, async () => ({
-                nested: {
-                    data: [1, 2, 3],
-                    metadata: { count: 3 },
-                },
-                status: 'success',
-            }));
-            registerExpressRoutes(app, { getContext: async () => ({ user: 'test' }) }, getProcedures());
-            const response = await supertest(app).get('/complex');
-            expect(response.status).toBe(200);
-            expect(response.headers['content-type']).toMatch(/application\/json/);
-            expect(response.body).toEqual({
-                nested: {
-                    data: [1, 2, 3],
-                    metadata: { count: 3 },
-                },
-                status: 'success',
-            });
-        });
-    });
-});
-//# sourceMappingURL=index.test.js.map