@visulima/pail 4.0.1 → 4.1.0

package/dist/middleware/fastify.d.ts

@@ -1,84 +1,83 @@
-import { W as WideEvent } from "../packem_shared/wide-event.d-D3ATYpoK.js";
-import { P as PailMiddlewareOptions } from "../packem_shared/create-middleware-logger.d-B-JmQ1Sl.js";
+import { W as WideEvent } from "../packem_shared/wide-event.d-BMLastMR.js";
+import { P as PailMiddlewareOptions } from "../packem_shared/create-middleware-logger.d-BRkkBMlk.js";
 import "../packem_shared/index.d-T71KjNAr.js";
-import 'type-fest';
-import "../packem_shared/types.d-bWnqHJKL.js";
+import "../packem_shared/types.d-4ge_rME4.js";
 import '@visulima/colorize';
 import '@visulima/interactive-manager';
 /**
-* A Fastify-like request object with the pail logger attached.
-* Use this to type your route handlers when accessing `request.log`.
-* @example
-* ```typescript
-* import type { PailFastifyRequest } from "@visulima/pail/middleware/fastify";
-*
-* app.get("/api/users", async (request: PailFastifyRequest, reply) => {
-*   request.log?.set({ user: { id: 1 } });
-* });
-* ```
-*/
+ * A Fastify-like request object with the pail logger attached.
+ * Use this to type your route handlers when accessing `request.log`.
+ * @example
+ * ```typescript
+ * import type { PailFastifyRequest } from "@visulima/pail/middleware/fastify";
+ *
+ * app.get("/api/users", async (request: PailFastifyRequest, reply) => {
+ *   request.log?.set({ user: { id: 1 } });
+ * });
+ * ```
+ */
 interface PailFastifyRequest {
   [key: string]: unknown;
   headers: Record<string, string | string[] | undefined>;
   /**
-  * The request-scoped WideEvent logger, attached by pail plugin.
-  * Only present for non-excluded routes.
-  */
+   * The request-scoped WideEvent logger, attached by pail plugin.
+   * Only present for non-excluded routes.
+   */
   log?: WideEvent;
   method: string;
   url: string;
 }
 /**
-* A Fastify-like reply object.
-*/
+ * A Fastify-like reply object.
+ */
 interface PailFastifyReply {
   [key: string]: unknown;
   statusCode: number;
 }
 /**
-* A Fastify-like instance that supports the hook registration API.
-*/
+ * A Fastify-like instance that supports the hook registration API.
+ */
 interface PailFastifyInstance {
   addHook: ((name: "onError", hook: (request: PailFastifyRequest, reply: PailFastifyReply, error: Error) => Promise<void>) => void) & ((name: "onRequest", hook: (request: PailFastifyRequest, reply: PailFastifyReply, done: () => void) => void) => void) & ((name: "onResponse", hook: (request: PailFastifyRequest, reply: PailFastifyReply) => Promise<void>) => void);
 }
 /**
-* Retrieve the request-scoped WideEvent logger from AsyncLocalStorage.
-* Must be called within a request handled by the pail Fastify plugin.
-* @returns The request-scoped WideEvent logger
-* @throws Error if called outside of the plugin context
-*/
+ * Retrieve the request-scoped WideEvent logger from AsyncLocalStorage.
+ * Must be called within a request handled by the pail Fastify plugin.
+ * @returns The request-scoped WideEvent logger
+ * @throws Error if called outside of the plugin context
+ */
 declare const useLogger: () => WideEvent;
 /**
-* Configuration options for the Fastify pail plugin.
-* @template T - Custom logger type names from the pail instance
-*/
+ * Configuration options for the Fastify pail plugin.
+ * @template T - Custom logger type names from the pail instance
+ */
 type FastifyPluginOptions<T extends string = string> = PailMiddlewareOptions<T>;
 /**
-* Register pail wide event logging as a Fastify plugin.
-*
-* Attaches a WideEvent logger to each request, accessible via:
-* - `request.log` on the Fastify request object
-* - `useLogger()` from anywhere in the async call stack
-*
-* The wide event is automatically emitted on response or error.
-* @param fastify The Fastify instance
-* @param options Plugin configuration
-* @example
-* ```typescript
-* import Fastify from "fastify";
-* import { createPail } from "@visulima/pail";
-* import { pailPlugin, useLogger } from "@visulima/pail/middleware/fastify";
-*
-* const app = Fastify();
-* const logger = createPail();
-*
-* pailPlugin(app, { pail: logger });
-*
-* app.get("/api/users", async (request, reply) => {
-*   request.log.set({ user: { id: 1 } });
-*   return { ok: true };
-* });
-* ```
-*/
+ * Register pail wide event logging as a Fastify plugin.
+ *
+ * Attaches a WideEvent logger to each request, accessible via:
+ * - `request.log` on the Fastify request object
+ * - `useLogger()` from anywhere in the async call stack
+ *
+ * The wide event is automatically emitted on response or error.
+ * @param fastify The Fastify instance
+ * @param options Plugin configuration
+ * @example
+ * ```typescript
+ * import Fastify from "fastify";
+ * import { createPail } from "@visulima/pail";
+ * import { pailPlugin, useLogger } from "@visulima/pail/middleware/fastify";
+ *
+ * const app = Fastify();
+ * const logger = createPail();
+ *
+ * pailPlugin(app, { pail: logger });
+ *
+ * app.get("/api/users", async (request, reply) => {
+ *   request.log.set({ user: { id: 1 } });
+ *   return { ok: true };
+ * });
+ * ```
+ */
 declare const pailPlugin: <T extends string = string>(fastify: PailFastifyInstance, options: FastifyPluginOptions<T>) => void;
 export { type FastifyPluginOptions, type PailFastifyInstance, type PailFastifyReply, type PailFastifyRequest, type WideEvent, pailPlugin, useLogger };

