mppx 0.0.1 → 0.1.1

package/dist/tempo/client/Session.js

@@ -0,0 +1,263 @@
+import { parseUnits } from 'viem';
+import { tempo as tempo_chain } from 'viem/chains';
+import * as MethodIntent from '../../MethodIntent.js';
+import * as Account from '../../viem/Account.js';
+import * as Client from '../../viem/Client.js';
+import * as z from '../../zod.js';
+import * as Intents from '../Intents.js';
+import * as defaults from '../internal/defaults.js';
+import { signVoucher } from '../stream/Voucher.js';
+import { createOpenPayload, createVoucherPayload, resolveEscrow, serializeCredential, tryRecoverChannel, } from './ChannelOps.js';
+export const streamContextSchema = z.object({
+    account: z.optional(z.custom()),
+    action: z.optional(z.enum(['open', 'topUp', 'voucher', 'close'])),
+    channelId: z.optional(z.string()),
+    cumulativeAmount: z.optional(z.amount()),
+    cumulativeAmountRaw: z.optional(z.string()),
+    transaction: z.optional(z.string()),
+    authorizedSigner: z.optional(z.string()),
+    additionalDeposit: z.optional(z.amount()),
+    additionalDepositRaw: z.optional(z.string()),
+    depositRaw: z.optional(z.string()),
+});
+/**
+ * Creates a session payment MethodIntent plugin for use with `Mppx.create()`.
+ *
+ * Supports both auto mode (set `deposit` to manage channels automatically)
+ * and manual mode (pass `context.action` to control each step).
+ *
+ * @example
+ * ```ts
+ * // Auto mode
+ * import { Mppx, tempo } from 'mppx/client'
+ *
+ * const mppx = Mppx.create({
+ *   methods: [tempo({
+ *     account: privateKeyToAccount('0x...'),
+ *     deposit: '10',
+ *   })],
+ * })
+ *
+ * const res = await mppx.fetch('/api/chat?prompt=hello')
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Manual mode
+ * const mppx = Mppx.create({
+ *   methods: [tempo({ account })],
+ * })
+ *
+ * const credential = await mppx.createCredential(response, {
+ *   action: 'voucher',
+ *   channelId: '0x...',
+ *   cumulativeAmount: '1',
+ * })
+ * ```
+ */
+export function session(parameters = {}) {
+    const { decimals = defaults.decimals } = parameters;
+    const getClient = Client.getResolver({
+        chain: tempo_chain,
+        getClient: parameters.getClient,
+        rpcUrl: defaults.rpcUrl,
+    });
+    const getAccount = Account.getResolver({ account: parameters.account });
+    const maxDeposit = parameters.maxDeposit !== undefined ? parseUnits(parameters.maxDeposit, decimals) : undefined;
+    const escrowContractMap = new Map();
+    const channels = new Map();
+    const channelIdToKey = new Map();
+    function notifyUpdate(entry) {
+        parameters.onChannelUpdate?.(entry);
+    }
+    function channelKey(payee, currency, escrow) {
+        return `${payee.toLowerCase()}:${currency.toLowerCase()}:${escrow.toLowerCase()}`;
+    }
+    function resolveEscrowCached(challenge, chainId, channelId) {
+        if (channelId) {
+            const cached = escrowContractMap.get(channelId);
+            if (cached)
+                return cached;
+        }
+        return resolveEscrow(challenge, chainId, parameters.escrowContract);
+    }
+    async function autoManageCredential(challenge, account, context) {
+        const md = challenge.request.methodDetails;
+        const chainId = md?.chainId ?? 0;
+        const client = await getClient({ chainId });
+        const escrowContract = resolveEscrowCached(challenge, chainId);
+        const payee = challenge.request.recipient;
+        const currency = challenge.request.currency;
+        const amount = BigInt(challenge.request.amount);
+        const suggestedDepositRaw = challenge.request
+            .suggestedDeposit;
+        const suggestedDeposit = suggestedDepositRaw ? BigInt(suggestedDepositRaw) : undefined;
+        const deposit = (() => {
+            if (context?.depositRaw)
+                return BigInt(context.depositRaw);
+            if (suggestedDeposit !== undefined && maxDeposit !== undefined)
+                return suggestedDeposit < maxDeposit ? suggestedDeposit : maxDeposit;
+            if (suggestedDeposit !== undefined)
+                return suggestedDeposit;
+            if (maxDeposit !== undefined)
+                return maxDeposit;
+            if (parameters.deposit !== undefined)
+                return parseUnits(parameters.deposit, decimals);
+            throw new Error('No deposit amount available. Set `deposit`, `maxDeposit`, or ensure the server challenge includes `suggestedDeposit`.');
+        })();
+        const key = channelKey(payee, currency, escrowContract);
+        let entry = channels.get(key);
+        if (!entry) {
+            const suggestedChannelId = (context?.channelId ?? md?.channelId);
+            if (suggestedChannelId) {
+                const recovered = await tryRecoverChannel(client, escrowContract, suggestedChannelId, chainId);
+                if (recovered) {
+                    const contextCumulative = context?.cumulativeAmountRaw
+                        ? BigInt(context.cumulativeAmountRaw)
+                        : context?.cumulativeAmount
+                            ? parseUnits(context.cumulativeAmount, decimals)
+                            : undefined;
+                    if (contextCumulative !== undefined)
+                        recovered.cumulativeAmount = contextCumulative;
+                    channels.set(key, recovered);
+                    channelIdToKey.set(recovered.channelId, key);
+                    escrowContractMap.set(recovered.channelId, escrowContract);
+                    entry = recovered;
+                    notifyUpdate(entry);
+                }
+                else if (context?.channelId) {
+                    throw new Error(`Channel ${context.channelId} cannot be reused (closed or not found on-chain).`);
+                }
+            }
+        }
+        let payload;
+        if (entry?.opened) {
+            entry.cumulativeAmount += amount;
+            payload = await createVoucherPayload(client, account, entry.channelId, entry.cumulativeAmount, escrowContract, chainId, parameters.authorizedSigner);
+            notifyUpdate(entry);
+        }
+        else {
+            const result = await createOpenPayload(client, account, {
+                authorizedSigner: parameters.authorizedSigner,
+                escrowContract,
+                payee,
+                currency,
+                deposit,
+                initialAmount: amount,
+                chainId,
+                feePayer: md?.feePayer,
+            });
+            channels.set(key, result.entry);
+            channelIdToKey.set(result.entry.channelId, key);
+            escrowContractMap.set(result.entry.channelId, escrowContract);
+            payload = result.payload;
+            notifyUpdate(result.entry);
+        }
+        return serializeCredential(challenge, payload, chainId, account);
+    }
+    async function manualCredential(challenge, account, context) {
+        const md = challenge.request.methodDetails;
+        const chainId = md?.chainId ?? 0;
+        const client = await getClient({ chainId });
+        const action = context.action;
+        const { channelId: channelIdRaw, transaction, authorizedSigner } = context;
+        const channelId = channelIdRaw;
+        const cumulativeAmount = context.cumulativeAmountRaw
+            ? BigInt(context.cumulativeAmountRaw)
+            : context.cumulativeAmount
+                ? parseUnits(context.cumulativeAmount, decimals)
+                : undefined;
+        const resolvedAdditionalDeposit = context.additionalDepositRaw
+            ? BigInt(context.additionalDepositRaw)
+            : context.additionalDeposit
+                ? parseUnits(context.additionalDeposit, decimals)
+                : undefined;
+        const escrowContract = resolveEscrowCached(challenge, chainId, channelId);
+        escrowContractMap.set(channelId, escrowContract);
+        let payload;
+        switch (action) {
+            case 'open': {
+                if (!transaction)
+                    throw new Error('transaction required for open action');
+                if (cumulativeAmount === undefined)
+                    throw new Error('cumulativeAmount required for open action');
+                const signature = await signVoucher(client, account, { channelId, cumulativeAmount }, escrowContract, chainId, parameters.authorizedSigner);
+                payload = {
+                    action: 'open',
+                    type: 'transaction',
+                    channelId,
+                    transaction: transaction,
+                    authorizedSigner: authorizedSigner ?? account.address,
+                    cumulativeAmount: cumulativeAmount.toString(),
+                    signature,
+                };
+                break;
+            }
+            case 'topUp':
+                if (!transaction)
+                    throw new Error('transaction required for topUp action');
+                if (resolvedAdditionalDeposit === undefined)
+                    throw new Error('additionalDeposit required for topUp action');
+                payload = {
+                    action: 'topUp',
+                    type: 'transaction',
+                    channelId,
+                    transaction: transaction,
+                    additionalDeposit: resolvedAdditionalDeposit.toString(),
+                };
+                break;
+            case 'voucher': {
+                if (cumulativeAmount === undefined)
+                    throw new Error('cumulativeAmount required for voucher action');
+                payload = await createVoucherPayload(client, account, channelId, cumulativeAmount, escrowContract, chainId, parameters.authorizedSigner);
+                const key = channelIdToKey.get(channelId);
+                if (key) {
+                    const entry = channels.get(key);
+                    if (entry) {
+                        entry.cumulativeAmount =
+                            entry.cumulativeAmount > cumulativeAmount ? entry.cumulativeAmount : cumulativeAmount;
+                        notifyUpdate(entry);
+                    }
+                }
+                break;
+            }
+            case 'close': {
+                if (cumulativeAmount === undefined)
+                    throw new Error('cumulativeAmount required for close action');
+                const signature = await signVoucher(client, account, { channelId, cumulativeAmount }, escrowContract, chainId, parameters.authorizedSigner);
+                payload = {
+                    action: 'close',
+                    channelId,
+                    cumulativeAmount: cumulativeAmount.toString(),
+                    signature,
+                };
+                const closeKey = channelIdToKey.get(channelId);
+                if (closeKey) {
+                    const entry = channels.get(closeKey);
+                    if (entry) {
+                        entry.opened = false;
+                        entry.cumulativeAmount =
+                            entry.cumulativeAmount > cumulativeAmount ? entry.cumulativeAmount : cumulativeAmount;
+                        notifyUpdate(entry);
+                    }
+                }
+                break;
+            }
+        }
+        return serializeCredential(challenge, payload, chainId, account);
+    }
+    return MethodIntent.toClient(Intents.session, {
+        context: streamContextSchema,
+        async createCredential({ challenge, context }) {
+            const chainId = challenge.request.methodDetails?.chainId ?? 0;
+            const client = await getClient({ chainId });
+            const account = getAccount(client, context);
+            if (!context?.action && (parameters.deposit !== undefined || maxDeposit !== undefined))
+                return autoManageCredential(challenge, account, context);
+            if (context?.action)
+                return manualCredential(challenge, account, context);
+            throw new Error('No `action` in context and no `deposit` or `maxDeposit` configured. Either provide context with action/channelId/cumulativeAmount, or configure `deposit`/`maxDeposit` for auto-management.');
+        },
+    });
+}
+//# sourceMappingURL=Session.js.map

