glasswork 0.7.0 → 0.8.0

package/dist/hooks/index.js

@@ -0,0 +1,55 @@
+/**
+ * Service hooks system for wrapping service method calls with before/after/error hooks.
+ *
+ * This module provides a flexible hook system that can be used for:
+ * - Authorization (using CASL)
+ * - Audit logging
+ * - Metrics and tracing
+ * - Error handling
+ * - Retry logic
+ * - Timeouts
+ * - Response transformation
+ *
+ * Hooks are transparent - they wrap service methods without modifying the service
+ * implementation, keeping business logic clean and framework-agnostic.
+ *
+ * @module hooks
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { authorizationHook, defineServiceMetadata } from 'glasswork';
+ *
+ * // Define metadata for service methods
+ * export const authServiceMetadata = defineServiceMetadata({
+ *   deleteSession: {
+ *     authorize: {
+ *       action: 'delete',
+ *       subject: 'Session'
+ *     }
+ *   }
+ * });
+ *
+ * // Configure hooks globally in bootstrap
+ * bootstrap({
+ *   serviceHooks: [authorizationHook],
+ *   serviceMetadata: {
+ *     authService: authServiceMetadata
+ *   }
+ * });
+ *
+ * // In routes, service calls are automatically wrapped
+ * export const authRoutes = createRoutes((router, { authService }) => {
+ *   router.delete('/session', ...route({
+ *     handler: async ({ context }) => {
+ *       // This automatically checks authorization before executing!
+ *       await authService.deleteSession(token);
+ *     }
+ *   }));
+ * });
+ * ```
+ */
+// Built-in hooks
+export { authorizationHook, defineAuthorize, } from './authorization-hook.js';
+// Hook system
+export { defineServiceMetadata, withServiceHooks, withServiceHooksMany, } from './service-hooks.js';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,iBAAiB;AACjB,OAAO,EAEL,iBAAiB,EACjB,eAAe,GAChB,MAAM,yBAAyB,CAAC;AAEjC,cAAc;AACd,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}

package/dist/hooks/service-hooks.d.ts

@@ -0,0 +1,82 @@
+import type { Context } from 'hono';
+import type { ServiceHooksConfig, ServiceMethodMetadata } from './types.js';
+/**
+ * Wraps a service with hooks that run before/after/on-error for method calls.
+ * This creates a transparent proxy that intercepts method calls and runs hooks
+ * while preserving all service functionality.
+ *
+ * **Note:** Hooks only run for method calls, not property access.
+ *
+ * @param service - The service instance to wrap
+ * @param config - Hook configuration
+ * @param honoContext - The current Hono request context
+ * @returns Proxied service with hooks
+ *
+ * @example
+ * ```typescript
+ * const authHook: ServiceHook = {
+ *   before: async (context) => {
+ *     if (context.metadata?.authorize) {
+ *       authorize(context.honoContext, ...);
+ *     }
+ *   }
+ * };
+ *
+ * const wrappedService = withServiceHooks(authService, {
+ *   hooks: [authHook],
+ *   metadata: {
+ *     deleteSession: {
+ *       authorize: { action: 'delete', subject: 'Session' }
+ *     }
+ *   }
+ * }, honoContext);
+ *
+ * // Hooks automatically run when calling methods
+ * await wrappedService.deleteSession(token);
+ * ```
+ */
+export declare function withServiceHooks<T extends object>(service: T, config: ServiceHooksConfig, honoContext: Context): T;
+/**
+ * Wraps multiple services with the same hooks configuration.
+ * Useful when you want to apply the same hooks to all services in a container.
+ *
+ * @param services - Object containing service instances
+ * @param config - Hook configuration (can be a function for per-service config)
+ * @param honoContext - The current Hono request context
+ * @returns Object with all services wrapped with hooks
+ *
+ * @example
+ * ```typescript
+ * const wrappedServices = withServiceHooksMany(
+ *   { authService, userService },
+ *   (serviceName) => ({
+ *     hooks: [authHook, auditHook],
+ *     metadata: serviceMetadataRegistry[serviceName],
+ *     serviceName,
+ *   }),
+ *   honoContext
+ * );
+ * ```
+ */
+export declare function withServiceHooksMany<T extends Record<string, object>>(services: T, config: ServiceHooksConfig | ((serviceName: string, service: unknown) => ServiceHooksConfig), honoContext: Context): T;
+/**
+ * Helper to define service method metadata with better type inference.
+ * This is just an identity function that helps TypeScript understand the structure.
+ *
+ * @param metadata - Service method metadata mapping
+ * @returns The same metadata (identity function)
+ *
+ * @example
+ * ```typescript
+ * export const authServiceMetadata = defineServiceMetadata({
+ *   deleteSession: {
+ *     authorize: { action: 'delete', subject: 'Session' }
+ *   },
+ *   findById: {
+ *     authorize: { action: 'read', subject: 'User' }
+ *   }
+ * });
+ * ```
+ */
+export declare function defineServiceMetadata(metadata: Record<string, ServiceMethodMetadata>): Record<string, ServiceMethodMetadata>;
+//# sourceMappingURL=service-hooks.d.ts.map

