glasswork 0.1.0

package/dist/route-helpers.js

@@ -0,0 +1,249 @@
+import { describeRoute as honoDescribeRoute } from 'hono-openapi';
+import { resolver, validator } from 'hono-openapi/valibot';
+import { getClientIp } from './get-client-ip.js';
+/**
+ * Global storage for OpenAPI response hooks.
+ * Set during bootstrap and used when defining routes.
+ */
+let globalResponseHooks = [];
+/**
+ * Set the global OpenAPI response hooks.
+ * This is called during bootstrap and makes hooks available to route definitions.
+ *
+ * @internal
+ */
+export function setGlobalResponseHooks(hooks) {
+    globalResponseHooks = hooks;
+}
+/**
+ * Get the current global OpenAPI response hooks.
+ *
+ * @internal
+ */
+export function getGlobalResponseHooks() {
+    return globalResponseHooks;
+}
+/**
+ * HTTP status codes with descriptions
+ */
+const STATUS_DESCRIPTIONS = {
+    200: 'Success',
+    201: 'Created',
+    204: 'No Content',
+    400: 'Bad Request',
+    401: 'Unauthorized',
+    403: 'Forbidden',
+    404: 'Not Found',
+    409: 'Conflict',
+    422: 'Unprocessable Entity',
+    429: 'Too Many Requests',
+    500: 'Internal Server Error',
+};
+/**
+ * Create routes with typed service injection.
+ *
+ * @template TServices - The shape of services required by these routes
+ *
+ * @example
+ * ```typescript
+ * interface AuthRoutesServices {
+ *   authService: AuthService;
+ *   userService: UserService;
+ * }
+ *
+ * export const authRoutes = createRoutes<AuthRoutesServices>((router, services) => {
+ *   // services.authService is typed as AuthService!
+ *   // services.userService is typed as UserService!
+ *   router.post('/login', ...);
+ * });
+ * ```
+ */
+export function createRoutes(factory) {
+    return factory;
+}
+/**
+ * Create a route handler with validation and OpenAPI metadata.
+ *
+ * Type inference works automatically:
+ * - Body type is inferred from the `body` schema
+ * - Return type is inferred from the `responses[200]` schema
+ *
+ * @example
+ * ```typescript
+ * route({
+ *   body: StartSessionDto,
+ *   responses: { 200: StartSessionResponseDto },
+ *   handler: async ({ body }) => {
+ *     // body is typed as InferOutput<typeof StartSessionDto>
+ *     return { email: body.email }; // Must match StartSessionResponseDto
+ *   }
+ * })
+ * ```
+ */
+export function route(config) {
+    const middlewares = [];
+    // Add OpenAPI metadata
+    middlewares.push(buildOpenAPIMiddleware(config));
+    // Add custom middleware (e.g., auth) before validation
+    if (config.middleware) {
+        middlewares.push(...config.middleware);
+    }
+    // Add validation middleware with custom error handler (returns 422 instead of 400)
+    if (config.body) {
+        middlewares.push(validator('json', config.body, (result, c) => {
+            if (!result.success) {
+                return c.json({ error: 'Validation failed', issues: result.issues }, 422);
+            }
+        }));
+    }
+    if (config.query) {
+        middlewares.push(validator('query', config.query, (result, c) => {
+            if (!result.success) {
+                return c.json({ error: 'Validation failed', issues: result.issues }, 422);
+            }
+        }));
+    }
+    if (config.params) {
+        middlewares.push(validator('param', config.params, (result, c) => {
+            if (!result.success) {
+                return c.json({ error: 'Validation failed', issues: result.issues }, 422);
+            }
+        }));
+    }
+    // Add handler wrapper
+    middlewares.push(async (c) => {
+        const routeContext = buildRouteContext(c);
+        const result = await config.handler(
+        // @ts-expect-error - Session typing issue to be resolved separately
+        routeContext);
+        // If handler returned a Response, return it directly (for custom responses like text)
+        if (result instanceof Response) {
+            return result;
+        }
+        // Return appropriate response
+        if (result === null || result === undefined) {
+            c.status(204);
+            return c.body(null);
+        }
+        return c.json(result);
+    });
+    return middlewares;
+}
+function buildOpenAPIMiddleware(config) {
+    const responses = buildOpenAPIResponses(config);
+    const openApiConfig = {
+        operationId: config.operationId || config.summary,
+        tags: config.tags,
+        summary: config.summary,
+        description: config.description,
+        responses: responses,
+        security: config.public ? [] : [{ bearerAuth: [] }],
+        ...(config.paginate && { parameters: buildPaginationParameters() }),
+        ...config.openapi,
+    };
+    return honoDescribeRoute(openApiConfig);
+}
+/**
+ * Build pagination parameters for OpenAPI spec
+ */
+function buildPaginationParameters() {
+    return [
+        {
+            name: 'page',
+            in: 'query',
+            required: false,
+            schema: {
+                type: 'integer',
+                format: 'int32',
+                minimum: 1,
+                maximum: 2147483647, // Max int32
+                default: 1,
+            },
+            description: 'Page number',
+        },
+        {
+            name: 'limit',
+            in: 'query',
+            required: false,
+            schema: {
+                type: 'integer',
+                format: 'int32',
+                minimum: 1,
+                maximum: 100,
+                default: 50,
+            },
+            description: 'Number of items per page',
+        },
+    ];
+}
+function buildOpenAPIResponses(config) {
+    const responses = {};
+    // Add default error responses
+    const defaultResponses = config.public
+        ? { 400: undefined, 429: undefined, 500: undefined }
+        : { 400: undefined, 401: undefined, 429: undefined, 500: undefined };
+    const allResponses = { ...defaultResponses, ...(config.responses || {}) };
+    // Get global hooks
+    const hooks = getGlobalResponseHooks();
+    for (const [statusCode, schema] of Object.entries(allResponses)) {
+        const code = Number(statusCode);
+        const description = STATUS_DESCRIPTIONS[code] || 'Response';
+        // Determine if this is an error response that should use default error schema
+        const isErrorResponse = code >= 400;
+        const shouldUseDefaultErrorSchema = isErrorResponse && !schema;
+        // Start with base response (no headers)
+        let response = {
+            description,
+            ...(schema
+                ? {
+                    content: {
+                        'application/json': {
+                            // resolver type only supports BaseSchema, but works with BaseSchemaAsync at runtime
+                            // @ts-expect-error - resolver accepts both BaseSchema and BaseSchemaAsync
+                            schema: resolver(schema, { errorMode: 'ignore' }),
+                        },
+                    },
+                }
+                : shouldUseDefaultErrorSchema
+                    ? {
+                        content: {
+                            'application/json': {
+                                schema: {
+                                    $ref: '#/components/schemas/ErrorResponse',
+                                },
+                            },
+                        },
+                    }
+                    : {}),
+        };
+        // Apply hooks to build up headers
+        for (const hook of hooks) {
+            response = hook(response, {
+                statusCode,
+                routeConfig: {
+                    public: config.public,
+                    paginate: config.paginate,
+                    tags: config.tags,
+                    summary: config.summary,
+                },
+            });
+        }
+        responses[statusCode] = response;
+    }
+    return responses;
+}
+function buildRouteContext(c) {
+    const req = c.req;
+    return {
+        body: req.valid('json'),
+        query: req.valid('query'),
+        params: req.valid('param'),
+        services: c.get('services') || {},
+        // @ts-expect-error - Session typing issue to be resolved separately
+        session: c.get('session'),
+        ip: getClientIp(c),
+        userAgent: c.req.header('user-agent'),
+        context: c,
+    };
+}
+//# sourceMappingURL=route-helpers.js.map

