@decohere/http 0.0.1-dev.125 → 0.0.1-dev.5

package/types/src/http/http.static.d.ts

@@ -1,160 +0,0 @@
-/**
- * Serving a module's built UI from its API (`builder.withStatic`). Everything here is
- * provider-neutral: the options, the caching rules and the missing-directory policy.
- * Only the HTTP provider knows how to put files on the wire. See ADR 0007.
- */
-/** Cache header for files whose name carries a content hash. The name changes when the content does. */
-export declare const STATIC_IMMUTABLE_CACHE_CONTROL = "public, max-age=31536000, immutable";
-/** Cache header for files that must be revalidated on every use (the entry points of a UI). */
-export declare const STATIC_NO_CACHE_CONTROL = "no-cache";
-/** Cache header for every other file: cacheable, but always revalidated (ETag / Last-Modified). */
-export declare const STATIC_DEFAULT_CACHE_CONTROL = "public, max-age=0, must-revalidate";
-/**
- * The entry points of a UI. `index.html` names the hashed bundles, and a module-federation host
- * loads `remoteEntry.js` by a fixed name to find the current remote, so neither can be cached.
- */
-export declare const STATIC_DEFAULT_NO_CACHE: readonly string[];
-/**
- * A build tool's hashed file name: `index-DiwrgTda.js`, `chunk.3f9a8c1b.css`, `app-abc123de.js.map`.
- * The hash is 8 or more letters, digits or `_` after a `-` or `.`, and holds a digit or a lowercase
- * letter followed by an uppercase one. Plain words (`logo-background.png`) are not hashes.
- */
-export declare const STATIC_DEFAULT_IMMUTABLE: RegExp;
-export type StaticOptions = {
-    /**
-     * Serve `index.html` for an unknown path under the prefix, so a client-side route survives a
-     * reload. Only for GET and HEAD, and never for a path that looks like a file (has an
-     * extension), so a missing asset stays a 404. Defaults to `true`.
-     */
-    spaFallback?: boolean;
-    /**
-     * Path patterns this mount never answers, neither a file nor the fallback: the request gets the
-     * normal JSON 404. Globs on the full request path (not relative to the prefix), for example
-     * `["/api/**", "/docs/**"]`: `*` is any run of characters inside one segment, `**` crosses
-     * segments, `?` is one character. `/api/**` also covers `/api` itself. Rarely needed: a path
-     * that starts with the first segment of a registered controller route is already never
-     * answered with the fallback (see `staticFiles.isUnderRoute`).
-     */
-    exclude?: string[];
-    /** The file served for the prefix itself and for the fallback. Defaults to `index.html`. */
-    index?: string;
-    /**
-     * Files sent with `Cache-Control: no-cache`, by file name (`index.html`) or by path relative to
-     * the directory (`remote/remoteEntry.js`). Replaces the default `["index.html", "remoteEntry.js"]`,
-     * so list `index.html` again if you override it.
-     */
-    noCache?: string[];
-    /**
-     * Files whose name holds a content hash get `public, max-age=31536000, immutable`. Replace the
-     * pattern if your build names files differently (it is tested against the path relative to the
-     * directory), or pass `false` to give no file the immutable header.
-     */
-    immutable?: RegExp | false;
-    /** `Cache-Control` for every other file. Defaults to `public, max-age=0, must-revalidate`. */
-    cacheControl?: string;
-    /**
-     * What to do when the directory does not exist at start. `"fail"` stops the app with an error;
-     * `"warn"` logs a warning and serves nothing, so the API still boots before the UI is built.
-     * Defaults to `"warn"` when NODE_ENV is `development` or `dev`, and to `"fail"` otherwise.
-     */
-    onMissingDirectory?: "fail" | "warn";
-};
-/** A `withStatic` call, as the builder keeps it. */
-export type StaticMount = {
-    /** Normalised: starts and ends with `/`, for example `/ui/`. */
-    prefix: string;
-    /** As given by the caller, resolved from the process working directory when the app starts. */
-    directory: string;
-    options: StaticOptions;
-};
-/** A mount the provider can register: the directory exists and every option has its value. */
-export type ResolvedStaticMount = {
-    prefix: string;
-    /** Absolute path of the directory. */
-    root: string;
-    spaFallback: boolean;
-    index: string;
-    noCache: readonly string[];
-    immutable: RegExp | false;
-    cacheControl: string;
-    exclude: readonly string[];
-};
-declare function toMount(prefix: string, directory: string, options?: StaticOptions): StaticMount;
-type DirectoryProbe = (absolutePath: string) => Promise<boolean>;
-export type ResolveStaticOptions = {
-    /** Where relative directories are resolved from. Defaults to the process working directory. */
-    cwd?: string;
-    nodeEnv?: string;
-    directoryExists: DirectoryProbe;
-    warn: (message: string) => void;
-};
-/**
- * Checks every mount at start. Returns the ones that can be served; a missing directory fails or
- * warns according to the mount's `onMissingDirectory`. Two mounts on one prefix always fail.
- */
-declare function resolve(mounts: readonly StaticMount[], env: ResolveStaticOptions): Promise<ResolvedStaticMount[]>;
-/** `Cache-Control` for a file, given its path relative to the mount's directory. */
-declare function cacheControlFor(mount: ResolvedStaticMount, relativePath: string): string;
-/**
- * Does this path look like a file: an extension on the last segment, or a dotfile anywhere?
- * Then a miss is a real 404, not a client-side route.
- */
-declare function looksLikeFile(pathname: string): boolean;
-/** The request path as the mount sees it: no query, decoded, repeated slashes collapsed. */
-declare function normalizePathname(url: string): string;
-/** Builds the test for a mount's `exclude` patterns. Matches on the normalised path. */
-declare function excluder(patterns: readonly string[]): (pathname: string) => boolean;
-/**
- * The first path segment of every registered route, for {@link isUnderRoute}. A segment that is a
- * parameter or wildcard (`:id`, `*`) says nothing about the path and is skipped.
- */
-declare function routeSegments(routePaths: Iterable<string>): Set<string>;
-/**
- * Is this path under one of the app's own routes? True when its first segment is the first
- * segment of a registered route: with a controller route `/lp/portfolio`, `/lp/portfolo` and
- * `/lp/anything/else` belong to the API and keep the JSON 404, while `/lpx` does not.
- */
-declare function isUnderRoute(pathname: string, segments: ReadonlySet<string>): boolean;
-/**
- * What the fallback treats as the API, as a test on the normalised path. With a global prefix it
- * is the prefix, the OpenAPI path and every route left outside the prefix
- * (`@Controller({ globalPrefix: false })`, such as `/health`), each with the paths below it, so a
- * client route may share a first segment with a controller. Without a prefix it is
- * {@link isUnderRoute} (the first segment of every registered route), the safe guess when nothing
- * says where the API lives.
- */
-declare function apiBoundary(boundary: {
-    /** Normalised global prefix (`/api`), or `""` when there is none. */
-    globalPrefix: string;
-    openApiPath?: string;
-    /** Every registered route path, global prefix included. */
-    routePaths: Iterable<string>;
-}): (pathname: string) => boolean;
-/** Does the `Accept` header ask for HTML (a browser navigation)? `text/html;q=0` does not. */
-declare function acceptsHtml(accept: string | undefined): boolean;
-export type FallbackRequest = {
-    method: string;
-    /** Normalised, see `normalizePathname`. */
-    pathname: string;
-    accept: string | undefined;
-};
-/**
- * Should an unknown path get the app's `index.html`? Only a browser navigation: GET or HEAD, no
- * file extension and no dotfile in the path, an `Accept` that includes `text/html`, and not under
- * the API (see {@link apiBoundary}). Everything else keeps the normal JSON 404.
- */
-declare function shouldFallBack(request: FallbackRequest, belongsToApi: (pathname: string) => boolean): boolean;
-export declare const staticFiles: {
-    toMount: typeof toMount;
-    resolve: typeof resolve;
-    cacheControlFor: typeof cacheControlFor;
-    looksLikeFile: typeof looksLikeFile;
-    normalizePathname: typeof normalizePathname;
-    excluder: typeof excluder;
-    routeSegments: typeof routeSegments;
-    isUnderRoute: typeof isUnderRoute;
-    apiBoundary: typeof apiBoundary;
-    acceptsHtml: typeof acceptsHtml;
-    shouldFallBack: typeof shouldFallBack;
-};
-export {};