package/dist/tempo/client/Session.js.map

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

package/dist/tempo/client/SessionManager.d.ts

@@ -0,0 +1,62 @@
+import type { Hex } from 'ox';
+import type { Address } from 'viem';
+import type * as Challenge from '../../Challenge.js';
+import type * as Account from '../../viem/Account.js';
+import type * as Client from '../../viem/Client.js';
+import type { StreamReceipt } from '../stream/Types.js';
+export type SessionManager = {
+    readonly channelId: Hex.Hex | undefined;
+    readonly cumulative: bigint;
+    readonly opened: boolean;
+    open(options?: {
+        deposit?: bigint;
+    }): Promise<void>;
+    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<PaymentResponse>;
+    sse(input: RequestInfo | URL, init?: RequestInit & {
+        onReceipt?: ((receipt: StreamReceipt) => void) | undefined;
+        signal?: AbortSignal | undefined;
+    }): Promise<AsyncIterable<string>>;
+    close(): Promise<StreamReceipt | undefined>;
+};
+export type PaymentResponse = Response & {
+    receipt: StreamReceipt | null;
+    challenge: Challenge.Challenge | null;
+    channelId: Hex.Hex | null;
+    cumulative: bigint;
+};
+/**
+ * Creates a session manager that handles the full client payment lifecycle:
+ * channel open, incremental vouchers, SSE streaming, and channel close.
+ *
+ * Internally delegates to the `session()` MethodIntent plugin for all
+ * channel state management and credential creation, and to `Fetch.from`
+ * for the 402 challenge/retry flow.
+ *
+ * ## Session resumption
+ *
+ * All channel state is held **in memory**. If the client process restarts,
+ * the session is lost and a new on-chain channel will be opened on the next
+ * request — the previous channel's deposit is orphaned until manually closed.
+ *
+ * When the server includes a `channelId` in the 402 challenge `methodDetails`,
+ * the client will attempt to recover the channel by reading its on-chain state
+ * via `getOnChainChannel()`. If the channel has a positive deposit and is not
+ * finalized, it resumes from the on-chain settled amount.
+ */
+export declare function sessionManager(parameters: sessionManager.Parameters): SessionManager;
+export declare namespace sessionManager {
+    type Parameters = Account.getResolver.Parameters & Client.getResolver.Parameters & {
+        /** Address authorized to sign vouchers. Defaults to the account address. */
+        authorizedSigner?: Address | undefined;
+        /** Viem client instance. Shorthand for `getClient: () => client`. */
+        client?: import('viem').Client | undefined;
+        /** Token decimals used to convert `maxDeposit` to raw units. Defaults to `6`. */
+        decimals?: number | undefined;
+        /** Escrow contract address. */
+        escrowContract?: Address | undefined;
+        fetch?: typeof globalThis.fetch | undefined;
+        /** Maximum deposit in human-readable units (e.g. `'10'` for 10 tokens). Converted to raw units via `decimals`. */
+        maxDeposit?: string | undefined;
+    };
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/tempo/client/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../../src/tempo/client/SessionManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,IAAI,CAAA;AAC7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACnC,OAAO,KAAK,KAAK,SAAS,MAAM,oBAAoB,CAAA;AAEpD,OAAO,KAAK,KAAK,OAAO,MAAM,uBAAuB,CAAA;AACrD,OAAO,KAAK,KAAK,MAAM,MAAM,sBAAsB,CAAA;AAGnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAIvD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IAExB,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC7E,GAAG,CACD,KAAK,EAAE,WAAW,GAAG,GAAG,EACxB,IAAI,CAAC,EAAE,WAAW,GAAG;QACnB,SAAS,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC,GAAG,SAAS,CAAA;QAC1D,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;KACjC,GACA,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;IACjC,KAAK,IAAI,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAA;CAC5C,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG;IACvC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAE,SAAS,CAAC,SAAS,GAAG,IAAI,CAAA;IACrC,SAAS,EAAE,GAAG,CAAC,GAAG,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,CAAC,UAAU,GAAG,cAAc,CA2MpF;AAED,MAAM,CAAC,OAAO,WAAW,cAAc,CAAC;IACtC,KAAK,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,GAC9C,MAAM,CAAC,WAAW,CAAC,UAAU,GAAG;QAC9B,4EAA4E;QAC5E,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACtC,qEAAqE;QACrE,MAAM,CAAC,EAAE,OAAO,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;QAC1C,iFAAiF;QACjF,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC7B,+BAA+B;QAC/B,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACpC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAA;QAC3C,kHAAkH;QAClH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAChC,CAAA;CACJ"}

package/dist/tempo/client/SessionManager.js

@@ -0,0 +1,201 @@
+import * as Fetch from '../../client/internal/Fetch.js';
+import { deserializeStreamReceipt } from '../stream/Receipt.js';
+import { parseEvent } from '../stream/Sse.js';
+import { session as sessionPlugin } from './Session.js';
+/**
+ * Creates a session manager that handles the full client payment lifecycle:
+ * channel open, incremental vouchers, SSE streaming, and channel close.
+ *
+ * Internally delegates to the `session()` MethodIntent plugin for all
+ * channel state management and credential creation, and to `Fetch.from`
+ * for the 402 challenge/retry flow.
+ *
+ * ## Session resumption
+ *
+ * All channel state is held **in memory**. If the client process restarts,
+ * the session is lost and a new on-chain channel will be opened on the next
+ * request — the previous channel's deposit is orphaned until manually closed.
+ *
+ * When the server includes a `channelId` in the 402 challenge `methodDetails`,
+ * the client will attempt to recover the channel by reading its on-chain state
+ * via `getOnChainChannel()`. If the channel has a positive deposit and is not
+ * finalized, it resumes from the on-chain settled amount.
+ */
+export function sessionManager(parameters) {
+    const fetchFn = parameters.fetch ?? globalThis.fetch;
+    let channel = null;
+    let lastChallenge = null;
+    let lastUrl = null;
+    const method = sessionPlugin({
+        account: parameters.account,
+        authorizedSigner: parameters.authorizedSigner,
+        getClient: parameters.client ? () => parameters.client : parameters.getClient,
+        escrowContract: parameters.escrowContract,
+        decimals: parameters.decimals,
+        maxDeposit: parameters.maxDeposit,
+        onChannelUpdate(entry) {
+            channel = entry;
+        },
+    });
+    const wrappedFetch = Fetch.from({
+        fetch: fetchFn,
+        methods: [method],
+        onChallenge: async (challenge, _helpers) => {
+            lastChallenge = challenge;
+            return undefined;
+        },
+    });
+    function toPaymentResponse(response) {
+        const receiptHeader = response.headers.get('Payment-Receipt');
+        const receipt = receiptHeader ? deserializeStreamReceipt(receiptHeader) : null;
+        return Object.assign(response, {
+            receipt,
+            challenge: lastChallenge,
+            channelId: channel?.channelId ?? null,
+            cumulative: channel?.cumulativeAmount ?? 0n,
+        });
+    }
+    async function doFetch(input, init) {
+        lastUrl = input;
+        const response = await wrappedFetch(input, init);
+        return toPaymentResponse(response);
+    }
+    const self = {
+        get channelId() {
+            return channel?.channelId;
+        },
+        get cumulative() {
+            return channel?.cumulativeAmount ?? 0n;
+        },
+        get opened() {
+            return channel?.opened ?? false;
+        },
+        async open(options) {
+            if (channel?.opened)
+                return;
+            if (!lastChallenge) {
+                throw new Error('No challenge available. Make a request first to receive a 402 challenge, or pass a challenge via .fetch()/.sse().');
+            }
+            const deposit = options?.deposit;
+            const credential = await method.createCredential({
+                challenge: lastChallenge,
+                context: {
+                    ...(deposit !== undefined && { depositRaw: deposit.toString() }),
+                },
+            });
+            if (!lastUrl)
+                throw new Error('No URL available — call fetch() or sse() before open().');
+            const response = await fetchFn(lastUrl, {
+                method: 'POST',
+                headers: { Authorization: credential },
+            });
+            if (!response.ok) {
+                const body = await response.text().catch(() => '');
+                const wwwAuth = response.headers.get('WWW-Authenticate') ?? '';
+                throw new Error(`Open request failed with status ${response.status}${body ? `: ${body}` : ''}${wwwAuth ? ` [WWW-Authenticate: ${wwwAuth}]` : ''}`);
+            }
+        },
+        fetch: doFetch,
+        async sse(input, init) {
+            const { onReceipt, signal, ...fetchInit } = init ?? {};
+            const sseInit = {
+                ...fetchInit,
+                headers: {
+                    ...fetchInit.headers,
+                    Accept: 'text/event-stream',
+                },
+                ...(signal ? { signal } : {}),
+            };
+            const response = await doFetch(input, sseInit);
+            // Snapshot the challenge at SSE open time so concurrent
+            // calls don't overwrite it.
+            const sseChallenge = lastChallenge;
+            if (!response.body)
+                throw new Error('Response has no body.');
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            async function* iterate() {
+                let buffer = '';
+                try {
+                    while (true) {
+                        if (signal?.aborted)
+                            break;
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        buffer += decoder.decode(value, { stream: true });
+                        const parts = buffer.split('\n\n');
+                        buffer = parts.pop();
+                        for (const part of parts) {
+                            if (!part.trim())
+                                continue;
+                            const event = parseEvent(part);
+                            if (!event)
+                                continue;
+                            switch (event.type) {
+                                case 'message':
+                                    yield event.data;
+                                    break;
+                                case 'payment-need-voucher': {
+                                    if (!channel || !sseChallenge)
+                                        break;
+                                    const required = BigInt(event.data.requiredCumulative);
+                                    channel.cumulativeAmount =
+                                        channel.cumulativeAmount > required ? channel.cumulativeAmount : required;
+                                    const credential = await method.createCredential({
+                                        challenge: sseChallenge,
+                                        context: {
+                                            action: 'voucher',
+                                            channelId: channel.channelId,
+                                            cumulativeAmountRaw: channel.cumulativeAmount.toString(),
+                                        },
+                                    });
+                                    const voucherResponse = await fetchFn(input, {
+                                        method: 'POST',
+                                        headers: { Authorization: credential },
+                                    });
+                                    if (!voucherResponse.ok) {
+                                        throw new Error(`Voucher POST failed with status ${voucherResponse.status}`);
+                                    }
+                                    break;
+                                }
+                                case 'payment-receipt':
+                                    onReceipt?.(event.data);
+                                    break;
+                            }
+                        }
+                    }
+                }
+                finally {
+                    reader.releaseLock();
+                }
+            }
+            return iterate();
+        },
+        async close() {
+            if (!channel?.opened || !lastChallenge)
+                return undefined;
+            const credential = await method.createCredential({
+                challenge: lastChallenge,
+                context: {
+                    action: 'close',
+                    channelId: channel.channelId,
+                    cumulativeAmountRaw: channel.cumulativeAmount.toString(),
+                },
+            });
+            let receipt;
+            if (lastUrl) {
+                const response = await fetchFn(lastUrl, {
+                    method: 'POST',
+                    headers: { Authorization: credential },
+                });
+                const receiptHeader = response.headers.get('Payment-Receipt');
+                if (receiptHeader)
+                    receipt = deserializeStreamReceipt(receiptHeader);
+            }
+            return receipt;
+        },
+    };
+    return self;
+}
+//# sourceMappingURL=SessionManager.js.map

package/dist/tempo/client/SessionManager.js.map

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

package/dist/tempo/client/index.d.ts

@@ -0,0 +1,6 @@
+export { charge } from './Charge.js';
+export { tempo } from './MethodIntents.js';
+export { session } from './Session.js';
+export type { PaymentResponse, SessionManager } from './SessionManager.js';
+export { sessionManager } from './SessionManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tempo/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tempo/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/tempo/client/index.js

@@ -0,0 +1,5 @@
+export { charge } from './Charge.js';
+export { tempo } from './MethodIntents.js';
+export { session } from './Session.js';
+export { sessionManager } from './SessionManager.js';
+//# sourceMappingURL=index.js.map

package/dist/tempo/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tempo/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/tempo/index.d.ts

@@ -0,0 +1,3 @@
+export * as MethodIntents from './Intents.js';
+export * as Stream from './stream/index.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/tempo/index.js

@@ -0,0 +1,3 @@
+export * as MethodIntents from './Intents.js';
+export * as Stream from './stream/index.js';
+//# sourceMappingURL=index.js.map

package/dist/tempo/index.js.map

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

package/dist/tempo/internal/account.d.ts

@@ -0,0 +1,32 @@
+import type { Account, Address } from 'viem';
+/**
+ * Resolves a recipient address and optional fee payer from flexible input parameters.
+ *
+ * Accepts either `account` or `recipient` as the parameter name. When the value
+ * is an `Account`, its address is extracted. If `feePayer` is `true`, the
+ * account also acts as the fee payer. Alternatively, a separate `Account`
+ * can be provided as the fee payer.
+ *
+ * @returns An object with `account`, `feePayer`, and `recipient`.
+ */
+export declare function resolve(parameters: resolve.Parameters): {
+    account: Account | undefined;
+    feePayer: Account | undefined;
+    recipient: Address | undefined;
+};
+export declare namespace resolve {
+    type Parameters = {
+        recipient?: Address | undefined;
+    } & ({
+        /** Account that performs payment operations. */
+        account?: Account | undefined;
+        /** When true, the account also sponsors (pays) transaction fees. */
+        feePayer?: true | undefined;
+    } | {
+        /** Address that receives payment. */
+        account?: Address | undefined;
+        /** Optional fee payer account for covering transaction fees. */
+        feePayer?: Account | undefined;
+    });
+}
+//# sourceMappingURL=account.d.ts.map

package/dist/tempo/internal/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../../src/tempo/internal/account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU;;;eAgBA,OAAO,GAAG,SAAS;EACxE;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,KAAK,UAAU,GAAG;QAAE,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,GAAG,CACpD;QACE,gDAAgD;QAChD,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,oEAAoE;QACpE,QAAQ,CAAC,EAAE,IAAI,GAAG,SAAS,CAAA;KAC5B,GACD;QACE,qCAAqC;QACrC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QAC7B,gEAAgE;QAChE,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAC/B,CACJ,CAAA;CACF"}