@zendfi/sdk 0.8.4 → 1.0.1

package/dist/webhook-handler-CdtQHVU5.d.mts

@@ -1,1130 +0,0 @@
-/**
- * ZendFi SDK Types
- * Complete type definitions for the ZendFi API
- */
-/** Branded type for type-safe IDs - prevents mixing different ID types */
-type Brand<T, B> = T & {
-    __brand: B;
-};
-/** Payment ID (e.g., 'pay_abc123') */
-type PaymentId = Brand<string, 'PaymentId'>;
-/** Session ID (e.g., 'sess_abc123') */
-type SessionId = Brand<string, 'SessionId'>;
-/** Agent Key ID (e.g., 'ak_abc123') */
-type AgentKeyId = Brand<string, 'AgentKeyId'>;
-/** Merchant ID (e.g., 'merch_abc123') */
-type MerchantId = Brand<string, 'MerchantId'>;
-/** Invoice ID (e.g., 'inv_abc123') */
-type InvoiceId = Brand<string, 'InvoiceId'>;
-/** Subscription ID (e.g., 'sub_abc123') */
-type SubscriptionId = Brand<string, 'SubscriptionId'>;
-/** Escrow ID (e.g., 'esc_abc123') */
-type EscrowId = Brand<string, 'EscrowId'>;
-/** Installment Plan ID (e.g., 'inst_abc123') */
-type InstallmentPlanId = Brand<string, 'InstallmentPlanId'>;
-/** Payment Link Code (e.g., 'link_abc123') */
-type PaymentLinkCode = Brand<string, 'PaymentLinkCode'>;
-/** Intent ID (e.g., 'pi_abc123') */
-type IntentId = Brand<string, 'IntentId'>;
-declare const asPaymentId: (id: string) => PaymentId;
-declare const asSessionId: (id: string) => SessionId;
-declare const asAgentKeyId: (id: string) => AgentKeyId;
-declare const asMerchantId: (id: string) => MerchantId;
-declare const asInvoiceId: (id: string) => InvoiceId;
-declare const asSubscriptionId: (id: string) => SubscriptionId;
-declare const asEscrowId: (id: string) => EscrowId;
-declare const asInstallmentPlanId: (id: string) => InstallmentPlanId;
-declare const asPaymentLinkCode: (id: string) => PaymentLinkCode;
-declare const asIntentId: (id: string) => IntentId;
-type Environment = 'development' | 'staging' | 'production';
-type ApiKeyMode = 'test' | 'live';
-type Currency = 'USD' | 'EUR' | 'GBP';
-type PaymentToken = 'SOL' | 'USDC' | 'USDT';
-type PaymentStatus = 'pending' | 'confirmed' | 'failed' | 'expired';
-type SubscriptionStatus = 'active' | 'canceled' | 'past_due' | 'paused';
-type InstallmentPlanStatus = 'active' | 'completed' | 'defaulted' | 'cancelled';
-type EscrowStatus = 'pending' | 'funded' | 'released' | 'refunded' | 'disputed' | 'cancelled';
-type InvoiceStatus = 'draft' | 'sent' | 'paid';
-type SplitStatus = 'pending' | 'processing' | 'completed' | 'failed' | 'refunded';
-type WebhookEvent = 'payment.created' | 'payment.confirmed' | 'payment.failed' | 'payment.expired' | 'subscription.created' | 'subscription.activated' | 'subscription.canceled' | 'subscription.payment_failed' | 'split.completed' | 'split.failed' | 'installment.due' | 'installment.paid' | 'installment.late' | 'escrow.funded' | 'escrow.released' | 'escrow.refunded' | 'escrow.disputed' | 'invoice.sent' | 'invoice.paid';
-interface ZendFiConfig {
-    apiKey?: string;
-    baseURL?: string;
-    environment?: Environment;
-    mode?: ApiKeyMode;
-    timeout?: number;
-    retries?: number;
-    idempotencyEnabled?: boolean;
-    debug?: boolean;
-}
-interface SplitRecipient {
-    recipient_wallet: string;
-    recipient_name?: string;
-    percentage?: number;
-    fixed_amount_usd?: number;
-    split_order?: number;
-}
-interface CreatePaymentRequest {
-    amount: number;
-    currency?: Currency;
-    token?: PaymentToken;
-    description?: string;
-    customer_email?: string;
-    redirect_url?: string;
-    metadata?: Record<string, any>;
-    split_recipients?: SplitRecipient[];
-}
-/**
- * Payment Link - Shareable checkout links
- */
-interface CreatePaymentLinkRequest {
-    amount: number;
-    currency?: string;
-    token?: string;
-    description?: string;
-    max_uses?: number;
-    expires_at?: string;
-    metadata?: Record<string, any>;
-    onramp?: boolean;
-}
-interface PaymentLink {
-    link_code: string;
-    merchant_id: string;
-    title?: string;
-    description?: string;
-    amount: number;
-    currency: string;
-    payment_methods?: string[];
-    redirect_url?: string;
-    expires_at?: string;
-    metadata?: Record<string, any>;
-    payment_url: string;
-    hosted_page_url: string;
-    created_at: string;
-    updated_at: string;
-    url: string;
-    id?: string;
-    token?: string;
-    max_uses?: number;
-    uses_count?: number;
-    is_active?: boolean;
-    onramp?: boolean;
-}
-interface Payment {
-    id: string;
-    merchant_id: string;
-    amount_usd?: number;
-    amount?: number;
-    currency?: string;
-    payment_token?: PaymentToken;
-    status: PaymentStatus;
-    customer_wallet?: string;
-    customer_email?: string;
-    description?: string;
-    checkout_url?: string;
-    payment_url?: string;
-    qr_code?: string;
-    expires_at: string;
-    confirmed_at?: string;
-    transaction_signature?: string;
-    metadata?: Record<string, any>;
-    split_ids?: string[];
-    created_at?: string;
-    updated_at?: string;
-}
-interface ListPaymentsRequest {
-    page?: number;
-    limit?: number;
-    status?: PaymentStatus;
-    from_date?: string;
-    to_date?: string;
-}
-interface PaginatedResponse<T> {
-    data: T[];
-    pagination: {
-        page: number;
-        limit: number;
-        total: number;
-        total_pages: number;
-    };
-}
-interface CreateSubscriptionPlanRequest {
-    name: string;
-    description?: string;
-    amount: number;
-    currency?: Currency;
-    interval: 'daily' | 'weekly' | 'monthly' | 'yearly';
-    interval_count?: number;
-    trial_days?: number;
-    metadata?: Record<string, any>;
-}
-interface SubscriptionPlan {
-    id: string;
-    merchant_id: string;
-    name: string;
-    description?: string;
-    amount: number;
-    currency: Currency;
-    interval: string;
-    interval_count: number;
-    trial_days: number;
-    is_active: boolean;
-    metadata?: Record<string, any>;
-    created_at: string;
-    updated_at: string;
-}
-interface CreateSubscriptionRequest {
-    plan_id: string;
-    customer_email: string;
-    customer_wallet?: string;
-    metadata?: Record<string, any>;
-}
-interface Subscription {
-    id: string;
-    plan_id: string;
-    merchant_id: string;
-    customer_email: string;
-    customer_wallet?: string;
-    status: SubscriptionStatus;
-    current_period_start: string;
-    current_period_end: string;
-    trial_end?: string;
-    canceled_at?: string;
-    metadata?: Record<string, any>;
-    created_at: string;
-    updated_at: string;
-}
-interface WebhookPayload {
-    event: WebhookEvent;
-    timestamp: string;
-    merchant_id: string;
-    data: Payment | Subscription;
-}
-interface VerifyWebhookRequest {
-    payload: string | object;
-    signature: string;
-    secret: string;
-}
-/**
- * Installment Plans - Pay over time
- */
-interface InstallmentScheduleItem {
-    installment_number: number;
-    due_date: string;
-    amount: string;
-    status: string;
-    payment_id?: string;
-    paid_at?: string;
-}
-interface CreateInstallmentPlanRequest {
-    customer_wallet: string;
-    customer_email?: string;
-    total_amount: number;
-    installment_count: number;
-    first_payment_date?: string;
-    payment_frequency_days: number;
-    description?: string;
-    late_fee_amount?: number;
-    grace_period_days?: number;
-    metadata?: Record<string, any>;
-}
-interface CreateInstallmentPlanResponse {
-    plan_id: string;
-    status: string;
-}
-interface InstallmentPlan {
-    id?: string;
-    plan_id?: string;
-    merchant_id?: string;
-    customer_wallet?: string;
-    customer_email?: string;
-    total_amount?: string;
-    installment_count?: number;
-    amount_per_installment?: string;
-    payment_schedule?: InstallmentScheduleItem[];
-    paid_count?: number;
-    status: InstallmentPlanStatus | string;
-    description?: string;
-    late_fee_amount?: string;
-    grace_period_days?: number;
-    metadata?: Record<string, any>;
-    created_at?: string;
-    updated_at?: string;
-    completed_at?: string;
-    defaulted_at?: string;
-}
-/**
- * Escrow - Secure fund holding
- */
-interface ReleaseCondition {
-    type: 'manual_approval' | 'time_based' | 'confirmation_required' | 'milestone';
-    approver?: string;
-    approved?: boolean;
-    release_after?: string;
-    confirmations_needed?: number;
-    confirmed_by?: string[];
-    description?: string;
-    approved_by?: string;
-}
-interface CreateEscrowRequest {
-    buyer_wallet: string;
-    seller_wallet: string;
-    amount: number;
-    currency?: Currency;
-    token?: PaymentToken;
-    description?: string;
-    release_conditions: ReleaseCondition;
-    metadata?: Record<string, any>;
-}
-interface Escrow {
-    id: string;
-    payment_id: string;
-    merchant_id: string;
-    buyer_wallet: string;
-    seller_wallet: string;
-    escrow_wallet: string;
-    amount: number;
-    currency: Currency;
-    token: PaymentToken;
-    release_conditions: ReleaseCondition;
-    status: EscrowStatus;
-    payment_url?: string;
-    qr_code?: string;
-    funded_at?: string;
-    released_at?: string;
-    refunded_at?: string;
-    disputed_at?: string;
-    dispute_reason?: string;
-    release_transaction_signature?: string;
-    refund_transaction_signature?: string;
-    metadata?: Record<string, any>;
-    created_at: string;
-    updated_at: string;
-}
-interface ApproveEscrowRequest {
-    approver_wallet: string;
-}
-interface RefundEscrowRequest {
-    reason: string;
-}
-interface DisputeEscrowRequest {
-    reason: string;
-}
-/**
- * Invoices - Professional billing
- */
-interface InvoiceLineItem {
-    description: string;
-    quantity: number;
-    unit_price: number;
-}
-interface CreateInvoiceRequest {
-    customer_email: string;
-    customer_name?: string;
-    amount: number;
-    token?: PaymentToken;
-    description: string;
-    line_items?: InvoiceLineItem[];
-    due_date?: string;
-    metadata?: Record<string, any>;
-}
-interface Invoice {
-    id: string;
-    invoice_number: string;
-    merchant_id: string;
-    customer_email: string;
-    customer_name?: string;
-    amount_usd: number;
-    token: PaymentToken;
-    description: string;
-    line_items?: InvoiceLineItem[];
-    status: InvoiceStatus;
-    payment_url?: string;
-    due_date?: string;
-    sent_at?: string;
-    paid_at?: string;
-    metadata?: Record<string, any>;
-    created_at: string;
-    updated_at: string;
-}
-/**
- * API Key Scopes for Agent Keys
- * Controls what operations an agent can perform
- */
-type ApiKeyScope = 'full' | 'read_only' | 'create_payments' | 'manage_escrow' | 'create_subscriptions' | 'manage_installments' | 'read_analytics';
-/**
- * Agent API Key - Scoped access for AI agents
- * Created via zendfi.agent.createKey()
- */
-interface AgentApiKey {
-    /** Unique identifier (UUID) */
-    id: string;
-    /** First 12 characters of the key for identification */
-    key_prefix: string;
-    /** Full API key (only returned on creation, starts with zai_) */
-    full_key?: string;
-    /** Human-readable name for the agent */
-    name: string;
-    /** Permissions granted to this key */
-    scopes: ApiKeyScope[];
-    /** Maximum API calls per hour */
-    rate_limit_per_hour: number;
-    /** Agent metadata (agent_id, agent_name, etc.) */
-    agent_metadata: Record<string, unknown>;
-    /** ISO 8601 timestamp */
-    created_at: string;
-}
-/**
- * Request to create an agent API key
- */
-interface CreateAgentApiKeyRequest {
-    /** Human-readable name for the agent */
-    name: string;
-    /** Unique identifier for the agent (e.g., "shopping-assistant-v1") */
-    agent_id: string;
-    /** Display name for the agent */
-    agent_name?: string;
-    /** Permissions to grant (defaults to ['create_payments']) */
-    scopes?: ApiKeyScope[];
-    /** Maximum API calls per hour (defaults to 1000) */
-    rate_limit_per_hour?: number;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Session spending limits for AI agents
- */
-interface SessionLimits {
-    /** Maximum USD per single transaction (default: 1000) */
-    max_per_transaction?: number;
-    /** Maximum USD per day (default: 5000) */
-    max_per_day?: number;
-    /** Maximum USD per week (default: 20000) */
-    max_per_week?: number;
-    /** Maximum USD per month (default: 50000) */
-    max_per_month?: number;
-    /** Require approval for transactions above this amount (default: 500) */
-    require_approval_above?: number;
-}
-/**
- * Agent Session - Time-bounded spending authorization
- */
-interface AgentSession {
-    /** Unique identifier (UUID) */
-    id: string;
-    /** Session token for API calls (zai_session_...) */
-    session_token: string;
-    /** Agent identifier */
-    agent_id: string;
-    /** Display name */
-    agent_name?: string;
-    /** User's Solana wallet address */
-    user_wallet: string;
-    /** Spending limits for this session */
-    limits: SessionLimits;
-    /** Whether the session is active */
-    is_active: boolean;
-    /** ISO 8601 timestamp */
-    created_at: string;
-    /** When the session expires (ISO 8601) */
-    expires_at: string;
-    /** Remaining daily spending allowance */
-    remaining_today: number;
-    /** Remaining weekly spending allowance */
-    remaining_this_week: number;
-    /** Remaining monthly spending allowance */
-    remaining_this_month: number;
-    /** Whether a PKP was minted for on-chain session identity */
-    mint_pkp?: boolean;
-    /** PKP Ethereum address (if mint_pkp was true) */
-    pkp_address?: string;
-}
-/**
- * Request to create an agent session
- */
-interface CreateAgentSessionRequest {
-    /** Unique identifier for the agent */
-    agent_id: string;
-    /** Display name for the agent */
-    agent_name?: string;
-    /** User's Solana wallet address */
-    user_wallet: string;
-    /** Spending limits (uses defaults if not provided) */
-    limits?: SessionLimits;
-    /** Restrict to specific merchants (UUIDs) */
-    allowed_merchants?: string[];
-    /** Session duration in hours (default: 24, max: 168) */
-    duration_hours?: number;
-    /**
-     * Mint a PKP for on-chain session identity (audit trail).
-     * Creates a blockchain-verified session identity via Lit Protocol.
-     * Note: Spending limits are enforced server-side.
-     */
-    mint_pkp?: boolean;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Payment Intent Status
- */
-type PaymentIntentStatus = 'requires_payment' | 'processing' | 'succeeded' | 'canceled' | 'failed';
-/**
- * Capture method for payment intents
- */
-type CaptureMethod = 'automatic' | 'manual';
-/**
- * Payment Intent - Two-phase payment flow
- */
-interface PaymentIntent {
-    /** Unique identifier (UUID) */
-    id: string;
-    /** Secret for confirming the intent (keep secure) */
-    client_secret: string;
-    /** Amount in USD */
-    amount: number;
-    /** Currency code */
-    currency: string;
-    /** Description of the payment */
-    description?: string;
-    /** Current status */
-    status: PaymentIntentStatus;
-    /** How to capture the payment */
-    capture_method: CaptureMethod;
-    /** Agent that created this intent */
-    agent_id?: string;
-    /** Linked payment ID (after confirmation) */
-    payment_id?: string;
-    /** ISO 8601 timestamp */
-    created_at: string;
-    /** When the intent expires (ISO 8601) */
-    expires_at: string;
-}
-/**
- * Request to create a payment intent
- */
-interface CreatePaymentIntentRequest {
-    /** Amount in USD (must be > 0) */
-    amount: number;
-    /** Currency code (default: "USD") */
-    currency?: string;
-    /** Description of the payment */
-    description?: string;
-    /** Capture method (default: "automatic") */
-    capture_method?: CaptureMethod;
-    /** Agent identifier */
-    agent_id?: string;
-    /** Agent display name */
-    agent_name?: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-    /** Time until expiration in seconds (default: 86400 = 24h) */
-    expires_in_seconds?: number;
-}
-/**
- * Request to confirm a payment intent
- */
-interface ConfirmPaymentIntentRequest {
-    /** The client_secret from the payment intent */
-    client_secret: string;
-    /** Customer's Solana wallet address */
-    customer_wallet: string;
-    /** Payment type (optional) */
-    payment_type?: string;
-    /** Enable gasless transaction (optional) */
-    auto_gasless?: boolean;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-    /** Session token for spending limit enforcement (optional) */
-    session_token?: string;
-}
-/**
- * Payment Intent Event
- */
-interface PaymentIntentEvent {
-    /** Event ID */
-    id: string;
-    /** Payment Intent ID */
-    payment_intent_id: string;
-    /** Event type */
-    event_type: string;
-    /** Event data */
-    data: Record<string, unknown>;
-    /** ISO 8601 timestamp */
-    created_at: string;
-}
-/**
- * Purchasing Power Parity factor for a country
- */
-interface PPPFactor {
-    /** ISO country code (e.g., "BR", "NG", "IN") */
-    country_code: string;
-    /** Full country name */
-    country_name: string;
-    /** PPP adjustment factor (0.0 - 1.0) */
-    ppp_factor: number;
-    /** Local currency code */
-    currency_code: string;
-    /** Suggested discount percentage */
-    adjustment_percentage: number;
-}
-/**
- * User profile for pricing decisions
- */
-interface UserProfile {
-    /** ISO country code */
-    location_country?: string;
-    /** Wallet transaction history (for loyalty detection) */
-    wallet_history?: Record<string, unknown>;
-    /** Context hint (e.g., "first-time", "loyal", "churning") */
-    context?: string;
-}
-/**
- * PPP pricing configuration
- */
-interface PPPConfig {
-    /** Enable PPP adjustments (default: true) */
-    enabled?: boolean;
-    /** Minimum PPP factor to apply */
-    min_factor?: number;
-    /** Maximum PPP factor to apply */
-    max_factor?: number;
-    /** Absolute minimum price in USD */
-    floor_price?: number;
-    /** Absolute maximum price in USD */
-    ceiling_price?: number;
-    /** Maximum discount percentage */
-    max_discount_percent?: number;
-    /** Additional discount percentage on top of PPP */
-    extra_discount_percent?: number;
-    /** Custom reasoning text */
-    custom_reasoning?: string;
-}
-/**
- * Request for AI-powered pricing suggestion
- */
-interface PricingSuggestionRequest {
-    /** Agent identifier */
-    agent_id: string;
-    /** Product identifier (optional) */
-    product_id?: string;
-    /** Base price in USD (must be > 0) */
-    base_price: number;
-    /** Currency code (default: "USD") */
-    currency?: string;
-    /** User profile for personalization */
-    user_profile?: UserProfile;
-    /** PPP configuration overrides */
-    ppp_config?: PPPConfig;
-}
-/**
- * AI-powered pricing suggestion response
- */
-interface PricingSuggestion {
-    /** Suggested price in USD */
-    suggested_amount: number;
-    /** Minimum acceptable price */
-    min_amount: number;
-    /** Maximum suggested price */
-    max_amount: number;
-    /** Currency code */
-    currency: string;
-    /** Human-readable explanation */
-    reasoning: string;
-    /** Whether PPP was applied */
-    ppp_adjusted: boolean;
-    /** PPP factor used (if applied) */
-    adjustment_factor?: number;
-}
-/**
- * Autonomous Delegate - Enables agent to sign transactions
- */
-interface AutonomousDelegate {
-    /** Unique identifier (UUID) */
-    id: string;
-    /** Session key this delegate is attached to */
-    session_key_id: string;
-    /** Whether the delegate is active */
-    is_active: boolean;
-    /** Maximum spending in USD */
-    max_amount_usd: number;
-    /** Amount already spent */
-    used_amount_usd: number;
-    /** Remaining spending allowance */
-    remaining_usd: number;
-    /** When the delegate expires (ISO 8601) */
-    expires_at: string;
-    /** When the delegate was created (ISO 8601) */
-    created_at: string;
-    /** When the delegate was revoked (if applicable) */
-    revoked_at?: string;
-    /** Last time the delegate was used */
-    last_used_at?: string;
-}
-/**
- * Request to enable autonomous signing
- */
-interface EnableAutonomyRequest {
-    /** Maximum spending in USD (must be > 0) */
-    max_amount_usd: number;
-    /** Duration in hours (1-168, max 7 days) */
-    duration_hours: number;
-    /** Ed25519 delegation signature (base64) */
-    delegation_signature: string;
-    /** Explicit expiration time (ISO 8601, optional) */
-    expires_at?: string;
-    /** Lit Protocol encrypted keypair (for device-bound keys) */
-    lit_encrypted_keypair?: string;
-    /** Hash of Lit Protocol encrypted data */
-    lit_data_hash?: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Response from enabling autonomous signing
- */
-interface EnableAutonomyResponse {
-    /** Delegate ID (UUID) */
-    delegate_id: string;
-    /** Session key ID (UUID) */
-    session_key_id: string;
-    /** Maximum spending in USD */
-    max_amount_usd: number;
-    /** When the delegate expires (ISO 8601) */
-    expires_at: string;
-    /** Public key of the delegate (base58) */
-    delegate_public_key: string;
-    /** Confirmation that autonomous mode is enabled */
-    autonomous_mode_enabled: boolean;
-    /** Whether Lit Protocol is being used */
-    lit_protocol_enabled: boolean;
-    /** True if device-bound key without Lit (fallback to client signing) */
-    requires_lit_for_auto_sign?: boolean;
-}
-/**
- * Request to revoke autonomous mode
- */
-interface RevokeAutonomyRequest {
-    /** Reason for revocation (optional) */
-    reason?: string;
-}
-/**
- * Autonomy status response
- */
-interface AutonomyStatus {
-    /** Whether autonomous mode is enabled */
-    autonomous_mode_enabled: boolean;
-    /** Active delegate (if any) */
-    delegate?: AutonomousDelegate;
-}
-/**
- * Request for AI-powered smart payment
- */
-interface SmartPaymentRequest {
-    /** Session token for limit enforcement (optional) */
-    session_token?: string;
-    /** Agent identifier */
-    agent_id: string;
-    /** User's Solana wallet address */
-    user_wallet: string;
-    /** Amount in USD (must be > 0) */
-    amount_usd: number;
-    /** Target merchant ID (optional) */
-    merchant_id?: string;
-    /** Token to use (default: "USDC") */
-    token?: PaymentToken;
-    /** Auto-detect if gasless is needed (optional) */
-    auto_detect_gasless?: boolean;
-    /** Enable instant settlement (optional) */
-    instant_settlement?: boolean;
-    /** Create escrow for this payment (optional) */
-    enable_escrow?: boolean;
-    /** Payment description */
-    description?: string;
-    /** Product details for receipt */
-    product_details?: Record<string, unknown>;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Smart Payment Status
- */
-type SmartPaymentStatus = 'pending' | 'confirmed' | 'awaiting_signature' | 'failed';
-/**
- * Response from smart payment
- */
-interface SmartPaymentResponse {
-    /** Payment ID (UUID) */
-    payment_id: string;
-    /** Current status */
-    status: SmartPaymentStatus;
-    /** Amount in USD */
-    amount_usd: number;
-    /** Whether gasless transaction was used */
-    gasless_used: boolean;
-    /** Whether settlement is complete */
-    settlement_complete: boolean;
-    /** Escrow ID if escrow was enabled */
-    escrow_id?: string;
-    /** Base64 encoded transaction (for signing) */
-    unsigned_transaction?: string;
-    /** Whether client signature is required */
-    requires_signature: boolean;
-    /** Transaction signature (if auto-signed) */
-    transaction_signature?: string;
-    /** Confirmation time in milliseconds */
-    confirmed_in_ms?: number;
-    /** URL to payment receipt */
-    receipt_url: string;
-    /** NFT receipt address (if minted) */
-    receipt_nft?: string;
-    /** Human-readable next steps */
-    next_steps: string;
-    /** URL to submit signed transaction */
-    submit_url?: string;
-    /** ISO 8601 timestamp */
-    created_at: string;
-}
-/**
- * Analytics data for an agent
- */
-interface AgentAnalytics {
-    /** Total number of payments */
-    total_payments: number;
-    /** Total volume in USD */
-    total_volume_usd: number;
-    /** Average payment amount in USD */
-    average_payment_usd: number;
-    /** Payment success rate (0-1) */
-    success_rate: number;
-    /** Number of active sessions */
-    active_sessions: number;
-    /** Number of active autonomous delegates */
-    active_delegates: number;
-    /** Total PPP savings in USD */
-    ppp_savings_usd: number;
-    /** Payments broken down by token */
-    payments_by_token: Record<PaymentToken, number>;
-    /** Daily payment statistics */
-    payments_by_day: Array<{
-        date: string;
-        count: number;
-        volume_usd: number;
-    }>;
-}
-/**
- * @deprecated Use device-bound session keys via `zendfi.sessionKeys.create()` instead.
- * Custodial session keys are deprecated and will be removed in a future version.
- */
-interface CreateSessionKeyRequest {
-    /** @deprecated */ user_wallet: string;
-    /** @deprecated */ agent_id: string;
-    /** @deprecated */ agent_name?: string;
-    /** @deprecated */ limit_usdc: number;
-    /** @deprecated */ duration_days?: number;
-    /** @deprecated */ device_fingerprint: string;
-    /** @deprecated */ link_session_id?: string;
-    /** @deprecated */ link_session_token?: string;
-}
-/**
- * @deprecated Use device-bound session keys instead.
- */
-interface CreateSessionKeyResponse {
-    /** @deprecated */ session_key_id: string;
-    /** @deprecated */ user_wallet: string;
-    /** @deprecated */ agent_id: string;
-    /** @deprecated */ agent_name?: string;
-    /** @deprecated */ limit_usdc: number;
-    /** @deprecated */ expires_at: string;
-    /** @deprecated */ requires_approval: boolean;
-    /** @deprecated */ approval_transaction: string;
-    /** @deprecated */ cross_app_compatible: boolean;
-    /** @deprecated */ instructions: SessionKeyInstructions;
-}
-/** @deprecated */
-interface SessionKeyInstructions {
-    step_1: string;
-    step_2: string;
-    step_3: string;
-    wallet_support: string[];
-}
-/**
- * Device-bound session key creation request (non-custodial mode)
- * Client generates keypair and encrypts it before sending
- */
-interface CreateDeviceBoundSessionKeyRequest {
-    /** User's main wallet address */
-    user_wallet: string;
-    /** Agent identifier for cross-app compatibility (e.g., "shopping-assistant-v1") */
-    agent_id: string;
-    /** Human-readable agent name (e.g., "AI Shopping Assistant") */
-    agent_name?: string;
-    /** Spending limit in USDC */
-    limit_usdc: number;
-    /** Duration in days (1-30) */
-    duration_days: number;
-    /** Client-encrypted session keypair (base64) */
-    encrypted_session_key: string;
-    /** Encryption nonce (base64, 12 bytes) */
-    nonce: string;
-    /** Public key of the session keypair */
-    session_public_key: string;
-    /** Device fingerprint (SHA-256 hex, 64 chars) */
-    device_fingerprint: string;
-    /** Optional recovery QR data */
-    recovery_qr_data?: string;
-}
-/**
- * Device-bound session key creation response
- */
-interface CreateDeviceBoundSessionKeyResponse {
-    /** UUID of the created session key */
-    session_key_id: string;
-    /** Always "device_bound" */
-    mode: string;
-    /** Always false for device-bound */
-    is_custodial: boolean;
-    /** User's main wallet address */
-    user_wallet: string;
-    /** Agent identifier */
-    agent_id: string;
-    /** Agent name (if provided) */
-    agent_name?: string;
-    /** Session wallet public key */
-    session_wallet: string;
-    /** Spending limit in USDC */
-    limit_usdc: number;
-    /** Expiration timestamp */
-    expires_at: string;
-    /** Always true for device-bound */
-    requires_client_signing: boolean;
-    /** True if this session key works across multiple apps with same agent_id */
-    cross_app_compatible: boolean;
-    /** Security details */
-    security_info: SessionKeySecurityInfo;
-}
-interface SessionKeySecurityInfo {
-    encryption_type: string;
-    device_bound: boolean;
-    backend_can_decrypt: boolean;
-    recovery_qr_saved: boolean;
-}
-/**
- * Session key status response
- */
-interface SessionKeyStatus {
-    /** UUID of the session key */
-    session_key_id: string;
-    /** Whether the key is currently active */
-    is_active: boolean;
-    /** Whether the approval transaction was confirmed */
-    is_approved: boolean;
-    /** Total spending limit in USDC */
-    limit_usdc: number;
-    /** Amount already spent in USDC */
-    used_amount_usdc: number;
-    /** Remaining balance in USDC */
-    remaining_usdc: number;
-    /** Expiration timestamp */
-    expires_at: string;
-    /** Days until expiry */
-    days_until_expiry: number;
-    /** Security status */
-    security_status: SecurityStatus;
-    /** Linked AI session info (if linked) */
-    linked_session?: LinkedSessionInfo;
-}
-/**
- * Information about a linked AI session (for policy enforcement)
- */
-interface LinkedSessionInfo {
-    /** Session ID */
-    session_id: string;
-    /** Agent ID */
-    agent_id: string;
-    /** Whether the linked session is active */
-    is_active: boolean;
-    /** Per-transaction limit */
-    max_per_transaction?: number;
-    /** Daily remaining */
-    remaining_today: number;
-    /** Weekly remaining */
-    remaining_this_week: number;
-    /** Monthly remaining */
-    remaining_this_month: number;
-    /** Effective limit (minimum of session key balance and session limits) */
-    effective_limit: number;
-}
-interface SecurityStatus {
-    device_fingerprint_matched: boolean;
-    recent_security_events: number;
-    last_used_at: string | null;
-}
-/**
- * Top-up request for adding funds to a session key
- */
-interface TopUpSessionKeyRequest {
-    /** User's main wallet address */
-    user_wallet: string;
-    /** Amount to add in USDC */
-    amount_usdc: number;
-    /** Device fingerprint for security */
-    device_fingerprint: string;
-}
-/**
- * Top-up response with unsigned transaction
- */
-interface TopUpSessionKeyResponse {
-    /** UUID of the session key */
-    session_key_id: string;
-    /** Previous limit before top-up */
-    previous_limit: number;
-    /** New limit after top-up */
-    new_limit: number;
-    /** Amount being added */
-    added_amount: number;
-    /** Base64 encoded top-up transaction (user must sign) */
-    top_up_transaction: string;
-    /** Block height for transaction validity */
-    last_valid_block_height: number;
-    /** Instructions for the user */
-    instructions: string;
-}
-/**
- * Submit signed transaction request
- */
-interface SubmitSignedTransactionRequest {
-    /** Base64 encoded signed transaction */
-    signed_transaction: string;
-    /** Optional session key ID (for some endpoints) */
-    session_key_id?: string;
-}
-/**
- * Submit transaction response
- */
-interface SubmitTransactionResponse {
-    success: boolean;
-    signature: string;
-    message: string;
-    /** For top-up submissions */
-    new_limit?: number;
-}
-/**
- * Session key list response
- */
-interface SessionKeyListResponse {
-    session_keys: SessionKeyStatus[];
-    stats: SessionKeyStats;
-    merchant_id: string;
-}
-interface SessionKeyStats {
-    total_keys: number;
-    active_keys: number;
-    total_limit_usdc: number;
-    total_used_usdc: number;
-}
-/**
- * Agent payment request - simplified payment via session
- */
-interface AgentPaymentRequest {
-    /** Session token for spending limit enforcement */
-    session_token: string;
-    /** Amount in USD */
-    amount: number;
-    /** Payment description */
-    description?: string;
-    /** Recipient merchant ID (optional if paying to session owner) */
-    recipient_merchant_id?: string;
-    /** Token to use (default: USDC) */
-    token?: PaymentToken;
-    /** Auto-detect if gasless is needed */
-    auto_gasless?: boolean;
-    /** Additional metadata */
-    metadata?: Record<string, any>;
-}
-/**
- * Agent payment response
- */
-interface AgentPaymentResponse {
-    /** UUID of the created payment */
-    payment_id: string;
-    /** Payment status */
-    status: 'pending' | 'processing' | 'confirmed' | 'failed' | 'awaiting_signature';
-    /** Amount in USD */
-    amount_usd: number;
-    /** Whether gasless mode was used */
-    gasless_used: boolean;
-    /** Transaction signature (if confirmed) */
-    transaction_signature?: string;
-    /** Confirmation time in milliseconds */
-    confirmed_in_ms?: number;
-    /** Receipt URL */
-    receipt_url?: string;
-    /** If true, client must sign the transaction */
-    requires_signature: boolean;
-    /** Base64 encoded unsigned transaction (if requires_signature) */
-    unsigned_transaction?: string;
-    /** URL to submit signed transaction */
-    submit_url?: string;
-    /** Next steps for the client */
-    next_steps: string;
-}
-
-/**
- * ZendFi Webhook Handlers
- * Type-safe webhook handlers with automatic verification and deduplication
- */
-
-/**
- * Webhook handler configuration
- */
-interface WebhookHandlerConfig {
-    /** Your webhook secret from ZendFi dashboard */
-    secret: string;
-    /** Optional: Path to store processed webhook IDs (for deduplication) */
-    onProcessed?: (webhookId: string) => Promise<void>;
-    /** Optional: Check if webhook was already processed */
-    isProcessed?: (webhookId: string) => Promise<boolean>;
-    /** Optional: Custom error handler */
-    onError?: (error: Error, event?: WebhookEvent) => void | Promise<void>;
-}
-/**
- * Event handler function type
- */
-type WebhookEventHandler<T = any> = (data: T, event: WebhookPayload) => void | Promise<void>;
-/**
- * Webhook handlers map - type-safe event handlers
- */
-type WebhookHandlers = Partial<{
-    'payment.created': WebhookEventHandler;
-    'payment.confirmed': WebhookEventHandler;
-    'payment.failed': WebhookEventHandler;
-    'payment.expired': WebhookEventHandler;
-    'subscription.created': WebhookEventHandler;
-    'subscription.activated': WebhookEventHandler;
-    'subscription.canceled': WebhookEventHandler;
-    'subscription.payment_failed': WebhookEventHandler;
-    'split.completed': WebhookEventHandler;
-    'split.failed': WebhookEventHandler;
-    'installment.due': WebhookEventHandler;
-    'installment.paid': WebhookEventHandler;
-    'installment.late': WebhookEventHandler;
-    'escrow.funded': WebhookEventHandler;
-    'escrow.released': WebhookEventHandler;
-    'escrow.refunded': WebhookEventHandler;
-    'escrow.disputed': WebhookEventHandler;
-    'invoice.sent': WebhookEventHandler;
-    'invoice.paid': WebhookEventHandler;
-}>;
-/**
- * Webhook processing result
- */
-interface WebhookResult {
-    success: boolean;
-    processed: boolean;
-    error?: string;
-    event?: WebhookEvent;
-    statusCode?: number;
-}
-declare function processWebhook(a: any, b?: any, c?: any): Promise<WebhookResult>;
-
-export { type SubscriptionId as $, type AgentApiKey as A, type Escrow as B, type CreateAgentApiKeyRequest as C, type ApproveEscrowRequest as D, type EnableAutonomyRequest as E, type DisputeEscrowRequest as F, type CreateInvoiceRequest as G, type Invoice as H, type InstallmentPlan as I, type WebhookPayload as J, type ApiKeyMode as K, type ListPaymentsRequest as L, processWebhook as M, type WebhookResult as N, type WebhookEventHandler as O, type PaymentIntent as P, type Brand as Q, type RefundEscrowRequest as R, type SmartPaymentRequest as S, type PaymentId as T, type SessionId as U, type VerifyWebhookRequest as V, type WebhookHandlerConfig as W, type AgentKeyId as X, type MerchantId as Y, type ZendFiConfig as Z, type InvoiceId as _, type WebhookHandlers as a, type EscrowId as a0, type InstallmentPlanId as a1, type PaymentLinkCode as a2, type IntentId as a3, asPaymentId as a4, asSessionId as a5, asAgentKeyId as a6, asMerchantId as a7, asInvoiceId as a8, asSubscriptionId as a9, type RevokeAutonomyRequest as aA, type SmartPaymentStatus as aB, type CreateSessionKeyRequest as aC, type CreateSessionKeyResponse as aD, type SessionKeyInstructions as aE, type CreateDeviceBoundSessionKeyRequest as aF, type CreateDeviceBoundSessionKeyResponse as aG, type SessionKeySecurityInfo as aH, type SessionKeyStatus as aI, type LinkedSessionInfo as aJ, type SecurityStatus as aK, type TopUpSessionKeyRequest as aL, type TopUpSessionKeyResponse as aM, type SubmitSignedTransactionRequest as aN, type SubmitTransactionResponse as aO, type SessionKeyListResponse as aP, type SessionKeyStats as aQ, asEscrowId as aa, asInstallmentPlanId as ab, asPaymentLinkCode as ac, asIntentId as ad, type Environment as ae, type Currency as af, type PaymentToken as ag, type PaymentStatus as ah, type SubscriptionStatus as ai, type InstallmentPlanStatus as aj, type EscrowStatus as ak, type InvoiceStatus as al, type SplitStatus as am, type WebhookEvent as an, type SplitRecipient as ao, type InstallmentScheduleItem as ap, type CreateInstallmentPlanResponse as aq, type ReleaseCondition as ar, type InvoiceLineItem as as, type ApiKeyScope as at, type SessionLimits as au, type PaymentIntentStatus as av, type CaptureMethod as aw, type UserProfile as ax, type PPPConfig as ay, type AutonomousDelegate as az, type CreateAgentSessionRequest as b, type AgentSession as c, type AgentPaymentRequest as d, type AgentPaymentResponse as e, type AgentAnalytics as f, type CreatePaymentIntentRequest as g, type ConfirmPaymentIntentRequest as h, type PaymentIntentEvent as i, type PPPFactor as j, type PricingSuggestionRequest as k, type PricingSuggestion as l, type EnableAutonomyResponse as m, type AutonomyStatus as n, type SmartPaymentResponse as o, type CreatePaymentRequest as p, type Payment as q, type PaginatedResponse as r, type CreateSubscriptionPlanRequest as s, type SubscriptionPlan as t, type CreateSubscriptionRequest as u, type Subscription as v, type CreatePaymentLinkRequest as w, type PaymentLink as x, type CreateInstallmentPlanRequest as y, type CreateEscrowRequest as z };