package/types/src/index.d.ts

@@ -1,10 +0,0 @@
-export type { StartOptions } from "./app/index.js";
-export * from "./app/index.js";
-export * from "./auth/index.js";
-export * from "./builder/index.js";
-export * from "./const.js";
-export * from "./health/index.js";
-export * from "./hosting/index.js";
-export * from "./openapi/index.js";
-export * from "./routing/index.js";
-export * from "./sse/index.js";

package/types/src/openapi/index.d.ts

@@ -1,6 +0,0 @@
-export type { ValidationIssue } from "../routing/anvil.types.js";
-export { generateOpenApiDocument, resolveOpenApiPath, toOpenApiPath, } from "./openapi.generator.js";
-export type { JsonSchema, OpenApiDocument, OpenApiOperation, OpenApiOptions, OpenApiParameter, } from "./openapi.types.js";
-export type { RouteRequestSchemas } from "./request-schema.js";
-export { buildRouteRequestSchemas, mergeObjectSchemas, objectArgToParts, pathParamsToSchema, typeToSchema, } from "./request-schema.js";
-export { ValidationError, validateRequest } from "./request-validator.js";

package/types/src/openapi/openapi.generator.d.ts

@@ -1,6 +0,0 @@
-import type { RouteRegistry } from "../routing/services/route-registry.js";
-import type { OpenApiDocument, OpenApiOptions } from "./openapi.types.js";
-export declare function resolveOpenApiPath(options: OpenApiOptions): string;
-/** Convert Fastify-style `:id` path params to OpenAPI `{id}`. */
-export declare function toOpenApiPath(fastifyPath: string): string;
-export declare function generateOpenApiDocument(registry: RouteRegistry, options: OpenApiOptions): OpenApiDocument;

