legonode 0.0.1

package/dist/cli/commands/start.js

@@ -0,0 +1,108 @@
+import { resolve, relative, join } from "node:path";
+import { existsSync } from "node:fs";
+import { setupServer } from "../../src/server/server.js";
+import { loadConfig, getBuildPath, getAppDir } from "../../src/config/loadConfig.js";
+import { loadSchedulesFromApp } from "../../src/schedules/scheduleLoader.js";
+import { runScheduler } from "../../src/schedules/runScheduler.js";
+import { validateApp } from "../../src/validation/validateApp.js";
+import { runPluginHook } from "../pluginHooks.js";
+import { appLogger } from "../../src/utils/logger.js";
+export const startCommand = {
+    name: "legonode start",
+    run: async (opts = {}) => {
+        const host = opts.host ?? "127.0.0.1";
+        const cwd = process.cwd();
+        const config = await loadConfig(cwd);
+        const plugins = config.plugins;
+        const buildPath = opts.buildPath ? resolve(cwd, opts.buildPath) : getBuildPath(config, cwd);
+        // Built app lives at buildPath/app (same structure as source appDir)
+        const currentAppDir = getAppDir(config, cwd);
+        const appDirRelative = relative(cwd, currentAppDir || "");
+        const appDir = join(buildPath, appDirRelative);
+        if (!existsSync(appDir)) {
+            appLogger.error(`Built app dir not found: ${appDir}. Run "legonode build" first, or check --build-path.`);
+            process.exit(1);
+        }
+        const port = opts.port ? Number(opts.port) : (config.port ?? 3000);
+        if (!Number.isFinite(port) || port <= 0) {
+            throw new Error(`Invalid --port: ${opts.port ?? config.port ?? ""}`);
+        }
+        await runPluginHook(plugins, "onStartStart", {
+            command: "start",
+            cwd,
+            appDir,
+            host,
+            port,
+            buildPath,
+        });
+        const isValid = await validateApp(appDir);
+        if (!isValid) {
+            appLogger.error("Failed to validate the app");
+            process.exit(1);
+        }
+        const app = setupServer(config, cwd, appDir, port, host);
+        if (app) {
+            await app.listen();
+            await runPluginHook(plugins, "onStartListening", {
+                command: "start",
+                cwd,
+                appDir,
+                host,
+                port,
+                buildPath,
+            });
+        }
+        else {
+            await runPluginHook(plugins, "onStartError", {
+                command: "start",
+                cwd,
+                appDir,
+                host,
+                port,
+                buildPath,
+                error: new Error("Failed to start the server"),
+            });
+            appLogger.error("Failed to start the server");
+            process.exit(1);
+        }
+        const tasks = await loadSchedulesFromApp(appDir);
+        let stopScheduler = null;
+        if (tasks.length > 0) {
+            stopScheduler = runScheduler(tasks, {
+                onRun: async (name, taskCtx) => {
+                    await runPluginHook(plugins, "onCronRun", undefined, {
+                        name,
+                        payload: taskCtx.payload,
+                        source: "scheduler",
+                    });
+                },
+                onError: (name, err) => {
+                    void runPluginHook(plugins, "onCronError", undefined, {
+                        name,
+                        payload: undefined,
+                        source: "scheduler",
+                        error: err,
+                    });
+                    appLogger.error(`[legonode task ${name}]`, err);
+                }
+            });
+        }
+        const onSignal = () => {
+            void runPluginHook(plugins, "onStartStop", {
+                command: "start",
+                cwd,
+                appDir,
+                host,
+                port,
+                buildPath,
+                reason: "signal",
+            });
+            stopScheduler?.();
+            void app?.close().catch(() => { });
+            process.exit(0);
+        };
+        process.on("SIGINT", onSignal);
+        process.on("SIGTERM", onSignal);
+    }
+};
+//# sourceMappingURL=start.js.map

package/dist/cli/commands/start.js.map

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

package/dist/cli/pluginHooks.d.ts

