@fluojs/http 1.0.0-beta.1

package/dist/client-identity.d.ts

@@ -0,0 +1,21 @@
+import type { FrameworkRequest } from './types.js';
+interface ClientIdentityResolutionOptions {
+    trustProxyHeaders?: boolean;
+}
+/**
+ * Resolve one stable client identity from the normalized request contract.
+ *
+ * By default, resolution uses only the raw socket's `remoteAddress`. When
+ * `trustProxyHeaders` is enabled, resolution order becomes `Forwarded`,
+ * `X-Forwarded-For`, `X-Real-IP`, then the raw socket fallback. If none are
+ * available, callers must provide an explicit resolver because falling back to
+ * a shared `unknown` bucket is not safe in proxied or serverless environments.
+ *
+ * @param request Adapter-normalized request whose headers/raw transport state should be inspected.
+ * @param options Client-identity trust settings for proxy-header handling.
+ * @returns A stable client identity string suitable for rate limiting.
+ * @throws Error When the request exposes no trusted proxy header or socket identity.
+ */
+export declare function resolveClientIdentity(request: FrameworkRequest, options?: ClientIdentityResolutionOptions): string;
+export {};
+//# sourceMappingURL=client-identity.d.ts.map

package/dist/client-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-identity.d.ts","sourceRoot":"","sources":["../src/client-identity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAMnD,UAAU,+BAA+B;IACvC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AA8HD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,+BAAoC,GAC5C,MAAM,CAeR"}

package/dist/client-identity.js

@@ -0,0 +1,108 @@
+const FORWARDED_HEADER = 'forwarded';
+const X_FORWARDED_FOR_HEADER = 'x-forwarded-for';
+const X_REAL_IP_HEADER = 'x-real-ip';
+function readHeader(headers, name) {
+  const direct = headers[name];
+  if (typeof direct === 'string') {
+    return direct;
+  }
+  if (Array.isArray(direct)) {
+    return direct.find(value => value.trim().length > 0);
+  }
+  const match = Object.entries(headers).find(([key]) => key.toLowerCase() === name);
+  const value = match?.[1];
+  if (typeof value === 'string') {
+    return value;
+  }
+  return value?.find(entry => entry.trim().length > 0);
+}
+function normalizeClientIdentity(value) {
+  if (!value) {
+    return undefined;
+  }
+  let normalized = value.trim();
+  if (!normalized || normalized.toLowerCase() === 'unknown') {
+    return undefined;
+  }
+  if (normalized.startsWith('"') && normalized.endsWith('"')) {
+    normalized = normalized.slice(1, -1).trim();
+  }
+  const bracketedHostPort = normalized.match(/^\[(.+)]:(\d+)$/);
+  if (bracketedHostPort) {
+    return bracketedHostPort[1]?.trim() || undefined;
+  }
+  if (normalized.startsWith('[') && normalized.endsWith(']')) {
+    normalized = normalized.slice(1, -1).trim();
+  }
+  const ipv4HostPort = normalized.match(/^((?:\d{1,3}\.){3}\d{1,3}):(\d+)$/);
+  if (ipv4HostPort) {
+    return ipv4HostPort[1]?.trim() || undefined;
+  }
+  return normalized || undefined;
+}
+function resolveForwardedClientIdentity(headers) {
+  const forwarded = readHeader(headers, FORWARDED_HEADER);
+  if (!forwarded) {
+    return undefined;
+  }
+  for (const field of forwarded.split(',')) {
+    for (const part of field.split(';')) {
+      const separator = part.indexOf('=');
+      if (separator === -1) {
+        continue;
+      }
+      const key = part.slice(0, separator).trim().toLowerCase();
+      if (key !== 'for') {
+        continue;
+      }
+      const normalized = normalizeClientIdentity(part.slice(separator + 1));
+      if (normalized) {
+        return normalized;
+      }
+    }
+  }
+  return undefined;
+}
+function resolveCommaSeparatedClientIdentity(headers, headerName) {
+  const headerValue = readHeader(headers, headerName);
+  if (!headerValue) {
+    return undefined;
+  }
+  for (const value of headerValue.split(',')) {
+    const normalized = normalizeClientIdentity(value);
+    if (normalized) {
+      return normalized;
+    }
+  }
+  return undefined;
+}
+function resolveSocketClientIdentity(raw) {
+  if (!raw || typeof raw !== 'object') {
+    return undefined;
+  }
+  const socket = raw.socket;
+  return typeof socket?.remoteAddress === 'string' ? normalizeClientIdentity(socket.remoteAddress) : undefined;
+}
+
+/**
+ * Resolve one stable client identity from the normalized request contract.
+ *
+ * By default, resolution uses only the raw socket's `remoteAddress`. When
+ * `trustProxyHeaders` is enabled, resolution order becomes `Forwarded`,
+ * `X-Forwarded-For`, `X-Real-IP`, then the raw socket fallback. If none are
+ * available, callers must provide an explicit resolver because falling back to
+ * a shared `unknown` bucket is not safe in proxied or serverless environments.
+ *
+ * @param request Adapter-normalized request whose headers/raw transport state should be inspected.
+ * @param options Client-identity trust settings for proxy-header handling.
+ * @returns A stable client identity string suitable for rate limiting.
+ * @throws Error When the request exposes no trusted proxy header or socket identity.
+ */
+export function resolveClientIdentity(request, options = {}) {
+  const proxyClientIdentity = options.trustProxyHeaders ? resolveForwardedClientIdentity(request.headers) ?? resolveCommaSeparatedClientIdentity(request.headers, X_FORWARDED_FOR_HEADER) ?? normalizeClientIdentity(readHeader(request.headers, X_REAL_IP_HEADER)) : undefined;
+  const clientIdentity = proxyClientIdentity ?? resolveSocketClientIdentity(request.raw);
+  if (clientIdentity) {
+    return clientIdentity;
+  }
+  throw new Error('Unable to resolve client identity from the trusted request transport. Enable trustProxyHeaders only behind a trusted proxy, or provide an explicit keyResolver/keyGenerator for this environment.');
+}

