@envarai/envarpay 0.1.0-alpha.3 → 0.2.0-alpha.10

package/dist/commerce/buyer.d.ts

@@ -0,0 +1,138 @@
+import type { ClientEvmSigner } from '@x402/evm';
+import type { PaymentPayload, PaymentRequirements, SettleResponse } from '@x402/core/types';
+import { type BuyerPolicy, type Input, type StandardA2APeer } from './types.js';
+import { CredentialVault } from './vault.js';
+import { BuyerStore, type BuyerQuote } from './buyer-store.js';
+import { type MppAuthenticationAction, type MppBuyerOptions, type MppReceipt } from './mpp-client.js';
+export interface BuyerPreviewInput {
+    cardUrl: string;
+    messageId: string;
+    input: Input;
+    offerId: string;
+}
+export interface BuyerConfirmInput {
+    previewId: string;
+    quoteToken: string;
+    messageId: string;
+}
+export interface BuyerAuthentication {
+    purchaseId: string;
+    action: MppAuthenticationAction | null;
+}
+export interface CommerceBuyerOptions {
+    policy: BuyerPolicy;
+    store: BuyerStore;
+    vault?: CredentialVault;
+    signer?: ClientEvmSigner;
+    mpp?: MppBuyerOptions;
+    peerTokens: Readonly<Record<string, string>>;
+    /** Override sibling /a2a only when the local wallet owner explicitly allows it. */
+    peerEndpoints?: Readonly<Record<string, string>>;
+    verifyReceipt?: (receipt: SettleResponse, payload: PaymentPayload, requirements: PaymentRequirements) => Promise<boolean>;
+    checkpoint?: (requirements: PaymentRequirements) => Promise<string>;
+    proveExpiredUnused?: (payload: PaymentPayload, requirements: PaymentRequirements) => Promise<boolean>;
+    findOriginalReceipt?: (payload: PaymentPayload, requirements: PaymentRequirements, fromBlock: string) => Promise<SettleResponse | undefined>;
+    fetchImpl?: typeof fetch;
+}
+export interface BuyerSnapshot {
+    id: string;
+    quoteToken: string;
+    messageId: string;
+    payer: string;
+    state: string;
+    quote: BuyerQuote;
+    paymentState: string;
+    executionState: string;
+    task?: Record<string, unknown>;
+    result?: unknown;
+    errorCode?: string;
+    continuation?: {
+        messageId: string;
+        state: 'pending' | 'unknown' | 'resolved';
+        input: Input;
+    };
+    receipt?: SettleResponse | MppReceipt;
+    nonce?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Independent x402 wallet; payment and execution state are deliberately separate. */
+export declare class CommerceBuyer {
+    private readonly options;
+    readonly policy: BuyerPolicy;
+    private readonly fetchImpl;
+    private readonly active;
+    private timer?;
+    private readonly previews;
+    constructor(options: CommerceBuyerOptions);
+    /** Background observation only; never signs, replays credentials or changes reservations. */
+    start(intervalMs?: number): void;
+    stop(): Promise<void>;
+    policySnapshot(): {
+        capabilities: ("free" | "x402" | "mpp")[];
+        state: string;
+        payer: string | undefined;
+        budgets: {
+            reserved: string;
+            spent: string;
+            currency: string;
+            maxTotal: string;
+            period: "cumulative";
+        }[];
+        policyVersion: 1;
+        paymentsEnabled: boolean;
+        approval: "per_purchase" | "within_preapproved_limits";
+        peers: (StandardA2APeer | {
+            id: string;
+            cardUrl: string;
+            mode?: "envarpay";
+            protocol: "x402" | "mpp";
+            currency: string;
+            recipient: string;
+            maxPerPurchase: string;
+        } | {
+            id: string;
+            cardUrl: string;
+            mode?: "envarpay";
+            protocol: "free";
+            currency: null;
+            recipient: null;
+            maxPerPurchase: "0";
+        })[];
+    };
+    private peer;
+    private endpoint;
+    private scopedFetch;
+    private record;
+    private snapshot;
+    get(caller: string, id: string): BuyerSnapshot;
+    preview(caller: string, input: BuyerPreviewInput): Promise<BuyerSnapshot>;
+    private prepare;
+    private prepareStandard;
+    private prepareFree;
+    private replayFree;
+    private prepareMpp;
+    private mppCredential;
+    private purchaseMpp;
+    private savedMpp;
+    private verifyMpp;
+    private replayMpp;
+    private recoverMpp;
+    /** Owner-only provider read. No replay, token creation, reservation or payment transition. */
+    authentication(caller: string, id: string): Promise<BuyerAuthentication>;
+    private assertCurrentPolicy;
+    confirm(caller: string, input: BuyerConfirmInput): Promise<BuyerSnapshot>;
+    private exclusive;
+    private purchase;
+    private saved;
+    private verify;
+    private task;
+    private replay;
+    private client;
+    private observe;
+    continue(caller: string, id: string, input: {
+        messageId: string;
+        input: Input;
+    }): Promise<BuyerSnapshot>;
+    recover(caller: string, id: string): Promise<BuyerSnapshot>;
+}