@fluojs/http 1.0.0-beta.1

package/dist/types.d.ts

@@ -0,0 +1,274 @@
+import type { Constructor, MaybePromise, MetadataPropertyKey, MetadataSource, Token } from '@fluojs/core';
+import type { RequestScopeContainer } from '@fluojs/di';
+export type { ValidationIssue, Validator } from '@fluojs/validation';
+/** HTTP methods understood by Fluo route metadata and dispatcher matching. */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD' | 'ALL';
+/** Strategies that decide how versioned HTTP routes are selected for one request. */
+export declare enum VersioningType {
+    URI = "URI",
+    HEADER = "HEADER",
+    MEDIA_TYPE = "MEDIA_TYPE",
+    CUSTOM = "CUSTOM"
+}
+/**
+ * Adapter-normalized incoming request passed through the HTTP pipeline.
+ *
+ * Runtime adapters populate this shape so decorators, binders, guards, and
+ * middleware can reason about one stable contract instead of platform-specific
+ * request objects.
+ */
+export interface FrameworkRequest {
+    method: HttpMethod | string;
+    path: string;
+    url: string;
+    headers: Readonly<Record<string, string | string[] | undefined>>;
+    query: Readonly<Record<string, string | string[] | undefined>>;
+    cookies: Readonly<Record<string, string | undefined>>;
+    params: Readonly<Record<string, string>>;
+    body?: unknown;
+    rawBody?: Uint8Array;
+    raw: unknown;
+    signal?: AbortSignal;
+}
+/**
+ * Adapter-normalized mutable response facade shared across dispatch stages.
+ *
+ * Dispatch policies write headers, status, redirects, and bodies through this
+ * contract before the underlying platform commits the response.
+ */
+export interface FrameworkResponse {
+    compression?: FrameworkResponseCompression;
+    statusCode?: number;
+    statusSet?: boolean;
+    headers: Record<string, string | string[]>;
+    committed: boolean;
+    raw?: unknown;
+    stream?: FrameworkResponseStream;
+    setStatus(code: number): void;
+    setHeader(name: string, value: string | string[]): void;
+    redirect(status: number, location: string): void;
+    send(body: unknown): MaybePromise<void>;
+}
+/** Compression writer used when a platform can stream encoded response bodies. */
+export interface FrameworkResponseCompression {
+    write(body: Uint8Array, options?: FrameworkResponseCompressionWriteOptions): MaybePromise<boolean>;
+}
+/** Additional metadata passed to a response compression writer. */
+export interface FrameworkResponseCompressionWriteOptions {
+    contentType?: string;
+}
+/**
+ * Low-level streaming handle used by SSE and other incremental response flows.
+ */
+export interface FrameworkResponseStream {
+    readonly closed: boolean;
+    close(): void;
+    flush?(): void;
+    onClose?(listener: () => void): (() => void) | void;
+    waitForDrain?(): Promise<void>;
+    write(chunk: string | Uint8Array): boolean;
+}
+/** Serializer used during response content negotiation. */
+export interface ResponseFormatter {
+    readonly mediaType: string;
+    format(body: unknown): string | Buffer;
+}
+/** Response negotiation settings applied to one route or dispatcher instance. */
+export interface ContentNegotiationOptions {
+    defaultMediaType?: string;
+    formatters?: ResponseFormatter[];
+}
+/** Authenticated caller identity attached to the active request context. */
+export interface Principal {
+    subject: string;
+    issuer?: string;
+    audience?: string | string[];
+    roles?: string[];
+    scopes?: string[];
+    claims: Record<string, unknown>;
+}
+/**
+ * Per-request execution context shared across binding, guards, interceptors,
+ * and controller handlers.
+ */
+export interface RequestContext {
+    request: FrameworkRequest;
+    response: FrameworkResponse;
+    requestId?: string;
+    principal?: Principal;
+    metadata: Record<string | symbol, unknown>;
+    container: RequestScopeContainer;
+}
+/** Typed metadata key used to store request-scoped values safely. */
+export interface ContextKey<T> {
+    readonly id: symbol;
+    readonly description: string;
+    readonly __type?: T;
+}
+/** Controller method signature after DTO binding and request-context injection. */
+export type ControllerHandler<Input = unknown, Result = unknown> = (input: Input, ctx: RequestContext) => MaybePromise<Result>;
+/**
+ * Route-level behavioral metadata collected from HTTP decorators.
+ */
+export interface RouteDefinition {
+    method: HttpMethod;
+    path: string;
+    produces?: string[];
+    request?: Constructor;
+    guards?: GuardLike[];
+    headers?: {
+        name: string;
+        value: string;
+    }[];
+    interceptors?: InterceptorLike[];
+    redirect?: {
+        url: string;
+        statusCode?: number;
+    };
+    successStatus?: number;
+    version?: string;
+}
+/** Derived metadata used while mapping controllers into dispatchable handlers. */
+export interface HandlerMetadata {
+    controllerPath: string;
+    effectivePath: string;
+    effectiveVersion?: string;
+    moduleMiddleware: MiddlewareLike[];
+    moduleType?: Constructor;
+    pathParams: string[];
+}
+/** Fully resolved controller handler descriptor stored in handler mappings. */
+export interface HandlerDescriptor {
+    controllerToken: Constructor;
+    metadata: HandlerMetadata;
+    methodName: string;
+    route: RouteDefinition;
+}
+/** Result returned when request matching resolves one handler and path params. */
+export interface HandlerMatch {
+    descriptor: HandlerDescriptor;
+    params: Readonly<Record<string, string>>;
+}
+/** Immutable lookup table that matches incoming requests to controller handlers. */
+export interface HandlerMapping {
+    readonly descriptors: HandlerDescriptor[];
+    match(request: FrameworkRequest): HandlerMatch | undefined;
+}
+/** Source module/controller pair used to build a handler mapping. */
+export interface HandlerSource {
+    controllerToken: Constructor;
+    moduleMiddleware?: MiddlewareLike[];
+    moduleType?: Constructor;
+}
+/** Candidate version values returned by a custom version extractor. */
+export type VersioningExtractorResult = string | readonly string[] | undefined;
+/** Callback that extracts route version candidates from one framework request. */
+export type VersioningExtractor = (request: FrameworkRequest) => VersioningExtractorResult;
+/**
+ * Versioning configuration shared by dispatcher and route-mapping policies.
+ */
+export type VersioningOptions = {
+    type?: VersioningType.URI;
+} | {
+    type: VersioningType.HEADER;
+    header: string;
+} | {
+    type: VersioningType.MEDIA_TYPE;
+    key?: string;
+} | {
+    type: VersioningType.CUSTOM;
+    extractor: VersioningExtractor;
+};
+/** Runtime dispatcher that executes the full HTTP request lifecycle. */
+export interface Dispatcher {
+    dispatch(request: FrameworkRequest, response: FrameworkResponse): Promise<void>;
+}
+/** Logger seam used by the dispatcher for non-fatal internal failure reporting. */
+export interface DispatcherLogger {
+    error(message: string, error?: unknown, context?: string): void;
+}
+/** Observation payload delivered to request observers throughout one dispatch. */
+export interface RequestObservationContext {
+    handler?: HandlerDescriptor;
+    requestContext: RequestContext;
+}
+/** Continuation callback that advances middleware or interceptor execution. */
+export type Next = () => Promise<void>;
+/** Input passed to one middleware invocation. */
+export interface MiddlewareContext {
+    request: FrameworkRequest;
+    requestContext: RequestContext;
+    response: FrameworkResponse;
+}
+/** Request pipeline middleware contract. */
+export interface Middleware {
+    handle(context: MiddlewareContext, next: Next): MaybePromise<void>;
+}
+/** Declarative middleware binding for selected route patterns. */
+export interface MiddlewareRouteConfig {
+    middleware: Constructor<Middleware>;
+    routes: string[];
+}
+/** Guard execution context for one matched handler invocation. */
+export interface GuardContext {
+    handler: HandlerDescriptor;
+    requestContext: RequestContext;
+}
+/** Authorization or precondition contract evaluated before handler execution. */
+export interface Guard {
+    canActivate(context: GuardContext): MaybePromise<void | boolean>;
+}
+/** Lazy handle that lets interceptors continue into the next execution stage. */
+export interface CallHandler {
+    handle(): Promise<unknown>;
+}
+/** Interceptor execution context for one matched handler. */
+export interface InterceptorContext {
+    handler: HandlerDescriptor;
+    requestContext: RequestContext;
+}
+/** Around-invocation hook for transforming handler input, output, or errors. */
+export interface Interceptor {
+    intercept(context: InterceptorContext, next: CallHandler): MaybePromise<unknown>;
+}
+/** Lifecycle observer notified as one request moves through dispatch stages. */
+export interface RequestObserver {
+    onHandlerMatched?(context: RequestObservationContext): MaybePromise<void>;
+    onRequestError?(context: RequestObservationContext, error: unknown): MaybePromise<void>;
+    onRequestFinish?(context: RequestObservationContext): MaybePromise<void>;
+    onRequestStart?(context: RequestObservationContext): MaybePromise<void>;
+    onRequestSuccess?(context: RequestObservationContext, value: unknown): MaybePromise<void>;
+}
+/** Context passed to DTO binders while resolving handler arguments. */
+export interface ArgumentResolverContext {
+    handler: HandlerDescriptor;
+    requestContext: RequestContext;
+}
+/** Converter reference accepted by binding decorators and binder configuration. */
+export type ConverterLike = Converter | Token<Converter>;
+/** DTO property target metadata supplied to a converter invocation. */
+export interface ConverterTarget {
+    dto: Constructor;
+    handler: HandlerDescriptor;
+    key: string;
+    propertyKey: MetadataPropertyKey;
+    requestContext: RequestContext;
+    source: MetadataSource;
+}
+/** DTO binder that materializes one handler input object from request data. */
+export interface Binder {
+    bind(dto: Constructor, context: ArgumentResolverContext): MaybePromise<unknown>;
+}
+/** Value converter used to coerce one bound request field into a target shape. */
+export interface Converter {
+    convert(value: unknown, target: ConverterTarget): MaybePromise<unknown>;
+}
+/** Middleware reference accepted by module/runtime configuration. */
+export type MiddlewareLike = Middleware | Token<Middleware> | MiddlewareRouteConfig;
+/** Guard reference accepted by route metadata and runtime configuration. */
+export type GuardLike = Guard | Token<Guard>;
+/** Interceptor reference accepted by route metadata and runtime configuration. */
+export type InterceptorLike = Interceptor | Token<Interceptor>;
+/** Request observer reference accepted by runtime configuration. */
+export type RequestObserverLike = RequestObserver | Token<RequestObserver>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,114 @@
+/** HTTP methods understood by Fluo route metadata and dispatcher matching. */
+
+/** Strategies that decide how versioned HTTP routes are selected for one request. */
+export let VersioningType = /*#__PURE__*/function (VersioningType) {
+  VersioningType["URI"] = "URI";
+  VersioningType["HEADER"] = "HEADER";
+  VersioningType["MEDIA_TYPE"] = "MEDIA_TYPE";
+  VersioningType["CUSTOM"] = "CUSTOM";
+  return VersioningType;
+}({});
+
+/**
+ * Adapter-normalized incoming request passed through the HTTP pipeline.
+ *
+ * Runtime adapters populate this shape so decorators, binders, guards, and
+ * middleware can reason about one stable contract instead of platform-specific
+ * request objects.
+ */
+
+/**
+ * Adapter-normalized mutable response facade shared across dispatch stages.
+ *
+ * Dispatch policies write headers, status, redirects, and bodies through this
+ * contract before the underlying platform commits the response.
+ */
+
+/** Compression writer used when a platform can stream encoded response bodies. */
+
+/** Additional metadata passed to a response compression writer. */
+
+/**
+ * Low-level streaming handle used by SSE and other incremental response flows.
+ */
+
+/** Serializer used during response content negotiation. */
+
+/** Response negotiation settings applied to one route or dispatcher instance. */
+
+/** Authenticated caller identity attached to the active request context. */
+
+/**
+ * Per-request execution context shared across binding, guards, interceptors,
+ * and controller handlers.
+ */
+
+/** Typed metadata key used to store request-scoped values safely. */
+
+/** Controller method signature after DTO binding and request-context injection. */
+
+/**
+ * Route-level behavioral metadata collected from HTTP decorators.
+ */
+
+/** Derived metadata used while mapping controllers into dispatchable handlers. */
+
+/** Fully resolved controller handler descriptor stored in handler mappings. */
+
+/** Result returned when request matching resolves one handler and path params. */
+
+/** Immutable lookup table that matches incoming requests to controller handlers. */
+
+/** Source module/controller pair used to build a handler mapping. */
+
+/** Candidate version values returned by a custom version extractor. */
+
+/** Callback that extracts route version candidates from one framework request. */
+
+/**
+ * Versioning configuration shared by dispatcher and route-mapping policies.
+ */
+
+/** Runtime dispatcher that executes the full HTTP request lifecycle. */
+
+/** Logger seam used by the dispatcher for non-fatal internal failure reporting. */
+
+/** Observation payload delivered to request observers throughout one dispatch. */
+
+/** Continuation callback that advances middleware or interceptor execution. */
+
+/** Input passed to one middleware invocation. */
+
+/** Request pipeline middleware contract. */
+
+/** Declarative middleware binding for selected route patterns. */
+
+/** Guard execution context for one matched handler invocation. */
+
+/** Authorization or precondition contract evaluated before handler execution. */
+
+/** Lazy handle that lets interceptors continue into the next execution stage. */
+
+/** Interceptor execution context for one matched handler. */
+
+/** Around-invocation hook for transforming handler input, output, or errors. */
+
+/** Lifecycle observer notified as one request moves through dispatch stages. */
+
+/** Context passed to DTO binders while resolving handler arguments. */
+
+/** Converter reference accepted by binding decorators and binder configuration. */
+
+/** DTO property target metadata supplied to a converter invocation. */
+
+/** DTO binder that materializes one handler input object from request data. */
+
+/** Value converter used to coerce one bound request field into a target shape. */
+
+/** Middleware reference accepted by module/runtime configuration. */
+
+/** Guard reference accepted by route metadata and runtime configuration. */
+
+/** Interceptor reference accepted by route metadata and runtime configuration. */
+
+/** Request observer reference accepted by runtime configuration. */

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@fluojs/http",
+  "description": "HTTP execution layer — routing, guards, interceptors, DTO binding, and exception handling for Fluo.",
+  "keywords": [
+    "fluo",
+    "http",
+    "routing",
+    "guards",
+    "interceptors",
+    "controller",
+    "rest"
+  ],
+  "version": "1.0.0-beta.1",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fluojs/fluo.git",
+    "directory": "packages/http"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@fluojs/validation": "^1.0.0-beta.1",
+    "@fluojs/core": "^1.0.0-beta.1",
+    "@fluojs/di": "^1.0.0-beta.1"
+  },
+  "devDependencies": {
+    "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "prebuild": "node ../../tooling/scripts/clean-dist.mjs",
+    "build": "pnpm exec babel src --extensions .ts --ignore 'src/**/*.test.ts' --out-dir dist --config-file ../../tooling/babel/babel.config.cjs && pnpm exec tsc -p tsconfig.build.json",
+    "typecheck": "pnpm exec tsc -p tsconfig.json --noEmit",
+    "test": "pnpm exec vitest run -c vitest.config.ts",
+    "test:watch": "pnpm exec vitest -c vitest.config.ts"
+  }
+}