accounts 0.6.0 → 0.6.2

package/dist/server/Handler.d.ts

@@ -1,9 +1,8 @@
 import { Hono } from 'hono';
-import { RpcRequest } from 'ox';
-import { type Chain, type Transport } from 'viem';
-import type { LocalAccount } from 'viem/accounts';
-import * as CliAuth from './CliAuth.js';
-import * as Kv from './Kv.js';
+export { codeAuth } from './internal/handlers/codeAuth.js';
+export { feePayer } from './internal/handlers/feePayer.js';
+export { relay } from './internal/handlers/relay.js';
+export { webAuthn } from './internal/handlers/webAuthn.js';
 export type Handler = Hono & {
     listener: (req: any, res: any) => void;
 };
@@ -48,251 +47,4 @@ export declare namespace from {
         maxAge?: number | undefined;
     };
 }
-/**
- * Instantiates a fee payer service request handler that can be used to
- * sponsor the fee for user transactions.
- *
- * @example
- * ### Cloudflare Worker
- *
- * ```ts
- * import { privateKeyToAccount } from 'viem/accounts'
- * import { Handler } from 'accounts/server'
- *
- * export default {
- *   fetch(request) {
- *     return Handler.feePayer({
- *       account: privateKeyToAccount('0x...'),
- *     }).fetch(request)
- *   }
- * }
- * ```
- *
- * @example
- * ### Next.js
- *
- * ```ts
- * import { privateKeyToAccount } from 'viem/accounts'
- * import { Handler } from 'accounts/server'
- *
- * const handler = Handler.feePayer({
- *   account: privateKeyToAccount('0x...'),
- * })
- *
- * export GET = handler.fetch
- * export POST = handler.fetch
- * ```
- *
- * @example
- * ### Hono
- *
- * ```ts
- * import { privateKeyToAccount } from 'viem/accounts'
- * import { Handler } from 'accounts/server'
- *
- * const handler = Handler.feePayer({
- *   account: privateKeyToAccount('0x...'),
- * })
- *
- * const app = new Hono()
- * app.all('*', handler)
- *
- * export default app
- * ```
- *
- * @example
- * ### Node.js
- *
- * ```ts
- * import { privateKeyToAccount } from 'viem/accounts'
- * import { Handler } from 'accounts/server'
- *
- * const handler = Handler.feePayer({
- *   account: privateKeyToAccount('0x...'),
- * })
- *
- * const server = createServer(handler.listener)
- * server.listen(3000)
- * ```
- *
- * @example
- * ### Bun
- *
- * ```ts
- * import { privateKeyToAccount } from 'viem/accounts'
- * import { Handler } from 'accounts/server'
- *
- * const handler = Handler.feePayer({
- *   account: privateKeyToAccount('0x...'),
- * })
- *
- * Bun.serve(handler)
- * ```
- *
- * @example
- * ### Deno
- *
- * ```ts
- * import { privateKeyToAccount } from 'viem/accounts'
- * import { Handler } from 'accounts/server'
- *
- * const handler = Handler.feePayer({
- *   account: privateKeyToAccount('0x...'),
- * })
- *
- * Deno.serve(handler)
- * ```
- *
- * @example
- * ### Express
- *
- * ```ts
- * import { privateKeyToAccount } from 'viem/accounts'
- * import { Handler } from 'accounts/server'
- *
- * const handler = Handler.feePayer({
- *   account: privateKeyToAccount('0x...'),
- * })
- *
- * const app = express()
- * app.use(handler.listener)
- * app.listen(3000)
- * ```
- *
- * @example
- * ### Custom chains & transports
- *
- * ```ts
- * import { http } from 'viem'
- * import { privateKeyToAccount } from 'viem/accounts'
- * import { tempo, tempoModerato } from 'viem/chains'
- * import { Handler } from 'accounts/server'
- *
- * const handler = Handler.feePayer({
- *   account: privateKeyToAccount('0x...'),
- *   chains: [tempo, tempoModerato],
- *   transports: {
- *     [tempo.id]: http('https://rpc.tempo.xyz'),
- *     [tempoModerato.id]: http('https://rpc.testnet.tempo.xyz'),
- *   },
- * })
- * ```
- *
- * @param options - Options.
- * @returns Request handler.
- */
-export declare function feePayer(options: feePayer.Options): Handler;
-export declare namespace feePayer {
-    type Options = from.Options & {
-        /** Account to use as the fee payer. */
-        account: LocalAccount;
-        /**
-         * Supported chains. The handler resolves the client based on the
-         * `chainId` in the incoming transaction.
-         * @default [tempo, tempoModerato]
-         */
-        chains?: readonly [Chain, ...Chain[]] | undefined;
-        /** Function to call before handling the request. */
-        onRequest?: (request: RpcRequest.RpcRequest) => Promise<void>;
-        /** Path to use for the handler. */
-        path?: string | undefined;
-        /** Sponsor display name returned from `eth_fillTransaction`. */
-        name?: string | undefined;
-        /** Transports keyed by chain ID. Defaults to `http()` for each chain. */
-        transports?: Record<number, Transport> | undefined;
-        /** Sponsor URL returned from `eth_fillTransaction`. */
-        url?: string | undefined;
-    };
-}
-/**
- * Instantiates a generic device-code handler for access-key bootstrap.
- *
- * Exposes 4 endpoints:
- * - `GET /auth/pkce/pending/:code`
- * - `POST /auth/pkce/code`
- * - `POST /auth/pkce/poll/:code`
- * - `POST /auth/pkce`
- *
- * @param options - Options.
- * @returns Request handler.
- */
-export declare function codeAuth(options?: codeAuth.Options): Handler;
-export declare namespace codeAuth {
-    type Options = from.Options & {
-        /**
-         * Supported chains. The handler resolves the client based on chain IDs carried
-         * by device-code requests and key authorizations.
-         * @default [tempo, tempoModerato]
-         */
-        chains?: readonly [Chain, ...Chain[]] | undefined;
-        /** Time source used for TTL evaluation. */
-        now?: (() => number) | undefined;
-        /** Path prefix for the code auth endpoints. @default "/auth/pkce" */
-        path?: string | undefined;
-        /** Policy used to validate and default requested CLI auth fields. */
-        policy?: CliAuth.Policy | undefined;
-        /** Random byte generator used for device-code allocation. */
-        random?: ((size: number) => Uint8Array) | undefined;
-        /** Device-code store. */
-        store?: CliAuth.Store | undefined;
-        /** Transports keyed by chain ID. Defaults to `http()` for each chain. */
-        transports?: Record<number, Transport> | undefined;
-        /** Pending entry TTL in milliseconds. @default 600000 */
-        ttlMs?: number | undefined;
-    };
-}
-/**
- * Instantiates a WebAuthn ceremony handler that manages registration and
- * authentication flows server-side.
- *
- * Exposes 4 POST endpoints following the webauthx convention:
- * - `POST /register/options` — generate credential creation options
- * - `POST /register` — verify registration and store credential
- * - `POST /login/options` — generate credential request options
- * - `POST /login` — verify authentication
- *
- * @example
- * ```ts
- * import { Handler, Kv } from 'accounts/server'
- *
- * const handler = Handler.webAuthn({
- *   kv: Kv.memory(),
- *   origin: 'https://example.com',
- *   rpId: 'example.com',
- * })
- *
- * export default handler
- * ```
- *
- * @param options - Options.
- * @returns Request handler.
- */
-export declare function webAuthn(options: webAuthn.Options): Handler;
-export declare namespace webAuthn {
-    type Options = from.Options & {
-        /** Maximum age of a challenge in seconds before it expires. @default 300 */
-        challengeTtl?: number | undefined;
-        /** Key-value store for challenges and credentials. */
-        kv: Kv.Kv;
-        /** Called after a successful registration. The returned response is merged onto the default JSON response. */
-        onRegister?: (parameters: {
-            credentialId: string;
-            publicKey: string;
-            request: Request;
-        }) => Response | Promise<Response> | void | Promise<void>;
-        /** Called after a successful authentication. The returned response is merged onto the default JSON response. */
-        onAuthenticate?: (parameters: {
-            credentialId: string;
-            publicKey: string;
-            userId?: string | undefined;
-            request: Request;
-        }) => Response | Promise<Response> | void | Promise<void>;
-        /** Expected origin(s) (e.g. `"https://example.com"` or `["https://a.com", "https://b.com"]`). */
-        origin: string | readonly string[];
-        /** Path prefix for the WebAuthn endpoints (e.g. `"/webauthn"`). @default "" */
-        path?: string | undefined;
-        /** Relying Party ID (e.g. `"example.com"`). */
-        rpId: string;
-    };
-}
 //# sourceMappingURL=Handler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Handler.d.ts","sourceRoot":"","sources":["../../src/server/Handler.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Handler.d.ts","sourceRoot":"","sources":["../../src/server/Handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAI3B,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAE1D,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG;IAC3B,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAA;CACvC,CAAA;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,GAAE,OAAO,CAAC,OAAY,GAAG,OAAO,CAmBxF;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAY,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG;QACnC,uCAAuC;QACvC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC1B,CAAA;CACF;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,OAAO,GAAE,IAAI,CAAC,OAAY,GAAG,OAAO,CAiBxD;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,KAAY,OAAO,GAAG;QACpB;;;;;WAKG;QACH,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,CAAA;QACjC,sCAAsC;QACtC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;KACvD,CAAA;IAED,KAAY,IAAI,GAAG;QACjB,0CAA0C;QAC1C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;QACtC,wEAAwE;QACxE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B,qDAAqD;QACrD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC5B,oCAAoC;QACpC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACjC,wCAAwC;QACxC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAClC,8CAA8C;QAC9C,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC5B,CAAA;CACF"}