@nevermined-io/payments 1.6.0 → 1.7.0

package/dist/x402/token.js

@@ -25,14 +25,16 @@ export class X402TokenAPI extends BasePaymentsAPI {
         return new X402TokenAPI(options);
     }
     /**
-     * Create a delegation and get an X402 access token for the given plan.
+     * Get an X402 access token for the given plan, backed by a delegation.
      *
      * This token allows the agent to verify and settle delegations on behalf
      * of the subscriber.
      *
-     * For erc4337 scheme, you must pass `tokenOptions.delegationConfig` with either:
-     * - `delegationId` to reuse an existing delegation, or
-     * - `spendingLimitCents` + `durationSecs` to auto-create a new one.
+     * The supported flow is **create-first**: create the delegation once with
+     * {@link DelegationAPI.createDelegation}, then pass its `delegationId` in
+     * `tokenOptions.delegationConfig`. Passing inline create-on-the-fly fields
+     * (spending limits / `providerPaymentMethodId` / `cardId`, i.e. no
+     * `delegationId`) is **deprecated** and emits a runtime warning.
      *
      * @param planId - The unique identifier of the payment plan
      * @param agentId - The unique identifier of the AI agent (optional)
@@ -44,14 +46,15 @@ export class X402TokenAPI extends BasePaymentsAPI {
      *
      * @example
      * ```typescript
-     * // Pattern A — auto-create delegation
-     * const result = await payments.x402.getX402AccessToken(planId, agentId, {
-     *   delegationConfig: { spendingLimitCents: 10000, durationSecs: 604800 }
+     * // Supported: create the delegation first, then request the token by id.
+     * const { delegationId } = await payments.delegation.createDelegation({
+     *   provider: 'erc4337',
+     *   spendingLimitCents: 10000,
+     *   durationSecs: 604800,
+     *   currency: 'usdc',
      * })
-     *
-     * // Pattern B — reuse existing delegation
      * const result = await payments.x402.getX402AccessToken(planId, agentId, {
-     *   delegationConfig: { delegationId: 'existing-delegation-uuid' }
+     *   delegationConfig: { delegationId },
      * })
      * ```
      */
@@ -63,8 +66,36 @@ export class X402TokenAPI extends BasePaymentsAPI {
         // Validate delegationConfig is provided — the backend requires it for token generation
         if (!tokenOptions?.delegationConfig) {
             throw PaymentsError.validation(`delegationConfig is required for ${scheme} token generation. ` +
-                'Provide delegationConfig.delegationId to reuse an existing delegation, ' +
-                'or delegationConfig.spendingLimitCents + durationSecs to auto-create one.');
+                'Create a delegation first with payments.delegation.createDelegation(), ' +
+                'then request the token with delegationConfig.delegationId.');
+        }
+        // Deprecation: the supported flow is create-first — create the delegation
+        // with createDelegation(), then request the token with { delegationId }.
+        // A delegationConfig that carries an inline-create signal instead of a
+        // delegationId triggers inline create-on-the-fly, which the backend has
+        // deprecated (auto-select and providerPaymentMethodId/cardId creation).
+        // Warn once per call; the { delegationId } (± apiKeyId) path is silent.
+        // Predicate mirrors the Python SDK (payments-py#224): no delegationId AND
+        // at least one creation field present — a bare/invalid config is left to
+        // fail downstream rather than warned.
+        const { delegationId, cardId, providerPaymentMethodId, spendingLimitCents, durationSecs } = tokenOptions.delegationConfig;
+        // Reject an explicit empty/blank delegationId early — it is neither a valid
+        // reuse id nor an inline-create signal, and forwarding `delegationId: ''`
+        // would 4xx at the backend. (Symmetric with the Python SDK, payments-py#225.)
+        if (delegationId !== undefined && delegationId.trim() === '') {
+            throw PaymentsError.validation('delegationConfig.delegationId must not be an empty string. ' +
+                'Pass a valid delegation UUID or omit the field.');
+        }
+        const isInlineCreate = !delegationId &&
+            (cardId !== undefined ||
+                providerPaymentMethodId !== undefined ||
+                spendingLimitCents !== undefined ||
+                durationSecs !== undefined);
+        if (isInlineCreate) {
+            console.warn('[DEPRECATED] getX402AccessToken: inline create-on-the-fly delegationConfig ' +
+                '(no delegationId) is deprecated and will be removed in a future release. ' +
+                'Create the delegation first with payments.delegation.createDelegation(), ' +
+                'then request the token with delegationConfig: { delegationId }.');
         }
         // Build x402-aligned request body
         const body = {
@@ -77,10 +108,9 @@ export class X402TokenAPI extends BasePaymentsAPI {
                 },
             },
         };
