@raiyyan/brisk 0.0.0-stage → 0.2.0

package/dist/src/http/controller.d.ts.map

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

package/dist/src/http/controller.js

@@ -0,0 +1,290 @@
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { Router } from "express";
+import { getContext, HandlerContext } from "./context.js";
+import { MethodNotAllowedError, UnsupportedMediaTypeError } from "../errors/http-errors.js";
+import { applyMiddlewares, securityOf, } from "./middleware.js";
+import { parseInput, Pending, serializeOutput, settle } from "./validation.js";
+/**
+ * Declares a feature's HTTP routes. `setup` runs once per app instance, inside its container, so it can
+ * `inject()` services. It declares routes and returns them by name; the names form the typed client, so
+ * `usersController` mounted as `users` gives `api.users.get(...)`.
+ *
+ * A handler's return value is the response: nothing sends 204, a `Readable` is streamed, a `Buffer` is sent
+ * as bytes, and anything else is JSON, parsed through `response` when given. Throw an error class to fail;
+ * never call `next()`.
+ *
+ * @example
+ * ```ts
+ * export const usersController = defineController({ prefix: "/users", use: [authenticate] }, (route) => {
+ *   const users = inject(UsersService);
+ *   return {
+ *     me: route.get("/me", ({ user }) => user),
+ *     get: route.get("/:id", { params: UserIdParams, response: UserResponse }, ({ params }) => users.get(params.id)),
+ *     create: route.post("/", { body: CreateUserBody, response: UserResponse }, ({ body }) => users.create(body)),
+ *   };
+ * });
+ * ```
+ */
+export function defineController(options, setup) {
+    return {
+        prefix: options.prefix,
+        providers: options.providers ?? [],
+        mount: (target) => mount(target, options.use ?? [], (builder) => 
+        // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- the loose builder implements every typed overload at runtime
+        setup(builder)),
+    };
+}
+/**
+ * Registers a controller's routes inside the container, with full paths on the app's one router: no nested
+ * router per controller, so a request pays no prefix trimming or parameter merging on its way to a route.
+ */
+function mount({ container, router, basePath, parseBody }, use, register) {
+    const declared = [];
+    const returned = container.run(() => register(createBuilder({ router, container, parseBody, declared, prefix: basePath, use })));
+    const named = new Map();
+    const manifest = returned === undefined ? undefined : toManifest(returned, named, basePath, "");
+    const missing = manifest ? declared.find((ref) => !named.has(ref)) : undefined;
+    if (missing) {
+        throw new TypeError(`Controller ${basePath} declares ${missing.method.toUpperCase()} ${missing.path} but does not return it: add it to the object setup returns`);
+    }
+    const endpoints = declared.map((ref) => ({
+        method: ref.method,
+        path: ref.path,
+        name: named.get(ref),
+        schemas: ref.schemas,
+        status: ref.status,
+        security: ref.security,
+    }));
+    return { endpoints, manifest };
+}
+/** A route as `route.get(...)` returns it: method and full path for the manifest, schemas for documentation. */
+class RouteRef {
+    method;
+    path;
+    schemas;
+    status;
+    security;
+    constructor(method, path, options, middlewares) {
+        this.method = method;
+        this.path = path;
+        this.status = options.status;
+        this.security = securityOf(middlewares);
+        const schemas = {};
+        for (const key of ["params", "query", "body", "headers", "response"]) {
+            const schema = options[key];
+            if (schema)
+                schemas[key] = schema;
+        }
+        this.schemas = schemas;
+    }
+}
+/** Turns the object a setup returned into a manifest, recording every route's dotted name. */
+function toManifest(value, named, where, scope) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new TypeError(`Controller ${where} must return an object of named routes, or nothing`);
+    }
+    const manifest = {};
+    for (const [name, entry] of Object.entries(value)) {
+        const dotted = scope === "" ? name : `${scope}.${name}`;
+        if (entry instanceof RouteRef) {
+            named.set(entry, dotted);
+            manifest[name] = [entry.method.toUpperCase(), entry.path];
+        }
+        else if (isController(entry)) {
+            throw new TypeError(`"${dotted}" in controller ${where} is a controller, not a route: add it to defineApp({ controllers }) instead`);
+        }
+        else {
+            manifest[name] = toManifest(entry, named, `${where} (${dotted})`, dotted);
+        }
+    }
+    return manifest;
+}
+/**
+ * Answers requests no controller handled on a known path: `OPTIONS` gets 204, other methods 405, both with an
+ * `Allow` header that lists what every controller accepts there.
+ *
+ * The app mounts it twice. Before the controllers, for `OPTIONS` only, because an Express router would
+ * otherwise answer `OPTIONS` itself with just its own methods. After them, where only unmatched requests
+ * arrive. A request that matches a route never runs it.
+ */
+export function methodGuard(routes) {
+    const router = Router();
+    const allowedByRequest = new WeakMap();
+    const allowed = new Map();
+    for (const { method, path } of routes) {
+        const methods = allowed.get(path) ?? new Set(["OPTIONS"]);
+        methods.add(method.toUpperCase());
+        if (method === "get")
+            methods.add("HEAD");
+        allowed.set(path, methods);
+    }
+    for (const [path, methods] of allowed) {
+        router.all(path, (req, _res, next) => {
+            const seen = allowedByRequest.get(req);
+            if (seen)
+                for (const method of methods)
+                    seen.add(method);
+            else
+                allowedByRequest.set(req, new Set(methods));
+            next();
+        });
+    }
+    router.use((req, res, next) => {
+        const methods = allowedByRequest.get(req);
+        if (!methods) {
+            next();
+            return;
+        }
+        const allow = [...methods].toSorted();
+        if (req.method !== "OPTIONS")
+            throw new MethodNotAllowedError(allow);
+        res.set("allow", allow.join(", ")).status(204).end();
+    });
+    return router;
+}
+function createBuilder(state) {
+    const route = (method) => (path, optionsOrHandler, maybeHandler) => {
+        const [options, handler] = isFunction(optionsOrHandler)
+            ? [{}, optionsOrHandler]
+            : [optionsOrHandler, maybeHandler];
+        if (!isOptions(options) || !isFunction(handler)) {
+            throw new TypeError(`Invalid route ${method.toUpperCase()} ${path}: use (path, handler) or (path, options, handler)`);
+        }
+        if (options.status !== undefined && !isSuccessStatus(options.status)) {
+            throw new TypeError(`Invalid status ${String(options.status)} on ${method.toUpperCase()} ${path}: use a 2xx or 3xx status; throw an error class for failures`);
+        }
+        const fullPath = joinPath(state.prefix, path);
+        const middlewares = [...state.use, ...(options.use ?? [])];
+        const ref = new RouteRef(method, fullPath, options, middlewares);
+        state.declared.push(ref);
+        const run = (req, res) => state.container.run(handle, req, res, method, middlewares, options, handler);
+        // GET requests rarely carry a body, so they skip the parser unless the route declares one.
+        if (method === "get" && !options.body)
+            state.router.get(fullPath, run);
+        else
+            state.router[method](fullPath, state.parseBody, run);
+        return ref;
+    };
+    return {
+        get: route("get"),
+        post: route("post"),
+        put: route("put"),
+        patch: route("patch"),
+        delete: route("delete"),
+        group(path, optionsOrSetup, maybeSetup) {
+            const [options, setup] = isFunction(optionsOrSetup)
+                ? [{}, optionsOrSetup]
+                : [optionsOrSetup, maybeSetup];
+            if (!isOptions(options) || !isFunction(setup)) {
+                throw new TypeError(`Invalid group ${path}: use (path, setup) or (path, options, setup)`);
+            }
+            return setup(createBuilder({
+                ...state,
+                prefix: joinPath(state.prefix, path),
+                use: [...state.use, ...(options.use ?? [])],
+            }));
+        },
+    };
+}
+/**
+ * One request: middlewares, input validation, handler, then the response the handler's result calls for.
+ * Awaits only what is really a promise, so synchronous middlewares and handlers stay synchronous.
+ */
+async function handle(req, res, method, middlewares, options, handler) {
+    const base = getContext(req);
+    const ctx = new HandlerContext(base);
+    if (middlewares.length > 0) {
+        const pending = applyMiddlewares(base, ctx, middlewares);
+        if (pending)
+            await pending;
+        if (res.headersSent)
+            return;
+    }
+    if (options.body && req.body === undefined && hasBody(req) && req.get("content-type") !== undefined) {
+        throw new UnsupportedMediaTypeError(`No parser accepted a ${req.get("content-type")} body`);
+    }
+    const parsing = parseInto(ctx, req, options);
+    if (parsing)
+        await parsing;
+    const returned = handler(ctx);
+    const result = returned instanceof Promise ? await returned : returned;
+    if (res.headersSent)
+        return;
+    const chosen = options.status ?? (res.statusCode === 200 ? undefined : res.statusCode);
+    if (result === undefined) {
+        res.status(chosen ?? 204).end();
+        return;
+    }
+    const status = chosen ?? (method === "post" ? 201 : 200);
+    if (result instanceof Readable) {
+        res.status(status);
+        await stream(result, res);
+        return;
+    }
+    if (result instanceof Uint8Array) {
+        res.status(status).send(Buffer.from(result.buffer, result.byteOffset, result.byteLength));
+        return;
+    }
+    const output = serializeOutput(options.response, result);
+    res.status(status).json(output instanceof Promise ? await output : output);
+}
+/** Whether the request carries a body at all, as body parsers decide it; a bodiless POST is not a 415. */
+function hasBody(req) {
+    return req.get("transfer-encoding") !== undefined || req.get("content-length") !== undefined;
+}
+/** Pipes with backpressure. A client that disconnects mid-stream is normal, not a server error. */
+async function stream(source, res) {
+    try {
+        await pipeline(source, res);
+    }
+    catch (error) {
+        if (!(error instanceof Error && "code" in error && error.code === "ERR_STREAM_PREMATURE_CLOSE"))
+            throw error;
+    }
+}
+/**
+ * Validates every input location onto the handler's context. Synchronous, which is the fast path; only when a
+ * schema has async refinements does validation switch to `safeParseAsync` and return a promise.
+ */
+function parseInto(ctx, req, options) {
+    const params = parseInput(options.params, req.params, "params");
+    const query = parseInput(options.query, req.query, "query");
+    const body = parseInput(options.body, req.body, "body");
+    const headers = parseInput(options.headers, req.headers, "headers");
+    if (params instanceof Pending ||
+        query instanceof Pending ||
+        body instanceof Pending ||
+        headers instanceof Pending) {
+        return settleInto(ctx, params, query, body, headers);
+    }
+    ctx.params = params;
+    ctx.query = query;
+    ctx.body = body;
+    ctx.headers = headers;
+    return undefined;
+}
+async function settleInto(ctx, ...inputs) {
+    const [params, query, body, headers] = await Promise.all(inputs.map(settle));
+    ctx.params = params;
+    ctx.query = query;
+    ctx.body = body;
+    ctx.headers = headers;
+}
+function isController(value) {
+    return typeof value === "object" && value !== null && "mount" in value && typeof value.mount === "function";
+}
+function isSuccessStatus(status) {
+    return Number.isInteger(status) && status >= 200 && status <= 399;
+}
+function isFunction(value) {
+    return typeof value === "function";
+}
+function isOptions(value) {
+    return typeof value === "object" && value !== null;
+}
+/** Joins URL segments into one normalized path: `("/api", "/users/", ":id")` gives `/api/users/:id`. */
+export function joinPath(...parts) {
+    return `/${parts.join("/").split("/").filter(Boolean).join("/")}`;
+}
+//# sourceMappingURL=controller.js.map