package/types/src/openapi/openapi.types.d.ts

@@ -1,58 +0,0 @@
-export type OpenApiInfo = {
-    title: string;
-    version: string;
-    description?: string;
-};
-export type OpenApiServer = {
-    url: string;
-    description?: string;
-};
-export type OpenApiOptions = {
-    /** Defaults to `/openapi.json`. Absolute Fastify path (not affected by globalPrefix). */
-    path?: string;
-    info: OpenApiInfo;
-    servers?: OpenApiServer[];
-    /** When true (default), validate request params/query/body before the handler. */
-    validateRequests?: boolean;
-};
-export type JsonSchema = {
-    type?: string;
-    properties?: Record<string, JsonSchema>;
-    required?: string[];
-    items?: JsonSchema;
-    additionalProperties?: boolean | JsonSchema;
-    format?: string;
-    description?: string;
-    minLength?: number;
-    maxLength?: number;
-};
-export type OpenApiParameter = {
-    name: string;
-    in: "query" | "path" | "header" | "cookie";
-    required?: boolean;
-    schema?: JsonSchema;
-};
-export type OpenApiOperation = {
-    operationId?: string;
-    summary?: string;
-    tags?: string[];
-    parameters?: OpenApiParameter[];
-    requestBody?: {
-        required?: boolean;
-        content: Record<string, {
-            schema: JsonSchema;
-        }>;
-    };
-    responses: Record<string, {
-        description: string;
-        content?: Record<string, {
-            schema: JsonSchema;
-        }>;
-    }>;
-};
-export type OpenApiDocument = {
-    openapi: "3.0.3";
-    info: OpenApiInfo;
-    servers?: OpenApiServer[];
-    paths: Record<string, Partial<Record<string, OpenApiOperation>>>;
-};