package/dist/hooks/service-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-hooks.d.ts","sourceRoot":"","sources":["../../src/hooks/service-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAGV,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAkDpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAC/C,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,OAAO,GACnB,CAAC,CAqCH;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnE,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,kBAAkB,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,kBAAkB,CAAC,EAC5F,WAAW,EAAE,OAAO,GACnB,CAAC,CAcH;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAC9C,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAEvC"}

package/dist/hooks/service-hooks.js

@@ -0,0 +1,158 @@
+/**
+ * Execute a method with hooks (before/after/error).
+ * Extracted as a helper to reduce complexity.
+ */
+async function executeWithHooks(hookContext, hooks, 
+// biome-ignore lint/suspicious/noExplicitAny: Function type requires any
+originalMethod, target, args) {
+    try {
+        // Run all before hooks
+        for (const hook of hooks) {
+            if (hook.before) {
+                await hook.before(hookContext, args);
+            }
+        }
+        // Execute original method
+        let result = await originalMethod.apply(target, args);
+        // Run all after hooks (in order)
+        for (const hook of hooks) {
+            if (hook.after) {
+                const hookResult = await hook.after(hookContext, args, result);
+                // If hook returns a value, use it as the new result
+                if (hookResult !== undefined) {
+                    result = hookResult;
+                }
+            }
+        }
+        return result;
+    }
+    catch (error) {
+        // Run all error hooks
+        for (const hook of hooks) {
+            if (hook.onError) {
+                await hook.onError(hookContext, args, error);
+            }
+        }
+        // Re-throw the error after hooks
+        throw error;
+    }
+}
+/**
+ * Wraps a service with hooks that run before/after/on-error for method calls.
+ * This creates a transparent proxy that intercepts method calls and runs hooks
+ * while preserving all service functionality.
+ *
+ * **Note:** Hooks only run for method calls, not property access.
+ *
+ * @param service - The service instance to wrap
+ * @param config - Hook configuration
+ * @param honoContext - The current Hono request context
+ * @returns Proxied service with hooks
+ *
+ * @example
+ * ```typescript
+ * const authHook: ServiceHook = {
+ *   before: async (context) => {
+ *     if (context.metadata?.authorize) {
+ *       authorize(context.honoContext, ...);
+ *     }
+ *   }
+ * };
+ *
+ * const wrappedService = withServiceHooks(authService, {
+ *   hooks: [authHook],
+ *   metadata: {
+ *     deleteSession: {
+ *       authorize: { action: 'delete', subject: 'Session' }
+ *     }
+ *   }
+ * }, honoContext);
+ *
+ * // Hooks automatically run when calling methods
+ * await wrappedService.deleteSession(token);
+ * ```
+ */
+export function withServiceHooks(service, config, honoContext) {
+    const { hooks, metadata = {}, serviceName } = config;
+    // Try to determine service name
+    const inferredServiceName = serviceName || service.constructor?.name || 'UnknownService';
+    return new Proxy(service, {
+        get(target, prop) {
+            // Only intercept string properties (method names)
+            if (typeof prop !== 'string') {
+                return Reflect.get(target, prop);
+            }
+            const originalValue = Reflect.get(target, prop);
+            // If it's not a function, return as-is
+            if (typeof originalValue !== 'function') {
+                return originalValue;
+            }
+            // Get metadata for this method
+            const methodMetadata = metadata[prop];
+            // Return wrapped function with hooks
+            return async function (...args) {
+                const hookContext = {
+                    honoContext,
+                    serviceName: inferredServiceName,
+                    methodName: prop,
+                    metadata: methodMetadata,
+                };
+                // biome-ignore lint/suspicious/noExplicitAny: originalValue is guaranteed to be a function by the check above
+                return executeWithHooks(hookContext, hooks, originalValue, target, args);
+            };
+        },
+    });
+}
+/**
+ * Wraps multiple services with the same hooks configuration.
+ * Useful when you want to apply the same hooks to all services in a container.
+ *
+ * @param services - Object containing service instances
+ * @param config - Hook configuration (can be a function for per-service config)
+ * @param honoContext - The current Hono request context
+ * @returns Object with all services wrapped with hooks
+ *
+ * @example
+ * ```typescript
+ * const wrappedServices = withServiceHooksMany(
+ *   { authService, userService },
+ *   (serviceName) => ({
+ *     hooks: [authHook, auditHook],
+ *     metadata: serviceMetadataRegistry[serviceName],
+ *     serviceName,
+ *   }),
+ *   honoContext
+ * );
+ * ```
+ */
+export function withServiceHooksMany(services, config, honoContext) {
+    const result = {};
+    for (const [serviceName, service] of Object.entries(services)) {
+        const serviceConfig = typeof config === 'function' ? config(serviceName, service) : config;
+        result[serviceName] = withServiceHooks(service, { ...serviceConfig, serviceName }, honoContext);
+    }
+    return result;
+}
+/**
+ * Helper to define service method metadata with better type inference.
+ * This is just an identity function that helps TypeScript understand the structure.
+ *
+ * @param metadata - Service method metadata mapping
+ * @returns The same metadata (identity function)
+ *
+ * @example
+ * ```typescript
+ * export const authServiceMetadata = defineServiceMetadata({
+ *   deleteSession: {
+ *     authorize: { action: 'delete', subject: 'Session' }
+ *   },
+ *   findById: {
+ *     authorize: { action: 'read', subject: 'User' }
+ *   }
+ * });
+ * ```
+ */
+export function defineServiceMetadata(metadata) {
+    return metadata;
+}
+//# sourceMappingURL=service-hooks.js.map