package/dist/src/http/controller.js.map

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

package/dist/src/http/error-handler.d.ts

@@ -0,0 +1,86 @@
+import type { ErrorRequestHandler } from "express";
+import type { Logger } from "../config/logger.ts";
+import { type RequestContext } from "./context.ts";
+import { HttpError } from "../errors/http-errors.ts";
+/**
+ * The app's error translation, injectable: turns any error into the status, code, message and details a route
+ * would answer with, `errors.mappers` applied and internal messages hidden. For code outside brisk's routes,
+ * such as GraphQL's `maskError` or WebSocket close codes. Inside a request `inject()` it directly; in a
+ * callback a library fires on its own, resolve it in a class field.
+ *
+ * @example
+ * ```ts
+ * maskError: (error) => {
+ *   const { status, code, message } = inject(ErrorTranslator)(unwrap(error));
+ *   return new GraphQLError(message, { extensions: { code, status } });
+ * },
+ * ```
+ */
+export declare const ErrorTranslator: import("../di/container.ts").InjectionToken<(error: unknown) => {
+    status: number;
+    code: string;
+    message: string;
+    details: unknown;
+}>;
+/**
+ * Turns an error from a library (a database, an SDK) into an HTTP error, or returns `undefined` to leave it.
+ *
+ * @example
+ * ```ts
+ * const uniqueViolation: ErrorMapper = (error) =>
+ *   error instanceof DatabaseError && error.code === "23505" ? new ConflictError("Already exists") : undefined;
+ *
+ * defineApp({ controllers, errors: { mappers: [uniqueViolation] } });
+ * ```
+ */
+export type ErrorMapper = (error: unknown) => HttpError | undefined;
+/**
+ * Builds the body of an error response. The default builds an {@link ErrorResponse}.
+ *
+ * @example
+ * ```ts
+ * const problemJson: ErrorFormatter = (error, ctx) => ({
+ *   type: `https://errors.example.com/${error.code}`,
+ *   title: error.message,
+ *   status: error.status,
+ *   instance: ctx.req.originalUrl,
+ * });
+ *
+ * defineApp({ controllers, errors: { format: problemJson } });
+ * ```
+ */
+export type ErrorFormatter = (error: HttpError, ctx: RequestContext) => unknown;
+export interface ErrorHandlingOptions {
+    mappers: readonly ErrorMapper[];
+    format: ErrorFormatter;
+    exposeInternalErrors: boolean;
+    onError: ((error: unknown, ctx: RequestContext) => void) | undefined;
+}
+/**
+ * The default error body: `{ error: { code, message, details, requestId } }`. Call it from your own formatter
+ * to add fields to the default shape.
+ *
+ * @example
+ * ```ts
+ * const withDocs: ErrorFormatter = (error, ctx) => ({
+ *   ...defaultErrorFormatter(error, ctx),
+ *   docs: `https://docs.example.com/errors/${error.code}`,
+ * });
+ * ```
+ */
+export declare const defaultErrorFormatter: ErrorFormatter;
+/**
+ * Turns every error into a response: classify it, log it by severity, report it to `onError`, then send the
+ * status, headers and body. A mapper, formatter or `onError` hook that throws is logged, never fatal.
+ *
+ * When the response has already started (a handler wrote part of a stream, then threw), the connection is
+ * destroyed instead: ending it normally would hand the client a truncated body that looks complete.
+ */
+export declare function errorHandler(options: ErrorHandlingOptions): ErrorRequestHandler;
+/**
+ * Classifies any error as the HTTP error a client should see: an HttpError as it is, then the mappers, a
+ * ZodError as 400, body-parser and http-errors failures by their status, and anything else as a 500 whose
+ * message is hidden unless `exposeInternalErrors` is on.
+ */
+export declare function toHttpError(error: unknown, options: Omit<ErrorHandlingOptions, "format" | "onError">, log: Logger): HttpError;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/src/http/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/http/error-handler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAEL,SAAS,EAMV,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,sDAClB,OAAO,KAAK;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAGvF,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,GAAG,SAAS,CAAC;AAEpE;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC;AAEhF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACtE;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAElC,CAAC;AAEH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAsB/E;AAWD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,SAAS,CAAC,EACzD,GAAG,EAAE,MAAM,GACV,SAAS,CAgBX"}

