tempo.ts 0.6.2 → 0.7.1

package/dist/server/Handler.js

@@ -0,0 +1,441 @@
+import { createRouter } from '@remix-run/fetch-router';
+import { RpcRequest, RpcResponse } from 'ox';
+import * as Base64 from 'ox/Base64';
+import * as Hex from 'ox/Hex';
+import { createClient } from 'viem';
+import { signTransaction } from 'viem/actions';
+import { formatTransaction } from '../viem/Formatters.js';
+import * as Transaction from '../viem/Transaction.js';
+import * as RequestListener from './internal/requestListener.js';
+/**
+ * Instantiates a new request handler.
+ *
+ * @param options - constructor options
+ * @returns Handler instance
+ */
+export function from() {
+    const router = createRouter();
+    return {
+        ...router,
+        listener: RequestListener.fromFetchHandler((request) => {
+            return router.fetch(request);
+        }),
+    };
+}
+/**
+ * Defines a Key Manager request handler.
+ *
+ * @example
+ * ### Cloudflare Worker
+ *
+ * ```ts
+ * import { env } from 'cloudflare:workers'
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * export default {
+ *   fetch(request) {
+ *     return Handler.keyManager({
+ *       kv: Kv.cloudflare(env.KEY_STORE),
+ *     }).fetch(request)
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ### Next.js
+ *
+ * ```ts
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const handler = Handler.keyManager({
+ *   kv: Kv.memory(),
+ * })
+ *
+ * export GET = handler.fetch
+ * export POST = handler.fetch
+ * ```
+ *
+ * @example
+ * ### Hono
+ *
+ * ```ts
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const handler = Handler.keyManager({
+ *   kv: Kv.memory(),
+ * })
+ *
+ * const app = new Hono()
+ * app.all('*', handler)
+ *
+ * export default app
+ * ```
+ *
+ * @example
+ * ### Node.js
+ *
+ * ```ts
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const handler = Handler.keyManager({
+ *   kv: Kv.memory(),
+ * })
+ *
+ * const server = createServer(handler.listener)
+ * server.listen(3000)
+ * ```
+ *
+ * @example
+ * ### Bun
+ *
+ * ```ts
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const handler = Handler.keyManager({
+ *   kv: Kv.memory(),
+ * })
+ *
+ * Bun.serve(handler)
+ * ```
+ *
+ * @example
+ * ### Deno
+ *
+ * ```ts
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const handler = Handler.keyManager({
+ *   kv: Kv.memory(),
+ * })
+ *
+ * Deno.serve(handler)
+ * ```
+ *
+ * @example
+ * ### Express
+ *
+ * ```ts
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const handler = Handler.keyManager({
+ *   kv: Kv.memory(),
+ * })
+ *
+ * const app = express()
+ * app.use(handler.listener)
+ * app.listen(3000)
+ * ```
+ *
+ * @param options - Options.
+ * @returns Request handler.
+ */
+export function keyManager(options) {
+    const { kv } = options;
+    const path = options.path ?? '';
+    const rp = (() => {
+        if (typeof options.rp === 'string')
+            return { id: options.rp, name: options.rp };
+        if (options.rp)
+            return {
+                id: options.rp.id,
+                name: options.rp.name ?? options.rp.id,
+            };
+        return undefined;
+    })();
+    const router = from();
+    // Get challenge for WebAuthn credential creation
+    router.get(`${path}/challenge`, async () => {
+        // Generate a random challenge
+        const challenge = Hex.random(32);
+        // Store challenge in KV with 5 minute expiration
+        await kv.set(`challenge:${challenge}`, '1');
+        return Response.json({
+            challenge,
+            ...(rp ? { rp } : {}),
+        });
+    });
+    // Get public key for a credential
+    router.get(`${path}/:id`, async ({ params }) => {
+        const { id } = params;
+        const publicKey = await kv.get(`credential:${id}`);
+        if (!publicKey)
+            return new Response('Credential not found', { status: 404 });
+        return Response.json({
+            publicKey,
+        });
+    });
+    // Set public key for a credential
+    router.post(`${path}/:id`, async ({ params, request }) => {
+        const { id } = params;
+        const { credential, publicKey } = (await request.json());
+        if (!credential)
+            return Response.json({ error: 'Missing `credential`' }, { status: 400 });
+        if (!publicKey)
+            return Response.json({ error: 'Missing `publicKey`' }, { status: 400 });
+        // Decode and verify clientDataJSON
+        const clientDataJSON = JSON.parse(Base64.toString(credential.response.clientDataJSON));
+        // Verify challenge
+        const challenge = Base64.toHex(clientDataJSON.challenge);
+        if (!(await kv.get(`challenge:${challenge}`)))
+            return Response.json({ error: 'Invalid or expired `challenge`' }, { status: 400 });
+        // Verify type
+        if (clientDataJSON.type !== 'webauthn.create')
+            return Response.json({ error: 'Invalid `clientDataJSON.type`' }, { status: 400 });
+        // Verify origin
+        if (rp?.id &&
+            !rp.id.includes('localhost') &&
+            clientDataJSON.origin !== new URL(`https://${rp.id}`).origin)
+            return Response.json({ error: 'Invalid `clientDataJSON.origin`' }, { status: 400 });
+        // Parse authenticatorData
+        const authenticatorData = Base64.toBytes(credential.response.authenticatorData);
+        // Parse flags (byte 32)
+        const flags = authenticatorData[32];
+        if (!flags)
+            return Response.json({ error: 'Invalid `authenticatorData`' }, { status: 400 });
+        // Check User Present (UP) flag (bit 0)
+        const userPresent = (flags & 0x01) !== 0;
+        if (!userPresent)
+            return Response.json({ error: 'User not present' }, { status: 400 });
+        // Consume the challenge (delete it so it can't be reused)
+        await kv.delete(`challenge:${challenge}`);
+        // Store the public key
+        await kv.set(`credential:${id}`, publicKey);
+        return new Response(null, { status: 204 });
+    });
+    return router;
+}
+/**
+ * Instantiates a fee payer service request handler that can be used to
+ * sponsor the fee for user transactions.
+ *
+ * @example
+ * ### Cloudflare Worker
+ *
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { tempo } from 'tempo.ts/chains'
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const client = createClient({
+ *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   transport: http(),
+ * })
+ *
+ * export default {
+ *   fetch(request) {
+ *     return Handler.feePayer({
+ *       account: privateKeyToAccount('0x...'),
+ *       client,
+ *     }).fetch(request)
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ### Next.js
+ *
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { tempo } from 'tempo.ts/chains'
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const client = createClient({
+ *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   transport: http(),
+ * })
+ *
+ * const handler = Handler.feePayer({
+ *   account: privateKeyToAccount('0x...'),
+ *   client,
+ * })
+ *
+ * export GET = handler.fetch
+ * export POST = handler.fetch
+ * ```
+ *
+ * @example
+ * ### Hono
+ *
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { tempo } from 'tempo.ts/chains'
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const client = createClient({
+ *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   transport: http(),
+ * })
+ *
+ * const handler = Handler.feePayer({
+ *   account: privateKeyToAccount('0x...'),
+ *   client,
+ * })
+ *
+ * const app = new Hono()
+ * app.all('*', handler)
+ *
+ * export default app
+ * ```
+ *
+ * @example
+ * ### Node.js
+ *
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { tempo } from 'tempo.ts/chains'
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const client = createClient({
+ *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   transport: http(),
+ * })
+ *
+ * const handler = Handler.feePayer({
+ *   account: privateKeyToAccount('0x...'),
+ *   client,
+ * })
+ *
+ * const server = createServer(handler.listener)
+ * server.listen(3000)
+ * ```
+ *
+ * @example
+ * ### Bun
+ *
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { tempo } from 'tempo.ts/chains'
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const client = createClient({
+ *   account: privateKeyToAccount('0x...'),
+ *   chain: tempo({
+ *     feeToken: '0x20c0000000000000000000000000000000000001',
+ *   }),
+ *   transport: http(),
+ * })
+ *
+ * const handler = Handler.feePayer({
+ *   account: privateKeyToAccount('0x...'),
+ *   client,
+ * })
+ *
+ * Bun.serve(handler)
+ * ```
+ *
+ * @example
+ * ### Deno
+ *
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { tempo } from 'tempo.ts/chains'
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const client = createClient({
+ *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   transport: http(),
+ * })
+ *
+ * const handler = Handler.feePayer({
+ *   account: privateKeyToAccount('0x...'),
+ *   client,
+ * })
+ *
+ * Deno.serve(handler)
+ * ```
+ *
+ * @example
+ * ### Express
+ *
+ * ```ts
+ * import { createClient, http } from 'viem'
+ * import { privateKeyToAccount } from 'viem/accounts'
+ * import { tempo } from 'tempo.ts/chains'
+ * import { Handler } from 'tempo.ts/server'
+ *
+ * const client = createClient({
+ *   chain: tempo({ feeToken: '0x20c0000000000000000000000000000000000001' }),
+ *   transport: http(),
+ * })
+ *
+ * const handler = Handler.feePayer({
+ *   account: privateKeyToAccount('0x...'),
+ *   client,
+ * })
+ *
+ * const app = express()
+ * app.use(handler.listener)
+ * app.listen(3000)
+ * ```
+ *
+ * @param options - Options.
+ * @returns Request handler.
+ */
+export function feePayer(options) {
+    const { account, onRequest, path = '/' } = options;
+    const client = (() => {
+        if ('client' in options)
+            return options.client;
+        if ('chain' in options && 'transport' in options)
+            return createClient({
+                chain: options.chain,
+                transport: options.transport,
+            });
+        throw new Error('No client or chain provided');
+    })();
+    const router = from();
+    router.post(path, async ({ request: req }) => {
+        const request = RpcRequest.from((await req.json()));
+        await onRequest?.(request);
+        if (request.method === 'eth_signTransaction') {
+            const transactionRequest = formatTransaction(request.params?.[0]);
+            const serializedTransaction = await signTransaction(client, {
+                ...transactionRequest,
+                account,
+                // @ts-expect-error
+                feePayer: account,
+            });
+            return Response.json(RpcResponse.from({ result: serializedTransaction }, { request }));
+        }
+        if (request.method === 'eth_signRawTransaction') {
+            const serialized = request.params?.[0];
+            const transaction = Transaction.deserialize(serialized);
+            const serializedTransaction = await signTransaction(client, {
+                ...transaction,
+                account,
+                // @ts-expect-error
+                feePayer: account,
+            });
+            return Response.json(RpcResponse.from({ result: serializedTransaction }, { request }));
+        }
+        if (request.method === 'eth_sendRawTransaction' ||
+            request.method === 'eth_sendRawTransactionSync') {
+            const serialized = request.params?.[0];
+            const transaction = Transaction.deserialize(serialized);
+            const serializedTransaction = await signTransaction(client, {
+                ...transaction,
+                account,
+                // @ts-expect-error
+                feePayer: account,
+            });
+            const result = await client.request({
+                method: request.method,
+                params: [serializedTransaction],
+            });
+            return Response.json(RpcResponse.from({ result }, { request }));
+        }
+        return Response.json(RpcResponse.from({
+            error: new RpcResponse.MethodNotSupportedError({
+                message: `Method not supported: ${request.method}`,
+            }),
+        }, { request }), { status: 400 });
+    });
+    return router;
+}
+//# sourceMappingURL=Handler.js.map

