@haven_ai/sdk 0.1.2 → 0.1.3

package/dist/index.d.cts

@@ -113,6 +113,43 @@ interface X402Receipt {
     merchantTo?: string | null;
     payer?: string;
     chainId?: number;
+    haven?: {
+        paymentId: string;
+        fundingTxHash: string;
+        fundingExplorerUrl: string;
+    };
+    merchant?: {
+        payTo: string | null;
+        settlementTxHash?: string | null;
+        settlementExplorerUrl?: string | null;
+    };
+    x402?: {
+        amount: string;
+        token: string;
+        network: string;
+        asset: string;
+        resource: string;
+    };
+}
+interface X402AuthorizationOptions {
+    /** Stable caller-supplied key for this user intent. Prevents duplicate approvals across fresh 402 quotes. */
+    idempotencyKey?: string;
+}
+interface ResumeAuthorizedX402Input extends X402AuthorizationOptions {
+    /** Payment or approval request ID returned by authorizeX402 / haven.fetch. */
+    paymentId: string;
+    /** Original or freshly parsed x402 requirements for the merchant retry. */
+    paymentRequired: X402PaymentRequired;
+}
+interface ResumeX402PaymentInput extends X402AuthorizationOptions {
+    /** Payment or approval request ID returned by authorizeX402 / haven.fetch. */
+    paymentId: string;
+    /** Original paid URL. If paymentRequired is omitted, Haven will call it once to re-read the 402 challenge. */
+    url: string;
+    /** Original fetch options. Reused for the 402 probe and final merchant retry. */
+    init?: RequestInit;
+    /** Original or freshly parsed x402 requirements. Supplying this avoids an extra merchant 402 probe. */
+    paymentRequired?: X402PaymentRequired;
 }
 type MachinePaymentRail = 'x402' | 'mpp_demo' | 'mpp_crypto' | 'stripe_deposit' | 'spt';
 interface MachinePaymentChallenge {
@@ -273,8 +310,10 @@ declare class HavenClient {
      *
      * Requires `delegateKey` to be set in the client config.
      */
-    authorizeX402(paymentRequired: X402PaymentRequired): Promise<X402Receipt>;
+    authorizeX402(paymentRequired: X402PaymentRequired, options?: X402AuthorizationOptions): Promise<X402Receipt>;
     private authorizeStandardX402;
+    resumeAuthorizedX402(input: ResumeAuthorizedX402Input): Promise<X402Receipt>;
+    resumeX402Payment(input: ResumeX402PaymentInput): Promise<Response>;
     /**
      * Fetch wrapper that automatically handles HTTP 402 responses.
      *
@@ -288,10 +327,15 @@ declare class HavenClient {
      *
      * Requires `delegateKey` to be set in the client config.
      */
-    fetch(url: string, init?: RequestInit): Promise<Response>;
+    fetch(url: string, init?: RequestInit, options?: X402AuthorizationOptions): Promise<Response>;
+    private retryX402Request;
     authorizeMachinePayment(challenge: MachinePaymentChallenge): Promise<MachinePaymentReceipt>;
     private authorizeMppDemoPayment;
     private fetchWithMachinePayment;
+    private assertCanResumeX402;
+    private mapX402ReceiptFromAuthorization;
+    private mapX402ReceiptFromStatus;
+    private buildX402Receipt;
     private createStandardX402Header;
     private cacheX402Receipt;
     private mapMachinePaymentReceipt;
@@ -315,6 +359,8 @@ declare class HavenClient {
      * ```
      */
     executeTool(toolName: string, input: Record<string, unknown>): Promise<Record<string, unknown>>;
+    private toolX402PaymentRequired;
+    private x402ToolReceipt;
     private toolError;
     private post;
     private get;
@@ -450,4 +496,4 @@ declare function parseMachinePaymentChallengeResponse(response: Response): Promi
 declare function buildMachinePaymentIdempotencyKey(challenge: MachinePaymentChallenge): string;
 declare function encodeMachinePaymentProof(receipt: Omit<MachinePaymentReceipt, 'proofHeader'>): string;
 
-export { type ClaudeTool, HavenApiError, HavenClient, type HavenClientConfig, HavenError, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, type MachinePaymentChallenge, type MachinePaymentRail, type MachinePaymentReceipt, type OpenAITool, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentRequest, type PaymentResult, type PaymentStatus, type PaymentStatusResult, type PendingApproval, type SignData, type X402PaymentOption, type X402PaymentRequired, type X402Receipt, addressFromKey, buildMachinePaymentIdempotencyKey, encodeMachinePaymentProof, encodePaymentProof, havenTools, parseMachinePaymentChallenge, parseMachinePaymentChallengeResponse, parsePaymentRequired, parsePaymentRequiredResponse, selectPaymentOption, signHash, verifySignature };
+export { type ClaudeTool, HavenApiError, HavenClient, type HavenClientConfig, HavenError, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, type MachinePaymentChallenge, type MachinePaymentRail, type MachinePaymentReceipt, type OpenAITool, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentRequest, type PaymentResult, type PaymentStatus, type PaymentStatusResult, type PendingApproval, type ResumeAuthorizedX402Input, type ResumeX402PaymentInput, type SignData, type X402AuthorizationOptions, type X402PaymentOption, type X402PaymentRequired, type X402Receipt, addressFromKey, buildMachinePaymentIdempotencyKey, encodeMachinePaymentProof, encodePaymentProof, havenTools, parseMachinePaymentChallenge, parseMachinePaymentChallengeResponse, parsePaymentRequired, parsePaymentRequiredResponse, selectPaymentOption, signHash, verifySignature };

package/dist/index.d.ts

@@ -113,6 +113,43 @@ interface X402Receipt {
     merchantTo?: string | null;
     payer?: string;
     chainId?: number;
+    haven?: {
+        paymentId: string;
+        fundingTxHash: string;
+        fundingExplorerUrl: string;
+    };
+    merchant?: {
+        payTo: string | null;
+        settlementTxHash?: string | null;
+        settlementExplorerUrl?: string | null;
+    };
+    x402?: {
+        amount: string;
+        token: string;
+        network: string;
+        asset: string;
+        resource: string;
+    };
+}
+interface X402AuthorizationOptions {
+    /** Stable caller-supplied key for this user intent. Prevents duplicate approvals across fresh 402 quotes. */
+    idempotencyKey?: string;
+}
+interface ResumeAuthorizedX402Input extends X402AuthorizationOptions {
+    /** Payment or approval request ID returned by authorizeX402 / haven.fetch. */
+    paymentId: string;
+    /** Original or freshly parsed x402 requirements for the merchant retry. */
+    paymentRequired: X402PaymentRequired;
+}
+interface ResumeX402PaymentInput extends X402AuthorizationOptions {
+    /** Payment or approval request ID returned by authorizeX402 / haven.fetch. */
+    paymentId: string;
+    /** Original paid URL. If paymentRequired is omitted, Haven will call it once to re-read the 402 challenge. */
+    url: string;
+    /** Original fetch options. Reused for the 402 probe and final merchant retry. */
+    init?: RequestInit;
+    /** Original or freshly parsed x402 requirements. Supplying this avoids an extra merchant 402 probe. */
+    paymentRequired?: X402PaymentRequired;
 }
 type MachinePaymentRail = 'x402' | 'mpp_demo' | 'mpp_crypto' | 'stripe_deposit' | 'spt';
 interface MachinePaymentChallenge {
@@ -273,8 +310,10 @@ declare class HavenClient {
      *
      * Requires `delegateKey` to be set in the client config.
      */
-    authorizeX402(paymentRequired: X402PaymentRequired): Promise<X402Receipt>;
+    authorizeX402(paymentRequired: X402PaymentRequired, options?: X402AuthorizationOptions): Promise<X402Receipt>;
     private authorizeStandardX402;
+    resumeAuthorizedX402(input: ResumeAuthorizedX402Input): Promise<X402Receipt>;
+    resumeX402Payment(input: ResumeX402PaymentInput): Promise<Response>;
     /**
      * Fetch wrapper that automatically handles HTTP 402 responses.
      *
@@ -288,10 +327,15 @@ declare class HavenClient {
      *
      * Requires `delegateKey` to be set in the client config.
      */
-    fetch(url: string, init?: RequestInit): Promise<Response>;
+    fetch(url: string, init?: RequestInit, options?: X402AuthorizationOptions): Promise<Response>;
+    private retryX402Request;
     authorizeMachinePayment(challenge: MachinePaymentChallenge): Promise<MachinePaymentReceipt>;
     private authorizeMppDemoPayment;
     private fetchWithMachinePayment;
+    private assertCanResumeX402;
+    private mapX402ReceiptFromAuthorization;
+    private mapX402ReceiptFromStatus;
+    private buildX402Receipt;
     private createStandardX402Header;
     private cacheX402Receipt;
     private mapMachinePaymentReceipt;
@@ -315,6 +359,8 @@ declare class HavenClient {
      * ```
      */
     executeTool(toolName: string, input: Record<string, unknown>): Promise<Record<string, unknown>>;
+    private toolX402PaymentRequired;
+    private x402ToolReceipt;
     private toolError;
     private post;
     private get;
@@ -450,4 +496,4 @@ declare function parseMachinePaymentChallengeResponse(response: Response): Promi
 declare function buildMachinePaymentIdempotencyKey(challenge: MachinePaymentChallenge): string;
 declare function encodeMachinePaymentProof(receipt: Omit<MachinePaymentReceipt, 'proofHeader'>): string;
 
-export { type ClaudeTool, HavenApiError, HavenClient, type HavenClientConfig, HavenError, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, type MachinePaymentChallenge, type MachinePaymentRail, type MachinePaymentReceipt, type OpenAITool, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentRequest, type PaymentResult, type PaymentStatus, type PaymentStatusResult, type PendingApproval, type SignData, type X402PaymentOption, type X402PaymentRequired, type X402Receipt, addressFromKey, buildMachinePaymentIdempotencyKey, encodeMachinePaymentProof, encodePaymentProof, havenTools, parseMachinePaymentChallenge, parseMachinePaymentChallengeResponse, parsePaymentRequired, parsePaymentRequiredResponse, selectPaymentOption, signHash, verifySignature };
+export { type ClaudeTool, HavenApiError, HavenClient, type HavenClientConfig, HavenError, HavenPaymentStateError, HavenSigningError, HavenTimeoutError, type MachinePaymentChallenge, type MachinePaymentRail, type MachinePaymentReceipt, type OpenAITool, type PaymentIntent, type PaymentNextAction, type PaymentPhase, type PaymentRequest, type PaymentResult, type PaymentStatus, type PaymentStatusResult, type PendingApproval, type ResumeAuthorizedX402Input, type ResumeX402PaymentInput, type SignData, type X402AuthorizationOptions, type X402PaymentOption, type X402PaymentRequired, type X402Receipt, addressFromKey, buildMachinePaymentIdempotencyKey, encodeMachinePaymentProof, encodePaymentProof, havenTools, parseMachinePaymentChallenge, parseMachinePaymentChallengeResponse, parsePaymentRequired, parsePaymentRequiredResponse, selectPaymentOption, signHash, verifySignature };