package/dist/src/http/error-handler.js

@@ -0,0 +1,147 @@
+import { STATUS_CODES } from "node:http";
+import { z } from "zod";
+import { defineToken } from "../di/container.js";
+import { getContext } from "./context.js";
+import { BadRequestError, HttpError, InternalServerError, PayloadTooLargeError, UnsupportedMediaTypeError, ValidationError, } from "../errors/http-errors.js";
+/**
+ * The app's error translation, injectable: turns any error into the status, code, message and details a route
+ * would answer with, `errors.mappers` applied and internal messages hidden. For code outside brisk's routes,
+ * such as GraphQL's `maskError` or WebSocket close codes. Inside a request `inject()` it directly; in a
+ * callback a library fires on its own, resolve it in a class field.
+ *
+ * @example
+ * ```ts
+ * maskError: (error) => {
+ *   const { status, code, message } = inject(ErrorTranslator)(unwrap(error));
+ *   return new GraphQLError(message, { extensions: { code, status } });
+ * },
+ * ```
+ */
+export const ErrorTranslator = /* @__PURE__ */ defineToken("ErrorTranslator", () => {
+    throw new Error("ErrorTranslator is provided by an app made with defineApp()");
+});
+/**
+ * The default error body: `{ error: { code, message, details, requestId } }`. Call it from your own formatter
+ * to add fields to the default shape.
+ *
+ * @example
+ * ```ts
+ * const withDocs: ErrorFormatter = (error, ctx) => ({
+ *   ...defaultErrorFormatter(error, ctx),
+ *   docs: `https://docs.example.com/errors/${error.code}`,
+ * });
+ * ```
+ */
+export const defaultErrorFormatter = (error, ctx) => ({
+    error: { code: error.code, message: error.message, details: error.details, requestId: ctx.requestId },
+});
+/**
+ * Turns every error into a response: classify it, log it by severity, report it to `onError`, then send the
+ * status, headers and body. A mapper, formatter or `onError` hook that throws is logged, never fatal.
+ *
+ * When the response has already started (a handler wrote part of a stream, then threw), the connection is
+ * destroyed instead: ending it normally would hand the client a truncated body that looks complete.
+ */
+export function errorHandler(options) {
+    return (error, req, res, _next) => {
+        const ctx = getContext(req);
+        const http = toHttpError(error, options, ctx.log);
+        if (http.status >= 500)
+            ctx.log.error({ err: error, code: http.code }, http.message);
+        else
+            ctx.log.debug({ code: http.code, status: http.status }, http.message);
+        try {
+            options.onError?.(error, ctx);
+        }
+        catch (hookError) {
+            ctx.log.error({ err: hookError }, "onError hook failed");
+        }
+        if (res.headersSent) {
+            if (!res.writableEnded)
+                res.destroy();
+            return;
+        }
+        res
+            .status(http.status)
+            .set(http.headers)
+            .json(formatBody(http, ctx, options.format));
+    };
+}
+function formatBody(error, ctx, format) {
+    try {
+        return format(error, ctx);
+    }
+    catch (formatError) {
+        ctx.log.error({ err: formatError }, "formatError failed, sending the default error body");
+        return defaultErrorFormatter(error, ctx);
+    }
+}
+/**
+ * Classifies any error as the HTTP error a client should see: an HttpError as it is, then the mappers, a
+ * ZodError as 400, body-parser and http-errors failures by their status, and anything else as a 500 whose
+ * message is hidden unless `exposeInternalErrors` is on.
+ */
+export function toHttpError(error, options, log) {
+    if (error instanceof HttpError)
+        return error;
+    for (const mapper of options.mappers) {
+        try {
+            const mapped = mapper(error);
+            if (mapped)
+                return mapped;
+        }
+        catch (mapperError) {
+            log.error({ err: mapperError }, "error mapper failed");
+        }
+    }
+    if (error instanceof z.ZodError)
+        return ValidationError.fromZod(error, "input");
+    const parserError = fromBodyParser(error) ?? fromHttpErrors(error);
+    if (parserError)
+        return parserError;
+    const message = options.exposeInternalErrors && error instanceof Error ? error.message : "Internal server error";
+    return new InternalServerError(message, { cause: error });
+}
+/** Errors raised while reading the request body, rewritten so parser internals never reach the client. */
+function fromBodyParser(error) {
+    if (!(error instanceof Error) || !("type" in error) || typeof error.type !== "string")
+        return undefined;
+    switch (error.type) {
+        case "entity.parse.failed":
+            return new BadRequestError("Body must be a valid JSON object or array", {
+                code: "INVALID_JSON",
+                cause: error,
+            });
+        case "entity.too.large":
+            return new PayloadTooLargeError("Request body is too large", { cause: error });
+        case "encoding.unsupported":
+        case "charset.unsupported":
+            return new UnsupportedMediaTypeError(error.message, { cause: error });
+        default:
+            return undefined;
+    }
+}
+/**
+ * Errors from Express middleware that follow the `http-errors` convention: a numeric `status` and a boolean
+ * `expose` (body parsers, `express.static`, many community packages). The status is kept, and the message is
+ * sent only when `expose` is true.
+ *
+ * Errors without `expose` are not trusted: an upstream SDK's `{ status: 404 }` means a call to another
+ * service failed, which is this server's 500, not the client's 404. The one exception is Express's own
+ * `URIError` for an undecodable path parameter, which it marks 400.
+ */
+function fromHttpErrors(error) {
+    if (error instanceof URIError && "status" in error && error.status === 400) {
+        return new BadRequestError("Malformed percent-encoding in the URL", {
+            code: "INVALID_URL",
+            cause: error,
+        });
+    }
+    if (!(error instanceof Error) || !("status" in error) || !("expose" in error))
+        return undefined;
+    const { status, expose } = error;
+    if (typeof status !== "number" || typeof expose !== "boolean" || status < 400 || status > 599)
+        return undefined;
+    return new HttpError(status, expose ? error.message : (STATUS_CODES[status] ?? "Error"), { cause: error });
+}
+//# sourceMappingURL=error-handler.js.map