package/dist/route-helpers.js.map

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

package/dist/serialize-dates.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Type helper to recursively convert Date fields to string in an object type
+ */
+export type SerializedDates<T> = T extends Date ? string : T extends Array<infer U> ? Array<SerializedDates<U>> : T extends object ? {
+    [K in keyof T]: SerializedDates<T[K]>;
+} : T;
+/**
+ * Recursively converts all Date objects to ISO 8601 strings in an entity or array of entities.
+ *
+ * This utility handles the mismatch between Prisma's Date types and API response DTOs
+ * that expect string timestamps. It preserves null values and handles nested objects and arrays.
+ *
+ * @template T - The type of data to transform
+ * @param data - The data to transform (object, array, or primitive)
+ * @returns The same structure with all Date objects converted to ISO strings
+ *
+ * @example
+ * ```typescript
+ * const ranger = await prisma.ranger.findUnique({
+ *   where: { id },
+ *   include: { category: true }
+ * });
+ * return serializeDates(ranger); // All Date fields → ISO strings
+ * ```
+ */
+export declare function serializeDates<T>(data: T): SerializedDates<T>;
+//# sourceMappingURL=serialize-dates.d.ts.map

package/dist/serialize-dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-dates.d.ts","sourceRoot":"","sources":["../src/serialize-dates.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GAC3C,MAAM,GACN,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACtB,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,GACzB,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACzC,CAAC,CAAC;AAEV;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAsB7D"}