package/dist/hooks/service-hooks.js.map

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

package/dist/hooks/types.d.ts

@@ -0,0 +1,151 @@
+import type { Context } from 'hono';
+/**
+ * Context passed to service hooks containing the current Hono request context
+ * and any additional metadata about the service call.
+ */
+export interface ServiceHookContext {
+    /**
+     * The Hono request context, providing access to request data,
+     * response helpers, and context variables (like user, ability, etc.)
+     */
+    honoContext: Context;
+    /**
+     * The name of the service being called (e.g., 'authService', 'userService')
+     */
+    serviceName: string;
+    /**
+     * The name of the method being called (e.g., 'deleteSession', 'findById')
+     */
+    methodName: string;
+    /**
+     * Optional metadata associated with this service method.
+     * Can be used to pass configuration like authorization rules, audit info, etc.
+     */
+    metadata?: unknown;
+}
+/**
+ * Hook function that runs before a service method is executed.
+ * Can be used for authorization, validation, logging, etc.
+ *
+ * @param context - Hook context with Hono context and service info
+ * @param args - Arguments being passed to the service method
+ * @throws Error to prevent the service method from executing
+ *
+ * @example
+ * ```typescript
+ * const authorizationHook: ServiceBeforeHook = async (context, args) => {
+ *   const { honoContext, metadata } = context;
+ *   if (metadata?.authorize) {
+ *     authorize(honoContext, metadata.authorize.action, metadata.authorize.subject);
+ *   }
+ * };
+ * ```
+ */
+export type ServiceBeforeHook = (context: ServiceHookContext, args: unknown[]) => Promise<void> | void;
+/**
+ * Hook function that runs after a service method successfully executes.
+ * Can be used for audit logging, metrics, response transformation, etc.
+ *
+ * @param context - Hook context with Hono context and service info
+ * @param args - Arguments that were passed to the service method
+ * @param result - The result returned by the service method
+ * @returns Optionally return a transformed result
+ *
+ * @example
+ * ```typescript
+ * const auditHook: ServiceAfterHook = async (context, args, result) => {
+ *   await auditLog.create({
+ *     service: context.serviceName,
+ *     method: context.methodName,
+ *     args,
+ *     timestamp: new Date(),
+ *   });
+ * };
+ * ```
+ */
+export type ServiceAfterHook = (context: ServiceHookContext, args: unknown[], result: unknown) => Promise<unknown | undefined> | unknown | undefined;
+/**
+ * Hook function that runs when a service method throws an error.
+ * Can be used for error logging, error transformation, retries, etc.
+ *
+ * @param context - Hook context with Hono context and service info
+ * @param args - Arguments that were passed to the service method
+ * @param error - The error that was thrown
+ * @throws Error to propagate or throw a different error
+ *
+ * @example
+ * ```typescript
+ * const errorLoggingHook: ServiceErrorHook = async (context, args, error) => {
+ *   logger.error('Service error', {
+ *     service: context.serviceName,
+ *     method: context.methodName,
+ *     error,
+ *   });
+ *   // Re-throw to propagate
+ *   throw error;
+ * };
+ * ```
+ */
+export type ServiceErrorHook = (context: ServiceHookContext, args: unknown[], error: unknown) => undefined | never | Promise<undefined | never>;
+/**
+ * A service hook that can define before, after, and error handlers.
+ */
+export interface ServiceHook {
+    /**
+     * Optional hook that runs before the service method executes.
+     */
+    before?: ServiceBeforeHook;
+    /**
+     * Optional hook that runs after the service method successfully executes.
+     */
+    after?: ServiceAfterHook;
+    /**
+     * Optional hook that runs when the service method throws an error.
+     */
+    onError?: ServiceErrorHook;
+}
+/**
+ * Metadata that can be attached to service methods to configure hook behavior.
+ */
+export type ServiceMethodMetadata = Record<string, unknown>;
+/**
+ * Configuration for applying hooks to a service.
+ */
+export interface ServiceHooksConfig {
+    /**
+     * Array of hooks to apply to the service.
+     * Hooks run in the order they're defined.
+     */
+    hooks: ServiceHook[];
+    /**
+     * Optional metadata for service methods.
+     * Keys are method names, values are metadata objects.
+     *
+     * @example
+     * ```typescript
+     * {
+     *   deleteSession: {
+     *     authorize: { action: 'delete', subject: 'Session' }
+     *   },
+     *   findById: {
+     *     authorize: { action: 'read', subject: 'User' },
+     *     cache: { ttl: 300 }
+     *   }
+     * }
+     * ```
+     */
+    metadata?: Record<string, ServiceMethodMetadata>;
+    /**
+     * Optional service name for better debugging.
+     * If not provided, will try to infer from the service constructor name.
+     */
+    serviceName?: string;
+}
+/**
+ * Services registry that maps service names to their wrapped instances.
+ * This is used internally by the route context to provide hooked services.
+ */
+export type ServicesRegistry<T = unknown> = {
+    [K in keyof T]: T[K];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/hooks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,OAAO,EAAE,KACZ,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,EAAE,OAAO,KACZ,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,GAAG,OAAO,GAAG,SAAS,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAC7B,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,OAAO,EAAE,EACf,KAAK,EAAE,OAAO,KACX,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAE3B;;OAEG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,KAAK,EAAE,WAAW,EAAE,CAAC;IAErB;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAEjD;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI;KACzC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CACrB,CAAC"}

package/dist/hooks/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/hooks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":""}

package/dist/http/route-helpers.d.ts

@@ -126,6 +126,22 @@ export interface RouteOpenAPIOptions extends Partial<Omit<DescribeRouteOptions,
      * ```
      */
     responseHeaders?: string[] | Record<string, string[]>;
+    /**
+     * Exclude this route from the OpenAPI specification.
+     * Useful for internal or hidden endpoints.
+     */
+    exclude?: boolean;
+    /**
+     * Mark this route as deprecated.
+     */
+    deprecated?: boolean;
+    /**
+     * External documentation for this route.
+     */
+    docs?: {
+        description?: string;
+        url: string;
+    };
 }
 /**
  * Route configuration with automatic type inference from Valibot schemas.
@@ -166,6 +182,12 @@ export interface RouteConfig<TBody extends ValibotSchema | undefined = undefined
      */
     public?: TPublic;
     body?: TBody;
+    /**
+     * Content type for request body validation.
+     * - 'json': application/json (default)
+     * - 'form': application/x-www-form-urlencoded or multipart/form-data
+     */
+    bodyType?: 'json' | 'form';
     query?: ValibotSchema;
     params?: ValibotSchema;
     responses?: TResponses;

package/dist/http/route-helpers.d.ts.map

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

package/dist/http/route-helpers.js

@@ -105,7 +105,7 @@ function hasPaginationFields(schema) {
  * Create a validation middleware for request validation.
  * Returns 422 Unprocessable Entity on validation failure (instead of Hono's default 400).
  *
- * @param type - The validation target ('json' for body, 'query', or 'param')
+ * @param type - The validation target ('json' or 'form' for body, 'query', or 'param')
  * @param schema - The Valibot schema to validate against
  */
 function createValidationMiddleware(type, schema) {
@@ -185,14 +185,16 @@ export function route(router, config) {
     // Detect pagination from query schema
     const hasPagination = hasPaginationFields(config.query);
     // Add OpenAPI metadata
-    middlewares.push(buildOpenAPIMiddleware(config, openAPIContext, hasPagination));
+    if (!config.openapi?.exclude) {
+        middlewares.push(buildOpenAPIMiddleware(config, openAPIContext, hasPagination));
+    }
     // Add custom middleware (e.g., auth) before validation
     if (config.middleware) {
         middlewares.push(...config.middleware);
     }
     // Add validation middleware (returns 422 instead of Hono's default 400)
     if (config.body) {
-        middlewares.push(createValidationMiddleware('json', config.body));
+        middlewares.push(createValidationMiddleware(config.bodyType || 'json', config.body));
     }
     if (config.query) {
         middlewares.push(createValidationMiddleware('query', config.query));
@@ -202,9 +204,9 @@ export function route(router, config) {
     }
     // Add handler wrapper
     middlewares.push(async (c) => {
-        const routeContext = buildRouteContext(c);
+        const routeContext = buildRouteContext(c, config);
         const result = await config.handler(routeContext);
-        return handleResponse(result, config.responses, config.serialization, config.summary, c);
+        return handleResponse(result, config.responses, config.serialization, config.strictTypes, config.summary, c);
     });
     return middlewares;
 }
@@ -237,7 +239,7 @@ function serializeResponseData(data, serializationConfig) {
  * @param context - Hono context
  * @returns Response object or undefined if handled
  */
-async function handleResponse(result, responses, serializationConfig, routeSummary, context) {
+async function handleResponse(result, responses, serializationConfig, strictTypes, routeSummary, context) {
     // If handler returned a Response, return it directly (for custom responses like text)
     if (result instanceof Response) {
         return result;
@@ -250,7 +252,14 @@ async function handleResponse(result, responses, serializationConfig, routeSumma
     // Serialize Prisma types and custom transformers
     let serializedResult;
     try {
-        serializedResult = serializeResponseData(result, serializationConfig);
+        // Only serialize if strictTypes is disabled (default)
+        // If strictTypes is true, we expect the handler to return exact types
+        if (!strictTypes) {
+            serializedResult = serializeResponseData(result, serializationConfig);
+        }
+        else {
+            serializedResult = result;
+        }
     }
     catch (error) {
         // Handle serialization errors (circular references, max depth exceeded)
@@ -327,13 +336,14 @@ function buildOpenAPIMiddleware(config, openAPIContext, hasPagination) {
     const security = config.public
         ? []
         : openAPIContext.securitySchemes.map((scheme) => ({ [scheme]: [] }));
-    // Extract responseHeaders from openapi config to avoid passing it to hono-openapi
-    const { responseHeaders: _responseHeaders, ...restOpenapi } = config.openapi ?? {};
+    // Extract responseHeaders and exclude from openapi config to avoid passing it to hono-openapi
+    const { responseHeaders: _responseHeaders, exclude: _exclude, docs, ...restOpenapi } = config.openapi ?? {};
     const openApiConfig = {
         operationId: config.operationId || config.summary,
         tags: config.tags,
         summary: config.summary,
         description: config.description,
+        externalDocs: docs,
         responses: responses,
         security,
         ...restOpenapi,
@@ -410,7 +420,7 @@ function buildOpenAPIResponses(config, openAPIContext, hasPagination) {
     }
     return responses;
 }
-function buildRouteContext(c) {
+function buildRouteContext(c, config) {
     const req = c.req;
     // Spread all context variables (from ContextVariableMap)
     // This includes session, ability, role, and any other middleware-added variables
@@ -418,7 +428,7 @@ function buildRouteContext(c) {
     // The type will be narrowed at the call site based on the route's public setting
     return {
         ...c.var,
-        body: req.valid('json'),
+        body: req.valid(config.bodyType || 'json'),
         query: req.valid('query'),
         params: req.valid('param'),
         services: c.get('services') || {},