@hashgraphonline/standards-sdk 0.1.137 → 0.1.138

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

@@ -1,16 +1,163 @@
-function getTopicId(inscription) {
-  if (!inscription || typeof inscription !== "object") return void 0;
-  const obj = inscription;
-  const direct = obj.topicId || obj.topic_id;
-  if (typeof direct === "string" && direct.trim()) return direct;
-  const rec = obj;
-  const t1 = rec["topicId"];
-  if (typeof t1 === "string" && t1.trim()) return t1;
-  const t2 = rec["topic_id"];
-  if (typeof t2 === "string" && t2.trim()) return t2;
-  return void 0;
+import { Logger } from "./standards-sdk.es105.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}`);
+      }
+    }
+  }
+  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 {
-  getTopicId
+  ProgressReporter
 };
 //# sourceMappingURL=standards-sdk.es108.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es108.js","sources":["../../src/utils/topic-id-utils.ts"],"sourcesContent":["/**\n * Utility functions for safely handling topic ID properties that may use different naming conventions\n */\n\n/**\n * Safely extracts topic ID from an inscription result object that may have either `topicId` or `topic_id`\n * @param inscription - The inscription result object\n * @returns The topic ID string or undefined if not found\n */\ntype TopicIdCarrier =\n  | { topicId?: string; topic_id?: string }\n  | Record<string, unknown>\n  | null\n  | undefined;\n\nexport function getTopicId(inscription: unknown): string | undefined {\n  if (!inscription || typeof inscription !== 'object') return undefined;\n  const obj = inscription as TopicIdCarrier;\n  const direct =\n    (obj as { topicId?: string }).topicId ||\n    (obj as { topic_id?: string }).topic_id;\n  if (typeof direct === 'string' && direct.trim()) return direct;\n  const rec = obj as Record<string, unknown>;\n  const t1 = rec['topicId'];\n  if (typeof t1 === 'string' && t1.trim()) return t1;\n  const t2 = rec['topic_id'];\n  if (typeof t2 === 'string' && t2.trim()) return t2;\n  return undefined;\n}\n"],"names":[],"mappings":"AAeO,SAAS,WAAW,aAA0C;AACnE,MAAI,CAAC,eAAe,OAAO,gBAAgB,SAAU,QAAO;AAC5D,QAAM,MAAM;AACZ,QAAM,SACH,IAA6B,WAC7B,IAA8B;AACjC,MAAI,OAAO,WAAW,YAAY,OAAO,KAAA,EAAQ,QAAO;AACxD,QAAM,MAAM;AACZ,QAAM,KAAK,IAAI,SAAS;AACxB,MAAI,OAAO,OAAO,YAAY,GAAG,KAAA,EAAQ,QAAO;AAChD,QAAM,KAAK,IAAI,UAAU;AACzB,MAAI,OAAO,OAAO,YAAY,GAAG,KAAA,EAAQ,QAAO;AAChD,SAAO;AACT;"}
