@wooksjs/event-http 0.7.2 → 0.7.3

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _wooksjs_event_core from '@wooksjs/event-core';
-import { EventContext as EventContext$1, Logger, EventContextOptions } 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';
@@ -19,7 +19,7 @@ import { Duplex } from 'stream';
  * const sessionId = getCookie('session_id')
  * ```
  */
-declare const useCookies: (ctx?: EventContext$1) => {
+declare const useCookies: (ctx?: EventContext) => {
     raw: string | undefined;
     getCookie: (name: string) => string | null;
 };
@@ -27,7 +27,7 @@ declare const useCookies: (ctx?: EventContext$1) => {
 /** 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$1) => {
+declare const useAccept: (ctx?: EventContext) => {
     accept: string | undefined;
     has: (type: KnownAcceptType | (string & {})) => boolean;
 };
@@ -42,7 +42,7 @@ type KnownAuthType = 'basic' | 'bearer';
  * if (is('bearer')) { const token = credentials() }
  * ```
  */
-declare const useAuthorization: (ctx?: EventContext$1) => {
+declare const useAuthorization: (ctx?: EventContext) => {
     authorization: string | undefined;
     type: () => string | null;
     credentials: () => string | null;
@@ -60,7 +60,7 @@ declare const useAuthorization: (ctx?: EventContext$1) => {
  * const { host, authorization } = useHeaders()
  * ```
  */
-declare function useHeaders(ctx?: EventContext$1): IncomingHttpHeaders;
+declare function useHeaders(ctx?: EventContext): IncomingHttpHeaders;
 
 /** Default safety limits for request body reading (size, ratio, timeout). */
 declare const DEFAULT_LIMITS: {
@@ -79,7 +79,7 @@ declare const rawBodySlot: _wooksjs_event_core.Cached<Promise<Buffer$1<ArrayBuff
  * const body = await rawBody()
  * ```
  */
-declare const useRequest: (ctx?: EventContext$1) => {
+declare const useRequest: (ctx?: EventContext) => {
     raw: http.IncomingMessage;
     url: string | undefined;
     method: string | undefined;
@@ -410,9 +410,9 @@ declare class HttpResponse {
     /** Whether the response has already been sent (or the underlying stream is no longer writable). */
     get responded(): boolean;
     protected renderBody(): string | Uint8Array;
-    protected renderError(data: TWooksErrorBodyExt, _ctx: EventContext$1): void;
+    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`. */
-    sendError(error: HttpError, ctx: EventContext$1): void | Promise<void>;
+    sendError(error: HttpError, ctx: EventContext): void | Promise<void>;
     /**
      * Finalizes and sends the response.
      *
@@ -442,7 +442,7 @@ declare class HttpResponse {
  * response.setCookie('session', 'abc', { httpOnly: true })
  * ```
  */
-declare function useResponse(ctx?: EventContext$1): HttpResponse;
+declare function useResponse(ctx?: EventContext): HttpResponse;
 
 /**
  * Extended `URLSearchParams` with safe JSON conversion.
@@ -463,14 +463,21 @@ declare class WooksURLSearchParams extends URLSearchParams {
  * const page = params().get('page')
  * ```
  */
-declare const useUrlParams: (ctx?: EventContext$1) => {
+declare const useUrlParams: (ctx?: EventContext) => {
     raw: () => string;
     params: () => WooksURLSearchParams;
     toJson: () => unknown;
 };
 
-/** Creates an async event context for an incoming HTTP request/response pair. */
-declare function createHttpContext(data: THttpEventData, options: EventContextOptions, ResponseClass?: typeof HttpResponse): <R>(fn: () => R) => R;
+/** Event kind definition for HTTP requests. Provides typed context slots for `req`, `response`, and `requestLimits`. */
+declare const httpKind: _wooksjs_event_core.EventKind<{
+    req: _wooksjs_event_core.SlotMarker<IncomingMessage>;
+    response: _wooksjs_event_core.SlotMarker<HttpResponse | undefined>;
+    requestLimits: _wooksjs_event_core.SlotMarker<TRequestLimits | undefined>;
+}>;
+
+/** Creates an HTTP event context and runs `fn` inside it. */
+declare function createHttpContext<R>(options: EventContextOptions, seeds: EventKindSeeds<typeof httpKind>, fn: () => R): R;
 /** Returns the current HTTP event context. */
 declare function useHttpContext(ctx?: EventContext): EventContext;
 
@@ -488,7 +495,7 @@ declare class WooksHttpResponse extends HttpResponse {
         link: string;
         image: string;
     }): void;
-    protected renderError(data: TWooksErrorBodyExt, ctx: EventContext$1): void;
+    protected renderError(data: TWooksErrorBodyExt, ctx: EventContext): void;
 }
 
 /** Configuration options for the WooksHttp adapter. */
@@ -566,7 +573,7 @@ declare class WooksHttp extends WooksAdapterBase {
      * @param server Server
      */
     attachServer(server?: Server): void;
-    protected respond(data: unknown, response: HttpResponse, ctx: EventContext$1): void | Promise<void>;
+    protected respond(data: unknown, response: HttpResponse, ctx: EventContext): void | Promise<void>;
     /**
      * Returns server callback function
      * that can be passed to any node server:
@@ -585,8 +592,8 @@ declare class WooksHttp extends WooksAdapterBase {
      * Creates an HTTP context, seeds it with upgrade data, and routes as method 'UPGRADE'.
      */
     getUpgradeCb(): (req: IncomingMessage, socket: Duplex, head: Buffer) => void;
-    protected processUpgradeHandlers(handlers: TWooksHandler[], ctx: EventContext$1, socket: Duplex): void | Promise<unknown>;
-    protected processHandlers(handlers: TWooksHandler[], ctx: EventContext$1, response: HttpResponse): void | Promise<unknown>;
+    protected processUpgradeHandlers(handlers: TWooksHandler[], ctx: EventContext, socket: Duplex): void | Promise<unknown>;
+    protected processHandlers(handlers: TWooksHandler[], ctx: EventContext, response: HttpResponse): void | Promise<unknown>;
     private processAsyncResult;
 }
 /**
@@ -600,13 +607,6 @@ declare class WooksHttp extends WooksAdapterBase {
  */
 declare function createHttpApp(opts?: TWooksHttpOptions, wooks?: Wooks | WooksAdapterBase): WooksHttp;
 
-/** Event kind definition for HTTP requests. Provides typed context slots for `req`, `response`, and `requestLimits`. */
-declare const httpKind: _wooksjs_event_core.EventKind<{
-    req: _wooksjs_event_core.SlotMarker<IncomingMessage>;
-    response: _wooksjs_event_core.SlotMarker<HttpResponse>;
-    requestLimits: _wooksjs_event_core.SlotMarker<TRequestLimits | undefined>;
-}>;
-
 /**
  * Configuration for `securityHeaders()`. Each option accepts a `string` (override value),
  * `false` (disable), or `undefined` (use default). `strictTransportSecurity` has no default (opt-in only).