@hashgraphonline/standards-sdk 0.1.190 → 0.1.191

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

@@ -1,163 +1,108 @@
-import { Logger } from "./standards-sdk.es147.js";
-import { Hcs26SkillRegistryResolver } from "./standards-sdk.es142.js";
-function getManifestTopicId(entry) {
-  const topicIdCandidate = entry.t_id;
-  if (typeof topicIdCandidate === "string" && topicIdCandidate.trim()) {
-    return topicIdCandidate.trim();
+import { z } from "zod";
+import { hcs26TopicTypeEnumSchema, HCS26_PROTOCOL, hcs26OperationEnumSchema } from "./standards-sdk.es142.js";
+const HCS26_DEFAULT_TTL_SECONDS = 86400;
+function toPositiveInt(value) {
+  if (!Number.isFinite(value)) {
+    throw new Error("Expected a finite number");
   }
-  const hrlCandidate = entry.manifest_hcs1;
-  if (typeof hrlCandidate !== "string" || !hrlCandidate.trim()) {
-    throw new Error("Missing manifest reference in version register entry");
+  const intValue = Math.floor(value);
+  if (intValue <= 0) {
+    throw new Error("Expected a positive integer");
   }
-  const hrl = hrlCandidate.trim();
-  const prefix = "hcs://1/";
-  if (!hrl.startsWith(prefix)) {
-    throw new Error(`Invalid manifest HRL: ${hrl}`);
+  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;
   }
-  return hrl.slice(prefix.length);
+  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}`;
 }
-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
-    });
+function parseHcs26TransactionMemo(memoRaw) {
+  const memo = memoRaw.trim();
+  if (!memo) {
+    return null;
+  }
+  const match = memo.match(/^hcs-26:op:(\d+):(\d+)$/);
+  if (!match) {
+    return null;
   }
-  async resolveSkill(params) {
-    const discovery = await this.resolver.resolveDiscoveryRecord({
-      directoryTopicId: params.directoryTopicId,
-      skillUid: params.skillUid,
-      scanLimit: params.discoveryScanLimit
-    });
-    if (!discovery) {
-      return null;
-    }
-    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}`
-      );
-    }
-    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 {
-      directoryTopicId: params.directoryTopicId,
-      skillUid: params.skillUid,
-      discovery,
-      versionRegistryTopicId,
-      latestVersion,
-      manifest,
-      manifestSha256Hex: sha256Hex,
-      ...includeVerification ? { verification } : {}
-    };
+  const operation = Number(match[1]);
+  const topicType = Number(match[2]);
+  if (![operation, topicType].every(Number.isFinite)) {
+    return null;
   }
-  async listSkillVersions(params) {
-    const discovery = await this.resolver.resolveDiscoveryRecord({
-      directoryTopicId: params.directoryTopicId,
-      skillUid: params.skillUid,
-      scanLimit: params.discoveryScanLimit
-    });
-    if (!discovery) {
-      return [];
-    }
-    const versionRegistryTopicId = discovery.t_id;
-    return this.resolver.listVersionRegisters({
-      versionRegistryTopicId,
-      skillUid: params.skillUid,
-      limit: params.limit
-    });
+  const parsedOperation = hcs26OperationEnumSchema.safeParse(operation);
+  if (!parsedOperation.success) {
+    return null;
   }
-  async resolveSkillVersion(params) {
-    const versionRaw = params.version.trim();
-    if (!versionRaw) {
-      throw new Error("version is required");
-    }
-    const discovery = await this.resolver.resolveDiscoveryRecord({
-      directoryTopicId: params.directoryTopicId,
-      skillUid: params.skillUid,
-      scanLimit: params.discoveryScanLimit
-    });
-    if (!discovery) {
-      return null;
-    }
-    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 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;
-      }
-    }
-    return {
-      directoryTopicId: params.directoryTopicId,
-      skillUid: params.skillUid,
-      discovery,
-      versionRegistryTopicId,
-      versionEntry: target,
-      manifest,
-      manifestSha256Hex: sha256Hex,
-      ...includeVerification ? { verification } : {}
-    };
+  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 {
-  HCS26BaseClient
+  HCS26_DEFAULT_TTL_SECONDS,
+  buildHcs26TopicMemo,
+  buildHcs26TransactionMemo,
+  hcs26TopicMemoSchema,
+  hcs26TransactionMemoSchema,
+  parseHcs26TopicMemo,
+  parseHcs26TransactionMemo
 };
 //# sourceMappingURL=standards-sdk.es144.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es144.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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"}
+{"version":3,"file":"standards-sdk.es144.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.es145.js

@@ -1,37 +1,163 @@
-import { getSkillVerificationStatus } from "./standards-sdk.es210.js";
-import { HCS26BaseClient } from "./standards-sdk.es144.js";
-function mapVerification(status) {
-  const pendingRequest = status.pendingRequest ?? void 0;
-  return {
-    name: status.name,
-    verified: status.verified,
-    previouslyVerified: status.previouslyVerified,
-    ...pendingRequest ? { pendingRequest } : {}
-  };
-}
-function createRegistryBrokerVerificationProvider(client) {
-  return {
-    async getSkillVerificationStatus(params) {
-      const status = await getSkillVerificationStatus(client, {
-        name: params.name
-      });
-      return mapVerification(status);
-    }
-  };
+import { Logger } from "./standards-sdk.es148.js";
+import { Hcs26SkillRegistryResolver } from "./standards-sdk.es143.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);
 }
-class HCS26Client extends HCS26BaseClient {
+class 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
+    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
+    });
+  }
+  async resolveSkill(params) {
+    const discovery = await this.resolver.resolveDiscoveryRecord({
+      directoryTopicId: params.directoryTopicId,
+      skillUid: params.skillUid,
+      scanLimit: params.discoveryScanLimit
+    });
+    if (!discovery) {
+      return null;
+    }
+    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}`
+      );
+    }
+    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 {
+      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
+    });
+    if (!discovery) {
+      return [];
+    }
+    const versionRegistryTopicId = discovery.t_id;
+    return this.resolver.listVersionRegisters({
+      versionRegistryTopicId,
+      skillUid: params.skillUid,
+      limit: params.limit
+    });
+  }
+  async resolveSkillVersion(params) {
+    const versionRaw = params.version.trim();
+    if (!versionRaw) {
+      throw new Error("version is required");
+    }
+    const discovery = await this.resolver.resolveDiscoveryRecord({
+      directoryTopicId: params.directoryTopicId,
+      skillUid: params.skillUid,
+      scanLimit: params.discoveryScanLimit
     });
+    if (!discovery) {
+      return null;
+    }
+    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 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;
+      }
+    }
+    return {
+      directoryTopicId: params.directoryTopicId,
+      skillUid: params.skillUid,
+      discovery,
+      versionRegistryTopicId,
+      versionEntry: target,
+      manifest,
+      manifestSha256Hex: sha256Hex,
+      ...includeVerification ? { verification } : {}
+    };
   }
 }
 export {
-  HCS26Client,
-  createRegistryBrokerVerificationProvider
+  HCS26BaseClient
 };
 //# sourceMappingURL=standards-sdk.es145.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es145.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;"}
+{"version":3,"file":"standards-sdk.es145.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":";;AA+DA,SAAS,mBACP,OACQ;AACR,QAAM,mBAAoB,MAA6B;AACvD,MAAI,OAAO,qBAAqB,YAAY,iBAAiB,QAAQ;AACnE,WAAO,iBAAiB,KAAA;AAAA,EAC1B;AAEA,QAAM,eAAgB,MAAsC;AAC5D,MAAI,OAAO,iBAAiB,YAAY,CAAC,aAAa,QAAQ;AAC5D,UAAM,IAAI,MAAM,sDAAsD;AAAA,EACxE;AAEA,QAAM,MAAM,aAAa,KAAA;AACzB,QAAM,SAAS;AACf,MAAI,CAAC,IAAI,WAAW,MAAM,GAAG;AAC3B,UAAM,IAAI,MAAM,yBAAyB,GAAG,EAAE;AAAA,EAChD;AACA,SAAO,IAAI,MAAM,OAAO,MAAM;AAChC;AAEO,MAAM,gBAAgB;AAAA,EAM3B,YAAY,QAA2B;AACrC,SAAK,UAAU,OAAO;AACtB,SAAK,SACH,OAAO,UACP,OAAO,YAAY;AAAA,MACjB,QAAQ;AAAA,MACR,OAAO;AAAA,IAAA,CACR;AACH,SAAK,uBAAuB,OAAO;AAEnC,SAAK,WAAW,IAAI,2BAA2B;AAAA,MAC7C,SAAS,KAAK;AAAA,MACd,QAAQ,KAAK;AAAA,MACb,YAAY,OAAO;AAAA,IAAA,CACpB;AAAA,EACH;AAAA,EAEA,MAAM,aAAa,QAKoB;AACrC,UAAM,YAAa,MAAM,KAAK,SAAS,uBAAuB;AAAA,MAC5D,kBAAkB,OAAO;AAAA,MACzB,UAAU,OAAO;AAAA,MACjB,WAAW,OAAO;AAAA,IAAA,CACnB;AAED,QAAI,CAAC,WAAW;AACd,aAAO;AAAA,IACT;AAEA,UAAM,yBAAyB,UAAU;AACzC,UAAM,gBAAgB,MAAM,KAAK,SAAS,yBAAyB;AAAA,MACjE;AAAA,MACA,UAAU,OAAO;AAAA,IAAA,CAClB;AAED,QAAI,CAAC,eAAe;AAClB,YAAM,IAAI;AAAA,QACR,6CAA6C,OAAO,QAAQ,wBAAwB,sBAAsB;AAAA,MAAA;AAAA,IAE9G;AAEA,UAAM,kBAAkB,mBAAmB,aAAa;AACxD,UAAM,EAAE,UAAU,UAAA,IAAc,MAAM,KAAK,SAAS,gBAAgB;AAAA,MAClE;AAAA,IAAA,CACD;AAED,UAAM,KAAK,SAAS,qCAAqC;AAAA,MACvD,iBAAiB;AAAA,MACjB,mBAAmB;AAAA,IAAA,CACpB;AAED,QAAI;AACJ,UAAM,WAAW,KAAK;AACtB,UAAM,sBAAsB,OAAO,wBAAwB;AAC3D,UAAM,OACJ,OAAO,UAAU,UAAU,SAAS,WAChC,UAAU,SAAS,KAAK,KAAA,IACxB;AAEN,QAAI,uBAAuB,YAAY,MAAM;AAC3C,UAAI;AACF,uBAAe,MAAM,SAAS,2BAA2B,EAAE,MAAM;AAAA,MACnE,SAAS,OAAO;AACd,cAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,aAAK,OAAO;AAAA,UACV,oDAAoD,IAAI,MAAM,MAAM;AAAA,QAAA;AAEtE,uBAAe;AAAA,MACjB;AAAA,IACF;AAEA,WAAO;AAAA,MACL,kBAAkB,OAAO;AAAA,MACzB,UAAU,OAAO;AAAA,MACjB;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,mBAAmB;AAAA,MACnB,GAAI,sBAAsB,EAAE,iBAAiB,CAAA;AAAA,IAAC;AAAA,EAElD;AAAA,EAEA,MAAM,kBAAkB,QAUtB;AACA,UAAM,YAAa,MAAM,KAAK,SAAS,uBAAuB;AAAA,MAC5D,kBAAkB,OAAO;AAAA,MACzB,UAAU,OAAO;AAAA,MACjB,WAAW,OAAO;AAAA,IAAA,CACnB;AAED,QAAI,CAAC,WAAW;AACd,aAAO,CAAA;AAAA,IACT;AAEA,UAAM,yBAAyB,UAAU;AACzC,WAAO,KAAK,SAAS,qBAAqB;AAAA,MACxC;AAAA,MACA,UAAU,OAAO;AAAA,MACjB,OAAO,OAAO;AAAA,IAAA,CACf;AAAA,EACH;AAAA,EAEA,MAAM,oBAAoB,QAMoB;AAC5C,UAAM,aAAa,OAAO,QAAQ,KAAA;AAClC,QAAI,CAAC,YAAY;AACf,YAAM,IAAI,MAAM,qBAAqB;AAAA,IACvC;AAEA,UAAM,YAAa,MAAM,KAAK,SAAS,uBAAuB;AAAA,MAC5D,kBAAkB,OAAO;AAAA,MACzB,UAAU,OAAO;AAAA,MACjB,WAAW,OAAO;AAAA,IAAA,CACnB;AAED,QAAI,CAAC,WAAW;AACd,aAAO;AAAA,IACT;AAEA,UAAM,yBAAyB,UAAU;AACzC,UAAM,UAAU,MAAM,KAAK,SAAS,qBAAqB;AAAA,MACvD;AAAA,MACA,UAAU,OAAO;AAAA,MACjB,OAAO;AAAA,IAAA,CACR;AAED,UAAM,SAAS,QAAQ,KAAK,CAAA,UAAS,MAAM,QAAQ,KAAA,MAAW,UAAU;AACxE,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AAEA,UAAM,kBAAkB,mBAAmB,MAAM;AACjD,UAAM,EAAE,UAAU,UAAA,IAAc,MAAM,KAAK,SAAS,gBAAgB;AAAA,MAClE;AAAA,IAAA,CACD;AAED,UAAM,KAAK,SAAS,qCAAqC;AAAA,MACvD,iBAAiB;AAAA,MACjB,mBAAmB;AAAA,IAAA,CACpB;AAED,QAAI;AACJ,UAAM,WAAW,KAAK;AACtB,UAAM,sBAAsB,OAAO,wBAAwB;AAC3D,UAAM,OACJ,OAAO,UAAU,UAAU,SAAS,WAChC,UAAU,SAAS,KAAK,KAAA,IACxB;AAEN,QAAI,uBAAuB,YAAY,MAAM;AAC3C,UAAI;AACF,uBAAe,MAAM,SAAS,2BAA2B,EAAE,MAAM;AAAA,MACnE,SAAS,OAAO;AACd,cAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,aAAK,OAAO;AAAA,UACV,oDAAoD,IAAI,MAAM,MAAM;AAAA,QAAA;AAEtE,uBAAe;AAAA,MACjB;AAAA,IACF;AAEA,WAAO;AAAA,MACL,kBAAkB,OAAO;AAAA,MACzB,UAAU,OAAO;AAAA,MACjB;AAAA,MACA;AAAA,MACA,cAAc;AAAA,MACd;AAAA,MACA,mBAAmB;AAAA,MACnB,GAAI,sBAAsB,EAAE,iBAAiB,CAAA;AAAA,IAAC;AAAA,EAElD;AACF;"}

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

@@ -1,15 +1,37 @@
-import { HCS26BaseClient } from "./standards-sdk.es144.js";
-class HCS26BrowserClient extends HCS26BaseClient {
+import { getSkillVerificationStatus } from "./standards-sdk.es214.js";
+import { HCS26BaseClient } from "./standards-sdk.es145.js";
+function mapVerification(status) {
+  const pendingRequest = status.pendingRequest ?? void 0;
+  return {
+    name: status.name,
+    verified: status.verified,
+    previouslyVerified: status.previouslyVerified,
+    ...pendingRequest ? { pendingRequest } : {}
+  };
+}
+function createRegistryBrokerVerificationProvider(client) {
+  return {
+    async getSkillVerificationStatus(params) {
+      const status = await getSkillVerificationStatus(client, {
+        name: params.name
+      });
+      return mapVerification(status);
+    }
+  };
+}
+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: config.verificationProvider
+      verificationProvider: provider
     });
   }
 }
 export {
-  HCS26BrowserClient
+  HCS26Client,
+  createRegistryBrokerVerificationProvider
 };
 //# sourceMappingURL=standards-sdk.es146.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es146.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.es146.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;"}