package/types/src/openapi/request-schema.d.ts

@@ -1,21 +0,0 @@
-import { type MappedRoute, type RouteArg } from "../routing/anvil.types.js";
-import type { JsonSchema, OpenApiParameter } from "./openapi.types.js";
-/**
- * Request shapes derived from route / `@Field` metadata (same source as OpenAPI).
- * Used by the document generator and the AJV request validator.
- */
-export type RouteRequestSchemas = {
-    queryParams: OpenApiParameter[];
-    pathParams: OpenApiParameter[];
-    body?: JsonSchema;
-};
-export declare function buildRouteRequestSchemas(route: MappedRoute): RouteRequestSchemas;
-export declare function objectArgToParts(routeArg: RouteArg): {
-    queryParams: OpenApiParameter[];
-    pathParams: OpenApiParameter[];
-    body?: JsonSchema;
-};
-export declare function mergeObjectSchemas(a: JsonSchema | undefined, b: JsonSchema): JsonSchema;
-export declare function typeToSchema(typeName?: string): JsonSchema;
-/** JSON Schema object for required path params (HTTP path values are always strings). */
-export declare function pathParamsToSchema(params: OpenApiParameter[]): JsonSchema | undefined;

package/types/src/openapi/request-validator.d.ts

@@ -1,9 +0,0 @@
-import type { HttpRequest, MappedRoute, ValidationIssue } from "../routing/anvil.types.js";
-import { ValidationError } from "../routing/anvil.types.js";
-export type { ValidationIssue };
-export { ValidationError };
-/**
- * Fail-closed request validation from route / OpenAPI / `@Field` metadata.
- * Uses AJV against the same schemas as the OpenAPI generator (no type coercion).
- */
-export declare function validateRequest(route: MappedRoute, request: HttpRequest): void;

package/types/src/providers/fastify.provider.d.ts

@@ -1,56 +0,0 @@
-import { type FastifyInstance } from "fastify";
-import type { HttpOptions } from "../http/http.options.js";
-import { type HttpProvider, type StartOptions, type StartResponse, type StopResponse } from "../routing/anvil.types.js";
-import { type ExceptionFilterHost } from "../routing/filters/exception-filter-host.js";
-import type { RouteRegistry } from "../routing/services/route-registry.js";
-import type { Router } from "../routing/services/router.js";
-export declare class FastifyProvider implements HttpProvider {
-    readonly provider: FastifyInstance;
-    readonly router: Router;
-    private readonly routeRegistry;
-    private readonly httpOptions?;
-    private readonly exceptionFilterHost?;
-    private closing;
-    private readonly logger;
-    /** One per live `@Sse()` request, so stopping the app can end the streams. */
-    private readonly openStreams;
-    constructor(routeRegistry?: RouteRegistry, router?: Router, httpOptions?: HttpOptions, exceptionFilterHost?: ExceptionFilterHost);
-    start<T extends StartOptions>(options?: T): Promise<StartResponse>;
-    stop(): Promise<StopResponse>;
-    [Symbol.asyncDispose](): Promise<void>;
-    /**
-     * Once stopping, tell clients to drop the connection after their response. Otherwise
-     * a request that was in flight leaves a kept-alive socket that holds `close()` open
-     * until Node's keep-alive timeout (5s).
-     */
-    private closeConnectionsWhileStopping;
-    get addresses(): string[];
-    private registerHelmet;
-    private registerRateLimit;
-    private resolveStatics;
-    /**
-     * One encapsulated context per mount: its not-found handler (the SPA fallback) applies to
-     * paths under the prefix and nowhere else, so an API 404 is never answered with the UI.
-     */
-    private registerStatic;
-    /** What the static fallback leaves to the API: the global prefix, else the registered routes. ADR 0007. */
-    private apiBoundary;
-    /**
-     * `@fastify/compress` with best-practice defaults; the plugin owns the policy. Registered
-     * before any route so every response goes through it, errors and static files included.
-     * `providerOptions` is merged last, so a user can override any plugin option.
-     */
-    private registerCompression;
-    private registerCors;
-    private registerOpenApi;
-    private registerAllRoutes;
-    private routeRequest;
-    /**
-     * Gives the handler a signal that aborts when the client goes away before the response
-     * finished. Streams are also tracked so that stopping the app can abort them.
-     */
-    private abortOnDisconnect;
-    private sendEventStream;
-    private applyResponseHeaders;
-    private fastifyToRequest;
-}