package/dist/server/Handler.js.map

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

package/dist/server/Kv.d.ts

@@ -0,0 +1,16 @@
+export type Kv = {
+    get: <value = unknown>(key: string) => Promise<value>;
+    set: (key: string, value: unknown) => Promise<void>;
+    delete: (key: string) => Promise<void>;
+};
+export declare function from<kv extends Kv>(kv: kv): kv;
+export declare function cloudflare(kv: cloudflare.Parameters): Kv;
+export declare namespace cloudflare {
+    type Parameters = {
+        get: <value = unknown>(key: string) => Promise<value>;
+        put: (key: string, value: any) => Promise<void>;
+        delete: (key: string) => Promise<void>;
+    };
+}
+export declare function memory(): Kv;
+//# sourceMappingURL=Kv.d.ts.map

package/dist/server/Kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Kv.d.ts","sourceRoot":"","sources":["../../src/server/Kv.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,EAAE,GAAG;IACf,GAAG,EAAE,CAAC,KAAK,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;IACrD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC,CAAA;AAED,wBAAgB,IAAI,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAE9C;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,UAAU,GAAG,EAAE,CAMxD;AAED,MAAM,CAAC,OAAO,WAAW,UAAU,CAAC;IAClC,KAAY,UAAU,GAAG;QACvB,GAAG,EAAE,CAAC,KAAK,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;QACrD,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;QAC/C,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KACvC,CAAA;CACF;AAED,wBAAgB,MAAM,IAAI,EAAE,CAa3B"}

