@c9up/ream 0.1.3

package/dist/Ignitor.js

@@ -0,0 +1,505 @@
+/**
+ * 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 { ErrorBoundary } from './ErrorBoundary.js';
+import { ReamError } from './errors/ReamError.js';
+import { startHotReload } from './HotReload.js';
+import { createHttpKernel } from './HttpKernel.js';
+import { ExceptionHandler } from './http/Exception.js';
+import { MiddlewareRegistry } from './middleware/Pipeline.js';
+import { callProviderPhase } from './Provider.js';
+import { Router } from './router/Router.js';
+import { Server } from './server/Server.js';
+import { setApp } from './services/app.js';
+import { setRouter } from './services/router.js';
+import { setServer } from './services/server.js';
+/** defineConfig helper — like AdonisJS defineConfig(). */
+export function defineConfig(config) {
+    return config;
+}
+/**
+ * Ignitor — boots and wires the Ream framework.
+ *
+ * Lifecycle: register → boot → start → ready → shutdown
+ */
+export class Ignitor {
+    app;
+    router;
+    server;
+    middleware;
+    errorBoundary;
+    _httpServer;
+    config;
+    appRoot;
+    environment = 'unknown';
+    reamrc;
+    providers = [];
+    errorListeners = [];
+    phase = 'created';
+    hotReloadCleanup;
+    // Inline configuration (for simple use or testing)
+    inlineRoutes;
+    inlineMiddleware = [];
+    inlineNamedMiddleware = [];
+    inlineProviderFactories = [];
+    /**
+     * Create the Ignitor.
+     *
+     * AdonisJS-style:
+     *   new Ignitor(APP_ROOT, { importer: IMPORTER })
+     *
+     * Simple-style:
+     *   new Ignitor({ port: 3000, serverFactory: ... })
+     */
+    constructor(appRootOrConfig, config) {
+        if (appRootOrConfig instanceof URL) {
+            this.appRoot = appRootOrConfig;
+            this.config = config ?? {};
+        }
+        else {
+            this.config = appRootOrConfig ?? {};
+        }
+        this.app = new Application();
+        this.router = new Router();
+        this.server = new Server(this.router);
+        this.middleware = new MiddlewareRegistry();
+        this.errorBoundary = new ErrorBoundary((event) => this.handleError(event), this.isDevMode());
+        // Register framework services in container
+        this.app.container.singleton('router', () => this.router);
+        this.app.container.singleton('server', () => this.server);
+        this.app.container.singleton('middleware', () => this.middleware);
+        this.app.container.singleton('app', () => this.app);
+        // `appRoot` is the URL passed to `new Ignitor(new URL('../', import.meta.url))`.
+        // Providers resolve it through the container so they can interpret
+        // relative paths in config files (e.g. `pages.root: './resources/pages'`)
+        // against the project root — same convention `modules.path` uses.
+        if (this.appRoot) {
+            const root = this.appRoot;
+            this.app.container.singleton('appRoot', () => root);
+        }
+        // Set service singletons so route/kernel files can import them
+        setApp(this.app);
+        setRouter(this.router);
+        setServer(this.server);
+    }
+    // ─── Configuration ────────────────────────────────────────
+    /**
+     * Access the Application instance before start.
+     * Like AdonisJS: .tap((app) => { app.booting(...) })
+     */
+    tap(callback) {
+        callback(this.app);
+        return this;
+    }
+    /** Set the application environment. */
+    setEnvironment(env) {
+        this.environment = env;
+        return this;
+    }
+    getEnvironment() {
+        return this.environment;
+    }
+    /**
+     * Load the reamrc config (equivalent to adonisrc.ts).
+     */
+    useRcFile(reamrc) {
+        this.reamrc = reamrc;
+        return this;
+    }
+    // === Inline configuration (simple mode / testing) ===
+    /** Define routes inline (simple mode). */
+    routes(callback) {
+        this.inlineRoutes = callback;
+        return this;
+    }
+    /** Add global middleware inline. */
+    use(mw) {
+        this.inlineMiddleware.push(mw);
+        return this;
+    }
+    /** Register a named middleware inline. */
+    named(name, mw) {
+        this.inlineNamedMiddleware.push([name, mw]);
+        return this;
+    }
+    /** Register a provider inline (for testing or simple apps). */
+    provider(factory) {
+        this.inlineProviderFactories.push(factory);
+        return this;
+    }
+    /** Listen for error events. */
+    onError(listener) {
+        this.errorListeners.push(listener);
+        return this;
+    }
+    /** Set a config value. */
+    configure(key, value) {
+        this.app.config.set(key, value);
+        return this;
+    }
+    // ─── Mode selection ───────────────────────────────────────
+    /** Configure for HTTP server mode. */
+    httpServer() {
+        this.environment = 'web';
+        return this;
+    }
+    /** Configure for CLI/console mode. Returns a ConsoleKernel for dispatching commands. */
+    console() {
+        this.environment = 'console';
+        return new ConsoleKernel(this);
+    }
+    /** Configure for test mode. */
+    testMode() {
+        this.environment = 'test';
+        return this;
+    }
+    // ─── Lifecycle ────────────────────────────────────────────
+    async start() {
+        await this.phaseRegister();
+        await this.phaseBoot();
+        await this.phaseStart();
+        await this.phaseReady();
+        return this;
+    }
+    async phaseRegister() {
+        // Auto-load config/*.ts files into app.config
+        await this.autoloadConfig();
+        // Load providers from reamrc
+        if (this.reamrc?.providers) {
+            for (const providerEntry of this.reamrc.providers) {
+                const providerImport = typeof providerEntry === 'function' ? providerEntry : providerEntry.file;
+                const env = typeof providerEntry === 'function' ? undefined : providerEntry.environment;
+                // Skip providers not matching current environment
+                if (env && !env.includes(this.environment))
+                    continue;
+                const mod = await providerImport();
+                const ProviderClass = mod.default;
+                const instance = new ProviderClass(this.app);
+                this.providers.push(instance);
+                this.app.register(instance);
+            }
+        }
+        // Register inline providers
+        for (const factory of this.inlineProviderFactories) {
+            const instance = factory(this.app);
+            this.providers.push(instance);
+            this.app.register(instance);
+        }
+        this.phase = 'registered';
+    }
+    async phaseBoot() {
+        await this.app.boot();
+        this.phase = 'booted';
+    }
+    async phaseStart() {
+        // Import preload files (routes.ts, kernel.ts, etc.)
+        if (this.reamrc?.preloads) {
+            for (const preloadEntry of this.reamrc.preloads) {
+                const preloadImport = typeof preloadEntry === 'function' ? preloadEntry : preloadEntry.file;
+                const env = typeof preloadEntry === 'function'
+                    ? undefined
+                    : preloadEntry.environment;
+                if (env && !env.includes(this.environment))
+                    continue;
+                await preloadImport();
+            }
+        }
+        // Auto-load module files (routes.ts, etc.) from modules directory
+        await this.autoloadModules();
+        // Apply inline configuration
+        for (const mw of this.inlineMiddleware) {
+            this.middleware.use(mw);
+        }
+        for (const [name, mw] of this.inlineNamedMiddleware) {
+            this.middleware.register(name, mw);
+        }
+        if (this.inlineRoutes) {
+            this.inlineRoutes(this.router);
+        }
+        // Call start() on providers
+        for (const provider of this.providers) {
+            await callProviderPhase(provider, 'start');
+        }
+        this.phase = 'started';
+    }
+    async phaseReady() {
+        // Boot the Server (resolves lazy error handler etc.)
+        await this.server.boot();
+        // Start HTTP server if in web mode
+        if (this.environment === 'web' && this.config.serverFactory) {
+            // Build the HttpKernel with server middleware + router middleware.
+            // The streaming backend is resolved lazily — the HyperServer is
+            // created a few lines down, after the kernel — so the kernel
+            // closes over the `this._httpServer` slot and reads it on every
+            // request through the factory.
+            const kernel = createHttpKernel({
+                router: this.router,
+                middleware: this.middleware,
+                container: this.app.container,
+                exceptionHandler: this.server.getErrorHandler() ?? new ExceptionHandler(!this.app.inProduction),
+                serverMiddleware: this.server.getServerMiddleware(),
+                routerMiddleware: this.router.getRouterMiddleware(),
+                onError: (error, ctx) => {
+                    this.errorBoundary.serviceError('HttpKernel', error, ctx.id);
+                },
+                streamBackend: () => {
+                    const server = this._httpServer;
+                    if (server &&
+                        typeof server.registerStream === 'function' &&
+                        typeof server.writeStream === 'function' &&
+                        typeof server.closeStream === 'function' &&
+                        typeof server.onStreamDisconnect === 'function') {
+                        // Narrow to a backend-shaped record. All four methods are
+                        // present at this point — the check above guards mocked
+                        // servers without forcing a structural cast.
+                        return {
+                            registerStream: server.registerStream.bind(server),
+                            writeStream: server.writeStream.bind(server),
+                            closeStream: server.closeStream.bind(server),
+                            onStreamDisconnect: server.onStreamDisconnect.bind(server),
+                        };
+                    }
+                    return undefined;
+                },
+            });
+            const desiredPort = this.config.port ?? 3000;
+            const availablePort = await findAvailablePort(desiredPort);
+            this._httpServer = this.config.serverFactory(availablePort);
+            this._httpServer.onRequest(kernel);
+            // Pre-resolve client IPs in Rust from the trusted-proxy CIDRs before
+            // listen. Security filtering itself lives in @c9up/blackhole.
+            const trustedProxies = this.server.getTrustedProxies();
+            if (trustedProxies.length > 0 &&
+                typeof this._httpServer.configureTrustedProxies === 'function') {
+                this._httpServer.configureTrustedProxies([...trustedProxies]);
+            }
+            await this._httpServer.listen();
+        }
+        else if (this.environment === 'web' && !this.config.serverFactory) {
+            throw new ReamError('IGNITOR_NO_SERVER_FACTORY', 'httpServer() requires a serverFactory in config', {
+                hint: 'Example: new Ignitor({ serverFactory: (port) => new HyperServer(port) })',
+            });
+        }
+        // Install error boundary
+        this.errorBoundary.install();
+        // Call ready() on providers
+        for (const provider of this.providers) {
+            await callProviderPhase(provider, 'ready');
+        }
+        // Core domain event: the app finished booting (all providers ready).
+        // Emitted once through the bus when events are wired — zero hot-path cost.
+        if (this.app.container.has('events')) {
+            this.app.container
+                .resolve('events')
+                .emit('app:ready', { environment: this.environment });
+        }
+        // Hot-reload in dev mode
+        if (this.isDevMode()) {
+            const watchDirs = this.config.watchDirs ?? ['app', 'start'];
+            this.hotReloadCleanup = startHotReload({
+                watchDirs,
+                onReload: async () => {
+                    const { clearServiceRegistry } = await import('./decorators/Service.js');
+                    clearServiceRegistry();
+                    this.router.clear();
+                    if (this.inlineRoutes)
+                        this.inlineRoutes(this.router);
+                    if (this.reamrc?.preloads) {
+                        for (const preloadEntry of this.reamrc.preloads) {
+                            const preloadImport = typeof preloadEntry === 'function' ? preloadEntry : preloadEntry.file;
+                            await preloadImport();
+                        }
+                    }
+                },
+                logger: {
+                    info: (msg) => this.handleError({
+                        type: 'system.info',
+                        source: 'HotReload',
+                        message: msg,
+                        severity: 'info',
+                        timestamp: new Date().toISOString(),
+                    }),
+                },
+            });
+        }
+        this.phase = 'ready';
+    }
+    /**
+     * 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')
+     */
+    async autoloadConfig() {
+        const { readdirSync, existsSync } = await import('node:fs');
+        const { join, basename } = await import('node:path');
+        const { fileURLToPath, pathToFileURL } = await import('node:url');
+        const configDir = this.appRoot
+            ? join(fileURLToPath(this.appRoot), 'config')
+            : join(process.cwd(), 'config');
+        if (!existsSync(configDir))
+            return;
+        const files = readdirSync(configDir)
+            .filter((f) => (f.endsWith('.ts') || f.endsWith('.js')) && !f.startsWith('.'))
+            .sort();
+        for (const file of files) {
+            const key = basename(file).replace(/\.(ts|js)$/, '');
+            const mod = await import(pathToFileURL(join(configDir, file)).href);
+            this.app.config.set(key, mod.default ?? mod);
+        }
+    }
+    /**
+     * Auto-load module files (routes.ts, etc.) from the modules directory.
+     * Scans modules.path for subdirectories and imports matching files.
+     */
+    async autoloadModules() {
+        const modulesConfig = this.reamrc?.modules;
+        if (!modulesConfig?.path)
+            return;
+        const { readdirSync, existsSync } = await import('node:fs');
+        const { join, resolve } = await import('node:path');
+        const { fileURLToPath } = await import('node:url');
+        const { pathToFileURL } = await import('node:url');
+        // Resolve modules path relative to app root or cwd
+        const basePath = this.appRoot
+            ? join(fileURLToPath(this.appRoot), modulesConfig.path)
+            : resolve(modulesConfig.path);
+        if (!existsSync(basePath))
+            return;
+        const autoloadFiles = modulesConfig.autoload ?? ['routes', 'events'];
+        const moduleDirs = readdirSync(basePath, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name)
+            .sort();
+        for (const moduleDir of moduleDirs) {
+            for (const fileName of autoloadFiles) {
+                const tsPath = join(basePath, moduleDir, `${fileName}.ts`);
+                const jsPath = join(basePath, moduleDir, `${fileName}.js`);
+                const filePath = existsSync(tsPath) ? tsPath : existsSync(jsPath) ? jsPath : null;
+                if (filePath) {
+                    await import(pathToFileURL(filePath).href);
+                }
+            }
+        }
+    }
+    /** Graceful shutdown. */
+    async stop() {
+        if (this.hotReloadCleanup)
+            this.hotReloadCleanup();
+        if (this._httpServer)
+            await this._httpServer.close();
+        this.errorBoundary.uninstall();
+        await this.app.shutdown();
+        this.phase = 'shutdown';
+    }
+    // ─── Accessors ────────────────────────────────────────────
+    async port() {
+        return this._httpServer ? this._httpServer.port() : 0;
+    }
+    getApp() {
+        return this.app;
+    }
+    getRouter() {
+        return this.router;
+    }
+    getServer() {
+        return this.server;
+    }
+    /** Get the kernel callback (for serverless / testing). */
+    getKernel() {
+        return createHttpKernel({
+            router: this.router,
+            middleware: this.middleware,
+            container: this.app.container,
+            exceptionHandler: this.server.getErrorHandler() ?? new ExceptionHandler(!this.app.inProduction),
+            serverMiddleware: this.server.getServerMiddleware(),
+            routerMiddleware: this.router.getRouterMiddleware(),
+        });
+    }
+    isDevMode() {
+        return this.app.inDev;
+    }
+    getPhase() {
+        return this.phase;
+    }
+    handleError(event) {
+        for (const listener of this.errorListeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                /* Don't let listeners crash */
+            }
+        }
+    }
+}
+/**
+ * Pretty-print an error (like AdonisJS prettyPrintError).
+ */
+export function prettyPrintError(error) {
+    if (error instanceof ReamError) {
+        console.error(error.toDevString());
+    }
+    else if (error instanceof Error) {
+        console.error(`\n  ${error.message}\n`);
+        if (error.stack)
+            console.error(error.stack);
+    }
+    else {
+        console.error(error);
+    }
+}
+/**
+ * ConsoleKernel — handles CLI command dispatching.
+ * Like AdonisJS: new Ignitor(...).console().handle(process.argv.splice(2))
+ */
+export class ConsoleKernel {
+    ignitor;
+    constructor(ignitor) {
+        this.ignitor = ignitor;
+    }
+    async handle(argv) {
+        await this.ignitor.start();
+        const { CommandRunner } = await import('./console/CommandRunner.js');
+        const runner = new CommandRunner();
+        // Auto-register commands from reamrc
+        const reamrc = this.ignitor.reamrc;
+        if (reamrc?.commands) {
+            for (const commandImport of reamrc.commands) {
+                const mod = await commandImport();
+                const cmd = mod.default;
+                if (cmd?.name && typeof cmd?.run === 'function') {
+                    runner.register(cmd);
+                }
+            }
+        }
+        this.ignitor.getApp().container.singleton('console', () => runner);
+        await runner.handle(argv);
+        await this.ignitor.stop();
+    }
+}
+async function findAvailablePort(desired) {
+    const net = await import('node:net');
+    for (let port = desired; port < desired + 20; port++) {
+        const available = await new Promise((resolve) => {
+            const server = net.createServer();
+            server.listen(port, () => server.close(() => resolve(true)));
+            server.on('error', () => resolve(false));
+        });
+        if (available)
+            return port;
+    }
+    return desired;
+}
+//# sourceMappingURL=Ignitor.js.map

