@nevermined-io/payments 1.1.18 → 1.4.0

package/dist/x402/visa-token-api.d.ts

@@ -1,60 +0,0 @@
-/**
- * Visa Token API — generates x402 payment payloads via the Visa backend.
- *
- * Instead of generating a cryptographic NVM access token (which requires session keys
- * and smart accounts), this API calls the Visa backend's /access-token endpoint
- * with a vProvisionedTokenID + instructionId + amount to get a base64-encoded
- * PaymentPayload suitable for the PAYMENT-SIGNATURE header.
- */
-import { X402TokenAPI } from './token.js';
-import { PaymentOptions } from '../common/types.js';
-/**
- * Response from the Visa backend's /access-token endpoint
- */
-export interface VisaPaymentPayloadResponse {
-    success: boolean;
-    payload?: unknown;
-    payloadEncoded?: string;
-    error?: string;
-}
-/**
- * Visa Token API — generates payment payloads for Visa x402 flow.
- */
-export declare class VisaTokenAPI extends X402TokenAPI {
-    protected visaBackendUrl: string;
-    constructor(options: PaymentOptions);
-    static getInstance(options: PaymentOptions): VisaTokenAPI;
-    /**
-     * Generate a Visa x402 payment payload.
-     *
-     * When called with only `amount`, the Visa backend resolves the user's Visa
-     * credentials from the NVM API key sent in the Authorization header.
-     *
-     * When called with explicit Visa credentials (`vProvisionedTokenID` and
-     * `instructionId`), those are sent directly to the Visa backend.
-     *
-     * @param amount - The payment amount (e.g. "1.00")
-     * @param vProvisionedTokenID - The Visa Token Service provisioned token ID (optional)
-     * @param instructionId - The VIC mandate instruction ID (optional)
-     * @returns A promise resolving to an object with `accessToken` (the base64-encoded PaymentPayload)
-     *
-     * @example
-     * ```typescript
-     * // Using NVM API key (credentials resolved by backend)
-     * const result = await payments.x402.getVisaAccessToken('1.00')
-     *
-     * // Using explicit Visa credentials
-     * const result = await payments.x402.getVisaAccessToken(
-     *   '2.00',
-     *   'token-id-from-visa',
-     *   'instruction-id-from-mandate',
-     * )
-     * // Use result.accessToken as the PAYMENT-SIGNATURE header value
-     * ```
-     */
-    getVisaAccessToken(amount: string, vProvisionedTokenID?: string, instructionId?: string): Promise<{
-        accessToken: string;
-        [key: string]: any;
-    }>;
-}
-//# sourceMappingURL=visa-token-api.d.ts.map

package/dist/x402/visa-token-api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"visa-token-api.d.ts","sourceRoot":"","sources":["../../src/x402/visa-token-api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGnD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,SAAS,CAAC,cAAc,EAAE,MAAM,CAAA;gBAEpB,OAAO,EAAE,cAAc;WAKnB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY;IAIlE;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,mBAAmB,CAAC,EAAE,MAAM,EAC5B,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;CAuDxD"}

package/dist/x402/visa-token-api.js

