@wooksjs/event-http 0.7.4 → 0.7.5

package/dist/index.d.ts

@@ -2,8 +2,8 @@ import * as _wooksjs_event_core from '@wooksjs/event-core';
 import { EventContext, Logger, EventContextOptions, EventKindSeeds } from '@wooksjs/event-core';
 export { EventContext, EventContextOptions, useLogger, useRouteParams } from '@wooksjs/event-core';
 import * as http from 'http';
-import { IncomingHttpHeaders, IncomingMessage, ServerResponse, Server } from 'http';
-import { Buffer as Buffer$1 } from 'buffer';
+import http__default, { IncomingHttpHeaders, IncomingMessage, ServerResponse, Server } from 'http';
+import { Buffer } from 'buffer';
 import { URLSearchParams } from 'url';
 import * as wooks from 'wooks';
 import { TWooksHandler, TWooksOptions, WooksAdapterBase, Wooks, WooksUpgradeHandler } from 'wooks';
@@ -19,18 +19,18 @@ import { Duplex } from 'stream';
  * const sessionId = getCookie('session_id')
  * ```
  */
-declare const useCookies: (ctx?: EventContext) => {
+declare const useCookies: _wooksjs_event_core.WookComposable<{
     raw: string | undefined;
     getCookie: (name: string) => string | null;
-};
+}>;
 
 /** Short names for common Accept MIME types. */
 type KnownAcceptType = 'json' | 'html' | 'xml' | 'text';
 /** Provides helpers to check the request's Accept header for supported MIME types. */
-declare const useAccept: (ctx?: EventContext) => {
+declare const useAccept: _wooksjs_event_core.WookComposable<{
     accept: string | undefined;
     has: (type: KnownAcceptType | (string & {})) => boolean;
-};
+}>;
 
 /** Short names for common Authorization schemes. */
 type KnownAuthType = 'basic' | 'bearer';
@@ -42,7 +42,7 @@ type KnownAuthType = 'basic' | 'bearer';
  * if (is('bearer')) { const token = credentials() }
  * ```
  */
-declare const useAuthorization: (ctx?: EventContext) => {
+declare const useAuthorization: _wooksjs_event_core.WookComposable<{
     authorization: string | undefined;
     type: () => string | null;
     credentials: () => string | null;
@@ -51,7 +51,7 @@ declare const useAuthorization: (ctx?: EventContext) => {
         username: string;
         password: string;
     } | null;
-};
+}>;
 
 /**
  * Returns the incoming request headers.
@@ -70,7 +70,7 @@ declare const DEFAULT_LIMITS: {
     readonly readTimeoutMs: 10000;
 };
 /** @internal Exported for test pre-seeding via `ctx.set(rawBodySlot, ...)`. */
-declare const rawBodySlot: _wooksjs_event_core.Cached<Promise<Buffer$1<ArrayBufferLike>>>;
+declare const rawBodySlot: _wooksjs_event_core.Cached<Promise<Buffer<ArrayBufferLike>>>;
 /**
  * Provides access to the incoming HTTP request (method, url, headers, body, IP).
  * @example
@@ -79,12 +79,12 @@ declare const rawBodySlot: _wooksjs_event_core.Cached<Promise<Buffer$1<ArrayBuff
  * const body = await rawBody()
  * ```
  */
