@zendfi/sdk 0.5.2 → 0.5.3

package/dist/{webhook-handler-D8wEoYd7.d.ts → webhook-handler-B-RdABQr.d.ts}

@@ -532,6 +532,8 @@ interface ConfirmPaymentIntentRequest {
     auto_gasless?: boolean;
     /** Additional metadata */
     metadata?: Record<string, unknown>;
+    /** Session token for spending limit enforcement (optional) */
+    session_token?: string;
 }
 /**
  * Payment Intent Event
@@ -807,6 +809,233 @@ interface AgentAnalytics {
         volume_usd: number;
     }>;
 }
+/**
+ * Session key creation request (custodial mode)
+ * Backend generates and stores the keypair
+ */
+interface CreateSessionKeyRequest {
+    /** User's main wallet address */
+    user_wallet: string;
+    /** Spending limit in USDC */
+    limit_usdc: number;
+    /** Duration in days (1-30) */
+    duration_days?: number;
+    /** Device fingerprint for security */
+    device_fingerprint: string;
+}
+/**
+ * Session key creation response (custodial mode)
+ */
+interface CreateSessionKeyResponse {
+    /** UUID of the created session key */
+    session_key_id: string;
+    /** User's main wallet address */
+    user_wallet: string;
+    /** Spending limit in USDC */
+    limit_usdc: number;
+    /** Expiration timestamp */
+    expires_at: string;
+    /** Whether user needs to sign approval transaction */
+    requires_approval: boolean;
+    /** Base64 encoded approval transaction (user must sign) */
+    approval_transaction: string;
+    /** Setup instructions */
+    instructions: SessionKeyInstructions;
+}
+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;
+    /** 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;
+    /** 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;
+    /** 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;
+}
+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
@@ -866,4 +1095,4 @@ interface WebhookResult {
 }
 declare function processWebhook(a: any, b?: any, c?: any): Promise<WebhookResult>;
 
-export { type PaymentLinkCode as $, type AgentApiKey as A, type CreateInvoiceRequest as B, type CreateAgentApiKeyRequest as C, type DisputeEscrowRequest as D, type EnableAutonomyRequest as E, type Invoice as F, type WebhookPayload as G, processWebhook as H, type InstallmentPlan as I, type WebhookResult as J, type WebhookEventHandler as K, type ListPaymentsRequest as L, type Brand as M, type PaymentId as N, type SessionId as O, type PaymentIntent as P, type AgentKeyId as Q, type RefundEscrowRequest as R, type SmartPaymentRequest as S, type MerchantId as T, type InvoiceId as U, type VerifyWebhookRequest as V, type WebhookHandlerConfig as W, type SubscriptionId as X, type EscrowId as Y, type ZendFiConfig as Z, type InstallmentPlanId as _, type WebhookHandlers as a, type IntentId as a0, asPaymentId as a1, asSessionId as a2, asAgentKeyId as a3, asMerchantId as a4, asInvoiceId as a5, asSubscriptionId as a6, asEscrowId as a7, asInstallmentPlanId as a8, asPaymentLinkCode as a9, asIntentId as aa, type Environment as ab, type ApiKeyMode as ac, type Currency as ad, type PaymentToken as ae, type PaymentStatus as af, type SubscriptionStatus as ag, type InstallmentPlanStatus as ah, type EscrowStatus as ai, type InvoiceStatus as aj, type SplitStatus as ak, type WebhookEvent as al, type SplitRecipient as am, type InstallmentScheduleItem as an, type CreateInstallmentPlanResponse as ao, type ReleaseCondition as ap, type InvoiceLineItem as aq, type ApiKeyScope as ar, type SessionLimits as as, type PaymentIntentStatus as at, type CaptureMethod as au, type UserProfile as av, type PPPConfig as aw, type AutonomousDelegate as ax, type RevokeAutonomyRequest as ay, type SmartPaymentStatus as az, type CreateAgentSessionRequest as b, type AgentSession as c, type AgentAnalytics as d, type CreatePaymentIntentRequest as e, type ConfirmPaymentIntentRequest as f, type PaymentIntentEvent as g, type PPPFactor as h, type PricingSuggestionRequest as i, type PricingSuggestion as j, type EnableAutonomyResponse as k, type AutonomyStatus as l, type SmartPaymentResponse as m, type CreatePaymentRequest as n, type Payment as o, type PaginatedResponse as p, type CreateSubscriptionPlanRequest as q, type SubscriptionPlan as r, type CreateSubscriptionRequest as s, type Subscription as t, type CreatePaymentLinkRequest as u, type PaymentLink as v, type CreateInstallmentPlanRequest as w, type CreateEscrowRequest as x, type Escrow as y, type ApproveEscrowRequest as z };
+export { processWebhook as $, type AgentApiKey as A, type PaginatedResponse as B, type CreateAgentApiKeyRequest as C, type CreateSubscriptionPlanRequest as D, type EnableAutonomyRequest as E, type SubscriptionPlan as F, type CreateSubscriptionRequest as G, type Subscription as H, type CreatePaymentLinkRequest as I, type PaymentLink as J, type CreateInstallmentPlanRequest as K, type ListPaymentsRequest as L, type InstallmentPlan as M, type CreateEscrowRequest as N, type Escrow as O, type PaymentIntent as P, type ApproveEscrowRequest as Q, type RefundEscrowRequest as R, type SmartPaymentRequest as S, type TopUpSessionKeyRequest as T, type DisputeEscrowRequest as U, type CreateInvoiceRequest as V, type WebhookHandlerConfig as W, type Invoice as X, type VerifyWebhookRequest as Y, type ZendFiConfig as Z, type WebhookPayload as _, type WebhookHandlers as a, type WebhookResult as a0, type WebhookEventHandler as a1, type Brand as a2, type PaymentId as a3, type SessionId as a4, type AgentKeyId as a5, type MerchantId as a6, type InvoiceId as a7, type SubscriptionId as a8, type EscrowId as a9, type CreateInstallmentPlanResponse as aA, type ReleaseCondition as aB, type InvoiceLineItem as aC, type ApiKeyScope as aD, type SessionLimits as aE, type PaymentIntentStatus as aF, type CaptureMethod as aG, type UserProfile as aH, type PPPConfig as aI, type AutonomousDelegate as aJ, type RevokeAutonomyRequest as aK, type SmartPaymentStatus as aL, type SessionKeyInstructions as aM, type SessionKeySecurityInfo as aN, type SecurityStatus as aO, type SessionKeyStats as aP, type InstallmentPlanId as aa, type PaymentLinkCode as ab, type IntentId as ac, asPaymentId as ad, asSessionId as ae, asAgentKeyId as af, asMerchantId as ag, asInvoiceId as ah, asSubscriptionId as ai, asEscrowId as aj, asInstallmentPlanId as ak, asPaymentLinkCode as al, asIntentId as am, type Environment as an, type ApiKeyMode as ao, type Currency as ap, type PaymentToken as aq, type PaymentStatus as ar, type SubscriptionStatus as as, type InstallmentPlanStatus as at, type EscrowStatus as au, type InvoiceStatus as av, type SplitStatus as aw, type WebhookEvent as ax, type SplitRecipient as ay, type InstallmentScheduleItem 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 CreateSessionKeyRequest as p, type CreateSessionKeyResponse as q, type CreateDeviceBoundSessionKeyRequest as r, type CreateDeviceBoundSessionKeyResponse as s, type SubmitSignedTransactionRequest as t, type SubmitTransactionResponse as u, type SessionKeyStatus as v, type SessionKeyListResponse as w, type TopUpSessionKeyResponse as x, type CreatePaymentRequest as y, type Payment as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zendfi/sdk",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Zero-config TypeScript SDK for ZendFi crypto payments",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",