@@ -1,99 +0,0 @@
-/**
- * Visa Token API — generates x402 payment payloads via the Visa backend.
- *
- * Instead of generating a cryptographic NVM access token (which requires session keys
- * and smart accounts), this API calls the Visa backend's /access-token endpoint
- * with a vProvisionedTokenID + instructionId + amount to get a base64-encoded
- * PaymentPayload suitable for the PAYMENT-SIGNATURE header.
- */
-import { X402TokenAPI } from './token.js';
-import { PaymentsError } from '../common/payments.error.js';
-import { VisaBackendUrls } from '../environments.js';
-/**
- * Visa Token API — generates payment payloads for Visa x402 flow.
- */
-export class VisaTokenAPI extends X402TokenAPI {
-    constructor(options) {
-        super(options);
-        this.visaBackendUrl = VisaBackendUrls[this.environmentName];
-    }
-    static getInstance(options) {
-        return new VisaTokenAPI(options);
-    }
-    /**
-     * Generate a Visa x402 payment payload.
-     *
-     * When called with only `amount`, the Visa backend resolves the user's Visa
-     * credentials from the NVM API key sent in the Authorization header.
-     *
-     * When called with explicit Visa credentials (`vProvisionedTokenID` and
-     * `instructionId`), those are sent directly to the Visa backend.
-     *
-     * @param amount - The payment amount (e.g. "1.00")
-     * @param vProvisionedTokenID - The Visa Token Service provisioned token ID (optional)
-     * @param instructionId - The VIC mandate instruction ID (optional)
-     * @returns A promise resolving to an object with `accessToken` (the base64-encoded PaymentPayload)
-     *
-     * @example
-     * ```typescript
-     * // Using NVM API key (credentials resolved by backend)
-     * const result = await payments.x402.getVisaAccessToken('1.00')
-     *
-     * // Using explicit Visa credentials
-     * const result = await payments.x402.getVisaAccessToken(
-     *   '2.00',
-     *   'token-id-from-visa',
-     *   'instruction-id-from-mandate',
-     * )
-     * // Use result.accessToken as the PAYMENT-SIGNATURE header value
-     * ```
-     */
-    async getVisaAccessToken(amount, vProvisionedTokenID, instructionId) {
-        const hasExplicitCredentials = vProvisionedTokenID && instructionId;
-        const url = hasExplicitCredentials
-            ? new URL('access-token', this.visaBackendUrl)
-            : new URL('access-token/from-nvm-key', this.visaBackendUrl);
-        const body = hasExplicitCredentials
-            ? { vProvisionedTokenID, instructionId, amount }
-            : { amount };
-        const fetchOptions = hasExplicitCredentials
-            ? {
-                method: 'POST',
-                headers: {
-                    Accept: 'application/json',
-                    'Content-Type': 'application/json',
-                },
-                body: JSON.stringify(body),
-            }
-            : this.getBackendHTTPOptions('POST', body);
-        try {
-            const response = await fetch(url, fetchOptions);
-            if (!response.ok) {
-                let errorMessage = 'Failed to generate Visa payment payload';
-                try {
-                    const errorData = await response.json();
-                    errorMessage = errorData.error || errorData.message || errorMessage;
-                }
-                catch {
-                    // Use default error message
-                }
-                throw PaymentsError.internal(`${errorMessage} (HTTP ${response.status})`);
-            }
-            const result = await response.json();
-            if (!result.success || !result.payloadEncoded) {
-                throw PaymentsError.internal(result.error || 'Failed to generate Visa payment payload');
-            }
-            return {
-                accessToken: result.payloadEncoded,
-                payload: result.payload,
-            };
-        }
-        catch (error) {
-            if (error instanceof PaymentsError) {
-                throw error;
-            }
-            throw PaymentsError.internal(`Network error while generating Visa payment payload: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-}
-//# sourceMappingURL=visa-token-api.js.map

package/dist/x402/visa-token-api.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"visa-token-api.js","sourceRoot":"","sources":["../../src/x402/visa-token-api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Visa Token API — generates x402 payment payloads via the Visa backend.\n *\n * Instead of generating a cryptographic NVM access token (which requires session keys\n * and smart accounts), this API calls the Visa backend's /access-token endpoint\n * with a vProvisionedTokenID + instructionId + amount to get a base64-encoded\n * PaymentPayload suitable for the PAYMENT-SIGNATURE header.\n */\n\nimport { X402TokenAPI } from './token.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport { PaymentOptions } from '../common/types.js'\nimport { VisaBackendUrls } from '../environments.js'\n\n/**\n * Response from the Visa backend's /access-token endpoint\n */\nexport interface VisaPaymentPayloadResponse {\n  success: boolean\n  payload?: unknown\n  payloadEncoded?: string\n  error?: string\n}\n\n/**\n * Visa Token API — generates payment payloads for Visa x402 flow.\n */\nexport class VisaTokenAPI extends X402TokenAPI {\n  protected visaBackendUrl: string\n\n  constructor(options: PaymentOptions) {\n    super(options)\n    this.visaBackendUrl = VisaBackendUrls[this.environmentName]\n  }\n\n  static override getInstance(options: PaymentOptions): VisaTokenAPI {\n    return new VisaTokenAPI(options)\n  }\n\n  /**\n   * Generate a Visa x402 payment payload.\n   *\n   * When called with only `amount`, the Visa backend resolves the user's Visa\n   * credentials from the NVM API key sent in the Authorization header.\n   *\n   * When called with explicit Visa credentials (`vProvisionedTokenID` and\n   * `instructionId`), those are sent directly to the Visa backend.\n   *\n   * @param amount - The payment amount (e.g. \"1.00\")\n   * @param vProvisionedTokenID - The Visa Token Service provisioned token ID (optional)\n   * @param instructionId - The VIC mandate instruction ID (optional)\n   * @returns A promise resolving to an object with `accessToken` (the base64-encoded PaymentPayload)\n   *\n   * @example\n   * ```typescript\n   * // Using NVM API key (credentials resolved by backend)\n   * const result = await payments.x402.getVisaAccessToken('1.00')\n   *\n   * // Using explicit Visa credentials\n   * const result = await payments.x402.getVisaAccessToken(\n   *   '2.00',\n   *   'token-id-from-visa',\n   *   'instruction-id-from-mandate',\n   * )\n   * // Use result.accessToken as the PAYMENT-SIGNATURE header value\n   * ```\n   */\n  async getVisaAccessToken(\n    amount: string,\n    vProvisionedTokenID?: string,\n    instructionId?: string,\n  ): Promise<{ accessToken: string; [key: string]: any }> {\n    const hasExplicitCredentials = vProvisionedTokenID && instructionId\n\n    const url = hasExplicitCredentials\n      ? new URL('access-token', this.visaBackendUrl)\n      : new URL('access-token/from-nvm-key', this.visaBackendUrl)\n\n    const body = hasExplicitCredentials\n      ? { vProvisionedTokenID, instructionId, amount }\n      : { amount }\n\n    const fetchOptions = hasExplicitCredentials\n      ? {\n          method: 'POST',\n          headers: {\n            Accept: 'application/json',\n            'Content-Type': 'application/json',\n          },\n          body: JSON.stringify(body),\n        }\n      : this.getBackendHTTPOptions('POST', body)\n\n    try {\n      const response = await fetch(url, fetchOptions)\n\n      if (!response.ok) {\n        let errorMessage = 'Failed to generate Visa payment payload'\n        try {\n          const errorData = await response.json()\n          errorMessage = errorData.error || errorData.message || errorMessage\n        } catch {\n          // Use default error message\n        }\n        throw PaymentsError.internal(`${errorMessage} (HTTP ${response.status})`)\n      }\n\n      const result: VisaPaymentPayloadResponse = await response.json()\n\n      if (!result.success || !result.payloadEncoded) {\n        throw PaymentsError.internal(result.error || 'Failed to generate Visa payment payload')\n      }\n\n      return {\n        accessToken: result.payloadEncoded,\n        payload: result.payload,\n      }\n    } catch (error) {\n      if (error instanceof PaymentsError) {\n        throw error\n      }\n      throw PaymentsError.internal(\n        `Network error while generating Visa payment payload: ${error instanceof Error ? error.message : String(error)}`,\n      )\n    }\n  }\n}\n"]}