package/dist/server/Kv.js

@@ -0,0 +1,25 @@
+export function from(kv) {
+    return kv;
+}
+export function cloudflare(kv) {
+    return from({
+        delete: kv.delete.bind(kv),
+        get: kv.get.bind(kv),
+        set: kv.put.bind(kv),
+    });
+}
+export function memory() {
+    const store = new Map();
+    return from({
+        async delete(key) {
+            Promise.resolve(store.delete(key));
+        },
+        async get(key) {
+            return store.get(key);
+        },
+        async set(key, value) {
+            store.set(key, value);
+        },
+    });
+}
+//# sourceMappingURL=Kv.js.map

package/dist/server/Kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Kv.js","sourceRoot":"","sources":["../../src/server/Kv.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,IAAI,CAAgB,EAAM;IACxC,OAAO,EAAE,CAAA;AACX,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,EAAyB;IAClD,OAAO,IAAI,CAAC;QACV,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;KACrB,CAAC,CAAA;AACJ,CAAC;AAUD,MAAM,UAAU,MAAM;IACpB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAmB,CAAA;IACxC,OAAO,IAAI,CAAC;QACV,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;QACpC,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAQ,CAAA;QAC9B,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK;YAClB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QACvB,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+export * as Handler from './Handler.js';
+export * as Kv from './Kv.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA"}