package/types/src/routing/anvil.types.d.ts

@@ -1,119 +0,0 @@
-import type { Constructable, Type } from "@decohere/core/reflection";
-import type { HTTPMethod } from "../const.js";
-import type { SseOptions } from "../sse/sse.types.js";
-import type { Pipe } from "./pipes/pipes.js";
-export type Metadata = "controller" | "route" | "parameter" | "fieldMap" | "authorize" | "allowAnonymous" | "httpCode" | "headers" | "catch";
-export type CorsOptions = {
-    origin?: boolean | string | string[];
-    methods?: string[];
-    allowedHeaders?: string[];
-    exposedHeaders?: string[];
-    credentials?: boolean;
-    maxAge?: number;
-};
-export declare const RequestParts: {
-    query: "query";
-    params: "params";
-    body: "body";
-    principal: "principal";
-    signal: "signal";
-    lastEventId: "lastEventId";
-};
-export interface HttpProvider {
-    start<T extends StartOptions>(options: T): Promise<StartResponse>;
-    stop(): Promise<StopResponse>;
-    [Symbol.asyncDispose](): Promise<void>;
-}
-export type RequestPart = "query" | "params" | "body" | "principal" | "signal" | "lastEventId";
-/** Argument locations filled by the HTTP package itself rather than read from the request payload. */
-export declare const InjectedParts: readonly RequestPart[];
-export type MappedRoute = {
-    key: string;
-    controller: Constructable;
-    handler: string;
-    routeArgs?: RouteArg[];
-    httpCode?: number;
-    headers?: Record<string, string>;
-    /** Set by `@Sse()`: the handler returns a stream of events instead of a single response. */
-    sse?: SseOptions;
-} & RouteMetadata;
-export type RouteArg = {
-    argumentType: Constructable;
-    fieldMap?: Map<string, FieldMeta>;
-    pipes?: Constructable<Pipe>[];
-} & ArgumentMeta;
-export declare class HttpRequest {
-    constructor(data?: Partial<HttpRequest>);
-    requestId: string;
-    url: string;
-    method: string;
-    params: Record<string, string>;
-    query: Record<string, string>;
-    body: unknown;
-    headers: Record<string, string>;
-    /** Aborts when the client disconnects or the app stops. Never aborts if the provider cannot tell. */
-    signal: AbortSignal;
-    /** Outbound headers set by middleware; applied by the HTTP provider. */
-    responseHeaders: Record<string, string>;
-}
-export type StartResponse = {
-    addresses: string[];
-};
-export type StopResponse = {
-    message: string;
-};
-export type StartOptions = {
-    port: number;
-    host?: string;
-};
-export type ArgumentMeta = {
-    argumentIndex: number;
-    mappingKey?: string;
-    argumentLocation?: RequestPart;
-    pipes: Constructable<Pipe>[];
-};
-export type ControllerMetadata = {
-    prefix: string;
-    /**
-     * `false` leaves this controller's routes out of the global prefix (`withGlobalPrefix`), for
-     * paths something outside the app expects at a fixed place: probes, webhooks, metrics. Default
-     * `true`.
-     */
-    globalPrefix?: boolean;
-};
-export type FieldMeta = {
-    fieldKey: string;
-    fieldType: Type;
-    mappingKey: string;
-    fieldLocation?: RequestPart;
-    pipes?: Constructable<Pipe>[];
-};
-export type RouteMetadata = {
-    path: string;
-    method: HTTPMethod;
-};
-export declare class RouteConfigurationError extends Error {
-}
-export declare class RoutingError extends Error {
-}
-export declare class TransformError extends Error {
-}
-export declare class HttpError extends Error {
-    readonly status: number;
-    constructor(message: string, status: number);
-}
-export declare class UnauthorizedError extends HttpError {
-    constructor(message?: string);
-}
-export declare class ForbiddenError extends HttpError {
-    constructor(message?: string);
-}
-export type ValidationIssue = {
-    path: string;
-    message: string;
-    keyword?: string;
-};
-export declare class ValidationError extends HttpError {
-    readonly errors: ValidationIssue[];
-    constructor(message?: string, errors?: ValidationIssue[]);
-}

