@hashgraphonline/standards-sdk 0.1.184 → 0.1.185

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

@@ -1,15 +1,108 @@
-import { HCS26BaseClient } from "./standards-sdk.es120.js";
-class HCS26BrowserClient extends HCS26BaseClient {
-  constructor(config) {
-    super({
-      network: config.network,
-      logger: config.logger,
-      mirrorNode: config.mirrorNode,
-      verificationProvider: config.verificationProvider
-    });
+import { z } from "zod";
+import { hcs26TopicTypeEnumSchema, HCS26_PROTOCOL, hcs26OperationEnumSchema } from "./standards-sdk.es120.js";
+const HCS26_DEFAULT_TTL_SECONDS = 86400;
+function toPositiveInt(value) {
+  if (!Number.isFinite(value)) {
+    throw new Error("Expected a finite number");
   }
+  const intValue = Math.floor(value);
+  if (intValue <= 0) {
+    throw new Error("Expected a positive integer");
+  }
+  return intValue;
+}
+function buildHcs26TopicMemo(input) {
+  const indexed = input.indexed ?? true;
+  const ttlSeconds = toPositiveInt(
+    input.ttlSeconds ?? HCS26_DEFAULT_TTL_SECONDS
+  );
+  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);
+  const indexedSegment = indexed ? "0" : "1";
+  return `${HCS26_PROTOCOL}:${indexedSegment}:${ttlSeconds}:${topicType}`;
+}
+function parseHcs26TopicMemo(memoRaw) {
+  const memo = memoRaw.trim();
+  if (!memo) {
+    return null;
+  }
+  const match = memo.match(/^hcs-26:(\d+):(\d+):(\d+)$/);
+  if (!match) {
+    return null;
+  }
+  const indexedSegment = Number(match[1]);
+  const ttlSeconds = Number(match[2]);
+  const topicType = Number(match[3]);
+  if (![indexedSegment, ttlSeconds, topicType].every(Number.isFinite)) {
+    return null;
+  }
+  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);
+  if (!parsedTopicType.success) {
+    return null;
+  }
+  if (indexedSegment !== 0 && indexedSegment !== 1) {
+    return null;
+  }
+  return {
+    protocol: HCS26_PROTOCOL,
+    indexed: indexedSegment === 0,
+    ttlSeconds,
+    topicType: parsedTopicType.data
+  };
+}
+function buildHcs26TransactionMemo(input) {
+  const operation = hcs26OperationEnumSchema.parse(input.operation);
+  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);
+  return `${HCS26_PROTOCOL}:op:${operation}:${topicType}`;
 }
+function parseHcs26TransactionMemo(memoRaw) {
+  const memo = memoRaw.trim();
+  if (!memo) {
+    return null;
+  }
+  const match = memo.match(/^hcs-26:op:(\d+):(\d+)$/);
+  if (!match) {
+    return null;
+  }
+  const operation = Number(match[1]);
+  const topicType = Number(match[2]);
+  if (![operation, topicType].every(Number.isFinite)) {
+    return null;
+  }
+  const parsedOperation = hcs26OperationEnumSchema.safeParse(operation);
+  if (!parsedOperation.success) {
+    return null;
+  }
+  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);
+  if (!parsedTopicType.success) {
+    return null;
+  }
+  return {
+    protocol: HCS26_PROTOCOL,
+    operation: parsedOperation.data,
+    topicType: parsedTopicType.data
+  };
+}
+const hcs26TopicMemoSchema = z.string().transform((value) => {
+  const parsed = parseHcs26TopicMemo(value);
+  if (!parsed) {
+    throw new Error("Invalid HCS-26 topic memo");
+  }
+  return parsed;
+});
+const hcs26TransactionMemoSchema = z.string().transform((value) => {
+  const parsed = parseHcs26TransactionMemo(value);
+  if (!parsed) {
+    throw new Error("Invalid HCS-26 transaction memo");
+  }
+  return parsed;
+});
 export {
-  HCS26BrowserClient
+  HCS26_DEFAULT_TTL_SECONDS,
+  buildHcs26TopicMemo,
+  buildHcs26TransactionMemo,
+  hcs26TopicMemoSchema,
+  hcs26TransactionMemoSchema,
+  parseHcs26TopicMemo,
+  parseHcs26TransactionMemo
 };
 //# sourceMappingURL=standards-sdk.es122.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es122.js","sources":["../../src/hcs-26/browser.ts"],"sourcesContent":["import type { ILogger } from '../utils/logger';\nimport type { NetworkType } from '../utils/types';\nimport { HCS26BaseClient, type HCS26ClientConfig } from './base-client';\n\nexport interface BrowserHCS26ClientConfig\n  extends Omit<HCS26ClientConfig, 'network' | 'logger'> {\n  network: NetworkType;\n  logger?: ILogger;\n}\n\nexport class HCS26BrowserClient extends HCS26BaseClient {\n  constructor(config: BrowserHCS26ClientConfig) {\n    super({\n      network: config.network,\n      logger: config.logger,\n      mirrorNode: config.mirrorNode,\n      verificationProvider: config.verificationProvider,\n    });\n  }\n}\n"],"names":[],"mappings":";AAUO,MAAM,2BAA2B,gBAAgB;AAAA,EACtD,YAAY,QAAkC;AAC5C,UAAM;AAAA,MACJ,SAAS,OAAO;AAAA,MAChB,QAAQ,OAAO;AAAA,MACf,YAAY,OAAO;AAAA,MACnB,sBAAsB,OAAO;AAAA,IAAA,CAC9B;AAAA,EACH;AACF;"}