-declare const useRequest: (ctx?: EventContext) => {
+declare const useRequest: _wooksjs_event_core.WookComposable<{
     raw: http.IncomingMessage;
     url: string | undefined;
     method: string | undefined;
     headers: http.IncomingHttpHeaders;
-    rawBody: () => Promise<Buffer$1<ArrayBufferLike>>;
+    rawBody: () => Promise<Buffer<ArrayBufferLike>>;
     reqId: () => string;
     getIp: (options?: {
         trustProxy: boolean;
@@ -102,7 +102,7 @@ declare const useRequest: (ctx?: EventContext) => {
     setMaxInflated: (limit: number) => void;
     getMaxRatio: () => number;
     setMaxRatio: (limit: number) => void;
-};
+}>;
 
 /** Maps numeric HTTP status codes to their human-readable descriptions. */
 declare const httpStatusCodes: {
@@ -344,13 +344,14 @@ declare class HttpResponse {
     protected readonly _res: ServerResponse;
     protected readonly _req: IncomingMessage;
     protected readonly _logger: Logger;
+    protected readonly _captureMode: boolean;
     /**
      * @param _res - The underlying Node.js `ServerResponse`.
      * @param _req - The underlying Node.js `IncomingMessage`.
      * @param _logger - Logger instance for error reporting.
      * @param defaultHeaders - Optional headers to pre-populate on this response (e.g. from `securityHeaders()`).
      */
-    constructor(_res: ServerResponse, _req: IncomingMessage, _logger: Logger, defaultHeaders?: Record<string, string | string[]>);
+    constructor(_res: ServerResponse, _req: IncomingMessage, _logger: Logger, defaultHeaders?: Record<string, string | string[]>, _captureMode?: boolean);
     protected _status: EHttpStatusCode;
     protected _body: unknown;
     protected _headers: Record<string, string | string[]>;
@@ -409,6 +410,14 @@ declare class HttpResponse {
     getRawRes(passthrough?: boolean): ServerResponse;
     /** Whether the response has already been sent (or the underlying stream is no longer writable). */
     get responded(): boolean;
+    /**
+     * Builds a Web Standard `Response` from the accumulated response state
+     * (status, headers, cookies, body) without writing to the underlying `ServerResponse`.
+     *
+     * Used by `WooksHttp.fetch()` for programmatic invocation.
+     */
+    toWebResponse(): Response;
+    private _buildWebHeaders;
     protected renderBody(): string | Uint8Array;
     protected renderError(data: TWooksErrorBodyExt, _ctx: EventContext): void;
     /** Renders and sends an HTTP error response. Called automatically by the framework when a handler throws an `HttpError`. */
@@ -428,6 +437,8 @@ declare class HttpResponse {
     private sendFetchResponse;
     private sendRegular;
 }
+/** Converts a Record of headers to a Web Standard `Headers` object. */
+declare function recordToWebHeaders(record: Record<string, string | string[]>): Headers;
 
 /**
  * Returns the HttpResponse instance for the current request.
@@ -463,11 +474,11 @@ declare class WooksURLSearchParams extends URLSearchParams {
  * const page = params().get('page')
  * ```
  */
-declare const useUrlParams: (ctx?: EventContext) => {
+declare const useUrlParams: _wooksjs_event_core.WookComposable<{
     raw: () => string;
     params: () => WooksURLSearchParams;
     toJson: () => unknown;
-};
+}>;
 
 /** Event kind definition for HTTP requests. Provides typed context slots for `req`, `response`, and `requestLimits`. */
 declare const httpKind: _wooksjs_event_core.EventKind<{
@@ -509,6 +520,12 @@ interface TWooksHttpOptions {
     responseClass?: typeof WooksHttpResponse;
     /** Default headers applied to every response. Use `securityHeaders()` for recommended security headers. */
     defaultHeaders?: Record<string, string | string[]>;
+    /**
+     * Headers forwarded from the calling HTTP context during programmatic `fetch()`.
+     * Set to `false` to disable forwarding entirely.
+     * @default ['authorization', 'cookie', 'accept-language', 'x-forwarded-for', 'x-request-id']
+     */
+    forwardHeaders?: string[] | false;
 }
 /** HTTP adapter for Wooks that provides route registration, server lifecycle, and request handling. */
 declare class WooksHttp extends WooksAdapterBase {
@@ -564,7 +581,7 @@ declare class WooksHttp extends WooksAdapterBase {
      * See attachServer method docs
      * @returns Server
      */
-    getServer(): Server<typeof IncomingMessage, typeof ServerResponse> | undefined;
+    getServer(): http__default.Server<typeof http__default.IncomingMessage, typeof http__default.ServerResponse> | undefined;
     /**
      * Attaches http(s) server instance
      * to Wooks.
@@ -595,6 +612,29 @@ declare class WooksHttp extends WooksAdapterBase {
     protected processUpgradeHandlers(handlers: TWooksHandler[], ctx: EventContext, socket: Duplex): void | Promise<unknown>;
     protected processHandlers(handlers: TWooksHandler[], ctx: EventContext, response: HttpResponse): void | Promise<unknown>;
     private processAsyncResult;
+    /**
+     * Programmatic route invocation using the Web Standard fetch API.
+     * Goes through the full dispatch pipeline: context creation, route matching,
+     * handler execution, response finalization.
+     *
+     * When called from within an existing HTTP context (e.g. during SSR),
+     * identity headers (authorization, cookie) are automatically forwarded
+     * from the calling request unless already present on the given Request.
+     *
+     * @param request - A Web Standard Request object.
+     * @returns A Web Standard Response.
+     */
+    fetch(request: Request): Promise<Response>;
+    /**
+     * Convenience wrapper for programmatic route invocation.
+     * Accepts a URL string (relative paths auto-prefixed with `http://localhost`),
+     * URL object, or Request, plus optional `RequestInit`.
+     *
+     * @param input - URL string, URL object, or Request.
+     * @param init - Optional RequestInit (method, headers, body, etc.).
+     * @returns A Web Standard Response.
+     */
+    request(input: string | URL | Request, init?: RequestInit): Promise<Response>;
 }
 /**
  * Creates a new WooksHttp application instance.
@@ -650,7 +690,7 @@ interface TTestHttpContext {
     /** Custom request body limits. */
     requestLimits?: TRequestLimits;
     /** Pre-seed the raw body for body-parsing tests. */
-    rawBody?: string | Buffer$1;
+    rawBody?: string | Buffer;
     /** Default headers to pre-populate on the response (e.g. from `securityHeaders()`). */
     defaultHeaders?: Record<string, string | string[]>;
 }
@@ -671,5 +711,5 @@ interface TTestHttpContext {
  */
 declare function prepareTestHttpContext(options: TTestHttpContext): <T>(cb: (...a: any[]) => T) => T;
 
-export { DEFAULT_LIMITS, EHttpStatusCode, HttpError, HttpResponse, WooksHttp, WooksHttpResponse, WooksURLSearchParams, createHttpApp, createHttpContext, httpKind, httpStatusCodes, prepareTestHttpContext, rawBodySlot, renderCacheControl, securityHeaders, useAccept, useAuthorization, useCookies, useHeaders, useHttpContext, useRequest, useResponse, useUrlParams };
+export { DEFAULT_LIMITS, EHttpStatusCode, HttpError, HttpResponse, WooksHttp, WooksHttpResponse, WooksURLSearchParams, createHttpApp, createHttpContext, httpKind, httpStatusCodes, prepareTestHttpContext, rawBodySlot, recordToWebHeaders, renderCacheControl, securityHeaders, useAccept, useAuthorization, useCookies, useHeaders, useHttpContext, useRequest, useResponse, useUrlParams };
 export type { KnownAcceptType, KnownAuthType, SecurityHeadersOptions, TCacheControl, TCookieAttributes, TCookieAttributesInput, THttpEventData, TRequestLimits, TSetCookieData, TTestHttpContext, TWooksErrorBody, TWooksErrorBodyExt, TWooksHttpOptions };