+{"version":3,"file":"standards-sdk.es108.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":";AAgCO,MAAM,iBAAiB;AAAA,EAY5B,YAAY,UAAmC,IAAI;AACjD,SAAK,SAAS,QAAQ,UAAU;AAChC,SAAK,WAAW,QAAQ;AACxB,SAAK,SACH,QAAQ,UACR,IAAI,OAAO;AAAA,MACT,OAAO;AAAA,MACP,QAAQ;AAAA,IAAA,CACT;AACH,SAAK,cAAc,QAAQ,eAAe;AAC1C,SAAK,aAAa,QAAQ,cAAc;AACxC,SAAK,aAAa,QAAQ,cAAc;AACxC,SAAK,sBAAsB;AAC3B,SAAK,mBAAmB;AACxB,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,OAAO,YAAY,UAAmC,IAAsB;AAC1E,QAAI,CAAC,iBAAiB,UAAU;AAC9B,uBAAiB,WAAW,IAAI,iBAAiB,OAAO;AAAA,IAC1D,OAAO;AACL,UAAI,QAAQ,UAAU;AACpB,yBAAiB,SAAS,YAAY,QAAQ,QAAQ;AAAA,MACxD;AACA,UAAI,QAAQ,QAAQ;AAClB,yBAAiB,SAAS,UAAU,QAAQ,MAAM;AAAA,MACpD;AACA,UAAI,QAAQ,QAAQ;AAClB,yBAAiB,SAAS,UAAU,QAAQ,MAAM;AAAA,MACpD;AACA,UAAI,QAAQ,eAAe,QAAW;AACpC,yBAAiB,SAAS,cAAc,QAAQ,UAAU;AAAA,MAC5D;AACA,UAAI,QAAQ,eAAe,QAAW;AACpC,yBAAiB,SAAS,cAAc,QAAQ,UAAU;AAAA,MAC5D;AAAA,IACF;AACA,WAAO,iBAAiB;AAAA,EAC1B;AAAA,EAEA,YAAY,UAAkC;AAC5C,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,UAAU,QAAsB;AAC9B,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,UAAU,QAAuB;AAC/B,SAAK,SAAS;AAAA,EAChB;AAAA,EAEA,cAAc,YAA0B;AACtC,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,cAAc,YAA0B;AACtC,SAAK,aAAa;AAAA,EACpB;AAAA,EAEA,kBAAkB,SAIG;AACnB,UAAM,cAAc,IAAI,iBAAiB;AAAA,MACvC,QAAQ,KAAK;AAAA,MACb,QAAQ,KAAK;AAAA,MACb,aAAa,KAAK;AAAA,MAClB,YAAY,QAAQ;AAAA,MACpB,YAAY,QAAQ;AAAA,IAAA,CACrB;AAED,UAAM,YAAY,QAAQ,aAAa;AAEvC,gBAAY,YAAY,CAAA,SAAQ;AAC9B,YAAM,gBAAgB,KAAK;AAAA,QACzB,KAAK;AAAA,QACL,QAAQ;AAAA,QACR,QAAQ;AAAA,MAAA;AAGV,UAAI,mBAAmB,KAAK;AAC5B,UAAI,aAAa,CAAC,iBAAiB,WAAW,SAAS,GAAG;AACxD,2BAAmB,GAAG,SAAS,KAAK,gBAAgB;AAAA,MACtD;AAEA,WAAK,OAAO;AAAA,QACV,OAAO,KAAK;AAAA,QACZ,SAAS;AAAA,QACT,iBAAiB;AAAA,QACjB,SAAS,KAAK;AAAA,MAAA,CACf;AAAA,IACH,CAAC;AAED,WAAO;AAAA,EACT;AAAA,EAEA,OAAO,MAA0B;AAC/B,UAAM,aAAa,KAAK;AACxB,UAAM,UAAU,KAAK,IAAI,GAAG,KAAK,IAAI,KAAK,UAAU,CAAC;AAErD,UAAM,gBAAgB,KAAK,aAAa,SAAS,GAAG,GAAG;AAEvD,UAAM,MAAM,KAAK,IAAA;AACjB,QACE,kBAAkB,KAAK,uBACvB,MAAM,KAAK,mBAAmB,KAAK,cACnC,KAAK,UAAU,eACf,KAAK,UAAU,UACf;AACA;AAAA,IACF;AAEA,SAAK,sBAAsB;AAC3B,SAAK,mBAAmB;AAExB,UAAM,eAAe;AAAA,MACnB,GAAG;AAAA,MACH,iBAAiB;AAAA,IAAA;AAGnB,QAAI,KAAK,aAAa;AACpB,WAAK,OAAO;AAAA,QACV,IAAI,KAAK,MAAM,MAAM,KAAK,MAAM,YAAA,CAAa,KAC3C,KAAK,OACP,KAAK,cAAc,QAAQ,CAAC,CAAC;AAAA,QAC7B,KAAK;AAAA,MAAA;AAAA,IAET;AAEA,QAAI,KAAK,UAAU;AACjB,UAAI;AACF,aAAK,SAAS,YAAY;AAAA,MAC5B,SAAS,KAAK;AACZ,aAAK,OAAO,KAAK,+BAA+B,GAAG,EAAE;AAAA,MACvD;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,aACN,SACA,WACA,WACQ;AACR,UAAM,QAAQ,KAAK,aAAa,KAAK;AACrC,UAAM,cAAc,YAAY;AAChC,UAAM,cAAc,QAAQ;AAE5B,WAAO,KAAK,cAAc,UAAU,aAAa;AAAA,EACnD;AAAA,EAEA,UACE,SACA,SACA,SACM;AACN,SAAK,OAAO;AAAA,MACV,OAAO;AAAA,MACP;AAAA,MACA,iBAAiB;AAAA,MACjB;AAAA,IAAA,CACD;AAAA,EACH;AAAA,EAEA,WACE,SACA,SACA,SACM;AACN,SAAK,OAAO;AAAA,MACV,OAAO;AAAA,MACP;AAAA,MACA,iBAAiB;AAAA,MACjB;AAAA,IAAA,CACD;AAAA,EACH;AAAA,EAEA,WACE,SACA,SACA,SACM;AACN,SAAK,OAAO;AAAA,MACV,OAAO;AAAA,MACP;AAAA,MACA,iBAAiB;AAAA,MACjB;AAAA,IAAA,CACD;AAAA,EACH;AAAA,EAEA,UACE,SACA,SACA,SACM;AACN,SAAK,OAAO;AAAA,MACV,OAAO;AAAA,MACP;AAAA,MACA,iBAAiB;AAAA,MACjB;AAAA,IAAA,CACD;AAAA,EACH;AAAA,EAEA,UAAU,SAAiB,SAAqC;AAC9D,SAAK,OAAO,EAAE,OAAO,aAAa,SAAS,iBAAiB,KAAK,SAAS;AAAA,EAC5E;AAAA,EAEA,OAAO,SAAiB,SAAqC;AAC3D,SAAK,OAAO;AAAA,MACV,OAAO;AAAA,MACP;AAAA,MACA,iBAAiB,KAAK;AAAA,MACtB;AAAA,IAAA,CACD;AAAA,EACH;AACF;"}

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

