raffel 0.2.3 → 1.0.0-next.f81d4db

package/dist/dx/scenarios.js

@@ -0,0 +1,109 @@
+/**
+ * Developer-friendly scenario presets for multi-protocol server bootstrapping.
+ *
+ * These helpers generate `createServer()` configuration objects for
+ * common combinations used during development.
+ */
+function buildOptionalTransportPorts(input) {
+    const host = input.host ?? '0.0.0.0';
+    const config = {};
+    if (input.tcpPort !== undefined) {
+        config.tcp = { port: input.tcpPort, host };
+    }
+    return config;
+}
+function resolveGrpcConfig(input) {
+    if (input.grpc === false || input.grpc === undefined) {
+        return undefined;
+    }
+    if (typeof input.grpc === 'object') {
+        return input.grpc;
+    }
+    return undefined;
+}
+export function createServerScenario(scenario, input) {
+    const port = input.port;
+    const host = input.host ?? '0.0.0.0';
+    const protocolAliasMode = input.protocolAliasMode ?? 'standard';
+    const websocketPath = input.websocketPath ?? '/ws';
+    const jsonrpcPath = input.jsonrpcPath ?? '/rpc';
+    const graphqlPath = input.graphqlPath ?? '/graphql';
+    const base = {
+        port,
+        host,
+        basePath: input.basePath ?? '/',
+        protocolAliasMode,
+    };
+    if (typeof input.singlePort === 'boolean') {
+        base.singlePort = {
+            enabled: input.singlePort,
+            protocols: input.singlePortProtocols,
+            protocolAliasMode,
+        };
+    }
+    else if (input.singlePort) {
+        base.singlePort = {
+            ...input.singlePort,
+            protocols: input.singlePort.protocols ?? input.singlePortProtocols,
+            protocolAliasMode: input.singlePort.protocolAliasMode ?? protocolAliasMode,
+        };
+    }
+    const transports = buildOptionalTransportPorts(input);
+    if (scenario === 'realtime') {
+        return {
+            ...base,
+            websocket: { path: websocketPath },
+            ...transports,
+            scenario,
+        };
+    }
+    if (scenario === 'rpc') {
+        const grpc = resolveGrpcConfig(input);
+        return {
+            ...base,
+            jsonrpc: { path: jsonrpcPath },
+            grpc,
+            ...transports,
+            scenario,
+        };
+    }
+    if (scenario === 'dev') {
+        const grpc = resolveGrpcConfig(input);
+        return {
+            ...base,
+            websocket: { path: websocketPath },
+            jsonrpc: { path: jsonrpcPath },
+            graphql: { path: graphqlPath },
+            grpc,
+            ...transports,
+            scenario,
+        };
+    }
+    if (scenario === 'full') {
+        const grpc = resolveGrpcConfig(input);
+        const tcp = transports.tcp
+            ? transports.tcp
+            : input.singlePort
+                ? undefined
+                : { port: port + 2, host };
+        return {
+            ...base,
+            websocket: { path: websocketPath },
+            jsonrpc: { path: jsonrpcPath },
+            graphql: { path: graphqlPath },
+            grpc,
+            tcp,
+            scenario,
+        };
+    }
+    // api
+    return {
+        ...base,
+        websocket: { path: websocketPath },
+        jsonrpc: { path: jsonrpcPath },
+        graphql: { path: graphqlPath },
+        ...transports,
+        scenario,
+    };
+}
+//# sourceMappingURL=scenarios.js.map

package/dist/dx/scenarios.js.map

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

package/dist/errors/codes.d.ts

