@routedock/routedock 0.2.0 → 0.3.1

package/dist/MppSessionHandler-CLB5SzgN.d.ts

@@ -1,121 +0,0 @@
-import { RequestHandler } from 'express';
-import { Store } from 'mppx';
-import { R as RouteDockManifest } from './types-DmhmfLzP.js';
-
-/**
- * Idempotency store for payment settlement.
- *
- * `x402Handler` and `MppChargeHandler` settle on every request carrying a
- * payment header. An agent that retries after a post-settlement network
- * timeout resends the *same* signed payment, which would settle a second time
- * and invoke `onSettled` twice — double-counting in billing.
- *
- * Before settling, a handler derives an idempotency key from the inbound
- * payment header(s) and checks this store. On a hit it replays the cached
- * settlement response and skips both the on-chain settle and `onSettled`.
- *
- * The default {@link InMemorySeenTxStore} is per-handler and per-process. For
- * multi-instance deployments, supply a shared implementation backed by Redis,
- * Supabase, etc.
- */
-/** Cached outcome of a settlement, replayed on a duplicate payment. */
-interface SettlementRecord {
-    /** On-chain transaction hash (or settlement reference), if known. */
-    txHash: string | null;
-    /** Response headers to re-apply on a replay (e.g. `X-Payment-Response`). */
-    headers?: Record<string, string>;
-}
-interface SeenTxStore {
-    /** Returns the cached settlement for a key, or `undefined` if unseen. */
-    get(key: string): Promise<SettlementRecord | undefined> | SettlementRecord | undefined;
-    /** Records the settlement outcome for a key. */
-    set(key: string, record: SettlementRecord): Promise<void> | void;
-}
-interface InMemorySeenTxStoreOptions {
-    /** Maximum number of entries before FIFO eviction. Defaults to 10,000. */
-    maxEntries?: number;
-    /** Log a startup warning about non-durability. Defaults to true. */
-    warn?: boolean;
-}
-/**
- * Default in-memory {@link SeenTxStore}. Bounded by `maxEntries` with FIFO
- * eviction so a long-running process cannot grow without limit.
- *
- * **Not durable.** On serverless/edge runtimes each request may land on a
- * fresh isolate with an empty cache, which causes duplicate settlements.
- * Supply a persistent implementation (Supabase, Redis, …) in production.
- */
-declare class InMemorySeenTxStore implements SeenTxStore {
-    private readonly map;
-    private readonly order;
-    constructor(maxEntriesOrOptions?: number | InMemorySeenTxStoreOptions);
-    private readonly maxEntries;
-    get(key: string): SettlementRecord | undefined;
-    set(key: string, record: SettlementRecord): void;
-}
-/**
- * Derive a collision-resistant idempotency key from the inbound
- * payment-bearing headers. Uses SHA-256 instead of 32-bit FNV-1a
- * (which has a 2^32 keyspace — birthday collisions become likely
- * well before the 10_000-entry default store is full).
- *
- * x402 clients send the signed payment in `payment-signature` / `x-payment`;
- * mppx clients send it in `authorization` (the `Payment` scheme). A retry
- * resends byte-identical headers, so hashing the first present one yields a
- * stable key. Returns `null` when no payment header is present (nothing to
- * dedupe — e.g. the initial 402 challenge request).
- */
-declare function paymentIdempotencyKey(getHeader: (name: string) => string | undefined): Promise<string | null>;
-
-/** Store shape extended with optional atomic update operation. */
-type ChannelStore = Store.Store & {
-    update?: (key: string, fn: (prev: unknown) => unknown) => Promise<unknown>;
-};
-/** Expected payload shape for voucher cumulative amount entries. */
-interface VoucherStoreValue {
-    amount: string;
-    [key: string]: unknown;
-}
-/** Validates that a stored store value is an object containing a numeric string amount. */
-declare function isVoucherStoreValue(value: unknown): value is VoucherStoreValue;
-type Network = 'testnet' | 'mainnet';
-/** Why a live session was flagged as orphaned (never cleanly closed). */
-type OrphanReason = 'connection-closed' | 'idle-timeout';
-/** Latest signed state of an orphaned session, enough for the reconciler to settle. */
-interface OrphanedSessionInfo {
-    /** Cumulative amount of the highest voucher seen (human-readable, 7 dp). */
-    cumulativeAmount: string;
-    /** Hex-encoded signature of the highest voucher seen. */
-    lastSignature: string;
-    /** Number of vouchers received before teardown. */
-    voucherCount: number;
-    /** What triggered the orphan flag. */
-    reason: OrphanReason;
-}
-interface MppSessionHandlerOptions {
-    payeeSecretKey: string;
-    network: Network;
-    channelFactory: string;
-    rate: string;
-    assetContract: string;
-    manifest: RouteDockManifest;
-    commitmentPublicKey: string;
-    onSettled?: (txHash: string, totalPaid: string, mode: string, payer: string | null) => Promise<void>;
-    onSessionOpen?: (channelId: string, payer: string | null) => Promise<void>;
-    onVoucher?: (channelId: string, voucherIndex: number, cumulativeAmount: string, signature: string) => Promise<void>;
-    onCallbackError?: (err: unknown, cb: string) => void;
-    /**
-     * Called when the client connection drops mid-session or the session goes
-     * idle, before a clean close. Persist the session as `closing` so the
-     * SessionReconciler can settle it with the latest signed voucher.
-     */
-    onOrphaned?: (channelId: string, info: OrphanedSessionInfo) => Promise<void>;
-    /**
-     * Flag the session orphaned after this many milliseconds with no voucher
-     * activity. Disabled when unset.
-     */
-    idleTimeoutMs?: number;
-}
-declare function createMppSessionHandler(opts: MppSessionHandlerOptions): RequestHandler;
-
-export { type ChannelStore as C, InMemorySeenTxStore as I, type MppSessionHandlerOptions as M, type OrphanedSessionInfo as O, type SeenTxStore as S, type VoucherStoreValue as V, type SettlementRecord as a, type InMemorySeenTxStoreOptions as b, type OrphanReason as c, createMppSessionHandler as d, isVoucherStoreValue as i, paymentIdempotencyKey as p };