+{"version":3,"file":"standards-sdk.es122.js","sources":["../../src/hcs-26/memos.ts"],"sourcesContent":["import { z } from 'zod';\nimport {\n  HCS26_PROTOCOL,\n  hcs26OperationEnumSchema,\n  hcs26TopicTypeEnumSchema,\n  type Hcs26OperationEnum,\n  type Hcs26TopicTypeEnum,\n} from './types';\n\nexport type Hcs26TopicMemo = {\n  protocol: typeof HCS26_PROTOCOL;\n  indexed: boolean;\n  ttlSeconds: number;\n  topicType: Hcs26TopicTypeEnum;\n};\n\nexport const HCS26_DEFAULT_TTL_SECONDS = 86400;\n\nfunction toPositiveInt(value: number): number {\n  if (!Number.isFinite(value)) {\n    throw new Error('Expected a finite number');\n  }\n  const intValue = Math.floor(value);\n  if (intValue <= 0) {\n    throw new Error('Expected a positive integer');\n  }\n  return intValue;\n}\n\nexport function buildHcs26TopicMemo(input: {\n  indexed?: boolean;\n  ttlSeconds?: number;\n  topicType: Hcs26TopicTypeEnum;\n}): string {\n  const indexed = input.indexed ?? true;\n  const ttlSeconds = toPositiveInt(\n    input.ttlSeconds ?? HCS26_DEFAULT_TTL_SECONDS,\n  );\n  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);\n\n  // HCS-2 memo convention: indexed topics use \"0\" in the second segment.\n  const indexedSegment = indexed ? '0' : '1';\n  return `${HCS26_PROTOCOL}:${indexedSegment}:${ttlSeconds}:${topicType}`;\n}\n\nexport function parseHcs26TopicMemo(memoRaw: string): Hcs26TopicMemo | null {\n  const memo = memoRaw.trim();\n  if (!memo) {\n    return null;\n  }\n\n  const match = memo.match(/^hcs-26:(\\d+):(\\d+):(\\d+)$/);\n  if (!match) {\n    return null;\n  }\n\n  const indexedSegment = Number(match[1]);\n  const ttlSeconds = Number(match[2]);\n  const topicType = Number(match[3]);\n\n  if (![indexedSegment, ttlSeconds, topicType].every(Number.isFinite)) {\n    return null;\n  }\n\n  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);\n  if (!parsedTopicType.success) {\n    return null;\n  }\n\n  if (indexedSegment !== 0 && indexedSegment !== 1) {\n    return null;\n  }\n\n  return {\n    protocol: HCS26_PROTOCOL,\n    indexed: indexedSegment === 0,\n    ttlSeconds,\n    topicType: parsedTopicType.data,\n  };\n}\n\nexport function buildHcs26TransactionMemo(input: {\n  operation: Hcs26OperationEnum;\n  topicType: Hcs26TopicTypeEnum;\n}): string {\n  const operation = hcs26OperationEnumSchema.parse(input.operation);\n  const topicType = hcs26TopicTypeEnumSchema.parse(input.topicType);\n  return `${HCS26_PROTOCOL}:op:${operation}:${topicType}`;\n}\n\nexport type Hcs26TransactionMemo = {\n  protocol: typeof HCS26_PROTOCOL;\n  operation: Hcs26OperationEnum;\n  topicType: Hcs26TopicTypeEnum;\n};\n\nexport function parseHcs26TransactionMemo(\n  memoRaw: string,\n): Hcs26TransactionMemo | null {\n  const memo = memoRaw.trim();\n  if (!memo) {\n    return null;\n  }\n\n  const match = memo.match(/^hcs-26:op:(\\d+):(\\d+)$/);\n  if (!match) {\n    return null;\n  }\n\n  const operation = Number(match[1]);\n  const topicType = Number(match[2]);\n  if (![operation, topicType].every(Number.isFinite)) {\n    return null;\n  }\n\n  const parsedOperation = hcs26OperationEnumSchema.safeParse(operation);\n  if (!parsedOperation.success) {\n    return null;\n  }\n  const parsedTopicType = hcs26TopicTypeEnumSchema.safeParse(topicType);\n  if (!parsedTopicType.success) {\n    return null;\n  }\n\n  return {\n    protocol: HCS26_PROTOCOL,\n    operation: parsedOperation.data,\n    topicType: parsedTopicType.data,\n  };\n}\n\nexport const hcs26TopicMemoSchema = z.string().transform(value => {\n  const parsed = parseHcs26TopicMemo(value);\n  if (!parsed) {\n    throw new Error('Invalid HCS-26 topic memo');\n  }\n  return parsed;\n});\n\nexport const hcs26TransactionMemoSchema = z.string().transform(value => {\n  const parsed = parseHcs26TransactionMemo(value);\n  if (!parsed) {\n    throw new Error('Invalid HCS-26 transaction memo');\n  }\n  return parsed;\n});\n"],"names":[],"mappings":"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"}

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

