@nevermined-io/payments 1.4.0 → 1.5.0

package/dist/api/plans-api.js

@@ -1,8 +1,9 @@
+import { safeParseJson } from '../common/helper.js';
 import { PaymentsError } from '../common/payments.error.js';
 import { Currency, EURC_TOKEN_ADDRESS, PaginationOptions, } from '../common/types.js';
 import { ZeroAddress } from '../environments.js';
 import { getRandomBigInt, isEthereumAddress } from '../utils.js';
-import { BasePaymentsAPI } from './base-payments.js';
+import { BasePaymentsAPI, resolvePublicationHeaders } from './base-payments.js';
 import * as Plans from '../plans.js';
 import { ContractsAPI } from './contracts-api.js';
 import { API_URL_GET_PLAN, API_URL_GET_PLAN_AGENTS, API_URL_MINT_EXPIRABLE_PLAN, API_URL_MINT_PLAN, API_URL_ORDER_PLAN, API_URL_PLAN_BALANCE, API_URL_REGISTER_PLAN, API_URL_STRIPE_CHECKOUT, API_URL_GET_PLANS, } from './nvm-api.js';
@@ -18,7 +19,11 @@ export class PlansAPI extends BasePaymentsAPI {
     /**
      * Builds a Fiat price configuration for a plan.
      *
-     * @param amount - Amount to charge in minor units (e.g., cents) as bigint.
+     * `amount` is in **6-decimal units** (USDC convention, NOT cents). To
+     * charge $2.00, pass `2_000_000n`. Minimum is `1_000_000n` ($1.00) —
+     * lower values are rejected server-side with `BCK.PROTOCOL.0047`.
+     *
+     * @param amount - Amount to charge in 6-decimal units (e.g. `2_000_000n` for $2.00) as bigint.
      * @param receiver - Wallet address that will receive the payment.
      * @param currency - Fiat currency code (default: 'USD'). Any ISO 4217 code accepted by Stripe.
      * @returns The PlanPriceConfig representing a fiat price.
@@ -193,7 +198,7 @@ export class PlansAPI extends BasePaymentsAPI {
      *
      * @returns The unique identifier of the plan (Plan ID) of the newly created plan.
      */
-    async registerPlan(planMetadata, priceConfig, creditsConfig, nonce = getRandomBigInt(), accessLimit) {
+    async registerPlan(planMetadata, priceConfig, creditsConfig, nonce = getRandomBigInt(), accessLimit, publicationOptions) {
         if (accessLimit && !['credits', 'time'].includes(accessLimit)) {
             throw new PaymentsError('Invalid access limit', 'accessLimit must be either "credits" or "time"');
         }
@@ -209,7 +214,7 @@ export class PlansAPI extends BasePaymentsAPI {
             accessLimit,
             ...(priceConfig.currency && { currency: priceConfig.currency }),
         };
-        const options = this.getBackendHTTPOptions('POST', body);
+        const options = this.getBackendHTTPOptions('POST', body, resolvePublicationHeaders(publicationOptions));
         const url = new URL(API_URL_REGISTER_PLAN, this.environment.backend);
         const response = await fetch(url, options);
         if (!response.ok) {
@@ -247,13 +252,13 @@ export class PlansAPI extends BasePaymentsAPI {
      *
      * @returns The unique identifier of the plan (Plan ID) of the newly created plan.
      */
-    async registerCreditsPlan(planMetadata, priceConfig, creditsConfig) {
+    async registerCreditsPlan(planMetadata, priceConfig, creditsConfig, publicationOptions) {
         // Credits plans must have durationSecs = 0 (non-expirable) and either fixed or dynamic redemption
         if (BigInt(creditsConfig.durationSecs) !== 0n)
             throw new PaymentsError('The creditsConfig.durationSecs must be 0 for credits plans (non-expirable)');
         if (creditsConfig.minAmount > creditsConfig.maxAmount)
             throw new PaymentsError('The creditsConfig.minAmount can not be more than creditsConfig.maxAmount');
-        return this.registerPlan(planMetadata, priceConfig, creditsConfig, undefined, 'credits');
+        return this.registerPlan(planMetadata, priceConfig, creditsConfig, undefined, 'credits', publicationOptions);
     }
     /**
      *
@@ -285,13 +290,13 @@ export class PlansAPI extends BasePaymentsAPI {
      *
      * @returns The unique identifier of the plan (Plan ID) of the newly created plan.
      */
-    async registerTimePlan(planMetadata, priceConfig, creditsConfig) {
+    async registerTimePlan(planMetadata, priceConfig, creditsConfig, publicationOptions) {
         // Time plans must have durationSecs > 0 (expirable) and isRedemptionAmountFixed = false
         if (BigInt(creditsConfig.durationSecs) === 0n)
             throw new PaymentsError('The creditsConfig.durationSecs must be greater than 0 for time plans (expirable)');
         if (creditsConfig.isRedemptionAmountFixed)
             throw new PaymentsError('The creditsConfig.isRedemptionAmountFixed must be false for time plans');
-        return this.registerPlan(planMetadata, priceConfig, creditsConfig, undefined, 'time');
+        return this.registerPlan(planMetadata, priceConfig, creditsConfig, undefined, 'time', publicationOptions);
     }
     /**
      *
@@ -321,9 +326,9 @@ export class PlansAPI extends BasePaymentsAPI {
      *
      * @returns The unique identifier of the plan (Plan ID) of the newly created plan.
      */
-    async registerCreditsTrialPlan(planMetadata, priceConfig, creditsConfig) {
+    async registerCreditsTrialPlan(planMetadata, priceConfig, creditsConfig, publicationOptions) {
         planMetadata.isTrialPlan = true;
-        return this.registerCreditsPlan(planMetadata, priceConfig, creditsConfig);
+        return this.registerCreditsPlan(planMetadata, priceConfig, creditsConfig, publicationOptions);
     }
     /**
      *
@@ -353,9 +358,9 @@ export class PlansAPI extends BasePaymentsAPI {
      *
      * @returns The unique identifier of the plan (Plan ID) of the newly created plan.
      */
-    async registerTimeTrialPlan(planMetadata, priceConfig, creditsConfig) {
+    async registerTimeTrialPlan(planMetadata, priceConfig, creditsConfig, publicationOptions) {
         planMetadata.isTrialPlan = true;
-        return this.registerTimePlan(planMetadata, priceConfig, creditsConfig);
+        return this.registerTimePlan(planMetadata, priceConfig, creditsConfig, publicationOptions);
     }
     /**
      * Gets the information about a Payment Plan by its identifier.
@@ -373,7 +378,7 @@ export class PlansAPI extends BasePaymentsAPI {
         const url = new URL(query, this.environment.backend);
         const response = await fetch(url);
         if (!response.ok) {
-            throw PaymentsError.fromBackend('Plan not found', await response.json());
+            throw PaymentsError.fromBackend('Plan not found', await safeParseJson(response));
         }
         return response.json();
     }
@@ -394,7 +399,7 @@ export class PlansAPI extends BasePaymentsAPI {
         const options = this.getBackendHTTPOptions('GET');
         const response = await fetch(url, options);
         if (!response.ok) {
-            throw PaymentsError.fromBackend('Unable to get plans', await response.json());
+            throw PaymentsError.fromBackend('Unable to get plans', await safeParseJson(response));
         }
         const data = await response.json();
         return data;
@@ -424,7 +429,7 @@ export class PlansAPI extends BasePaymentsAPI {
         const url = new URL(query, this.environment.backend);
         const response = await fetch(url);
         if (!response.ok) {
-            throw PaymentsError.fromBackend('Plan not found', await response.json());
+            throw PaymentsError.fromBackend('Plan not found', await safeParseJson(response));
         }
         return response.json();
     }
@@ -467,7 +472,7 @@ export class PlansAPI extends BasePaymentsAPI {
         const url = new URL(balanceUrl, this.environment.backend);
         const response = await fetch(url, options);
         if (!response.ok) {
-            throw PaymentsError.fromBackend('Unable to get balance', await response.json());
+            throw PaymentsError.fromBackend('Unable to get balance', await safeParseJson(response));
         }
         return response.json();
     }
@@ -495,7 +500,7 @@ export class PlansAPI extends BasePaymentsAPI {
         const url = new URL(API_URL_ORDER_PLAN.replace(':planId', planId), this.environment.backend);
         const response = await fetch(url, options);
         if (!response.ok) {
-            throw PaymentsError.fromBackend('Unable to order plan', await response.json());
+            throw PaymentsError.fromBackend('Unable to order plan', await safeParseJson(response));
         }
         return response.json();
     }
@@ -525,7 +530,7 @@ export class PlansAPI extends BasePaymentsAPI {
         const url = new URL(API_URL_STRIPE_CHECKOUT, this.environment.backend);
         const response = await fetch(url, options);
         if (!response.ok) {
-            throw PaymentsError.fromBackend('Unable to order fiat plan', await response.json());
+            throw PaymentsError.fromBackend('Unable to order fiat plan', await safeParseJson(response));
         }
         return response.json();
     }
@@ -556,7 +561,7 @@ export class PlansAPI extends BasePaymentsAPI {
         const url = new URL(API_URL_MINT_PLAN, this.environment.backend);
         const response = await fetch(url, options);
         if (!response.ok) {
-            throw PaymentsError.fromBackend('Unable to mint plan credits', await response.json());
+            throw PaymentsError.fromBackend('Unable to mint plan credits', await safeParseJson(response));
         }
         return response.json();
     }
@@ -593,7 +598,7 @@ export class PlansAPI extends BasePaymentsAPI {
         const url = new URL(API_URL_MINT_EXPIRABLE_PLAN, this.environment.backend);
         const response = await fetch(url, options);
         if (!response.ok) {
-            throw PaymentsError.fromBackend('Unable to mint expirable credits', await response.json());
+            throw PaymentsError.fromBackend('Unable to mint expirable credits', await safeParseJson(response));
         }
         return response.json();
     }

package/dist/api/plans-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"plans-api.js","sourceRoot":"","sources":["../../src/api/plans-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { PaymentsError } from '../common/payments.error.js'\nimport {\n  Address,\n  Currency,\n  EURC_TOKEN_ADDRESS,\n  NvmAPIResult,\n  PaginationOptions,\n  PaymentOptions,\n  PlanBalance,\n  PlanCreditsConfig,\n  PlanRedemptionType,\n  PlanMetadata,\n  PlanPriceConfig,\n  StripeCheckoutResult,\n} from '../common/types.js'\nimport { ZeroAddress } from '../environments.js'\nimport { getRandomBigInt, isEthereumAddress } from '../utils.js'\nimport { BasePaymentsAPI } from './base-payments.js'\nimport * as Plans from '../plans.js'\nimport { ContractsAPI } from './contracts-api.js'\nimport {\n  API_URL_GET_PLAN,\n  API_URL_GET_PLAN_AGENTS,\n  API_URL_MINT_EXPIRABLE_PLAN,\n  API_URL_MINT_PLAN,\n  API_URL_ORDER_PLAN,\n  API_URL_PLAN_BALANCE,\n  API_URL_REGISTER_PLAN,\n  API_URL_STRIPE_CHECKOUT,\n  API_URL_GET_PLANS,\n} from './nvm-api.js'\n\n/**\n * The PlansAPI class provides methods to register and interact with payment plans on Nevermined.\n */\nexport class PlansAPI extends BasePaymentsAPI {\n  private contractsApi: ContractsAPI\n\n  constructor(options: PaymentOptions) {\n    super(options)\n    this.contractsApi = new ContractsAPI(options)\n  }\n  /** Price helpers */\n  /**\n   * Builds a Fiat price configuration for a plan.\n   *\n   * @param amount - Amount to charge in minor units (e.g., cents) as bigint.\n   * @param receiver - Wallet address that will receive the payment.\n   * @param currency - Fiat currency code (default: 'USD'). Any ISO 4217 code accepted by Stripe.\n   * @returns The PlanPriceConfig representing a fiat price.\n   */\n  public getFiatPriceConfig(\n    amount: bigint,\n    receiver: Address,\n    currency: Currency | string = Currency.USD,\n  ): PlanPriceConfig {\n    return Plans.getFiatPriceConfig(amount, receiver, currency)\n  }\n\n  /**\n   * Builds a Pay-As-You-Go price configuration using the template address from the API.\n   */\n  public async getPayAsYouGoPriceConfig(\n    amount: bigint,\n    receiver: Address,\n    tokenAddress: Address = ZeroAddress,\n  ): Promise<PlanPriceConfig> {\n    const templateAddress = await this.contractsApi.getPayAsYouGoTemplateAddress()\n    return Plans.getPayAsYouGoPriceConfig(amount, receiver, tokenAddress, templateAddress)\n  }\n\n  /**\n   * Builds a Pay-As-You-Go credits configuration.\n   */\n  public getPayAsYouGoCreditsConfig(): PlanCreditsConfig {\n    return Plans.getPayAsYouGoCreditsConfig()\n  }\n\n  /**\n   * Builds a crypto price configuration for a plan.\n   *\n   * @param amount - Amount to charge in token minor units as bigint.\n   * @param receiver - Wallet address that will receive the payment.\n   * @param tokenAddress - Optional ERC20 token address. If omitted, native token is assumed.\n   * @returns The PlanPriceConfig representing a crypto price.\n   */\n  public getCryptoPriceConfig(\n    amount: bigint,\n    receiver: Address,\n    tokenAddress?: Address,\n  ): PlanPriceConfig {\n    return Plans.getCryptoPriceConfig(amount, receiver, tokenAddress)\n  }\n\n  /**\n   * Builds an ERC20 price configuration for a plan.\n   *\n   * @param amount - Amount to charge in token minor units as bigint.\n   * @param tokenAddress - ERC20 token contract address.\n   * @param receiver - Wallet address that will receive the payment.\n   * @returns The PlanPriceConfig representing an ERC20 price.\n   */\n  public getERC20PriceConfig(\n    amount: bigint,\n    tokenAddress: Address,\n    receiver: Address,\n  ): PlanPriceConfig {\n    return Plans.getERC20PriceConfig(amount, tokenAddress, receiver)\n  }\n\n  /**\n   * Builds an EURC (Euro stablecoin) price configuration for a plan.\n   *\n   * @param amount - Amount to charge in EURC minor units (6 decimals) as bigint.\n   * @param receiver - Wallet address that will receive the payment.\n   * @param eurcAddress - Optional EURC token address. Defaults to Base Mainnet EURC.\n   * @returns The PlanPriceConfig representing an EURC price.\n   */\n  public getEURCPriceConfig(\n    amount: bigint,\n    receiver: Address,\n    eurcAddress: Address = EURC_TOKEN_ADDRESS,\n  ): PlanPriceConfig {\n    return Plans.getEURCPriceConfig(amount, receiver, eurcAddress)\n  }\n\n  /**\n   * Builds a FREE price configuration (no payment required).\n   * @returns The PlanPriceConfig representing a free plan.\n   */\n  public getFreePriceConfig(): PlanPriceConfig {\n    return Plans.getFreePriceConfig()\n  }\n\n  /**\n   * Builds a native token price configuration for a plan.\n   *\n   * @param amount - Amount to charge in native token minor units as bigint.\n   * @param receiver - Wallet address that will receive the payment.\n   * @returns The PlanPriceConfig representing a native token price.\n   */\n  public getNativeTokenPriceConfig(amount: bigint, receiver: Address): PlanPriceConfig {\n    return Plans.getNativeTokenPriceConfig(amount, receiver)\n  }\n\n  /** Credits helpers */\n  /**\n   * Builds an EXPIRABLE credits configuration (time-based access).\n   *\n   * @param durationOfPlan - Duration in seconds.\n   * @returns The PlanCreditsConfig representing expirable credits.\n   */\n  public getExpirableDurationConfig(durationOfPlan: bigint): PlanCreditsConfig {\n    return Plans.getExpirableDurationConfig(durationOfPlan)\n  }\n\n  /**\n   * Builds a NON-EXPIRABLE credits configuration (no expiration).\n   * @returns The PlanCreditsConfig representing non-expirable credits.\n   */\n  public getNonExpirableDurationConfig(): PlanCreditsConfig {\n    return Plans.getNonExpirableDurationConfig()\n  }\n\n  /**\n   * Builds a FIXED credits configuration.\n   *\n   * @param creditsGranted - Total credits granted by the plan.\n   * @param creditsPerRequest - Credits spent per request (default 1n).\n   * @returns The PlanCreditsConfig representing fixed credits.\n   */\n  public getFixedCreditsConfig(creditsGranted: bigint, creditsPerRequest = 1n): PlanCreditsConfig {\n    return Plans.getFixedCreditsConfig(creditsGranted, creditsPerRequest)\n  }\n\n  /**\n   * Builds a DYNAMIC credits configuration (range-limited per request).\n   *\n   * @param creditsGranted - Total credits granted by the plan.\n   * @param minCreditsPerRequest - Minimum credits per request.\n   * @param maxCreditsPerRequest - Maximum credits per request.\n   * @returns The PlanCreditsConfig representing dynamic credits.\n   */\n  public getDynamicCreditsConfig(\n    creditsGranted: bigint,\n    minCreditsPerRequest = 1n,\n    maxCreditsPerRequest = 1n,\n  ): PlanCreditsConfig {\n    return Plans.getDynamicCreditsConfig(creditsGranted, minCreditsPerRequest, maxCreditsPerRequest)\n  }\n\n  /**\n   * Sets the redemption type in a credits configuration.\n   *\n   * @param creditsConfig - Credits configuration to modify.\n   * @param redemptionType - Redemption type to set.\n   * @returns The updated PlanCreditsConfig.\n   */\n  public setRedemptionType(\n    creditsConfig: PlanCreditsConfig,\n    redemptionType: PlanRedemptionType,\n  ): PlanCreditsConfig {\n    return Plans.setRedemptionType(creditsConfig, redemptionType)\n  }\n\n  /**\n   * Marks whether burns of these credits are mirrored on-chain.\n   *\n   * @param creditsConfig - Credits configuration to modify.\n   * @param onchainMirror - Whether on-chain mirroring is enabled. Defaults\n   *   to `true` so calling `setOnchainMirror(config)` enables the mirror;\n   *   pass `false` explicitly to disable it. The `PlanCreditsConfig`\n   *   field itself defaults to `false` (set by all credits-config\n   *   builders) — when `false` the credits ledger lives in the API's\n   *   Postgres and burns are recorded off-chain only; when `true`, an\n   *   on-chain audit mirror replays each burn to `NFT1155Credits`.\n   * @returns The updated PlanCreditsConfig.\n   */\n  public setOnchainMirror(\n    creditsConfig: PlanCreditsConfig,\n    onchainMirror = true,\n  ): PlanCreditsConfig {\n    return Plans.setOnchainMirror(creditsConfig, onchainMirror)\n  }\n  /**\n   * This method is used to create a singleton instance of the PlansAPI class.\n   *\n   * @param options - The options to initialize the payments class.\n   * @returns The instance of the PlansAPI class.\n   */\n  static getInstance(options: PaymentOptions): PlansAPI {\n    return new PlansAPI(options)\n  }\n\n  /**\n   *\n   * It allows to an AI Builder to register a Payment Plan on Nevermined in a flexible manner.\n   * A Payment Plan defines 2 main aspects:\n   *   1. What a subscriber needs to pay to get the plan (i.e. 100 USDC, 5 USD, etc).\n   *   2. What the subscriber gets in return to access the AI agents associated to the plan (i.e. 100 credits, 1 week of usage, etc).\n   *\n   * With Payment Plans, AI Builders control the usage to their AI Agents.\n   *\n   * Every time a user accesses an AI Agent to the Payment Plan, the usage consumes from a capped amount of credits (or when the plan duration expires).\n   * When the user consumes all the credits, the plan automatically expires and the user needs to top up to continue using the service.\n   *\n   * @remarks\n   * This method is oriented to AI Builders.\n   * The NVM API Key must have publication permissions.\n   *\n   * @see https://nevermined.ai/docs/tutorials/builders/create-plan\n   *\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   * @param nonce - Optional nonce to prevent replay attacks. Default is a random BigInt.\n   * @example\n   * ```\n   *  const cryptoPriceConfig = getNativeTokenPriceConfig(100n, builderAddress)\n   *  const creditsConfig = getFixedCreditsConfig(100n)\n   *  const { planId } = await payments.plans.registerPlan({ name: 'AI Assistants Plan'}, cryptoPriceConfig, creditsConfig)\n   * ```\n   *\n   * @returns The unique identifier of the plan (Plan ID) of the newly created plan.\n   */\n  public async registerPlan(\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n    nonce = getRandomBigInt(),\n    accessLimit?: 'credits' | 'time',\n  ): Promise<{ planId: string }> {\n    if (accessLimit && !['credits', 'time'].includes(accessLimit)) {\n      throw new PaymentsError(\n        'Invalid access limit',\n        'accessLimit must be either \"credits\" or \"time\"',\n      )\n    }\n    if (!accessLimit) {\n      accessLimit = BigInt(creditsConfig.durationSecs) > 0n ? 'time' : 'credits'\n    }\n    const body = {\n      metadataAttributes: planMetadata,\n      priceConfig,\n      creditsConfig,\n      nonce,\n      isTrialPlan: planMetadata.isTrialPlan || false,\n      accessLimit,\n      ...(priceConfig.currency && { currency: priceConfig.currency }),\n    }\n    const options = this.getBackendHTTPOptions('POST', body)\n    const url = new URL(API_URL_REGISTER_PLAN, this.environment.backend)\n\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw Error(`${response.statusText} - ${await response.text()}`)\n    }\n\n    return response.json()\n  }\n\n  /**\n   *\n   * It allows to an AI Builder to create a Payment Plan on Nevermined based on Credits.\n   * A Nevermined Credits Plan limits the access by the access/usage of the Plan.\n   * With them, AI Builders control the number of requests that can be made to an agent or service.\n   * Every time a user accesses any resouce associated to the Payment Plan, the usage consumes from a capped amount of credits.\n   * When the user consumes all the credits, the plan automatically expires and the user needs to top up to continue using the service.\n   *\n   * @remarks This method is oriented to AI Builders\n   * @remarks To call this method, the NVM API Key must have publication permissions\n   *\n   * @see https://nevermined.ai/docs/tutorials/builders/create-plan\n   *\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   *\n   * @example\n   * ```\n   *  const cryptoPriceConfig = getNativeTokenPriceConfig(100n, builderAddress)\n   *  const creditsConfig = getFixedCreditsConfig(100n)\n   *  const { planId } = await payments.plans.registerCreditsPlan(\n   *     { name: 'AI Credits Plan'},\n   *     cryptoPriceConfig,\n   *     creditsConfig\n   * )\n   * ```\n   *\n   * @returns The unique identifier of the plan (Plan ID) of the newly created plan.\n   */\n  public async registerCreditsPlan(\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n  ): Promise<{ planId: string }> {\n    // Credits plans must have durationSecs = 0 (non-expirable) and either fixed or dynamic redemption\n    if (BigInt(creditsConfig.durationSecs) !== 0n)\n      throw new PaymentsError(\n        'The creditsConfig.durationSecs must be 0 for credits plans (non-expirable)',\n      )\n\n    if (creditsConfig.minAmount > creditsConfig.maxAmount)\n      throw new PaymentsError(\n        'The creditsConfig.minAmount can not be more than creditsConfig.maxAmount',\n      )\n\n    return this.registerPlan(planMetadata, priceConfig, creditsConfig, undefined, 'credits')\n  }\n\n  /**\n   *\n   * It allows to an AI Builder to create a Payment Plan on Nevermined limited by duration.\n   * A Nevermined Credits Plan limits the access by the access/usage of the Plan.\n   * With them, AI Builders control the number of requests that can be made to an agent or service.\n   * Every time a user accesses any resouce associated to the Payment Plan, the usage consumes from a capped amount of credits.\n   * When the user consumes all the credits, the plan automatically expires and the user needs to top up to continue using the service.\n   *\n   * @remarks This method is oriented to AI Builders\n   * @remarks To call this method, the NVM API Key must have publication permissions\n   *\n   * @see https://nevermined.ai/docs/tutorials/builders/create-plan\n   *\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   *\n   * @example\n   * ```\n   *  const cryptoPriceConfig = getNativeTokenPriceConfig(100n, builderAddress)\n   *  const 1dayDurationPlan = getExpirableDurationConfig(ONE_DAY_DURATION)\n   *  const { planId } = await payments.plans.registerTimePlan(\n   *    { name: 'Just for today plan'},\n   *    cryptoPriceConfig,\n   *    1dayDurationPlan\n   *  )\n   * ```\n   *\n   * @returns The unique identifier of the plan (Plan ID) of the newly created plan.\n   */\n  public async registerTimePlan(\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n  ): Promise<{ planId: string }> {\n    // Time plans must have durationSecs > 0 (expirable) and isRedemptionAmountFixed = false\n    if (BigInt(creditsConfig.durationSecs) === 0n)\n      throw new PaymentsError(\n        'The creditsConfig.durationSecs must be greater than 0 for time plans (expirable)',\n      )\n\n    if (creditsConfig.isRedemptionAmountFixed)\n      throw new PaymentsError(\n        'The creditsConfig.isRedemptionAmountFixed must be false for time plans',\n      )\n\n    return this.registerPlan(planMetadata, priceConfig, creditsConfig, undefined, 'time')\n  }\n\n  /**\n   *\n   * It allows to an AI Builder to create a Trial Payment Plan on Nevermined limited by duration.\n   * A Nevermined Trial Plan allow subscribers of that plan to test the Agents associated to it.\n   * A Trial plan is a plan that only can be purchased once by a user.\n   * Trial plans, as regular plans, can be limited by duration (i.e 1 week of usage) or by credits (i.e 100 credits to use the agent).\n   * @remarks This method is oriented to AI Builders\n   * @remarks To call this method, the NVM API Key must have publication permissions\n   *\n   * @see https://nevermined.ai/docs/tutorials/builders/create-plan\n   *\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   *\n   * @example\n   * ```\n   *  const freePriceConfig = getFreePriceConfig()\n   *  const 1dayDurationPlan = getExpirableDurationConfig(ONE_DAY_DURATION)\n   *  const { planId } = await payments.plans.registerCreditsTrialPlan(\n   *    {name: 'Trial plan'},\n   *    freePriceConfig,\n   *    1dayDurationPlan\n   * )\n   * ```\n   *\n   * @returns The unique identifier of the plan (Plan ID) of the newly created plan.\n   */\n  public async registerCreditsTrialPlan(\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n  ): Promise<{ planId: string }> {\n    planMetadata.isTrialPlan = true\n    return this.registerCreditsPlan(planMetadata, priceConfig, creditsConfig)\n  }\n\n  /**\n   *\n   * It allows to an AI Builder to create a Trial Payment Plan on Nevermined limited by duration.\n   * A Nevermined Trial Plan allow subscribers of that plan to test the Agents associated to it.\n   * A Trial plan is a plan that only can be purchased once by a user.\n   * Trial plans, as regular plans, can be limited by duration (i.e 1 week of usage) or by credits (i.e 100 credits to use the agent).\n   * @remarks This method is oriented to AI Builders\n   * @remarks To call this method, the NVM API Key must have publication permissions\n   *\n   * @see https://nevermined.ai/docs/tutorials/builders/create-plan\n   *\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   *\n   * @example\n   * ```\n   *  const freePriceConfig = getFreePriceConfig()\n   *  const 1dayDurationPlan = getExpirableDurationConfig(ONE_DAY_DURATION)\n   *  const { planId } = await payments.plans.registerTimeTrialPlan(\n   *    {name: '1 day Trial plan'},\n   *    freePriceConfig,\n   *    1dayDurationPlan\n   * )\n   * ```\n   *\n   * @returns The unique identifier of the plan (Plan ID) of the newly created plan.\n   */\n  public async registerTimeTrialPlan(\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n  ): Promise<{ planId: string }> {\n    planMetadata.isTrialPlan = true\n    return this.registerTimePlan(planMetadata, priceConfig, creditsConfig)\n  }\n\n  /**\n   * Gets the information about a Payment Plan by its identifier.\n   *\n   * @param planId - The unique identifier of the plan.\n   * @returns A promise that resolves to the plan's description.\n   * @throws PaymentsError if the plan is not found.\n   * @example\n   * ```\n   *  const plan = payments.plans.getPlan(planId)\n   * ```\n   */\n  public async getPlan(planId: string) {\n    const query = API_URL_GET_PLAN.replace(':planId', planId)\n    const url = new URL(query, this.environment.backend)\n    const response = await fetch(url)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Plan not found', await response.json())\n    }\n    return response.json()\n  }\n\n  /**\n   *\n   * @param page - The page number to retrieve.\n   * @param offset - The number of items per page.\n   * @param sortBy - The field to sort the results by.\n   * @param sortOrder - The order in which to sort the results.\n   * @returns A promise that resolves to the list of all different plans.\n   */\n  public async getPlans(page = 1, offset = 100, sortBy = 'created', sortOrder = 'desc') {\n    const url = new URL(API_URL_GET_PLANS, this.environment.backend)\n    url.searchParams.set('page', page.toString())\n    url.searchParams.set('offset', offset.toString())\n    url.searchParams.set('sortBy', sortBy)\n    url.searchParams.set('sortOrder', sortOrder)\n    const options = this.getBackendHTTPOptions('GET')\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to get plans', await response.json())\n    }\n\n    const data = await response.json()\n    return data\n  }\n\n  /**\n   * Gets the list of Agents that have associated a specific Payment Plan.\n   * All the agents returned can be accessed by the users that are subscribed to the Payment Plan.\n   *\n   * @param planId - The unique identifier of the plan.\n   * @param pagination - Optional pagination options to control the number of results returned.\n   * @returns A promise that resolves to the list of agents associated with the plan.\n   * @throws PaymentsError if the plan is not found.\n   *\n   * @example\n   * ```\n   *  const result = payments.plans.getAgentsAssociatedToAPlan(planId)\n   *  // {\n   *  //  total: 10,\n   *  //  page: 1,\n   *  //  offset: 5,\n   *  //  agents: [ ..]\n   *  // }\n   * ```\n   */\n  public async getAgentsAssociatedToAPlan(planId: string, pagination = new PaginationOptions()) {\n    const query =\n      API_URL_GET_PLAN_AGENTS.replace(':planId', planId) + '?' + pagination.asQueryParams()\n    const url = new URL(query, this.environment.backend)\n    const response = await fetch(url)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Plan not found', await response.json())\n    }\n    return response.json()\n  }\n\n  /**\n   * Gets the balance of an account for a Payment Plan.\n   *\n   * @param planId - The identifier of the Payment Plan.\n   * @param accountAddress - The address of the account to get the balance for.\n   * @returns @see {@link PlanBalance} A promise that resolves to the balance result.\n   * @throws PaymentsError if unable to get the balance.\n   *\n   * ```\n   * const balance = payments.plans.getPlanBalance(planId)\n   * // {\n   * //     planId: '105906633592154016712415751065660953070604027297000423385655551747721326921578',\n   * //     planType: 'credits',\n   * //     holderAddress: '0x505384192Ba6a4D4b50EAB846ee67db3b9A93359',\n   * //     creditsContract: '0xdd0240858fE744C3BF245DD377abBC04d1FDA443',\n   * //     balance: '100',\n   * //     isSubscriber: true\n   * //   }\n   * ```\n   *\n   */\n  public async getPlanBalance(planId: string, accountAddress?: Address): Promise<PlanBalance> {\n    const holderAddress = isEthereumAddress(accountAddress)\n      ? accountAddress\n      : this.getAccountAddress()\n\n    if (!holderAddress) {\n      throw new PaymentsError('Holder address is required')\n    }\n\n    const balanceUrl = API_URL_PLAN_BALANCE.replace(':planId', planId).replace(\n      ':holderAddress',\n      holderAddress,\n    )\n\n    const options = {\n      method: 'GET',\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n      },\n    }\n    const url = new URL(balanceUrl, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to get balance', await response.json())\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Orders a Payment Plan requiring the payment in crypto. The user must have enough balance in the selected token.\n   *\n   * @remarks\n   * The payment is done using crypto in the token (ERC20 or native) defined in the plan.\n   *\n   * @param planId - The unique identifier of the plan.\n   * @returns  @see {@link NvmAPIResult} A promise that resolves indicating if the operation was successful.\n   * @throws PaymentsError if unable to order the plan.\n   *\n   * @example\n   * ```\n   * const result = await payments.plans.orderPlan(planId)\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async orderPlan(planId: string): Promise<NvmAPIResult> {\n    const options = this.getBackendHTTPOptions('POST')\n    const url = new URL(API_URL_ORDER_PLAN.replace(':planId', planId), this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to order plan', await response.json())\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Initiates the purchase of a Plan requiring the payment in Fiat. This method will return a URL where the user can complete the payment.\n   *\n   * @remarks\n   * The payment is completed using a credit card in a external website (Stripe).\n   * @remarks\n   * This method is only valid for plans with price in Fiat.\n   *\n   * @param planId - The unique identifier of the plan.\n   * @returns A promise that resolves indicating the URL to complete the payment.\n   * @throws PaymentsError if unable to order the plan.\n   *\n   * @example\n   * ```\n   * const result = await payments.plans.orderFiatPlan(planId)\n   * ```\n   */\n  public async orderFiatPlan(planId: string): Promise<{ result: StripeCheckoutResult }> {\n    const body = {\n      sessionType: 'embedded',\n      planId,\n    }\n    const options = this.getBackendHTTPOptions('POST', body)\n    const url = new URL(API_URL_STRIPE_CHECKOUT, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to order fiat plan', await response.json())\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Mints credits for a given Payment Plan and transfers them to a receiver.\n   *\n   * @remarks\n   * Only the owner of the Payment Plan can call this method.\n   *\n   * @param planId - The unique identifier of the Payment Plan.\n   * @param creditsAmount - The number of credits to mint.\n   * @param creditsReceiver - The address of the receiver.\n   * @returns @see {@link NvmAPIResult} A promise that resolves to the result of the operation.\n   * @throws PaymentsError if unable to mint credits.\n   *\n   * @example\n   * ```\n   * const result = await payments.plans.mintPlanCredits(planId, 5n, '0x505384192Ba6a4D4b50EAB846ee67db3b9A93359')\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async mintPlanCredits(\n    planId: string,\n    creditsAmount: bigint,\n    creditsReceiver: Address,\n  ): Promise<NvmAPIResult> {\n    const body = { planId, amount: creditsAmount, creditsReceiver }\n    const options = this.getBackendHTTPOptions('POST', body)\n    const url = new URL(API_URL_MINT_PLAN, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to mint plan credits', await response.json())\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Mints expirable credits for a given Payment Plan and transfers them to a receiver.\n   *\n   * @remarks\n   * Only the owner of the Payment Plan can call this method.\n   *\n   * @param planId - The unique identifier of the Payment Plan.\n   * @param creditsAmount - The number of credits to mint.\n   * @param creditsReceiver - The address of the receiver.\n   * @param creditsDuration - The duration of the credits in seconds. Default is 0 (no expiration).\n   * @returns @see {@link NvmAPIResult} A promise that resolves to the result of the operation.\n   * @throws PaymentsError if unable to mint expirable credits.\n   *\n   * @example\n   * ```\n   * const result = await payments.plans.mintPlanExpirable(\n   *    planId,\n   *    1n,\n   *    '0x505384192Ba6a4D4b50EAB846ee67db3b9A93359',\n   *    86_400n // 1 day in seconds\n   *  )\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async mintPlanExpirable(\n    planId: string,\n    creditsAmount: bigint,\n    creditsReceiver: Address,\n    creditsDuration = 0n,\n  ): Promise<NvmAPIResult> {\n    const body = { planId, creditsAmount, creditsReceiver, creditsDuration }\n    const options = this.getBackendHTTPOptions('POST', body)\n    const url = new URL(API_URL_MINT_EXPIRABLE_PLAN, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to mint expirable credits', await response.json())\n    }\n\n    return response.json()\n  }\n}\n"]}
+{"version":3,"file":"plans-api.js","sourceRoot":"","sources":["../../src/api/plans-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { safeParseJson } from '../common/helper.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport {\n  Address,\n  Currency,\n  EURC_TOKEN_ADDRESS,\n  NvmAPIResult,\n  PaginationOptions,\n  PaymentOptions,\n  PlanBalance,\n  PlanCreditsConfig,\n  PlanRedemptionType,\n  PlanMetadata,\n  PlanPriceConfig,\n  StripeCheckoutResult,\n} from '../common/types.js'\nimport { ZeroAddress } from '../environments.js'\nimport { getRandomBigInt, isEthereumAddress } from '../utils.js'\nimport { BasePaymentsAPI, PublicationOptions, resolvePublicationHeaders } from './base-payments.js'\nimport * as Plans from '../plans.js'\nimport { ContractsAPI } from './contracts-api.js'\nimport {\n  API_URL_GET_PLAN,\n  API_URL_GET_PLAN_AGENTS,\n  API_URL_MINT_EXPIRABLE_PLAN,\n  API_URL_MINT_PLAN,\n  API_URL_ORDER_PLAN,\n  API_URL_PLAN_BALANCE,\n  API_URL_REGISTER_PLAN,\n  API_URL_STRIPE_CHECKOUT,\n  API_URL_GET_PLANS,\n} from './nvm-api.js'\n\n/**\n * The PlansAPI class provides methods to register and interact with payment plans on Nevermined.\n */\nexport class PlansAPI extends BasePaymentsAPI {\n  private contractsApi: ContractsAPI\n\n  constructor(options: PaymentOptions) {\n    super(options)\n    this.contractsApi = new ContractsAPI(options)\n  }\n  /** Price helpers */\n  /**\n   * Builds a Fiat price configuration for a plan.\n   *\n   * `amount` is in **6-decimal units** (USDC convention, NOT cents). To\n   * charge $2.00, pass `2_000_000n`. Minimum is `1_000_000n` ($1.00) —\n   * lower values are rejected server-side with `BCK.PROTOCOL.0047`.\n   *\n   * @param amount - Amount to charge in 6-decimal units (e.g. `2_000_000n` for $2.00) as bigint.\n   * @param receiver - Wallet address that will receive the payment.\n   * @param currency - Fiat currency code (default: 'USD'). Any ISO 4217 code accepted by Stripe.\n   * @returns The PlanPriceConfig representing a fiat price.\n   */\n  public getFiatPriceConfig(\n    amount: bigint,\n    receiver: Address,\n    currency: Currency | string = Currency.USD,\n  ): PlanPriceConfig {\n    return Plans.getFiatPriceConfig(amount, receiver, currency)\n  }\n\n  /**\n   * Builds a Pay-As-You-Go price configuration using the template address from the API.\n   */\n  public async getPayAsYouGoPriceConfig(\n    amount: bigint,\n    receiver: Address,\n    tokenAddress: Address = ZeroAddress,\n  ): Promise<PlanPriceConfig> {\n    const templateAddress = await this.contractsApi.getPayAsYouGoTemplateAddress()\n    return Plans.getPayAsYouGoPriceConfig(amount, receiver, tokenAddress, templateAddress)\n  }\n\n  /**\n   * Builds a Pay-As-You-Go credits configuration.\n   */\n  public getPayAsYouGoCreditsConfig(): PlanCreditsConfig {\n    return Plans.getPayAsYouGoCreditsConfig()\n  }\n\n  /**\n   * Builds a crypto price configuration for a plan.\n   *\n   * @param amount - Amount to charge in token minor units as bigint.\n   * @param receiver - Wallet address that will receive the payment.\n   * @param tokenAddress - Optional ERC20 token address. If omitted, native token is assumed.\n   * @returns The PlanPriceConfig representing a crypto price.\n   */\n  public getCryptoPriceConfig(\n    amount: bigint,\n    receiver: Address,\n    tokenAddress?: Address,\n  ): PlanPriceConfig {\n    return Plans.getCryptoPriceConfig(amount, receiver, tokenAddress)\n  }\n\n  /**\n   * Builds an ERC20 price configuration for a plan.\n   *\n   * @param amount - Amount to charge in token minor units as bigint.\n   * @param tokenAddress - ERC20 token contract address.\n   * @param receiver - Wallet address that will receive the payment.\n   * @returns The PlanPriceConfig representing an ERC20 price.\n   */\n  public getERC20PriceConfig(\n    amount: bigint,\n    tokenAddress: Address,\n    receiver: Address,\n  ): PlanPriceConfig {\n    return Plans.getERC20PriceConfig(amount, tokenAddress, receiver)\n  }\n\n  /**\n   * Builds an EURC (Euro stablecoin) price configuration for a plan.\n   *\n   * @param amount - Amount to charge in EURC minor units (6 decimals) as bigint.\n   * @param receiver - Wallet address that will receive the payment.\n   * @param eurcAddress - Optional EURC token address. Defaults to Base Mainnet EURC.\n   * @returns The PlanPriceConfig representing an EURC price.\n   */\n  public getEURCPriceConfig(\n    amount: bigint,\n    receiver: Address,\n    eurcAddress: Address = EURC_TOKEN_ADDRESS,\n  ): PlanPriceConfig {\n    return Plans.getEURCPriceConfig(amount, receiver, eurcAddress)\n  }\n\n  /**\n   * Builds a FREE price configuration (no payment required).\n   * @returns The PlanPriceConfig representing a free plan.\n   */\n  public getFreePriceConfig(): PlanPriceConfig {\n    return Plans.getFreePriceConfig()\n  }\n\n  /**\n   * Builds a native token price configuration for a plan.\n   *\n   * @param amount - Amount to charge in native token minor units as bigint.\n   * @param receiver - Wallet address that will receive the payment.\n   * @returns The PlanPriceConfig representing a native token price.\n   */\n  public getNativeTokenPriceConfig(amount: bigint, receiver: Address): PlanPriceConfig {\n    return Plans.getNativeTokenPriceConfig(amount, receiver)\n  }\n\n  /** Credits helpers */\n  /**\n   * Builds an EXPIRABLE credits configuration (time-based access).\n   *\n   * @param durationOfPlan - Duration in seconds.\n   * @returns The PlanCreditsConfig representing expirable credits.\n   */\n  public getExpirableDurationConfig(durationOfPlan: bigint): PlanCreditsConfig {\n    return Plans.getExpirableDurationConfig(durationOfPlan)\n  }\n\n  /**\n   * Builds a NON-EXPIRABLE credits configuration (no expiration).\n   * @returns The PlanCreditsConfig representing non-expirable credits.\n   */\n  public getNonExpirableDurationConfig(): PlanCreditsConfig {\n    return Plans.getNonExpirableDurationConfig()\n  }\n\n  /**\n   * Builds a FIXED credits configuration.\n   *\n   * @param creditsGranted - Total credits granted by the plan.\n   * @param creditsPerRequest - Credits spent per request (default 1n).\n   * @returns The PlanCreditsConfig representing fixed credits.\n   */\n  public getFixedCreditsConfig(creditsGranted: bigint, creditsPerRequest = 1n): PlanCreditsConfig {\n    return Plans.getFixedCreditsConfig(creditsGranted, creditsPerRequest)\n  }\n\n  /**\n   * Builds a DYNAMIC credits configuration (range-limited per request).\n   *\n   * @param creditsGranted - Total credits granted by the plan.\n   * @param minCreditsPerRequest - Minimum credits per request.\n   * @param maxCreditsPerRequest - Maximum credits per request.\n   * @returns The PlanCreditsConfig representing dynamic credits.\n   */\n  public getDynamicCreditsConfig(\n    creditsGranted: bigint,\n    minCreditsPerRequest = 1n,\n    maxCreditsPerRequest = 1n,\n  ): PlanCreditsConfig {\n    return Plans.getDynamicCreditsConfig(creditsGranted, minCreditsPerRequest, maxCreditsPerRequest)\n  }\n\n  /**\n   * Sets the redemption type in a credits configuration.\n   *\n   * @param creditsConfig - Credits configuration to modify.\n   * @param redemptionType - Redemption type to set.\n   * @returns The updated PlanCreditsConfig.\n   */\n  public setRedemptionType(\n    creditsConfig: PlanCreditsConfig,\n    redemptionType: PlanRedemptionType,\n  ): PlanCreditsConfig {\n    return Plans.setRedemptionType(creditsConfig, redemptionType)\n  }\n\n  /**\n   * Marks whether burns of these credits are mirrored on-chain.\n   *\n   * @param creditsConfig - Credits configuration to modify.\n   * @param onchainMirror - Whether on-chain mirroring is enabled. Defaults\n   *   to `true` so calling `setOnchainMirror(config)` enables the mirror;\n   *   pass `false` explicitly to disable it. The `PlanCreditsConfig`\n   *   field itself defaults to `false` (set by all credits-config\n   *   builders) — when `false` the credits ledger lives in the API's\n   *   Postgres and burns are recorded off-chain only; when `true`, an\n   *   on-chain audit mirror replays each burn to `NFT1155Credits`.\n   * @returns The updated PlanCreditsConfig.\n   */\n  public setOnchainMirror(\n    creditsConfig: PlanCreditsConfig,\n    onchainMirror = true,\n  ): PlanCreditsConfig {\n    return Plans.setOnchainMirror(creditsConfig, onchainMirror)\n  }\n  /**\n   * This method is used to create a singleton instance of the PlansAPI class.\n   *\n   * @param options - The options to initialize the payments class.\n   * @returns The instance of the PlansAPI class.\n   */\n  static getInstance(options: PaymentOptions): PlansAPI {\n    return new PlansAPI(options)\n  }\n\n  /**\n   *\n   * It allows to an AI Builder to register a Payment Plan on Nevermined in a flexible manner.\n   * A Payment Plan defines 2 main aspects:\n   *   1. What a subscriber needs to pay to get the plan (i.e. 100 USDC, 5 USD, etc).\n   *   2. What the subscriber gets in return to access the AI agents associated to the plan (i.e. 100 credits, 1 week of usage, etc).\n   *\n   * With Payment Plans, AI Builders control the usage to their AI Agents.\n   *\n   * Every time a user accesses an AI Agent to the Payment Plan, the usage consumes from a capped amount of credits (or when the plan duration expires).\n   * When the user consumes all the credits, the plan automatically expires and the user needs to top up to continue using the service.\n   *\n   * @remarks\n   * This method is oriented to AI Builders.\n   * The NVM API Key must have publication permissions.\n   *\n   * @see https://nevermined.ai/docs/tutorials/builders/create-plan\n   *\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   * @param nonce - Optional nonce to prevent replay attacks. Default is a random BigInt.\n   * @example\n   * ```\n   *  const cryptoPriceConfig = getNativeTokenPriceConfig(100n, builderAddress)\n   *  const creditsConfig = getFixedCreditsConfig(100n)\n   *  const { planId } = await payments.plans.registerPlan({ name: 'AI Assistants Plan'}, cryptoPriceConfig, creditsConfig)\n   * ```\n   *\n   * @returns The unique identifier of the plan (Plan ID) of the newly created plan.\n   */\n  public async registerPlan(\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n    nonce = getRandomBigInt(),\n    accessLimit?: 'credits' | 'time',\n    publicationOptions?: PublicationOptions,\n  ): Promise<{ planId: string }> {\n    if (accessLimit && !['credits', 'time'].includes(accessLimit)) {\n      throw new PaymentsError(\n        'Invalid access limit',\n        'accessLimit must be either \"credits\" or \"time\"',\n      )\n    }\n    if (!accessLimit) {\n      accessLimit = BigInt(creditsConfig.durationSecs) > 0n ? 'time' : 'credits'\n    }\n    const body = {\n      metadataAttributes: planMetadata,\n      priceConfig,\n      creditsConfig,\n      nonce,\n      isTrialPlan: planMetadata.isTrialPlan || false,\n      accessLimit,\n      ...(priceConfig.currency && { currency: priceConfig.currency }),\n    }\n    const options = this.getBackendHTTPOptions(\n      'POST',\n      body,\n      resolvePublicationHeaders(publicationOptions),\n    )\n    const url = new URL(API_URL_REGISTER_PLAN, this.environment.backend)\n\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw Error(`${response.statusText} - ${await response.text()}`)\n    }\n\n    return response.json()\n  }\n\n  /**\n   *\n   * It allows to an AI Builder to create a Payment Plan on Nevermined based on Credits.\n   * A Nevermined Credits Plan limits the access by the access/usage of the Plan.\n   * With them, AI Builders control the number of requests that can be made to an agent or service.\n   * Every time a user accesses any resouce associated to the Payment Plan, the usage consumes from a capped amount of credits.\n   * When the user consumes all the credits, the plan automatically expires and the user needs to top up to continue using the service.\n   *\n   * @remarks This method is oriented to AI Builders\n   * @remarks To call this method, the NVM API Key must have publication permissions\n   *\n   * @see https://nevermined.ai/docs/tutorials/builders/create-plan\n   *\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   *\n   * @example\n   * ```\n   *  const cryptoPriceConfig = getNativeTokenPriceConfig(100n, builderAddress)\n   *  const creditsConfig = getFixedCreditsConfig(100n)\n   *  const { planId } = await payments.plans.registerCreditsPlan(\n   *     { name: 'AI Credits Plan'},\n   *     cryptoPriceConfig,\n   *     creditsConfig\n   * )\n   * ```\n   *\n   * @returns The unique identifier of the plan (Plan ID) of the newly created plan.\n   */\n  public async registerCreditsPlan(\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n    publicationOptions?: PublicationOptions,\n  ): Promise<{ planId: string }> {\n    // Credits plans must have durationSecs = 0 (non-expirable) and either fixed or dynamic redemption\n    if (BigInt(creditsConfig.durationSecs) !== 0n)\n      throw new PaymentsError(\n        'The creditsConfig.durationSecs must be 0 for credits plans (non-expirable)',\n      )\n\n    if (creditsConfig.minAmount > creditsConfig.maxAmount)\n      throw new PaymentsError(\n        'The creditsConfig.minAmount can not be more than creditsConfig.maxAmount',\n      )\n\n    return this.registerPlan(\n      planMetadata,\n      priceConfig,\n      creditsConfig,\n      undefined,\n      'credits',\n      publicationOptions,\n    )\n  }\n\n  /**\n   *\n   * It allows to an AI Builder to create a Payment Plan on Nevermined limited by duration.\n   * A Nevermined Credits Plan limits the access by the access/usage of the Plan.\n   * With them, AI Builders control the number of requests that can be made to an agent or service.\n   * Every time a user accesses any resouce associated to the Payment Plan, the usage consumes from a capped amount of credits.\n   * When the user consumes all the credits, the plan automatically expires and the user needs to top up to continue using the service.\n   *\n   * @remarks This method is oriented to AI Builders\n   * @remarks To call this method, the NVM API Key must have publication permissions\n   *\n   * @see https://nevermined.ai/docs/tutorials/builders/create-plan\n   *\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   *\n   * @example\n   * ```\n   *  const cryptoPriceConfig = getNativeTokenPriceConfig(100n, builderAddress)\n   *  const 1dayDurationPlan = getExpirableDurationConfig(ONE_DAY_DURATION)\n   *  const { planId } = await payments.plans.registerTimePlan(\n   *    { name: 'Just for today plan'},\n   *    cryptoPriceConfig,\n   *    1dayDurationPlan\n   *  )\n   * ```\n   *\n   * @returns The unique identifier of the plan (Plan ID) of the newly created plan.\n   */\n  public async registerTimePlan(\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n    publicationOptions?: PublicationOptions,\n  ): Promise<{ planId: string }> {\n    // Time plans must have durationSecs > 0 (expirable) and isRedemptionAmountFixed = false\n    if (BigInt(creditsConfig.durationSecs) === 0n)\n      throw new PaymentsError(\n        'The creditsConfig.durationSecs must be greater than 0 for time plans (expirable)',\n      )\n\n    if (creditsConfig.isRedemptionAmountFixed)\n      throw new PaymentsError(\n        'The creditsConfig.isRedemptionAmountFixed must be false for time plans',\n      )\n\n    return this.registerPlan(\n      planMetadata,\n      priceConfig,\n      creditsConfig,\n      undefined,\n      'time',\n      publicationOptions,\n    )\n  }\n\n  /**\n   *\n   * It allows to an AI Builder to create a Trial Payment Plan on Nevermined limited by duration.\n   * A Nevermined Trial Plan allow subscribers of that plan to test the Agents associated to it.\n   * A Trial plan is a plan that only can be purchased once by a user.\n   * Trial plans, as regular plans, can be limited by duration (i.e 1 week of usage) or by credits (i.e 100 credits to use the agent).\n   * @remarks This method is oriented to AI Builders\n   * @remarks To call this method, the NVM API Key must have publication permissions\n   *\n   * @see https://nevermined.ai/docs/tutorials/builders/create-plan\n   *\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   *\n   * @example\n   * ```\n   *  const freePriceConfig = getFreePriceConfig()\n   *  const 1dayDurationPlan = getExpirableDurationConfig(ONE_DAY_DURATION)\n   *  const { planId } = await payments.plans.registerCreditsTrialPlan(\n   *    {name: 'Trial plan'},\n   *    freePriceConfig,\n   *    1dayDurationPlan\n   * )\n   * ```\n   *\n   * @returns The unique identifier of the plan (Plan ID) of the newly created plan.\n   */\n  public async registerCreditsTrialPlan(\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n    publicationOptions?: PublicationOptions,\n  ): Promise<{ planId: string }> {\n    planMetadata.isTrialPlan = true\n    return this.registerCreditsPlan(planMetadata, priceConfig, creditsConfig, publicationOptions)\n  }\n\n  /**\n   *\n   * It allows to an AI Builder to create a Trial Payment Plan on Nevermined limited by duration.\n   * A Nevermined Trial Plan allow subscribers of that plan to test the Agents associated to it.\n   * A Trial plan is a plan that only can be purchased once by a user.\n   * Trial plans, as regular plans, can be limited by duration (i.e 1 week of usage) or by credits (i.e 100 credits to use the agent).\n   * @remarks This method is oriented to AI Builders\n   * @remarks To call this method, the NVM API Key must have publication permissions\n   *\n   * @see https://nevermined.ai/docs/tutorials/builders/create-plan\n   *\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   *\n   * @example\n   * ```\n   *  const freePriceConfig = getFreePriceConfig()\n   *  const 1dayDurationPlan = getExpirableDurationConfig(ONE_DAY_DURATION)\n   *  const { planId } = await payments.plans.registerTimeTrialPlan(\n   *    {name: '1 day Trial plan'},\n   *    freePriceConfig,\n   *    1dayDurationPlan\n   * )\n   * ```\n   *\n   * @returns The unique identifier of the plan (Plan ID) of the newly created plan.\n   */\n  public async registerTimeTrialPlan(\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n    publicationOptions?: PublicationOptions,\n  ): Promise<{ planId: string }> {\n    planMetadata.isTrialPlan = true\n    return this.registerTimePlan(planMetadata, priceConfig, creditsConfig, publicationOptions)\n  }\n\n  /**\n   * Gets the information about a Payment Plan by its identifier.\n   *\n   * @param planId - The unique identifier of the plan.\n   * @returns A promise that resolves to the plan's description.\n   * @throws PaymentsError if the plan is not found.\n   * @example\n   * ```\n   *  const plan = payments.plans.getPlan(planId)\n   * ```\n   */\n  public async getPlan(planId: string) {\n    const query = API_URL_GET_PLAN.replace(':planId', planId)\n    const url = new URL(query, this.environment.backend)\n    const response = await fetch(url)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Plan not found', await safeParseJson(response))\n    }\n    return response.json()\n  }\n\n  /**\n   *\n   * @param page - The page number to retrieve.\n   * @param offset - The number of items per page.\n   * @param sortBy - The field to sort the results by.\n   * @param sortOrder - The order in which to sort the results.\n   * @returns A promise that resolves to the list of all different plans.\n   */\n  public async getPlans(page = 1, offset = 100, sortBy = 'created', sortOrder = 'desc') {\n    const url = new URL(API_URL_GET_PLANS, this.environment.backend)\n    url.searchParams.set('page', page.toString())\n    url.searchParams.set('offset', offset.toString())\n    url.searchParams.set('sortBy', sortBy)\n    url.searchParams.set('sortOrder', sortOrder)\n    const options = this.getBackendHTTPOptions('GET')\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to get plans', await safeParseJson(response))\n    }\n\n    const data = await response.json()\n    return data\n  }\n\n  /**\n   * Gets the list of Agents that have associated a specific Payment Plan.\n   * All the agents returned can be accessed by the users that are subscribed to the Payment Plan.\n   *\n   * @param planId - The unique identifier of the plan.\n   * @param pagination - Optional pagination options to control the number of results returned.\n   * @returns A promise that resolves to the list of agents associated with the plan.\n   * @throws PaymentsError if the plan is not found.\n   *\n   * @example\n   * ```\n   *  const result = payments.plans.getAgentsAssociatedToAPlan(planId)\n   *  // {\n   *  //  total: 10,\n   *  //  page: 1,\n   *  //  offset: 5,\n   *  //  agents: [ ..]\n   *  // }\n   * ```\n   */\n  public async getAgentsAssociatedToAPlan(planId: string, pagination = new PaginationOptions()) {\n    const query =\n      API_URL_GET_PLAN_AGENTS.replace(':planId', planId) + '?' + pagination.asQueryParams()\n    const url = new URL(query, this.environment.backend)\n    const response = await fetch(url)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Plan not found', await safeParseJson(response))\n    }\n    return response.json()\n  }\n\n  /**\n   * Gets the balance of an account for a Payment Plan.\n   *\n   * @param planId - The identifier of the Payment Plan.\n   * @param accountAddress - The address of the account to get the balance for.\n   * @returns @see {@link PlanBalance} A promise that resolves to the balance result.\n   * @throws PaymentsError if unable to get the balance.\n   *\n   * ```\n   * const balance = payments.plans.getPlanBalance(planId)\n   * // {\n   * //     planId: '105906633592154016712415751065660953070604027297000423385655551747721326921578',\n   * //     planType: 'credits',\n   * //     holderAddress: '0x505384192Ba6a4D4b50EAB846ee67db3b9A93359',\n   * //     creditsContract: '0xdd0240858fE744C3BF245DD377abBC04d1FDA443',\n   * //     balance: '100',\n   * //     isSubscriber: true\n   * //   }\n   * ```\n   *\n   */\n  public async getPlanBalance(planId: string, accountAddress?: Address): Promise<PlanBalance> {\n    const holderAddress = isEthereumAddress(accountAddress)\n      ? accountAddress\n      : this.getAccountAddress()\n\n    if (!holderAddress) {\n      throw new PaymentsError('Holder address is required')\n    }\n\n    const balanceUrl = API_URL_PLAN_BALANCE.replace(':planId', planId).replace(\n      ':holderAddress',\n      holderAddress,\n    )\n\n    const options = {\n      method: 'GET',\n      headers: {\n        Accept: 'application/json',\n        'Content-Type': 'application/json',\n      },\n    }\n    const url = new URL(balanceUrl, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to get balance', await safeParseJson(response))\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Orders a Payment Plan requiring the payment in crypto. The user must have enough balance in the selected token.\n   *\n   * @remarks\n   * The payment is done using crypto in the token (ERC20 or native) defined in the plan.\n   *\n   * @param planId - The unique identifier of the plan.\n   * @returns  @see {@link NvmAPIResult} A promise that resolves indicating if the operation was successful.\n   * @throws PaymentsError if unable to order the plan.\n   *\n   * @example\n   * ```\n   * const result = await payments.plans.orderPlan(planId)\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async orderPlan(planId: string): Promise<NvmAPIResult> {\n    const options = this.getBackendHTTPOptions('POST')\n    const url = new URL(API_URL_ORDER_PLAN.replace(':planId', planId), this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to order plan', await safeParseJson(response))\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Initiates the purchase of a Plan requiring the payment in Fiat. This method will return a URL where the user can complete the payment.\n   *\n   * @remarks\n   * The payment is completed using a credit card in a external website (Stripe).\n   * @remarks\n   * This method is only valid for plans with price in Fiat.\n   *\n   * @param planId - The unique identifier of the plan.\n   * @returns A promise that resolves indicating the URL to complete the payment.\n   * @throws PaymentsError if unable to order the plan.\n   *\n   * @example\n   * ```\n   * const result = await payments.plans.orderFiatPlan(planId)\n   * ```\n   */\n  public async orderFiatPlan(planId: string): Promise<{ result: StripeCheckoutResult }> {\n    const body = {\n      sessionType: 'embedded',\n      planId,\n    }\n    const options = this.getBackendHTTPOptions('POST', body)\n    const url = new URL(API_URL_STRIPE_CHECKOUT, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to order fiat plan', await safeParseJson(response))\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Mints credits for a given Payment Plan and transfers them to a receiver.\n   *\n   * @remarks\n   * Only the owner of the Payment Plan can call this method.\n   *\n   * @param planId - The unique identifier of the Payment Plan.\n   * @param creditsAmount - The number of credits to mint.\n   * @param creditsReceiver - The address of the receiver.\n   * @returns @see {@link NvmAPIResult} A promise that resolves to the result of the operation.\n   * @throws PaymentsError if unable to mint credits.\n   *\n   * @example\n   * ```\n   * const result = await payments.plans.mintPlanCredits(planId, 5n, '0x505384192Ba6a4D4b50EAB846ee67db3b9A93359')\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async mintPlanCredits(\n    planId: string,\n    creditsAmount: bigint,\n    creditsReceiver: Address,\n  ): Promise<NvmAPIResult> {\n    const body = { planId, amount: creditsAmount, creditsReceiver }\n    const options = this.getBackendHTTPOptions('POST', body)\n    const url = new URL(API_URL_MINT_PLAN, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to mint plan credits', await safeParseJson(response))\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Mints expirable credits for a given Payment Plan and transfers them to a receiver.\n   *\n   * @remarks\n   * Only the owner of the Payment Plan can call this method.\n   *\n   * @param planId - The unique identifier of the Payment Plan.\n   * @param creditsAmount - The number of credits to mint.\n   * @param creditsReceiver - The address of the receiver.\n   * @param creditsDuration - The duration of the credits in seconds. Default is 0 (no expiration).\n   * @returns @see {@link NvmAPIResult} A promise that resolves to the result of the operation.\n   * @throws PaymentsError if unable to mint expirable credits.\n   *\n   * @example\n   * ```\n   * const result = await payments.plans.mintPlanExpirable(\n   *    planId,\n   *    1n,\n   *    '0x505384192Ba6a4D4b50EAB846ee67db3b9A93359',\n   *    86_400n // 1 day in seconds\n   *  )\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async mintPlanExpirable(\n    planId: string,\n    creditsAmount: bigint,\n    creditsReceiver: Address,\n    creditsDuration = 0n,\n  ): Promise<NvmAPIResult> {\n    const body = { planId, creditsAmount, creditsReceiver, creditsDuration }\n    const options = this.getBackendHTTPOptions('POST', body)\n    const url = new URL(API_URL_MINT_EXPIRABLE_PLAN, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend(\n        'Unable to mint expirable credits',\n        await safeParseJson(response),\n      )\n    }\n\n    return response.json()\n  }\n}\n"]}

package/dist/api/requests-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requests-api.d.ts","sourceRoot":"","sources":["../../src/api/requests-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,EACzB,MAAM,oBAAoB,CAAA;AAQ3B;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;IACnD;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB;IAK7D;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,sBAAsB,CACjC,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC,iBAAiB,CAAC;IAU7B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACU,uBAAuB,CAClC,cAAc,EAAE,MAAM,EACtB,aAAa,SAAM,EACnB,KAAK,UAAQ,GACZ,OAAO,CAAC,YAAY,CAAC;IAiDxB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACU,iBAAiB,CAAC,iBAAiB,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;CAmB/F"}
+{"version":3,"file":"requests-api.d.ts","sourceRoot":"","sources":["../../src/api/requests-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,EACzB,MAAM,oBAAoB,CAAA;AAS3B;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,eAAe;IACnD;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB;IAI7D;;;;;;;;;;;;;;;;;;;;OAoBG;IACU,sBAAsB,CACjC,IAAI,GAAE,wBAA6B,GAClC,OAAO,CAAC,iBAAiB,CAAC;IAa7B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACU,uBAAuB,CAClC,cAAc,EAAE,MAAM,EACtB,aAAa,SAAM,EACnB,KAAK,UAAQ,GACZ,OAAO,CAAC,YAAY,CAAC;IAgDxB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACU,iBAAiB,CAAC,iBAAiB,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC;CAsB/F"}

package/dist/api/requests-api.js

@@ -1,6 +1,7 @@
 import { BasePaymentsAPI } from './base-payments.js';
 import { API_URL_TRACK_AGENT_SUB_TASK, API_URL_SIMULATE_AGENT_REQUEST, API_URL_SIMULATE_REDEEM_AGENT_REQUEST, } from './nvm-api.js';
 import { PaymentsError } from '../common/payments.error.js';
+import { safeParseJson } from '../common/helper.js';
 /**
  * The AgentRequestsAPI class provides methods to manage the requests received by AI Agents integrated with Nevermined.
  *
@@ -41,7 +42,7 @@ export class AgentRequestsAPI extends BasePaymentsAPI {
         const options = this.getBackendHTTPOptions('POST', opts);
         const response = await fetch(url, options);
         if (!response.ok) {
-            throw PaymentsError.fromBackend('Unable to start simulation request', await response.json());
+            throw PaymentsError.fromBackend('Unable to start simulation request', await safeParseJson(response));
         }
         return response.json();
     }
@@ -82,7 +83,7 @@ export class AgentRequestsAPI extends BasePaymentsAPI {
             try {
                 const response = await fetch(url, options);
                 if (!response.ok) {
-                    lastError = PaymentsError.fromBackend('Unable to finish simulation request', await response.json());
+                    lastError = PaymentsError.fromBackend('Unable to finish simulation request', await safeParseJson(response));
                     if (attempt < maxRetries - 1) {
                         await new Promise((resolve) => setTimeout(resolve, 1000));
                         continue;
@@ -149,7 +150,7 @@ export class AgentRequestsAPI extends BasePaymentsAPI {
         const url = new URL(API_URL_TRACK_AGENT_SUB_TASK, this.environment.backend);
         const response = await fetch(url, options);
         if (!response.ok) {
-            throw PaymentsError.fromBackend('Unable to track agent sub task', await response.json());
+            throw PaymentsError.fromBackend('Unable to track agent sub task', await safeParseJson(response));
         }
         return response.json();
     }

package/dist/api/requests-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"requests-api.js","sourceRoot":"","sources":["../../src/api/requests-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { BasePaymentsAPI } from './base-payments.js'\nimport {\n  PaymentOptions,\n  TrackAgentSubTaskDto,\n  StartAgentRequest,\n  NvmAPIResult,\n  SimulationRequestOptions,\n} from '../common/types.js'\nimport {\n  API_URL_TRACK_AGENT_SUB_TASK,\n  API_URL_SIMULATE_AGENT_REQUEST,\n  API_URL_SIMULATE_REDEEM_AGENT_REQUEST,\n} from './nvm-api.js'\nimport { PaymentsError } from '../common/payments.error.js'\n\n/**\n * The AgentRequestsAPI class provides methods to manage the requests received by AI Agents integrated with Nevermined.\n *\n */\nexport class AgentRequestsAPI extends BasePaymentsAPI {\n  /**\n   * This method is used to create a singleton instance of the AgentRequestsAPI class.\n   *\n   * @param options - The options to initialize the payments class.\n   * @returns The instance of the AgentRequestsAPI class.\n   */\n  static getInstance(options: PaymentOptions): AgentRequestsAPI {\n    return new AgentRequestsAPI(options)\n  }\n\n\n  /**\n   * This method simulates an agent request.\n   *\n   * @remarks\n   * This method is used to simulate an agent request.\n   *\n   * @param opts - The options for the simulation request.\n   * @returns @see {@link StartAgentRequest} The information about the simulation of the request.\n   * @throws PaymentsError if unable to simulate the agent request.\n   *\n   * @example\n   * ```\n   * const result = await payments.requests.startSimulationRequest()\n   *\n   * // {\n   * //   agentRequestId: '3921032910321',\n   * //   urlMatching: 'https://api.example.com/agent-endpoint/1234',\n   * //   verbMatching: 'POST'\n   * // }\n   * ```\n   */\n  public async startSimulationRequest(\n    opts: SimulationRequestOptions = {},\n  ): Promise<StartAgentRequest> {\n    const url = new URL(API_URL_SIMULATE_AGENT_REQUEST, this.environment.backend).toString()\n    const options = this.getBackendHTTPOptions('POST', opts)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to start simulation request', await response.json())\n    }\n    return response.json()\n  }\n\n  /**\n   * This method simulates the redemption of credits for an agent request.\n   *\n   * @remarks\n   * This method is used to simulate the redemption of credits for an agent request.\n   *\n   * @param agentRequestId - The unique identifier of the agent request.\n   * @param marginPercent - The margin percentage to apply. Defaults to 20%.\n   * @param batch - Whether the request is a batch request. Defaults to false.\n   * @returns @see {@link NvmAPIResult} The result of the simulation.\n   * @throws PaymentsError if unable to finish the simulation request.\n   *\n   * @example\n   * ```\n   * const result = await payments.requests.finishSimulationRequest('arId-3921032910321', 0.2, true)\n   *\n   * // {\n   * //   creditsToRedeem: '10',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async finishSimulationRequest(\n    agentRequestId: string,\n    marginPercent = 0.2,\n    batch = false,\n  ): Promise<NvmAPIResult> {\n    const url = new URL(API_URL_SIMULATE_REDEEM_AGENT_REQUEST, this.environment.backend).toString()\n    const options = this.getBackendHTTPOptions('POST', {\n      agentRequestId,\n      marginPercent,\n      batch,\n    })\n\n    // Since this method is usually called immediately after the llm call\n    // the request might not be immediately available on helicone, so we need to retry.\n    const maxRetries = 3\n    let lastError: Error | null = null\n\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      try {\n        const response = await fetch(url, options)\n        if (!response.ok) {\n          lastError = PaymentsError.fromBackend(\n            'Unable to finish simulation request',\n            await response.json(),\n          )\n          if (attempt < maxRetries - 1) {\n            await new Promise((resolve) => setTimeout(resolve, 1000))\n            continue\n          }\n          throw lastError\n        }\n        return response.json()\n      } catch (error) {\n        if (error instanceof PaymentsError) {\n          lastError = error\n        } else {\n          lastError = PaymentsError.fromBackend('Unable to finish simulation request', {\n            error: String(error),\n          })\n        }\n        if (attempt < maxRetries - 1) {\n          await new Promise((resolve) => setTimeout(resolve, 1000))\n          continue\n        }\n        throw lastError\n      }\n    }\n\n    // This should never be reached, but TypeScript requires it\n    throw lastError || new PaymentsError('Unable to finish simulation request')\n  }\n\n\n  /**\n   * Tracks an agent sub task.\n   *\n   * @remarks\n   * This method is used by agent owners to track agent sub tasks for agent tasks.\n   * It records information about credit redemption, categorization tags, and processing descriptions.\n   *\n   * @param trackAgentSubTask - @see {@link TrackAgentSubTaskDto} The agent sub task data to track\n   * @returns @see {@link NvmAPIResult} A promise that resolves to the result of the operation.\n   * @throws PaymentsError if unable to track the agent sub task\n   *\n   * @example\n   * ```\n   * const result = await payments.requests.trackAgentSubTask({\n   *   agentRequestId: 'atx-12345',\n   *   creditsToRedeem: 5,\n   *   tag: 'high-priority',\n   *   description: 'Processing high-priority data request',\n   *   status: AgentTaskStatus.SUCCESS\n   * })\n   *\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async trackAgentSubTask(trackAgentSubTask: TrackAgentSubTaskDto): Promise<NvmAPIResult> {\n    const body = {\n      agentRequestId: trackAgentSubTask.agentRequestId,\n      creditsToRedeem: trackAgentSubTask.creditsToRedeem || 0,\n      tag: trackAgentSubTask.tag,\n      description: trackAgentSubTask.description,\n      status: trackAgentSubTask.status,\n    }\n\n    const options = this.getBackendHTTPOptions('POST', body)\n    const url = new URL(API_URL_TRACK_AGENT_SUB_TASK, this.environment.backend)\n    const response = await fetch(url, options)\n\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to track agent sub task', await response.json())\n    }\n\n    return response.json()\n  }\n}\n"]}
+{"version":3,"file":"requests-api.js","sourceRoot":"","sources":["../../src/api/requests-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { BasePaymentsAPI } from './base-payments.js'\nimport {\n  PaymentOptions,\n  TrackAgentSubTaskDto,\n  StartAgentRequest,\n  NvmAPIResult,\n  SimulationRequestOptions,\n} from '../common/types.js'\nimport {\n  API_URL_TRACK_AGENT_SUB_TASK,\n  API_URL_SIMULATE_AGENT_REQUEST,\n  API_URL_SIMULATE_REDEEM_AGENT_REQUEST,\n} from './nvm-api.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport { safeParseJson } from '../common/helper.js'\n\n/**\n * The AgentRequestsAPI class provides methods to manage the requests received by AI Agents integrated with Nevermined.\n *\n */\nexport class AgentRequestsAPI extends BasePaymentsAPI {\n  /**\n   * This method is used to create a singleton instance of the AgentRequestsAPI class.\n   *\n   * @param options - The options to initialize the payments class.\n   * @returns The instance of the AgentRequestsAPI class.\n   */\n  static getInstance(options: PaymentOptions): AgentRequestsAPI {\n    return new AgentRequestsAPI(options)\n  }\n\n  /**\n   * This method simulates an agent request.\n   *\n   * @remarks\n   * This method is used to simulate an agent request.\n   *\n   * @param opts - The options for the simulation request.\n   * @returns @see {@link StartAgentRequest} The information about the simulation of the request.\n   * @throws PaymentsError if unable to simulate the agent request.\n   *\n   * @example\n   * ```\n   * const result = await payments.requests.startSimulationRequest()\n   *\n   * // {\n   * //   agentRequestId: '3921032910321',\n   * //   urlMatching: 'https://api.example.com/agent-endpoint/1234',\n   * //   verbMatching: 'POST'\n   * // }\n   * ```\n   */\n  public async startSimulationRequest(\n    opts: SimulationRequestOptions = {},\n  ): Promise<StartAgentRequest> {\n    const url = new URL(API_URL_SIMULATE_AGENT_REQUEST, this.environment.backend).toString()\n    const options = this.getBackendHTTPOptions('POST', opts)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend(\n        'Unable to start simulation request',\n        await safeParseJson(response),\n      )\n    }\n    return response.json()\n  }\n\n  /**\n   * This method simulates the redemption of credits for an agent request.\n   *\n   * @remarks\n   * This method is used to simulate the redemption of credits for an agent request.\n   *\n   * @param agentRequestId - The unique identifier of the agent request.\n   * @param marginPercent - The margin percentage to apply. Defaults to 20%.\n   * @param batch - Whether the request is a batch request. Defaults to false.\n   * @returns @see {@link NvmAPIResult} The result of the simulation.\n   * @throws PaymentsError if unable to finish the simulation request.\n   *\n   * @example\n   * ```\n   * const result = await payments.requests.finishSimulationRequest('arId-3921032910321', 0.2, true)\n   *\n   * // {\n   * //   creditsToRedeem: '10',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async finishSimulationRequest(\n    agentRequestId: string,\n    marginPercent = 0.2,\n    batch = false,\n  ): Promise<NvmAPIResult> {\n    const url = new URL(API_URL_SIMULATE_REDEEM_AGENT_REQUEST, this.environment.backend).toString()\n    const options = this.getBackendHTTPOptions('POST', {\n      agentRequestId,\n      marginPercent,\n      batch,\n    })\n\n    // Since this method is usually called immediately after the llm call\n    // the request might not be immediately available on helicone, so we need to retry.\n    const maxRetries = 3\n    let lastError: Error | null = null\n\n    for (let attempt = 0; attempt < maxRetries; attempt++) {\n      try {\n        const response = await fetch(url, options)\n        if (!response.ok) {\n          lastError = PaymentsError.fromBackend(\n            'Unable to finish simulation request',\n            await safeParseJson(response),\n          )\n          if (attempt < maxRetries - 1) {\n            await new Promise((resolve) => setTimeout(resolve, 1000))\n            continue\n          }\n          throw lastError\n        }\n        return response.json()\n      } catch (error) {\n        if (error instanceof PaymentsError) {\n          lastError = error\n        } else {\n          lastError = PaymentsError.fromBackend('Unable to finish simulation request', {\n            error: String(error),\n          })\n        }\n        if (attempt < maxRetries - 1) {\n          await new Promise((resolve) => setTimeout(resolve, 1000))\n          continue\n        }\n        throw lastError\n      }\n    }\n\n    // This should never be reached, but TypeScript requires it\n    throw lastError || new PaymentsError('Unable to finish simulation request')\n  }\n\n  /**\n   * Tracks an agent sub task.\n   *\n   * @remarks\n   * This method is used by agent owners to track agent sub tasks for agent tasks.\n   * It records information about credit redemption, categorization tags, and processing descriptions.\n   *\n   * @param trackAgentSubTask - @see {@link TrackAgentSubTaskDto} The agent sub task data to track\n   * @returns @see {@link NvmAPIResult} A promise that resolves to the result of the operation.\n   * @throws PaymentsError if unable to track the agent sub task\n   *\n   * @example\n   * ```\n   * const result = await payments.requests.trackAgentSubTask({\n   *   agentRequestId: 'atx-12345',\n   *   creditsToRedeem: 5,\n   *   tag: 'high-priority',\n   *   description: 'Processing high-priority data request',\n   *   status: AgentTaskStatus.SUCCESS\n   * })\n   *\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async trackAgentSubTask(trackAgentSubTask: TrackAgentSubTaskDto): Promise<NvmAPIResult> {\n    const body = {\n      agentRequestId: trackAgentSubTask.agentRequestId,\n      creditsToRedeem: trackAgentSubTask.creditsToRedeem || 0,\n      tag: trackAgentSubTask.tag,\n      description: trackAgentSubTask.description,\n      status: trackAgentSubTask.status,\n    }\n\n    const options = this.getBackendHTTPOptions('POST', body)\n    const url = new URL(API_URL_TRACK_AGENT_SUB_TASK, this.environment.backend)\n    const response = await fetch(url, options)\n\n    if (!response.ok) {\n      throw PaymentsError.fromBackend(\n        'Unable to track agent sub task',\n        await safeParseJson(response),\n      )\n    }\n\n    return response.json()\n  }\n}\n"]}

package/dist/common/helper.d.ts

@@ -1,5 +1,16 @@
 import { Endpoint } from './types.js';
 export declare const sleep: (ms: number) => Promise<unknown>;
+/**
+ * Safe JSON parse for fetch responses. Reads the body once and tolerates
+ * non-JSON payloads (e.g. NGINX HTML 5xx gateway pages) by returning a
+ * `{ message }` shell that downstream error code paths can still consume.
+ *
+ * Prevents the failure mode tracked in #1727: callers doing
+ * `throw PaymentsError.fromBackend('...', await response.json())` would
+ * otherwise let a SyntaxError from `.json()` escape and surface as an
+ * `unhandledRejection` that can take the host Node process down.
+ */
+export declare function safeParseJson(response: Response): Promise<unknown>;
 export declare const jsonReplacer: (_key: any, value: {
     toString: () => any;
 }) => string | {

package/dist/common/helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/common/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,qBAAsD,CAAA;AAEtF,eAAO,MAAM,YAAY,GAAI,MAAM,GAAG,EAAE,OAAO;IAAE,QAAQ,EAAE,MAAM,GAAG,CAAA;CAAE;cAAX,MAAM,GAAG;CAEnE,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,WAAW,QAAQ,EAAE,KAAG,MAOnE,CAAA"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../src/common/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,qBAAsD,CAAA;AAEtF;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBxE;AAED,eAAO,MAAM,YAAY,GAAI,MAAM,GAAG,EAAE,OAAO;IAAE,QAAQ,EAAE,MAAM,GAAG,CAAA;CAAE;cAAX,MAAM,GAAG;CAEnE,CAAA;AAED,eAAO,MAAM,2BAA2B,GAAI,WAAW,QAAQ,EAAE,KAAG,MAOnE,CAAA"}

package/dist/common/helper.js

@@ -1,4 +1,36 @@
 export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Safe JSON parse for fetch responses. Reads the body once and tolerates
+ * non-JSON payloads (e.g. NGINX HTML 5xx gateway pages) by returning a
+ * `{ message }` shell that downstream error code paths can still consume.
+ *
+ * Prevents the failure mode tracked in #1727: callers doing
+ * `throw PaymentsError.fromBackend('...', await response.json())` would
+ * otherwise let a SyntaxError from `.json()` escape and surface as an
+ * `unhandledRejection` that can take the host Node process down.
+ */
+export async function safeParseJson(response) {
+    const contentType = response.headers.get('content-type') ?? '';
+    // Always consume the body so the underlying socket can be released, even
+    // when we decide we can't parse it as JSON.
+    const text = await response.text().catch(() => '');
+    if (!text)
+        return {};
+    if (!contentType.toLowerCase().includes('json')) {
+        // Truncate to keep the payload bounded — a full HTML gateway page is
+        // noise in an error log.
+        const snippet = text.length > 200 ? `${text.slice(0, 200)}…` : text;
+        return { message: `Non-JSON response (${contentType || 'no content-type'}): ${snippet}` };
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (cause) {
+        return {
+            message: `Malformed JSON response: ${cause instanceof Error ? cause.message : String(cause)}`,
+        };
+    }
+}
 export const jsonReplacer = (_key, value) => {
     return typeof value === 'bigint' ? value.toString() : value;
 };

package/dist/common/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../src/common/helper.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAEtF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAS,EAAE,KAA8B,EAAE,EAAE;IACxE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;AAC7D,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,SAAqB,EAAU,EAAE;IAC3E,IAAI,WAAW,GAAG,EAAE,CAAA;IACpB,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5C,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAA;IACzC,CAAC,CAAC,CAAA;IACF,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA","sourcesContent":["import { Endpoint } from './types.js'\n\nexport const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms))\n\nexport const jsonReplacer = (_key: any, value: { toString: () => any }) => {\n  return typeof value === 'bigint' ? value.toString() : value\n}\n\nexport const getServiceHostFromEndpoints = (endpoints: Endpoint[]): string => {\n  let serviceHost = ''\n  endpoints.some((endpoint) => {\n    const _endpoint = Object.values(endpoint)[0]\n    serviceHost = new URL(_endpoint).origin\n  })\n  return serviceHost\n}\n"]}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../src/common/helper.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAA;AAEtF;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAkB;IACpD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;IAC9D,yEAAyE;IACzE,4CAA4C;IAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;IAClD,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IACpB,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAChD,qEAAqE;QACrE,yBAAyB;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;QACnE,OAAO,EAAE,OAAO,EAAE,sBAAsB,WAAW,IAAI,iBAAiB,MAAM,OAAO,EAAE,EAAE,CAAA;IAC3F,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SAC9F,CAAA;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAS,EAAE,KAA8B,EAAE,EAAE;IACxE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;AAC7D,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,SAAqB,EAAU,EAAE;IAC3E,IAAI,WAAW,GAAG,EAAE,CAAA;IACpB,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5C,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,MAAM,CAAA;IACzC,CAAC,CAAC,CAAA;IACF,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA","sourcesContent":["import { Endpoint } from './types.js'\n\nexport const sleep = (ms: number) => new Promise((resolve) => setTimeout(resolve, ms))\n\n/**\n * Safe JSON parse for fetch responses. Reads the body once and tolerates\n * non-JSON payloads (e.g. NGINX HTML 5xx gateway pages) by returning a\n * `{ message }` shell that downstream error code paths can still consume.\n *\n * Prevents the failure mode tracked in #1727: callers doing\n * `throw PaymentsError.fromBackend('...', await response.json())` would\n * otherwise let a SyntaxError from `.json()` escape and surface as an\n * `unhandledRejection` that can take the host Node process down.\n */\nexport async function safeParseJson(response: Response): Promise<unknown> {\n  const contentType = response.headers.get('content-type') ?? ''\n  // Always consume the body so the underlying socket can be released, even\n  // when we decide we can't parse it as JSON.\n  const text = await response.text().catch(() => '')\n  if (!text) return {}\n  if (!contentType.toLowerCase().includes('json')) {\n    // Truncate to keep the payload bounded — a full HTML gateway page is\n    // noise in an error log.\n    const snippet = text.length > 200 ? `${text.slice(0, 200)}…` : text\n    return { message: `Non-JSON response (${contentType || 'no content-type'}): ${snippet}` }\n  }\n  try {\n    return JSON.parse(text)\n  } catch (cause) {\n    return {\n      message: `Malformed JSON response: ${cause instanceof Error ? cause.message : String(cause)}`,\n    }\n  }\n}\n\nexport const jsonReplacer = (_key: any, value: { toString: () => any }) => {\n  return typeof value === 'bigint' ? value.toString() : value\n}\n\nexport const getServiceHostFromEndpoints = (endpoints: Endpoint[]): string => {\n  let serviceHost = ''\n  endpoints.some((endpoint) => {\n    const _endpoint = Object.values(endpoint)[0]\n    serviceHost = new URL(_endpoint).origin\n  })\n  return serviceHost\n}\n"]}

package/dist/common/types.d.ts

@@ -35,6 +35,21 @@ export interface PaymentOptions {
      * The version of the API to use.
      */
     version?: string;
+    /**
+     * Optional organization ID to use as the active workspace for every
+     * authenticated backend request. When set, the SDK sends an
+     * `X-Current-Org-Id` header so the backend scopes published agents,
+     * plans, and other resources to this organization.
+     *
+     * If omitted the backend falls back to the API key's org tag or to the
+     * caller's most-recent active membership (see `CurrentOrgContextGuard`
+     * in nvm-monorepo).
+     *
+     * Override per-call via the `organizationId` option on create methods.
+     *
+     * @see Payments.setOrganizationId
+     */
+    organizationId?: string;
 }
 export interface Endpoint {
     [verb: string]: string;

package/dist/common/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,CAAA;AAEjC,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,WAAW,EAAE,eAAe,CAAA;IAE5B;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAA;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,CAAC,CAAA;IACR,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,OAAO,GAAG,KAAK,MAAM,EAAE,CAAA;AAEnC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;OAEG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,uBAAuB,EAAE,OAAO,CAAA;IAChC;;OAEG;IACH,cAAc,EAAE,kBAAkB,CAAA;IAClC;;;;;OAKG;IACH,aAAa,EAAE,OAAO,CAAA;IACtB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;;;;;GAMG;AACH,oBAAY,aAAa;IACvB,WAAW,IAAA;IACX,gBAAgB,IAAA;IAChB,oBAAoB,IAAA;CACrB;AAED;;;;GAIG;AACH,oBAAY,QAAQ;IAClB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,EAAE,OAAsD,CAAA;AACvF,+DAA+D;AAC/D,eAAO,MAAM,0BAA0B,EAAE,OAAsD,CAAA;AAE/F;;;;;;GAMG;AACH,oBAAY,eAAe;IACzB,SAAS,IAAA;IACT,KAAK,IAAA;IACL,OAAO,IAAA;CACR;AAED;;;;;;;GAOG;AACH,oBAAY,kBAAkB;IAC5B,gBAAgB,IAAI,CAAE,qBAAqB;IAC3C,UAAU,IAAI,CAAE,iBAAiB;IACjC,cAAc,IAAI;IAClB,eAAe,IAAI;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,OAAO,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,OAAO,CAAA;IACxB,YAAY,EAAE,OAAO,CAAA;IACrB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,WAAW,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,WAAW,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,IAAI,CAAC,EAAE,IAAI,CAAA;CACZ;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,uBAAuB,EAAE,MAAM,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;IACzB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,CAAA;CAGnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAI3B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;IAChD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,SAAS,EAAE,KAAK,GAAG,MAAM,CAAS;IAClC;;;OAGG;IACH,IAAI,SAAI;IACR;;;OAGG;IACH,MAAM,SAAK;IAEX;;;OAGG;gBACS,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAShD;;;;OAIG;IACH,aAAa,IAAI,MAAM;CAWxB;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;IAEtB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,CAAA;CACzB;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,qBAAqB,CAAA;AAElE;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAG/D,CAAA;AAYD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE,eAAe,GAAG,MAAM,CAK/F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,cAAc,CAE7D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oFAAoF;IACpF,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,0EAA0E;IAC1E,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0FAA0F;IAC1F,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAA;IACrD,2IAA2I;IAC3I,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,sCAAsC;IACtC,kBAAkB,EAAE,MAAM,CAAA;IAC1B,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAA;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,sBAAsB;IACtB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":"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"}