package/dist/serialize-dates.js

@@ -0,0 +1,39 @@
+/**
+ * Recursively converts all Date objects to ISO 8601 strings in an entity or array of entities.
+ *
+ * This utility handles the mismatch between Prisma's Date types and API response DTOs
+ * that expect string timestamps. It preserves null values and handles nested objects and arrays.
+ *
+ * @template T - The type of data to transform
+ * @param data - The data to transform (object, array, or primitive)
+ * @returns The same structure with all Date objects converted to ISO strings
+ *
+ * @example
+ * ```typescript
+ * const ranger = await prisma.ranger.findUnique({
+ *   where: { id },
+ *   include: { category: true }
+ * });
+ * return serializeDates(ranger); // All Date fields → ISO strings
+ * ```
+ */
+export function serializeDates(data) {
+    if (data === null || data === undefined) {
+        return data;
+    }
+    if (data instanceof Date) {
+        return data.toISOString();
+    }
+    if (Array.isArray(data)) {
+        return data.map((item) => serializeDates(item));
+    }
+    if (typeof data === 'object') {
+        const result = {};
+        for (const [key, value] of Object.entries(data)) {
+            result[key] = serializeDates(value);
+        }
+        return result;
+    }
+    return data;
+}
+//# sourceMappingURL=serialize-dates.js.map