@@ -113,7 +113,7 @@ export declare const ErrorCodes: {
     /** Request timeout / deadline exceeded (local) */
     readonly DEADLINE_EXCEEDED: {
         readonly code: "DEADLINE_EXCEEDED";
-        readonly status: 504;
+        readonly status: 408;
         readonly message: "Deadline exceeded";
     };
     /**

package/dist/errors/codes.js

@@ -105,7 +105,7 @@ export const ErrorCodes = {
     /** Request timeout / deadline exceeded (local) */
     DEADLINE_EXCEEDED: {
         code: 'DEADLINE_EXCEEDED',
-        status: 504,
+        status: 408,
         message: 'Deadline exceeded',
     },
     /**

package/dist/graphql/adapter.js

@@ -110,7 +110,7 @@ async function withTimeout(promise, timeoutMs) {
     }
     return new Promise((resolve, reject) => {
         const timer = setTimeout(() => {
-            reject(new GraphQLAdapterError('DEADLINE_EXCEEDED', 504, 'Request deadline exceeded'));
+            reject(new GraphQLAdapterError('DEADLINE_EXCEEDED', 408, 'Request deadline exceeded'));
         }, timeoutMs);
         promise.then((value) => {
             clearTimeout(timer);

package/dist/http/index.d.ts

@@ -61,6 +61,8 @@ export { createValidator, validateBody, validateQuery, validateParams, validateH
 export type { ValidationTarget, Validator, CompiledSchema, ValidationMiddlewareOptions, CombinedValidationOptions, } from './validate.js';
 export { createTemplateEngine, renderMiddleware, renderTemplate, createEjsAdapter, createPugAdapter, createHandlebarsAdapter, } from './templates.js';
 export type { TemplateData, TemplateEngineAdapter, CompiledTemplate, TemplateEngineOptions, TemplateManager, RenderMiddlewareOptions, } from './templates.js';
+export { serveRedoc, serveSwaggerUI, mountOpenApiDocs, } from './openapi-ui.js';
+export type { RedocOptions, SwaggerUIOptions, DocsUI, MountOpenApiDocsOptions, HttpAppWithRoutes, } from './openapi-ui.js';
 export { createStreamAuthFactory, streamBearerAuth, streamApiKeyAuth, streamCookieSession, extractBearerToken, extractApiKey, extractCookieSession, parsePathParams, parseQueryParams, matchStreamRoute, } from './stream-auth.js';
 export type { StreamAuthResult, StreamBearerOptions, StreamApiKeyOptions, StreamCookieSessionOptions, StreamAuthFactoryOptions, StreamContext, StreamRoute, } from './stream-auth.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/http/index.d.ts.map

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

package/dist/http/index.js

@@ -126,6 +126,10 @@ export { createValidator, validateBody, validateQuery, validateParams, validateH
 // ─────────────────────────────────────────────────────────────────────────────
 export { createTemplateEngine, renderMiddleware, renderTemplate, createEjsAdapter, createPugAdapter, createHandlebarsAdapter, } from './templates.js';
 // ─────────────────────────────────────────────────────────────────────────────
+// OpenAPI Documentation UI
+// ─────────────────────────────────────────────────────────────────────────────
+export { serveRedoc, serveSwaggerUI, mountOpenApiDocs, } from './openapi-ui.js';
+// ─────────────────────────────────────────────────────────────────────────────
 // Stream Authentication
 // ─────────────────────────────────────────────────────────────────────────────
 export { createStreamAuthFactory, streamBearerAuth, streamApiKeyAuth, streamCookieSession, extractBearerToken, extractApiKey, extractCookieSession, parsePathParams, parseQueryParams, matchStreamRoute, } from './stream-auth.js';

package/dist/http/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,gFAAgF;AAChF,mCAAmC;AACnC,gFAAgF;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AASlC,gFAAgF;AAChF,yCAAyC;AACzC,gFAAgF;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAQ1C,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAOlC,gFAAgF;AAChF,4CAA4C;AAC5C,gFAAgF;AAEhF,OAAO,EACL,SAAS,EACT,SAAS,GACV,MAAM,YAAY,CAAA;AAiCnB,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,OAAO;AACL,0BAA0B;AAC1B,SAAS,EACT,UAAU,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY;AAEZ,mBAAmB;AACnB,UAAU,EACV,aAAa;AAEb,iBAAiB;AACjB,eAAe,EACf,eAAe;AAEf,mBAAmB;AACnB,aAAa,EACb,eAAe;AAEf,qCAAqC;AACrC,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EAMf,wBAAwB,GACzB,MAAM,aAAa,CAAA;AAapB,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,gFAAgF;AAChF,8BAA8B;AAC9B,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAe7C,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,OAAO,EACL,OAAO,EACP,KAAK,EACL,IAAI,EACJ,OAAO,EACP,SAAS,EACT,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,eAAe,CAAA;AAWtB,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,6BAA6B,EAC7B,4BAA4B,EAC5B,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,EAC3B,uBAAuB,EACvB,eAAe,EACf,WAAW,GACZ,MAAM,aAAa,CAAA;AAMpB,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,sBAAsB,GACvB,MAAM,aAAa,CAAA;AAYpB,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,OAAO,EACL,SAAS,EACT,SAAS,EACT,UAAU,GACX,MAAM,iBAAiB,CAAA;AAMxB,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO,EACL,oBAAoB,EACpB,WAAW,EACX,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,KAAK,EACL,SAAS,EACT,QAAQ,GACT,MAAM,aAAa,CAAA;AAUpB,gFAAgF;AAChF,kBAAkB;AAClB,gFAAgF;AAEhF,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,sBAAsB,CAAA;AAO7B,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,OAAO,EACL,SAAS,EACT,UAAU,EACV,aAAa,EACb,aAAa;AACb,6BAA6B;AAC7B,QAAQ,EACR,SAAS;AACT,mBAAmB;AACnB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,WAAW,CAAA;AAoBlB,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,OAAO,EACL,MAAM,EACN,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,aAAa,CAAA;AAQpB,gFAAgF;AAChF,uCAAuC;AACvC,gFAAgF;AAEhF,OAAO,EACL,IAAI,EACJ,oBAAoB,EACpB,cAAc,GACf,MAAM,WAAW,CAAA;AAUlB,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGzC,yBAAyB;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAS9C,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAG3E,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAWjE,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAS5E,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAA;AAUrB,sBAAsB;AACtB,OAAO,EACL,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,oBAAoB,CAAA;AAO3B,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,OAAO,EACP,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AAaxB,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,OAAO,EACL,eAAe,EACf,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,QAAQ,GACT,MAAM,eAAe,CAAA;AAStB,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,gBAAgB,CAAA;AAUvB,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF,OAAO,EACL,UAAU,EACV,cAAc,EACd,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AASxB,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAA"}

package/dist/http/openapi-ui.d.ts

@@ -0,0 +1,174 @@
+/**
+ * OpenAPI Documentation UI Middleware
+ *
+ * Provides generic middleware helpers for serving OpenAPI documentation UIs:
+ * - serveRedoc()    — serves ReDoc (https://redocly.com/redoc/)
+ * - serveSwaggerUI() — serves Swagger UI (https://swagger.io/tools/swagger-ui/)
+ * - mountOpenApiDocs() — convenience helper to mount both /openapi.json and /docs
+ *
+ * Completely framework-agnostic: works with any OpenAPI spec generator.
+ * No external runtime dependencies (UIs loaded via CDN).
+ *
+ * @example
+ * ```typescript
+ * import { HttpApp } from 'raffel/http'
+ * import { serveRedoc, serveSwaggerUI, mountOpenApiDocs } from 'raffel/http'
+ *
+ * const app = new HttpApp()
+ *
+ * // Option A: Mount both JSON spec + ReDoc UI in one call
+ * mountOpenApiDocs(app, {
+ *   spec: () => generateOpenApiSpec(),
+ *   title: 'My API',
+ * })
+ *
+ * // Option B: Individual middleware
+ * app.get('/openapi.json', (c) => c.json(generateOpenApiSpec()))
+ * app.get('/docs', serveRedoc({ specUrl: '/openapi.json', title: 'My API' }))
+ * ```
+ */
+import type { HttpHandler, HttpMiddleware } from './app.js';
+export interface RedocOptions {
+    /**
+     * URL of the OpenAPI spec JSON.
+     * Can be absolute or relative to the current origin.
+     * @default '/openapi.json'
+     */
+    specUrl?: string;
+    /**
+     * Page title shown in the browser tab.
+     * @default 'API Documentation'
+     */
+    title?: string;
+    /**
+     * Custom Content-Security-Policy header value.
+     * If not provided, a permissive policy for CDN-hosted ReDoc is applied.
+     */
+    csp?: string | null;
+    /**
+     * ReDoc CDN version to load.
+     * @default 'latest'
+     */
+    version?: string;
+    /**
+     * Additional HTML to inject into the <head> element.
+     * Useful for custom fonts, analytics, etc.
+     */
+    head?: string;
+    /**
+     * ReDoc configuration options passed as `redoc-config` JSON.
+     * See https://redocly.com/docs/redoc/config/
+     */
+    config?: Record<string, unknown>;
+}
+export interface SwaggerUIOptions {
+    /**
+     * URL of the OpenAPI spec JSON.
+     * @default '/openapi.json'
+     */
+    specUrl?: string;
+    /**
+     * Page title shown in the browser tab.
+     * @default 'API Documentation'
+     */
+    title?: string;
+    /**
+     * Custom Content-Security-Policy header value.
+     * If not provided, a permissive policy for CDN-hosted Swagger UI is applied.
+     */
+    csp?: string | null;
+    /**
+     * Swagger UI CDN version to load.
+     * @default 'latest'
+     */
+    version?: string;
+    /**
+     * OAuth2 redirect URL for Swagger UI.
+     * @default '/docs/oauth2-redirect'
+     */
+    oauth2RedirectUrl?: string;
+}
+export type DocsUI = 'redoc' | 'swagger';
+export interface MountOpenApiDocsOptions {
+    /**
+     * Function that returns the OpenAPI spec object.
+     * Called on every request to /openapi.json (consider caching in the function).
+     */
+    spec: () => Record<string, unknown>;
+    /**
+     * Path where the OpenAPI JSON spec will be served.
+     * @default '/openapi.json'
+     */
+    specPath?: string;
+    /**
+     * Path where the documentation UI will be served.
+     * @default '/docs'
+     */
+    docsPath?: string;
+    /**
+     * Documentation UI to use.
+     * @default 'redoc'
+     */
+    ui?: DocsUI;
+    /**
+     * Page title for the docs UI.
+     * @default 'API Documentation'
+     */
+    title?: string;
+    /**
+     * Custom CSP header for the docs page.
+     */
+    csp?: string | null;
+    /**
+     * ReDoc-specific options (when ui = 'redoc').
+     */
+    redoc?: Omit<RedocOptions, 'specUrl' | 'title' | 'csp'>;
+    /**
+     * Swagger UI-specific options (when ui = 'swagger').
+     */
+    swagger?: Omit<SwaggerUIOptions, 'specUrl' | 'title' | 'csp'>;
+}
+export interface HttpAppWithRoutes {
+    get(path: string, handler: HttpHandler): unknown;
+}
+/**
+ * Create a handler that serves ReDoc documentation UI.
+ *
+ * @example
+ * ```typescript
+ * app.get('/docs', serveRedoc({ specUrl: '/openapi.json', title: 'My API' }))
+ * ```
+ */
+export declare function serveRedoc(options?: RedocOptions): HttpHandler;
+/**
+ * Create a handler that serves Swagger UI documentation.
+ *
+ * @example
+ * ```typescript
+ * app.get('/docs', serveSwaggerUI({ specUrl: '/openapi.json', title: 'My API' }))
+ * ```
+ */
+export declare function serveSwaggerUI(options?: SwaggerUIOptions): HttpHandler;
+/**
+ * Mount OpenAPI documentation routes on an HttpApp (or any app with `.get()`).
+ *
+ * Registers two routes:
+ * - `specPath` (default: `/openapi.json`) — returns the OpenAPI spec as JSON
+ * - `docsPath` (default: `/docs`) — serves the documentation UI (ReDoc or Swagger UI)
+ *
+ * @example
+ * ```typescript
+ * import { HttpApp, mountOpenApiDocs } from 'raffel/http'
+ *
+ * const app = new HttpApp()
+ *
+ * mountOpenApiDocs(app, {
+ *   spec: () => generateOpenApiSpec(),
+ *   title: 'My API',
+ *   ui: 'redoc',
+ * })
+ * ```
+ */
+export declare function mountOpenApiDocs(app: HttpAppWithRoutes, options: MountOpenApiDocsOptions): void;
+export type { HttpHandler, HttpMiddleware };
+//# sourceMappingURL=openapi-ui.d.ts.map

package/dist/http/openapi-ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-ui.d.ts","sourceRoot":"","sources":["../../src/http/openapi-ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AAM3D,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;AAExC,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,IAAI,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IAEX;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC,CAAA;IAEvD;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,OAAO,GAAG,KAAK,CAAC,CAAA;CAC9D;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAA;CACjD;AA6DD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,YAAiB,GAAG,WAAW,CAalE;AAgED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,WAAW,CAa1E;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CA2CN;AAMD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,CAAA"}

package/dist/http/openapi-ui.js

@@ -0,0 +1,221 @@
+/**
+ * OpenAPI Documentation UI Middleware
+ *
+ * Provides generic middleware helpers for serving OpenAPI documentation UIs:
+ * - serveRedoc()    — serves ReDoc (https://redocly.com/redoc/)
+ * - serveSwaggerUI() — serves Swagger UI (https://swagger.io/tools/swagger-ui/)
+ * - mountOpenApiDocs() — convenience helper to mount both /openapi.json and /docs
+ *
+ * Completely framework-agnostic: works with any OpenAPI spec generator.
+ * No external runtime dependencies (UIs loaded via CDN).
+ *
+ * @example
+ * ```typescript
+ * import { HttpApp } from 'raffel/http'
+ * import { serveRedoc, serveSwaggerUI, mountOpenApiDocs } from 'raffel/http'
+ *
+ * const app = new HttpApp()
+ *
+ * // Option A: Mount both JSON spec + ReDoc UI in one call
+ * mountOpenApiDocs(app, {
+ *   spec: () => generateOpenApiSpec(),
+ *   title: 'My API',
+ * })
+ *
+ * // Option B: Individual middleware
+ * app.get('/openapi.json', (c) => c.json(generateOpenApiSpec()))
+ * app.get('/docs', serveRedoc({ specUrl: '/openapi.json', title: 'My API' }))
+ * ```
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// ReDoc
+// ─────────────────────────────────────────────────────────────────────────────
+const REDOC_CDN_BASE = 'https://cdn.redoc.ly';
+const FONTS_CSS_CDN = 'https://fonts.googleapis.com';
+const FONTS_GSTATIC_CDN = 'https://fonts.gstatic.com';
+function buildRedocCsp(custom) {
+    if (custom !== undefined)
+        return custom;
+    return [
+        "default-src 'self'",
+        `script-src 'self' 'unsafe-inline' ${REDOC_CDN_BASE}`,
+        `script-src-elem 'self' 'unsafe-inline' ${REDOC_CDN_BASE}`,
+        `style-src 'self' 'unsafe-inline' ${REDOC_CDN_BASE} ${FONTS_CSS_CDN}`,
+        "img-src 'self' data: https:",
+        `font-src 'self' ${FONTS_GSTATIC_CDN}`,
+        "connect-src 'self'",
+    ].join('; ');
+}
+function buildRedocHtml(options) {
+    const { specUrl = '/openapi.json', title = 'API Documentation', version = 'latest', head = '', config, } = options;
+    const configAttr = config
+        ? ` redoc-config='${JSON.stringify(config)}'`
+        : '';
+    const cdnUrl = version === 'latest'
+        ? `${REDOC_CDN_BASE}/redoc/latest/bundles/redoc.standalone.js`
+        : `${REDOC_CDN_BASE}/redoc/v${version}/bundles/redoc.standalone.js`;
+    return [
+        '<!DOCTYPE html>',
+        '<html lang="en">',
+        '<head>',
+        '  <meta charset="UTF-8">',
+        '  <meta name="viewport" content="width=device-width, initial-scale=1.0">',
+        `  <title>${title}</title>`,
+        '  <style>body { margin: 0; padding: 0; }</style>',
+        head,
+        '</head>',
+        '<body>',
+        `  <redoc spec-url="${specUrl}"${configAttr}></redoc>`,
+        `  <script src="${cdnUrl}"></script>`,
+        '</body>',
+        '</html>',
+    ]
+        .filter((line) => line !== '')
+        .join('\n');
+}
+/**
+ * Create a handler that serves ReDoc documentation UI.
+ *
+ * @example
+ * ```typescript
+ * app.get('/docs', serveRedoc({ specUrl: '/openapi.json', title: 'My API' }))
+ * ```
+ */
+export function serveRedoc(options = {}) {
+    const html = buildRedocHtml(options);
+    const csp = buildRedocCsp(options.csp);
+    return (c) => {
+        const headers = {
+            'Content-Type': 'text/html; charset=UTF-8',
+        };
+        if (csp) {
+            headers['Content-Security-Policy'] = csp;
+        }
+        return new Response(html, { status: 200, headers });
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Swagger UI
+// ─────────────────────────────────────────────────────────────────────────────
+const SWAGGER_CDN_BASE = 'https://unpkg.com/swagger-ui-dist';
+function buildSwaggerCsp(custom) {
+    if (custom !== undefined)
+        return custom;
+    return [
+        "default-src 'self'",
+        `script-src 'self' 'unsafe-inline' ${SWAGGER_CDN_BASE}`,
+        `script-src-elem 'self' 'unsafe-inline' ${SWAGGER_CDN_BASE}`,
+        `style-src 'self' 'unsafe-inline' ${SWAGGER_CDN_BASE}`,
+        "img-src 'self' data: https:",
+        "font-src 'self' data:",
+        "connect-src 'self'",
+    ].join('; ');
+}
+function buildSwaggerHtml(options) {
+    const { specUrl = '/openapi.json', title = 'API Documentation', version = 'latest', oauth2RedirectUrl, } = options;
+    const cdnBase = version === 'latest' ? SWAGGER_CDN_BASE : `https://unpkg.com/swagger-ui-dist@${version}`;
+    const oauth2Attr = oauth2RedirectUrl
+        ? `\n          oauth2RedirectUrl: '${oauth2RedirectUrl}',`
+        : '';
+    return [
+        '<!DOCTYPE html>',
+        '<html lang="en">',
+        '<head>',
+        '  <meta charset="UTF-8">',
+        '  <meta name="viewport" content="width=device-width, initial-scale=1.0">',
+        `  <title>${title}</title>`,
+        `  <link rel="stylesheet" href="${cdnBase}/swagger-ui.css">`,
+        '  <style>body { margin: 0; padding: 0; }</style>',
+        '</head>',
+        '<body>',
+        '  <div id="swagger-ui"></div>',
+        `  <script src="${cdnBase}/swagger-ui-bundle.js"></script>`,
+        `  <script src="${cdnBase}/swagger-ui-standalone-preset.js"></script>`,
+        '  <script>',
+        '    window.onload = function() {',
+        '      window.ui = SwaggerUIBundle({',
+        `        url: '${specUrl}',${oauth2Attr}`,
+        "        dom_id: '#swagger-ui',",
+        '        presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],',
+        "        layout: 'StandaloneLayout',",
+        '        deepLinking: true,',
+        '      })',
+        '    }',
+        '  </script>',
+        '</body>',
+        '</html>',
+    ].join('\n');
+}
+/**
+ * Create a handler that serves Swagger UI documentation.
+ *
+ * @example
+ * ```typescript
+ * app.get('/docs', serveSwaggerUI({ specUrl: '/openapi.json', title: 'My API' }))
+ * ```
+ */
+export function serveSwaggerUI(options = {}) {
+    const html = buildSwaggerHtml(options);
+    const csp = buildSwaggerCsp(options.csp);
+    return (c) => {
+        const headers = {
+            'Content-Type': 'text/html; charset=UTF-8',
+        };
+        if (csp) {
+            headers['Content-Security-Policy'] = csp;
+        }
+        return new Response(html, { status: 200, headers });
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// mountOpenApiDocs — convenience helper
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Mount OpenAPI documentation routes on an HttpApp (or any app with `.get()`).
+ *
+ * Registers two routes:
+ * - `specPath` (default: `/openapi.json`) — returns the OpenAPI spec as JSON
+ * - `docsPath` (default: `/docs`) — serves the documentation UI (ReDoc or Swagger UI)
+ *
+ * @example
+ * ```typescript
+ * import { HttpApp, mountOpenApiDocs } from 'raffel/http'
+ *
+ * const app = new HttpApp()
+ *
+ * mountOpenApiDocs(app, {
+ *   spec: () => generateOpenApiSpec(),
+ *   title: 'My API',
+ *   ui: 'redoc',
+ * })
+ * ```
+ */
+export function mountOpenApiDocs(app, options) {
+    const { spec, specPath = '/openapi.json', docsPath = '/docs', ui = 'redoc', title = 'API Documentation', csp, redoc: redocOpts = {}, swagger: swaggerOpts = {}, } = options;
+    // Register OpenAPI JSON spec endpoint
+    app.get(specPath, (c) => {
+        const specObj = spec();
+        return new Response(JSON.stringify(specObj), {
+            status: 200,
+            headers: { 'Content-Type': 'application/json; charset=UTF-8' },
+        });
+    });
+    // Register docs UI endpoint
+    if (ui === 'swagger') {
+        app.get(docsPath, serveSwaggerUI({
+            specUrl: specPath,
+            title,
+            csp,
+            ...swaggerOpts,
+        }));
+    }
+    else {
+        app.get(docsPath, serveRedoc({
+            specUrl: specPath,
+            title,
+            csp,
+            ...redocOpts,
+        }));
+    }
+}
+//# sourceMappingURL=openapi-ui.js.map

package/dist/http/openapi-ui.js.map

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

package/dist/http/serve.d.ts

@@ -22,6 +22,20 @@ export interface ServeOptions {
     }) => void;
     /** Callback when server encounters an error */
     onError?: (err: Error) => void;
+    /**
+     * Keep-alive timeout in milliseconds.
+     * Time the server waits for additional requests on a persistent connection.
+     * Recommended: slightly above load balancer idle timeout (e.g., 65000 for ALB/nginx).
+     * @default Node.js default (5000ms in Node 18+)
+     */
+    keepAliveTimeout?: number;
+    /**
+     * Headers timeout in milliseconds.
+     * Time allowed to receive the request headers after a connection is established.
+     * Should be greater than keepAliveTimeout.
+     * @default Node.js default (60000ms)
+     */
+    headersTimeout?: number;
 }
 /** Extended server interface with graceful shutdown */
 export interface RaffelServer extends Server {

package/dist/http/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/http/serve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAA6C,MAAM,WAAW,CAAA;AAOhG,6BAA6B;AAC7B,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE7E,oBAAoB;AACpB,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,KAAK,EAAE,YAAY,CAAA;IAEnB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAE7D,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;CAC/B;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC1C;;;OAGG;IACH,qBAAqB,IAAI,IAAI,CAAA;IAE7B;;;;OAIG;IACH,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1D;;OAEG;IACH,gBAAgB,IAAI,MAAM,CAAA;IAE1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5C;AAuFD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CA4GzD;AAMD,eAAe,KAAK,CAAA"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/http/serve.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAA6C,MAAM,WAAW,CAAA;AAOhG,6BAA6B;AAC7B,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;AAE7E,oBAAoB;AACpB,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,KAAK,EAAE,YAAY,CAAA;IAEnB,wBAAwB;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAE7D,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;IAE9B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEzB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC1C;;;OAGG;IACH,qBAAqB,IAAI,IAAI,CAAA;IAE7B;;;;OAIG;IACH,uBAAuB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1D;;OAEG;IACH,gBAAgB,IAAI,MAAM,CAAA;IAE1B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5C;AAuFD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAsHzD;AAMD,eAAe,KAAK,CAAA"}