@@ -0,0 +1,5 @@
+import type { LegonodePlugin } from "../src/plugin/pluginAPI.js";
+type HookName = keyof LegonodePlugin;
+export declare function runPluginHook(plugins: LegonodePlugin[] | undefined, hook: HookName, ...args: unknown[]): Promise<void>;
+export {};
+//# sourceMappingURL=pluginHooks.d.ts.map

package/dist/cli/pluginHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginHooks.d.ts","sourceRoot":"","sources":["../../cli/pluginHooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,KAAK,QAAQ,GAAG,MAAM,cAAc,CAAC;AAIrC,wBAAsB,aAAa,CACjC,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,EACrC,IAAI,EAAE,QAAQ,EACd,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/cli/pluginHooks.js

@@ -0,0 +1,11 @@
+export async function runPluginHook(plugins, hook, ...args) {
+    if (!plugins || plugins.length === 0)
+        return;
+    for (const plugin of plugins) {
+        const fn = plugin[hook];
+        if (typeof fn === "function") {
+            await fn(...args);
+        }
+    }
+}
+//# sourceMappingURL=pluginHooks.js.map

package/dist/cli/pluginHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginHooks.js","sourceRoot":"","sources":["../../cli/pluginHooks.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAqC,EACrC,IAAc,EACd,GAAG,IAAe;IAElB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAC7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAe,CAAC;QACtC,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/body/parseBody.d.ts

@@ -0,0 +1,11 @@
+import type { IncomingMessage } from "node:http";
+export type ParseBodyResult = {
+    ok: true;
+    body: unknown;
+} | {
+    ok: false;
+    status: number;
+    body: unknown;
+};
+export declare function parseBody(req: IncomingMessage, maxBodySize?: number): Promise<ParseBodyResult>;
+//# sourceMappingURL=parseBody.d.ts.map

package/dist/src/body/parseBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBody.d.ts","sourceRoot":"","sources":["../../../src/body/parseBody.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC3B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AA8EjD,wBAAsB,SAAS,CAC7B,GAAG,EAAE,eAAe,EACpB,WAAW,GAAE,MAA8B,GAC1C,OAAO,CAAC,eAAe,CAAC,CAsC1B"}

package/dist/src/body/parseBody.js