package/dist/context/request-context.d.ts

@@ -0,0 +1,53 @@
+import type { ContextKey, RequestContext } from '../types.js';
+/**
+ * Runs a callback inside the request-scoped AsyncLocalStorage context.
+ *
+ * @param context Request context snapshot to bind to the current async execution chain.
+ * @param callback Callback executed with `context` available through request-context helpers.
+ * @returns The return value from `callback`.
+ */
+export declare function runWithRequestContext<T>(context: RequestContext, callback: () => T): T;
+/**
+ * Returns the request context active in the current async scope, if available.
+ *
+ * @returns The active request context, or `undefined` when no request scope is bound.
+ */
+export declare function getCurrentRequestContext(): RequestContext | undefined;
+/**
+ * Returns the current request context or throws when no request scope is active.
+ *
+ * @returns The active request context bound to the current async execution scope.
+ * @throws {FluoError} When called outside a request scope managed by `runWithRequestContext(...)`.
+ */
+export declare function assertRequestContext(): RequestContext;
+/**
+ * Creates a defensive clone of a request context for AsyncLocalStorage storage.
+ *
+ * @param context Request context to clone before storing in AsyncLocalStorage.
+ * @returns A shallow clone with copied metadata map to avoid cross-request mutation.
+ */
+export declare function createRequestContext(context: RequestContext): RequestContext;
+/**
+ * Creates a typed key for `RequestContext.metadata`.
+ *
+ * @param description Human-readable key label used for debugging and symbol description.
+ * @returns A unique metadata key carrying the requested value type.
+ */
+export declare function createContextKey<T>(description: string): ContextKey<T>;
+/**
+ * Reads a typed value from request-context metadata.
+ *
+ * @param context Request context containing metadata values.
+ * @param key Typed metadata key created by `createContextKey(...)`.
+ * @returns The stored typed metadata value, or `undefined` when unset.
+ */
+export declare function getContextValue<T>(context: RequestContext, key: ContextKey<T>): T | undefined;
+/**
+ * Writes a typed value into request-context metadata.
+ *
+ * @param context Request context whose metadata map should be updated.
+ * @param key Typed metadata key created by `createContextKey(...)`.
+ * @param value Value to store for subsequent reads in the same request scope.
+ */
+export declare function setContextValue<T>(context: RequestContext, key: ContextKey<T>, value: T): void;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/context/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/context/request-context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI9D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAEtF;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,GAAG,SAAS,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,cAAc,CAUrD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAK5E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAKtE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAE7F;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAE9F"}