package/dist/middleware/fastify.js

@@ -1 +1 @@
-import{a as p,c as f}from"../packem_shared/headers-DH0H2s8W.js";import{c as l}from"../packem_shared/storage-DaXAlpiO.js";const i=l("Fastify middleware context. Make sure pail plugin is registered before your route handlers."),y=()=>i.useLogger(),w=(o,g)=>{const t=new WeakMap,s=new WeakSet;o.addHook("onRequest",(e,d,r)=>{const a=e.headers["x-request-id"]??crypto.randomUUID(),c=p(e.headers),{finish:u,logger:n,skipped:h}=f(g,{headers:c,method:e.method,path:e.url,requestId:a});if(h){r();return}e.log=n,t.set(e,{finish:u}),i.storage.run(n,()=>{r()})}),o.addHook("onResponse",async(e,d)=>{const r=t.get(e);!r||s.has(e)||(s.add(e),r.finish({status:d.statusCode}))}),o.addHook("onError",async(e,d,r)=>{const a=t.get(e);!a||s.has(e)||(s.add(e),a.finish({error:r}))})};export{w as pailPlugin,y as useLogger};
+import{a as h,c as f}from"../packem_shared/headers-DI58djdG.js";import{c as l}from"../packem_shared/storage-DVcJumyk.js";const i=l("Fastify middleware context. Make sure pail plugin is registered before your route handlers."),y=()=>i.useLogger(),w=(o,g)=>{const t=new WeakMap,s=new WeakSet;o.addHook("onRequest",(e,d,r)=>{const a=e.headers["x-request-id"]??crypto.randomUUID(),c=h(e.headers),{finish:u,logger:n,skipped:p}=f(g,{headers:c,method:e.method,path:e.url.split("?")[0],requestId:a});if(p){r();return}e.log=n,t.set(e,{finish:u}),i.storage.run(n,()=>{r()})}),o.addHook("onResponse",async(e,d)=>{const r=t.get(e);!r||s.has(e)||(s.add(e),r.finish({status:d.statusCode}))}),o.addHook("onError",async(e,d,r)=>{const a=t.get(e);!a||s.has(e)||(s.add(e),a.finish({error:r}))})};export{w as pailPlugin,y as useLogger};