package/dist/src/http/error-handler.js.map

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

package/dist/src/http/instance.d.ts

@@ -0,0 +1,14 @@
+import { type ProviderEntry } from "../di/container.ts";
+import type { AppInstance, AppOptions, ControllerMap, ListenOptions, StartOptions } from "./app.ts";
+/** An instance with the controls only `defineApp` uses: each instance listens or starts once. */
+export interface Runner<C extends ControllerMap> extends AppInstance<C> {
+    listen(port: number, options: Omit<ListenOptions, "providers">): Promise<void>;
+    start(options: Omit<StartOptions, "providers">): Promise<void>;
+}
+/**
+ * Builds one instance of an app: security headers, request ids and logging, health check and OpenAPI routes,
+ * the app's `use`, controllers (each parsing its own JSON bodies), mounts, 404 and error handling, and the container that runs every
+ * lifecycle hook. `overrides` come after the app's own providers, so they win.
+ */
+export declare function createInstance<C extends ControllerMap>(options: AppOptions<C>, overrides?: readonly ProviderEntry[]): Runner<C>;
+//# sourceMappingURL=instance.d.ts.map

package/dist/src/http/instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.d.ts","sourceRoot":"","sources":["../../../src/http/instance.ts"],"names":[],"mappings":"AAKA,OAAO,EAAwC,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE9F,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,aAAa,EAEb,aAAa,EACb,YAAY,EACb,MAAM,UAAU,CAAC;AAoBlB,iGAAiG;AACjG,MAAM,WAAW,MAAM,CAAC,CAAC,SAAS,aAAa,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IACrE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EACpD,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EACtB,SAAS,GAAE,SAAS,aAAa,EAAO,GACvC,MAAM,CAAC,CAAC,CAAC,CAoPX"}