@c9up/ream 0.1.3

package/dist/HttpKernel.js

@@ -0,0 +1,210 @@
+/**
+ * HttpKernel — bridges HyperServer NAPI with Router + Middleware Pipeline + ExceptionHandler.
+ *
+ * Request flow (like AdonisJS):
+ * 1. Parse JSON from Rust NAPI
+ * 2. Create HttpContext
+ * 3. Onion pipeline: Server MW → Router MW → Route MW → Guards → Handler
+ * 4. ExceptionHandler for any errors
+ *
+ * @implements FR21, FR22, FR23, FR24
+ */
+import { E_ROUTE_NOT_FOUND, ExceptionHandler } from './http/Exception.js';
+import { HttpContext } from './http/HttpContext.js';
+import { compose } from './middleware/Pipeline.js';
+export function createHttpKernel(config) {
+    // Debug mode requires explicit opt-in — never leak stack traces by default
+    const handler = config.exceptionHandler ?? new ExceptionHandler(config.debug === true);
+    const serverMw = config.serverMiddleware ?? [];
+    const routerMw = config.routerMiddleware ?? [];
+    // Pipeline cache: compiled middleware chain per route key (PERF-7)
+    // Cleared when router.clear() is called (hot-reload).
+    const pipelineCache = new Map();
+    // Hook into router clear for cache invalidation
+    const origClear = config.router.clear.bind(config.router);
+    config.router.clear = () => {
+        origClear();
+        pipelineCache.clear();
+    };
+    // Resolve the events emitter once, only when the app registered
+    // `EventsProvider`. Lazy + cached: the binding may not exist yet at kernel
+    // creation, and `has()` avoids loading the native bus for apps without events.
+    let eventsEmitter;
+    let eventsResolved = false;
+    const resolveEvents = () => {
+        if (!eventsResolved) {
+            eventsResolved = true;
+            if (config.container?.has('events')) {
+                eventsEmitter = config.container.resolve('events');
+            }
+        }
+        return eventsEmitter;
+    };
+    return async (reqData) => {
+        // The Rust HyperServer hands the request as a typed JS object via napi
+        // `to_js_value` (no JSON intermediate). Serverless adapters that pass a
+        // JSON string must `JSON.parse` themselves before invoking the kernel.
+        // 2. Correlation ID
+        const CORR_ID_RE = /^[A-Za-z0-9\-_]{8,128}$/;
+        const rawCorrId = reqData.headers['x-request-id'] ?? reqData.headers['x-correlation-id'] ?? '';
+        const correlationId = CORR_ID_RE.test(rawCorrId) ? rawCorrId : crypto.randomUUID();
+        // 3. Match route (pass host for domain-based routing).
+        // The Rust HyperServer lowercases every header name before handing
+        // the request over (see crates/ream-http/src/request.rs — `headers`
+        // is documented "lowercased"). Looking up `host` is therefore the
+        // only correct key; the previous PascalCase fallback was dead code.
+        const host = reqData.headers.host;
+        const match = config.router.match(reqData.method, reqData.path, host);
+        const routeInfo = match
+            ? {
+                pattern: match.route.path,
+                name: match.route.name,
+                middleware: match.route.middleware,
+                // Forward the controller class + method name onto the public
+                // RouteInfo so middleware (Warden's @Guard, Photon's @Meta) can
+                // read decorator metadata via Reflect. Absent for inline-arrow
+                // route handlers — that's intentional, decorators only apply
+                // to controller methods.
+                controller: match.route.controller?.target.prototype,
+                action: match.route.controller?.method,
+            }
+            : { pattern: '', middleware: [] };
+        // 4. Create HttpContext
+        const ctx = new HttpContext(correlationId, reqData, match?.params ?? {}, routeInfo);
+        ctx.setRouteUrlResolver((name, params) => config.router.makeUrl(name, params));
+        ctx.events = resolveEvents();
+        // Wire the streaming backend so `ctx.response.sse()` can talk to
+        // the HyperServer NAPI. Falls back silently when no backend is
+        // available (mock server, websocket-only host) — the SSE helper
+        // throws a clean error in that case.
+        const backend = config.streamBackend?.();
+        if (backend) {
+            ctx.response.setStreamBackend(backend);
+        }
+        try {
+            // 5. Build the FULL onion pipeline:
+            //    Server MW → [route match check] → Router MW → Route named MW → Route inline MW → Guards → Handler
+            const coreHandler = async (innerCtx) => {
+                if (!match) {
+                    throw new E_ROUTE_NOT_FOUND(reqData.method, reqData.path);
+                }
+                // Cache key: method + path pattern (static per route definition)
+                const cacheKey = `${match.route.method}:${match.route.path}`;
+                let cached = pipelineCache.get(cacheKey);
+                if (!cached) {
+                    // Resolve handler (once per route)
+                    let routeHandler;
+                    if (match.route.controller) {
+                        routeHandler = createControllerHandler(match.route.controller, config.container);
+                    }
+                    else if (match.route.handler) {
+                        routeHandler = match.route.handler;
+                    }
+                    else {
+                        throw new Error(`Route ${match.route.method} ${match.route.path} has neither controller nor handler`);
+                    }
+                    // Merge route-level guards with controller method decorator metadata (once)
+                    let guards = [...match.route.guards];
+                    let roles = [...match.route.roles];
+                    let permissions = [...match.route.permissions];
+                    if (match.route.controller) {
+                        const meta = readControllerGuardMetadata(match.route.controller.target, match.route.controller.method);
+                        guards = [...guards, ...meta.guards];
+                        roles = [...roles, ...meta.roles];
+                        permissions = [...permissions, ...meta.permissions];
+                    }
+                    // Compile pipeline once
+                    const chain = config.middleware.buildChain(match.route.middleware, [...routerMw, ...match.route.inlineMiddleware], async (c) => {
+                        await routeHandler(c);
+                    }, { guards, roles, permissions });
+                    cached = { chain };
+                    pipelineCache.set(cacheKey, cached);
+                }
+                // API versioning headers (per-request, cheap)
+                if (match.route.version) {
+                    innerCtx.response.header('x-api-version', match.route.version);
+                }
+                if (match.route.deprecates) {
+                    innerCtx.response.header('deprecation', 'true');
+                    innerCtx.response.header('x-deprecated-version', match.route.deprecates.version);
+                    if (match.route.deprecates.sunset) {
+                        innerCtx.response.header('sunset', match.route.deprecates.sunset);
+                    }
+                }
+                await cached.chain(innerCtx, async () => { });
+            };
+            // Compose: server middleware wraps everything (onion)
+            const fullPipeline = compose([...serverMw, coreHandler]);
+            await fullPipeline(ctx, async () => { });
+            return serializeResponse(ctx);
+        }
+        catch (error) {
+            // If the handler opened an SSE stream via `response.sse()` and
+            // THEN threw, the reserved stream id is still on the response.
+            // Tear it down before building the error response — otherwise
+            // serializeResponse emits `streamId` next to an error body and
+            // the HyperServer keeps feeding a dead stream slot forever.
+            await ctx.response.abortStream();
+            try {
+                await handler.handle(error, ctx);
+                await handler.report(error, ctx);
+            }
+            catch (handlerError) {
+                console.error('ExceptionHandler failed:', handlerError);
+                ctx.response
+                    .status(500)
+                    .json({ error: { code: 'E_HANDLER_FAILURE', message: 'An internal error occurred' } });
+            }
+            if (config.onError) {
+                config.onError(error, ctx);
+            }
+            // Core domain event: a request raised an exception. Fire-and-forget
+            // through the bus when events are wired (error path only — zero cost on
+            // the happy path). Emitter isolates listener failures from the response.
+            ctx.events?.emit('exception', {
+                id: ctx.id,
+                method: reqData.method,
+                path: reqData.path,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return serializeResponse(ctx);
+        }
+    };
+}
+function createControllerHandler(
+// biome-ignore lint/suspicious/noExplicitAny: see ControllerAction type — IoC resolves constructor params
+controller, container) {
+    return async (ctx) => {
+        const instance = container ? container.make(controller.target) : new controller.target();
+        const method = instance[controller.method];
+        if (typeof method !== 'function') {
+            throw new Error(`Controller method '${controller.method}' not found on ${controller.target.name}`);
+        }
+        await method.call(instance, ctx);
+    };
+}
+/**
+ * Read @Guard, @Role, @Permission metadata from a controller method.
+ * Returns empty arrays if no decorators are present.
+ */
+function readControllerGuardMetadata(target, method) {
+    try {
+        const guards = Reflect.getMetadata(Symbol.for('warden:guard'), target.prototype, method) ?? [];
+        const roles = Reflect.getMetadata(Symbol.for('warden:role'), target.prototype, method) ?? [];
+        const permissions = Reflect.getMetadata(Symbol.for('warden:permission'), target.prototype, method) ?? [];
+        return { guards, roles, permissions };
+    }
+    catch {
+        return { guards: [], roles: [], permissions: [] };
+    }
+}
+function serializeResponse(ctx) {
+    const streamId = ctx.response.getStreamId();
+    return {
+        status: ctx.response.getStatus(),
+        headers: ctx.response.getHeaders(),
+        body: ctx.response.getBody(),
+        ...(streamId !== undefined ? { streamId } : {}),
+    };
+}
+//# sourceMappingURL=HttpKernel.js.map

package/dist/HttpKernel.js.map

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

package/dist/Ignitor.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Ignitor — AdonisJS-compatible application bootstrap.
+ *
+ * Usage (like AdonisJS):
+ *   new Ignitor(APP_ROOT, { importer: IMPORTER })
+ *     .tap((app) => {
+ *       app.booting(async () => { await import('#start/env') })
+ *       app.listen('SIGTERM', () => app.terminate())
+ *     })
+ *     .httpServer()
+ *     .start()
+ *
+ * @implements FR17, FR20, FR23
+ */
+import { Application } from './Application.js';
+import type { ErrorEvent } from './ErrorBoundary.js';
+import type { HttpKernelRequest, HttpKernelResponse } from './HttpKernel.js';
+import type { MiddlewareFunction } from './middleware/Pipeline.js';
+import type { AppContext, ProviderContract } from './Provider.js';
+import { Router } from './router/Router.js';
+import { Server } from './server/Server.js';
+/** Application environment. */
+export type AppEnvironment = 'web' | 'console' | 'test' | 'unknown';
+/**
+ * Reamrc config — like AdonisJS adonisrc.ts with defineConfig().
+ */
+export interface ReamrcConfig {
+    providers?: Array<(() => Promise<{
+        default: new (app: AppContext) => ProviderContract;
+    }>) | {
+        file: () => Promise<{
+            default: new (app: AppContext) => ProviderContract;
+        }>;
+        environment?: string[];
+    }>;
+    preloads?: Array<(() => Promise<unknown>) | {
+        file: () => Promise<unknown>;
+        environment?: string[];
+    }>;
+    commands?: Array<() => Promise<unknown>>;
+    modules?: {
+        /** Path to the modules directory (relative to app root). Default: './app/modules' */
+        path?: string;
+        /** Auto-loaded files in each module directory. Default: ['routes'] */
+        autoload?: string[];
+    };
+    tests?: {
+        suites?: Array<{
+            name: string;
+            files: string[];
+            timeout?: number;
+        }>;
+        forceExit?: boolean;
+    };
+}
+/** defineConfig helper — like AdonisJS defineConfig(). */
+export declare function defineConfig(config: ReamrcConfig): ReamrcConfig;
+/** Minimal interface for the HTTP server (NAPI or mock). */
+export interface HyperServerLike {
+    onRequest(callback: (request: HttpKernelRequest) => Promise<HttpKernelResponse>): void;
+    /**
+     * Optional — present on the real `HyperServer` (Rust-backed), absent on
+     * trivial test mocks. Ignitor only calls it when a shield config is set.
+     */
+    configureShield?(config: {
+        pathTraversal: boolean;
+        paramPollution: boolean;
+    }): void;
+    /** Optional — same lifecycle as `configureShield`. */
+    configureTrustedProxies?(cidrs: string[]): void;
+    /** Optional — same lifecycle as `configureShield`. */
+    configureRateLimit?(config: {
+        max: number;
+        windowSecs: number;
+    } | null): void;
+    listen(): Promise<void>;
+    port(): Promise<number>;
+    close(): Promise<void>;
+    registerStream?(streamId: string): Promise<boolean>;
+    writeStream?(streamId: string, chunk: string): Promise<boolean>;
+    closeStream?(streamId: string): Promise<boolean>;
+    onStreamDisconnect?(streamId: string, callback: () => void): void;
+}
+export interface IgnitorConfig {
+    port?: number;
+    serverFactory?: (port: number) => HyperServerLike;
+    importer?: (filePath: string) => Promise<unknown>;
+    watchDirs?: string[];
+}
+/**
+ * Ignitor — boots and wires the Ream framework.
+ *
+ * Lifecycle: register → boot → start → ready → shutdown
+ */
+export declare class Ignitor {
+    private app;
+    private router;
+    private server;
+    private middleware;
+    private errorBoundary;
+    private _httpServer?;
+    private config;
+    private appRoot?;
+    private environment;
+    private reamrc?;
+    private providers;
+    private errorListeners;
+    private phase;
+    private hotReloadCleanup?;
+    private inlineRoutes?;
+    private inlineMiddleware;
+    private inlineNamedMiddleware;
+    private inlineProviderFactories;
+    /**
+     * Create the Ignitor.
+     *
+     * AdonisJS-style:
+     *   new Ignitor(APP_ROOT, { importer: IMPORTER })
+     *
+     * Simple-style:
+     *   new Ignitor({ port: 3000, serverFactory: ... })
+     */
+    constructor(appRootOrConfig?: URL | IgnitorConfig, config?: IgnitorConfig);
+    /**
+     * Access the Application instance before start.
+     * Like AdonisJS: .tap((app) => { app.booting(...) })
+     */
+    tap(callback: (app: Application) => void): this;
+    /** Set the application environment. */
+    setEnvironment(env: AppEnvironment): this;
+    getEnvironment(): AppEnvironment;
+    /**
+     * Load the reamrc config (equivalent to adonisrc.ts).
+     */
+    useRcFile(reamrc: ReamrcConfig): this;
+    /** Define routes inline (simple mode). */
+    routes(callback: (router: Router) => void): this;
+    /** Add global middleware inline. */
+    use(mw: MiddlewareFunction): this;
+    /** Register a named middleware inline. */
+    named(name: string, mw: MiddlewareFunction): this;
+    /** Register a provider inline (for testing or simple apps). */
+    provider(factory: (app: Application) => ProviderContract): this;
+    /** Listen for error events. */
+    onError(listener: (event: ErrorEvent) => void): this;
+    /** Set a config value. */
+    configure(key: string, value: unknown): this;
+    /** Configure for HTTP server mode. */
+    httpServer(): this;
+    /** Configure for CLI/console mode. Returns a ConsoleKernel for dispatching commands. */
+    console(): ConsoleKernel;
+    /** Configure for test mode. */
+    testMode(): this;
+    start(): Promise<Ignitor>;
+    private phaseRegister;
+    private phaseBoot;
+    private phaseStart;
+    private phaseReady;
+    /**
+     * Auto-load config/*.ts files into app.config store.
+     * Each file's default export is stored under its filename (without extension).
+     * e.g. config/database.ts → app.config.get('database')
+     */
+    private autoloadConfig;
+    /**
+     * Auto-load module files (routes.ts, etc.) from the modules directory.
+     * Scans modules.path for subdirectories and imports matching files.
+     */
+    private autoloadModules;
+    /** Graceful shutdown. */
+    stop(): Promise<void>;
+    port(): Promise<number>;
+    getApp(): Application;
+    getRouter(): Router;
+    getServer(): Server;
+    /** Get the kernel callback (for serverless / testing). */
+    getKernel(): (request: HttpKernelRequest) => Promise<HttpKernelResponse>;
+    isDevMode(): boolean;
+    getPhase(): string;
+    private handleError;
+}
+/**
+ * Pretty-print an error (like AdonisJS prettyPrintError).
+ */
+export declare function prettyPrintError(error: unknown): void;
+/**
+ * ConsoleKernel — handles CLI command dispatching.
+ * Like AdonisJS: new Ignitor(...).console().handle(process.argv.splice(2))
+ */
+export declare class ConsoleKernel {
+    private ignitor;
+    constructor(ignitor: Ignitor);
+    handle(argv: string[]): Promise<void>;
+}
+//# sourceMappingURL=Ignitor.d.ts.map

package/dist/Ignitor.d.ts.map

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