@@ -0,0 +1,113 @@
+const DEFAULT_MAX_BODY_SIZE = 1_000_000; // 1MB
+const PAYLOAD_TOO_LARGE = new Error("Payload too large");
+function readStream(req, maxSize) {
+    return new Promise((resolve, reject) => {
+        const contentLength = req.headers["content-length"];
+        const length = contentLength ? parseInt(contentLength, 10) : null;
+        if (length !== null && (isNaN(length) || length < 0 || length > maxSize)) {
+            reject(PAYLOAD_TOO_LARGE);
+            return;
+        }
+        if (length === 0) {
+            resolve(Buffer.allocUnsafe(0));
+            return;
+        }
+        if (length !== null && length <= maxSize) {
+            const buf = Buffer.allocUnsafe(length);
+            let offset = 0;
+            req.on("data", (chunk) => {
+                const toCopy = Math.min(chunk.length, length - offset);
+                chunk.copy(buf, offset, 0, toCopy);
+                offset += toCopy;
+                if (offset > maxSize) {
+                    req.destroy();
+                    reject(PAYLOAD_TOO_LARGE);
+                }
+            });
+            req.on("end", () => resolve(buf.subarray(0, offset)));
+            req.on("error", reject);
+            return;
+        }
+        const chunks = [];
+        let total = 0;
+        req.on("data", (chunk) => {
+            total += chunk.length;
+            if (total > maxSize) {
+                req.destroy();
+                reject(PAYLOAD_TOO_LARGE);
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on("end", () => resolve(Buffer.concat(chunks)));
+        req.on("error", reject);
+    });
+}
+function parseJson(buf) {
+    if (buf.length === 0)
+        return null;
+    const raw = buf.toString("utf-8");
+    return JSON.parse(raw);
+}
+function parseUrlEncoded(buf) {
+    if (buf.length === 0)
+        return {};
+    const raw = buf.toString("utf-8");
+    const out = {};
+    for (const pair of raw.split("&")) {
+        const eq = pair.indexOf("=");
+        if (eq === -1) {
+            out[decodeURIComponent(pair.replace(/\+/g, " "))] = "";
+        }
+        else {
+            const key = decodeURIComponent(pair.slice(0, eq).replace(/\+/g, " "));
+            const value = decodeURIComponent(pair.slice(eq + 1).replace(/\+/g, " "));
+            out[key] = value;
+        }
+    }
+    return out;
+}
+function getContentType(req) {
+    const raw = req.headers["content-type"];
+    if (!raw || typeof raw !== "string")
+        return null;
+    const part = raw.split(";")[0];
+    return part ? part.trim().toLowerCase() : null;
+}
+export async function parseBody(req, maxBodySize = DEFAULT_MAX_BODY_SIZE) {
+    const method = (req.method ?? "GET").toUpperCase();
+    if (method === "GET" || method === "HEAD") {
+        return { ok: true, body: null };
+    }
+    const contentLength = req.headers["content-length"];
+    if (contentLength === "0" || contentLength === undefined) {
+        return { ok: true, body: null };
+    }
+    let buffer;
+    try {
+        buffer = await readStream(req, maxBodySize);
+    }
+    catch (err) {
+        const message = err === PAYLOAD_TOO_LARGE ? "Payload too large" : "Bad request";
+        return { ok: false, status: 413, body: { error: message } };
+    }
+    const contentType = getContentType(req);
+    if (!contentType || buffer.length === 0) {
+        return { ok: true, body: null };
+    }
+    if (contentType === "application/json") {
+        try {
+            const body = parseJson(buffer);
+            return { ok: true, body };
+        }
+        catch {
+            return { ok: false, status: 400, body: { error: "Invalid JSON" } };
+        }
+    }
+    if (contentType === "application/x-www-form-urlencoded") {
+        const body = parseUrlEncoded(buffer);
+        return { ok: true, body };
+    }
+    return { ok: true, body: buffer };
+}
+//# sourceMappingURL=parseBody.js.map

package/dist/src/body/parseBody.js.map

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

package/dist/src/config/loadConfig.d.ts

@@ -0,0 +1,71 @@
+import type { LegonodeContext } from "../core/context.js";
+import type { LegonodePlugin } from "../plugin/pluginAPI.js";
+import type { ResponseSchemaMap } from "../validation/routeSchema.js";
+import type { LegonodeLogger } from "../logger/requestLogger.js";
+import type { TracerFn, TraceStartFn } from "../trace/traceEngine.js";
+export type CorsConfig = {
+    origin?: string | string[] | boolean;
+    methods?: string[];
+    allowedHeaders?: string[];
+    credentials?: boolean;
+};
+export type ErrorHandlerResult = {
+    status?: number;
+    headers?: Record<string, string>;
+    json?: unknown;
+} | {
+    status?: number;
+    headers?: Record<string, string>;
+    body?: string | Uint8Array;
+};
+export type ErrorHandler = (ctx: LegonodeContext, err: unknown) => void | ErrorHandlerResult | Promise<void | ErrorHandlerResult>;
+export type LegonodeConfig = {
+    appDir?: string;
+    buildPath?: string;
+    /** Port for dev/start (CLI --port overrides). */
+    port?: number;
+    /** Dev-only options. */
+    dev?: {
+        /** Set false to disable cron jobs in development (default: true). */
+        cron?: boolean;
+        /** Set true to use pino-pretty for human-readable logs in development. */
+        logPretty?: boolean;
+    };
+    maxBodySize?: number;
+    errorHandler?: ErrorHandler;
+    cors?: CorsConfig;
+    plugins?: LegonodePlugin[];
+    /** Default response body schemas per status code. Enforced before send; invalid response becomes 500. */
+    responses?: ResponseSchemaMap;
+    /** Base logger for request loggers (ctx.logger). If not set, a default pino logger is used. */
+    logger?: LegonodeLogger;
+    /** Set false to disable request lifecycle logging (request started / request completed) and tracer/traceStart callbacks (default: true). */
+    tracing?: boolean;
+    /** Called when a request span ends with trace data (method, pathname, duration, status, responseSize, etc.). */
+    tracer?: TracerFn;
+    /** Called when a request span starts. Default logs "request started" via logger. */
+    traceStart?: TraceStartFn;
+};
+export declare function loadConfig(cwd: string): Promise<LegonodeConfig>;
+export declare function getAppDir(config: LegonodeConfig, cwd: string): string | undefined;
+export declare function getBuildPath(config: LegonodeConfig, cwd: string): string;
+export type RequestHandlerOptionsFromConfig = {
+    appDir: string;
+    maxBodySize?: number;
+    errorHandler?: ErrorHandler;
+    cors?: CorsConfig;
+    plugins?: LegonodePlugin[];
+    responses?: ResponseSchemaMap;
+    logger?: LegonodeLogger;
+    dev?: {
+        cron?: boolean;
+        logPretty?: boolean;
+    };
+    tracing?: boolean;
+    tracer?: TracerFn;
+    traceStart?: TraceStartFn;
+};
+export declare function getRequestHandlerOptionsFromConfig(config: LegonodeConfig, cwd: string, overrides?: {
+    appDir?: string;
+}): RequestHandlerOptionsFromConfig;
+//# sourceMappingURL=loadConfig.d.ts.map

package/dist/src/config/loadConfig.d.ts.map

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

package/dist/src/config/loadConfig.js

@@ -0,0 +1,69 @@
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { existsSync } from "node:fs";
+import { appLogger } from "../utils/logger.js";
+export async function loadConfig(cwd) {
+    const candidates = ["legonode.config.ts", "legonode.config.js", "legonode.config.mjs"];
+    for (const name of candidates) {
+        const configPath = resolve(cwd, name);
+        try {
+            const url = pathToFileURL(configPath).href;
+            const mod = await import(url);
+            const config = mod.default ?? mod;
+            return typeof config === "object" && config !== null ? config : {};
+        }
+        catch {
+            continue;
+        }
+    }
+    return {};
+}
+export function getAppDir(config, cwd) {
+    // Default app directory layout:
+    // - routes live under `${appDir}/router/**`
+    // - other runtime features (events/schedules/middleware/etc.) use `${appDir}`
+    try {
+        const appDir = config.appDir ?? "./src";
+        const routerDir = resolve(appDir);
+        if (existsSync(routerDir)) {
+            return routerDir;
+        }
+        throw new Error();
+    }
+    catch {
+        appLogger.error("App directory not found: ", config.appDir);
+        return;
+    }
+    // const raw = config.appDir ?? "./src";
+    // return raw.startsWith("/") ? raw : resolve(cwd, raw);
+}
+export function getBuildPath(config, cwd) {
+    const raw = config.buildPath ?? "./dist";
+    return raw.startsWith("/") ? raw : resolve(cwd, raw);
+}
+export function getRequestHandlerOptionsFromConfig(config, cwd, overrides) {
+    const appDir = overrides?.appDir ?? getAppDir(config, cwd);
+    const out = { appDir: appDir || "" };
+    if (config.maxBodySize !== undefined)
+        out.maxBodySize = config.maxBodySize;
+    if (config.errorHandler !== undefined)
+        out.errorHandler = config.errorHandler;
+    if (config.cors !== undefined)
+        out.cors = config.cors;
+    if (config.plugins !== undefined)
+        out.plugins = config.plugins;
+    if (config.responses !== undefined)
+        out.responses = config.responses;
+    if (config.logger !== undefined)
+        out.logger = config.logger;
+    if (config.dev !== undefined)
+        out.dev = config.dev;
+    if (config.tracing !== undefined)
+        out.tracing = config.tracing;
+    if (config.tracer !== undefined)
+        out.tracer = config.tracer;
+    if (config.traceStart !== undefined)
+        out.traceStart = config.traceStart;
+    return out;
+}
+//# sourceMappingURL=loadConfig.js.map

package/dist/src/config/loadConfig.js.map

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

package/dist/src/core/context.d.ts

@@ -0,0 +1,139 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { Readable } from "node:stream";
+import type { TraceSpan } from "../trace/traceEngine.js";
+import type { RequestLogEntry, LegonodeLogger } from "../logger/requestLogger.js";
+/** Exposed on ctx.trace so the user can get the request trace id (e.g. for logging). */
+export type TraceRef = {
+    readonly traceId: string;
+};
+import type { EventEmitterFn } from "../events/eventBus.js";
+import type { ScheduleRunnerFn } from "../schedules/scheduleLoader.js";
+import type { ResponseSchemaMap } from "../validation/routeSchema.js";
+export type Response = {
+    status?: number;
+    headers?: Record<string, string>;
+    body?: string | Uint8Array;
+} | {
+    status?: number;
+    headers?: Record<string, string>;
+    json: unknown;
+};
+/** Chainable return type for ctx.res.status(code).json() / .send() / .text() / .html() */
+export type ResStatusChain = {
+    json: (data: unknown) => void | Promise<void>;
+    send: (body: string | Buffer | Uint8Array) => void | Promise<void>;
+    text: (body: string) => void | Promise<void>;
+    html: (body: string) => void | Promise<void>;
+};
+/** Fluent response API on ctx.res */
+export type LegonodeResponse = {
+    /** Raw Node HTTP response */
+    raw: ServerResponse;
+    /** Set status code; returns chainable .json() / .send() / .text() */
+    status: (code: number) => ResStatusChain;
+    /** Current status code (e.g. set by status()); used when handler returns data without calling res.json() */
+    readonly statusCode: number;
+    /** Headers to send (merged when response is sent) */
+    headers: Record<string, string | number>;
+    /** Set a single header */
+    setHeader: (name: string, value: string | number) => void;
+    /** Send raw body (HTML, buffer). Default content-type not set; use setHeader for HTML */
+    send: (body: string | Buffer | Uint8Array) => void | Promise<void>;
+    /** Send HTML (content-type text/html) */
+    html: (body: string) => void | Promise<void>;
+    /** Send JSON (content-type application/json) */
+    json: (data: unknown) => void | Promise<void>;
+    /** Send plain text (content-type text/plain) */
+    text: (body: string) => void | Promise<void>;
+    /** Redirect to url (default 302). Use status as second arg for 301 etc. */
+    redirect: (url: string, status?: number) => void | Promise<void>;
+    /** Pipe a readable stream as the response body */
+    stream: (readable: Readable) => void | Promise<void>;
+    /** True if response was already sent (e.g. via res.json()) */
+    readonly sent: boolean;
+    /** @internal Reuse for another request when using context pool. */
+    reinit?: (nodeRes: ServerResponse, defaultStatusRef: DefaultStatusRef, responseSizeRef?: {
+        current: number;
+    }) => void;
+};
+export type LegonodeContext = {
+    req: IncomingMessage;
+    res: LegonodeResponse;
+    /** Path params; catch-all [[...x]] params are string[], others are string. */
+    params: Record<string, string | string[]>;
+    /** Query params (parsed from URL or replaced by validated Record after validation). */
+    query: Record<string, string>;
+    body: unknown;
+    state: Record<string, unknown>;
+    emit: EventEmitterFn;
+    /** Trigger a cron by name (e.g. "interval.example"). Same run() as in app/cron/*.cron.ts. */
+    schedule: ScheduleRunnerFn;
+    /** Request-scoped logger with traceId in bindings. Use for application logs; tracing is automatic. */
+    logger: LegonodeLogger;
+    /** Request-scoped captured logger output for plugin/readback use. */
+    log: {
+        state: RequestLogEntry[];
+    };
+    /** Request trace id (one per request). Use ctx.trace.traceId for correlation. */
+    trace: TraceRef;
+    /** @internal Used by framework for span start/annotate/end; do not use. */
+    __traceSpan?: TraceSpan;
+    /** @internal Set by framework so res.json() can validate against response schema for current status. */
+    __responseSchemaRef?: ResponseSchemaRef;
+    /** @internal Set by framework from merged response schema (route + config) so res uses that default when status() not called. */
+    __defaultStatusRef?: DefaultStatusRef;
+    /** @internal Set by framework when response is sent; used for trace responseSize. */
+    __responseSizeRef?: {
+        current: number;
+    };
+    /** @internal Backing for query getter; reset on release for context pool. */
+    __queryCache?: Record<string, string> | undefined;
+    /** @internal Ref for beforeSend to resolve ctx when res sends. */
+    __ctxRef?: {
+        current: LegonodeContext | null;
+    };
+};
+/** Map status codes to response body types for typed res.status(code).json(data). */
+export type ResponseBodyByStatus = Record<number, unknown>;
+/** Chain with json(data) typed by status code. */
+export type ResStatusChainTyped<T> = {
+    json: (data: T) => void;
+    send: (body: string | Buffer | Uint8Array) => void;
+    text: (body: string) => void;
+    html: (body: string) => void;
+};
+/** Response API: status(code) accepts any number; .json(data) typed for codes in T when possible. */
+export type LegonodeResponseTyped<T extends ResponseBodyByStatus> = Omit<LegonodeResponse, "status" | "json"> & {
+    /** Accepts any status code; .json() payload is typed when code is in your response schema. */
+    status: (code: number) => ResStatusChainTyped<unknown>;
+    json: (data: unknown) => void;
+};
+/** Context with res.json() typed by status from response schema. */
+export type ContextWithResponses<T extends ResponseBodyByStatus> = Omit<LegonodeContext, "res"> & {
+    res: LegonodeResponseTyped<T>;
+};
+/**
+ * Context type. Use without a generic for untyped res, or with a response body type map to enforce schema typing.
+ * @example
+ * export default async function GET(ctx: Context) { ... }
+ * // Or with response schema typing:
+ * type Res = InferResponseBodies<typeof RESPONSE_SCHEMA>;
+ * export default async function GET(ctx: Context<Res>) { ctx.res.status(200).json([...]); }
+ */
+export type Context<T extends ResponseBodyByStatus = never> = [T] extends [never] ? Omit<LegonodeContext, "__traceSpan" | "__responseSchemaRef" | "__defaultStatusRef" | "__responseSizeRef"> : Omit<ContextWithResponses<T>, "__traceSpan" | "__responseSchemaRef" | "__defaultStatusRef" | "__responseSizeRef">;
+export type ResponseSchemaRef = {
+    current?: ResponseSchemaMap;
+};
+export type DefaultStatusRef = {
+    current: number;
+};
+/** Pick default status when handler does not call res.status(): prefer 200, then 201, then 204; else 200. */
+export declare function getDefaultStatusFromSchema(schema: ResponseSchemaMap | undefined): number;
+export type BeforeSendFn = (ctx: LegonodeContext) => void | Promise<void>;
+/** Get context from pool or create new. Use releaseContext(ctx) in finally when done. When usePool is false, always alloc (faster hot path for hello-world). */
+export declare function getContext(req: IncomingMessage, res: ServerResponse, usePool?: boolean, beforeSend?: BeforeSendFn): LegonodeContext;
+/** Return context to pool. Call in request handler finally. Keeps ctx.res for reuse via reinit. */
+export declare function releaseContext(ctx: LegonodeContext): void;
+/** Get a request context (from pool when possible). Same as getContext; exported for backwards compatibility. */
+export declare const createContext: typeof getContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/src/core/context.d.ts.map

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