package/types/src/routing/decorators/argument.decorator.d.ts

@@ -1,11 +0,0 @@
-import type { Constructable } from "@decohere/core/reflection";
-import { type RequestPart } from "../anvil.types.js";
-import type { Pipe } from "../pipes/pipes.js";
-export type ArgumentOptions = {
-    mappingKey?: string;
-    argumentLocation?: RequestPart;
-    pipes?: Constructable<Pipe>[];
-};
-export declare function Query(key: string): (target: object, functionName: string, argumentIndex: number) => void;
-export declare function Param(key: string): (target: object, functionName: string, argumentIndex: number) => void;
-export declare function Argument(options: ArgumentOptions): (target: object, functionName: string, argumentIndex: number) => void;

package/types/src/routing/decorators/auth.decorator.d.ts

@@ -1,30 +0,0 @@
-import type { Constructable } from "@decohere/core/reflection";
-export type AuthorizeOptions = {
-    action: string;
-    subject: string;
-};
-/**
- * Require the principal to be able to perform `action` on `subject`.
- * Uses an IAuthorizationService (e.g. CaslAuthorizationService) registered in DI.
- * When applied to a class, all methods inherit the constraint.
- * When applied to a method, it takes precedence over the class-level decorator.
- *
- * @example
- * \@Authorize("delete", "Article")
- * \@Authorize("manage", "all")
- */
-export declare function Authorize(action: string, subject?: string): (target: object | Constructable, methodName?: string, _descriptor?: PropertyDescriptor) => void;
-/**
- * Opt a specific route method out of authentication, even when the controller
- * class is decorated with @Authorize.
- */
-export declare function AllowAnonymous(): (target: object, methodName: string, _descriptor?: PropertyDescriptor) => void;
-/** Read the effective @Authorize options for a handler function. */
-export declare function getAuthorizeOptions(controllerPrototype: object, handlerFn: object): AuthorizeOptions | undefined;
-/** Returns true only when the handler is explicitly marked @AllowAnonymous. */
-export declare function isAllowAnonymous(_controllerPrototype: object, handlerFn: object): boolean;
-/**
- * Parameter decorator — injects the authenticated Principal into this argument.
- * The argument resolver will supply the principal verified during the auth step.
- */
-export declare function CurrentUser(): (target: object, propertyKey: string, parameterIndex: number) => void;

package/types/src/routing/decorators/controller.decorator.d.ts

@@ -1,3 +0,0 @@
-import type { Constructable } from "@decohere/core/reflection";
-import type { ControllerMetadata } from "../anvil.types.js";
-export declare function Controller(options?: ControllerMetadata): (target: Constructable) => void;

