@hashgraphonline/standards-sdk 0.1.190 → 0.1.191

package/dist/es/standards-sdk.es150.js

@@ -1,163 +1,25 @@
-import { Logger } from "./standards-sdk.es147.js";
-class ProgressReporter {
-  constructor(options = {}) {
-    this.module = options.module || "Progress";
-    this.callback = options.callback;
-    this.logger = options.logger || new Logger({
-      level: "info",
-      module: "ProgressReporter"
-    });
-    this.logProgress = options.logProgress ?? true;
-    this.minPercent = options.minPercent ?? 0;
-    this.maxPercent = options.maxPercent ?? 100;
-    this.lastReportedPercent = -1;
-    this.lastReportedTime = 0;
-    this.throttleMs = 100;
-  }
-  static getInstance(options = {}) {
-    if (!ProgressReporter.instance) {
-      ProgressReporter.instance = new ProgressReporter(options);
-    } else {
-      if (options.callback) {
-        ProgressReporter.instance.setCallback(options.callback);
-      }
-      if (options.module) {
-        ProgressReporter.instance.setModule(options.module);
-      }
-      if (options.logger) {
-        ProgressReporter.instance.setLogger(options.logger);
-      }
-      if (options.minPercent !== void 0) {
-        ProgressReporter.instance.setMinPercent(options.minPercent);
-      }
-      if (options.maxPercent !== void 0) {
-        ProgressReporter.instance.setMaxPercent(options.maxPercent);
-      }
-    }
-    return ProgressReporter.instance;
-  }
-  setCallback(callback) {
-    this.callback = callback;
-  }
-  setModule(module) {
-    this.module = module;
-  }
-  setLogger(logger) {
-    this.logger = logger;
-  }
-  setMinPercent(minPercent) {
-    this.minPercent = minPercent;
-  }
-  setMaxPercent(maxPercent) {
-    this.maxPercent = maxPercent;
-  }
-  createSubProgress(options) {
-    const subReporter = new ProgressReporter({
-      module: this.module,
-      logger: this.logger,
-      logProgress: this.logProgress,
-      minPercent: options.minPercent,
-      maxPercent: options.maxPercent
-    });
-    const logPrefix = options.logPrefix || "";
-    subReporter.setCallback((data) => {
-      const scaledPercent = this.scalePercent(
-        data.progressPercent,
-        options.minPercent,
-        options.maxPercent
-      );
-      let formattedMessage = data.message;
-      if (logPrefix && !formattedMessage.startsWith(logPrefix)) {
-        formattedMessage = `${logPrefix}: ${formattedMessage}`;
-      }
-      this.report({
-        stage: data.stage,
-        message: formattedMessage,
-        progressPercent: scaledPercent,
-        details: data.details
-      });
-    });
-    return subReporter;
-  }
-  report(data) {
-    const rawPercent = data.progressPercent;
-    const percent = Math.max(0, Math.min(100, rawPercent));
-    const scaledPercent = this.scalePercent(percent, 0, 100);
-    const now = Date.now();
-    if (scaledPercent === this.lastReportedPercent && now - this.lastReportedTime < this.throttleMs && data.stage !== "completed" && data.stage !== "failed") {
-      return;
-    }
-    this.lastReportedPercent = scaledPercent;
-    this.lastReportedTime = now;
-    const progressData = {
-      ...data,
-      progressPercent: scaledPercent
-    };
-    if (this.logProgress) {
-      this.logger.debug(
-        `[${this.module}] [${data.stage.toUpperCase()}] ${data.message} (${scaledPercent.toFixed(1)}%)`,
-        data.details
-      );
-    }
-    if (this.callback) {
-      try {
-        this.callback(progressData);
-      } catch (err) {
-        this.logger.warn(`Error in progress callback: ${err}`);
+import { HederaMirrorNode } from "./standards-sdk.es169.js";
+async function accountIdsToExemptKeys(accountIds, network, logger) {
+  const mirrorNode = new HederaMirrorNode(
+    network,
+    logger
+  );
+  const exemptKeys = [];
+  for (const accountId of accountIds) {
+    try {
+      const publicKey = await mirrorNode.getPublicKey(accountId);
+      exemptKeys.push(publicKey);
+    } catch (error) {
+      if (logger) {
+        logger.warn(
+          `Could not get public key for account ${accountId}: ${error}`
+        );
       }
     }
   }
-  scalePercent(percent, sourceMin, sourceMax) {
-    const range = this.maxPercent - this.minPercent;
-    const sourceRange = sourceMax - sourceMin;
-    const scaleFactor = range / sourceRange;
-    return this.minPercent + (percent - sourceMin) * scaleFactor;
-  }
-  preparing(message, percent, details) {
-    this.report({
-      stage: "preparing",
-      message,
-      progressPercent: percent,
-      details
-    });
-  }
-  submitting(message, percent, details) {
-    this.report({
-      stage: "submitting",
-      message,
-      progressPercent: percent,
-      details
-    });
-  }
-  confirming(message, percent, details) {
-    this.report({
-      stage: "confirming",
-      message,
-      progressPercent: percent,
-      details
-    });
-  }
-  verifying(message, percent, details) {
-    this.report({
-      stage: "verifying",
-      message,
-      progressPercent: percent,
-      details
-    });
-  }
-  completed(message, details) {
-    this.report({ stage: "completed", message, progressPercent: 100, details });
-  }
-  failed(message, details) {
-    this.report({
-      stage: "failed",
-      message,
-      progressPercent: this.lastReportedPercent,
-      details
-    });
-  }
+  return exemptKeys;
 }
 export {
-  ProgressReporter
+  accountIdsToExemptKeys
 };
 //# sourceMappingURL=standards-sdk.es150.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es150.js","sources":["../../src/utils/progress-reporter.ts"],"sourcesContent":["import { Logger, ILogger } from './logger';\n\nexport type ProgressStage =\n  | 'preparing'\n  | 'submitting'\n  | 'confirming'\n  | 'verifying'\n  | 'completed'\n  | 'failed';\n\nexport interface ProgressData {\n  stage: ProgressStage;\n  message: string;\n  progressPercent: number;\n  details?: Record<string, any>;\n}\n\nexport type ProgressCallback = (data: ProgressData) => void;\n\nexport interface ProgressReporterOptions {\n  module?: string;\n  callback?: ProgressCallback;\n  logger?: ILogger;\n  logProgress?: boolean;\n  minPercent?: number;\n  maxPercent?: number;\n}\n\n/**\n * ProgressReporter is a singleton class that reports progress of a task.\n * Can be used in a generalized fashion.\n */\nexport class ProgressReporter {\n  private static instance: ProgressReporter;\n  private module: string;\n  private callback?: ProgressCallback;\n  private logger: ILogger;\n  private logProgress: boolean;\n  private minPercent: number;\n  private maxPercent: number;\n  private lastReportedPercent: number;\n  private lastReportedTime: number;\n  private throttleMs: number;\n\n  constructor(options: ProgressReporterOptions = {}) {\n    this.module = options.module || 'Progress';\n    this.callback = options.callback;\n    this.logger =\n      options.logger ||\n      new Logger({\n        level: 'info',\n        module: 'ProgressReporter',\n      });\n    this.logProgress = options.logProgress ?? true;\n    this.minPercent = options.minPercent ?? 0;\n    this.maxPercent = options.maxPercent ?? 100;\n    this.lastReportedPercent = -1;\n    this.lastReportedTime = 0;\n    this.throttleMs = 100;\n  }\n\n  static getInstance(options: ProgressReporterOptions = {}): ProgressReporter {\n    if (!ProgressReporter.instance) {\n      ProgressReporter.instance = new ProgressReporter(options);\n    } else {\n      if (options.callback) {\n        ProgressReporter.instance.setCallback(options.callback);\n      }\n      if (options.module) {\n        ProgressReporter.instance.setModule(options.module);\n      }\n      if (options.logger) {\n        ProgressReporter.instance.setLogger(options.logger);\n      }\n      if (options.minPercent !== undefined) {\n        ProgressReporter.instance.setMinPercent(options.minPercent);\n      }\n      if (options.maxPercent !== undefined) {\n        ProgressReporter.instance.setMaxPercent(options.maxPercent);\n      }\n    }\n    return ProgressReporter.instance;\n  }\n\n  setCallback(callback: ProgressCallback): void {\n    this.callback = callback;\n  }\n\n  setModule(module: string): void {\n    this.module = module;\n  }\n\n  setLogger(logger: ILogger): void {\n    this.logger = logger;\n  }\n\n  setMinPercent(minPercent: number): void {\n    this.minPercent = minPercent;\n  }\n\n  setMaxPercent(maxPercent: number): void {\n    this.maxPercent = maxPercent;\n  }\n\n  createSubProgress(options: {\n    minPercent: number;\n    maxPercent: number;\n    logPrefix?: string;\n  }): ProgressReporter {\n    const subReporter = new ProgressReporter({\n      module: this.module,\n      logger: this.logger,\n      logProgress: this.logProgress,\n      minPercent: options.minPercent,\n      maxPercent: options.maxPercent,\n    });\n\n    const logPrefix = options.logPrefix || '';\n\n    subReporter.setCallback(data => {\n      const scaledPercent = this.scalePercent(\n        data.progressPercent,\n        options.minPercent,\n        options.maxPercent,\n      );\n\n      let formattedMessage = data.message;\n      if (logPrefix && !formattedMessage.startsWith(logPrefix)) {\n        formattedMessage = `${logPrefix}: ${formattedMessage}`;\n      }\n\n      this.report({\n        stage: data.stage,\n        message: formattedMessage,\n        progressPercent: scaledPercent,\n        details: data.details,\n      });\n    });\n\n    return subReporter;\n  }\n\n  report(data: ProgressData): void {\n    const rawPercent = data.progressPercent;\n    const percent = Math.max(0, Math.min(100, rawPercent));\n\n    const scaledPercent = this.scalePercent(percent, 0, 100);\n\n    const now = Date.now();\n    if (\n      scaledPercent === this.lastReportedPercent &&\n      now - this.lastReportedTime < this.throttleMs &&\n      data.stage !== 'completed' &&\n      data.stage !== 'failed'\n    ) {\n      return;\n    }\n\n    this.lastReportedPercent = scaledPercent;\n    this.lastReportedTime = now;\n\n    const progressData = {\n      ...data,\n      progressPercent: scaledPercent,\n    };\n\n    if (this.logProgress) {\n      this.logger.debug(\n        `[${this.module}] [${data.stage.toUpperCase()}] ${\n          data.message\n        } (${scaledPercent.toFixed(1)}%)`,\n        data.details,\n      );\n    }\n\n    if (this.callback) {\n      try {\n        this.callback(progressData);\n      } catch (err) {\n        this.logger.warn(`Error in progress callback: ${err}`);\n      }\n    }\n  }\n\n  private scalePercent(\n    percent: number,\n    sourceMin: number,\n    sourceMax: number,\n  ): number {\n    const range = this.maxPercent - this.minPercent;\n    const sourceRange = sourceMax - sourceMin;\n    const scaleFactor = range / sourceRange;\n\n    return this.minPercent + (percent - sourceMin) * scaleFactor;\n  }\n\n  preparing(\n    message: string,\n    percent: number,\n    details?: Record<string, any>,\n  ): void {\n    this.report({\n      stage: 'preparing',\n      message,\n      progressPercent: percent,\n      details,\n    });\n  }\n\n  submitting(\n    message: string,\n    percent: number,\n    details?: Record<string, any>,\n  ): void {\n    this.report({\n      stage: 'submitting',\n      message,\n      progressPercent: percent,\n      details,\n    });\n  }\n\n  confirming(\n    message: string,\n    percent: number,\n    details?: Record<string, any>,\n  ): void {\n    this.report({\n      stage: 'confirming',\n      message,\n      progressPercent: percent,\n      details,\n    });\n  }\n\n  verifying(\n    message: string,\n    percent: number,\n    details?: Record<string, any>,\n  ): void {\n    this.report({\n      stage: 'verifying',\n      message,\n      progressPercent: percent,\n      details,\n    });\n  }\n\n  completed(message: string, details?: Record<string, any>): void {\n    this.report({ stage: 'completed', message, progressPercent: 100, details });\n  }\n\n  failed(message: string, details?: Record<string, any>): void {\n    this.report({\n      stage: 'failed',\n      message,\n      progressPercent: this.lastReportedPercent,\n      details,\n    });\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es150.js","sources":["../../src/utils/topic-fee-utils.ts"],"sourcesContent":["import { PublicKey } from '@hashgraph/sdk';\nimport { ILogger } from './logger';\nimport { HederaMirrorNode } from '../services/mirror-node';\n\n/**\n * Converts account IDs to public keys for fee exemption\n * @param client Hedera client instance\n * @param accountIds Array of account IDs to convert to public keys\n * @param network The network to use for retrieving public keys\n * @param logger Optional logger instance\n * @returns Array of public keys\n */\nexport async function accountIdsToExemptKeys(\n  accountIds: string[],\n  network: string,\n  logger?: ILogger,\n): Promise<PublicKey[]> {\n  const mirrorNode = new HederaMirrorNode(\n    network as 'mainnet' | 'testnet',\n    logger,\n  );\n  const exemptKeys: PublicKey[] = [];\n\n  for (const accountId of accountIds) {\n    try {\n      const publicKey = await mirrorNode.getPublicKey(accountId);\n      exemptKeys.push(publicKey);\n    } catch (error) {\n      if (logger) {\n        logger.warn(\n          `Could not get public key for account ${accountId}: ${error}`,\n        );\n      }\n    }\n  }\n\n  return exemptKeys;\n}\n"],"names":[],"mappings":";AAYA,eAAsB,uBACpB,YACA,SACA,QACsB;AACtB,QAAM,aAAa,IAAI;AAAA,IACrB;AAAA,IACA;AAAA,EAAA;AAEF,QAAM,aAA0B,CAAA;AAEhC,aAAW,aAAa,YAAY;AAClC,QAAI;AACF,YAAM,YAAY,MAAM,WAAW,aAAa,SAAS;AACzD,iBAAW,KAAK,SAAS;AAAA,IAC3B,SAAS,OAAO;AACd,UAAI,QAAQ;AACV,eAAO;AAAA,UACL,wCAAwC,SAAS,KAAK,KAAK;AAAA,QAAA;AAAA,MAE/D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;"}

package/dist/es/standards-sdk.es151.js

@@ -1,205 +1,163 @@
-import axios from "axios";
-import { Logger } from "./standards-sdk.es147.js";
-import { HederaMirrorNode } from "./standards-sdk.es168.js";
-import "buffer";
-import "@noble/curves/secp256k1.js";
-import "zod";
-import "./standards-sdk.es177.js";
-import "./standards-sdk.es171.js";
-import "./standards-sdk.es175.js";
-class HRLResolver {
-  constructor(logLevel = "info") {
-    this.defaultEndpoint = "https://kiloscribe.com/api/inscription-cdn";
-    this.logger = Logger.getInstance({
-      level: logLevel,
-      module: "HRLResolver"
+import { Logger } from "./standards-sdk.es148.js";
+class ProgressReporter {
+  constructor(options = {}) {
+    this.module = options.module || "Progress";
+    this.callback = options.callback;
+    this.logger = options.logger || new Logger({
+      level: "info",
+      module: "ProgressReporter"
     });
+    this.logProgress = options.logProgress ?? true;
+    this.minPercent = options.minPercent ?? 0;
+    this.maxPercent = options.maxPercent ?? 100;
+    this.lastReportedPercent = -1;
+    this.lastReportedTime = 0;
+    this.throttleMs = 100;
   }
-  /**
-   * Determines if a MIME type represents binary content
-   */
-  isBinaryContentType(mimeType) {
-    const binaryTypes = [
-      "image/",
-      "audio/",
-      "video/",
-      "application/octet-stream",
-      "application/pdf",
-      "application/zip",
-      "application/gzip",
-      "application/x-binary",
-      "application/vnd.ms-",
-      "application/x-msdownload",
-      "application/x-shockwave-flash",
-      "font/",
-      "application/wasm"
-    ];
-    return binaryTypes.some((prefix) => mimeType.startsWith(prefix));
-  }
-  /**
-   * Parses an HRL string into its components
-   */
-  parseHRL(hrl) {
-    if (!hrl) {
-      return null;
-    }
-    const hrlPattern = /^hcs:\/\/(\d+)\/([0-9]+\.[0-9]+\.[0-9]+)$/;
-    const match = hrl.match(hrlPattern);
-    if (!match) {
-      return null;
+  static getInstance(options = {}) {
+    if (!ProgressReporter.instance) {
+      ProgressReporter.instance = new ProgressReporter(options);
+    } else {
+      if (options.callback) {
+        ProgressReporter.instance.setCallback(options.callback);
+      }
+      if (options.module) {
+        ProgressReporter.instance.setModule(options.module);
+      }
+      if (options.logger) {
+        ProgressReporter.instance.setLogger(options.logger);
+      }
+      if (options.minPercent !== void 0) {
+        ProgressReporter.instance.setMinPercent(options.minPercent);
+      }
+      if (options.maxPercent !== void 0) {
+        ProgressReporter.instance.setMaxPercent(options.maxPercent);
+      }
     }
-    return {
-      standard: match[1],
-      topicId: match[2]
-    };
+    return ProgressReporter.instance;
   }
-  /**
-   * Validates if a string is a valid HRL
-   */
-  isValidHRL(hrl) {
-    if (!hrl || typeof hrl !== "string") {
-      return false;
-    }
-    const parsed = this.parseHRL(hrl);
-    if (!parsed) {
-      return false;
-    }
-    const topicIdPattern = /^[0-9]+\.[0-9]+\.[0-9]+$/;
-    if (!topicIdPattern.test(parsed.topicId)) {
-      return false;
-    }
-    return true;
-  }
-  /**
-   * Validates if a string is a valid topic ID
-   */
-  isValidTopicId(topicId) {
-    const topicIdPattern = /^[0-9]+\.[0-9]+\.[0-9]+$/;
-    return topicIdPattern.test(topicId);
-  }
-  /**
-   * Resolves content from either an HRL or a topic ID
-   * If a topic ID is provided, it queries the topic memo to determine the HCS standard
-   */
-  async resolve(hrlOrTopicId, options) {
-    if (this.isValidHRL(hrlOrTopicId)) {
-      return this.resolveHRL(hrlOrTopicId, options);
-    }
-    if (!this.isValidTopicId(hrlOrTopicId)) {
-      throw new Error(`Invalid HRL or topic ID format: ${hrlOrTopicId}`);
-    }
-    try {
-      const mirrorNode = new HederaMirrorNode(options.network, this.logger);
-      const topicInfo = await mirrorNode.getTopicInfo(hrlOrTopicId);
-      const memo = topicInfo?.memo || "";
-      let standard = "1";
-      if (memo) {
-        const hcsMatch = memo.match(/^hcs-(\d+)/);
-        if (hcsMatch && hcsMatch[1]) {
-          standard = hcsMatch[1];
-        }
-      }
-      const hrl = `hcs://${standard}/${hrlOrTopicId}`;
-      return this.resolveHRL(hrl, options);
-    } catch (error) {
-      this.logger.error(
-        `Failed to get topic info for ${hrlOrTopicId}: ${error.message}`
+  setCallback(callback) {
+    this.callback = callback;
+  }
+  setModule(module) {
+    this.module = module;
+  }
+  setLogger(logger) {
+    this.logger = logger;
+  }
+  setMinPercent(minPercent) {
+    this.minPercent = minPercent;
+  }
+  setMaxPercent(maxPercent) {
+    this.maxPercent = maxPercent;
+  }
+  createSubProgress(options) {
+    const subReporter = new ProgressReporter({
+      module: this.module,
+      logger: this.logger,
+      logProgress: this.logProgress,
+      minPercent: options.minPercent,
+      maxPercent: options.maxPercent
+    });
+    const logPrefix = options.logPrefix || "";
+    subReporter.setCallback((data) => {
+      const scaledPercent = this.scalePercent(
+        data.progressPercent,
+        options.minPercent,
+        options.maxPercent
       );
-      const hrl = `hcs://1/${hrlOrTopicId}`;
-      return this.resolveHRL(hrl, options);
-    }
+      let formattedMessage = data.message;
+      if (logPrefix && !formattedMessage.startsWith(logPrefix)) {
+        formattedMessage = `${logPrefix}: ${formattedMessage}`;
+      }
+      this.report({
+        stage: data.stage,
+        message: formattedMessage,
+        progressPercent: scaledPercent,
+        details: data.details
+      });
+    });
+    return subReporter;
   }
-  async getContentWithType(hrl, options) {
-    if (!this.isValidHRL(hrl)) {
-      return {
-        content: hrl,
-        contentType: "text/plain",
-        isBinary: false
-      };
-    }
-    try {
-      const result = await this.resolveHRL(hrl, options);
-      return {
-        content: result.content,
-        contentType: result.contentType,
-        isBinary: result.isBinary
-      };
-    } catch (e) {
-      const error = e;
-      const logMessage = `Error resolving HRL for content and type: ${error.message}`;
-      this.logger.error(logMessage);
-      throw new Error(logMessage);
+  report(data) {
+    const rawPercent = data.progressPercent;
+    const percent = Math.max(0, Math.min(100, rawPercent));
+    const scaledPercent = this.scalePercent(percent, 0, 100);
+    const now = Date.now();
+    if (scaledPercent === this.lastReportedPercent && now - this.lastReportedTime < this.throttleMs && data.stage !== "completed" && data.stage !== "failed") {
+      return;
     }
-  }
-  /**
-   * Resolves HRL content with proper content type detection
-   */
-  async resolveHRL(hrl, options) {
-    const parsed = this.parseHRL(hrl);
-    if (!parsed) {
-      throw new Error(`Invalid HRL format: ${hrl}`);
+    this.lastReportedPercent = scaledPercent;
+    this.lastReportedTime = now;
+    const progressData = {
+      ...data,
+      progressPercent: scaledPercent
+    };
+    if (this.logProgress) {
+      this.logger.debug(
+        `[${this.module}] [${data.stage.toUpperCase()}] ${data.message} (${scaledPercent.toFixed(1)}%)`,
+        data.details
+      );
     }
-    const { standard, topicId } = parsed;
-    this.logger.debug(
-      `Resolving HRL reference: standard=${standard}, topicId=${topicId}`
-    );
-    try {
-      const cdnEndpoint = options.cdnEndpoint || this.defaultEndpoint;
-      const cdnUrl = `${cdnEndpoint}/${topicId}?network=${options.network}`;
-      this.logger.debug(`Fetching content from CDN: ${cdnUrl}`);
-      const headResponse = await axios.head(cdnUrl);
-      const contentType = headResponse.headers["content-type"] || "";
-      const isBinary = this.isBinaryContentType(contentType);
-      if (isBinary || options.returnRaw) {
-        const response2 = await axios.get(cdnUrl, {
-          responseType: "arraybuffer"
-        });
-        return {
-          content: response2.data,
-          contentType,
-          topicId,
-          isBinary: true
-        };
+    if (this.callback) {
+      try {
+        this.callback(progressData);
+      } catch (err) {
+        this.logger.warn(`Error in progress callback: ${err}`);
       }
-      if (contentType === "application/json") {
-        const response2 = await axios.get(cdnUrl, {
-          responseType: "json"
-        });
-        if (!response2.data) {
-          throw new Error(`Failed to fetch content from topic: ${topicId}`);
-        }
-        return {
-          content: response2.data,
-          contentType,
-          topicId,
-          isBinary: false
-        };
-      }
-      const response = await axios.get(cdnUrl);
-      if (!response.data) {
-        throw new Error(`Failed to fetch content from topic: ${topicId}`);
-      }
-      let content;
-      if (typeof response.data === "object") {
-        content = response.data.content || response.data.text || JSON.stringify(response.data);
-      } else {
-        content = response.data;
-      }
-      return {
-        content,
-        contentType,
-        topicId,
-        isBinary: false
-      };
-    } catch (e) {
-      const error = e;
-      const logMessage = `Error resolving HRL reference: ${error.message}`;
-      this.logger.error(logMessage);
-      throw new Error(logMessage);
     }
   }
+  scalePercent(percent, sourceMin, sourceMax) {
+    const range = this.maxPercent - this.minPercent;
+    const sourceRange = sourceMax - sourceMin;
+    const scaleFactor = range / sourceRange;
+    return this.minPercent + (percent - sourceMin) * scaleFactor;
+  }
+  preparing(message, percent, details) {
+    this.report({
+      stage: "preparing",
+      message,
+      progressPercent: percent,
+      details
+    });
+  }
+  submitting(message, percent, details) {
+    this.report({
+      stage: "submitting",
+      message,
+      progressPercent: percent,
+      details
+    });
+  }
+  confirming(message, percent, details) {
+    this.report({
+      stage: "confirming",
+      message,
+      progressPercent: percent,
+      details
+    });
+  }
+  verifying(message, percent, details) {
+    this.report({
+      stage: "verifying",
+      message,
+      progressPercent: percent,
+      details
+    });
+  }
+  completed(message, details) {
+    this.report({ stage: "completed", message, progressPercent: 100, details });
+  }
+  failed(message, details) {
+    this.report({
+      stage: "failed",
+      message,
+      progressPercent: this.lastReportedPercent,
+      details
+    });
+  }
 }
 export {
-  HRLResolver
+  ProgressReporter
 };
 //# sourceMappingURL=standards-sdk.es151.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es151.js","sources":["../../src/utils/hrl-resolver.ts"],"sourcesContent":["import axios from 'axios';\nimport { Logger, LogLevel, ILogger } from './logger';\nimport { NetworkType } from './types';\nimport { HederaMirrorNode } from '../services';\n\n/**\n * Options for HRL resolution\n */\nexport interface HRLResolutionOptions {\n  network: NetworkType;\n  returnRaw?: boolean;\n  cdnEndpoint?: string;\n}\n\n/**\n * Result of an HRL resolution operation\n */\nexport interface HRLResolutionResult {\n  content: string | ArrayBuffer;\n  contentType: string;\n  topicId: string;\n  isBinary: boolean;\n}\n\nexport interface ContentWithType {\n  content: string | ArrayBuffer;\n  contentType: string;\n  isBinary: boolean;\n}\n\n/**\n * Utility class for resolving Hedera Resource Locators across the SDK\n */\nexport class HRLResolver {\n  private logger: ILogger;\n  private defaultEndpoint = 'https://kiloscribe.com/api/inscription-cdn';\n\n  constructor(logLevel: LogLevel = 'info') {\n    this.logger = Logger.getInstance({\n      level: logLevel,\n      module: 'HRLResolver',\n    });\n  }\n\n  /**\n   * Determines if a MIME type represents binary content\n   */\n  private isBinaryContentType(mimeType: string): boolean {\n    const binaryTypes = [\n      'image/',\n      'audio/',\n      'video/',\n      'application/octet-stream',\n      'application/pdf',\n      'application/zip',\n      'application/gzip',\n      'application/x-binary',\n      'application/vnd.ms-',\n      'application/x-msdownload',\n      'application/x-shockwave-flash',\n      'font/',\n      'application/wasm',\n    ];\n\n    return binaryTypes.some(prefix => mimeType.startsWith(prefix));\n  }\n\n  /**\n   * Parses an HRL string into its components\n   */\n  public parseHRL(hrl: string): { standard: string; topicId: string } | null {\n    if (!hrl) {\n      return null;\n    }\n\n    const hrlPattern = /^hcs:\\/\\/(\\d+)\\/([0-9]+\\.[0-9]+\\.[0-9]+)$/;\n    const match = hrl.match(hrlPattern);\n\n    if (!match) {\n      return null;\n    }\n\n    return {\n      standard: match[1],\n      topicId: match[2],\n    };\n  }\n\n  /**\n   * Validates if a string is a valid HRL\n   */\n  public isValidHRL(hrl: string): boolean {\n    if (!hrl || typeof hrl !== 'string') {\n      return false;\n    }\n\n    const parsed = this.parseHRL(hrl);\n    if (!parsed) {\n      return false;\n    }\n\n    const topicIdPattern = /^[0-9]+\\.[0-9]+\\.[0-9]+$/;\n    if (!topicIdPattern.test(parsed.topicId)) {\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * Validates if a string is a valid topic ID\n   */\n  public isValidTopicId(topicId: string): boolean {\n    const topicIdPattern = /^[0-9]+\\.[0-9]+\\.[0-9]+$/;\n    return topicIdPattern.test(topicId);\n  }\n\n  /**\n   * Resolves content from either an HRL or a topic ID\n   * If a topic ID is provided, it queries the topic memo to determine the HCS standard\n   */\n  public async resolve(\n    hrlOrTopicId: string,\n    options: HRLResolutionOptions,\n  ): Promise<HRLResolutionResult> {\n    if (this.isValidHRL(hrlOrTopicId)) {\n      return this.resolveHRL(hrlOrTopicId, options);\n    }\n\n    if (!this.isValidTopicId(hrlOrTopicId)) {\n      throw new Error(`Invalid HRL or topic ID format: ${hrlOrTopicId}`);\n    }\n\n    try {\n      const mirrorNode = new HederaMirrorNode(options.network, this.logger);\n      const topicInfo = await mirrorNode.getTopicInfo(hrlOrTopicId);\n      const memo = topicInfo?.memo || '';\n\n      let standard = '1';\n      if (memo) {\n        const hcsMatch = memo.match(/^hcs-(\\d+)/);\n        if (hcsMatch && hcsMatch[1]) {\n          standard = hcsMatch[1];\n        }\n      }\n\n      const hrl = `hcs://${standard}/${hrlOrTopicId}`;\n      return this.resolveHRL(hrl, options);\n    } catch (error: any) {\n      this.logger.error(\n        `Failed to get topic info for ${hrlOrTopicId}: ${error.message}`,\n      );\n      const hrl = `hcs://1/${hrlOrTopicId}`;\n      return this.resolveHRL(hrl, options);\n    }\n  }\n\n  public async getContentWithType(\n    hrl: string,\n    options: HRLResolutionOptions,\n  ): Promise<ContentWithType> {\n    if (!this.isValidHRL(hrl)) {\n      return {\n        content: hrl,\n        contentType: 'text/plain',\n        isBinary: false,\n      };\n    }\n\n    try {\n      const result = await this.resolveHRL(hrl, options);\n      return {\n        content: result.content,\n        contentType: result.contentType,\n        isBinary: result.isBinary,\n      };\n    } catch (e: any) {\n      const error = e as Error;\n      const logMessage = `Error resolving HRL for content and type: ${error.message}`;\n      this.logger.error(logMessage);\n      throw new Error(logMessage);\n    }\n  }\n\n  /**\n   * Resolves HRL content with proper content type detection\n   */\n  public async resolveHRL(\n    hrl: string,\n    options: HRLResolutionOptions,\n  ): Promise<HRLResolutionResult> {\n    const parsed = this.parseHRL(hrl);\n\n    if (!parsed) {\n      throw new Error(`Invalid HRL format: ${hrl}`);\n    }\n\n    const { standard, topicId } = parsed;\n\n    this.logger.debug(\n      `Resolving HRL reference: standard=${standard}, topicId=${topicId}`,\n    );\n\n    try {\n      const cdnEndpoint = options.cdnEndpoint || this.defaultEndpoint;\n      const cdnUrl = `${cdnEndpoint}/${topicId}?network=${options.network}`;\n\n      this.logger.debug(`Fetching content from CDN: ${cdnUrl}`);\n      const headResponse = await axios.head(cdnUrl);\n      const contentType = headResponse.headers['content-type'] || '';\n      const isBinary = this.isBinaryContentType(contentType);\n\n      if (isBinary || options.returnRaw) {\n        const response = await axios.get(cdnUrl, {\n          responseType: 'arraybuffer',\n        });\n\n        return {\n          content: response.data,\n          contentType,\n          topicId,\n          isBinary: true,\n        };\n      }\n\n      if (contentType === 'application/json') {\n        const response = await axios.get(cdnUrl, {\n          responseType: 'json',\n        });\n\n        if (!response.data) {\n          throw new Error(`Failed to fetch content from topic: ${topicId}`);\n        }\n\n        return {\n          content: response.data,\n          contentType,\n          topicId,\n          isBinary: false,\n        };\n      }\n\n      const response = await axios.get(cdnUrl);\n\n      if (!response.data) {\n        throw new Error(`Failed to fetch content from topic: ${topicId}`);\n      }\n\n      let content: string;\n\n      if (typeof response.data === 'object') {\n        content =\n          response.data.content ||\n          response.data.text ||\n          JSON.stringify(response.data);\n      } else {\n        content = response.data;\n      }\n\n      return {\n        content,\n        contentType,\n        topicId,\n        isBinary: false,\n      };\n    } catch (e: any) {\n      const error = e as Error;\n      const logMessage = `Error resolving HRL reference: ${error.message}`;\n      this.logger.error(logMessage);\n      throw new Error(logMessage);\n    }\n  }\n}\n"],"names":["response"],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es151.js","sources":["../../src/utils/progress-reporter.ts"],"sourcesContent":["import { Logger, ILogger } from './logger';\n\nexport type ProgressStage =\n  | 'preparing'\n  | 'submitting'\n  | 'confirming'\n  | 'verifying'\n  | 'completed'\n  | 'failed';\n\nexport interface ProgressData {\n  stage: ProgressStage;\n  message: string;\n  progressPercent: number;\n  details?: Record<string, any>;\n}\n\nexport type ProgressCallback = (data: ProgressData) => void;\n\nexport interface ProgressReporterOptions {\n  module?: string;\n  callback?: ProgressCallback;\n  logger?: ILogger;\n  logProgress?: boolean;\n  minPercent?: number;\n  maxPercent?: number;\n}\n\n/**\n * ProgressReporter is a singleton class that reports progress of a task.\n * Can be used in a generalized fashion.\n */\nexport class ProgressReporter {\n  private static instance: ProgressReporter;\n  private module: string;\n  private callback?: ProgressCallback;\n  private logger: ILogger;\n  private logProgress: boolean;\n  private minPercent: number;\n  private maxPercent: number;\n  private lastReportedPercent: number;\n  private lastReportedTime: number;\n  private throttleMs: number;\n\n  constructor(options: ProgressReporterOptions = {}) {\n    this.module = options.module || 'Progress';\n    this.callback = options.callback;\n    this.logger =\n      options.logger ||\n      new Logger({\n        level: 'info',\n        module: 'ProgressReporter',\n      });\n    this.logProgress = options.logProgress ?? true;\n    this.minPercent = options.minPercent ?? 0;\n    this.maxPercent = options.maxPercent ?? 100;\n    this.lastReportedPercent = -1;\n    this.lastReportedTime = 0;\n    this.throttleMs = 100;\n  }\n\n  static getInstance(options: ProgressReporterOptions = {}): ProgressReporter {\n    if (!ProgressReporter.instance) {\n      ProgressReporter.instance = new ProgressReporter(options);\n    } else {\n      if (options.callback) {\n        ProgressReporter.instance.setCallback(options.callback);\n      }\n      if (options.module) {\n        ProgressReporter.instance.setModule(options.module);\n      }\n      if (options.logger) {\n        ProgressReporter.instance.setLogger(options.logger);\n      }\n      if (options.minPercent !== undefined) {\n        ProgressReporter.instance.setMinPercent(options.minPercent);\n      }\n      if (options.maxPercent !== undefined) {\n        ProgressReporter.instance.setMaxPercent(options.maxPercent);\n      }\n    }\n    return ProgressReporter.instance;\n  }\n\n  setCallback(callback: ProgressCallback): void {\n    this.callback = callback;\n  }\n\n  setModule(module: string): void {\n    this.module = module;\n  }\n\n  setLogger(logger: ILogger): void {\n    this.logger = logger;\n  }\n\n  setMinPercent(minPercent: number): void {\n    this.minPercent = minPercent;\n  }\n\n  setMaxPercent(maxPercent: number): void {\n    this.maxPercent = maxPercent;\n  }\n\n  createSubProgress(options: {\n    minPercent: number;\n    maxPercent: number;\n    logPrefix?: string;\n  }): ProgressReporter {\n    const subReporter = new ProgressReporter({\n      module: this.module,\n      logger: this.logger,\n      logProgress: this.logProgress,\n      minPercent: options.minPercent,\n      maxPercent: options.maxPercent,\n    });\n\n    const logPrefix = options.logPrefix || '';\n\n    subReporter.setCallback(data => {\n      const scaledPercent = this.scalePercent(\n        data.progressPercent,\n        options.minPercent,\n        options.maxPercent,\n      );\n\n      let formattedMessage = data.message;\n      if (logPrefix && !formattedMessage.startsWith(logPrefix)) {\n        formattedMessage = `${logPrefix}: ${formattedMessage}`;\n      }\n\n      this.report({\n        stage: data.stage,\n        message: formattedMessage,\n        progressPercent: scaledPercent,\n        details: data.details,\n      });\n    });\n\n    return subReporter;\n  }\n\n  report(data: ProgressData): void {\n    const rawPercent = data.progressPercent;\n    const percent = Math.max(0, Math.min(100, rawPercent));\n\n    const scaledPercent = this.scalePercent(percent, 0, 100);\n\n    const now = Date.now();\n    if (\n      scaledPercent === this.lastReportedPercent &&\n      now - this.lastReportedTime < this.throttleMs &&\n      data.stage !== 'completed' &&\n      data.stage !== 'failed'\n    ) {\n      return;\n    }\n\n    this.lastReportedPercent = scaledPercent;\n    this.lastReportedTime = now;\n\n    const progressData = {\n      ...data,\n      progressPercent: scaledPercent,\n    };\n\n    if (this.logProgress) {\n      this.logger.debug(\n        `[${this.module}] [${data.stage.toUpperCase()}] ${\n          data.message\n        } (${scaledPercent.toFixed(1)}%)`,\n        data.details,\n      );\n    }\n\n    if (this.callback) {\n      try {\n        this.callback(progressData);\n      } catch (err) {\n        this.logger.warn(`Error in progress callback: ${err}`);\n      }\n    }\n  }\n\n  private scalePercent(\n    percent: number,\n    sourceMin: number,\n    sourceMax: number,\n  ): number {\n    const range = this.maxPercent - this.minPercent;\n    const sourceRange = sourceMax - sourceMin;\n    const scaleFactor = range / sourceRange;\n\n    return this.minPercent + (percent - sourceMin) * scaleFactor;\n  }\n\n  preparing(\n    message: string,\n    percent: number,\n    details?: Record<string, any>,\n  ): void {\n    this.report({\n      stage: 'preparing',\n      message,\n      progressPercent: percent,\n      details,\n    });\n  }\n\n  submitting(\n    message: string,\n    percent: number,\n    details?: Record<string, any>,\n  ): void {\n    this.report({\n      stage: 'submitting',\n      message,\n      progressPercent: percent,\n      details,\n    });\n  }\n\n  confirming(\n    message: string,\n    percent: number,\n    details?: Record<string, any>,\n  ): void {\n    this.report({\n      stage: 'confirming',\n      message,\n      progressPercent: percent,\n      details,\n    });\n  }\n\n  verifying(\n    message: string,\n    percent: number,\n    details?: Record<string, any>,\n  ): void {\n    this.report({\n      stage: 'verifying',\n      message,\n      progressPercent: percent,\n      details,\n    });\n  }\n\n  completed(message: string, details?: Record<string, any>): void {\n    this.report({ stage: 'completed', message, progressPercent: 100, details });\n  }\n\n  failed(message: string, details?: Record<string, any>): void {\n    this.report({\n      stage: 'failed',\n      message,\n      progressPercent: this.lastReportedPercent,\n      details,\n    });\n  }\n}\n"],"names":[],"mappings":"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"}