@c9up/ream 0.1.3

package/dist/http/urlDecode.js

@@ -0,0 +1,18 @@
+/**
+ * Safe URL decoding helpers for untrusted request inputs.
+ */
+/** Decode URI component and keep raw value on malformed escapes. */
+export function safeDecodeURIComponent(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+}
+/** Decode x-www-form-urlencoded component (`+` => space) safely. */
+export function safeDecodeFormComponent(value) {
+    const normalized = value.replace(/\+/g, ' ');
+    return safeDecodeURIComponent(normalized);
+}
+//# sourceMappingURL=urlDecode.js.map

package/dist/http/urlDecode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urlDecode.js","sourceRoot":"","sources":["../../src/http/urlDecode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oEAAoE;AACpE,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAC5C,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAA;AAC3C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @module @c9up/ream
+ * @description Ream — Rust-powered Node.js application framework
+ * @implements FR11, FR12, FR13, FR14, FR16, FR17, FR18, FR19, FR20, FR21
+ */
+import 'reflect-metadata';
+export { Application } from './Application.js';
+export { defineModuleConfig, env, ConfigStore } from './ConfigLoader.js';
+export { Container } from './container/Container.js';
+export type { Binding, ServiceFactory, ServiceScope, ServiceToken } from './container/types.js';
+export { E_FORBIDDEN, E_HTTP_EXCEPTION, E_ROUTE_NOT_FOUND, E_ROW_NOT_FOUND, E_UNAUTHORIZED, E_VALIDATION_ERROR, Exception, ExceptionHandler, } from './http/Exception.js';
+export type { AuthState, RouteInfo } from './http/HttpContext.js';
+export { HttpContext } from './http/HttpContext.js';
+export { RedirectBuilder } from './http/RedirectBuilder.js';
+export type { RawRequest } from './http/Request.js';
+export { Request } from './http/Request.js';
+export { Response } from './http/Response.js';
+export { CookieDriver as SessionCookieDriver } from './session/drivers/CookieDriver.js';
+export { MemoryDriver as SessionMemoryDriver } from './session/drivers/MemoryDriver.js';
+export type { SessionConfig, SessionDriver } from './session/Session.js';
+export { Session } from './session/Session.js';
+export { default as SessionMiddleware } from './session/SessionMiddleware.js';
+export type { BodyParserConfig } from './bodyparser/BodyParserMiddleware.js';
+export { default as BodyParserMiddleware } from './bodyparser/BodyParserMiddleware.js';
+export type { FileValidationOptions } from './bodyparser/MultipartFile.js';
+export { MultipartFile } from './bodyparser/MultipartFile.js';
+export type { RpcConfig, RpcProviderOptions } from './rpc/RpcProvider.js';
+export { RpcProvider } from './rpc/RpcProvider.js';
+export type { RpcHandler, RpcMethodDefinition } from './rpc/RpcRouter.js';
+export { RpcMethodBuilder, RpcRouter } from './rpc/RpcRouter.js';
+export type { GraphQLConfig, ResolverOptions, SelectionField, } from './graphql/GraphQLEngine.js';
+export { GraphQLEngine } from './graphql/GraphQLEngine.js';
+export type { GraphQLProviderOptions } from './graphql/GraphQLProvider.js';
+export { GraphQLProvider } from './graphql/GraphQLProvider.js';
+export type { OpenApiConfig } from './openapi/OpenApiGenerator.js';
+export { OpenApiGenerator } from './openapi/OpenApiGenerator.js';
+export type { OpenApiMiddlewareConfig } from './openapi/OpenApiMiddleware.js';
+export { OpenApiMiddleware } from './openapi/OpenApiMiddleware.js';
+export type { OpenApiDocsConfig, OpenApiProviderOptions, } from './openapi/OpenApiProvider.js';
+export { OpenApiProvider } from './openapi/OpenApiProvider.js';
+export type { PaginationMeta } from './resources/ApiResource.js';
+export { ApiResource } from './resources/ApiResource.js';
+export type { StaticConfig } from './storage/StaticMiddleware.js';
+export { StaticMiddleware } from './storage/StaticMiddleware.js';
+export type { StaticProviderOptions } from './storage/StaticProvider.js';
+export { StaticProvider } from './storage/StaticProvider.js';
+export { CookieSigner } from './security/CookieSigner.js';
+export { setNapi, constantTimeEq, hasNativeCrypto, hmacSign, hmacVerify, randomBytesBase64, randomHex, } from './security/crypto.js';
+export type { SignedUrlConfig } from './security/SignedUrl.js';
+export { SignedUrl } from './security/SignedUrl.js';
+export { createLazyProxy, getLazyParams, Lazy } from './decorators/Lazy.js';
+export { clearServiceRegistry, getServiceMetadata, getServiceRegistry, Inject, inject, Service, } from './decorators/Service.js';
+export type { ControllerAction, MatchResult, ParamMatcher, RouteDefinition, RouteHandler, RouteHandlerFunction, } from './router/Router.js';
+export { GroupBuilder, matchers, OnRouteBuilder, RouteBuilder, Router } from './router/Router.js';
+export type { MiddlewareFunction } from './middleware/Pipeline.js';
+export { compose, MiddlewareRegistry } from './middleware/Pipeline.js';
+export type { HttpKernelConfig } from './HttpKernel.js';
+export { createHttpKernel } from './HttpKernel.js';
+export type { ErrorHandlerClass, LazyImport, MiddlewareClass, MiddlewareEntry, } from './server/Server.js';
+export { resolveMiddlewareEntry, Server } from './server/Server.js';
+export type { Command } from './console/CommandRunner.js';
+export { CommandRunner } from './console/CommandRunner.js';
+export type { AppEnvironment, HyperServerLike, IgnitorConfig, ReamrcConfig } from './Ignitor.js';
+export { ConsoleKernel, defineConfig, Ignitor, prettyPrintError } from './Ignitor.js';
+export type { AppContext, ProviderContract } from './Provider.js';
+export { Provider } from './Provider.js';
+export type { Codemods } from './Codemods.js';
+export { createCodemods } from './Codemods.js';
+export type { ErrorEmitter, ErrorEvent, ErrorSeverity } from './ErrorBoundary.js';
+export { ErrorBoundary } from './ErrorBoundary.js';
+export { didYouMean, findClosestMatches, levenshtein } from './errors/FuzzyMatcher.js';
+export { AtlasError, ContainerError, EventsError, ForgeError, PipelineError, RouterError, RuneError, WardenError, } from './errors/ModuleErrors.js';
+export type { PipelineStageName } from './errors/PipelineStageError.js';
+export { createPipelineError, PIPELINE_STAGES, validatePipelineConfig, } from './errors/PipelineStageError.js';
+export { ReamError } from './errors/ReamError.js';
+export type { ShutdownHandle, ShutdownOptions } from './GracefulShutdown.js';
+export { installGracefulShutdown } from './GracefulShutdown.js';
+export type { HealthChecker, HealthCheckResult, HealthStatus } from './HealthCheck.js';
+export { HealthCheck } from './HealthCheck.js';
+export type { HotReloadOptions } from './HotReload.js';
+export { startHotReload } from './HotReload.js';
+export type { AsyncOrSync, Constructor, Dict, ExtractFunctions, InferRouteParams, OneOrMore, Opaque, Prettify, UnwrapOpaque, } from './types/helpers.js';
+export { setApp } from './services/app.js';
+export { setRouter } from './services/router.js';
+export { setServer } from './services/server.js';
+export type { EventsConfig } from './events/config.js';
+export { defineConfig as defineEventsConfig } from './events/config.js';
+export { BaseEvent, type ContainerResolver, Emitter, type ListenerClass, } from './events/Emitter.js';
+export type { ErrorReporter, LockBackend, RunTaskOutcome, ScheduleEvent, ScheduleEventSink, ScheduleInvocation, ScheduleMetadata, ScheduleProviderOptions, SchedulerOptions, ScheduleTaskCompletedEvent, ScheduleTaskFailedEvent, ScheduleTaskSkippedEvent, ScheduleTaskStartedEvent, TaskInfo, TaskStats, } from './scheduler/index.js';
+export { getScheduleMetadata, MemoryLockBackend, SCHEDULE_METADATA_KEY, Schedule, ScheduleProvider, Scheduler, StatsTracker, } from './scheduler/index.js';
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,67 @@
+/**
+ * @module @c9up/ream
+ * @description Ream — Rust-powered Node.js application framework
+ * @implements FR11, FR12, FR13, FR14, FR16, FR17, FR18, FR19, FR20, FR21
+ */
+import 'reflect-metadata';
+// ─── Core ───────────────────────────────────────────────────
+export { Application } from './Application.js';
+export { defineModuleConfig, env, ConfigStore } from './ConfigLoader.js';
+export { Container } from './container/Container.js';
+// ─── HTTP (new — AdonisJS-compatible) ───────────────────────
+export { E_FORBIDDEN, E_HTTP_EXCEPTION, E_ROUTE_NOT_FOUND, E_ROW_NOT_FOUND, E_UNAUTHORIZED, E_VALIDATION_ERROR, Exception, ExceptionHandler, } from './http/Exception.js';
+export { HttpContext } from './http/HttpContext.js';
+export { RedirectBuilder } from './http/RedirectBuilder.js';
+export { Request } from './http/Request.js';
+export { Response } from './http/Response.js';
+// ─── Session ────────────────────────────────────────────────
+export { CookieDriver as SessionCookieDriver } from './session/drivers/CookieDriver.js';
+export { MemoryDriver as SessionMemoryDriver } from './session/drivers/MemoryDriver.js';
+export { Session } from './session/Session.js';
+export { default as SessionMiddleware } from './session/SessionMiddleware.js';
+export { default as BodyParserMiddleware } from './bodyparser/BodyParserMiddleware.js';
+export { MultipartFile } from './bodyparser/MultipartFile.js';
+export { RpcProvider } from './rpc/RpcProvider.js';
+export { RpcMethodBuilder, RpcRouter } from './rpc/RpcRouter.js';
+export { GraphQLEngine } from './graphql/GraphQLEngine.js';
+export { GraphQLProvider } from './graphql/GraphQLProvider.js';
+export { OpenApiGenerator } from './openapi/OpenApiGenerator.js';
+export { OpenApiMiddleware } from './openapi/OpenApiMiddleware.js';
+export { OpenApiProvider } from './openapi/OpenApiProvider.js';
+export { ApiResource } from './resources/ApiResource.js';
+export { StaticMiddleware } from './storage/StaticMiddleware.js';
+export { StaticProvider } from './storage/StaticProvider.js';
+// ─── Security ───────────────────────────────────────────────
+// Request-filter security (CSRF, XSS, rate-limit, CORS, headers, path/param)
+// lives in @c9up/blackhole. ream core keeps only the crypto primitives.
+export { CookieSigner } from './security/CookieSigner.js';
+export { setNapi, constantTimeEq, hasNativeCrypto, hmacSign, hmacVerify, randomBytesBase64, randomHex, } from './security/crypto.js';
+export { SignedUrl } from './security/SignedUrl.js';
+// ─── Decorators ─────────────────────────────────────────────
+export { createLazyProxy, getLazyParams, Lazy } from './decorators/Lazy.js';
+export { clearServiceRegistry, getServiceMetadata, getServiceRegistry, Inject, inject, Service, } from './decorators/Service.js';
+export { GroupBuilder, matchers, OnRouteBuilder, RouteBuilder, Router } from './router/Router.js';
+export { compose, MiddlewareRegistry } from './middleware/Pipeline.js';
+export { createHttpKernel } from './HttpKernel.js';
+export { resolveMiddlewareEntry, Server } from './server/Server.js';
+export { CommandRunner } from './console/CommandRunner.js';
+export { ConsoleKernel, defineConfig, Ignitor, prettyPrintError } from './Ignitor.js';
+export { Provider } from './Provider.js';
+export { createCodemods } from './Codemods.js';
+export { ErrorBoundary } from './ErrorBoundary.js';
+export { didYouMean, findClosestMatches, levenshtein } from './errors/FuzzyMatcher.js';
+export { AtlasError, ContainerError, EventsError, ForgeError, PipelineError, RouterError, RuneError, WardenError, } from './errors/ModuleErrors.js';
+export { createPipelineError, PIPELINE_STAGES, validatePipelineConfig, } from './errors/PipelineStageError.js';
+export { ReamError } from './errors/ReamError.js';
+export { installGracefulShutdown } from './GracefulShutdown.js';
+export { HealthCheck } from './HealthCheck.js';
+export { startHotReload } from './HotReload.js';
+// ─── Services ───────────────────────────────────────────────
+export { setApp } from './services/app.js';
+export { setRouter } from './services/router.js';
+export { setServer } from './services/server.js';
+export { defineConfig as defineEventsConfig } from './events/config.js';
+export { BaseEvent, Emitter, } from './events/Emitter.js';
+export { getScheduleMetadata, MemoryLockBackend, SCHEDULE_METADATA_KEY, Schedule, ScheduleProvider, Scheduler, StatsTracker, } from './scheduler/index.js';
+export const VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/middleware/Pipeline.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Unified Middleware Pipeline — typed for HttpContext.
+ *
+ * @implements FR22, FR27
+ *
+ * Pipeline order (fixed):
+ * 1. Global middleware
+ * 2. Route/handler named middleware
+ * 3. Route inline middleware
+ * 4. Guard (auth + roles + permissions)
+ * 5. Handler
+ */
+import type { HttpContext } from '../http/HttpContext.js';
+export type MiddlewareFunction = (ctx: HttpContext, next: () => Promise<void>) => Promise<void> | void;
+/** Named middleware registry. */
+export declare class MiddlewareRegistry {
+    #private;
+    /** Register a global middleware (runs on every request). */
+    use(middleware: MiddlewareFunction): void;
+    /** Register a named middleware. */
+    register(name: string, middleware: MiddlewareFunction): void;
+    /** Get a named middleware. */
+    get(name: string): MiddlewareFunction | undefined;
+    /** Get all global middleware. */
+    getGlobal(): MiddlewareFunction[];
+    /** Build the execution chain for a request. */
+    buildChain(namedMiddleware: string[], inlineMiddleware: MiddlewareFunction[], handler: MiddlewareFunction, options?: {
+        guards?: string[];
+        roles?: string[];
+        permissions?: string[];
+    }): MiddlewareFunction;
+}
+/** Compose middleware into a single handler (onion pattern). */
+declare function compose(middleware: MiddlewareFunction[]): MiddlewareFunction;
+export { compose };
+//# sourceMappingURL=Pipeline.d.ts.map

