@hashgraphonline/standards-sdk 0.1.185 → 0.1.187

package/dist/es/standards-sdk.es156.js.map

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es156.js","sources":["../../src/fees/fee-config-builder.ts"],"sourcesContent":["import {\n  FeeConfigBuilderInterface,\n  TokenFeeConfig,\n  TopicFeeConfig,\n  CustomFeeType,\n} from './types';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport { Logger } from '../utils/logger';\nimport { NetworkType } from '../utils/types';\n\n/**\n * FeeConfigBuilder provides a fluent interface for creating fee configurations\n * for HCS-10 topics. This makes it easy to configure fees without dealing with\n * the complexity of the underlying fee structure.\n *\n * Example usage:\n *\n * // Super simple one-liner with the factory method\n * const simpleFeeConfig = FeeConfigBuilder.forHbar(5, '0.0.12345', NetworkType.TESTNET, new Logger(), ['0.0.67890']);\n *\n * // With multiple fees:\n * const multipleFeeConfig = new FeeConfigBuilder({\n *   network: NetworkType.TESTNET,\n *   logger: new Logger(),\n *   defaultCollectorAccountId: '0.0.12345',\n *   defaultExemptAccountIds: ['0.0.67890']\n * })\n *   .withHbarFee(1) // 1 HBAR fee\n *   .withTokenFee(10, '0.0.54321') // 10 units of token 0.0.54321\n *   .build();\n *\n * With Agent Builder\n * const agent = new AgentBuilder()\n *   .setName('Fee Collector Agent')\n *   .setDescription('An agent that collects fees')\n *   .setInboundTopicType(InboundTopicType.FEE_BASED)\n *   .setFeeConfig(FeeConfigBuilder.forHbar(1, '0.0.12345', NetworkType.TESTNET, new Logger(), ['0.0.67890']))\n *   .setNetwork('testnet')\n  .build();\n\n * Directly with client\n * const client = new HCS10Client(config);\n * const connectionFeeConfig = new FeeConfigBuilder({\n *   network: NetworkType.TESTNET,\n *   logger: new Logger(),\n *   defaultCollectorAccountId: client.getAccountAndSigner().accountId,\n *   defaultExemptAccountIds: ['0.0.67890']\n * })\n *   .withHbarFee(0.5) // 0.5 HBAR (simple!)\n *   .build();\n\n * const result = await client.handleConnectionRequest(\n *   inboundTopicId,\n *   requestingAccountId,\n *   connectionRequestId,\n *   connectionFeeConfig\n * );\n*/\nexport interface FeeConfigBuilderOptions {\n  network: NetworkType;\n  logger: Logger;\n  defaultCollectorAccountId?: string;\n}\n\nexport class FeeConfigBuilder implements FeeConfigBuilderInterface {\n  private customFees: TokenFeeConfig[] = [];\n  private mirrorNode: HederaMirrorNode;\n  private logger: Logger;\n  private defaultCollectorAccountId: string;\n\n  constructor(options: FeeConfigBuilderOptions) {\n    this.logger = options.logger;\n    this.mirrorNode = new HederaMirrorNode(options.network, options.logger);\n    this.defaultCollectorAccountId = options.defaultCollectorAccountId || '';\n  }\n\n  /**\n   * Static factory method to create a FeeConfigBuilder with a single HBAR fee.\n   * @param hbarAmount Amount in HBAR.\n   * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.\n   * @param network Network type ('mainnet' or 'testnet').\n   * @param logger Logger instance.\n   * @param exemptAccounts Optional array of account IDs exempt from this fee.\n   * @returns A configured FeeConfigBuilder instance.\n   */\n  static forHbar(\n    hbarAmount: number,\n    collectorAccountId: string | undefined,\n    network: NetworkType,\n    logger: Logger,\n    exemptAccounts: string[] = [],\n  ): FeeConfigBuilder {\n    const builder = new FeeConfigBuilder({\n      network,\n      logger,\n      defaultCollectorAccountId: collectorAccountId,\n    });\n    return builder.addHbarFee(hbarAmount, collectorAccountId, exemptAccounts);\n  }\n\n  /**\n   * Static factory method to create a FeeConfigBuilder with a single token fee.\n   * Automatically fetches token decimals if not provided.\n   * @param tokenAmount Amount of tokens.\n   * @param feeTokenId Token ID for the fee.\n   * @param collectorAccountId Optional account ID to collect the fee. If omitted or undefined, defaults to the agent's own account ID during topic creation.\n   * @param network Network type ('mainnet' or 'testnet').\n   * @param logger Logger instance.\n   * @param exemptAccounts Optional array of account IDs exempt from this fee.\n   * @param decimals Optional decimals for the token (fetched if omitted).\n   * @returns A Promise resolving to a configured FeeConfigBuilder instance.\n   */\n  static async forToken(\n    tokenAmount: number,\n    feeTokenId: string,\n    collectorAccountId: string | undefined,\n    network: NetworkType,\n    logger: Logger,\n    exemptAccounts: string[] = [],\n    decimals?: number,\n  ): Promise<FeeConfigBuilder> {\n    const builder = new FeeConfigBuilder({\n      network,\n      logger,\n      defaultCollectorAccountId: collectorAccountId,\n    });\n    await builder.addTokenFee(\n      tokenAmount,\n      feeTokenId,\n      collectorAccountId,\n      decimals,\n      exemptAccounts,\n    );\n    return builder;\n  }\n\n  /**\n   * Adds an HBAR fee configuration to the builder.\n   * Allows chaining multiple fee additions.\n   * @param hbarAmount The amount in HBAR (e.g., 0.5).\n   * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.\n   * @param exemptAccountIds Optional. Accounts specifically exempt from *this* HBAR fee.\n   * @returns This FeeConfigBuilder instance for chaining.\n   */\n  addHbarFee(\n    hbarAmount: number,\n    collectorAccountId?: string,\n    exemptAccountIds: string[] = [],\n  ): FeeConfigBuilder {\n    if (hbarAmount <= 0) {\n      throw new Error('HBAR amount must be greater than zero');\n    }\n\n    this.customFees.push({\n      feeAmount: {\n        amount: hbarAmount * 100_000_000,\n        decimals: 0,\n      },\n      feeCollectorAccountId:\n        collectorAccountId || this.defaultCollectorAccountId,\n      feeTokenId: undefined,\n      exemptAccounts: [...exemptAccountIds],\n      type: CustomFeeType.FIXED_FEE,\n    });\n\n    return this;\n  }\n\n  /**\n   * Adds a token fee configuration to the builder.\n   * Allows chaining multiple fee additions.\n   * Fetches token decimals automatically if not provided.\n   * @param tokenAmount The amount of the specified token.\n   * @param feeTokenId The ID of the token to charge the fee in.\n   * @param collectorAccountId Optional. The account ID to collect this fee. If omitted, defaults to the agent's own account ID during topic creation.\n   * @param decimals Optional. The number of decimals for the token. If omitted, it will be fetched from the mirror node.\n   * @param exemptAccountIds Optional. Accounts specifically exempt from *this* token fee.\n   * @returns A Promise resolving to this FeeConfigBuilder instance for chaining.\n   */\n  async addTokenFee(\n    tokenAmount: number,\n    feeTokenId: string,\n    collectorAccountId?: string,\n    decimals?: number,\n    exemptAccountIds: string[] = [],\n  ): Promise<FeeConfigBuilder> {\n    if (tokenAmount <= 0) {\n      throw new Error('Token amount must be greater than zero');\n    }\n    if (!feeTokenId) {\n      throw new Error('Fee token ID is required when adding a token fee');\n    }\n\n    let finalDecimals = decimals;\n    if (finalDecimals === undefined) {\n      try {\n        const tokenInfo = await this.mirrorNode.getTokenInfo(feeTokenId);\n        if (tokenInfo?.decimals) {\n          finalDecimals = parseInt(tokenInfo.decimals, 10);\n          this.logger.info(\n            `Fetched decimals for ${feeTokenId}: ${finalDecimals}`,\n          );\n        } else {\n          this.logger.warn(\n            `Could not fetch decimals for ${feeTokenId}, defaulting to 0.`,\n          );\n          finalDecimals = 0;\n        }\n      } catch (error) {\n        this.logger.error(\n          `Error fetching decimals for ${feeTokenId}, defaulting to 0: ${error}`,\n        );\n        finalDecimals = 0;\n      }\n    }\n\n    this.customFees.push({\n      feeAmount: {\n        amount: tokenAmount * 10 ** finalDecimals,\n        decimals: finalDecimals,\n      },\n      feeCollectorAccountId:\n        collectorAccountId || this.defaultCollectorAccountId,\n      feeTokenId: feeTokenId,\n      exemptAccounts: [...exemptAccountIds],\n      type: CustomFeeType.FIXED_FEE,\n    });\n\n    return this;\n  }\n\n  /**\n   * Builds the final TopicFeeConfig object.\n   * @returns The TopicFeeConfig containing all added custom fees and a consolidated list of unique exempt accounts.\n   * @throws Error if no fees have been added.\n   * @throws Error if more than 10 fees have been added.\n   */\n  build(): TopicFeeConfig {\n    if (this.customFees.length === 0) {\n      throw new Error(\n        'At least one fee must be added using addHbarFee/addTokenFee or created using forHbar/forToken',\n      );\n    }\n\n    if (this.customFees.length > 10) {\n      throw new Error('Maximum of 10 custom fees per topic allowed');\n    }\n\n    const allExemptAccounts = new Set<string>();\n    this.customFees.forEach(fee => {\n      fee.exemptAccounts.forEach(account => allExemptAccounts.add(account));\n    });\n\n    const resolvedCustomFees = this.customFees.map(fee => ({\n      ...fee,\n      feeCollectorAccountId:\n        fee.feeCollectorAccountId || this.defaultCollectorAccountId,\n    }));\n\n    return {\n      customFees: resolvedCustomFees,\n      exemptAccounts: Array.from(allExemptAccounts),\n    };\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es156.js","sources":["../../src/services/registry-broker/hol-chat-ops.ts"],"sourcesContent":["export const HOL_CHAT_PROTOCOL_ID = 'hol-chat' as const;\n\nexport type HolChatOpName =\n  | 'payment_request'\n  | 'payment_approve'\n  | 'payment_decline'\n  | 'payment_result'\n  | 'job_status';\n\nexport interface HolChatOpBase {\n  p: typeof HOL_CHAT_PROTOCOL_ID;\n  op: HolChatOpName;\n  request_id: string;\n  m?: string;\n  data?: Record<string, unknown>;\n}\n\nexport type HolChatOp = HolChatOpBase;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  Boolean(value) && typeof value === 'object' && !Array.isArray(value);\n\nexport const isHolChatOp = (value: unknown): value is HolChatOp => {\n  if (!isRecord(value)) {\n    return false;\n  }\n  if (value.p !== HOL_CHAT_PROTOCOL_ID) {\n    return false;\n  }\n  if (\n    typeof value.request_id !== 'string' ||\n    value.request_id.trim().length === 0\n  ) {\n    return false;\n  }\n  const op = value.op;\n  if (\n    op !== 'payment_request' &&\n    op !== 'payment_approve' &&\n    op !== 'payment_decline' &&\n    op !== 'payment_result' &&\n    op !== 'job_status'\n  ) {\n    return false;\n  }\n  return true;\n};\n\nexport const parseHolChatOps = (ops: unknown): HolChatOp[] => {\n  if (!Array.isArray(ops)) {\n    return [];\n  }\n  return ops.filter(isHolChatOp).map(op => {\n    const next: HolChatOp = {\n      p: HOL_CHAT_PROTOCOL_ID,\n      op: op.op,\n      request_id: op.request_id.trim(),\n    };\n    if (typeof op.m === 'string' && op.m.trim().length > 0) {\n      next.m = op.m.trim();\n    }\n    if (isRecord(op.data)) {\n      next.data = { ...op.data };\n    }\n    return next;\n  });\n};\n\nexport const buildPaymentApproveMessage = (input: {\n  requestId: string;\n  jobId: number;\n}): string =>\n  JSON.stringify({\n    p: HOL_CHAT_PROTOCOL_ID,\n    op: 'payment_approve',\n    request_id: input.requestId,\n    data: { job_id: input.jobId },\n  });\n\nexport const buildPaymentDeclineMessage = (input: {\n  requestId: string;\n}): string =>\n  JSON.stringify({\n    p: HOL_CHAT_PROTOCOL_ID,\n    op: 'payment_decline',\n    request_id: input.requestId,\n  });\n\nexport const buildJobStatusMessage = (input: {\n  requestId: string;\n  jobId: number;\n}): string =>\n  JSON.stringify({\n    p: HOL_CHAT_PROTOCOL_ID,\n    op: 'job_status',\n    request_id: input.requestId,\n    data: { job_id: input.jobId },\n  });\n"],"names":[],"mappings":"AAAO,MAAM,uBAAuB;AAmBpC,MAAM,WAAW,CAAC,UAChB,QAAQ,KAAK,KAAK,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAE9D,MAAM,cAAc,CAAC,UAAuC;AACjE,MAAI,CAAC,SAAS,KAAK,GAAG;AACpB,WAAO;AAAA,EACT;AACA,MAAI,MAAM,MAAM,sBAAsB;AACpC,WAAO;AAAA,EACT;AACA,MACE,OAAO,MAAM,eAAe,YAC5B,MAAM,WAAW,KAAA,EAAO,WAAW,GACnC;AACA,WAAO;AAAA,EACT;AACA,QAAM,KAAK,MAAM;AACjB,MACE,OAAO,qBACP,OAAO,qBACP,OAAO,qBACP,OAAO,oBACP,OAAO,cACP;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,MAAM,kBAAkB,CAAC,QAA8B;AAC5D,MAAI,CAAC,MAAM,QAAQ,GAAG,GAAG;AACvB,WAAO,CAAA;AAAA,EACT;AACA,SAAO,IAAI,OAAO,WAAW,EAAE,IAAI,CAAA,OAAM;AACvC,UAAM,OAAkB;AAAA,MACtB,GAAG;AAAA,MACH,IAAI,GAAG;AAAA,MACP,YAAY,GAAG,WAAW,KAAA;AAAA,IAAK;AAEjC,QAAI,OAAO,GAAG,MAAM,YAAY,GAAG,EAAE,KAAA,EAAO,SAAS,GAAG;AACtD,WAAK,IAAI,GAAG,EAAE,KAAA;AAAA,IAChB;AACA,QAAI,SAAS,GAAG,IAAI,GAAG;AACrB,WAAK,OAAO,EAAE,GAAG,GAAG,KAAA;AAAA,IACtB;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAEO,MAAM,6BAA6B,CAAC,UAIzC,KAAK,UAAU;AAAA,EACb,GAAG;AAAA,EACH,IAAI;AAAA,EACJ,YAAY,MAAM;AAAA,EAClB,MAAM,EAAE,QAAQ,MAAM,MAAA;AACxB,CAAC;AAEI,MAAM,6BAA6B,CAAC,UAGzC,KAAK,UAAU;AAAA,EACb,GAAG;AAAA,EACH,IAAI;AAAA,EACJ,YAAY,MAAM;AACpB,CAAC;AAEI,MAAM,wBAAwB,CAAC,UAIpC,KAAK,UAAU;AAAA,EACb,GAAG;AAAA,EACH,IAAI;AAAA,EACJ,YAAY,MAAM;AAAA,EAClB,MAAM,EAAE,QAAQ,MAAM,MAAA;AACxB,CAAC;"}