package/dist/server/index.js

@@ -0,0 +1,3 @@
+export * as Handler from './Handler.js';
+export * as Kv from './Kv.js';
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAA"}

package/dist/server/internal/requestListener.d.ts

@@ -0,0 +1,124 @@
+import type * as http from 'node:http';
+import type * as http2 from 'node:http2';
+export interface RequestListenerOptions {
+    /**
+     * Overrides the host portion of the incoming request URL. By default the request URL host is
+     * derived from the HTTP `Host` header.
+     *
+     * For example, if you have a `$HOST` environment variable that contains the hostname of your
+     * server, you can use it to set the host of all incoming request URLs like so:
+     *
+     * ```ts
+     * createRequestListener(handler, { host: process.env.HOST })
+     * ```
+     */
+    host?: string;
+    /**
+     * An error handler that determines the response when the request handler throws an error. By
+     * default a 500 Internal Server Error response will be sent.
+     */
+    onError?: ErrorHandler;
+    /**
+     * Overrides the protocol of the incoming request URL. By default the request URL protocol is
+     * derived from the connection protocol. So e.g. when serving over HTTPS (using
+     * `https.createServer()`), the request URL will begin with `https:`.
+     */
+    protocol?: string;
+}
+/**
+ * Wraps a fetch handler in a Node.js request listener that can be used with:
+ *
+ * - [`http.createServer()`](https://nodejs.org/api/http.html#httpcreateserveroptions-requestlistener)
+ * - [`https.createServer()`](https://nodejs.org/api/https.html#httpscreateserveroptions-requestlistener)
+ * - [`http2.createServer()`](https://nodejs.org/api/http2.html#http2createserveroptions-onrequesthandler)
+ * - [`http2.createSecureServer()`](https://nodejs.org/api/http2.html#http2createsecureserveroptions-onrequesthandler)
+ *
+ * Example:
+ *
+ * ```ts
+ * import * as http from 'node:http';
+ * import { createRequestListener } from '@mjackson/node-fetch-server';
+ *
+ * async function handler(request) {
+ *   return new Response('Hello, world!');
+ * }
+ *
+ * let server = http.createServer(
+ *   createRequestListener(handler)
+ * );
+ *
+ * server.listen(3000);
+ * ```
+ *
+ * @param handler The fetch handler to use for processing incoming requests.
+ * @param options Request listener options.
+ * @returns A Node.js request listener function.
+ */
+export declare function fromFetchHandler(handler: FetchHandler, options?: RequestListenerOptions): http.RequestListener;
+export type RequestOptions = Omit<RequestListenerOptions, 'onError'>;
+/**
+ * Creates a [`Request`](https://developer.mozilla.org/en-US/docs/Web/API/Request) object from
+ *
+ * - a [`http.IncomingMessage`](https://nodejs.org/api/http.html#class-httpincomingmessage)/[`http.ServerResponse`](https://nodejs.org/api/http.html#class-httpserverresponse) pair
+ * - a [`http2.Http2ServerRequest`](https://nodejs.org/api/http2.html#class-http2http2serverrequest)/[`http2.Http2ServerResponse`](https://nodejs.org/api/http2.html#class-http2http2serverresponse) pair
+ *
+ * @param req The incoming request object.
+ * @param res The server response object.
+ * @param options
+ * @returns A request object.
+ */
+export declare function createRequest(req: http.IncomingMessage | http2.Http2ServerRequest, res: http.ServerResponse | http2.Http2ServerResponse, options?: RequestOptions): Request;
+/**
+ * Creates a [`Headers`](https://developer.mozilla.org/en-US/docs/Web/API/Headers) object from the headers in a Node.js
+ * [`http.IncomingMessage`](https://nodejs.org/api/http.html#class-httpincomingmessage)/[`http2.Http2ServerRequest`](https://nodejs.org/api/http2.html#class-http2http2serverrequest).
+ *
+ * @param req The incoming request object.
+ * @returns A headers object.
+ */
+export declare function createHeaders(req: http.IncomingMessage | http2.Http2ServerRequest): Headers;
+/**
+ * Sends a [`Response`](https://developer.mozilla.org/en-US/docs/Web/API/Response) to the client using a Node.js
+ * [`http.ServerResponse`](https://nodejs.org/api/http.html#class-httpserverresponse)/[`http2.Http2ServerResponse`](https://nodejs.org/api/http2.html#class-http2http2serverresponse)
+ * object.
+ *
+ * @param res The server response object.
+ * @param response The response to send.
+ */
+export declare function sendResponse(res: http.ServerResponse | http2.Http2ServerResponse, response: Response): Promise<void>;
+export declare function readStream(stream: ReadableStream<Uint8Array>): AsyncIterable<Uint8Array>;
+export interface ClientAddress {
+    /**
+     * The IP address of the client that sent the request.
+     *
+     * [Node.js Reference](https://nodejs.org/api/net.html#socketremoteaddress)
+     */
+    address: string;
+    /**
+     * The family of the client IP address.
+     *
+     * [Node.js Reference](https://nodejs.org/api/net.html#socketremotefamily)
+     */
+    family: 'IPv4' | 'IPv6';
+    /**
+     * The remote port of the client that sent the request.
+     *
+     * [Node.js Reference](https://nodejs.org/api/net.html#socketremoteport)
+     */
+    port: number;
+}
+/**
+ * A function that handles an error that occurred during request handling. May return a response to
+ * send to the client, or `undefined` to allow the server to send a default error response.
+ *
+ * [MDN `Response` Reference](https://developer.mozilla.org/en-US/docs/Web/API/Response)
+ */
+export type ErrorHandler = (error: unknown) => undefined | Response | Promise<undefined | Response>;
+/**
+ * A function that handles an incoming request and returns a response.
+ *
+ * [MDN `Request` Reference](https://developer.mozilla.org/en-US/docs/Web/API/Request)
+ *
+ * [MDN `Response` Reference](https://developer.mozilla.org/en-US/docs/Web/API/Response)
+ */
+export type FetchHandler = (request: Request, client: ClientAddress) => Response | Promise<Response>;
+//# sourceMappingURL=requestListener.d.ts.map

package/dist/server/internal/requestListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestListener.d.ts","sourceRoot":"","sources":["../../../src/server/internal/requestListener.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,IAAI,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,KAAK,KAAK,MAAM,YAAY,CAAA;AAExC,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;OAUG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,IAAI,CAAC,eAAe,CAyBtB;AAuBD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,sBAAsB,EAAE,SAAS,CAAC,CAAA;AAEpE;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,kBAAkB,EACpD,GAAG,EAAE,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,mBAAmB,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAuCT;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,kBAAkB,GACnD,OAAO,CAUT;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,mBAAmB,EACpD,QAAQ,EAAE,QAAQ,GACjB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAED,wBAAuB,UAAU,CAC/B,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GACjC,aAAa,CAAC,UAAU,CAAC,CAQ3B;AAED,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,KAAK,EAAE,OAAO,KACX,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAA;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,aAAa,KAClB,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA"}