@campnetwork/origin 1.2.2 → 1.2.4

package/dist/core.d.ts

@@ -306,6 +306,52 @@ declare function hasAccess(this: Origin, user: Address, tokenId: bigint): Promis
 
 declare function subscriptionExpiry(this: Origin, tokenId: bigint, user: Address): Promise<bigint>;
 
+/**
+ * Response from getDataWithX402 when payment is required
+ */
+interface X402Response {
+    error: string;
+    marketplaceAction?: {
+        kind: string;
+        contract: Address;
+        network: string;
+        chainId: number;
+        method: string;
+        payer: Address;
+        payTo: Address;
+        tokenId: string;
+        duration: number;
+        asset: Address;
+        amount: string;
+        amountFormatted: string;
+    };
+}
+interface TransactionResult {
+    txHash: string;
+    receipt?: any;
+}
+/**
+ * Settles a payment intent response by purchasing access if needed.
+ * This method checks if the user already has access to the item, and if not,
+ * it calls buyAccess with the parameters from the payment intent response.
+ * Supports viem WalletClient, ethers Signer, and custom signer implementations.
+ *
+ * @param paymentIntentResponse - The response from getDataWithIntent containing payment details.
+ * @param signer - Optional signer object used to interact with the blockchain. If not provided, uses the connected wallet client.
+ * @returns A promise that resolves with the transaction hash and receipt, or null if access already exists.
+ * @throws {Error} If the response doesn't contain marketplace action or if the method is not buyAccess.
+ */
+declare function settlePaymentIntent(this: Origin, paymentIntentResponse: X402Response, signer?: any): Promise<TransactionResult | null>;
+
+/**
+ * Fetch data with X402 payment handling.
+ * @param {bigint} tokenId The token ID to fetch data for.
+ * @param {any} [signer] Optional signer object for signing the X402 intent.
+ * @returns {Promise<any>} A promise that resolves with the fetched data.
+ * @throws {Error} Throws an error if the data cannot be fetched or if no signer/wallet client is provided.
+ */
+declare function getDataWithIntent(this: Origin, tokenId: bigint, signer?: any, decide?: (terms: any) => Promise<boolean>): Promise<any>;
+
 interface RoyaltyInfo {
     tokenBoundAccount: Address;
     balance: bigint;
@@ -341,11 +387,13 @@ declare class Origin {
     buyAccess: typeof buyAccess;
     hasAccess: typeof hasAccess;
     subscriptionExpiry: typeof subscriptionExpiry;
+    settlePaymentIntent: typeof settlePaymentIntent;
+    getDataWithIntent: typeof getDataWithIntent;
     private jwt?;
     environment: Environment;
     private viemClient?;
     baseParentId?: bigint;
-    constructor(environment: Environment | string, jwt?: string, viemClient?: WalletClient, baseParentId?: bigint);
+    constructor(environment?: Environment | string, jwt?: string, viemClient?: WalletClient, baseParentId?: bigint);
     getJwt(): string | undefined;
     setViemClient(client: WalletClient): void;
     mintFile(file: File, metadata: Record<string, unknown>, license: LicenseTerms, parents?: bigint[], options?: {
@@ -376,14 +424,6 @@ declare class Origin {
      * @throws {Error} Throws an error if the data cannot be fetched.
      */
     getData(tokenId: bigint): Promise<any>;
-    /**
-     * Fetch data with X402 payment handling.
-     * @param {bigint} tokenId The token ID to fetch data for.
-     * @param {any} [signer] Optional signer object for signing the X402 intent.
-     * @returns {Promise<any>} A promise that resolves with the fetched data.
-     * @throws {Error} Throws an error if the data cannot be fetched or if no signer/wallet client is provided.
-     */
-    getDataWithX402(tokenId: bigint, signer?: any): Promise<any>;
     /**
      * Get the Token Bound Account (TBA) address for a specific token ID.
      * @param {bigint} tokenId - The token ID to get the TBA address for.

package/dist/core.esm.d.ts

@@ -306,6 +306,52 @@ declare function hasAccess(this: Origin, user: Address, tokenId: bigint): Promis
 
 declare function subscriptionExpiry(this: Origin, tokenId: bigint, user: Address): Promise<bigint>;
 
+/**
+ * Response from getDataWithX402 when payment is required
+ */
+interface X402Response {
+    error: string;
+    marketplaceAction?: {
+        kind: string;
+        contract: Address;
+        network: string;
+        chainId: number;
+        method: string;
+        payer: Address;
+        payTo: Address;
+        tokenId: string;
+        duration: number;
+        asset: Address;
+        amount: string;
+        amountFormatted: string;
+    };
+}
+interface TransactionResult {
+    txHash: string;
+    receipt?: any;
+}
+/**
+ * Settles a payment intent response by purchasing access if needed.
+ * This method checks if the user already has access to the item, and if not,
+ * it calls buyAccess with the parameters from the payment intent response.
+ * Supports viem WalletClient, ethers Signer, and custom signer implementations.
+ *
+ * @param paymentIntentResponse - The response from getDataWithIntent containing payment details.
+ * @param signer - Optional signer object used to interact with the blockchain. If not provided, uses the connected wallet client.
+ * @returns A promise that resolves with the transaction hash and receipt, or null if access already exists.
+ * @throws {Error} If the response doesn't contain marketplace action or if the method is not buyAccess.
+ */
+declare function settlePaymentIntent(this: Origin, paymentIntentResponse: X402Response, signer?: any): Promise<TransactionResult | null>;
+
+/**
+ * Fetch data with X402 payment handling.
+ * @param {bigint} tokenId The token ID to fetch data for.
+ * @param {any} [signer] Optional signer object for signing the X402 intent.
+ * @returns {Promise<any>} A promise that resolves with the fetched data.
+ * @throws {Error} Throws an error if the data cannot be fetched or if no signer/wallet client is provided.
+ */
+declare function getDataWithIntent(this: Origin, tokenId: bigint, signer?: any, decide?: (terms: any) => Promise<boolean>): Promise<any>;
+
 interface RoyaltyInfo {
     tokenBoundAccount: Address;
     balance: bigint;
@@ -341,11 +387,13 @@ declare class Origin {
     buyAccess: typeof buyAccess;
     hasAccess: typeof hasAccess;
     subscriptionExpiry: typeof subscriptionExpiry;
+    settlePaymentIntent: typeof settlePaymentIntent;
+    getDataWithIntent: typeof getDataWithIntent;
     private jwt?;
     environment: Environment;
     private viemClient?;
     baseParentId?: bigint;
-    constructor(environment: Environment | string, jwt?: string, viemClient?: WalletClient, baseParentId?: bigint);
+    constructor(environment?: Environment | string, jwt?: string, viemClient?: WalletClient, baseParentId?: bigint);
     getJwt(): string | undefined;
     setViemClient(client: WalletClient): void;
     mintFile(file: File, metadata: Record<string, unknown>, license: LicenseTerms, parents?: bigint[], options?: {
@@ -376,14 +424,6 @@ declare class Origin {
      * @throws {Error} Throws an error if the data cannot be fetched.
      */
     getData(tokenId: bigint): Promise<any>;
-    /**
-     * Fetch data with X402 payment handling.
-     * @param {bigint} tokenId The token ID to fetch data for.
-     * @param {any} [signer] Optional signer object for signing the X402 intent.
-     * @returns {Promise<any>} A promise that resolves with the fetched data.
-     * @throws {Error} Throws an error if the data cannot be fetched or if no signer/wallet client is provided.
-     */
-    getDataWithX402(tokenId: bigint, signer?: any): Promise<any>;
     /**
      * Get the Token Bound Account (TBA) address for a specific token ID.
      * @param {bigint} tokenId - The token ID to get the TBA address for.