package/dist/Ignitor.js.map

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

package/dist/Provider.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Base Provider class — modules register via providers.
+ *
+ * @implements FR20
+ *
+ * Lifecycle (AdonisJS-compatible):
+ *   register() → boot() → start() → ready() → ... → shutdown()
+ */
+import type { ConfigStore } from './ConfigLoader.js';
+import type { Container } from './container/Container.js';
+export interface AppContext {
+    container: Container;
+    config: ConfigStore;
+}
+/**
+ * Structural contract for a provider — all phases optional. Independently-
+ * published packages (spectrum, warden, blackhole, relay, ...) implement
+ * only the phases they need without taking a hard dependency on
+ * `@c9up/ream`. The lifecycle runner guards each call with a `typeof`
+ * check, so a missing method is opt-out, not a contract break.
+ *
+ * The abstract `Provider` class below is the convenience implementation
+ * for code that *does* live inside this package — it ships empty
+ * defaults for every phase. Both shapes satisfy `ProviderContract`.
+ */
+export interface ProviderContract {
+    register?(): void;
+    boot?(): Promise<void> | void;
+    start?(): Promise<void> | void;
+    ready?(): Promise<void> | void;
+    shutdown?(): Promise<void> | void;
+}
+/**
+ * Invoke an async lifecycle phase on a provider, ignoring it when the
+ * method is absent. Centralises the duck-type guard that the lifecycle
+ * runner has to do at every phase since `ProviderContract` makes them
+ * all optional.
+ */
+export declare function callProviderPhase(provider: ProviderContract, phase: 'boot' | 'start' | 'ready' | 'shutdown'): Promise<void>;
+export declare abstract class Provider implements ProviderContract {
+    protected app: AppContext;
+    constructor(app: AppContext);
+    /** Phase 1: Register bindings in the container (synchronous). */
+    register(): void;
+    /** Phase 2: Boot — framework setup, verify connections. */
+    boot(): Promise<void>;
+    /** Phase 3: Start — before HTTP server starts. Import routes, warm caches. */
+    start(): Promise<void>;
+    /** Phase 4: Ready — app fully operational, HTTP server listening. */
+    ready(): Promise<void>;
+    /** Cleanup on shutdown (reverse order). */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=Provider.d.ts.map

package/dist/Provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../src/Provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEzD,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,WAAW,CAAA;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,IAAI,CAAA;IACjB,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC7B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC9B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAC7C,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,8BAAsB,QAAS,YAAW,gBAAgB;IACxD,SAAS,CAAC,GAAG,EAAE,UAAU,CAAA;gBAEb,GAAG,EAAE,UAAU;IAI3B,iEAAiE;IACjE,QAAQ,IAAI,IAAI;IAEhB,2DAA2D;IACrD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,8EAA8E;IACxE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5B,qEAAqE;IAC/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAE5B,2CAA2C;IACrC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAChC"}

package/dist/Provider.js

@@ -0,0 +1,37 @@
+/**
+ * Base Provider class — modules register via providers.
+ *
+ * @implements FR20
+ *
+ * Lifecycle (AdonisJS-compatible):
+ *   register() → boot() → start() → ready() → ... → shutdown()
+ */
+/**
+ * Invoke an async lifecycle phase on a provider, ignoring it when the
+ * method is absent. Centralises the duck-type guard that the lifecycle
+ * runner has to do at every phase since `ProviderContract` makes them
+ * all optional.
+ */
+export async function callProviderPhase(provider, phase) {
+    const fn = provider[phase];
+    if (typeof fn === 'function') {
+        await fn.call(provider);
+    }
+}
+export class Provider {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    /** Phase 1: Register bindings in the container (synchronous). */
+    register() { }
+    /** Phase 2: Boot — framework setup, verify connections. */
+    async boot() { }
+    /** Phase 3: Start — before HTTP server starts. Import routes, warm caches. */
+    async start() { }
+    /** Phase 4: Ready — app fully operational, HTTP server listening. */
+    async ready() { }
+    /** Cleanup on shutdown (reverse order). */
+    async shutdown() { }
+}
+//# sourceMappingURL=Provider.js.map

package/dist/Provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.js","sourceRoot":"","sources":["../src/Provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA6BH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,QAA0B,EAC1B,KAA8C;IAE9C,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC1B,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACzB,CAAC;AACH,CAAC;AAED,MAAM,OAAgB,QAAQ;IAClB,GAAG,CAAY;IAEzB,YAAY,GAAe;QACzB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;IAChB,CAAC;IAED,iEAAiE;IACjE,QAAQ,KAAU,CAAC;IAEnB,2DAA2D;IAC3D,KAAK,CAAC,IAAI,KAAmB,CAAC;IAE9B,8EAA8E;IAC9E,KAAK,CAAC,KAAK,KAAmB,CAAC;IAE/B,qEAAqE;IACrE,KAAK,CAAC,KAAK,KAAmB,CAAC;IAE/B,2CAA2C;IAC3C,KAAK,CAAC,QAAQ,KAAmB,CAAC;CACnC"}

package/dist/bodyparser/BodyParserMiddleware.d.ts

@@ -0,0 +1,38 @@
+/**
+ * BodyParser middleware — parses request bodies by content-type.
+ *
+ * Supports JSON, form-urlencoded, and raw text.
+ * Multipart (file uploads) handled separately.
+ * Configured via config/bodyparser.ts.
+ */
+import type { HttpContext } from '../http/HttpContext.js';
+export interface BodyParserConfig {
+    json?: {
+        enabled?: boolean;
+        limit?: string;
+        types?: string[];
+    };
+    form?: {
+        enabled?: boolean;
+        limit?: string;
+        types?: string[];
+    };
+    raw?: {
+        enabled?: boolean;
+        limit?: string;
+        types?: string[];
+    };
+    multipart?: {
+        enabled?: boolean;
+        limit?: string;
+        maxFields?: number;
+        tmpDir?: string;
+        types?: string[];
+    };
+}
+export default class BodyParserMiddleware {
+    #private;
+    constructor(config?: BodyParserConfig);
+    handle(ctx: HttpContext, next: () => Promise<void>): Promise<void>;
+}
+//# sourceMappingURL=BodyParserMiddleware.d.ts.map