package/dist/serialize-dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize-dates.js","sourceRoot":"","sources":["../src/serialize-dates.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAI,IAAO;IACvC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,IAA0B,CAAC;IACpC,CAAC;IAED,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,WAAW,EAAwB,CAAC;IAClD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAuB,CAAC;IACxE,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,MAA4B,CAAC;IACtC,CAAC;IAED,OAAO,IAA0B,CAAC;AACpC,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,87 @@
+import type { AwilixContainer } from 'awilix';
+import { Hono } from 'hono';
+import type { ModuleConfig } from './types.js';
+/**
+ * Options for creating a test app
+ */
+export interface CreateTestAppOptions {
+    /**
+     * API base path
+     * @default '/api'
+     */
+    apiBasePath?: string;
+    /**
+     * Service mocks to override module providers
+     * These will be registered as values in the container, overriding any class/factory providers
+     */
+    services?: Record<string, unknown>;
+    /**
+     * Error handler
+     * @default defaultErrorHandler
+     * Set to false to disable error handling
+     */
+    errorHandler?: false | import('hono').ErrorHandler;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Test context returned by createTestApp
+ */
+export interface TestContext {
+    /**
+     * Hono app instance with mounted routes
+     */
+    app: Hono;
+    /**
+     * Awilix container with all services
+     */
+    container: AwilixContainer;
+}
+/**
+ * Create a test app for testing a specific module.
+ *
+ * This function:
+ * 1. Creates an Awilix container
+ * 2. Registers all module providers (from the module and its imports)
+ * 3. Overrides providers with mock services
+ * 4. Creates a Hono app with error handler
+ * 5. Mounts the module's routes
+ *
+ * @example
+ * ```typescript
+ * const mockEmailService = {
+ *   sendEmail: vi.fn(),
+ * };
+ *
+ * const { app, container } = createTestApp(AuthModule, {
+ *   services: {
+ *     emailService: mockEmailService,
+ *     prismaService: testDb,
+ *   },
+ * });
+ *
+ * // Test routes
+ * const res = await app.request('/api/auth/session', { method: 'POST', ... });
+ * ```
+ */
+export declare function createTestApp(module: ModuleConfig, options?: CreateTestAppOptions): TestContext;
+/**
+ * Create a test container with specific services.
+ *
+ * Useful for testing services in isolation without creating a full app.
+ *
+ * @example
+ * ```typescript
+ * const container = createTestContainer({
+ *   prismaService: testDb,
+ *   hashService: new HashService(),
+ * });
+ *
+ * const authService = new AuthService(container.cradle);
+ * ```
+ */
+export declare function createTestContainer(services: Record<string, unknown>): AwilixContainer;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,KAAK,GAAG,OAAO,MAAM,EAAE,YAAY,CAAC;IAEnD;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,GAAG,EAAE,IAAI,CAAC;IAEV;;OAEG;IACH,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,oBAAyB,GACjC,WAAW,CA+Cb;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAatF"}

package/dist/testing.js

@@ -0,0 +1,94 @@
+import { asValue, createContainer, InjectionMode } from 'awilix';
+import { Hono } from 'hono';
+import { collectModules, registerModuleProviders, validateNoCycles } from './bootstrap.js';
+import { defaultErrorHandler } from './error-handler.js';
+/**
+ * Create a test app for testing a specific module.
+ *
+ * This function:
+ * 1. Creates an Awilix container
+ * 2. Registers all module providers (from the module and its imports)
+ * 3. Overrides providers with mock services
+ * 4. Creates a Hono app with error handler
+ * 5. Mounts the module's routes
+ *
+ * @example
+ * ```typescript
+ * const mockEmailService = {
+ *   sendEmail: vi.fn(),
+ * };
+ *
+ * const { app, container } = createTestApp(AuthModule, {
+ *   services: {
+ *     emailService: mockEmailService,
+ *     prismaService: testDb,
+ *   },
+ * });
+ *
+ * // Test routes
+ * const res = await app.request('/api/auth/session', { method: 'POST', ... });
+ * ```
+ */
+export function createTestApp(module, options = {}) {
+    const { apiBasePath = '/api', services = {}, errorHandler = defaultErrorHandler, debug = false, } = options;
+    // Create Awilix container
+    const container = createContainer({
+        injectionMode: InjectionMode.PROXY,
+        strict: true,
+    });
+    // Collect all modules (flatten imports)
+    const allModules = collectModules(module);
+    validateNoCycles(allModules);
+    // Register all providers from the module and its imports
+    for (const mod of allModules) {
+        registerModuleProviders(mod, container, debug);
+    }
+    // Override with mock services AFTER module providers
+    // This allows both overriding services and providing dependencies
+    for (const [key, value] of Object.entries(services)) {
+        container.register({
+            [key]: asValue(value),
+        });
+    }
+    // Create Hono app
+    const app = new Hono();
+    // Apply error handler
+    if (errorHandler !== false) {
+        app.onError(errorHandler);
+    }
+    // Mount module routes
+    if (module.routes && module.basePath) {
+        const router = new Hono();
+        module.routes(router, container.cradle);
+        app.route(`${apiBasePath}/${module.basePath}`, router);
+    }
+    return { app, container };
+}
+/**
+ * Create a test container with specific services.
+ *
+ * Useful for testing services in isolation without creating a full app.
+ *
+ * @example
+ * ```typescript
+ * const container = createTestContainer({
+ *   prismaService: testDb,
+ *   hashService: new HashService(),
+ * });
+ *
+ * const authService = new AuthService(container.cradle);
+ * ```
+ */
+export function createTestContainer(services) {
+    const container = createContainer({
+        injectionMode: InjectionMode.PROXY,
+        strict: true,
+    });
+    for (const [key, value] of Object.entries(services)) {
+        container.register({
+            [key]: asValue(value),
+        });
+    }
+    return container;
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAgDzD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAoB,EACpB,UAAgC,EAAE;IAElC,MAAM,EACJ,WAAW,GAAG,MAAM,EACpB,QAAQ,GAAG,EAAE,EACb,YAAY,GAAG,mBAAmB,EAClC,KAAK,GAAG,KAAK,GACd,GAAG,OAAO,CAAC;IAEZ,0BAA0B;IAC1B,MAAM,SAAS,GAAG,eAAe,CAAC;QAChC,aAAa,EAAE,aAAa,CAAC,KAAK;QAClC,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IAEH,wCAAwC;IACxC,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAC1C,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAE7B,yDAAyD;IACzD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,uBAAuB,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,qDAAqD;IACrD,kEAAkE;IAClE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,SAAS,CAAC,QAAQ,CAAC;YACjB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC;SACtB,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,sBAAsB;IACtB,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;QAC3B,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IAED,sBAAsB;IACtB,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,MAAiC,CAAC,CAAC;QACnE,GAAG,CAAC,KAAK,CAAC,GAAG,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAiC;IACnE,MAAM,SAAS,GAAG,eAAe,CAAC;QAChC,aAAa,EAAE,aAAa,CAAC,KAAK;QAClC,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IAEH,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,SAAS,CAAC,QAAQ,CAAC;YACjB,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}