package/types/src/routing/decorators/field.decorator.d.ts

@@ -1,2 +0,0 @@
-import type { RequestPart } from "../anvil.types.js";
-export declare function Field(fieldLocation?: RequestPart, mappingKey?: string): (target: object, fieldName: string) => void;

package/types/src/routing/decorators/request.decorator.d.ts

@@ -1,8 +0,0 @@
-import type { Constructable } from "@decohere/core/reflection";
-import type { RequestPart } from "../anvil.types.js";
-/**
- * Used to map a request object to route params
- * @param mappingKey
- * @returns
- */
-export declare function Request(mappingKey?: RequestPart): (target: Constructable) => void;

package/types/src/routing/decorators/response.decorator.d.ts

@@ -1,4 +0,0 @@
-/** Set the HTTP status code returned on a successful handler response. */
-export declare function HttpCode(statusCode: number): (_target: object, _methodName: string, descriptor: PropertyDescriptor) => void;
-/** Set a response header on a successful handler response. Stackable. */
-export declare function Header(name: string, value: string): (_target: object, _methodName: string, descriptor: PropertyDescriptor) => void;

package/types/src/routing/decorators/route.decorator.d.ts

@@ -1,7 +0,0 @@
-import { type HTTPMethod } from "../../const.js";
-export declare function Get(path?: string): (targetClass: object, functionName: string, descriptor?: TypedPropertyDescriptor<(...args: any[]) => any>) => void;
-export declare function Post(path?: string): (targetClass: object, functionName: string, descriptor?: TypedPropertyDescriptor<(...args: any[]) => any>) => void;
-export declare function Put(path?: string): (targetClass: object, functionName: string, descriptor?: TypedPropertyDescriptor<(...args: any[]) => any>) => void;
-export declare function Patch(path?: string): (targetClass: object, functionName: string, descriptor?: TypedPropertyDescriptor<(...args: any[]) => any>) => void;
-export declare function Delete(path?: string): (targetClass: object, functionName: string, descriptor?: TypedPropertyDescriptor<(...args: any[]) => any>) => void;
-export declare function Route(method: HTTPMethod, path?: string): (targetClass: object, functionName: string, descriptor?: TypedPropertyDescriptor<(...args: any[]) => any>) => void;

package/types/src/routing/filters/exception-filter-host.d.ts

@@ -1,19 +0,0 @@
-import { type LifetimeScope } from "@decohere/crucible";
-import type { HttpOptions } from "../../http/http.options.js";
-import { type ExceptionContext, type ExceptionFilter, type ExceptionResult } from "./exception-filter.js";
-export declare class DefaultHttpExceptionFilter implements ExceptionFilter {
-    private readonly logger;
-    catch(error: unknown, _ctx: ExceptionContext): ExceptionResult;
-}
-/**
- * Resolves the first matching filter for an error.
- * Custom filters (registered via builder) are tried first; default is last.
- */
-export declare class ExceptionFilterHost {
-    private readonly options?;
-    private readonly scope?;
-    private filters?;
-    constructor(options?: HttpOptions, scope?: LifetimeScope);
-    handle(error: unknown, ctx: ExceptionContext): Promise<ExceptionResult>;
-    private getFilters;
-}

package/types/src/routing/filters/exception-filter.d.ts

@@ -1,16 +0,0 @@
-import type { Constructable } from "@decohere/core/reflection";
-import type { HttpRequest } from "../anvil.types.js";
-export type ExceptionResult = {
-    status: number;
-    body: unknown;
-    headers?: Record<string, string>;
-};
-export type ExceptionContext = {
-    request: HttpRequest;
-};
-export interface ExceptionFilter {
-    catch(error: unknown, ctx: ExceptionContext): ExceptionResult | Promise<ExceptionResult>;
-}
-/** Declare which error types this filter handles. Empty = catch-all. */
-export declare function Catch(...types: Constructable[]): (target: Constructable) => void;
-export declare function getCatchTypes(filterType: Constructable): Constructable[];