@@ -1,185 +1,163 @@
-let loggerFactory = null;
-function normalizeErrorData(error) {
-  const normalizedData = {
-    name: error.name,
-    message: error.message
-  };
-  if (error.stack) {
-    normalizedData.stack = error.stack;
-  }
-  for (const [key, value] of Object.entries(error)) {
-    normalizedData[key] = value;
-  }
-  return normalizedData;
-}
-function serializeLogData(data) {
-  try {
-    return JSON.stringify(
-      data,
-      (_key, value) => {
-        if (value instanceof Error) {
-          return normalizeErrorData(value);
-        }
-        if (typeof value === "bigint") {
-          return value.toString();
-        }
-        if (value instanceof Map) {
-          return Object.fromEntries(value);
-        }
-        if (value instanceof Set) {
-          return Array.from(value);
-        }
-        if (value instanceof Uint8Array) {
-          return Array.from(value);
-        }
-        return value;
-      },
-      2
-    );
-  } catch {
-    return String(data);
-  }
-}
-function setLoggerFactory(factory) {
-  loggerFactory = factory;
-  Logger.clearInstances();
+import { Logger } from "./standards-sdk.es126.js";
+import { Hcs26SkillRegistryResolver } from "./standards-sdk.es121.js";
+function getManifestTopicId(entry) {
+  const topicIdCandidate = entry.t_id;
+  if (typeof topicIdCandidate === "string" && topicIdCandidate.trim()) {
+    return topicIdCandidate.trim();
+  }
+  const hrlCandidate = entry.manifest_hcs1;
+  if (typeof hrlCandidate !== "string" || !hrlCandidate.trim()) {
+    throw new Error("Missing manifest reference in version register entry");
+  }
+  const hrl = hrlCandidate.trim();
+  const prefix = "hcs://1/";
+  if (!hrl.startsWith(prefix)) {
+    throw new Error(`Invalid manifest HRL: ${hrl}`);
+  }
+  return hrl.slice(prefix.length);
 }
-const _Logger = class _Logger {
-  constructor(options = {}) {
-    if (loggerFactory) {
-      return loggerFactory(options);
-    }
-    const globalDisable = typeof process !== "undefined" && process.env?.DISABLE_LOGS === "true";
-    this.silent = options.silent || globalDisable;
-    this.level = this.silent ? "silent" : options.level || "info";
-    this.moduleContext = options.module || "app";
-    this.prettyPrint = !this.silent && options.prettyPrint !== false;
-  }
-  static getInstance(options = {}) {
-    const moduleKey = options.module || "default";
-    const globalDisable = typeof process !== "undefined" && process.env?.DISABLE_LOGS === "true";
-    if (globalDisable && _Logger.instances.has(moduleKey)) {
-      const existingLogger = _Logger.instances.get(moduleKey);
-      if (existingLogger.getLevel() !== "silent") {
-        _Logger.instances.delete(moduleKey);
-      }
-    }
-    if (!_Logger.instances.has(moduleKey)) {
-      const logger = loggerFactory ? loggerFactory(options) : new _Logger(options);
-      _Logger.instances.set(moduleKey, logger);
-    }
-    return _Logger.instances.get(moduleKey);
-  }
-  setLogLevel(level) {
-    this.level = level;
-  }
-  getLevel() {
-    return this.level;
+class HCS26BaseClient {
+  constructor(config) {
+    this.network = config.network;
+    this.logger = config.logger ?? Logger.getInstance({
+      module: "HCS26Client",
+      level: "info"
+    });
+    this.verificationProvider = config.verificationProvider;
+    this.resolver = new Hcs26SkillRegistryResolver({
+      network: this.network,
+      logger: this.logger,
+      mirrorNode: config.mirrorNode
+    });
   }
-  setSilent(silent) {
-    this.silent = silent;
-    if (silent) {
-      this.level = "silent";
+  async resolveSkill(params) {
+    const discovery = await this.resolver.resolveDiscoveryRecord({
+      directoryTopicId: params.directoryTopicId,
+      skillUid: params.skillUid,
+      scanLimit: params.discoveryScanLimit
+    });
+    if (!discovery) {
+      return null;
     }
-  }
-  setModule(module) {
-    this.moduleContext = module;
-  }
-  formatArgs(args) {
-    if (args.length === 0) {
-      return { msg: "" };
+    const versionRegistryTopicId = discovery.t_id;
+    const latestVersion = await this.resolver.getLatestVersionRegister({
+      versionRegistryTopicId,
+      skillUid: params.skillUid
+    });
+    if (!latestVersion) {
+      throw new Error(
+        `No active version entries found for skill ${params.skillUid} in version registry ${versionRegistryTopicId}`
+      );
     }
-    if (args.length === 1) {
-      if (typeof args[0] === "string") {
-        return { msg: args[0] };
+    const manifestTopicId = getManifestTopicId(latestVersion);
+    const { manifest, sha256Hex } = await this.resolver.resolveManifest({
+      manifestTopicId
+    });
+    await this.resolver.verifyVersionRegisterMatchesManifest({
+      versionRegister: latestVersion,
+      manifestSha256Hex: sha256Hex
+    });
+    let verification;
+    const provider = this.verificationProvider;
+    const includeVerification = params.includeVerification === true;
+    const name = typeof discovery.metadata?.name === "string" ? discovery.metadata.name.trim() : "";
+    if (includeVerification && provider && name) {
+      try {
+        verification = await provider.getSkillVerificationStatus({ name });
+      } catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        this.logger.warn(
+          `Failed to resolve verification status for skill "${name}": ${detail}`
+        );
+        verification = null;
       }
-      return { msg: "", data: args[0] };
     }
-    const stringArgs = [];
-    const objectArgs = [];
-    args.forEach((arg) => {
-      if (typeof arg === "string" || typeof arg === "number" || typeof arg === "boolean") {
-        stringArgs.push(String(arg));
-      } else {
-        objectArgs.push(arg);
-      }
+    return {
+      directoryTopicId: params.directoryTopicId,
+      skillUid: params.skillUid,
+      discovery,
+      versionRegistryTopicId,
+      latestVersion,
+      manifest,
+      manifestSha256Hex: sha256Hex,
+      ...includeVerification ? { verification } : {}
+    };
+  }
+  async listSkillVersions(params) {
+    const discovery = await this.resolver.resolveDiscoveryRecord({
+      directoryTopicId: params.directoryTopicId,
+      skillUid: params.skillUid,
+      scanLimit: params.discoveryScanLimit
     });
-    const msg = stringArgs.join(" ");
-    return objectArgs.length > 0 ? { msg, data: objectArgs } : { msg };
-  }
-  shouldLog(level) {
-    if (this.silent || this.level === "silent") {
-      return false;
+    if (!discovery) {
+      return [];
     }
-    const levels = ["trace", "debug", "info", "warn", "error", "silent"];
-    const currentLevelIndex = levels.indexOf(this.level);
-    const targetLevelIndex = levels.indexOf(level);
-    return targetLevelIndex >= currentLevelIndex;
+    const versionRegistryTopicId = discovery.t_id;
+    return this.resolver.listVersionRegisters({
+      versionRegistryTopicId,
+      skillUid: params.skillUid,
+      limit: params.limit
+    });
   }
-  getConsoleMethod(level) {
-    if (level === "error") {
-      return console.error;
-    }
-    if (level === "warn") {
-      return console.warn;
+  async resolveSkillVersion(params) {
+    const versionRaw = params.version.trim();
+    if (!versionRaw) {
+      throw new Error("version is required");
     }
-    if (level === "debug") {
-      return console.debug;
+    const discovery = await this.resolver.resolveDiscoveryRecord({
+      directoryTopicId: params.directoryTopicId,
+      skillUid: params.skillUid,
+      scanLimit: params.discoveryScanLimit
+    });
+    if (!discovery) {
+      return null;
     }
-    return console.log;
-  }
-  writeLog(level, ...args) {
-    if (!this.shouldLog(level)) {
-      return;
+    const versionRegistryTopicId = discovery.t_id;
+    const entries = await this.resolver.listVersionRegisters({
+      versionRegistryTopicId,
+      skillUid: params.skillUid,
+      limit: 250
+    });
+    const target = entries.find((entry) => entry.version.trim() === versionRaw);
+    if (!target) {
+      return null;
     }
-    const { msg, data } = this.formatArgs(args);
-    const timestamp = (/* @__PURE__ */ new Date()).toISOString();
-    const consoleMethod = this.getConsoleMethod(level);
-    if (this.prettyPrint) {
-      const levelFormatted = level.toUpperCase().padEnd(5);
-      let output = `${timestamp} ${levelFormatted} [${this.moduleContext}] ${msg}`;
-      if (data) {
-        output += "\n" + serializeLogData(data);
+    const manifestTopicId = getManifestTopicId(target);
+    const { manifest, sha256Hex } = await this.resolver.resolveManifest({
+      manifestTopicId
+    });
+    await this.resolver.verifyVersionRegisterMatchesManifest({
+      versionRegister: target,
+      manifestSha256Hex: sha256Hex
+    });
+    let verification;
+    const provider = this.verificationProvider;
+    const includeVerification = params.includeVerification === true;
+    const name = typeof discovery.metadata?.name === "string" ? discovery.metadata.name.trim() : "";
+    if (includeVerification && provider && name) {
+      try {
+        verification = await provider.getSkillVerificationStatus({ name });
+      } catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        this.logger.warn(
+          `Failed to resolve verification status for skill "${name}": ${detail}`
+        );
+        verification = null;
       }
-      consoleMethod(output);
-    } else {
-      const logObj = {
-        timestamp,
-        level,
-        module: this.moduleContext,
-        message: msg,
-        ...data && { data }
-      };
-      consoleMethod(JSON.stringify(logObj));
     }
+    return {
+      directoryTopicId: params.directoryTopicId,
+      skillUid: params.skillUid,
+      discovery,
+      versionRegistryTopicId,
+      versionEntry: target,
+      manifest,
+      manifestSha256Hex: sha256Hex,
+      ...includeVerification ? { verification } : {}
+    };
   }
-  debug(...args) {
-    this.writeLog("debug", ...args);
-  }
-  info(...args) {
-    this.writeLog("info", ...args);
-  }
-  warn(...args) {
-    this.writeLog("warn", ...args);
-  }
-  error(...args) {
-    this.writeLog("error", ...args);
-  }
-  trace(...args) {
-    this.writeLog("trace", ...args);
-  }
-  /**
-   * Clear all logger instances
-   * Used when switching logger implementations
-   */
-  static clearInstances() {
-    _Logger.instances.clear();
-  }
-};
-_Logger.instances = /* @__PURE__ */ new Map();
-let Logger = _Logger;
+}
 export {
-  Logger,
-  setLoggerFactory
+  HCS26BaseClient
 };
 //# sourceMappingURL=standards-sdk.es123.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es123.js","sources":["../../src/utils/logger.ts"],"sourcesContent":["export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'silent';\n\nexport interface LoggerOptions {\n  level?: LogLevel;\n  module?: string;\n  prettyPrint?: boolean;\n  silent?: boolean;\n}\n\nexport interface ILogger {\n  debug(...args: any[]): void;\n  info(...args: any[]): void;\n  warn(...args: any[]): void;\n  error(...args: any[]): void;\n  trace(...args: any[]): void;\n  setLogLevel(level: LogLevel): void;\n  getLevel(): LogLevel;\n  setSilent(silent: boolean): void;\n  setModule(module: string): void;\n}\n\nexport type LoggerFactory = (options: LoggerOptions) => ILogger;\n\nlet loggerFactory: LoggerFactory | null = null;\n\nfunction normalizeErrorData(error: Error): Record<string, unknown> {\n  const normalizedData: Record<string, unknown> = {\n    name: error.name,\n    message: error.message,\n  };\n\n  if (error.stack) {\n    normalizedData.stack = error.stack;\n  }\n\n  for (const [key, value] of Object.entries(error)) {\n    normalizedData[key] = value;\n  }\n\n  return normalizedData;\n}\n\nfunction serializeLogData(data: unknown): string {\n  try {\n    return JSON.stringify(\n      data,\n      (_key, value: unknown) => {\n        if (value instanceof Error) {\n          return normalizeErrorData(value);\n        }\n        if (typeof value === 'bigint') {\n          return value.toString();\n        }\n        if (value instanceof Map) {\n          return Object.fromEntries(value);\n        }\n        if (value instanceof Set) {\n          return Array.from(value);\n        }\n        if (value instanceof Uint8Array) {\n          return Array.from(value);\n        }\n        return value;\n      },\n      2,\n    );\n  } catch {\n    return String(data);\n  }\n}\n\n/**\n * Set a custom logger factory to override the default Pino-based implementation\n */\nexport function setLoggerFactory(factory: LoggerFactory): void {\n  loggerFactory = factory;\n  Logger.clearInstances();\n}\n\nexport class Logger implements ILogger {\n  private static instances: Map<string, ILogger> = new Map();\n  private level: LogLevel;\n  private moduleContext: string;\n  private silent: boolean;\n  private prettyPrint: boolean;\n\n  constructor(options: LoggerOptions = {}) {\n    if (loggerFactory) {\n      return loggerFactory(options) as any;\n    }\n\n    const globalDisable =\n      typeof process !== 'undefined' && process.env?.DISABLE_LOGS === 'true';\n\n    this.silent = options.silent || globalDisable;\n    this.level = this.silent ? 'silent' : options.level || 'info';\n    this.moduleContext = options.module || 'app';\n    this.prettyPrint = !this.silent && options.prettyPrint !== false;\n  }\n\n  static getInstance(options: LoggerOptions = {}): ILogger {\n    const moduleKey = options.module || 'default';\n\n    const globalDisable =\n      typeof process !== 'undefined' && process.env?.DISABLE_LOGS === 'true';\n\n    if (globalDisable && Logger.instances.has(moduleKey)) {\n      const existingLogger = Logger.instances.get(moduleKey)!;\n      if (existingLogger.getLevel() !== 'silent') {\n        Logger.instances.delete(moduleKey);\n      }\n    }\n\n    if (!Logger.instances.has(moduleKey)) {\n      const logger = loggerFactory\n        ? loggerFactory(options)\n        : new Logger(options);\n      Logger.instances.set(moduleKey, logger);\n    }\n\n    return Logger.instances.get(moduleKey)!;\n  }\n\n  setLogLevel(level: LogLevel): void {\n    this.level = level;\n  }\n\n  getLevel(): LogLevel {\n    return this.level;\n  }\n\n  setSilent(silent: boolean): void {\n    this.silent = silent;\n    if (silent) {\n      this.level = 'silent';\n    }\n  }\n\n  setModule(module: string): void {\n    this.moduleContext = module;\n  }\n\n  private formatArgs(args: any[]): { msg: string; data?: any } {\n    if (args.length === 0) {\n      return { msg: '' };\n    }\n\n    if (args.length === 1) {\n      if (typeof args[0] === 'string') {\n        return { msg: args[0] };\n      }\n      return { msg: '', data: args[0] };\n    }\n\n    const stringArgs: string[] = [];\n    const objectArgs: any[] = [];\n\n    args.forEach(arg => {\n      if (\n        typeof arg === 'string' ||\n        typeof arg === 'number' ||\n        typeof arg === 'boolean'\n      ) {\n        stringArgs.push(String(arg));\n      } else {\n        objectArgs.push(arg);\n      }\n    });\n\n    const msg = stringArgs.join(' ');\n    return objectArgs.length > 0 ? { msg, data: objectArgs } : { msg };\n  }\n\n  private shouldLog(level: LogLevel): boolean {\n    if (this.silent || this.level === 'silent') {\n      return false;\n    }\n\n    const levels = ['trace', 'debug', 'info', 'warn', 'error', 'silent'];\n    const currentLevelIndex = levels.indexOf(this.level);\n    const targetLevelIndex = levels.indexOf(level);\n\n    return targetLevelIndex >= currentLevelIndex;\n  }\n\n  private getConsoleMethod(level: LogLevel): (...args: any[]) => void {\n    if (level === 'error') {\n      return console.error;\n    }\n    if (level === 'warn') {\n      return console.warn;\n    }\n    if (level === 'debug') {\n      return console.debug;\n    }\n    return console.log;\n  }\n\n  private writeLog(level: LogLevel, ...args: any[]): void {\n    if (!this.shouldLog(level)) {\n      return;\n    }\n\n    const { msg, data } = this.formatArgs(args);\n    const timestamp = new Date().toISOString();\n    const consoleMethod = this.getConsoleMethod(level);\n\n    if (this.prettyPrint) {\n      const levelFormatted = level.toUpperCase().padEnd(5);\n      let output = `${timestamp} ${levelFormatted} [${this.moduleContext}] ${msg}`;\n\n      if (data) {\n        output += '\\n' + serializeLogData(data);\n      }\n\n      consoleMethod(output);\n    } else {\n      const logObj = {\n        timestamp,\n        level,\n        module: this.moduleContext,\n        message: msg,\n        ...(data && { data }),\n      };\n\n      consoleMethod(JSON.stringify(logObj));\n    }\n  }\n\n  debug(...args: any[]): void {\n    this.writeLog('debug', ...args);\n  }\n\n  info(...args: any[]): void {\n    this.writeLog('info', ...args);\n  }\n\n  warn(...args: any[]): void {\n    this.writeLog('warn', ...args);\n  }\n\n  error(...args: any[]): void {\n    this.writeLog('error', ...args);\n  }\n\n  trace(...args: any[]): void {\n    this.writeLog('trace', ...args);\n  }\n\n  /**\n   * Clear all logger instances\n   * Used when switching logger implementations\n   */\n  static clearInstances(): void {\n    Logger.instances.clear();\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es123.js","sources":["../../src/hcs-26/base-client.ts"],"sourcesContent":["import type { ILogger } from '../utils/logger';\nimport { Logger } from '../utils/logger';\nimport type { NetworkType } from '../utils/types';\nimport type { MirrorNodeConfig } from '../services/mirror-node';\nimport { Hcs26SkillRegistryResolver } from './resolver';\nimport type {\n  Hcs26SkillManifest,\n  Hcs26VersionRegister,\n  Hcs26VersionRegisterLegacy,\n} from './types';\n\nexport type HCS26SkillVerificationStatus = {\n  name: string;\n  verified: boolean;\n  previouslyVerified: boolean;\n  pendingRequest?: unknown;\n};\n\nexport interface HCS26SkillVerificationProvider {\n  getSkillVerificationStatus(params: {\n    name: string;\n  }): Promise<HCS26SkillVerificationStatus | null>;\n}\n\nexport interface HCS26ClientConfig {\n  network: NetworkType;\n  logger?: ILogger;\n  mirrorNode?: MirrorNodeConfig;\n  verificationProvider?: HCS26SkillVerificationProvider;\n}\n\nexport type HCS26DiscoveryRecord = {\n  p: 'hcs-26';\n  op: 'register';\n  t_id: string;\n  account_id: string;\n  metadata: Record<string, unknown>;\n  m?: string;\n  sequence_number?: number;\n};\n\nexport type HCS26ResolvedSkill = {\n  directoryTopicId: string;\n  skillUid: number;\n  discovery: HCS26DiscoveryRecord;\n  versionRegistryTopicId: string;\n  latestVersion:\n    | (Hcs26VersionRegister & { sequence_number?: number })\n    | (Hcs26VersionRegisterLegacy & { sequence_number?: number });\n  manifest: Hcs26SkillManifest;\n  manifestSha256Hex: string;\n  verification?: HCS26SkillVerificationStatus | null;\n};\n\nexport type HCS26ResolvedSkillVersion = Omit<\n  HCS26ResolvedSkill,\n  'latestVersion'\n> & {\n  versionEntry:\n    | (Hcs26VersionRegister & { sequence_number?: number })\n    | (Hcs26VersionRegisterLegacy & { sequence_number?: number });\n};\n\nfunction getManifestTopicId(\n  entry: Hcs26VersionRegister | Hcs26VersionRegisterLegacy,\n): string {\n  const topicIdCandidate = (entry as { t_id?: unknown }).t_id;\n  if (typeof topicIdCandidate === 'string' && topicIdCandidate.trim()) {\n    return topicIdCandidate.trim();\n  }\n\n  const hrlCandidate = (entry as { manifest_hcs1?: unknown }).manifest_hcs1;\n  if (typeof hrlCandidate !== 'string' || !hrlCandidate.trim()) {\n    throw new Error('Missing manifest reference in version register entry');\n  }\n\n  const hrl = hrlCandidate.trim();\n  const prefix = 'hcs://1/';\n  if (!hrl.startsWith(prefix)) {\n    throw new Error(`Invalid manifest HRL: ${hrl}`);\n  }\n  return hrl.slice(prefix.length);\n}\n\nexport class HCS26BaseClient {\n  protected readonly network: NetworkType;\n  protected readonly logger: ILogger;\n  protected readonly resolver: Hcs26SkillRegistryResolver;\n  protected readonly verificationProvider?: HCS26SkillVerificationProvider;\n\n  constructor(config: HCS26ClientConfig) {\n    this.network = config.network;\n    this.logger =\n      config.logger ??\n      Logger.getInstance({\n        module: 'HCS26Client',\n        level: 'info',\n      });\n    this.verificationProvider = config.verificationProvider;\n\n    this.resolver = new Hcs26SkillRegistryResolver({\n      network: this.network,\n      logger: this.logger,\n      mirrorNode: config.mirrorNode,\n    });\n  }\n\n  async resolveSkill(params: {\n    directoryTopicId: string;\n    skillUid: number;\n    discoveryScanLimit?: number;\n    includeVerification?: boolean;\n  }): Promise<HCS26ResolvedSkill | null> {\n    const discovery = (await this.resolver.resolveDiscoveryRecord({\n      directoryTopicId: params.directoryTopicId,\n      skillUid: params.skillUid,\n      scanLimit: params.discoveryScanLimit,\n    })) as HCS26DiscoveryRecord | null;\n\n    if (!discovery) {\n      return null;\n    }\n\n    const versionRegistryTopicId = discovery.t_id;\n    const latestVersion = await this.resolver.getLatestVersionRegister({\n      versionRegistryTopicId,\n      skillUid: params.skillUid,\n    });\n\n    if (!latestVersion) {\n      throw new Error(\n        `No active version entries found for skill ${params.skillUid} in version registry ${versionRegistryTopicId}`,\n      );\n    }\n\n    const manifestTopicId = getManifestTopicId(latestVersion);\n    const { manifest, sha256Hex } = await this.resolver.resolveManifest({\n      manifestTopicId,\n    });\n\n    await this.resolver.verifyVersionRegisterMatchesManifest({\n      versionRegister: latestVersion,\n      manifestSha256Hex: sha256Hex,\n    });\n\n    let verification: HCS26SkillVerificationStatus | null | undefined;\n    const provider = this.verificationProvider;\n    const includeVerification = params.includeVerification === true;\n    const name =\n      typeof discovery.metadata?.name === 'string'\n        ? discovery.metadata.name.trim()\n        : '';\n\n    if (includeVerification && provider && name) {\n      try {\n        verification = await provider.getSkillVerificationStatus({ name });\n      } catch (error) {\n        const detail = error instanceof Error ? error.message : String(error);\n        this.logger.warn(\n          `Failed to resolve verification status for skill \"${name}\": ${detail}`,\n        );\n        verification = null;\n      }\n    }\n\n    return {\n      directoryTopicId: params.directoryTopicId,\n      skillUid: params.skillUid,\n      discovery,\n      versionRegistryTopicId,\n      latestVersion,\n      manifest,\n      manifestSha256Hex: sha256Hex,\n      ...(includeVerification ? { verification } : {}),\n    };\n  }\n\n  async listSkillVersions(params: {\n    directoryTopicId: string;\n    skillUid: number;\n    discoveryScanLimit?: number;\n    limit?: number;\n  }): Promise<\n    Array<\n      | (Hcs26VersionRegister & { sequence_number?: number })\n      | (Hcs26VersionRegisterLegacy & { sequence_number?: number })\n    >\n  > {\n    const discovery = (await this.resolver.resolveDiscoveryRecord({\n      directoryTopicId: params.directoryTopicId,\n      skillUid: params.skillUid,\n      scanLimit: params.discoveryScanLimit,\n    })) as HCS26DiscoveryRecord | null;\n\n    if (!discovery) {\n      return [];\n    }\n\n    const versionRegistryTopicId = discovery.t_id;\n    return this.resolver.listVersionRegisters({\n      versionRegistryTopicId,\n      skillUid: params.skillUid,\n      limit: params.limit,\n    });\n  }\n\n  async resolveSkillVersion(params: {\n    directoryTopicId: string;\n    skillUid: number;\n    version: string;\n    discoveryScanLimit?: number;\n    includeVerification?: boolean;\n  }): Promise<HCS26ResolvedSkillVersion | null> {\n    const versionRaw = params.version.trim();\n    if (!versionRaw) {\n      throw new Error('version is required');\n    }\n\n    const discovery = (await this.resolver.resolveDiscoveryRecord({\n      directoryTopicId: params.directoryTopicId,\n      skillUid: params.skillUid,\n      scanLimit: params.discoveryScanLimit,\n    })) as HCS26DiscoveryRecord | null;\n\n    if (!discovery) {\n      return null;\n    }\n\n    const versionRegistryTopicId = discovery.t_id;\n    const entries = await this.resolver.listVersionRegisters({\n      versionRegistryTopicId,\n      skillUid: params.skillUid,\n      limit: 250,\n    });\n\n    const target = entries.find(entry => entry.version.trim() === versionRaw);\n    if (!target) {\n      return null;\n    }\n\n    const manifestTopicId = getManifestTopicId(target);\n    const { manifest, sha256Hex } = await this.resolver.resolveManifest({\n      manifestTopicId,\n    });\n\n    await this.resolver.verifyVersionRegisterMatchesManifest({\n      versionRegister: target,\n      manifestSha256Hex: sha256Hex,\n    });\n\n    let verification: HCS26SkillVerificationStatus | null | undefined;\n    const provider = this.verificationProvider;\n    const includeVerification = params.includeVerification === true;\n    const name =\n      typeof discovery.metadata?.name === 'string'\n        ? discovery.metadata.name.trim()\n        : '';\n\n    if (includeVerification && provider && name) {\n      try {\n        verification = await provider.getSkillVerificationStatus({ name });\n      } catch (error) {\n        const detail = error instanceof Error ? error.message : String(error);\n        this.logger.warn(\n          `Failed to resolve verification status for skill \"${name}\": ${detail}`,\n        );\n        verification = null;\n      }\n    }\n\n    return {\n      directoryTopicId: params.directoryTopicId,\n      skillUid: params.skillUid,\n      discovery,\n      versionRegistryTopicId,\n      versionEntry: target,\n      manifest,\n      manifestSha256Hex: sha256Hex,\n      ...(includeVerification ? { verification } : {}),\n    };\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,32 +1,37 @@
-import { Logger } from "./standards-sdk.es123.js";
-function createLoggerAdapter(iLogger) {
-  const adapter = Object.create(Logger.prototype);
-  adapter.debug = (...args) => iLogger.debug(...args);
-  adapter.info = (...args) => iLogger.info(...args);
-  adapter.warn = (...args) => iLogger.warn(...args);
-  adapter.error = (...args) => iLogger.error(...args);
-  adapter.trace = (...args) => iLogger.trace(...args);
-  adapter.setLogLevel = (level) => iLogger.setLogLevel(level);
-  adapter.getLevel = () => iLogger.getLevel();
-  adapter.setSilent = (silent) => iLogger.setSilent(silent);
-  adapter.setModule = (module) => iLogger.setModule(module);
-  adapter.logger = { level: iLogger.getLevel() };
-  adapter.moduleContext = "";
-  adapter.formatArgs = () => ({ msg: "" });
-  return adapter;
+import { getSkillVerificationStatus } from "./standards-sdk.es171.js";
+import { HCS26BaseClient } from "./standards-sdk.es123.js";
+function mapVerification(status) {
+  const pendingRequest = status.pendingRequest ?? void 0;
+  return {
+    name: status.name,
+    verified: status.verified,
+    previouslyVerified: status.previouslyVerified,
+    ...pendingRequest ? { pendingRequest } : {}
+  };
 }
-function isConcreteLogger(logger) {
-  return logger instanceof Logger;
+function createRegistryBrokerVerificationProvider(client) {
+  return {
+    async getSkillVerificationStatus(params) {
+      const status = await getSkillVerificationStatus(client, {
+        name: params.name
+      });
+      return mapVerification(status);
+    }
+  };
 }
-function ensureLoggerType(logger) {
-  if (isConcreteLogger(logger)) {
-    return logger;
+class HCS26Client extends HCS26BaseClient {
+  constructor(config) {
+    const provider = config.verificationProvider ?? (config.registryBrokerClient ? createRegistryBrokerVerificationProvider(config.registryBrokerClient) : void 0);
+    super({
+      network: config.network,
+      logger: config.logger,
+      mirrorNode: config.mirrorNode,
+      verificationProvider: provider
+    });
   }
-  return createLoggerAdapter(logger);
 }
 export {
-  createLoggerAdapter,
-  ensureLoggerType,
-  isConcreteLogger
+  HCS26Client,
+  createRegistryBrokerVerificationProvider
 };
 //# sourceMappingURL=standards-sdk.es124.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es124.js","sources":["../../src/utils/logger-adapter.ts"],"sourcesContent":["import { Logger, ILogger } from './logger';\n\n/**\n * Creates a Logger instance that wraps an ILogger implementation\n * This is needed for compatibility with external libraries that expect the concrete Logger type\n */\nexport function createLoggerAdapter(iLogger: ILogger): Logger {\n  const adapter = Object.create(Logger.prototype);\n\n  adapter.debug = (...args: any[]) => iLogger.debug(...args);\n  adapter.info = (...args: any[]) => iLogger.info(...args);\n  adapter.warn = (...args: any[]) => iLogger.warn(...args);\n  adapter.error = (...args: any[]) => iLogger.error(...args);\n  adapter.trace = (...args: any[]) => iLogger.trace(...args);\n  adapter.setLogLevel = (level: any) => iLogger.setLogLevel(level);\n  adapter.getLevel = () => iLogger.getLevel();\n  adapter.setSilent = (silent: boolean) => iLogger.setSilent(silent);\n  adapter.setModule = (module: string) => iLogger.setModule(module);\n\n  adapter.logger = { level: iLogger.getLevel() };\n  adapter.moduleContext = '';\n  adapter.formatArgs = () => ({ msg: '' });\n\n  return adapter as Logger;\n}\n\n/**\n * Type guard to check if a logger is the concrete Logger type\n */\nexport function isConcreteLogger(logger: ILogger | Logger): logger is Logger {\n  return logger instanceof Logger;\n}\n\n/**\n * Gets a Logger-compatible instance from an ILogger\n * If the ILogger is already a Logger, returns it as-is\n * Otherwise, creates an adapter\n */\nexport function ensureLoggerType(logger: ILogger): Logger {\n  if (isConcreteLogger(logger)) {\n    return logger;\n  }\n  return createLoggerAdapter(logger);\n}\n"],"names":[],"mappings":";AAMO,SAAS,oBAAoB,SAA0B;AAC5D,QAAM,UAAU,OAAO,OAAO,OAAO,SAAS;AAE9C,UAAQ,QAAQ,IAAI,SAAgB,QAAQ,MAAM,GAAG,IAAI;AACzD,UAAQ,OAAO,IAAI,SAAgB,QAAQ,KAAK,GAAG,IAAI;AACvD,UAAQ,OAAO,IAAI,SAAgB,QAAQ,KAAK,GAAG,IAAI;AACvD,UAAQ,QAAQ,IAAI,SAAgB,QAAQ,MAAM,GAAG,IAAI;AACzD,UAAQ,QAAQ,IAAI,SAAgB,QAAQ,MAAM,GAAG,IAAI;AACzD,UAAQ,cAAc,CAAC,UAAe,QAAQ,YAAY,KAAK;AAC/D,UAAQ,WAAW,MAAM,QAAQ,SAAA;AACjC,UAAQ,YAAY,CAAC,WAAoB,QAAQ,UAAU,MAAM;AACjE,UAAQ,YAAY,CAAC,WAAmB,QAAQ,UAAU,MAAM;AAEhE,UAAQ,SAAS,EAAE,OAAO,QAAQ,WAAS;AAC3C,UAAQ,gBAAgB;AACxB,UAAQ,aAAa,OAAO,EAAE,KAAK,GAAA;AAEnC,SAAO;AACT;AAKO,SAAS,iBAAiB,QAA4C;AAC3E,SAAO,kBAAkB;AAC3B;AAOO,SAAS,iBAAiB,QAAyB;AACxD,MAAI,iBAAiB,MAAM,GAAG;AAC5B,WAAO;AAAA,EACT;AACA,SAAO,oBAAoB,MAAM;AACnC;"}
+{"version":3,"file":"standards-sdk.es124.js","sources":["../../src/hcs-26/sdk.ts"],"sourcesContent":["import type { RegistryBrokerClient } from '../services/registry-broker/client/base-client';\nimport { getSkillVerificationStatus } from '../services/registry-broker/client/skills';\nimport type { SkillVerificationStatusResponse } from '../services/registry-broker/types';\nimport {\n  HCS26BaseClient,\n  type HCS26ClientConfig,\n  type HCS26SkillVerificationProvider,\n  type HCS26SkillVerificationStatus,\n} from './base-client';\n\nexport interface SDKHCS26ClientConfig extends HCS26ClientConfig {\n  registryBrokerClient?: RegistryBrokerClient;\n}\n\nfunction mapVerification(\n  status: SkillVerificationStatusResponse,\n): HCS26SkillVerificationStatus {\n  const pendingRequest = status.pendingRequest ?? undefined;\n  return {\n    name: status.name,\n    verified: status.verified,\n    previouslyVerified: status.previouslyVerified,\n    ...(pendingRequest ? { pendingRequest } : {}),\n  };\n}\n\nexport function createRegistryBrokerVerificationProvider(\n  client: RegistryBrokerClient,\n): HCS26SkillVerificationProvider {\n  return {\n    async getSkillVerificationStatus(params: { name: string }) {\n      const status = await getSkillVerificationStatus(client, {\n        name: params.name,\n      });\n      return mapVerification(status);\n    },\n  };\n}\n\nexport class HCS26Client extends HCS26BaseClient {\n  constructor(config: SDKHCS26ClientConfig) {\n    const provider =\n      config.verificationProvider ??\n      (config.registryBrokerClient\n        ? createRegistryBrokerVerificationProvider(config.registryBrokerClient)\n        : undefined);\n\n    super({\n      network: config.network,\n      logger: config.logger,\n      mirrorNode: config.mirrorNode,\n      verificationProvider: provider,\n    });\n  }\n}\n"],"names":[],"mappings":";;AAcA,SAAS,gBACP,QAC8B;AAC9B,QAAM,iBAAiB,OAAO,kBAAkB;AAChD,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb,UAAU,OAAO;AAAA,IACjB,oBAAoB,OAAO;AAAA,IAC3B,GAAI,iBAAiB,EAAE,mBAAmB,CAAA;AAAA,EAAC;AAE/C;AAEO,SAAS,yCACd,QACgC;AAChC,SAAO;AAAA,IACL,MAAM,2BAA2B,QAA0B;AACzD,YAAM,SAAS,MAAM,2BAA2B,QAAQ;AAAA,QACtD,MAAM,OAAO;AAAA,MAAA,CACd;AACD,aAAO,gBAAgB,MAAM;AAAA,IAC/B;AAAA,EAAA;AAEJ;AAEO,MAAM,oBAAoB,gBAAgB;AAAA,EAC/C,YAAY,QAA8B;AACxC,UAAM,WACJ,OAAO,yBACN,OAAO,uBACJ,yCAAyC,OAAO,oBAAoB,IACpE;AAEN,UAAM;AAAA,MACJ,SAAS,OAAO;AAAA,MAChB,QAAQ,OAAO;AAAA,MACf,YAAY,OAAO;AAAA,MACnB,sBAAsB;AAAA,IAAA,CACvB;AAAA,EACH;AACF;"}

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

@@ -1,25 +1,15 @@
-import { HederaMirrorNode } from "./standards-sdk.es144.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}`
-        );
-      }
-    }
+import { HCS26BaseClient } from "./standards-sdk.es123.js";
+class HCS26BrowserClient extends HCS26BaseClient {
+  constructor(config) {
+    super({
+      network: config.network,
+      logger: config.logger,
+      mirrorNode: config.mirrorNode,
+      verificationProvider: config.verificationProvider
+    });
   }
-  return exemptKeys;
 }
 export {
-  accountIdsToExemptKeys
+  HCS26BrowserClient
 };
 //# sourceMappingURL=standards-sdk.es125.js.map