package/dist/middleware/hono.d.ts

@@ -1,24 +1,23 @@
-import { W as WideEvent } from "../packem_shared/wide-event.d-D3ATYpoK.js";
-import { P as PailMiddlewareOptions } from "../packem_shared/create-middleware-logger.d-B-JmQ1Sl.js";
+import { W as WideEvent } from "../packem_shared/wide-event.d-BMLastMR.js";
+import { P as PailMiddlewareOptions } from "../packem_shared/create-middleware-logger.d-BRkkBMlk.js";
 import "../packem_shared/index.d-T71KjNAr.js";
-import 'type-fest';
-import "../packem_shared/types.d-bWnqHJKL.js";
+import "../packem_shared/types.d-4ge_rME4.js";
 import '@visulima/colorize';
 import '@visulima/interactive-manager';
 /**
-* A Hono-like context object with access to the pail logger.
-*
-* Use `c.get("log")` or `useLogger(c)` to access the WideEvent logger.
-* @example
-* ```typescript
-* import type { PailHonoContext } from "@visulima/pail/middleware/hono";
-*
-* app.get("/api/users", (c: PailHonoContext) => {
-*   const log = c.get("log");
-*   log.set({ user: { id: 1 } });
-* });
-* ```
-*/
+ * A Hono-like context object with access to the pail logger.
+ *
+ * Use `c.get("log")` or `useLogger(c)` to access the WideEvent logger.
+ * @example
+ * ```typescript
+ * import type { PailHonoContext } from "@visulima/pail/middleware/hono";
+ *
+ * app.get("/api/users", (c: PailHonoContext) => {
+ *   const log = c.get("log");
+ *   log.set({ user: { id: 1 } });
+ * });
+ * ```
+ */
 interface PailHonoContext {
   [key: string]: unknown;
   get: (key: string) => unknown;
@@ -36,53 +35,53 @@ interface PailHonoContext {
   set: (key: string, value: unknown) => void;
 }
 /**
-* Hono-compatible next function.
-*/
+ * Hono-compatible next function.
+ */
 type PailHonoNext = () => Promise<void>;
 /**
-* The Hono middleware function signature returned by `pailMiddleware()`.
-*/
+ * The Hono middleware function signature returned by `pailMiddleware()`.
+ */
 type PailHonoMiddleware = (c: PailHonoContext, next: PailHonoNext) => Promise<void>;
 /**
-* Configuration options for the Hono pail middleware.
-* @template T - Custom logger type names from the pail instance
-*/
+ * Configuration options for the Hono pail middleware.
+ * @template T - Custom logger type names from the pail instance
+ */
 type HonoMiddlewareOptions<T extends string = string> = PailMiddlewareOptions<T>;
 /**
-* Retrieve the WideEvent logger from Hono context.
-* Must be called within a request handler where pail middleware is active.
-* @param c The Hono context object
-* @returns The request-scoped WideEvent logger
-* @throws Error if the middleware is not registered
-*/
+ * Retrieve the WideEvent logger from Hono context.
+ * Must be called within a request handler where pail middleware is active.
+ * @param c The Hono context object
+ * @returns The request-scoped WideEvent logger
+ * @throws Error if the middleware is not registered
+ */
 declare const useLogger: (c: PailHonoContext) => WideEvent;
 /**
-* Create Hono middleware that attaches a WideEvent logger to each request.
-*
-* The logger is available via:
-* - `c.get("log")` on the Hono context
-* - `useLogger(c)` helper function
-*
-* The wide event is automatically emitted when the handler completes or throws.
-* @param options Middleware configuration
-* @returns Hono middleware function
-* @example
-* ```typescript
-* import { Hono } from "hono";
-* import { createPail } from "@visulima/pail";
-* import { pailMiddleware, useLogger } from "@visulima/pail/middleware/hono";
-*
-* const app = new Hono();
-* const logger = createPail();
-*
-* app.use("*", pailMiddleware({ pail: logger }));
-*
-* app.get("/api/users", (c) => {
-*   const log = useLogger(c);
-*   log.set({ user: { id: 1 } });
-*   return c.json({ ok: true });
-* });
-* ```
-*/
+ * Create Hono middleware that attaches a WideEvent logger to each request.
+ *
+ * The logger is available via:
+ * - `c.get("log")` on the Hono context
+ * - `useLogger(c)` helper function
+ *
+ * The wide event is automatically emitted when the handler completes or throws.
+ * @param options Middleware configuration
+ * @returns Hono middleware function
+ * @example
+ * ```typescript
+ * import { Hono } from "hono";
+ * import { createPail } from "@visulima/pail";
+ * import { pailMiddleware, useLogger } from "@visulima/pail/middleware/hono";
+ *
+ * const app = new Hono();
+ * const logger = createPail();
+ *
+ * app.use("*", pailMiddleware({ pail: logger }));
+ *
+ * app.get("/api/users", (c) => {
+ *   const log = useLogger(c);
+ *   log.set({ user: { id: 1 } });
+ *   return c.json({ ok: true });
+ * });
+ * ```
+ */
 declare const pailMiddleware: <T extends string = string>(options: HonoMiddlewareOptions<T>) => PailHonoMiddleware;
 export { type HonoMiddlewareOptions, type PailHonoContext, type PailHonoMiddleware, type PailHonoNext, type WideEvent, pailMiddleware, useLogger };

package/dist/middleware/hono.js

@@ -1 +1 @@
-import{e as c,c as g}from"../packem_shared/headers-DH0H2s8W.js";const l=t=>{const r=t.get("log");if(!r)throw new Error("[pail] useLogger() called but pail middleware is not registered.");return r},p=t=>async(r,a)=>{const o=r.req.header("x-request-id")??crypto.randomUUID(),i=c(r.req.raw.headers),{finish:s,logger:d,skipped:n}=g(t,{headers:i,method:r.req.method,path:r.req.path,requestId:o});if(n){await a();return}r.set("log",d);try{await a(),s({status:r.res.status})}catch(e){throw s({error:e instanceof Error?e:new Error(String(e))}),e}};export{p as pailMiddleware,l as useLogger};
+import{e as c,c as g}from"../packem_shared/headers-DI58djdG.js";const l=t=>{const r=t.get("log");if(!r)throw new Error("[pail] useLogger() called but pail middleware is not registered.");return r},p=t=>async(r,a)=>{const o=r.req.header("x-request-id")??crypto.randomUUID(),i=c(r.req.raw.headers),{finish:s,logger:d,skipped:n}=g(t,{headers:i,method:r.req.method,path:r.req.path,requestId:o});if(n){await a();return}r.set("log",d);try{await a(),s({status:r.res.status})}catch(e){throw s({error:e instanceof Error?e:new Error(String(e))}),e}};export{p as pailMiddleware,l as useLogger};

package/dist/middleware/next/handler.d.ts

@@ -1,14 +1,13 @@
-import { P as PailMiddlewareOptions } from "../../packem_shared/create-middleware-logger.d-B-JmQ1Sl.js";
-import { W as WideEvent } from "../../packem_shared/wide-event.d-D3ATYpoK.js";
+import { P as PailMiddlewareOptions } from "../../packem_shared/create-middleware-logger.d-BRkkBMlk.js";
+import { W as WideEvent } from "../../packem_shared/wide-event.d-BMLastMR.js";
 import 'node:async_hooks';
-import "../../packem_shared/types.d-bWnqHJKL.js";
+import "../../packem_shared/types.d-4ge_rME4.js";
 import '@visulima/colorize';
 import '@visulima/interactive-manager';
-import 'type-fest';
 import "../../packem_shared/index.d-T71KjNAr.js";
 /**
-* Minimal type definitions to avoid requiring next as a dependency.
-*/
+ * Minimal type definitions to avoid requiring next as a dependency.
+ */
 interface NextRequest {
   headers: Headers;
   nextUrl: {
@@ -26,79 +25,79 @@ interface NextResponseConstructor {
   }) => NextResponse;
 }
 /**
-* Options for the Next.js pail middleware.
-*/
+ * Options for the Next.js pail middleware.
+ */
 interface PailNextMiddlewareOptions {
   /**
-  * Glob patterns for paths to exclude from logging.
-  * Excluded paths won't get request IDs or timing headers.
-  * @example ["/_next/**", "/favicon.ico"]
-  */
+   * Glob patterns for paths to exclude from logging.
+   * Excluded paths won't get request IDs or timing headers.
+   * @example ["/_next/**", "/favicon.ico"]
+   */
   exclude?: string[];
   /**
-  * Glob patterns for paths to include in logging.
-  * If not set, all non-excluded paths are included.
-  */
+   * Glob patterns for paths to include in logging.
+   * If not set, all non-excluded paths are included.
+   */
   include?: string[];
 }
 /**
-* Create a Next.js edge middleware that sets `x-request-id` and `x-pail-start`
-* headers on the request for downstream use by `withPail()`.
-*
-* This middleware runs at the edge and prepares request metadata.
-* The actual wide event logging happens in `withPail()`.
-* @param NextResponseClass The NextResponse class from "next/server.js"
-* @param options Middleware configuration
-* @returns A middleware function
-* @example
-* ```typescript
-* // middleware.ts
-* import { NextResponse } from "next/server.js";
-* import { pailMiddleware } from "@visulima/pail/middleware/next";
-*
-* const middleware = pailMiddleware(NextResponse, {
-*   exclude: ["/_next/**", "/favicon.ico"],
-* });
-*
-* export default middleware;
-* ```
-*/
+ * Create a Next.js edge middleware that sets `x-request-id` and `x-pail-start`
+ * headers on the request for downstream use by `withPail()`.
+ *
+ * This middleware runs at the edge and prepares request metadata.
+ * The actual wide event logging happens in `withPail()`.
+ * @param NextResponseClass The NextResponse class from "next/server.js"
+ * @param options Middleware configuration
+ * @returns A middleware function
+ * @example
+ * ```typescript
+ * // middleware.ts
+ * import { NextResponse } from "next/server.js";
+ * import { pailMiddleware } from "@visulima/pail/middleware/next";
+ *
+ * const middleware = pailMiddleware(NextResponse, {
+ *   exclude: ["/_next/**", "/favicon.ico"],
+ * });
+ *
+ * export default middleware;
+ * ```
+ */
 declare const pailMiddleware: (NextResponseClass: NextResponseConstructor, options?: PailNextMiddlewareOptions) => (request: NextRequest) => NextResponse;
 /**
-* Retrieve the request-scoped WideEvent logger from AsyncLocalStorage.
-* Must be called within a `withPail()` wrapped handler or server action.
-* @returns The request-scoped WideEvent logger
-* @throws Error if called outside of a withPail context
-*/
+ * Retrieve the request-scoped WideEvent logger from AsyncLocalStorage.
+ * Must be called within a `withPail()` wrapped handler or server action.
+ * @returns The request-scoped WideEvent logger
+ * @throws Error if called outside of a withPail context
+ */
 declare const useLogger: () => WideEvent;
 type NextPailOptions<T extends string = string> = PailMiddlewareOptions<T>;
 /**
-* Create a `withPail` wrapper function for Next.js route handlers and server actions.
-*
-* Wraps handler execution in AsyncLocalStorage so that `useLogger()` works
-* anywhere in the async call stack. The wide event is automatically emitted
-* when the handler completes or throws.
-* @param options Configuration options
-* @returns A `withPail` wrapper function
-* @example
-* ```typescript
-* // lib/pail.ts
-* import { createPail } from "@visulima/pail";
-* import { createWithPail } from "@visulima/pail/middleware/next";
-*
-* const logger = createPail();
-* export const withPail = createWithPail({ pail: logger });
-*
-* // app/api/users/route.ts
-* import { withPail } from "@/lib/pail";
-* import { useLogger } from "@visulima/pail/middleware/next";
-*
-* export const GET = withPail(async (request: Request) => {
-*   const log = useLogger();
-*   log.set({ user: { id: 1 } });
-*   return Response.json({ ok: true });
-* });
-* ```
-*/
+ * Create a `withPail` wrapper function for Next.js route handlers and server actions.
+ *
+ * Wraps handler execution in AsyncLocalStorage so that `useLogger()` works
+ * anywhere in the async call stack. The wide event is automatically emitted
+ * when the handler completes or throws.
+ * @param options Configuration options
+ * @returns A `withPail` wrapper function
+ * @example
+ * ```typescript
+ * // lib/pail.ts
+ * import { createPail } from "@visulima/pail";
+ * import { createWithPail } from "@visulima/pail/middleware/next";
+ *
+ * const logger = createPail();
+ * export const withPail = createWithPail({ pail: logger });
+ *
+ * // app/api/users/route.ts
+ * import { withPail } from "@/lib/pail";
+ * import { useLogger } from "@visulima/pail/middleware/next";
+ *
+ * export const GET = withPail(async (request: Request) => {
+ *   const log = useLogger();
+ *   log.set({ user: { id: 1 } });
+ *   return Response.json({ ok: true });
+ * });
+ * ```
+ */
 declare const createWithPail: <T extends string = string>(options: NextPailOptions<T>) => <TArgs extends unknown[], TReturn>(handler: (...args: TArgs) => Promise<TReturn> | TReturn) => (...args: TArgs) => Promise<TReturn>;
 export { type NextPailOptions, type PailNextMiddlewareOptions, type WideEvent, createWithPail, pailMiddleware, useLogger };

package/dist/middleware/next/handler.js

@@ -1 +1 @@
-import{e as m,c as l}from"../../packem_shared/headers-DH0H2s8W.js";import{pailStorage as w}from"../../packem_shared/useLogger-DB34CuU5.js";import{useLogger as N}from"../../packem_shared/useLogger-DB34CuU5.js";import{pailMiddleware as S}from"../../packem_shared/pailMiddleware-B5DJoBYl.js";const q=u=>s=>async(...a)=>{const[o]=a,f=o instanceof Request;let n="UNKNOWN",i="/",c=crypto.randomUUID(),d={};if(f){const e=o,t=new URL(e.url);n=e.method,i=t.pathname,d=m(e.headers);const r=e.headers.get("x-request-id");r&&(c=r)}const{finish:p,logger:h,skipped:g}=l(u,{headers:d,method:n,path:i,requestId:c});if(g)return s(...a);try{const e=await w.run(h,()=>s(...a)),t=e instanceof Response?e.status:200;return p({status:t}),e}catch(e){const t=e instanceof Error?e:new Error(String(e)),r=t.status??t.statusCode??500;throw p({error:t,status:r}),e}};export{q as createWithPail,S as pailMiddleware,N as useLogger};
+import{e as m,c as l}from"../../packem_shared/headers-DI58djdG.js";import{pailStorage as w}from"../../packem_shared/useLogger-7p55yvvc.js";import{useLogger as N}from"../../packem_shared/useLogger-7p55yvvc.js";import{pailMiddleware as S}from"../../packem_shared/pailMiddleware-B5DJoBYl.js";const q=u=>s=>async(...a)=>{const[o]=a,f=o instanceof Request;let n="UNKNOWN",i="/",c=crypto.randomUUID(),d={};if(f){const e=o,t=new URL(e.url);n=e.method,i=t.pathname,d=m(e.headers);const r=e.headers.get("x-request-id");r&&(c=r)}const{finish:p,logger:h,skipped:g}=l(u,{headers:d,method:n,path:i,requestId:c});if(g)return s(...a);try{const e=await w.run(h,()=>s(...a)),t=e instanceof Response?e.status:200;return p({status:t}),e}catch(e){const t=e instanceof Error?e:new Error(String(e)),r=t.status??t.statusCode??500;throw p({error:t,status:r}),e}};export{q as createWithPail,S as pailMiddleware,N as useLogger};

package/dist/middleware/sveltekit.d.ts

@@ -1,22 +1,21 @@
-import { W as WideEvent } from "../packem_shared/wide-event.d-D3ATYpoK.js";
-import { P as PailMiddlewareOptions } from "../packem_shared/create-middleware-logger.d-B-JmQ1Sl.js";
+import { W as WideEvent } from "../packem_shared/wide-event.d-BMLastMR.js";
+import { P as PailMiddlewareOptions } from "../packem_shared/create-middleware-logger.d-BRkkBMlk.js";
 import "../packem_shared/index.d-T71KjNAr.js";
-import 'type-fest';
-import "../packem_shared/types.d-bWnqHJKL.js";
+import "../packem_shared/types.d-4ge_rME4.js";
 import '@visulima/colorize';
 import '@visulima/interactive-manager';
 /**
-* A SvelteKit-like event object with access to the pail logger via `locals.log`.
-* @example
-* ```typescript
-* // In a SvelteKit load function or action:
-* import type { PailSvelteKitEvent } from "@visulima/pail/middleware/sveltekit";
-*
-* export const load = async (event: PailSvelteKitEvent) => {
-*   event.locals.log?.set({ user: { id: 1 } });
-* };
-* ```
-*/
+ * A SvelteKit-like event object with access to the pail logger via `locals.log`.
+ * @example
+ * ```typescript
+ * // In a SvelteKit load function or action:
+ * import type { PailSvelteKitEvent } from "@visulima/pail/middleware/sveltekit";
+ *
+ * export const load = async (event: PailSvelteKitEvent) => {
+ *   event.locals.log?.set({ user: { id: 1 } });
+ * };
+ * ```
+ */
 interface PailSvelteKitEvent {
   [key: string]: unknown;
   locals: Record<string, unknown> & {
@@ -26,8 +25,8 @@ interface PailSvelteKitEvent {
   url: URL;
 }
 /**
-* Options passed to SvelteKit's resolve function.
-*/
+ * Options passed to SvelteKit's resolve function.
+ */
 interface PailSvelteKitResolveOptions {
   filterSerializedResponseHeaders?: (name: string) => boolean;
   preload?: (input: {
@@ -38,23 +37,23 @@ interface PailSvelteKitResolveOptions {
   }) => string;
 }
 /**
-* SvelteKit resolve function type.
-*/
+ * SvelteKit resolve function type.
+ */
 type PailSvelteKitResolve = (event: PailSvelteKitEvent, options?: PailSvelteKitResolveOptions) => Promise<Response>;
 /**
-* Input for the SvelteKit handle hook.
-*/
+ * Input for the SvelteKit handle hook.
+ */
 interface PailSvelteKitHandleInput {
   event: PailSvelteKitEvent;
   resolve: PailSvelteKitResolve;
 }
 /**
-* SvelteKit handle hook function type returned by `pailHandle()`.
-*/
+ * SvelteKit handle hook function type returned by `pailHandle()`.
+ */
 type PailSvelteKitHandle = (input: PailSvelteKitHandleInput) => Promise<Response>;
 /**
-* Input for the SvelteKit handleError hook.
-*/
+ * Input for the SvelteKit handleError hook.
+ */
 interface PailSvelteKitHandleErrorInput {
   error: unknown;
   event: PailSvelteKitEvent;
@@ -62,63 +61,63 @@ interface PailSvelteKitHandleErrorInput {
   status: number;
 }
 /**
-* SvelteKit handleError hook function type returned by `pailHandleError()`.
-*/
+ * SvelteKit handleError hook function type returned by `pailHandleError()`.
+ */
 type PailSvelteKitHandleError = (input: PailSvelteKitHandleErrorInput) => void;
 /**
-* Retrieve the request-scoped WideEvent logger from AsyncLocalStorage.
-* Must be called within a request handled by the pail SvelteKit handle hook.
-* @returns The request-scoped WideEvent logger
-* @throws Error if called outside of the hook context
-*/
+ * Retrieve the request-scoped WideEvent logger from AsyncLocalStorage.
+ * Must be called within a request handled by the pail SvelteKit handle hook.
+ * @returns The request-scoped WideEvent logger
+ * @throws Error if called outside of the hook context
+ */
 declare const useLogger: () => WideEvent;
 type SvelteKitHandleOptions<T extends string = string> = PailMiddlewareOptions<T>;
 /**
-* Create a SvelteKit `handle` hook that attaches a WideEvent logger to each request.
-*
-* The logger is available via:
-* - `event.locals.log` in server load functions and actions
-* - `useLogger()` from anywhere in the async call stack
-*
-* The wide event is automatically emitted when the response is sent or an error occurs.
-* @param options Hook configuration
-* @returns SvelteKit handle hook function
-* @example
-* ```typescript
-* // src/hooks.server.ts
-* import { createPail } from "@visulima/pail";
-* import { pailHandle, pailHandleError } from "@visulima/pail/middleware/sveltekit";
-*
-* const logger = createPail();
-*
-* export const handle = pailHandle({ pail: logger });
-* export const handleError = pailHandleError();
-* ```
-*/
+ * Create a SvelteKit `handle` hook that attaches a WideEvent logger to each request.
+ *
+ * The logger is available via:
+ * - `event.locals.log` in server load functions and actions
+ * - `useLogger()` from anywhere in the async call stack
+ *
+ * The wide event is automatically emitted when the response is sent or an error occurs.
+ * @param options Hook configuration
+ * @returns SvelteKit handle hook function
+ * @example
+ * ```typescript
+ * // src/hooks.server.ts
+ * import { createPail } from "@visulima/pail";
+ * import { pailHandle, pailHandleError } from "@visulima/pail/middleware/sveltekit";
+ *
+ * const logger = createPail();
+ *
+ * export const handle = pailHandle({ pail: logger });
+ * export const handleError = pailHandleError();
+ * ```
+ */
 declare const pailHandle: <T extends string = string>(options: SvelteKitHandleOptions<T>) => PailSvelteKitHandle;
 /**
-* Create a SvelteKit `handleError` hook that captures errors into the WideEvent logger.
-*
-* Should be used alongside `pailHandle` to ensure errors are recorded in the wide event.
-* @returns SvelteKit handleError hook function
-*/
+ * Create a SvelteKit `handleError` hook that captures errors into the WideEvent logger.
+ *
+ * Should be used alongside `pailHandle` to ensure errors are recorded in the wide event.
+ * @returns SvelteKit handleError hook function
+ */
 declare const pailHandleError: () => PailSvelteKitHandleError;
 /**
-* Convenience function that returns both handle and handleError hooks.
-* @param options Hook configuration
-* @returns Object with `handle` and `handleError` hooks
-* @example
-* ```typescript
-* // src/hooks.server.ts
-* import { createPail } from "@visulima/pail";
-* import { createPailHooks } from "@visulima/pail/middleware/sveltekit";
-*
-* const logger = createPail();
-* const { handle, handleError } = createPailHooks({ pail: logger });
-*
-* export { handle, handleError };
-* ```
-*/
+ * Convenience function that returns both handle and handleError hooks.
+ * @param options Hook configuration
+ * @returns Object with `handle` and `handleError` hooks
+ * @example
+ * ```typescript
+ * // src/hooks.server.ts
+ * import { createPail } from "@visulima/pail";
+ * import { createPailHooks } from "@visulima/pail/middleware/sveltekit";
+ *
+ * const logger = createPail();
+ * const { handle, handleError } = createPailHooks({ pail: logger });
+ *
+ * export { handle, handleError };
+ * ```
+ */
 declare const createPailHooks: <T extends string = string>(options: SvelteKitHandleOptions<T>) => {
   handle: PailSvelteKitHandle;
   handleError: PailSvelteKitHandleError;