package/types/src/routing/middleware/http-access-log.middleware.d.ts

@@ -1,8 +0,0 @@
-import type { Middleware, MiddlewareContext } from "./middleware.js";
-/**
- * Echoes `x-request-id` on the response and writes an HTTP access line via Scribe
- * (method, path, status, durationMs, requestId). Enabled by default through `withHttp`.
- */
-export declare class HttpAccessLogMiddleware implements Middleware {
-    use(ctx: MiddlewareContext, next: () => Promise<unknown>): Promise<unknown>;
-}

package/types/src/routing/middleware/middleware.d.ts

@@ -1,10 +0,0 @@
-import type { HttpRequest, MappedRoute } from "../anvil.types.js";
-export type MiddlewareContext = {
-    request: HttpRequest;
-    route: MappedRoute;
-};
-export interface Middleware {
-    use(ctx: MiddlewareContext, next: () => Promise<unknown>): Promise<unknown>;
-}
-/** Compose middleware around a terminal handler; returns the handler result. */
-export declare function composeMiddleware(middlewares: Middleware[], handler: () => Promise<unknown>, ctx: MiddlewareContext): Promise<unknown>;

package/types/src/routing/middleware/request-id.d.ts

@@ -1,6 +0,0 @@
-/** Canonical inbound/outbound request id header (lowercase). */
-export declare const REQUEST_ID_HEADER = "x-request-id";
-/**
- * Prefer an inbound `x-request-id`, then an existing id, otherwise generate one.
- */
-export declare function resolveRequestId(headers: Record<string, string>, fallback?: string): string;

package/types/src/routing/path.util.d.ts

@@ -1,9 +0,0 @@
-/** Normalize a prefix to `/foo` form with no trailing slash. Empty → `""`. */
-export declare function normalizePrefix(prefix: string | undefined | null): string;
-/**
- * Join a controller prefix with a method-relative route path.
- * Preserves `@Get("/")` trailing-slash semantics (`/hello` + `/` → `/hello/`).
- */
-export declare function joinRoutePath(prefix: string, routePath: string): string;
-/** Prepend a global prefix onto an already-joined controller route path. */
-export declare function applyGlobalPrefix(globalPrefix: string, path: string): string;

package/types/src/routing/pipes/pipes.d.ts

@@ -1,21 +0,0 @@
-import type { Type } from "@decohere/core/reflection";
-export type PipeContext = {
-    fieldTypes: Record<string, Type>;
-};
-export declare abstract class Pipe<T = unknown> {
-    abstract transform(value: unknown, context?: PipeContext): T;
-}
-export declare class BooleanPipe extends Pipe<boolean> {
-    transform(value: unknown, _context?: unknown): boolean;
-}
-export declare class DatePipe extends Pipe<Date> {
-    transform(value: unknown, _context?: unknown): Date;
-}
-export declare class JsonPipe extends Pipe<object> {
-    transform(value: string, context?: PipeContext): object;
-    private reviver;
-}
-export declare class NumberPipe extends Pipe<number> {
-    /** Finite numbers only. Blank or non-numeric input is a 400, not `undefined` (#503). */
-    transform(value: unknown, _context?: unknown): number;
-}

package/types/src/routing/services/route-argument-resolver.d.ts

@@ -1,10 +0,0 @@
-import type { IPrincipalProvider } from "../../auth/principal-provider.js";
-import type { HttpRequest, RouteArg } from "../anvil.types.js";
-export declare class RouteArgumentResolve {
-    resolveArguments(httpRequest: HttpRequest, routeArgs: RouteArg[], principalProvider?: IPrincipalProvider): any[];
-    private getValue;
-    private mapPrimitive;
-    private mapObject;
-    private transform;
-    private pipeContext;
-}