package/dist/context/request-context.js

@@ -0,0 +1,89 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { FluoError } from '@fluojs/core';
+const requestContextStore = new AsyncLocalStorage();
+
+/**
+ * Runs a callback inside the request-scoped AsyncLocalStorage context.
+ *
+ * @param context Request context snapshot to bind to the current async execution chain.
+ * @param callback Callback executed with `context` available through request-context helpers.
+ * @returns The return value from `callback`.
+ */
+export function runWithRequestContext(context, callback) {
+  return requestContextStore.run(context, callback);
+}
+
+/**
+ * Returns the request context active in the current async scope, if available.
+ *
+ * @returns The active request context, or `undefined` when no request scope is bound.
+ */
+export function getCurrentRequestContext() {
+  return requestContextStore.getStore();
+}
+
+/**
+ * Returns the current request context or throws when no request scope is active.
+ *
+ * @returns The active request context bound to the current async execution scope.
+ * @throws {FluoError} When called outside a request scope managed by `runWithRequestContext(...)`.
+ */
+export function assertRequestContext() {
+  const context = getCurrentRequestContext();
+  if (!context) {
+    throw new FluoError('RequestContext is not available in the current async scope.', {
+      code: 'REQUEST_CONTEXT_MISSING'
+    });
+  }
+  return context;
+}
+
+/**
+ * Creates a defensive clone of a request context for AsyncLocalStorage storage.
+ *
+ * @param context Request context to clone before storing in AsyncLocalStorage.
+ * @returns A shallow clone with copied metadata map to avoid cross-request mutation.
+ */
+export function createRequestContext(context) {
+  return {
+    ...context,
+    metadata: {
+      ...context.metadata
+    }
+  };
+}
+
+/**
+ * Creates a typed key for `RequestContext.metadata`.
+ *
+ * @param description Human-readable key label used for debugging and symbol description.
+ * @returns A unique metadata key carrying the requested value type.
+ */
+export function createContextKey(description) {
+  return {
+    description,
+    id: Symbol(description)
+  };
+}
+
+/**
+ * Reads a typed value from request-context metadata.
+ *
+ * @param context Request context containing metadata values.
+ * @param key Typed metadata key created by `createContextKey(...)`.
+ * @returns The stored typed metadata value, or `undefined` when unset.
+ */
+export function getContextValue(context, key) {
+  return context.metadata[key.id];
+}
+
+/**
+ * Writes a typed value into request-context metadata.
+ *
+ * @param context Request context whose metadata map should be updated.
+ * @param key Typed metadata key created by `createContextKey(...)`.
+ * @param value Value to store for subsequent reads in the same request scope.
+ */
+export function setContextValue(context, key, value) {
+  context.metadata[key.id] = value;
+}

package/dist/context/sse.d.ts

@@ -0,0 +1,21 @@
+import type { RequestContext } from '../types.js';
+export interface SseSendOptions {
+    event?: string;
+    id?: string | number;
+    retry?: number;
+}
+export declare function encodeSseComment(comment: string): string;
+export declare function encodeSseMessage(data: unknown, options?: SseSendOptions): string;
+export declare class SseResponse {
+    private readonly context;
+    private closed;
+    private readonly stream;
+    private removeCloseListener?;
+    private readonly onAbort;
+    constructor(context: RequestContext);
+    send(data: unknown, options?: SseSendOptions): boolean;
+    comment(comment: string): boolean;
+    close(): void;
+    private writeFrame;
+}
+//# sourceMappingURL=sse.d.ts.map