-        // Add delegation config for both erc4337 and card-delegation schemes
-        if (tokenOptions?.delegationConfig) {
-            body.delegationConfig = tokenOptions.delegationConfig;
-        }
+        // Add delegation config for both erc4337 and card-delegation schemes.
+        // delegationConfig is guaranteed present here (the absence check above throws).
+        body.delegationConfig = tokenOptions.delegationConfig;
         const options = this.getBackendHTTPOptions('POST', body);
         try {
             const response = await fetch(url, options);

package/dist/x402/token.js.map

@@ -1 +1 @@
-{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/x402/token.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAoC,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAExF;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC/C;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAuB;QACxC,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAA;IAClC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,KAAK,CAAC,kBAAkB,CACtB,MAAc,EACd,OAAgB,EAChB,YAA+B;QAE/B,MAAM,OAAO,GAAG,yBAAyB,CAAA;QACzC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAEtD,MAAM,MAAM,GAAG,YAAY,EAAE,MAAM,IAAI,aAAa,CAAA;QACpD,MAAM,OAAO,GAAG,YAAY,EAAE,OAAO,IAAI,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;QAExF,uFAAuF;QACvF,IAAI,CAAC,YAAY,EAAE,gBAAgB,EAAE,CAAC;YACpC,MAAM,aAAa,CAAC,UAAU,CAC5B,oCAAoC,MAAM,qBAAqB;gBAC7D,yEAAyE;gBACzE,2EAA2E,CAC9E,CAAA;QACH,CAAC;QAED,kCAAkC;QAClC,MAAM,IAAI,GAAwB;YAChC,QAAQ,EAAE;gBACR,MAAM;gBACN,OAAO;gBACP,MAAM;gBACN,KAAK,EAAE;oBACL,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;iBAC5B;aACF;SACF,CAAA;QAED,qEAAqE;QACrE,IAAI,YAAY,EAAE,gBAAgB,EAAE,CAAC;YACnC,IAAI,CAAC,gBAAgB,GAAG,YAAY,CAAC,gBAAgB,CAAA;QACvD,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAExD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,IAAI,YAAY,GAAG,wCAAwC,CAAA;gBAC3D,IAAI,CAAC;oBACH,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;oBACvC,YAAY,GAAG,SAAS,CAAC,OAAO,IAAI,YAAY,CAAA;gBAClD,CAAC;gBAAC,MAAM,CAAC;oBACP,4BAA4B;gBAC9B,CAAC;gBACD,MAAM,aAAa,CAAC,QAAQ,CAAC,GAAG,YAAY,UAAU,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;YAC3E,CAAC;YACD,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;gBACnC,MAAM,KAAK,CAAA;YACb,CAAC;YACD,MAAM,aAAa,CAAC,QAAQ,CAC1B,uDAAuD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAChH,CAAA;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["/**\n * X402 Token Generation API.\n *\n * Provides X402 access token generation functionality for subscribers.\n * Tokens are used to authorize payment verification and settlement.\n */\n\nimport { BasePaymentsAPI } from '../api/base-payments.js'\nimport { API_URL_CREATE_PERMISSION } from '../api/nvm-api.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport { PaymentOptions, X402TokenOptions, getDefaultNetwork } from '../common/types.js'\n\n/**\n * X402 Token API for generating access tokens.\n *\n * Handles X402 access token generation for subscribers to authorize\n * payment operations with AI agents.\n */\nexport class X402TokenAPI extends BasePaymentsAPI {\n  /**\n   * Get a singleton instance of the X402TokenAPI class.\n   *\n   * @param options - The options to initialize the API\n   * @returns The instance of the X402TokenAPI class\n   */\n  static getInstance(options: PaymentOptions): X402TokenAPI {\n    return new X402TokenAPI(options)\n  }\n\n  /**\n   * Create a delegation and get an X402 access token for the given plan.\n   *\n   * This token allows the agent to verify and settle delegations on behalf\n   * of the subscriber.\n   *\n   * For erc4337 scheme, you must pass `tokenOptions.delegationConfig` with either:\n   * - `delegationId` to reuse an existing delegation, or\n   * - `spendingLimitCents` + `durationSecs` to auto-create a new one.\n   *\n   * @param planId - The unique identifier of the payment plan\n   * @param agentId - The unique identifier of the AI agent (optional)\n   * @param tokenOptions - Options controlling scheme and delegation behavior (optional)\n   * @returns A promise that resolves to an object containing:\n   *   - accessToken: The X402 access token string\n   *\n   * @throws PaymentsError if the request fails\n   *\n   * @example\n   * ```typescript\n   * // Pattern A — auto-create delegation\n   * const result = await payments.x402.getX402AccessToken(planId, agentId, {\n   *   delegationConfig: { spendingLimitCents: 10000, durationSecs: 604800 }\n   * })\n   *\n   * // Pattern B — reuse existing delegation\n   * const result = await payments.x402.getX402AccessToken(planId, agentId, {\n   *   delegationConfig: { delegationId: 'existing-delegation-uuid' }\n   * })\n   * ```\n   */\n  async getX402AccessToken(\n    planId: string,\n    agentId?: string,\n    tokenOptions?: X402TokenOptions,\n  ): Promise<{ accessToken: string; [key: string]: any }> {\n    const urlPath = API_URL_CREATE_PERMISSION\n    const url = new URL(urlPath, this.environment.backend)\n\n    const scheme = tokenOptions?.scheme ?? 'nvm:erc4337'\n    const network = tokenOptions?.network ?? getDefaultNetwork(scheme, this.environmentName)\n\n    // Validate delegationConfig is provided — the backend requires it for token generation\n    if (!tokenOptions?.delegationConfig) {\n      throw PaymentsError.validation(\n        `delegationConfig is required for ${scheme} token generation. ` +\n          'Provide delegationConfig.delegationId to reuse an existing delegation, ' +\n          'or delegationConfig.spendingLimitCents + durationSecs to auto-create one.',\n      )\n    }\n\n    // Build x402-aligned request body\n    const body: Record<string, any> = {\n      accepted: {\n        scheme,\n        network,\n        planId,\n        extra: {\n          ...(agentId && { agentId }),\n        },\n      },\n    }\n\n    // Add delegation config for both erc4337 and card-delegation schemes\n    if (tokenOptions?.delegationConfig) {\n      body.delegationConfig = tokenOptions.delegationConfig\n    }\n\n    const options = this.getBackendHTTPOptions('POST', body)\n\n    try {\n      const response = await fetch(url, options)\n      if (!response.ok) {\n        let errorMessage = 'Failed to create X402 delegation token'\n        try {\n          const errorData = await response.json()\n          errorMessage = errorData.message || errorMessage\n        } catch {\n          // Use default error message\n        }\n        throw PaymentsError.internal(`${errorMessage} (HTTP ${response.status})`)\n      }\n      return await response.json()\n    } catch (error) {\n      if (error instanceof PaymentsError) {\n        throw error\n      }\n      throw PaymentsError.internal(\n        `Network error while creating X402 delegation token: ${error instanceof Error ? error.message : String(error)}`,\n      )\n    }\n  }\n}\n"]}
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../src/x402/token.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * X402 Token Generation API.\n *\n * Provides X402 access token generation functionality for subscribers.\n * Tokens are used to authorize payment verification and settlement.\n */\n\nimport { BasePaymentsAPI } from '../api/base-payments.js'\nimport { API_URL_CREATE_PERMISSION } from '../api/nvm-api.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport { PaymentOptions, X402TokenOptions, getDefaultNetwork } from '../common/types.js'\n\n/**\n * X402 Token API for generating access tokens.\n *\n * Handles X402 access token generation for subscribers to authorize\n * payment operations with AI agents.\n */\nexport class X402TokenAPI extends BasePaymentsAPI {\n  /**\n   * Get a singleton instance of the X402TokenAPI class.\n   *\n   * @param options - The options to initialize the API\n   * @returns The instance of the X402TokenAPI class\n   */\n  static getInstance(options: PaymentOptions): X402TokenAPI {\n    return new X402TokenAPI(options)\n  }\n\n  /**\n   * Get an X402 access token for the given plan, backed by a delegation.\n   *\n   * This token allows the agent to verify and settle delegations on behalf\n   * of the subscriber.\n   *\n   * The supported flow is **create-first**: create the delegation once with\n   * {@link DelegationAPI.createDelegation}, then pass its `delegationId` in\n   * `tokenOptions.delegationConfig`. Passing inline create-on-the-fly fields\n   * (spending limits / `providerPaymentMethodId` / `cardId`, i.e. no\n   * `delegationId`) is **deprecated** and emits a runtime warning.\n   *\n   * @param planId - The unique identifier of the payment plan\n   * @param agentId - The unique identifier of the AI agent (optional)\n   * @param tokenOptions - Options controlling scheme and delegation behavior (optional)\n   * @returns A promise that resolves to an object containing:\n   *   - accessToken: The X402 access token string\n   *\n   * @throws PaymentsError if the request fails\n   *\n   * @example\n   * ```typescript\n   * // Supported: create the delegation first, then request the token by id.\n   * const { delegationId } = await payments.delegation.createDelegation({\n   *   provider: 'erc4337',\n   *   spendingLimitCents: 10000,\n   *   durationSecs: 604800,\n   *   currency: 'usdc',\n   * })\n   * const result = await payments.x402.getX402AccessToken(planId, agentId, {\n   *   delegationConfig: { delegationId },\n   * })\n   * ```\n   */\n  async getX402AccessToken(\n    planId: string,\n    agentId?: string,\n    tokenOptions?: X402TokenOptions,\n  ): Promise<{ accessToken: string; [key: string]: any }> {\n    const urlPath = API_URL_CREATE_PERMISSION\n    const url = new URL(urlPath, this.environment.backend)\n\n    const scheme = tokenOptions?.scheme ?? 'nvm:erc4337'\n    const network = tokenOptions?.network ?? getDefaultNetwork(scheme, this.environmentName)\n\n    // Validate delegationConfig is provided — the backend requires it for token generation\n    if (!tokenOptions?.delegationConfig) {\n      throw PaymentsError.validation(\n        `delegationConfig is required for ${scheme} token generation. ` +\n          'Create a delegation first with payments.delegation.createDelegation(), ' +\n          'then request the token with delegationConfig.delegationId.',\n      )\n    }\n\n    // Deprecation: the supported flow is create-first — create the delegation\n    // with createDelegation(), then request the token with { delegationId }.\n    // A delegationConfig that carries an inline-create signal instead of a\n    // delegationId triggers inline create-on-the-fly, which the backend has\n    // deprecated (auto-select and providerPaymentMethodId/cardId creation).\n    // Warn once per call; the { delegationId } (± apiKeyId) path is silent.\n    // Predicate mirrors the Python SDK (payments-py#224): no delegationId AND\n    // at least one creation field present — a bare/invalid config is left to\n    // fail downstream rather than warned.\n    const { delegationId, cardId, providerPaymentMethodId, spendingLimitCents, durationSecs } =\n      tokenOptions.delegationConfig\n    // Reject an explicit empty/blank delegationId early — it is neither a valid\n    // reuse id nor an inline-create signal, and forwarding `delegationId: ''`\n    // would 4xx at the backend. (Symmetric with the Python SDK, payments-py#225.)\n    if (delegationId !== undefined && delegationId.trim() === '') {\n      throw PaymentsError.validation(\n        'delegationConfig.delegationId must not be an empty string. ' +\n          'Pass a valid delegation UUID or omit the field.',\n      )\n    }\n    const isInlineCreate =\n      !delegationId &&\n      (cardId !== undefined ||\n        providerPaymentMethodId !== undefined ||\n        spendingLimitCents !== undefined ||\n        durationSecs !== undefined)\n    if (isInlineCreate) {\n      console.warn(\n        '[DEPRECATED] getX402AccessToken: inline create-on-the-fly delegationConfig ' +\n          '(no delegationId) is deprecated and will be removed in a future release. ' +\n          'Create the delegation first with payments.delegation.createDelegation(), ' +\n          'then request the token with delegationConfig: { delegationId }.',\n      )\n    }\n\n    // Build x402-aligned request body\n    const body: Record<string, any> = {\n      accepted: {\n        scheme,\n        network,\n        planId,\n        extra: {\n          ...(agentId && { agentId }),\n        },\n      },\n    }\n\n    // Add delegation config for both erc4337 and card-delegation schemes.\n    // delegationConfig is guaranteed present here (the absence check above throws).\n    body.delegationConfig = tokenOptions.delegationConfig\n\n    const options = this.getBackendHTTPOptions('POST', body)\n\n    try {\n      const response = await fetch(url, options)\n      if (!response.ok) {\n        let errorMessage = 'Failed to create X402 delegation token'\n        try {\n          const errorData = await response.json()\n          errorMessage = errorData.message || errorMessage\n        } catch {\n          // Use default error message\n        }\n        throw PaymentsError.internal(`${errorMessage} (HTTP ${response.status})`)\n      }\n      return await response.json()\n    } catch (error) {\n      if (error instanceof PaymentsError) {\n        throw error\n      }\n      throw PaymentsError.internal(\n        `Network error while creating X402 delegation token: ${error instanceof Error ? error.message : String(error)}`,\n      )\n    }\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nevermined-io/payments",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Typescript SDK to interact with the Nevermined Payments Protocol",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",