@@ -1,5 +1,211 @@
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+import axios from "axios";
+import { Logger } from "./standards-sdk.es105.js";
+import { HederaMirrorNode } from "./standards-sdk.es126.js";
+import "node:path";
+import "node:buffer";
+import "node:crypto";
+import "@noble/curves/secp256k1.js";
+import "./standards-sdk.es129.js";
+import "viem/accounts";
+import "viem/chains";
+import "x402-axios";
+import "x402/types";
+import "./standards-sdk.es139.js";
+import "zod";
+import "@hashgraph/sdk";
+class HRLResolver {
+  constructor(logLevel = "info") {
+    this.defaultEndpoint = "https://kiloscribe.com/api/inscription-cdn";
+    this.logger = Logger.getInstance({
+      level: logLevel,
+      module: "HRLResolver"
+    });
+  }
+  /**
+   * 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;
+    }
+    return {
+      standard: match[1],
+      topicId: match[2]
+    };
+  }
+  /**
+   * 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}`
+      );
+      const hrl = `hcs://1/${hrlOrTopicId}`;
+      return this.resolveHRL(hrl, options);
+    }
+  }
+  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);
+    }
+  }
+  /**
+   * 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}`);
+    }
+    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 (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);
+    }
+  }
+}
 export {
-  sleep
+  HRLResolver
 };
 //# sourceMappingURL=standards-sdk.es109.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es109.js","sources":["../../src/utils/sleep.ts"],"sourcesContent":["export const sleep = (ms: number) =>\n  new Promise(resolve => setTimeout(resolve, ms));\n"],"names":[],"mappings":"AAAO,MAAM,QAAQ,CAAC,OACpB,IAAI,QAAQ,CAAA,YAAW,WAAW,SAAS,EAAE,CAAC;"}
+{"version":3,"file":"standards-sdk.es109.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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"}