@useagentpay/sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,328 @@
+interface BillingCredentials {
+    card: {
+        number: string;
+        expiry: string;
+        cvv: string;
+    };
+    name: string;
+    billingAddress: {
+        street: string;
+        city: string;
+        state: string;
+        zip: string;
+        country: string;
+    };
+    shippingAddress: {
+        street: string;
+        city: string;
+        state: string;
+        zip: string;
+        country: string;
+    };
+    email: string;
+    phone: string;
+}
+interface EncryptedVault {
+    ciphertext: string;
+    salt: string;
+    iv: string;
+}
+
+interface KeyPair {
+    publicKey: string;
+    privateKey: string;
+}
+interface PurchaseMandate {
+    txId: string;
+    txHash: string;
+    signature: string;
+    publicKey: string;
+    timestamp: string;
+}
+interface TransactionDetails {
+    txId: string;
+    merchant: string;
+    amount: number;
+    description: string;
+    timestamp: string;
+}
+
+interface Wallet {
+    budget: number;
+    balance: number;
+    limitPerTx: number;
+    spent: number;
+}
+
+type TransactionStatus = 'pending' | 'approved' | 'rejected' | 'executing' | 'completed' | 'failed';
+interface Transaction {
+    id: string;
+    status: TransactionStatus;
+    merchant: string;
+    amount: number;
+    description: string;
+    url: string;
+    createdAt: string;
+    mandate?: PurchaseMandate;
+    receipt?: Receipt;
+    rejectionReason?: string;
+    error?: string;
+}
+interface Receipt {
+    id: string;
+    merchant: string;
+    amount: number;
+    confirmationId: string;
+    completedAt: string;
+}
+interface ProposeOptions {
+    merchant: string;
+    amount: number;
+    description: string;
+    url: string;
+}
+
+interface CheckoutResult {
+    success: boolean;
+    confirmationId?: string;
+    error?: string;
+}
+interface ExecutorConfig {
+    browserbaseApiKey?: string;
+    browserbaseProjectId?: string;
+    modelApiKey?: string;
+}
+
+declare class NotSetupError extends Error {
+    readonly code = "NOT_SETUP";
+    constructor(message?: string);
+}
+declare class DecryptError extends Error {
+    readonly code = "DECRYPT_FAILED";
+    constructor(message?: string);
+}
+declare class InsufficientBalanceError extends Error {
+    readonly code = "INSUFFICIENT_BALANCE";
+    constructor(amount?: number, balance?: number);
+}
+declare class ExceedsTxLimitError extends Error {
+    readonly code = "EXCEEDS_TX_LIMIT";
+    constructor(amount?: number, limit?: number);
+}
+declare class NotApprovedError extends Error {
+    readonly code = "NOT_APPROVED";
+    constructor(txId?: string);
+}
+declare class InvalidMandateError extends Error {
+    readonly code = "INVALID_MANDATE";
+    constructor(message?: string);
+}
+declare class AlreadyExecutedError extends Error {
+    readonly code = "ALREADY_EXECUTED";
+    constructor(txId?: string);
+}
+declare class CheckoutFailedError extends Error {
+    readonly code = "CHECKOUT_FAILED";
+    constructor(message?: string);
+}
+declare class TimeoutError extends Error {
+    readonly code = "TIMEOUT";
+    constructor(message?: string);
+}
+
+declare function generateTxId(): string;
+
+declare function formatCurrency(amount: number): string;
+declare function formatTimestamp(iso: string): string;
+declare function formatTable(transactions: Transaction[]): string;
+declare function formatStatus(data: {
+    balance: number;
+    budget: number;
+    limitPerTx: number;
+    pending: Transaction[];
+    recent: Transaction[];
+}): string;
+
+declare function getHomePath(): string;
+declare function getCredentialsPath(): string;
+declare function getKeysPath(): string;
+declare function getWalletPath(): string;
+declare function getTransactionsPath(): string;
+declare function getAuditPath(): string;
+
+declare function encrypt(credentials: BillingCredentials, passphrase: string): EncryptedVault;
+declare function decrypt(vault: EncryptedVault, passphrase: string): BillingCredentials;
+declare function saveVault(vault: EncryptedVault, path?: string): void;
+declare function loadVault(path?: string): EncryptedVault;
+
+declare function generateKeyPair(passphrase: string): KeyPair;
+declare function saveKeyPair(keys: KeyPair, publicPath?: string, privatePath?: string): void;
+declare function loadPublicKey(path?: string): string;
+declare function loadPrivateKey(path?: string): string;
+
+declare function createMandate(txDetails: TransactionDetails, privateKeyPem: string, passphrase: string): PurchaseMandate;
+declare function verifyMandate(mandate: PurchaseMandate, txDetails: TransactionDetails): boolean;
+
+declare class BudgetManager {
+    private walletPath;
+    constructor(walletPath?: string);
+    getWallet(): Wallet;
+    private saveWallet;
+    setBudget(amount: number): void;
+    setLimitPerTx(limit: number): void;
+    deductBalance(amount: number): void;
+    checkProposal(amount: number): void;
+    addFunds(amount: number): Wallet;
+    getBalance(): {
+        budget: number;
+        balance: number;
+        limitPerTx: number;
+        spent: number;
+    };
+    initWallet(budget: number, limitPerTx?: number): void;
+}
+
+declare class TransactionManager {
+    private txPath;
+    constructor(txPath?: string);
+    private loadAll;
+    private saveAll;
+    propose(options: ProposeOptions): Transaction;
+    get(txId: string): Transaction | undefined;
+    approve(txId: string, mandate: PurchaseMandate): void;
+    reject(txId: string, reason?: string): void;
+    markExecuting(txId: string): void;
+    markCompleted(txId: string, receipt: Receipt): void;
+    markFailed(txId: string, error: string): void;
+    list(): Transaction[];
+    getPending(): Transaction[];
+    getHistory(): Transaction[];
+}
+
+interface PollOptions {
+    pollInterval?: number;
+    timeout?: number;
+}
+declare function waitForApproval(txId: string, manager: TransactionManager, options?: PollOptions): Promise<{
+    status: 'approved' | 'rejected';
+    reason?: string;
+}>;
+
+declare class AuditLogger {
+    private logPath;
+    constructor(logPath?: string);
+    log(action: string, details: Record<string, unknown>): void;
+    getLog(): string[];
+}
+
+interface DiscoverResult {
+    price: number;
+    productName: string;
+}
+declare class PurchaseExecutor {
+    private config;
+    private stagehand;
+    constructor(config?: ExecutorConfig);
+    private createStagehand;
+    /**
+     * Phase 1: Open browser, navigate to URL, extract price and product info.
+     * Keeps the session alive for fillAndComplete().
+     */
+    openAndDiscover(url: string, instructions?: string): Promise<DiscoverResult>;
+    /**
+     * Phase 2: Proceed to checkout, fill forms, swap credentials, and submit.
+     * Must be called after openAndDiscover().
+     */
+    fillAndComplete(credentials: BillingCredentials): Promise<CheckoutResult>;
+    /**
+     * Convenience: single-shot execute (navigate + checkout in one call).
+     * Used by AgentPay facade when amount is already known.
+     */
+    execute(tx: Transaction, credentials: BillingCredentials): Promise<CheckoutResult>;
+    close(): Promise<void>;
+}
+
+declare const PLACEHOLDER_MAP: {
+    readonly card_number: "{{card_number}}";
+    readonly cardholder_name: "{{cardholder_name}}";
+    readonly card_expiry: "{{card_expiry}}";
+    readonly card_cvv: "{{card_cvv}}";
+    readonly billing_street: "{{billing_street}}";
+    readonly billing_city: "{{billing_city}}";
+    readonly billing_state: "{{billing_state}}";
+    readonly billing_zip: "{{billing_zip}}";
+    readonly billing_country: "{{billing_country}}";
+    readonly shipping_street: "{{shipping_street}}";
+    readonly shipping_city: "{{shipping_city}}";
+    readonly shipping_state: "{{shipping_state}}";
+    readonly shipping_zip: "{{shipping_zip}}";
+    readonly shipping_country: "{{shipping_country}}";
+    readonly email: "{{email}}";
+    readonly phone: "{{phone}}";
+};
+declare function getPlaceholderVariables(): Record<string, string>;
+declare function credentialsToSwapMap(creds: BillingCredentials): Record<string, string>;
+
+interface AgentPayOptions {
+    home?: string;
+    passphrase?: string;
+    executor?: ExecutorConfig;
+}
+declare class AgentPay {
+    readonly home: string;
+    private passphrase?;
+    private budgetManager;
+    private txManager;
+    private auditLogger;
+    private executor;
+    constructor(options?: AgentPayOptions);
+    get wallet(): {
+        getBalance: () => {
+            budget: number;
+            balance: number;
+            limitPerTx: number;
+            spent: number;
+        };
+        getHistory: () => Transaction[];
+        getLimits: () => {
+            budget: number;
+            limitPerTx: number;
+            remaining: number;
+        };
+        generateFundingQR: (options?: {
+            suggestedBudget?: number;
+            message?: string;
+        }) => Promise<{
+            url: string;
+            qrDataUrl: string;
+        }>;
+    };
+    get transactions(): {
+        propose: (options: ProposeOptions) => Transaction;
+        get: (txId: string) => Transaction | undefined;
+        waitForApproval: (txId: string, options?: {
+            pollInterval?: number;
+            timeout?: number;
+        }) => Promise<{
+            status: "approved" | "rejected";
+            reason?: string;
+        }>;
+        execute: (txId: string) => Promise<Receipt>;
+        getReceipt: (txId: string) => Receipt | undefined;
+    };
+    get audit(): {
+        getLog: () => string[];
+    };
+    status(): {
+        balance: number;
+        budget: number;
+        limitPerTx: number;
+        pending: Transaction[];
+        recent: Transaction[];
+        isSetup: boolean;
+    };
+}
+
+declare const VERSION = "0.1.0";
+
+export { AgentPay, type AgentPayOptions, AlreadyExecutedError, AuditLogger, type BillingCredentials, BudgetManager, CheckoutFailedError, type CheckoutResult, DecryptError, type EncryptedVault, ExceedsTxLimitError, type ExecutorConfig, InsufficientBalanceError, InvalidMandateError, type KeyPair, NotApprovedError, NotSetupError, PLACEHOLDER_MAP, type ProposeOptions, PurchaseExecutor, type PurchaseMandate, type Receipt, TimeoutError, type Transaction, type TransactionDetails, TransactionManager, type TransactionStatus, VERSION, type Wallet, createMandate, credentialsToSwapMap, decrypt, encrypt, formatCurrency, formatStatus, formatTable, formatTimestamp, generateKeyPair, generateTxId, getAuditPath, getCredentialsPath, getHomePath, getKeysPath, getPlaceholderVariables, getTransactionsPath, getWalletPath, loadPrivateKey, loadPublicKey, loadVault, saveKeyPair, saveVault, verifyMandate, waitForApproval };