package/dist/context/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/context/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8C,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9F,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAoCD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAoBpF;AAED,qBAAa,WAAW;IASV,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,mBAAmB,CAAC,CAAa;IAEzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAEtB;gBAE2B,OAAO,EAAE,cAAc;IA0BpD,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO;IAI1D,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIjC,KAAK,IAAI,IAAI;IAiBb,OAAO,CAAC,UAAU;CAYnB"}

package/dist/context/sse.js

@@ -0,0 +1,106 @@
+function sanitizeSseField(value) {
+  return value.replace(/\r/g, '').replace(/\n/g, '');
+}
+function splitSseLines(value) {
+  return value.replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
+}
+function toSseDataString(data) {
+  if (data === undefined) {
+    return '';
+  }
+  if (typeof data === 'string') {
+    return data;
+  }
+  const serialized = JSON.stringify(data);
+  if (serialized === undefined) {
+    throw new TypeError(`SseResponse data must be JSON-serializable. Received ${typeof data}.`);
+  }
+  return serialized;
+}
+function resolveSseStream(response) {
+  if (!response.stream) {
+    throw new Error('SseResponse requires adapter-provided response.stream support.');
+  }
+  return response.stream;
+}
+export function encodeSseComment(comment) {
+  const lines = splitSseLines(comment);
+  const encoded = lines.map(line => line.length === 0 ? ':' : `: ${line}`);
+  return `${encoded.join('\n')}\n\n`;
+}
+export function encodeSseMessage(data, options = {}) {
+  const lines = [];
+  if (options.event !== undefined) {
+    lines.push(`event: ${sanitizeSseField(options.event)}`);
+  }
+  if (options.id !== undefined) {
+    lines.push(`id: ${sanitizeSseField(String(options.id))}`);
+  }
+  if (options.retry !== undefined && Number.isFinite(options.retry) && options.retry >= 0) {
+    lines.push(`retry: ${String(Math.floor(options.retry))}`);
+  }
+  for (const line of splitSseLines(toSseDataString(data))) {
+    lines.push(`data: ${line}`);
+  }
+  return `${lines.join('\n')}\n\n`;
+}
+export class SseResponse {
+  closed = false;
+  stream;
+  removeCloseListener;
+  onAbort = () => {
+    this.close();
+  };
+  constructor(context) {
+    this.context = context;
+    this.stream = resolveSseStream(context.response);
+    if (context.response.statusSet !== true) {
+      context.response.setStatus(200);
+    }
+    context.response.setHeader('Cache-Control', 'no-cache, no-transform');
+    context.response.setHeader('Connection', 'keep-alive');
+    context.response.setHeader('Content-Type', 'text/event-stream; charset=utf-8');
+    context.response.setHeader('X-Accel-Buffering', 'no');
+    context.response.committed = true;
+    this.stream.flush?.();
+    if (context.request.signal?.aborted) {
+      this.close();
+      return;
+    }
+    context.request.signal?.addEventListener('abort', this.onAbort, {
+      once: true
+    });
+    if (context.request.signal === undefined) {
+      this.removeCloseListener = this.stream.onClose?.(this.onAbort) ?? undefined;
+    }
+  }
+  send(data, options = {}) {
+    return this.writeFrame(encodeSseMessage(data, options));
+  }
+  comment(comment) {
+    return this.writeFrame(encodeSseComment(comment));
+  }
+  close() {
+    if (this.closed) {
+      return;
+    }
+    this.closed = true;
+    this.context.request.signal?.removeEventListener('abort', this.onAbort);
+    this.removeCloseListener?.();
+    this.removeCloseListener = undefined;
+    if (!this.stream.closed) {
+      this.stream.close();
+    }
+    this.context.response.committed = true;
+  }
+  writeFrame(frame) {
+    if (this.closed) {
+      return false;
+    }
+    if (this.stream.closed) {
+      this.close();
+      return false;
+    }
+    return this.stream.write(frame);
+  }
+}