package/dist/middleware/Pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pipeline.d.ts","sourceRoot":"","sources":["../../src/middleware/Pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB,iCAAiC;AACjC,qBAAa,kBAAkB;;IAI7B,4DAA4D;IAC5D,GAAG,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAIzC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAI5D,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD,iCAAiC;IACjC,SAAS,IAAI,kBAAkB,EAAE;IAIjC,+CAA+C;IAC/C,UAAU,CACR,eAAe,EAAE,MAAM,EAAE,EACzB,gBAAgB,EAAE,kBAAkB,EAAE,EACtC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GACxE,kBAAkB;CAsBtB;AAED,gEAAgE;AAChE,iBAAS,OAAO,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAoBrE;AAqCD,OAAO,EAAE,OAAO,EAAE,CAAA"}

package/dist/middleware/Pipeline.js

@@ -0,0 +1,104 @@
+/**
+ * Unified Middleware Pipeline — typed for HttpContext.
+ *
+ * @implements FR22, FR27
+ *
+ * Pipeline order (fixed):
+ * 1. Global middleware
+ * 2. Route/handler named middleware
+ * 3. Route inline middleware
+ * 4. Guard (auth + roles + permissions)
+ * 5. Handler
+ */
+import { ReamError } from '../errors/ReamError.js';
+import { E_FORBIDDEN, E_UNAUTHORIZED } from '../http/Exception.js';
+/** Named middleware registry. */
+export class MiddlewareRegistry {
+    #global = [];
+    #named = new Map();
+    /** Register a global middleware (runs on every request). */
+    use(middleware) {
+        this.#global.push(middleware);
+    }
+    /** Register a named middleware. */
+    register(name, middleware) {
+        this.#named.set(name, middleware);
+    }
+    /** Get a named middleware. */
+    get(name) {
+        return this.#named.get(name);
+    }
+    /** Get all global middleware. */
+    getGlobal() {
+        return [...this.#global];
+    }
+    /** Build the execution chain for a request. */
+    buildChain(namedMiddleware, inlineMiddleware, handler, options) {
+        const stack = [
+            // 1. Global middleware
+            ...this.#global,
+            // 2. Named middleware
+            ...namedMiddleware
+                .map((name) => this.#named.get(name))
+                .filter((mw) => mw !== undefined),
+            // 3. Inline middleware
+            ...inlineMiddleware,
+            // 4. Guard enforcement (throws exceptions instead of setting response)
+            ...((options?.guards?.length ?? 0) > 0 ||
+                (options?.roles?.length ?? 0) > 0 ||
+                (options?.permissions?.length ?? 0) > 0
+                ? [createGuardMiddleware(options?.guards ?? [], options?.roles, options?.permissions)]
+                : []),
+            // 5. Handler
+            handler,
+        ];
+        return compose(stack);
+    }
+}
+/** Compose middleware into a single handler (onion pattern). */
+function compose(middleware) {
+    return async (ctx, finalNext) => {
+        let index = -1;
+        async function dispatch(i) {
+            if (i <= index) {
+                throw new ReamError('PIPELINE_DOUBLE_NEXT', 'next() called multiple times', {
+                    hint: 'A middleware called next() more than once. Each middleware should call next() at most once.',
+                });
+            }
+            index = i;
+            const fn = i < middleware.length ? middleware[i] : finalNext;
+            if (!fn)
+                return;
+            await fn(ctx, () => dispatch(i + 1));
+        }
+        await dispatch(0);
+    };
+}
+/**
+ * Guard enforcement middleware.
+ * Throws E_UNAUTHORIZED / E_FORBIDDEN exceptions (caught by ExceptionHandler).
+ */
+function createGuardMiddleware(guards, roles, permissions) {
+    return async (ctx, next) => {
+        const needsAuth = guards.length > 0 || (roles && roles.length > 0) || (permissions && permissions.length > 0);
+        if (needsAuth && !ctx.auth.authenticated) {
+            throw new E_UNAUTHORIZED();
+        }
+        if (roles && roles.length > 0) {
+            const userRoles = ctx.auth.roles ?? [];
+            const hasAnyRole = roles.some((r) => userRoles.includes(r));
+            if (!hasAnyRole) {
+                throw new E_FORBIDDEN('Insufficient role', roles);
+            }
+        }
+        if (permissions && permissions.length > 0) {
+            const userPerms = ctx.auth.permissions ?? [];
+            if (!permissions.every((p) => userPerms.includes(p))) {
+                throw new E_FORBIDDEN('Insufficient permissions', permissions);
+            }
+        }
+        await next();
+    };
+}
+export { compose };
+//# sourceMappingURL=Pipeline.js.map

package/dist/middleware/Pipeline.js.map

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

package/dist/openapi/OpenApiGenerator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * OpenApiGenerator — auto-generates OpenAPI 3.1 spec from registered routes and Rune schemas.
+ *
+ * Zero manual spec writing. Routes, validators, guards, and versions are introspected at boot.
+ *
+ * Usage:
+ *   const spec = new OpenApiGenerator(router, { title: 'My API', version: '1.0.0' }).generate()
+ *
+ * @implements MISS-22
+ */
+import type { Router } from '../router/Router.js';
+export interface OpenApiConfig {
+    title: string;
+    version: string;
+    description?: string;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    contact?: {
+        name?: string;
+        email?: string;
+        url?: string;
+    };
+    license?: {
+        name: string;
+        url?: string;
+    };
+}
+type OpenApiSpec = {
+    openapi: string;
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+        contact?: Record<string, string>;
+        license?: Record<string, string>;
+    };
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    paths: Record<string, Record<string, unknown>>;
+    components: {
+        securitySchemes: Record<string, unknown>;
+        schemas: Record<string, unknown>;
+    };
+};
+export declare class OpenApiGenerator {
+    #private;
+    constructor(router: Router, config: OpenApiConfig, runeSchemas?: Map<string, Record<string, unknown>>);
+    /** Register a Rune validation schema for OpenAPI spec generation. */
+    registerSchema(name: string, definition: Record<string, unknown>): void;
+    /** Generate the complete OpenAPI 3.1 spec. */
+    generate(): OpenApiSpec;
+}
+export {};
+//# sourceMappingURL=OpenApiGenerator.d.ts.map

package/dist/openapi/OpenApiGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenApiGenerator.d.ts","sourceRoot":"","sources":["../../src/openapi/OpenApiGenerator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAmB,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAElE,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtD,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACzD,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACzC;AAMD,KAAK,WAAW,GAAG;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,CAAA;QACf,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACjC,CAAA;IACD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC9C,UAAU,EAAE;QACV,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACjC,CAAA;CACF,CAAA;AAaD,qBAAa,gBAAgB;;gBAMzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAOpD,qEAAqE;IACrE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIvE,8CAA8C;IAC9C,QAAQ,IAAI,WAAW;CAkLxB"}

package/dist/openapi/OpenApiGenerator.js

@@ -0,0 +1,192 @@
+/**
+ * OpenApiGenerator — auto-generates OpenAPI 3.1 spec from registered routes and Rune schemas.
+ *
+ * Zero manual spec writing. Routes, validators, guards, and versions are introspected at boot.
+ *
+ * Usage:
+ *   const spec = new OpenApiGenerator(router, { title: 'My API', version: '1.0.0' }).generate()
+ *
+ * @implements MISS-22
+ */
+/** Map a guard name to its OpenAPI security-scheme object. */
+function buildSecurityScheme(guard) {
+    if (guard === 'jwt') {
+        return { type: 'http', scheme: 'bearer', bearerFormat: 'JWT' };
+    }
+    if (guard === 'api-key' || guard === 'apikey') {
+        return { type: 'apiKey', in: 'header', name: 'X-API-Key' };
+    }
+    return { type: 'http', scheme: 'bearer' };
+}
+export class OpenApiGenerator {
+    #router;
+    #config;
+    #runeSchemas;
+    constructor(router, config, runeSchemas) {
+        this.#router = router;
+        this.#config = config;
+        this.#runeSchemas = runeSchemas ?? new Map();
+    }
+    /** Register a Rune validation schema for OpenAPI spec generation. */
+    registerSchema(name, definition) {
+        this.#runeSchemas.set(name, definition);
+    }
+    /** Generate the complete OpenAPI 3.1 spec. */
+    generate() {
+        const spec = {
+            openapi: '3.1.0',
+            info: {
+                title: this.#config.title,
+                version: this.#config.version,
+                ...(this.#config.description ? { description: this.#config.description } : {}),
+                ...(this.#config.contact ? { contact: this.#config.contact } : {}),
+                ...(this.#config.license ? { license: this.#config.license } : {}),
+            },
+            ...(this.#config.servers ? { servers: this.#config.servers } : {}),
+            paths: {},
+            components: {
+                securitySchemes: {},
+                schemas: {},
+            },
+        };
+        // Build paths from router
+        const routes = this.#getRoutes();
+        const securitySchemesUsed = new Set();
+        for (const route of routes) {
+            const method = route.method.toLowerCase();
+            if (method === '*')
+                continue; // skip wildcard routes
+            const path = this.#convertPath(route.path);
+            if (!spec.paths[path])
+                spec.paths[path] = {};
+            spec.paths[path][method] = this.#buildOperation(route, method, path, securitySchemesUsed, spec.components.schemas);
+        }
+        // Security schemes
+        for (const guard of securitySchemesUsed) {
+            spec.components.securitySchemes[guard] = buildSecurityScheme(guard);
+        }
+        return spec;
+    }
+    /**
+     * Build the OpenAPI operation object for one route. Records any guard names in
+     * `securitySchemesUsed` and registers validator request-body schemas into the
+     * shared `schemas` component map.
+     */
+    #buildOperation(route, method, path, securitySchemesUsed, schemas) {
+        const operation = {
+            summary: this.#generateSummary(route),
+            responses: {
+                '200': { description: 'Success' },
+                ...(route.guards.length > 0 ? { '401': { description: 'Unauthorized' } } : {}),
+                ...(route.roles.length > 0 || route.permissions.length > 0
+                    ? { '403': { description: 'Forbidden' } }
+                    : {}),
+            },
+        };
+        // Tags from path prefix
+        const tag = path.split('/').filter(Boolean)[1]; // e.g., /api/v1/tasks → "v1"
+        if (tag)
+            operation.tags = [tag];
+        if (route.version)
+            operation['x-api-version'] = route.version;
+        if (route.deprecates) {
+            operation.deprecated = true;
+            operation['x-sunset'] = route.deprecates.sunset;
+        }
+        const params = this.#extractPathParams(route.path);
+        if (params.length > 0) {
+            operation.parameters = params.map((p) => ({
+                name: p,
+                in: 'path',
+                required: true,
+                schema: { type: 'string' },
+            }));
+        }
+        if (route.guards.length > 0) {
+            operation.security = route.guards.map((g) => ({ [g]: [] }));
+            for (const g of route.guards)
+                securitySchemesUsed.add(g);
+        }
+        if (route.validators.length > 0 && ['post', 'put', 'patch'].includes(method)) {
+            const validatorName = route.validators[0];
+            const schema = this.#runeSchemas.get(validatorName);
+            if (schema) {
+                operation.requestBody = {
+                    required: true,
+                    content: { 'application/json': { schema: this.#runeToJsonSchema(schema) } },
+                };
+                schemas[validatorName] = this.#runeToJsonSchema(schema);
+            }
+            else {
+                operation.requestBody = {
+                    required: true,
+                    content: { 'application/json': { schema: { type: 'object' } } },
+                };
+            }
+        }
+        return operation;
+    }
+    /** Convert Express-style path params to OpenAPI format. */
+    #convertPath(path) {
+        return path.replace(/:(\w+)\??/g, '{$1}');
+    }
+    /** Extract parameter names from path. */
+    #extractPathParams(path) {
+        const matches = path.matchAll(/:(\w+)\??/g);
+        return [...matches].map((m) => m[1]);
+    }
+    /** Generate a summary from route metadata. */
+    #generateSummary(route) {
+        if (route.controller) {
+            return `${route.controller.target.name}.${route.controller.method}`;
+        }
+        if (route.name)
+            return route.name;
+        return `${route.method} ${route.path}`;
+    }
+    /** Convert a Rune schema (Record<string, RuleChain>) to JSON Schema. */
+    #runeToJsonSchema(schema) {
+        const properties = {};
+        const required = [];
+        for (const [field, chainRaw] of Object.entries(schema)) {
+            const chain = chainRaw;
+            let type = 'string';
+            const constraints = {};
+            for (const rule of chain.rules ?? []) {
+                if (rule.name === 'string')
+                    type = 'string';
+                else if (rule.name === 'number')
+                    type = 'number';
+                else if (rule.name === 'boolean')
+                    type = 'boolean';
+                else if (rule.name === 'email')
+                    constraints.format = 'email';
+                else if (rule.name === 'min' && rule.param !== undefined) {
+                    if (type === 'string')
+                        constraints.minLength = rule.param;
+                    else
+                        constraints.minimum = rule.param;
+                }
+                else if (rule.name === 'max' && rule.param !== undefined) {
+                    if (type === 'string')
+                        constraints.maxLength = rule.param;
+                    else
+                        constraints.maximum = rule.param;
+                }
+            }
+            properties[field] = { type, ...constraints };
+            if (!chain.isOptionalField)
+                required.push(field);
+        }
+        return {
+            type: 'object',
+            properties,
+            ...(required.length > 0 ? { required } : {}),
+        };
+    }
+    /** Get all routes from the router via public API. */
+    #getRoutes() {
+        return this.#router.getRoutes();
+    }
+}
+//# sourceMappingURL=OpenApiGenerator.js.map

package/dist/openapi/OpenApiGenerator.js.map

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