@nevermined-io/payments 1.7.0 → 1.9.0

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

@@ -1 +1 @@
-{"version":3,"file":"agents-api.js","sourceRoot":"","sources":["../../src/api/agents-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAIL,iBAAiB,GAKlB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,eAAe,EAAsB,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AACnG,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,gCAAgC,EAChC,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,cAAc,CAAA;AAIrB;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,eAAe;IAC5C;;;;;OAKG;IACH,MAAM,CAAC,WAAW,CAAC,OAAuB;QACxC,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACI,KAAK,CAAC,aAAa,CACxB,aAA4B,EAC5B,QAA4B,EAC5B,YAAsB,EACtB,kBAAuC;QAEvC,MAAM,IAAI,GAAG;YACX,kBAAkB,EAAE,aAAa;YACjC,kBAAkB,EAAE,QAAQ;YAC5B,KAAK,EAAE,YAAY;SACpB,CAAA;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CACxC,MAAM,EACN,IAAI,EACJ,yBAAyB,CAAC,kBAAkB,CAAC,CAC9C,CAAA;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,sBAAsB,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAErE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,WAAW,CAAC,0BAA0B,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC5F,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QACvC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAA;IAC5C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACI,KAAK,CAAC,oBAAoB,CAC/B,aAA4B,EAC5B,QAA4B,EAC5B,YAA0B,EAC1B,WAA4B,EAC5B,aAAgC,EAChC,WAAgC,EAChC,kBAAuC;QAMvC,IAAI,WAAW,IAAI,CAAC,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9D,MAAM,IAAI,aAAa,CACrB,sBAAsB,EACtB,gDAAgD,CACjD,CAAA;QACH,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,WAAW,GAAG,aAAa,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;QACpE,CAAC;QACD,MAAM,IAAI,GAAG;YACX,IAAI,EAAE;gBACJ,kBAAkB,EAAE,YAAY;gBAChC,WAAW,EAAE,WAAW;gBACxB,aAAa,EAAE,aAAa;gBAC5B,WAAW;aACZ;YACD,KAAK,EAAE;gBACL,kBAAkB,EAAE,aAAa;gBACjC,kBAAkB,EAAE,QAAQ;aAC7B;SACF,CAAA;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CACxC,MAAM,EACN,IAAI,EACJ,yBAAyB,CAAC,kBAAkB,CAAC,CAC9C,CAAA;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,gCAAgC,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAE/E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,WAAW,CAC7B,iCAAiC,EACjC,MAAM,aAAa,CAAC,QAAQ,CAAC,CAC9B,CAAA;QACH,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QACpC,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO;YAC5B,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;YAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAA;IACH,CAAC;IAED;;;;;;;;;;;OAWG;IACI,KAAK,CAAC,QAAQ,CAAC,OAAe;QACnC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAC7F,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAA;QACnE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAA;QACnF,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,KAAK,CAAC,mBAAmB,CAC9B,OAAe,EACf,aAA4B,EAC5B,QAA4B;QAE5B,MAAM,IAAI,GAAG;YACX,kBAAkB,EAAE,aAAa;YACjC,kBAAkB,EAAE,QAAQ;SAC7B,CAAA;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAChG,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QACvD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,WAAW,CAAC,sBAAsB,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAA;QACxF,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACI,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,UAAU,GAAG,IAAI,iBAAiB,EAAE;QAC9E,MAAM,KAAK,GACT,uBAAuB,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,GAAG,GAAG,GAAG,UAAU,CAAC,aAAa,EAAE,CAAA;QACzF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QACpD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAA;QACnE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,WAAW,CAAC,iBAAiB,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAA;QACnF,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,OAAe;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAA;QAClD,MAAM,QAAQ,GAAG,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QAC/F,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QACvD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,WAAW,CAAC,6BAA6B,EAAE,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC/F,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,KAAK,CAAC,mBAAmB,CAAC,MAAc,EAAE,OAAe;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAA;QACpD,MAAM,QAAQ,GAAG,yBAAyB,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,CAC3E,UAAU,EACV,OAAO,CACR,CAAA;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QACvD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC1C,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,aAAa,CAAC,WAAW,CAC7B,kCAAkC,EAClC,MAAM,aAAa,CAAC,QAAQ,CAAC,CAC9B,CAAA;QACH,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;CACF","sourcesContent":["import { safeParseJson } from '../common/helper.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport {\n  AgentAPIAttributes,\n  AgentMetadata,\n  NvmAPIResult,\n  PaginationOptions,\n  PaymentOptions,\n  PlanCreditsConfig,\n  PlanMetadata,\n  PlanPriceConfig,\n} from '../common/types.js'\nimport { BasePaymentsAPI, PublicationOptions, resolvePublicationHeaders } from './base-payments.js'\nimport {\n  API_URL_ADD_PLAN_AGENT,\n  API_URL_GET_AGENT,\n  API_URL_GET_AGENT_PLANS,\n  API_URL_REGISTER_AGENT,\n  API_URL_REGISTER_AGENTS_AND_PLAN,\n  API_URL_REMOVE_PLAN_AGENT,\n  API_URL_UPDATE_AGENT,\n} from './nvm-api.js'\n\nexport type { PublicationOptions } from './base-payments.js'\n\n/**\n * The AgentsAPI class provides methods to register and interact with AI Agents on Nevermined.\n */\nexport class AgentsAPI extends BasePaymentsAPI {\n  /**\n   * This method is used to create a singleton instance of the AgentsAPI class.\n   *\n   * @param options - The options to initialize the payments class.\n   * @returns The instance of the AgentsAPI class.\n   */\n  static getInstance(options: PaymentOptions): AgentsAPI {\n    return new AgentsAPI(options)\n  }\n\n  /**\n   *\n   * It registers a new AI Agent on Nevermined.\n   * The agent must be associated to one or multiple Payment Plans. Users that are subscribers of a payment plan can query the agent.\n   * Depending on the Payment Plan and the configuration of the agent, the usage of the agent/service will consume credits.\n   * When the plan expires (because the time is over or the credits are consumed), the user needs to renew the plan to continue using the agent.\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/register-agent\n   *\n   * @param agentMetadata - @see {@link AgentMetadata}\n   * @param agentApi - @see {@link AgentAPIAttributes}\n   * @param paymentPlans - the list of payment plans giving access to the agent.\n   *\n   * @example\n   * ```\n   *  const agentMetadata = { name: 'My AI Payments Agent', tags: ['test'] }\n   *  const agentApi = { endpoints: [{ 'POST': 'https://example.com/api/v1/agents/:agentId/tasks' }] }\n   *  const paymentPlans = [planId]\n   *\n   *  const { agentId } = await payments.agents.registerAgent(agentMetadata, agentApi, paymentPlans)\n   * ```\n   *\n   * @returns The unique identifier of the newly created agent (Agent Id).\n   */\n  public async registerAgent(\n    agentMetadata: AgentMetadata,\n    agentApi: AgentAPIAttributes,\n    paymentPlans: string[],\n    publicationOptions?: PublicationOptions,\n  ): Promise<{ agentId: string }> {\n    const body = {\n      metadataAttributes: agentMetadata,\n      agentApiAttributes: agentApi,\n      plans: paymentPlans,\n    }\n\n    const options = this.getBackendHTTPOptions(\n      'POST',\n      body,\n      resolvePublicationHeaders(publicationOptions),\n    )\n    const url = new URL(API_URL_REGISTER_AGENT, this.environment.backend)\n\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to register agent', await safeParseJson(response))\n    }\n    const agentData = await response.json()\n    return { agentId: agentData.data.agentId }\n  }\n\n  /**\n   *\n   * It registers a new AI Agent and a Payment Plan associated to this new agent.\n   * Depending on the Payment Plan and the configuration of the agent, the usage of the agent/service will consume credits.\n   * When the plan expires (because the time is over or the credits are consumed), the user needs to renew the plan to continue using the agent.\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/register-agent\n   *\n   * @param agentMetadata - @see {@link AgentMetadata}\n   * @param agentApi - @see {@link AgentAPIAttributes}\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   *\n   * @example\n   * ```\n   *  const agentMetadata = { name: 'My AI Payments Agent', tags: ['test'] }\n   *  const agentApi { endpoints: [{ 'POST': 'https://example.com/api/v1/agents/:agentId/tasks' }] }\n   *  const cryptoPriceConfig = getNativeTokenPriceConfig(100n, builderAddress)\n   *  const 1dayDurationPlan = getExpirableDurationConfig(ONE_DAY_DURATION)\n   *  const { agentId, planId } = await payments.agents.registerAgentAndPlan(\n   *    agentMetadata,\n   *    agentApi,\n   *    cryptoPriceConfig,\n   *    1dayDurationPlan\n   *  )\n   * ```\n   *\n   * @returns The unique identifier of the newly created agent (agentId).\n   * @returns The unique identifier of the newly created plan (planId).\n   */\n  public async registerAgentAndPlan(\n    agentMetadata: AgentMetadata,\n    agentApi: AgentAPIAttributes,\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n    accessLimit?: 'credits' | 'time',\n    publicationOptions?: PublicationOptions,\n  ): Promise<{\n    agentId: string\n    planId: string\n    txHash: string\n  }> {\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 = creditsConfig.durationSecs > 0n ? 'time' : 'credits'\n    }\n    const body = {\n      plan: {\n        metadataAttributes: planMetadata,\n        priceConfig: priceConfig,\n        creditsConfig: creditsConfig,\n        accessLimit,\n      },\n      agent: {\n        metadataAttributes: agentMetadata,\n        agentApiAttributes: agentApi,\n      },\n    }\n    const options = this.getBackendHTTPOptions(\n      'POST',\n      body,\n      resolvePublicationHeaders(publicationOptions),\n    )\n    const url = new URL(API_URL_REGISTER_AGENTS_AND_PLAN, this.environment.backend)\n\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend(\n        'Unable to register agent & plan',\n        await safeParseJson(response),\n      )\n    }\n    const result = await response.json()\n    return {\n      agentId: result.data.agentId,\n      planId: result.data.planId,\n      txHash: result.txHash,\n    }\n  }\n\n  /**\n   * Gets the metadata for a given Agent identifier.\n   *\n   * @param agentId - The unique identifier of the agent.\n   * @returns A promise that resolves to the agent's metadata.\n   * @throws PaymentsError if the agent is not found.\n   *\n   * @example\n   * ```\n   *  const plan = payments.agents.getAgent(agentId)\n   * ```\n   */\n  public async getAgent(agentId: string) {\n    const url = new URL(API_URL_GET_AGENT.replace(':agentId', agentId), this.environment.backend)\n    const response = await fetch(url, this.getPublicHTTPOptions('GET'))\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Agent not found', await safeParseJson(response))\n    }\n    return response.json()\n  }\n\n  /**\n   * Updates the metadata and API attributes of an existing AI Agent.\n   *\n   * @param agentId - The unique identifier of the agent.\n   * @param agentMetadata - The new metadata attributes for the agent.\n   * @param agentApi - The new API attributes for the agent.\n   * @returns  @see {@link NvmAPIResult} A promise that resolves indicating if the operation was successful.\n   * @throws PaymentsError if the agent is not found or if the update fails.\n   *\n   * @example\n   * ```\n   *  const agentMetadata = { name: 'My Updated Agent', tags: ['test'] }\n   *  const agentApi = { endpoints: [{ 'POST': 'https://nevermined.app/api/v1/agents/:agentId/tasks' }] }\n   *\n   *  await payments.agents.updateAgentMetadata(agentId, agentMetadata, agentApi)\n   * ```\n   */\n  public async updateAgentMetadata(\n    agentId: string,\n    agentMetadata: AgentMetadata,\n    agentApi: AgentAPIAttributes,\n  ): Promise<NvmAPIResult> {\n    const body = {\n      metadataAttributes: agentMetadata,\n      agentApiAttributes: agentApi,\n    }\n    const url = new URL(API_URL_UPDATE_AGENT.replace(':agentId', agentId), this.environment.backend)\n    const options = this.getBackendHTTPOptions('PUT', body)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Error updating agent', await safeParseJson(response))\n    }\n    return response.json()\n  }\n\n  /**\n   * Gets the list of plans that can be ordered to get access to an agent.\n   *\n   * @param agentId - The unique identifier of the agent.\n   * @param pagination - Optional pagination options to control the number of results returned.p\n   * @returns A promise that resolves to the list of all different plans giving access to the agent.\n   * @throws PaymentsError if the agent is not found.\n   *\n   * @example\n   * ```\n   *  const result = payments.agents.getAgentPlans(planId)\n   *  // {\n   *  //  total: 10,\n   *  //  page: 1,\n   *  //  offset: 5,\n   *  //  plans: [ ..]\n   *  // }\n   * ```\n   */\n  public async getAgentPlans(agentId: string, pagination = new PaginationOptions()) {\n    const query =\n      API_URL_GET_AGENT_PLANS.replace(':agentId', agentId) + '?' + pagination.asQueryParams()\n    const url = new URL(query, this.environment.backend)\n    const response = await fetch(url, this.getPublicHTTPOptions('GET'))\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Agent not found', await safeParseJson(response))\n    }\n    return response.json()\n  }\n\n  /**\n   * Adds an existing Payment Plan to an AI Agent.\n   * After this operation, users with access to the Payment Plan will be able to access the AI Agent.\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 agentId - The unique identifier of the AI Agent.\n   * @returns  @see {@link NvmAPIResult} A promise that resolves indicating if the operation was successful.\n   * @throws PaymentsError if unable to add the plan to the agent.\n   *\n   * @example\n   * ```\n   * const result = await payments.agents.addPlanToAgent(planId, agentId)\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async addPlanToAgent(planId: string, agentId: string): Promise<NvmAPIResult> {\n    const options = this.getBackendHTTPOptions('POST')\n    const endpoint = API_URL_ADD_PLAN_AGENT.replace(':planId', planId).replace(':agentId', agentId)\n    const url = new URL(endpoint, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to add plan to agent', await safeParseJson(response))\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Removes a Payment Plan from an AI Agent.\n   * After this operation, users with access to the Payment Plan will no longer be able to access the AI Agent.\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 agentId - The unique identifier of the AI Agent.\n   * @returns  @see {@link NvmAPIResult} A promise that resolves indicating if the operation was successful.\n   * @throws PaymentsError if unable to remove the plan from the agent.\n   *\n   * @example\n   * ```\n   * const result = await payments.agents.removePlanFromAgent(planId, agentId)\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async removePlanFromAgent(planId: string, agentId: string): Promise<NvmAPIResult> {\n    const options = this.getBackendHTTPOptions('DELETE')\n    const endpoint = API_URL_REMOVE_PLAN_AGENT.replace(':planId', planId).replace(\n      ':agentId',\n      agentId,\n    )\n    const url = new URL(endpoint, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend(\n        'Unable to remove plan from agent',\n        await safeParseJson(response),\n      )\n    }\n\n    return response.json()\n  }\n}\n"]}
+{"version":3,"file":"agents-api.js","sourceRoot":"","sources":["../../src/api/agents-api.ts"],"names":[],"mappings":"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","sourcesContent":["import { safeParseJson } from '../common/helper.js'\nimport { PaymentsError } from '../common/payments.error.js'\nimport {\n  AgentAPIAttributes,\n  AgentMetadata,\n  NvmAPIResult,\n  PaginationOptions,\n  PaymentOptions,\n  PlanCreditsConfig,\n  PlanMetadata,\n  PlanPriceConfig,\n} from '../common/types.js'\nimport { BasePaymentsAPI, PublicationOptions, resolvePublicationHeaders } from './base-payments.js'\nimport {\n  API_URL_ADD_PLAN_AGENT,\n  API_URL_GET_AGENT,\n  API_URL_GET_AGENTS,\n  API_URL_GET_AGENT_PLANS,\n  API_URL_REGISTER_AGENT,\n  API_URL_REGISTER_AGENTS_AND_PLAN,\n  API_URL_REMOVE_PLAN_AGENT,\n  API_URL_UPDATE_AGENT,\n} from './nvm-api.js'\n\nexport type { PublicationOptions } from './base-payments.js'\n\n/**\n * The AgentsAPI class provides methods to register and interact with AI Agents on Nevermined.\n */\nexport class AgentsAPI extends BasePaymentsAPI {\n  /**\n   * This method is used to create a singleton instance of the AgentsAPI class.\n   *\n   * @param options - The options to initialize the payments class.\n   * @returns The instance of the AgentsAPI class.\n   */\n  static getInstance(options: PaymentOptions): AgentsAPI {\n    return new AgentsAPI(options)\n  }\n\n  /**\n   *\n   * It registers a new AI Agent on Nevermined.\n   * The agent must be associated to one or multiple Payment Plans. Users that are subscribers of a payment plan can query the agent.\n   * Depending on the Payment Plan and the configuration of the agent, the usage of the agent/service will consume credits.\n   * When the plan expires (because the time is over or the credits are consumed), the user needs to renew the plan to continue using the agent.\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/register-agent\n   *\n   * @param agentMetadata - @see {@link AgentMetadata}\n   * @param agentApi - @see {@link AgentAPIAttributes}\n   * @param paymentPlans - the list of payment plans giving access to the agent.\n   *\n   * @example\n   * ```\n   *  const agentMetadata = { name: 'My AI Payments Agent', tags: ['test'] }\n   *  const agentApi = { endpoints: [{ 'POST': 'https://example.com/api/v1/agents/:agentId/tasks' }] }\n   *  const paymentPlans = [planId]\n   *\n   *  const { agentId } = await payments.agents.registerAgent(agentMetadata, agentApi, paymentPlans)\n   * ```\n   *\n   * @returns The unique identifier of the newly created agent (Agent Id).\n   */\n  public async registerAgent(\n    agentMetadata: AgentMetadata,\n    agentApi: AgentAPIAttributes,\n    paymentPlans: string[],\n    publicationOptions?: PublicationOptions,\n  ): Promise<{ agentId: string }> {\n    const body = {\n      metadataAttributes: agentMetadata,\n      agentApiAttributes: agentApi,\n      plans: paymentPlans,\n    }\n\n    const options = this.getBackendHTTPOptions(\n      'POST',\n      body,\n      resolvePublicationHeaders(publicationOptions),\n    )\n    const url = new URL(API_URL_REGISTER_AGENT, this.environment.backend)\n\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to register agent', await safeParseJson(response))\n    }\n    const agentData = await response.json()\n    return { agentId: agentData.data.agentId }\n  }\n\n  /**\n   *\n   * It registers a new AI Agent and a Payment Plan associated to this new agent.\n   * Depending on the Payment Plan and the configuration of the agent, the usage of the agent/service will consume credits.\n   * When the plan expires (because the time is over or the credits are consumed), the user needs to renew the plan to continue using the agent.\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/register-agent\n   *\n   * @param agentMetadata - @see {@link AgentMetadata}\n   * @param agentApi - @see {@link AgentAPIAttributes}\n   * @param planMetadata - @see {@link PlanMetadata}\n   * @param priceConfig - @see {@link PlanPriceConfig}\n   * @param creditsConfig - @see {@link PlanCreditsConfig}\n   *\n   * @example\n   * ```\n   *  const agentMetadata = { name: 'My AI Payments Agent', tags: ['test'] }\n   *  const agentApi { endpoints: [{ 'POST': 'https://example.com/api/v1/agents/:agentId/tasks' }] }\n   *  const cryptoPriceConfig = getNativeTokenPriceConfig(100n, builderAddress)\n   *  const 1dayDurationPlan = getExpirableDurationConfig(ONE_DAY_DURATION)\n   *  const { agentId, planId } = await payments.agents.registerAgentAndPlan(\n   *    agentMetadata,\n   *    agentApi,\n   *    cryptoPriceConfig,\n   *    1dayDurationPlan\n   *  )\n   * ```\n   *\n   * @returns The unique identifier of the newly created agent (agentId).\n   * @returns The unique identifier of the newly created plan (planId).\n   */\n  public async registerAgentAndPlan(\n    agentMetadata: AgentMetadata,\n    agentApi: AgentAPIAttributes,\n    planMetadata: PlanMetadata,\n    priceConfig: PlanPriceConfig,\n    creditsConfig: PlanCreditsConfig,\n    accessLimit?: 'credits' | 'time',\n    publicationOptions?: PublicationOptions,\n  ): Promise<{\n    agentId: string\n    planId: string\n    txHash: string\n  }> {\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 = creditsConfig.durationSecs > 0n ? 'time' : 'credits'\n    }\n    const body = {\n      plan: {\n        metadataAttributes: planMetadata,\n        priceConfig: priceConfig,\n        creditsConfig: creditsConfig,\n        accessLimit,\n      },\n      agent: {\n        metadataAttributes: agentMetadata,\n        agentApiAttributes: agentApi,\n      },\n    }\n    const options = this.getBackendHTTPOptions(\n      'POST',\n      body,\n      resolvePublicationHeaders(publicationOptions),\n    )\n    const url = new URL(API_URL_REGISTER_AGENTS_AND_PLAN, this.environment.backend)\n\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend(\n        'Unable to register agent & plan',\n        await safeParseJson(response),\n      )\n    }\n    const result = await response.json()\n    return {\n      agentId: result.data.agentId,\n      planId: result.data.planId,\n      txHash: result.txHash,\n    }\n  }\n\n  /**\n   * Gets the metadata for a given Agent identifier.\n   *\n   * @param agentId - The unique identifier of the agent.\n   * @returns A promise that resolves to the agent's metadata.\n   * @throws PaymentsError if the agent is not found.\n   *\n   * @example\n   * ```\n   *  const plan = payments.agents.getAgent(agentId)\n   * ```\n   */\n  public async getAgent(agentId: string) {\n    const url = new URL(API_URL_GET_AGENT.replace(':agentId', agentId), this.environment.backend)\n    const response = await fetch(url, this.getPublicHTTPOptions('GET'))\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Agent not found', await safeParseJson(response))\n    }\n    return response.json()\n  }\n\n  /**\n   * Updates the metadata and API attributes of an existing AI Agent.\n   *\n   * @param agentId - The unique identifier of the agent.\n   * @param agentMetadata - The new metadata attributes for the agent.\n   * @param agentApi - The new API attributes for the agent.\n   * @returns  @see {@link NvmAPIResult} A promise that resolves indicating if the operation was successful.\n   * @throws PaymentsError if the agent is not found or if the update fails.\n   *\n   * @example\n   * ```\n   *  const agentMetadata = { name: 'My Updated Agent', tags: ['test'] }\n   *  const agentApi = { endpoints: [{ 'POST': 'https://nevermined.app/api/v1/agents/:agentId/tasks' }] }\n   *\n   *  await payments.agents.updateAgentMetadata(agentId, agentMetadata, agentApi)\n   * ```\n   */\n  public async updateAgentMetadata(\n    agentId: string,\n    agentMetadata: AgentMetadata,\n    agentApi: AgentAPIAttributes,\n  ): Promise<NvmAPIResult> {\n    const body = {\n      metadataAttributes: agentMetadata,\n      agentApiAttributes: agentApi,\n    }\n    const url = new URL(API_URL_UPDATE_AGENT.replace(':agentId', agentId), this.environment.backend)\n    const options = this.getBackendHTTPOptions('PUT', body)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Error updating agent', await safeParseJson(response))\n    }\n    return response.json()\n  }\n\n  /**\n   * Gets the list of plans that can be ordered to get access to an agent.\n   *\n   * @param agentId - The unique identifier of the agent.\n   * @param pagination - Optional pagination options to control the number of results returned.p\n   * @returns A promise that resolves to the list of all different plans giving access to the agent.\n   * @throws PaymentsError if the agent is not found.\n   *\n   * @example\n   * ```\n   *  const result = payments.agents.getAgentPlans(planId)\n   *  // {\n   *  //  total: 10,\n   *  //  page: 1,\n   *  //  offset: 5,\n   *  //  plans: [ ..]\n   *  // }\n   * ```\n   */\n  public async getAgentPlans(agentId: string, pagination = new PaginationOptions()) {\n    const query =\n      API_URL_GET_AGENT_PLANS.replace(':agentId', agentId) + '?' + pagination.asQueryParams()\n    const url = new URL(query, this.environment.backend)\n    const response = await fetch(url, this.getPublicHTTPOptions('GET'))\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Agent not found', await safeParseJson(response))\n    }\n    return response.json()\n  }\n\n  /**\n   * Lists the AI agents **you** published (the authenticated caller's own\n   * agents). This is account management, not a marketplace search — it never\n   * returns other users' agents.\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   * @param orgId - Optional organization id. When set, returns every agent in\n   *   that organization (requires active membership) instead of the caller's.\n   * @returns A promise that resolves to the paginated list of your agents.\n   */\n  public async getAgents(\n    page = 1,\n    offset = 100,\n    sortBy = 'created',\n    sortOrder: 'asc' | 'desc' = 'desc',\n    orgId?: string,\n  ): Promise<{ total: number; page: number; offset: number; agents: any[] }> {\n    const url = new URL(API_URL_GET_AGENTS, 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    if (orgId) url.searchParams.set('orgId', orgId)\n    const response = await fetch(url, this.getBackendHTTPOptions('GET'))\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to get agents', await safeParseJson(response))\n    }\n    return response.json()\n  }\n\n  /**\n   * Adds an existing Payment Plan to an AI Agent.\n   * After this operation, users with access to the Payment Plan will be able to access the AI Agent.\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 agentId - The unique identifier of the AI Agent.\n   * @returns  @see {@link NvmAPIResult} A promise that resolves indicating if the operation was successful.\n   * @throws PaymentsError if unable to add the plan to the agent.\n   *\n   * @example\n   * ```\n   * const result = await payments.agents.addPlanToAgent(planId, agentId)\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async addPlanToAgent(planId: string, agentId: string): Promise<NvmAPIResult> {\n    const options = this.getBackendHTTPOptions('POST')\n    const endpoint = API_URL_ADD_PLAN_AGENT.replace(':planId', planId).replace(':agentId', agentId)\n    const url = new URL(endpoint, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Unable to add plan to agent', await safeParseJson(response))\n    }\n\n    return response.json()\n  }\n\n  /**\n   * Removes a Payment Plan from an AI Agent.\n   * After this operation, users with access to the Payment Plan will no longer be able to access the AI Agent.\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 agentId - The unique identifier of the AI Agent.\n   * @returns  @see {@link NvmAPIResult} A promise that resolves indicating if the operation was successful.\n   * @throws PaymentsError if unable to remove the plan from the agent.\n   *\n   * @example\n   * ```\n   * const result = await payments.agents.removePlanFromAgent(planId, agentId)\n   * // {\n   * //   txHash: '0x8d29d5769e832a35e53f80cd4e8890d941c50a09c33dbd975533debc894f2535',\n   * //   success: true\n   * // }\n   * ```\n   */\n  public async removePlanFromAgent(planId: string, agentId: string): Promise<NvmAPIResult> {\n    const options = this.getBackendHTTPOptions('DELETE')\n    const endpoint = API_URL_REMOVE_PLAN_AGENT.replace(':planId', planId).replace(\n      ':agentId',\n      agentId,\n    )\n    const url = new URL(endpoint, this.environment.backend)\n    const response = await fetch(url, options)\n    if (!response.ok) {\n      throw PaymentsError.fromBackend(\n        'Unable to remove plan from agent',\n        await safeParseJson(response),\n      )\n    }\n\n    return response.json()\n  }\n}\n"]}

package/dist/api/nvm-api.d.ts

@@ -4,6 +4,7 @@ export declare const API_URL_REGISTER_AGENTS_AND_PLAN = "/api/v1/protocol/agents
 export declare const API_URL_GET_AGENT = "/api/v1/protocol/agents/:agentId";
 export declare const API_URL_UPDATE_AGENT = "/api/v1/protocol/agents/:agentId";
 export declare const API_URL_GET_AGENT_PLANS = "/api/v1/protocol/agents/:agentId/plans";
+export declare const API_URL_GET_AGENTS = "/api/v1/protocol/agents";
 export declare const API_URL_GET_PLAN = "/api/v1/protocol/plans/:planId";
 export declare const API_URL_GET_PLANS = "/api/v1/protocol/plans";
 export declare const API_URL_GET_PLAN_AGENTS = "/api/v1/protocol/plans/:planId/agents";

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

@@ -1 +1 @@
-{"version":3,"file":"nvm-api.d.ts","sourceRoot":"","sources":["../../src/api/nvm-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"nvm-api.d.ts","sourceRoot":"","sources":["../../src/api/nvm-api.ts"],"names":[],"mappings":"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"}

package/dist/api/nvm-api.js

@@ -5,6 +5,10 @@ export const API_URL_REGISTER_AGENTS_AND_PLAN = '/api/v1/protocol/agents/plans';
 export const API_URL_GET_AGENT = '/api/v1/protocol/agents/:agentId';
 export const API_URL_UPDATE_AGENT = '/api/v1/protocol/agents/:agentId';
 export const API_URL_GET_AGENT_PLANS = '/api/v1/protocol/agents/:agentId/plans';
+// GET: the caller's own agents (?orgId= scopes to an org the caller belongs to).
+// Same path as API_URL_REGISTER_AGENT (disambiguated by GET vs POST); mirrors
+// the existing API_URL_REGISTER_PLAN / API_URL_GET_PLANS pair below.
+export const API_URL_GET_AGENTS = '/api/v1/protocol/agents';
 export const API_URL_GET_PLAN = '/api/v1/protocol/plans/:planId';
 export const API_URL_GET_PLANS = '/api/v1/protocol/plans';
 export const API_URL_GET_PLAN_AGENTS = '/api/v1/protocol/plans/:planId/agents';

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

@@ -1 +1 @@
-{"version":3,"file":"nvm-api.js","sourceRoot":"","sources":["../../src/api/nvm-api.ts"],"names":[],"mappings":"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","sourcesContent":["import axios from 'axios'\n\nexport const API_URL_REGISTER_PLAN = '/api/v1/protocol/plans'\nexport const API_URL_REGISTER_AGENT = '/api/v1/protocol/agents'\nexport const API_URL_REGISTER_AGENTS_AND_PLAN = '/api/v1/protocol/agents/plans'\nexport const API_URL_GET_AGENT = '/api/v1/protocol/agents/:agentId'\nexport const API_URL_UPDATE_AGENT = '/api/v1/protocol/agents/:agentId'\nexport const API_URL_GET_AGENT_PLANS = '/api/v1/protocol/agents/:agentId/plans'\nexport const API_URL_GET_PLAN = '/api/v1/protocol/plans/:planId'\nexport const API_URL_GET_PLANS = '/api/v1/protocol/plans'\nexport const API_URL_GET_PLAN_AGENTS = '/api/v1/protocol/plans/:planId/agents'\nexport const API_URL_ORDER_PLAN = '/api/v1/protocol/plans/:planId/order'\nexport const API_URL_MINT_PLAN = '/api/v1/protocol/plans/mint'\nexport const API_URL_MINT_EXPIRABLE_PLAN = '/api/v1/protocol/plans/mintExpirable'\nexport const API_URL_ADD_PLAN_AGENT = '/api/v1/protocol/agents/:agentId/plan/:planId'\nexport const API_URL_REMOVE_PLAN_AGENT = '/api/v1/protocol/agents/:agentId/plan/:planId'\nexport const API_URL_PLAN_BALANCE = '/api/v1/protocol/plans/:planId/balance/:holderAddress'\nexport const API_URL_INITIALIZE_AGENT = '/api/v1/protocol/agents/initialize/:agentId'\nexport const API_URL_SIMULATE_AGENT_REQUEST = '/api/v1/protocol/agents/simulate/start'\nexport const API_URL_SIMULATE_REDEEM_AGENT_REQUEST = '/api/v1/protocol/agents/simulate/finish'\nexport const API_URL_TRACK_AGENT_SUB_TASK = '/api/v1/protocol/agent-sub-tasks'\nexport const API_URL_VALIDATE_AGENT_ACCESS_TOKEN = '/api/v1/protocol/token/validate/:agentId'\nexport const API_URL_CREATE_PERMISSION = '/api/v1/x402/permissions'\nexport const API_URL_VERIFY_PERMISSIONS = '/api/v1/x402/verify'\nexport const API_URL_SETTLE_PERMISSIONS = '/api/v1/x402/settle'\nexport const API_URL_STRIPE_CHECKOUT = '/api/v1/fiat/stripe/payment'\nexport const API_URL_CREATE_USER = '/api/v1/organizations/account'\nexport const API_URL_GET_MEMBERS = '/api/v1/organizations/members'\nexport const API_URL_MY_MEMBERSHIPS = '/api/v1/organizations/my-memberships'\nexport const API_URL_ORG_ACTIVITY = '/api/v1/organizations/:orgId/activity'\nexport const API_URL_CONNECT_STRIPE_ACCOUNT = '/api/v1/fiat/stripe/account'\n\nexport interface BackendApiOptions {\n  /**\n   * The host of the backend server\n   */\n  backendHost: string\n\n  /**\n   * The Nevermined API Key. This key identify your user and is required to interact with the Nevermined API.\n   * You can get your API key by logging in to the Nevermined App.\n   * @see https://nevermined.ai/docs/tutorials/integration/nvm-api-keys\n   */\n  apiKey?: string\n\n  /**\n   * The host of the Nevermined Proxy\n   */\n  proxyHost?: string\n\n  /**\n   * Additional headers to send with the requests\n   */\n  headers?: { [key: string]: string }\n}\n\nexport class HTTPRequestOptions {\n  accessToken?: string\n  sendThroughProxy = true\n  proxyHost?: string = undefined\n  headers?: { [key: string]: string } = {}\n}\n\nexport abstract class AbstractHTTPClient {\n  // protected opts: BackendApiOptions\n  // private hasKey = false\n  // private agentId = ''\n\n  // constructor(opts: BackendApiOptions) {\n  //   const defaultHeaders = {\n  //     Accept: 'application/json',\n  //     ...opts.headers,\n  //     ...(opts.apiKey && { Authorization: `Bearer ${opts.apiKey}` }),\n  //   }\n\n  //   this.opts = {\n  //     ...opts,\n  //     headers: defaultHeaders,\n  //   }\n\n  //   try {\n  //     if (this.opts.apiKey && this.opts.apiKey.length > 0) {\n  //       const jwt = decodeJwt(this.opts.apiKey)\n  //       if (isEthereumAddress(jwt.sub)) {\n  //         this.hasKey = true\n  //       }\n  //     }\n  //   } catch {\n  //     this.hasKey = false\n  //   }\n\n  //   let backendUrl\n  //   try {\n  //     backendUrl = new URL(this.opts.backendHost)\n  //     this.opts.backendHost = backendUrl.origin\n  //   } catch (error) {\n  //     throw new Error(`Invalid URL: ${this.opts.backendHost} - ${(error as Error).message}`)\n  //   }\n  // }\n\n  constructor() {\n    // Empty constructor - required for abstract class implementation\n  }\n\n  parseUrl(urlRequested: string, reqOptions: HTTPRequestOptions) {\n    let _host: URL\n    if (reqOptions.sendThroughProxy) {\n      if (!reqOptions.proxyHost)\n        throw new Error('Proxy host is required when sendThroughProxy is true')\n      return `${new URL(reqOptions.proxyHost).origin}${new URL(urlRequested).href}`\n    } else {\n      return urlRequested\n    }\n  }\n\n  parseHeaders(requestHeaders: { [key: string]: string }, accessToken?: string) {\n    return {\n      ...(accessToken && { Authorization: `Bearer ${accessToken}` }),\n      ...requestHeaders,\n    }\n  }\n\n  // setBearerToken(token: string) {\n  //   this.opts.headers = {\n  //     ...this.opts.headers,\n  //     Authorization: `Bearer ${token}`,\n  //   }\n  // }\n\n  async request(\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH',\n    url: string,\n    data?: any,\n    reqOptions: HTTPRequestOptions = {\n      sendThroughProxy: false,\n    },\n  ) {\n    try {\n      const response = await axios({\n        method,\n        url: this.parseUrl(url, reqOptions),\n        headers: this.parseHeaders(reqOptions.headers || {}, reqOptions.accessToken),\n        ...(data && { data }), // Only include `data` for methods that support it\n      })\n\n      return response\n    } catch (err) {\n      if (axios.isAxiosError(err) && err.response) {\n        throw new Error(\n          `HTTP ${err.response.status}: ${err.response.data?.message || 'Request failed'}`,\n        )\n      }\n      throw new Error('Network error or request failed without a response.')\n    }\n  }\n\n  async get(url: string, reqOptions: HTTPRequestOptions = { sendThroughProxy: true }) {\n    return this.request('GET', url, undefined, reqOptions)\n  }\n\n  async post(url: string, data: any, reqOptions: HTTPRequestOptions) {\n    return this.request('POST', url, data, reqOptions)\n  }\n\n  async put(url: string, data: any, reqOptions: HTTPRequestOptions) {\n    return this.request('PUT', url, data, reqOptions)\n  }\n\n  async delete(url: string, data: any, reqOptions: HTTPRequestOptions) {\n    return this.request('DELETE', url, data, reqOptions)\n  }\n}\n"]}
+{"version":3,"file":"nvm-api.js","sourceRoot":"","sources":["../../src/api/nvm-api.ts"],"names":[],"mappings":"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","sourcesContent":["import axios from 'axios'\n\nexport const API_URL_REGISTER_PLAN = '/api/v1/protocol/plans'\nexport const API_URL_REGISTER_AGENT = '/api/v1/protocol/agents'\nexport const API_URL_REGISTER_AGENTS_AND_PLAN = '/api/v1/protocol/agents/plans'\nexport const API_URL_GET_AGENT = '/api/v1/protocol/agents/:agentId'\nexport const API_URL_UPDATE_AGENT = '/api/v1/protocol/agents/:agentId'\nexport const API_URL_GET_AGENT_PLANS = '/api/v1/protocol/agents/:agentId/plans'\n// GET: the caller's own agents (?orgId= scopes to an org the caller belongs to).\n// Same path as API_URL_REGISTER_AGENT (disambiguated by GET vs POST); mirrors\n// the existing API_URL_REGISTER_PLAN / API_URL_GET_PLANS pair below.\nexport const API_URL_GET_AGENTS = '/api/v1/protocol/agents'\nexport const API_URL_GET_PLAN = '/api/v1/protocol/plans/:planId'\nexport const API_URL_GET_PLANS = '/api/v1/protocol/plans'\nexport const API_URL_GET_PLAN_AGENTS = '/api/v1/protocol/plans/:planId/agents'\nexport const API_URL_ORDER_PLAN = '/api/v1/protocol/plans/:planId/order'\nexport const API_URL_MINT_PLAN = '/api/v1/protocol/plans/mint'\nexport const API_URL_MINT_EXPIRABLE_PLAN = '/api/v1/protocol/plans/mintExpirable'\nexport const API_URL_ADD_PLAN_AGENT = '/api/v1/protocol/agents/:agentId/plan/:planId'\nexport const API_URL_REMOVE_PLAN_AGENT = '/api/v1/protocol/agents/:agentId/plan/:planId'\nexport const API_URL_PLAN_BALANCE = '/api/v1/protocol/plans/:planId/balance/:holderAddress'\nexport const API_URL_INITIALIZE_AGENT = '/api/v1/protocol/agents/initialize/:agentId'\nexport const API_URL_SIMULATE_AGENT_REQUEST = '/api/v1/protocol/agents/simulate/start'\nexport const API_URL_SIMULATE_REDEEM_AGENT_REQUEST = '/api/v1/protocol/agents/simulate/finish'\nexport const API_URL_TRACK_AGENT_SUB_TASK = '/api/v1/protocol/agent-sub-tasks'\nexport const API_URL_VALIDATE_AGENT_ACCESS_TOKEN = '/api/v1/protocol/token/validate/:agentId'\nexport const API_URL_CREATE_PERMISSION = '/api/v1/x402/permissions'\nexport const API_URL_VERIFY_PERMISSIONS = '/api/v1/x402/verify'\nexport const API_URL_SETTLE_PERMISSIONS = '/api/v1/x402/settle'\nexport const API_URL_STRIPE_CHECKOUT = '/api/v1/fiat/stripe/payment'\nexport const API_URL_CREATE_USER = '/api/v1/organizations/account'\nexport const API_URL_GET_MEMBERS = '/api/v1/organizations/members'\nexport const API_URL_MY_MEMBERSHIPS = '/api/v1/organizations/my-memberships'\nexport const API_URL_ORG_ACTIVITY = '/api/v1/organizations/:orgId/activity'\nexport const API_URL_CONNECT_STRIPE_ACCOUNT = '/api/v1/fiat/stripe/account'\n\nexport interface BackendApiOptions {\n  /**\n   * The host of the backend server\n   */\n  backendHost: string\n\n  /**\n   * The Nevermined API Key. This key identify your user and is required to interact with the Nevermined API.\n   * You can get your API key by logging in to the Nevermined App.\n   * @see https://nevermined.ai/docs/tutorials/integration/nvm-api-keys\n   */\n  apiKey?: string\n\n  /**\n   * The host of the Nevermined Proxy\n   */\n  proxyHost?: string\n\n  /**\n   * Additional headers to send with the requests\n   */\n  headers?: { [key: string]: string }\n}\n\nexport class HTTPRequestOptions {\n  accessToken?: string\n  sendThroughProxy = true\n  proxyHost?: string = undefined\n  headers?: { [key: string]: string } = {}\n}\n\nexport abstract class AbstractHTTPClient {\n  // protected opts: BackendApiOptions\n  // private hasKey = false\n  // private agentId = ''\n\n  // constructor(opts: BackendApiOptions) {\n  //   const defaultHeaders = {\n  //     Accept: 'application/json',\n  //     ...opts.headers,\n  //     ...(opts.apiKey && { Authorization: `Bearer ${opts.apiKey}` }),\n  //   }\n\n  //   this.opts = {\n  //     ...opts,\n  //     headers: defaultHeaders,\n  //   }\n\n  //   try {\n  //     if (this.opts.apiKey && this.opts.apiKey.length > 0) {\n  //       const jwt = decodeJwt(this.opts.apiKey)\n  //       if (isEthereumAddress(jwt.sub)) {\n  //         this.hasKey = true\n  //       }\n  //     }\n  //   } catch {\n  //     this.hasKey = false\n  //   }\n\n  //   let backendUrl\n  //   try {\n  //     backendUrl = new URL(this.opts.backendHost)\n  //     this.opts.backendHost = backendUrl.origin\n  //   } catch (error) {\n  //     throw new Error(`Invalid URL: ${this.opts.backendHost} - ${(error as Error).message}`)\n  //   }\n  // }\n\n  constructor() {\n    // Empty constructor - required for abstract class implementation\n  }\n\n  parseUrl(urlRequested: string, reqOptions: HTTPRequestOptions) {\n    let _host: URL\n    if (reqOptions.sendThroughProxy) {\n      if (!reqOptions.proxyHost)\n        throw new Error('Proxy host is required when sendThroughProxy is true')\n      return `${new URL(reqOptions.proxyHost).origin}${new URL(urlRequested).href}`\n    } else {\n      return urlRequested\n    }\n  }\n\n  parseHeaders(requestHeaders: { [key: string]: string }, accessToken?: string) {\n    return {\n      ...(accessToken && { Authorization: `Bearer ${accessToken}` }),\n      ...requestHeaders,\n    }\n  }\n\n  // setBearerToken(token: string) {\n  //   this.opts.headers = {\n  //     ...this.opts.headers,\n  //     Authorization: `Bearer ${token}`,\n  //   }\n  // }\n\n  async request(\n    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH',\n    url: string,\n    data?: any,\n    reqOptions: HTTPRequestOptions = {\n      sendThroughProxy: false,\n    },\n  ) {\n    try {\n      const response = await axios({\n        method,\n        url: this.parseUrl(url, reqOptions),\n        headers: this.parseHeaders(reqOptions.headers || {}, reqOptions.accessToken),\n        ...(data && { data }), // Only include `data` for methods that support it\n      })\n\n      return response\n    } catch (err) {\n      if (axios.isAxiosError(err) && err.response) {\n        throw new Error(\n          `HTTP ${err.response.status}: ${err.response.data?.message || 'Request failed'}`,\n        )\n      }\n      throw new Error('Network error or request failed without a response.')\n    }\n  }\n\n  async get(url: string, reqOptions: HTTPRequestOptions = { sendThroughProxy: true }) {\n    return this.request('GET', url, undefined, reqOptions)\n  }\n\n  async post(url: string, data: any, reqOptions: HTTPRequestOptions) {\n    return this.request('POST', url, data, reqOptions)\n  }\n\n  async put(url: string, data: any, reqOptions: HTTPRequestOptions) {\n    return this.request('PUT', url, data, reqOptions)\n  }\n\n  async delete(url: string, data: any, reqOptions: HTTPRequestOptions) {\n    return this.request('DELETE', url, data, reqOptions)\n  }\n}\n"]}

package/dist/api/plans-api.d.ts

@@ -302,14 +302,24 @@ export declare class PlansAPI extends BasePaymentsAPI {
      */
     getPlan(planId: string): Promise<any>;
     /**
+     * Lists the payment plans **you** published (the authenticated caller's own
+     * plans). This is account management, not a marketplace search — it never
+     * returns other users' plans.
      *
      * @param page - The page number to retrieve.
      * @param offset - The number of items per page.
      * @param sortBy - The field to sort the results by.
      * @param sortOrder - The order in which to sort the results.
-     * @returns A promise that resolves to the list of all different plans.
+     * @param orgId - Optional organization id. When set, returns every plan in
+     *   that organization (requires active membership) instead of the caller's.
+     * @returns A promise that resolves to the paginated list of your plans.
      */
-    getPlans(page?: number, offset?: number, sortBy?: string, sortOrder?: string): Promise<any>;
+    getPlans(page?: number, offset?: number, sortBy?: string, sortOrder?: 'asc' | 'desc', orgId?: string): Promise<{
+        total: number;
+        page: number;
+        offset: number;
+        plans: any[];
+    }>;
     /**
      * Gets the list of Agents that have associated a specific Payment Plan.
      * All the agents returned can be accessed by the users that are subscribed to the Payment Plan.

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

@@ -1 +1 @@
-{"version":3,"file":"plans-api.d.ts","sourceRoot":"","sources":["../../src/api/plans-api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plans-api.d.ts","sourceRoot":"","sources":["../../src/api/plans-api.ts"],"names":[],"mappings":"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"}

package/dist/api/plans-api.js

@@ -383,19 +383,26 @@ export class PlansAPI extends BasePaymentsAPI {
         return response.json();
     }
     /**
+     * Lists the payment plans **you** published (the authenticated caller's own
+     * plans). This is account management, not a marketplace search — it never
+     * returns other users' plans.
      *
      * @param page - The page number to retrieve.
      * @param offset - The number of items per page.
      * @param sortBy - The field to sort the results by.
      * @param sortOrder - The order in which to sort the results.
-     * @returns A promise that resolves to the list of all different plans.
+     * @param orgId - Optional organization id. When set, returns every plan in
+     *   that organization (requires active membership) instead of the caller's.
+     * @returns A promise that resolves to the paginated list of your plans.
      */
-    async getPlans(page = 1, offset = 100, sortBy = 'created', sortOrder = 'desc') {
+    async getPlans(page = 1, offset = 100, sortBy = 'created', sortOrder = 'desc', orgId) {
         const url = new URL(API_URL_GET_PLANS, this.environment.backend);
         url.searchParams.set('page', page.toString());
         url.searchParams.set('offset', offset.toString());
         url.searchParams.set('sortBy', sortBy);
         url.searchParams.set('sortOrder', sortOrder);
+        if (orgId)
+            url.searchParams.set('orgId', orgId);
         const options = this.getBackendHTTPOptions('GET');
         const response = await fetch(url, options);
         if (!response.ok) {

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 { 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, this.getPublicHTTPOptions('GET'))\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, this.getPublicHTTPOptions('GET'))\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 url = new URL(balanceUrl, this.environment.backend)\n    const response = await fetch(url, this.getPublicHTTPOptions('GET'))\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"]}
+{"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, this.getPublicHTTPOptions('GET'))\n    if (!response.ok) {\n      throw PaymentsError.fromBackend('Plan not found', await safeParseJson(response))\n    }\n    return response.json()\n  }\n\n  /**\n   * Lists the payment plans **you** published (the authenticated caller's own\n   * plans). This is account management, not a marketplace search — it never\n   * returns other users' plans.\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   * @param orgId - Optional organization id. When set, returns every plan in\n   *   that organization (requires active membership) instead of the caller's.\n   * @returns A promise that resolves to the paginated list of your plans.\n   */\n  public async getPlans(\n    page = 1,\n    offset = 100,\n    sortBy = 'created',\n    sortOrder: 'asc' | 'desc' = 'desc',\n    orgId?: string,\n  ): Promise<{ total: number; page: number; offset: number; plans: any[] }> {\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    if (orgId) url.searchParams.set('orgId', orgId)\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, this.getPublicHTTPOptions('GET'))\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 url = new URL(balanceUrl, this.environment.backend)\n    const response = await fetch(url, this.getPublicHTTPOptions('GET'))\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/index.d.ts

@@ -23,4 +23,6 @@ export type { OAuthUrls, OAuthConfig, HttpRouterConfig, HttpServerConfig, HttpSe
 export type { ExtendedMcpConfig } from './mcp/index.js';
 export { createRequireAuthMiddleware } from './mcp/http/oauth-router.js';
 export type { AgentCard, TaskHandlerResult, TaskStatusUpdateEvent, ExecutionEventBus, AgentExecutor, RequestContext, PushNotificationConfig, Task, MessageSendParams, SendMessageResponse, TaskQueryParams, GetTaskResponse, TaskPushNotificationConfig, SetTaskPushNotificationConfigResponse, TaskIdParams, GetTaskPushNotificationConfigResponse, } from './a2a/types.js';
+export { X402A2AUtils, x402A2AUtils, X402A2AMetadata, X402_SETTLEMENT_DEFERRED_KEY, PaymentStatus as A2APaymentStatus, } from './a2a/x402-a2a.js';
+export { A2A_X402_EXTENSION_URI, NVM_PAYMENT_EXTENSION_URI, AGENT_CARD_WELL_KNOWN_PATH, LEGACY_AGENT_CARD_WELL_KNOWN_PATH, } from './a2a/agent-card.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,8CAA8C,CAAA;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAC/E,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,6BAA6B,GAC9B,MAAM,kCAAkC,CAAA;AACzC,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,kCAAkC,CAAA;AAGzC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,WAAW,GACZ,MAAM,0BAA0B,CAAA;AACjC,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,2BAA2B,CAAA;AAElC,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,SAAS,EACT,cAAc,EACd,UAAU,GACX,MAAM,8BAA8B,CAAA;AAGrC,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,2BAA2B,CAAA;AAGlC,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AAExE,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,IAAI,EACJ,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,0BAA0B,EAC1B,qCAAqC,EACrC,YAAY,EACZ,qCAAqC,GACtC,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,8CAA8C,CAAA;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAC/E,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,6BAA6B,GAC9B,MAAM,kCAAkC,CAAA;AACzC,YAAY,EACV,YAAY,EACZ,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,kCAAkC,CAAA;AAGzC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,WAAW,GACZ,MAAM,0BAA0B,CAAA;AACjC,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,UAAU,EACV,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,2BAA2B,CAAA;AAElC,YAAY,EACV,cAAc,EACd,aAAa,EACb,cAAc,EACd,SAAS,EACT,cAAc,EACd,UAAU,GACX,MAAM,8BAA8B,CAAA;AAGrC,YAAY,EACV,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,2BAA2B,CAAA;AAGlC,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AAExE,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,IAAI,EACJ,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,0BAA0B,EAC1B,qCAAqC,EACrC,YAAY,EACZ,qCAAqC,GACtC,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,4BAA4B,EAC5B,aAAa,IAAI,gBAAgB,GAClC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -16,4 +16,7 @@ export { buildPaymentRequired, resolveNetwork, resolveScheme } from './x402/faci
 export { DelegationAPI } from './x402/delegation-api.js';
 // MCP HTTP utilities
 export { createRequireAuthMiddleware } from './mcp/http/oauth-router.js';
+// x402 v2 A2A in-band transport utilities (mirrors the Python X402A2AUtils)
+export { X402A2AUtils, x402A2AUtils, X402A2AMetadata, X402_SETTLEMENT_DEFERRED_KEY, PaymentStatus as A2APaymentStatus, } from './a2a/x402-a2a.js';
+export { A2A_X402_EXTENSION_URI, NVM_PAYMENT_EXTENSION_URI, AGENT_CARD_WELL_KNOWN_PATH, LEGACY_AGENT_CARD_WELL_KNOWN_PATH, } from './a2a/agent-card.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,8CAA8C,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAC/E,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,6BAA6B,GAC9B,MAAM,kCAAkC,CAAA;AAQzC,2BAA2B;AAC3B,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AA0CxD,qBAAqB;AACrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA","sourcesContent":["export * from './environments.js'\nexport * from './payments.js'\nexport * from './utils.js'\nexport * from './common/api-version.js'\nexport * from './common/types.js'\nexport * from './common/payments.error.js'\nexport * from './common/helper.js'\nexport * from './api/query-api.js'\nexport * from './api/observability-api/observability-api.js'\nexport type { BackendApiOptions } from './api/nvm-api.js'\nexport { ContractsAPI } from './api/contracts-api.js'\nexport { CURRENT_ORG_ID_HEADER } from './api/base-payments.js'\nexport type { PublicationOptions } from './api/base-payments.js'\nexport { OrganizationsAPI } from './api/organizations-api/organizations-api.js'\nexport {\n  OrganizationMemberRole,\n  OrganizationType,\n  OrganizationActivityEventType,\n} from './api/organizations-api/types.js'\nexport type {\n  MyMembership,\n  OrganizationActivityEvent,\n  OrganizationActivityFilters,\n  OrganizationActivityPage,\n} from './api/organizations-api/types.js'\n\n// x402 utilities and types\nexport { buildPaymentRequired, resolveNetwork, resolveScheme } from './x402/facilitator-api.js'\nexport { DelegationAPI } from './x402/delegation-api.js'\nexport type {\n  PaymentMethodSummary,\n  UpdatePaymentMethodDto,\n  DelegationSummary,\n  DelegationListResponse,\n  PurchasingPower,\n  ListOptions,\n} from './x402/delegation-api.js'\nexport type {\n  X402PaymentRequired,\n  X402PaymentAccepted,\n  X402Resource,\n  X402Scheme,\n  X402SchemeExtra,\n  VerifyPermissionsParams,\n  VerifyPermissionsResult,\n  SettlePermissionsParams,\n  SettlePermissionsResult,\n} from './x402/facilitator-api.js'\n// MCP public types\nexport type {\n  CreditsContext,\n  CreditsOption,\n  PaywallOptions,\n  McpConfig,\n  PaywallContext,\n  AuthResult,\n} from './mcp/types/paywall.types.js'\n\n// MCP HTTP types\nexport type {\n  OAuthUrls,\n  OAuthConfig,\n  HttpRouterConfig,\n  HttpServerConfig,\n  HttpServerResult,\n} from './mcp/types/http.types.js'\n\n// MCP extended config type\nexport type { ExtendedMcpConfig } from './mcp/index.js'\n\n// MCP HTTP utilities\nexport { createRequireAuthMiddleware } from './mcp/http/oauth-router.js'\n\nexport type {\n  AgentCard,\n  TaskHandlerResult,\n  TaskStatusUpdateEvent,\n  ExecutionEventBus,\n  AgentExecutor,\n  RequestContext,\n  PushNotificationConfig,\n  Task,\n  MessageSendParams,\n  SendMessageResponse,\n  TaskQueryParams,\n  GetTaskResponse,\n  TaskPushNotificationConfig,\n  SetTaskPushNotificationConfigResponse,\n  TaskIdParams,\n  GetTaskPushNotificationConfigResponse,\n} from './a2a/types.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,8CAA8C,CAAA;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAA;AAC/E,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,6BAA6B,GAC9B,MAAM,kCAAkC,CAAA;AAQzC,2BAA2B;AAC3B,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AA0CxD,qBAAqB;AACrB,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AAqBxE,4EAA4E;AAC5E,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,4BAA4B,EAC5B,aAAa,IAAI,gBAAgB,GAClC,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,qBAAqB,CAAA","sourcesContent":["export * from './environments.js'\nexport * from './payments.js'\nexport * from './utils.js'\nexport * from './common/api-version.js'\nexport * from './common/types.js'\nexport * from './common/payments.error.js'\nexport * from './common/helper.js'\nexport * from './api/query-api.js'\nexport * from './api/observability-api/observability-api.js'\nexport type { BackendApiOptions } from './api/nvm-api.js'\nexport { ContractsAPI } from './api/contracts-api.js'\nexport { CURRENT_ORG_ID_HEADER } from './api/base-payments.js'\nexport type { PublicationOptions } from './api/base-payments.js'\nexport { OrganizationsAPI } from './api/organizations-api/organizations-api.js'\nexport {\n  OrganizationMemberRole,\n  OrganizationType,\n  OrganizationActivityEventType,\n} from './api/organizations-api/types.js'\nexport type {\n  MyMembership,\n  OrganizationActivityEvent,\n  OrganizationActivityFilters,\n  OrganizationActivityPage,\n} from './api/organizations-api/types.js'\n\n// x402 utilities and types\nexport { buildPaymentRequired, resolveNetwork, resolveScheme } from './x402/facilitator-api.js'\nexport { DelegationAPI } from './x402/delegation-api.js'\nexport type {\n  PaymentMethodSummary,\n  UpdatePaymentMethodDto,\n  DelegationSummary,\n  DelegationListResponse,\n  PurchasingPower,\n  ListOptions,\n} from './x402/delegation-api.js'\nexport type {\n  X402PaymentRequired,\n  X402PaymentAccepted,\n  X402Resource,\n  X402Scheme,\n  X402SchemeExtra,\n  VerifyPermissionsParams,\n  VerifyPermissionsResult,\n  SettlePermissionsParams,\n  SettlePermissionsResult,\n} from './x402/facilitator-api.js'\n// MCP public types\nexport type {\n  CreditsContext,\n  CreditsOption,\n  PaywallOptions,\n  McpConfig,\n  PaywallContext,\n  AuthResult,\n} from './mcp/types/paywall.types.js'\n\n// MCP HTTP types\nexport type {\n  OAuthUrls,\n  OAuthConfig,\n  HttpRouterConfig,\n  HttpServerConfig,\n  HttpServerResult,\n} from './mcp/types/http.types.js'\n\n// MCP extended config type\nexport type { ExtendedMcpConfig } from './mcp/index.js'\n\n// MCP HTTP utilities\nexport { createRequireAuthMiddleware } from './mcp/http/oauth-router.js'\n\nexport type {\n  AgentCard,\n  TaskHandlerResult,\n  TaskStatusUpdateEvent,\n  ExecutionEventBus,\n  AgentExecutor,\n  RequestContext,\n  PushNotificationConfig,\n  Task,\n  MessageSendParams,\n  SendMessageResponse,\n  TaskQueryParams,\n  GetTaskResponse,\n  TaskPushNotificationConfig,\n  SetTaskPushNotificationConfigResponse,\n  TaskIdParams,\n  GetTaskPushNotificationConfigResponse,\n} from './a2a/types.js'\n\n// x402 v2 A2A in-band transport utilities (mirrors the Python X402A2AUtils)\nexport {\n  X402A2AUtils,\n  x402A2AUtils,\n  X402A2AMetadata,\n  X402_SETTLEMENT_DEFERRED_KEY,\n  PaymentStatus as A2APaymentStatus,\n} from './a2a/x402-a2a.js'\nexport {\n  A2A_X402_EXTENSION_URI,\n  NVM_PAYMENT_EXTENSION_URI,\n  AGENT_CARD_WELL_KNOWN_PATH,\n  LEGACY_AGENT_CARD_WELL_KNOWN_PATH,\n} from './a2a/agent-card.js'\n"]}

package/dist/mcp/core/auth.d.ts

@@ -28,6 +28,20 @@ export declare class PaywallAuthenticator {
      * Tries logical URL first, falls back to HTTP URL if available.
      */
     private verifyWithFallback;
+    /**
+     * Build a spec-shaped {@link PaymentRequiredError} from the agent's plans.
+     *
+     * Fetches the agent's plans (best-effort) to populate the `accepts` array of
+     * the `PaymentRequired` object and a human-readable list of plan names in the
+     * error message. Falls back to an empty plan id when no plans can be resolved
+     * so the structured shape is still valid.
+     *
+     * @param agentId - Agent identifier used to look up purchasable plans.
+     * @param endpoint - Logical resource URL placed in `PaymentRequired.resource`.
+     * @param message - Leading human-readable message (e.g. "Authorization required.").
+     * @returns A `PaymentRequiredError` carrying the `PaymentRequired` object.
+     */
+    private buildPaymentRequiredError;
     /**
      * Verify permissions against a single endpoint URL.
      * Resolves planId from the token or from the agent's plans as fallback.
@@ -39,7 +53,7 @@ export declare class PaywallAuthenticator {
     authenticate(extra: any, options: {
         planId?: string;
         maxAmount?: bigint;
-    } | undefined, agentId: string, serverName: string, name: string, kind: 'tool' | 'resource' | 'prompt', argsOrVars: any): Promise<AuthResult>;
+    } | undefined, agentId: string | undefined, serverName: string, name: string, kind: 'tool' | 'resource' | 'prompt', argsOrVars: any): Promise<AuthResult>;
     /**
      * Authenticate generic MCP meta operations (e.g., initialize, tools/list, resources/list, prompts/list).
      * Returns an AuthResult compatible with paywall flows (without redeem step).
@@ -47,6 +61,6 @@ export declare class PaywallAuthenticator {
     authenticateMeta(extra: any, options: {
         planId?: string;
         maxAmount?: bigint;
-    } | undefined, agentId: string, serverName: string, method: string): Promise<AuthResult>;
+    } | undefined, agentId: string | undefined, serverName: string, method: string): Promise<AuthResult>;
 }
 //# sourceMappingURL=auth.d.ts.map

package/dist/mcp/core/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/mcp/core/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAGjD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAgBtD;;GAEG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAEtC;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IAepC;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAuB/B;;;OAGG;YACW,kBAAkB;IAoEhC;;;OAGG;YACW,kBAAkB;IAuDhC;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,YAAK,EACrD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,EACpC,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,UAAU,CAAC;IAkBtB;;;OAGG;IACG,gBAAgB,CACpB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,YAAK,EACrD,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC;CAiBvB"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/mcp/core/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAGjD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAoBtD;;GAEG;AACH,qBAAa,oBAAoB;IACnB,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,QAAQ;IAEtC;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IAepC;;;;OAIG;IACH,OAAO,CAAC,uBAAuB;IAuB/B;;;OAGG;YACW,kBAAkB;IAsDhC;;;;;;;;;;;;OAYG;YACW,yBAAyB;IAuDvC;;;OAGG;YACW,kBAAkB;IA0DhC;;OAEG;IACG,YAAY,CAChB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,YAAK,EACrD,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,QAAQ,EACpC,UAAU,EAAE,GAAG,GACd,OAAO,CAAC,UAAU,CAAC;IAuBtB;;;OAGG;IACG,gBAAgB,CACpB,KAAK,EAAE,GAAG,EACV,OAAO,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,YAAK,EACrD,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,UAAU,CAAC;CAsBvB"}