package/dist/decorators.d.ts

@@ -0,0 +1,188 @@
+import { type Constructor, type MetadataPropertyKey } from '@fluojs/core';
+import type { ConverterLike, GuardLike, InterceptorLike } from './types.js';
+type StandardClassDecoratorFn = (value: Function, context: ClassDecoratorContext) => void;
+type StandardMethodDecoratorFn = (value: Function, context: ClassMethodDecoratorContext) => void;
+type StandardFieldDecoratorFn = <This, Value>(value: undefined, context: ClassFieldDecoratorContext<This, Value>) => void;
+type ClassDecoratorLike = StandardClassDecoratorFn;
+type MethodDecoratorLike = StandardMethodDecoratorFn;
+type ClassOrMethodDecoratorLike = StandardClassDecoratorFn & StandardMethodDecoratorFn;
+type FieldDecoratorLike = StandardFieldDecoratorFn;
+/**
+ * Marks a class as an HTTP controller and defines its base route path.
+ *
+ * @param basePath Controller base path prefixed to every route declared on the class.
+ * @returns A class decorator that writes controller metadata for route mapping.
+ */
+export declare function Controller(basePath?: string): ClassDecoratorLike;
+/**
+ * Sets API version metadata on a controller or route handler.
+ *
+ * @param version Version label interpreted by runtime versioning strategy (for example `"1"`).
+ * @returns A decorator that applies version metadata at class or method scope.
+ */
+export declare function Version(version: string): ClassOrMethodDecoratorLike;
+/**
+ * Registers a `GET` route handler.
+ *
+ * @param path Route path relative to the controller base path.
+ * @returns A method decorator that registers a `GET` handler mapping.
+ */
+export declare const Get: (path: string) => MethodDecoratorLike;
+/**
+ * Registers a `POST` route handler.
+ *
+ * @param path Route path relative to the controller base path.
+ * @returns A method decorator that registers a `POST` handler mapping.
+ */
+export declare const Post: (path: string) => MethodDecoratorLike;
+/**
+ * Registers a `PUT` route handler.
+ *
+ * @param path Route path relative to the controller base path.
+ * @returns A method decorator that registers a `PUT` handler mapping.
+ */
+export declare const Put: (path: string) => MethodDecoratorLike;
+/**
+ * Registers a `PATCH` route handler.
+ *
+ * @param path Route path relative to the controller base path.
+ * @returns A method decorator that registers a `PATCH` handler mapping.
+ */
+export declare const Patch: (path: string) => MethodDecoratorLike;
+/**
+ * Registers a `DELETE` route handler.
+ *
+ * @param path Route path relative to the controller base path.
+ * @returns A method decorator that registers a `DELETE` handler mapping.
+ */
+export declare const Delete: (path: string) => MethodDecoratorLike;
+/**
+ * Registers an `OPTIONS` route handler.
+ *
+ * @param path Route path relative to the controller base path.
+ * @returns A method decorator that registers an `OPTIONS` handler mapping.
+ */
+export declare const Options: (path: string) => MethodDecoratorLike;
+/**
+ * Registers a `HEAD` route handler.
+ *
+ * @param path Route path relative to the controller base path.
+ * @returns A method decorator that registers a `HEAD` handler mapping.
+ */
+export declare const Head: (path: string) => MethodDecoratorLike;
+/**
+ * Registers a route handler that matches all HTTP methods.
+ *
+ * @param path Route path relative to the controller base path.
+ * @returns A method decorator that registers an all-method handler mapping.
+ */
+export declare const All: (path: string) => MethodDecoratorLike;
+/**
+ * Associates a DTO class used for request binding and validation.
+ *
+ * @param dto DTO class consumed by request binding and validation.
+ * @returns A method decorator that stores request DTO metadata for the route.
+ */
+export declare const RequestDto: (value: Constructor) => MethodDecoratorLike;
+/**
+ * Declares response media types produced by a route handler.
+ *
+ * @param mediaTypes One or more media type strings written into route metadata.
+ * @returns A method decorator that stores normalized `produces` metadata.
+ */
+export declare function Produces(...mediaTypes: string[]): MethodDecoratorLike;
+/**
+ * Overrides the default success status code for a route handler.
+ *
+ * @param status HTTP status code used when the route completes successfully.
+ * @returns A method decorator that stores the route-level success status override.
+ */
+export declare const HttpCode: (value: number) => MethodDecoratorLike;
+/**
+ * Reads route-level `@Produces(...)` metadata from a controller method.
+ *
+ * @param controllerToken Controller class containing route metadata.
+ * @param propertyKey Controller method key to read.
+ * @returns A defensive copy of declared media types, or `undefined` when not configured.
+ */
+export declare function getRouteProducesMetadata(controllerToken: Constructor, propertyKey: MetadataPropertyKey): string[] | undefined;
+/**
+ * Binds a DTO field from a path parameter.
+ *
+ * @param key Optional source key override. Defaults to the DTO field name.
+ * @returns A field decorator that marks the binding source as `path`.
+ */
+export declare const FromPath: (key?: string) => FieldDecoratorLike;
+/**
+ * Binds a DTO field from query parameters.
+ *
+ * @param key Optional source key override. Defaults to the DTO field name.
+ * @returns A field decorator that marks the binding source as `query`.
+ */
+export declare const FromQuery: (key?: string) => FieldDecoratorLike;
+/**
+ * Binds a DTO field from a request header.
+ *
+ * @param key Optional source key override. Defaults to the DTO field name.
+ * @returns A field decorator that marks the binding source as `header`.
+ */
+export declare const FromHeader: (key?: string) => FieldDecoratorLike;
+/**
+ * Binds a DTO field from a cookie.
+ *
+ * @param key Optional source key override. Defaults to the DTO field name.
+ * @returns A field decorator that marks the binding source as `cookie`.
+ */
+export declare const FromCookie: (key?: string) => FieldDecoratorLike;
+/**
+ * Binds a DTO field from the request body.
+ *
+ * @param key Optional source key override. Defaults to the DTO field name.
+ * @returns A field decorator that marks the binding source as `body`.
+ */
+export declare const FromBody: (key?: string) => FieldDecoratorLike;
+/**
+ * Marks a DTO field binding as optional.
+ *
+ * @returns A field decorator that marks the DTO binding as optional.
+ */
+export declare function Optional(): FieldDecoratorLike;
+/**
+ * Applies a field-level converter to a DTO binding.
+ *
+ * @param converter Converter instance or token resolved during request binding.
+ * @returns A field decorator that stores converter metadata for the DTO field.
+ */
+export declare function Convert(converter: ConverterLike): FieldDecoratorLike;
+/**
+ * Adds a static response header to the route metadata.
+ *
+ * @param name Response header name.
+ * @param value Static response header value applied by the dispatcher.
+ * @returns A method decorator that appends route-level response-header metadata.
+ */
+export declare function Header(name: string, value: string): MethodDecoratorLike;
+/**
+ * Marks a route as a redirect with an optional status code.
+ *
+ * @param url Redirect target URL.
+ * @param statusCode Optional explicit redirect status code.
+ * @returns A method decorator that writes redirect metadata for the route.
+ */
+export declare function Redirect(url: string, statusCode?: number): MethodDecoratorLike;
+/**
+ * Attaches guards to a controller or route handler.
+ *
+ * @param guards One or more guards merged into existing class- or route-level guard metadata.
+ * @returns A decorator applicable to classes and methods.
+ */
+export declare function UseGuards(...guards: GuardLike[]): ClassOrMethodDecoratorLike;
+/**
+ * Attaches interceptors to a controller or route handler.
+ *
+ * @param interceptors One or more interceptors merged into existing class- or route-level metadata.
+ * @returns A decorator applicable to classes and methods.
+ */
+export declare function UseInterceptors(...interceptors: InterceptorLike[]): ClassOrMethodDecoratorLike;
+export {};
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

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