@hashgraphonline/standards-sdk 0.1.171 → 0.1.172

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

@@ -1,84 +1,203 @@
-const orderedParamKeys = [
-  "uid",
-  "registry",
-  "proto",
-  "nativeId",
-  "domain",
-  "src"
-];
-const fqdnLabelRegex = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/i;
-function uaidTargetFromParsed(parsed) {
-  return parsed.method === "aid" ? "aid" : "did";
+import { parseSemicolonFields } from "./standards-sdk.es164.js";
+const ANS_HCS27_REGISTRY = "ans";
+function isObjectRecord(value) {
+  return typeof value === "object" && value !== null;
 }
-function normalizeDomain(value) {
-  return value.trim().replace(/\.$/, "").toLowerCase();
+function asString(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return null;
+  }
+  return trimmed;
 }
-function isFqdn(value) {
-  const normalized = normalizeDomain(value);
-  if (!normalized || normalized.length > 253 || !normalized.includes(".")) {
-    return false;
+function isSemver(value) {
+  return /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.test(
+    value
+  );
+}
+function normalizeAnsVersion(value) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return null;
   }
-  const labels = normalized.split(".");
-  for (const label of labels) {
-    if (!label || label.length > 63 || !fqdnLabelRegex.test(label)) {
-      return false;
+  const withoutPrefix = trimmed.startsWith("v") || trimmed.startsWith("V") ? trimmed.slice(1) : trimmed;
+  if (!isSemver(withoutPrefix)) {
+    return null;
+  }
+  return withoutPrefix;
+}
+function parseAnsDnsTxtRecord(rawRecord) {
+  const fields = parseSemicolonFields(rawRecord);
+  const version = fields["v"];
+  const urlValue = fields["url"];
+  if (!version || !urlValue || version.toLowerCase() !== "ans1") {
+    return null;
+  }
+  let parsedUrl;
+  try {
+    parsedUrl = new URL(urlValue);
+  } catch {
+    return null;
+  }
+  if (parsedUrl.protocol.toLowerCase() !== "https:") {
+    return null;
+  }
+  const rawAnsVersion = fields["version"];
+  let normalizedAnsVersion;
+  if (rawAnsVersion !== void 0) {
+    const parsedVersion = normalizeAnsVersion(rawAnsVersion);
+    if (!parsedVersion) {
+      return null;
     }
+    normalizedAnsVersion = parsedVersion;
   }
-  return true;
+  return {
+    version: normalizedAnsVersion,
+    url: parsedUrl.toString()
+  };
 }
-function normalizeTxtValue(value) {
-  const trimmed = value.trim();
-  if (trimmed.length >= 2 && trimmed.startsWith('"') && trimmed.endsWith('"')) {
-    return trimmed.slice(1, -1);
+function isValidAnsProfileVersion(value) {
+  return !!value && normalizeAnsVersion(value) !== null;
+}
+function hasProtocolPathSegment(pathname, protocol) {
+  const normalizedProtocol = protocol.trim().toLowerCase();
+  if (!normalizedProtocol) {
+    return false;
   }
-  const markdownLinkMatch = trimmed.match(/^\[(.+)\]\((.+)\)$/);
-  if (markdownLinkMatch) {
-    return markdownLinkMatch[2].trim();
+  const pathSegments = pathname.split("/").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
+  for (const segment of pathSegments) {
+    if (segment.toLowerCase() === normalizedProtocol) {
+      return true;
+    }
   }
-  return trimmed;
+  return false;
 }
-function parseSemicolonFields(input) {
-  const fields = {};
-  for (const part of input.split(";")) {
-    const trimmed = part.trim();
-    if (!trimmed) {
+function extractEndpointCandidates(endpoints, supportedSchemes) {
+  const candidates = [];
+  for (const [key, value] of Object.entries(endpoints)) {
+    if (!isObjectRecord(value)) {
       continue;
     }
-    const equalsIndex = trimmed.indexOf("=");
-    if (equalsIndex <= 0) {
+    const endpoint = asString(value["url"]);
+    if (!endpoint) {
       continue;
     }
-    const key = trimmed.slice(0, equalsIndex).trim();
-    const value = normalizeTxtValue(trimmed.slice(equalsIndex + 1));
-    if (!key || !value) {
+    let parsedUrl;
+    try {
+      parsedUrl = new URL(endpoint);
+    } catch {
       continue;
     }
-    fields[key] = value;
+    const scheme = parsedUrl.protocol.replace(/:$/, "").toLowerCase();
+    if (!supportedSchemes.has(scheme)) {
+      continue;
+    }
+    candidates.push({
+      key,
+      endpointUrl: parsedUrl.toString(),
+      parsedUrl
+    });
   }
-  return fields;
+  return candidates;
 }
-function buildCanonicalUaid(target, id, params) {
-  const entries = [];
-  const usedKeys = /* @__PURE__ */ new Set();
-  for (const key of orderedParamKeys) {
-    const value = params[key];
-    if (value) {
-      entries.push(`${key}=${value}`);
-      usedKeys.add(key);
-    }
+function validateAnsHcs27Hints(input) {
+  if (!isObjectRecord(input)) {
+    return void 0;
+  }
+  const checkpointTopicId = asString(input["checkpoint_topic_id"]);
+  const registry = asString(input["registry"]);
+  const logId = asString(input["log_id"]);
+  if (!checkpointTopicId || !registry || !logId || registry !== ANS_HCS27_REGISTRY) {
+    return void 0;
+  }
+  const checkpointUri = asString(input["checkpoint_uri"]) ?? void 0;
+  const viewerUri = asString(input["viewer_uri"]) ?? void 0;
+  return {
+    checkpointTopicId,
+    registry,
+    logId,
+    checkpointUri,
+    viewerUri
+  };
+}
+function validateHcs28Hints(input) {
+  if (!isObjectRecord(input)) {
+    return void 0;
+  }
+  const directoryTopicId = asString(input["directory_topic_id"]);
+  const tId = asString(input["t_id"]);
+  const agentId = asString(input["agent_id"]);
+  if (!directoryTopicId || !tId || !agentId) {
+    return void 0;
+  }
+  const proofProfile = asString(input["proof_profile"]) ?? void 0;
+  return {
+    directoryTopicId,
+    tId,
+    agentId,
+    proofProfile
+  };
+}
+function parseTransparencyHints(input) {
+  if (!isObjectRecord(input)) {
+    return void 0;
   }
-  const extraKeys = Object.keys(params).filter((key) => !usedKeys.has(key) && params[key]).sort((a, b) => a.localeCompare(b));
-  for (const key of extraKeys) {
-    entries.push(`${key}=${params[key]}`);
+  const hcs27 = validateAnsHcs27Hints(input["hcs27"]);
+  const hcs28 = validateHcs28Hints(input["hcs28"]);
+  if (!hcs27 && !hcs28) {
+    return void 0;
+  }
+  return {
+    hcs27,
+    hcs28
+  };
+}
+function parseAnsAgentCard(input) {
+  if (!isObjectRecord(input)) {
+    return null;
+  }
+  const ansName = asString(input["ansName"]);
+  const endpoints = input["endpoints"];
+  if (!ansName || !isObjectRecord(endpoints)) {
+    return null;
+  }
+  return {
+    ansName,
+    endpoints,
+    transparencyHints: parseTransparencyHints(input["transparency"])
+  };
+}
+function selectPreferredEndpoint(candidates, protocol) {
+  if (candidates.length === 0) {
+    return null;
+  }
+  const sortedCandidates = [...candidates].sort(
+    (a, b) => a.key.localeCompare(b.key)
+  );
+  const protocolMatches = sortedCandidates.filter(
+    (candidate) => hasProtocolPathSegment(candidate.parsedUrl.pathname, protocol)
+  );
+  if (protocolMatches.length > 0) {
+    return protocolMatches[0];
+  }
+  return sortedCandidates[0];
+}
+function toErrorMessage(error) {
+  if (error instanceof Error && error.message) {
+    return error.message;
   }
-  return entries.length > 0 ? `uaid:${target}:${id};${entries.join(";")}` : `uaid:${target}:${id}`;
+  return null;
 }
 export {
-  buildCanonicalUaid,
-  isFqdn,
-  normalizeDomain,
-  normalizeTxtValue,
-  parseSemicolonFields,
-  uaidTargetFromParsed
+  extractEndpointCandidates,
+  isValidAnsProfileVersion,
+  normalizeAnsVersion,
+  parseAnsAgentCard,
+  parseAnsDnsTxtRecord,
+  selectPreferredEndpoint,
+  toErrorMessage
 };
 //# sourceMappingURL=standards-sdk.es165.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es165.js","sources":["../../src/hcs-14/resolvers/profile-utils.ts"],"sourcesContent":["import type { ParsedHcs14Did } from '../types';\n\nconst orderedParamKeys = [\n  'uid',\n  'registry',\n  'proto',\n  'nativeId',\n  'domain',\n  'src',\n] as const;\n\nconst fqdnLabelRegex = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/i;\n\nexport function uaidTargetFromParsed(parsed: ParsedHcs14Did): 'aid' | 'did' {\n  return parsed.method === 'aid' ? 'aid' : 'did';\n}\n\nexport function normalizeDomain(value: string): string {\n  return value.trim().replace(/\\.$/, '').toLowerCase();\n}\n\nexport function isFqdn(value: string): boolean {\n  const normalized = normalizeDomain(value);\n  if (!normalized || normalized.length > 253 || !normalized.includes('.')) {\n    return false;\n  }\n  const labels = normalized.split('.');\n  for (const label of labels) {\n    if (!label || label.length > 63 || !fqdnLabelRegex.test(label)) {\n      return false;\n    }\n  }\n  return true;\n}\n\nexport function normalizeTxtValue(value: string): string {\n  const trimmed = value.trim();\n  if (trimmed.length >= 2 && trimmed.startsWith('\"') && trimmed.endsWith('\"')) {\n    return trimmed.slice(1, -1);\n  }\n  const markdownLinkMatch = trimmed.match(/^\\[(.+)\\]\\((.+)\\)$/);\n  if (markdownLinkMatch) {\n    return markdownLinkMatch[2].trim();\n  }\n  return trimmed;\n}\n\nexport function parseSemicolonFields(input: string): Record<string, string> {\n  const fields: Record<string, string> = {};\n  for (const part of input.split(';')) {\n    const trimmed = part.trim();\n    if (!trimmed) {\n      continue;\n    }\n    const equalsIndex = trimmed.indexOf('=');\n    if (equalsIndex <= 0) {\n      continue;\n    }\n    const key = trimmed.slice(0, equalsIndex).trim();\n    const value = normalizeTxtValue(trimmed.slice(equalsIndex + 1));\n    if (!key || !value) {\n      continue;\n    }\n    fields[key] = value;\n  }\n  return fields;\n}\n\nexport function buildCanonicalUaid(\n  target: 'aid' | 'did',\n  id: string,\n  params: Record<string, string>,\n): string {\n  const entries: string[] = [];\n  const usedKeys = new Set<string>();\n\n  for (const key of orderedParamKeys) {\n    const value = params[key];\n    if (value) {\n      entries.push(`${key}=${value}`);\n      usedKeys.add(key);\n    }\n  }\n\n  const extraKeys = Object.keys(params)\n    .filter(key => !usedKeys.has(key) && params[key])\n    .sort((a, b) => a.localeCompare(b));\n\n  for (const key of extraKeys) {\n    entries.push(`${key}=${params[key]}`);\n  }\n\n  return entries.length > 0\n    ? `uaid:${target}:${id};${entries.join(';')}`\n    : `uaid:${target}:${id}`;\n}\n\nexport function canonicalizeUaidFromParsed(parsed: ParsedHcs14Did): string {\n  return buildCanonicalUaid(\n    uaidTargetFromParsed(parsed),\n    parsed.id,\n    parsed.params,\n  );\n}\n"],"names":[],"mappings":"AAEA,MAAM,mBAAmB;AAAA,EACvB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,iBAAiB;AAEhB,SAAS,qBAAqB,QAAuC;AAC1E,SAAO,OAAO,WAAW,QAAQ,QAAQ;AAC3C;AAEO,SAAS,gBAAgB,OAAuB;AACrD,SAAO,MAAM,OAAO,QAAQ,OAAO,EAAE,EAAE,YAAA;AACzC;AAEO,SAAS,OAAO,OAAwB;AAC7C,QAAM,aAAa,gBAAgB,KAAK;AACxC,MAAI,CAAC,cAAc,WAAW,SAAS,OAAO,CAAC,WAAW,SAAS,GAAG,GAAG;AACvE,WAAO;AAAA,EACT;AACA,QAAM,SAAS,WAAW,MAAM,GAAG;AACnC,aAAW,SAAS,QAAQ;AAC1B,QAAI,CAAC,SAAS,MAAM,SAAS,MAAM,CAAC,eAAe,KAAK,KAAK,GAAG;AAC9D,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,kBAAkB,OAAuB;AACvD,QAAM,UAAU,MAAM,KAAA;AACtB,MAAI,QAAQ,UAAU,KAAK,QAAQ,WAAW,GAAG,KAAK,QAAQ,SAAS,GAAG,GAAG;AAC3E,WAAO,QAAQ,MAAM,GAAG,EAAE;AAAA,EAC5B;AACA,QAAM,oBAAoB,QAAQ,MAAM,oBAAoB;AAC5D,MAAI,mBAAmB;AACrB,WAAO,kBAAkB,CAAC,EAAE,KAAA;AAAA,EAC9B;AACA,SAAO;AACT;AAEO,SAAS,qBAAqB,OAAuC;AAC1E,QAAM,SAAiC,CAAA;AACvC,aAAW,QAAQ,MAAM,MAAM,GAAG,GAAG;AACnC,UAAM,UAAU,KAAK,KAAA;AACrB,QAAI,CAAC,SAAS;AACZ;AAAA,IACF;AACA,UAAM,cAAc,QAAQ,QAAQ,GAAG;AACvC,QAAI,eAAe,GAAG;AACpB;AAAA,IACF;AACA,UAAM,MAAM,QAAQ,MAAM,GAAG,WAAW,EAAE,KAAA;AAC1C,UAAM,QAAQ,kBAAkB,QAAQ,MAAM,cAAc,CAAC,CAAC;AAC9D,QAAI,CAAC,OAAO,CAAC,OAAO;AAClB;AAAA,IACF;AACA,WAAO,GAAG,IAAI;AAAA,EAChB;AACA,SAAO;AACT;AAEO,SAAS,mBACd,QACA,IACA,QACQ;AACR,QAAM,UAAoB,CAAA;AAC1B,QAAM,+BAAe,IAAA;AAErB,aAAW,OAAO,kBAAkB;AAClC,UAAM,QAAQ,OAAO,GAAG;AACxB,QAAI,OAAO;AACT,cAAQ,KAAK,GAAG,GAAG,IAAI,KAAK,EAAE;AAC9B,eAAS,IAAI,GAAG;AAAA,IAClB;AAAA,EACF;AAEA,QAAM,YAAY,OAAO,KAAK,MAAM,EACjC,OAAO,CAAA,QAAO,CAAC,SAAS,IAAI,GAAG,KAAK,OAAO,GAAG,CAAC,EAC/C,KAAK,CAAC,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AAEpC,aAAW,OAAO,WAAW;AAC3B,YAAQ,KAAK,GAAG,GAAG,IAAI,OAAO,GAAG,CAAC,EAAE;AAAA,EACtC;AAEA,SAAO,QAAQ,SAAS,IACpB,QAAQ,MAAM,IAAI,EAAE,IAAI,QAAQ,KAAK,GAAG,CAAC,KACzC,QAAQ,MAAM,IAAI,EAAE;AAC1B;"}
+{"version":3,"file":"standards-sdk.es165.js","sources":["../../src/hcs-14/resolvers/ans-dns-web-profile-utils.ts"],"sourcesContent":["import type {\n  ProfileResolutionHcs27TransparencyHints,\n  ProfileResolutionHcs28TransparencyHints,\n  ProfileResolutionTransparencyHints,\n} from './types';\nimport { parseSemicolonFields } from './profile-utils';\n\nexport interface AnsDnsTxtRecord {\n  version?: string;\n  url: string;\n}\n\nexport interface AnsEndpointCandidate {\n  key: string;\n  endpointUrl: string;\n  parsedUrl: URL;\n}\n\nexport interface ParsedAnsAgentCard {\n  ansName: string;\n  endpoints: Record<string, unknown>;\n  transparencyHints?: ProfileResolutionTransparencyHints;\n}\n\nconst ANS_HCS27_REGISTRY = 'ans';\n\nfunction isObjectRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction asString(value: unknown): string | null {\n  if (typeof value !== 'string') {\n    return null;\n  }\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return null;\n  }\n  return trimmed;\n}\n\nfunction isSemver(value: string): boolean {\n  return /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/.test(\n    value,\n  );\n}\n\nexport function normalizeAnsVersion(value: string): string | null {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return null;\n  }\n  const withoutPrefix =\n    trimmed.startsWith('v') || trimmed.startsWith('V')\n      ? trimmed.slice(1)\n      : trimmed;\n  if (!isSemver(withoutPrefix)) {\n    return null;\n  }\n  return withoutPrefix;\n}\n\nexport function parseAnsDnsTxtRecord(\n  rawRecord: string,\n): AnsDnsTxtRecord | null {\n  const fields = parseSemicolonFields(rawRecord);\n  const version = fields['v'];\n  const urlValue = fields['url'];\n  if (!version || !urlValue || version.toLowerCase() !== 'ans1') {\n    return null;\n  }\n\n  let parsedUrl: URL;\n  try {\n    parsedUrl = new URL(urlValue);\n  } catch {\n    return null;\n  }\n\n  if (parsedUrl.protocol.toLowerCase() !== 'https:') {\n    return null;\n  }\n\n  const rawAnsVersion = fields['version'];\n  let normalizedAnsVersion: string | undefined;\n  if (rawAnsVersion !== undefined) {\n    const parsedVersion = normalizeAnsVersion(rawAnsVersion);\n    if (!parsedVersion) {\n      return null;\n    }\n    normalizedAnsVersion = parsedVersion;\n  }\n\n  return {\n    version: normalizedAnsVersion,\n    url: parsedUrl.toString(),\n  };\n}\n\nexport function isValidAnsProfileVersion(value: string | undefined): boolean {\n  return !!value && normalizeAnsVersion(value) !== null;\n}\n\nfunction hasProtocolPathSegment(pathname: string, protocol: string): boolean {\n  const normalizedProtocol = protocol.trim().toLowerCase();\n  if (!normalizedProtocol) {\n    return false;\n  }\n\n  const pathSegments = pathname\n    .split('/')\n    .map(segment => segment.trim())\n    .filter(segment => segment.length > 0);\n  for (const segment of pathSegments) {\n    if (segment.toLowerCase() === normalizedProtocol) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function extractEndpointCandidates(\n  endpoints: Record<string, unknown>,\n  supportedSchemes: Set<string>,\n): AnsEndpointCandidate[] {\n  const candidates: AnsEndpointCandidate[] = [];\n  for (const [key, value] of Object.entries(endpoints)) {\n    if (!isObjectRecord(value)) {\n      continue;\n    }\n    const endpoint = asString(value['url']);\n    if (!endpoint) {\n      continue;\n    }\n\n    let parsedUrl: URL;\n    try {\n      parsedUrl = new URL(endpoint);\n    } catch {\n      continue;\n    }\n\n    const scheme = parsedUrl.protocol.replace(/:$/, '').toLowerCase();\n    if (!supportedSchemes.has(scheme)) {\n      continue;\n    }\n\n    candidates.push({\n      key,\n      endpointUrl: parsedUrl.toString(),\n      parsedUrl,\n    });\n  }\n\n  return candidates;\n}\n\nfunction validateAnsHcs27Hints(\n  input: unknown,\n): ProfileResolutionHcs27TransparencyHints | undefined {\n  if (!isObjectRecord(input)) {\n    return undefined;\n  }\n  const checkpointTopicId = asString(input['checkpoint_topic_id']);\n  const registry = asString(input['registry']);\n  const logId = asString(input['log_id']);\n  if (\n    !checkpointTopicId ||\n    !registry ||\n    !logId ||\n    registry !== ANS_HCS27_REGISTRY\n  ) {\n    return undefined;\n  }\n  const checkpointUri = asString(input['checkpoint_uri']) ?? undefined;\n  const viewerUri = asString(input['viewer_uri']) ?? undefined;\n  return {\n    checkpointTopicId,\n    registry,\n    logId,\n    checkpointUri,\n    viewerUri,\n  };\n}\n\nfunction validateHcs28Hints(\n  input: unknown,\n): ProfileResolutionHcs28TransparencyHints | undefined {\n  if (!isObjectRecord(input)) {\n    return undefined;\n  }\n  const directoryTopicId = asString(input['directory_topic_id']);\n  const tId = asString(input['t_id']);\n  const agentId = asString(input['agent_id']);\n  if (!directoryTopicId || !tId || !agentId) {\n    return undefined;\n  }\n  const proofProfile = asString(input['proof_profile']) ?? undefined;\n  return {\n    directoryTopicId,\n    tId,\n    agentId,\n    proofProfile,\n  };\n}\n\nfunction parseTransparencyHints(\n  input: unknown,\n): ProfileResolutionTransparencyHints | undefined {\n  if (!isObjectRecord(input)) {\n    return undefined;\n  }\n  const hcs27 = validateAnsHcs27Hints(input['hcs27']);\n  const hcs28 = validateHcs28Hints(input['hcs28']);\n  if (!hcs27 && !hcs28) {\n    return undefined;\n  }\n  return {\n    hcs27,\n    hcs28,\n  };\n}\n\nexport function parseAnsAgentCard(input: unknown): ParsedAnsAgentCard | null {\n  if (!isObjectRecord(input)) {\n    return null;\n  }\n  const ansName = asString(input['ansName']);\n  const endpoints = input['endpoints'];\n  if (!ansName || !isObjectRecord(endpoints)) {\n    return null;\n  }\n  return {\n    ansName,\n    endpoints,\n    transparencyHints: parseTransparencyHints(input['transparency']),\n  };\n}\n\nexport function selectPreferredEndpoint(\n  candidates: AnsEndpointCandidate[],\n  protocol: string,\n): AnsEndpointCandidate | null {\n  if (candidates.length === 0) {\n    return null;\n  }\n\n  const sortedCandidates = [...candidates].sort((a, b) =>\n    a.key.localeCompare(b.key),\n  );\n  const protocolMatches = sortedCandidates.filter(candidate =>\n    hasProtocolPathSegment(candidate.parsedUrl.pathname, protocol),\n  );\n  if (protocolMatches.length > 0) {\n    return protocolMatches[0];\n  }\n  return sortedCandidates[0];\n}\n\nexport function toErrorMessage(error: unknown): string | null {\n  if (error instanceof Error && error.message) {\n    return error.message;\n  }\n  return null;\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,203 +1,20 @@
-import { parseSemicolonFields } from "./standards-sdk.es165.js";
-const ANS_HCS27_REGISTRY = "ans";
-function isObjectRecord(value) {
-  return typeof value === "object" && value !== null;
-}
-function asString(value) {
-  if (typeof value !== "string") {
-    return null;
-  }
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return null;
-  }
-  return trimmed;
-}
-function isSemver(value) {
-  return /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/.test(
-    value
-  );
-}
-function normalizeAnsVersion(value) {
-  const trimmed = value.trim();
-  if (!trimmed) {
-    return null;
-  }
-  const withoutPrefix = trimmed.startsWith("v") || trimmed.startsWith("V") ? trimmed.slice(1) : trimmed;
-  if (!isSemver(withoutPrefix)) {
-    return null;
-  }
-  return withoutPrefix;
-}
-function parseAnsDnsTxtRecord(rawRecord) {
-  const fields = parseSemicolonFields(rawRecord);
-  const version = fields["v"];
-  const urlValue = fields["url"];
-  if (!version || !urlValue || version.toLowerCase() !== "ans1") {
-    return null;
-  }
-  let parsedUrl;
-  try {
-    parsedUrl = new URL(urlValue);
-  } catch {
-    return null;
-  }
-  if (parsedUrl.protocol.toLowerCase() !== "https:") {
-    return null;
-  }
-  const rawAnsVersion = fields["version"];
-  let normalizedAnsVersion;
-  if (rawAnsVersion !== void 0) {
-    const parsedVersion = normalizeAnsVersion(rawAnsVersion);
-    if (!parsedVersion) {
-      return null;
-    }
-    normalizedAnsVersion = parsedVersion;
-  }
-  return {
-    version: normalizedAnsVersion,
-    url: parsedUrl.toString()
-  };
-}
-function isValidAnsProfileVersion(value) {
-  return !!value && normalizeAnsVersion(value) !== null;
-}
-function hasProtocolPathSegment(pathname, protocol) {
-  const normalizedProtocol = protocol.trim().toLowerCase();
-  if (!normalizedProtocol) {
-    return false;
-  }
-  const pathSegments = pathname.split("/").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
-  for (const segment of pathSegments) {
-    if (segment.toLowerCase() === normalizedProtocol) {
-      return true;
-    }
-  }
-  return false;
-}
-function extractEndpointCandidates(endpoints, supportedSchemes) {
-  const candidates = [];
-  for (const [key, value] of Object.entries(endpoints)) {
-    if (!isObjectRecord(value)) {
-      continue;
-    }
-    const endpoint = asString(value["url"]);
-    if (!endpoint) {
-      continue;
-    }
-    let parsedUrl;
-    try {
-      parsedUrl = new URL(endpoint);
-    } catch {
-      continue;
-    }
-    const scheme = parsedUrl.protocol.replace(/:$/, "").toLowerCase();
-    if (!supportedSchemes.has(scheme)) {
-      continue;
-    }
-    candidates.push({
-      key,
-      endpointUrl: parsedUrl.toString(),
-      parsedUrl
+import { Logger } from "./standards-sdk.es123.js";
+import { HederaMirrorNode } from "./standards-sdk.es144.js";
+class HCS5BaseClient {
+  /**
+   * Create a new HCS-5 base client
+   */
+  constructor(config) {
+    this.network = config.network;
+    this.logger = config.logger || Logger.getInstance({
+      level: config.logLevel || "info",
+      module: "HCS5Client",
+      silent: config.silent
     });
+    this.mirrorNode = new HederaMirrorNode(this.network, this.logger);
   }
-  return candidates;
-}
-function validateAnsHcs27Hints(input) {
-  if (!isObjectRecord(input)) {
-    return void 0;
-  }
-  const checkpointTopicId = asString(input["checkpoint_topic_id"]);
-  const registry = asString(input["registry"]);
-  const logId = asString(input["log_id"]);
-  if (!checkpointTopicId || !registry || !logId || registry !== ANS_HCS27_REGISTRY) {
-    return void 0;
-  }
-  const checkpointUri = asString(input["checkpoint_uri"]) ?? void 0;
-  const viewerUri = asString(input["viewer_uri"]) ?? void 0;
-  return {
-    checkpointTopicId,
-    registry,
-    logId,
-    checkpointUri,
-    viewerUri
-  };
-}
-function validateHcs28Hints(input) {
-  if (!isObjectRecord(input)) {
-    return void 0;
-  }
-  const directoryTopicId = asString(input["directory_topic_id"]);
-  const tId = asString(input["t_id"]);
-  const agentId = asString(input["agent_id"]);
-  if (!directoryTopicId || !tId || !agentId) {
-    return void 0;
-  }
-  const proofProfile = asString(input["proof_profile"]) ?? void 0;
-  return {
-    directoryTopicId,
-    tId,
-    agentId,
-    proofProfile
-  };
-}
-function parseTransparencyHints(input) {
-  if (!isObjectRecord(input)) {
-    return void 0;
-  }
-  const hcs27 = validateAnsHcs27Hints(input["hcs27"]);
-  const hcs28 = validateHcs28Hints(input["hcs28"]);
-  if (!hcs27 && !hcs28) {
-    return void 0;
-  }
-  return {
-    hcs27,
-    hcs28
-  };
-}
-function parseAnsAgentCard(input) {
-  if (!isObjectRecord(input)) {
-    return null;
-  }
-  const ansName = asString(input["ansName"]);
-  const endpoints = input["endpoints"];
-  if (!ansName || !isObjectRecord(endpoints)) {
-    return null;
-  }
-  return {
-    ansName,
-    endpoints,
-    transparencyHints: parseTransparencyHints(input["transparency"])
-  };
-}
-function selectPreferredEndpoint(candidates, protocol) {
-  if (candidates.length === 0) {
-    return null;
-  }
-  const sortedCandidates = [...candidates].sort(
-    (a, b) => a.key.localeCompare(b.key)
-  );
-  const protocolMatches = sortedCandidates.filter(
-    (candidate) => hasProtocolPathSegment(candidate.parsedUrl.pathname, protocol)
-  );
-  if (protocolMatches.length > 0) {
-    return protocolMatches[0];
-  }
-  return sortedCandidates[0];
-}
-function toErrorMessage(error) {
-  if (error instanceof Error && error.message) {
-    return error.message;
-  }
-  return null;
 }
 export {
-  extractEndpointCandidates,
-  isValidAnsProfileVersion,
-  normalizeAnsVersion,
-  parseAnsAgentCard,
-  parseAnsDnsTxtRecord,
-  selectPreferredEndpoint,
-  toErrorMessage
+  HCS5BaseClient
 };
 //# sourceMappingURL=standards-sdk.es166.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es166.js","sources":["../../src/hcs-14/resolvers/ans-dns-web-profile-utils.ts"],"sourcesContent":["import type {\n  ProfileResolutionHcs27TransparencyHints,\n  ProfileResolutionHcs28TransparencyHints,\n  ProfileResolutionTransparencyHints,\n} from './types';\nimport { parseSemicolonFields } from './profile-utils';\n\nexport interface AnsDnsTxtRecord {\n  version?: string;\n  url: string;\n}\n\nexport interface AnsEndpointCandidate {\n  key: string;\n  endpointUrl: string;\n  parsedUrl: URL;\n}\n\nexport interface ParsedAnsAgentCard {\n  ansName: string;\n  endpoints: Record<string, unknown>;\n  transparencyHints?: ProfileResolutionTransparencyHints;\n}\n\nconst ANS_HCS27_REGISTRY = 'ans';\n\nfunction isObjectRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null;\n}\n\nfunction asString(value: unknown): string | null {\n  if (typeof value !== 'string') {\n    return null;\n  }\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return null;\n  }\n  return trimmed;\n}\n\nfunction isSemver(value: string): boolean {\n  return /^(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*)(?:-[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?(?:\\+[0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*)?$/.test(\n    value,\n  );\n}\n\nexport function normalizeAnsVersion(value: string): string | null {\n  const trimmed = value.trim();\n  if (!trimmed) {\n    return null;\n  }\n  const withoutPrefix =\n    trimmed.startsWith('v') || trimmed.startsWith('V')\n      ? trimmed.slice(1)\n      : trimmed;\n  if (!isSemver(withoutPrefix)) {\n    return null;\n  }\n  return withoutPrefix;\n}\n\nexport function parseAnsDnsTxtRecord(\n  rawRecord: string,\n): AnsDnsTxtRecord | null {\n  const fields = parseSemicolonFields(rawRecord);\n  const version = fields['v'];\n  const urlValue = fields['url'];\n  if (!version || !urlValue || version.toLowerCase() !== 'ans1') {\n    return null;\n  }\n\n  let parsedUrl: URL;\n  try {\n    parsedUrl = new URL(urlValue);\n  } catch {\n    return null;\n  }\n\n  if (parsedUrl.protocol.toLowerCase() !== 'https:') {\n    return null;\n  }\n\n  const rawAnsVersion = fields['version'];\n  let normalizedAnsVersion: string | undefined;\n  if (rawAnsVersion !== undefined) {\n    const parsedVersion = normalizeAnsVersion(rawAnsVersion);\n    if (!parsedVersion) {\n      return null;\n    }\n    normalizedAnsVersion = parsedVersion;\n  }\n\n  return {\n    version: normalizedAnsVersion,\n    url: parsedUrl.toString(),\n  };\n}\n\nexport function isValidAnsProfileVersion(value: string | undefined): boolean {\n  return !!value && normalizeAnsVersion(value) !== null;\n}\n\nfunction hasProtocolPathSegment(pathname: string, protocol: string): boolean {\n  const normalizedProtocol = protocol.trim().toLowerCase();\n  if (!normalizedProtocol) {\n    return false;\n  }\n\n  const pathSegments = pathname\n    .split('/')\n    .map(segment => segment.trim())\n    .filter(segment => segment.length > 0);\n  for (const segment of pathSegments) {\n    if (segment.toLowerCase() === normalizedProtocol) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function extractEndpointCandidates(\n  endpoints: Record<string, unknown>,\n  supportedSchemes: Set<string>,\n): AnsEndpointCandidate[] {\n  const candidates: AnsEndpointCandidate[] = [];\n  for (const [key, value] of Object.entries(endpoints)) {\n    if (!isObjectRecord(value)) {\n      continue;\n    }\n    const endpoint = asString(value['url']);\n    if (!endpoint) {\n      continue;\n    }\n\n    let parsedUrl: URL;\n    try {\n      parsedUrl = new URL(endpoint);\n    } catch {\n      continue;\n    }\n\n    const scheme = parsedUrl.protocol.replace(/:$/, '').toLowerCase();\n    if (!supportedSchemes.has(scheme)) {\n      continue;\n    }\n\n    candidates.push({\n      key,\n      endpointUrl: parsedUrl.toString(),\n      parsedUrl,\n    });\n  }\n\n  return candidates;\n}\n\nfunction validateAnsHcs27Hints(\n  input: unknown,\n): ProfileResolutionHcs27TransparencyHints | undefined {\n  if (!isObjectRecord(input)) {\n    return undefined;\n  }\n  const checkpointTopicId = asString(input['checkpoint_topic_id']);\n  const registry = asString(input['registry']);\n  const logId = asString(input['log_id']);\n  if (\n    !checkpointTopicId ||\n    !registry ||\n    !logId ||\n    registry !== ANS_HCS27_REGISTRY\n  ) {\n    return undefined;\n  }\n  const checkpointUri = asString(input['checkpoint_uri']) ?? undefined;\n  const viewerUri = asString(input['viewer_uri']) ?? undefined;\n  return {\n    checkpointTopicId,\n    registry,\n    logId,\n    checkpointUri,\n    viewerUri,\n  };\n}\n\nfunction validateHcs28Hints(\n  input: unknown,\n): ProfileResolutionHcs28TransparencyHints | undefined {\n  if (!isObjectRecord(input)) {\n    return undefined;\n  }\n  const directoryTopicId = asString(input['directory_topic_id']);\n  const tId = asString(input['t_id']);\n  const agentId = asString(input['agent_id']);\n  if (!directoryTopicId || !tId || !agentId) {\n    return undefined;\n  }\n  const proofProfile = asString(input['proof_profile']) ?? undefined;\n  return {\n    directoryTopicId,\n    tId,\n    agentId,\n    proofProfile,\n  };\n}\n\nfunction parseTransparencyHints(\n  input: unknown,\n): ProfileResolutionTransparencyHints | undefined {\n  if (!isObjectRecord(input)) {\n    return undefined;\n  }\n  const hcs27 = validateAnsHcs27Hints(input['hcs27']);\n  const hcs28 = validateHcs28Hints(input['hcs28']);\n  if (!hcs27 && !hcs28) {\n    return undefined;\n  }\n  return {\n    hcs27,\n    hcs28,\n  };\n}\n\nexport function parseAnsAgentCard(input: unknown): ParsedAnsAgentCard | null {\n  if (!isObjectRecord(input)) {\n    return null;\n  }\n  const ansName = asString(input['ansName']);\n  const endpoints = input['endpoints'];\n  if (!ansName || !isObjectRecord(endpoints)) {\n    return null;\n  }\n  return {\n    ansName,\n    endpoints,\n    transparencyHints: parseTransparencyHints(input['transparency']),\n  };\n}\n\nexport function selectPreferredEndpoint(\n  candidates: AnsEndpointCandidate[],\n  protocol: string,\n): AnsEndpointCandidate | null {\n  if (candidates.length === 0) {\n    return null;\n  }\n\n  const sortedCandidates = [...candidates].sort((a, b) =>\n    a.key.localeCompare(b.key),\n  );\n  const protocolMatches = sortedCandidates.filter(candidate =>\n    hasProtocolPathSegment(candidate.parsedUrl.pathname, protocol),\n  );\n  if (protocolMatches.length > 0) {\n    return protocolMatches[0];\n  }\n  return sortedCandidates[0];\n}\n\nexport function toErrorMessage(error: unknown): string | null {\n  if (error instanceof Error && error.message) {\n    return error.message;\n  }\n  return null;\n}\n"],"names":[],"mappings":";AAwBA,MAAM,qBAAqB;AAE3B,SAAS,eAAe,OAAkD;AACxE,SAAO,OAAO,UAAU,YAAY,UAAU;AAChD;AAEA,SAAS,SAAS,OAA+B;AAC/C,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AACA,QAAM,UAAU,MAAM,KAAA;AACtB,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,SAAS,SAAS,OAAwB;AACxC,SAAO,kIAAkI;AAAA,IACvI;AAAA,EAAA;AAEJ;AAEO,SAAS,oBAAoB,OAA8B;AAChE,QAAM,UAAU,MAAM,KAAA;AACtB,MAAI,CAAC,SAAS;AACZ,WAAO;AAAA,EACT;AACA,QAAM,gBACJ,QAAQ,WAAW,GAAG,KAAK,QAAQ,WAAW,GAAG,IAC7C,QAAQ,MAAM,CAAC,IACf;AACN,MAAI,CAAC,SAAS,aAAa,GAAG;AAC5B,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,SAAS,qBACd,WACwB;AACxB,QAAM,SAAS,qBAAqB,SAAS;AAC7C,QAAM,UAAU,OAAO,GAAG;AAC1B,QAAM,WAAW,OAAO,KAAK;AAC7B,MAAI,CAAC,WAAW,CAAC,YAAY,QAAQ,YAAA,MAAkB,QAAQ;AAC7D,WAAO;AAAA,EACT;AAEA,MAAI;AACJ,MAAI;AACF,gBAAY,IAAI,IAAI,QAAQ;AAAA,EAC9B,QAAQ;AACN,WAAO;AAAA,EACT;AAEA,MAAI,UAAU,SAAS,YAAA,MAAkB,UAAU;AACjD,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,OAAO,SAAS;AACtC,MAAI;AACJ,MAAI,kBAAkB,QAAW;AAC/B,UAAM,gBAAgB,oBAAoB,aAAa;AACvD,QAAI,CAAC,eAAe;AAClB,aAAO;AAAA,IACT;AACA,2BAAuB;AAAA,EACzB;AAEA,SAAO;AAAA,IACL,SAAS;AAAA,IACT,KAAK,UAAU,SAAA;AAAA,EAAS;AAE5B;AAEO,SAAS,yBAAyB,OAAoC;AAC3E,SAAO,CAAC,CAAC,SAAS,oBAAoB,KAAK,MAAM;AACnD;AAEA,SAAS,uBAAuB,UAAkB,UAA2B;AAC3E,QAAM,qBAAqB,SAAS,KAAA,EAAO,YAAA;AAC3C,MAAI,CAAC,oBAAoB;AACvB,WAAO;AAAA,EACT;AAEA,QAAM,eAAe,SAClB,MAAM,GAAG,EACT,IAAI,CAAA,YAAW,QAAQ,KAAA,CAAM,EAC7B,OAAO,CAAA,YAAW,QAAQ,SAAS,CAAC;AACvC,aAAW,WAAW,cAAc;AAClC,QAAI,QAAQ,YAAA,MAAkB,oBAAoB;AAChD,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,0BACd,WACA,kBACwB;AACxB,QAAM,aAAqC,CAAA;AAC3C,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,SAAS,GAAG;AACpD,QAAI,CAAC,eAAe,KAAK,GAAG;AAC1B;AAAA,IACF;AACA,UAAM,WAAW,SAAS,MAAM,KAAK,CAAC;AACtC,QAAI,CAAC,UAAU;AACb;AAAA,IACF;AAEA,QAAI;AACJ,QAAI;AACF,kBAAY,IAAI,IAAI,QAAQ;AAAA,IAC9B,QAAQ;AACN;AAAA,IACF;AAEA,UAAM,SAAS,UAAU,SAAS,QAAQ,MAAM,EAAE,EAAE,YAAA;AACpD,QAAI,CAAC,iBAAiB,IAAI,MAAM,GAAG;AACjC;AAAA,IACF;AAEA,eAAW,KAAK;AAAA,MACd;AAAA,MACA,aAAa,UAAU,SAAA;AAAA,MACvB;AAAA,IAAA,CACD;AAAA,EACH;AAEA,SAAO;AACT;AAEA,SAAS,sBACP,OACqD;AACrD,MAAI,CAAC,eAAe,KAAK,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,QAAM,oBAAoB,SAAS,MAAM,qBAAqB,CAAC;AAC/D,QAAM,WAAW,SAAS,MAAM,UAAU,CAAC;AAC3C,QAAM,QAAQ,SAAS,MAAM,QAAQ,CAAC;AACtC,MACE,CAAC,qBACD,CAAC,YACD,CAAC,SACD,aAAa,oBACb;AACA,WAAO;AAAA,EACT;AACA,QAAM,gBAAgB,SAAS,MAAM,gBAAgB,CAAC,KAAK;AAC3D,QAAM,YAAY,SAAS,MAAM,YAAY,CAAC,KAAK;AACnD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,SAAS,mBACP,OACqD;AACrD,MAAI,CAAC,eAAe,KAAK,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,QAAM,mBAAmB,SAAS,MAAM,oBAAoB,CAAC;AAC7D,QAAM,MAAM,SAAS,MAAM,MAAM,CAAC;AAClC,QAAM,UAAU,SAAS,MAAM,UAAU,CAAC;AAC1C,MAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,SAAS;AACzC,WAAO;AAAA,EACT;AACA,QAAM,eAAe,SAAS,MAAM,eAAe,CAAC,KAAK;AACzD,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,SAAS,uBACP,OACgD;AAChD,MAAI,CAAC,eAAe,KAAK,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,QAAM,QAAQ,sBAAsB,MAAM,OAAO,CAAC;AAClD,QAAM,QAAQ,mBAAmB,MAAM,OAAO,CAAC;AAC/C,MAAI,CAAC,SAAS,CAAC,OAAO;AACpB,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EAAA;AAEJ;AAEO,SAAS,kBAAkB,OAA2C;AAC3E,MAAI,CAAC,eAAe,KAAK,GAAG;AAC1B,WAAO;AAAA,EACT;AACA,QAAM,UAAU,SAAS,MAAM,SAAS,CAAC;AACzC,QAAM,YAAY,MAAM,WAAW;AACnC,MAAI,CAAC,WAAW,CAAC,eAAe,SAAS,GAAG;AAC1C,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,mBAAmB,uBAAuB,MAAM,cAAc,CAAC;AAAA,EAAA;AAEnE;AAEO,SAAS,wBACd,YACA,UAC6B;AAC7B,MAAI,WAAW,WAAW,GAAG;AAC3B,WAAO;AAAA,EACT;AAEA,QAAM,mBAAmB,CAAC,GAAG,UAAU,EAAE;AAAA,IAAK,CAAC,GAAG,MAChD,EAAE,IAAI,cAAc,EAAE,GAAG;AAAA,EAAA;AAE3B,QAAM,kBAAkB,iBAAiB;AAAA,IAAO,CAAA,cAC9C,uBAAuB,UAAU,UAAU,UAAU,QAAQ;AAAA,EAAA;AAE/D,MAAI,gBAAgB,SAAS,GAAG;AAC9B,WAAO,gBAAgB,CAAC;AAAA,EAC1B;AACA,SAAO,iBAAiB,CAAC;AAC3B;AAEO,SAAS,eAAe,OAA+B;AAC5D,MAAI,iBAAiB,SAAS,MAAM,SAAS;AAC3C,WAAO,MAAM;AAAA,EACf;AACA,SAAO;AACT;"}
+{"version":3,"file":"standards-sdk.es166.js","sources":["../../src/hcs-5/base-client.ts"],"sourcesContent":["import { Logger, ILogger } from '../utils/logger';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport { HCS5ClientConfig } from './types';\nimport { NetworkType } from '../utils/types';\n\n/**\n * Base client for HCS-5 operations\n */\nexport abstract class HCS5BaseClient {\n  protected logger: ILogger;\n  protected mirrorNode: HederaMirrorNode;\n  protected network: NetworkType;\n\n  /**\n   * Create a new HCS-5 base client\n   */\n  constructor(config: HCS5ClientConfig) {\n    this.network = config.network;\n    this.logger =\n      config.logger ||\n      Logger.getInstance({\n        level: config.logLevel || 'info',\n        module: 'HCS5Client',\n        silent: config.silent,\n      });\n\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger);\n  }\n}\n"],"names":[],"mappings":";;AAQO,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA,EAQnC,YAAY,QAA0B;AACpC,SAAK,UAAU,OAAO;AACtB,SAAK,SACH,OAAO,UACP,OAAO,YAAY;AAAA,MACjB,OAAO,OAAO,YAAY;AAAA,MAC1B,QAAQ;AAAA,MACR,QAAQ,OAAO;AAAA,IAAA,CAChB;AAEH,SAAK,aAAa,IAAI,iBAAiB,KAAK,SAAS,KAAK,MAAM;AAAA,EAClE;AACF;"}

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

@@ -1,20 +1,76 @@
-import { Logger } from "./standards-sdk.es123.js";
-import { HederaMirrorNode } from "./standards-sdk.es144.js";
-class HCS5BaseClient {
-  /**
-   * Create a new HCS-5 base client
-   */
-  constructor(config) {
-    this.network = config.network;
-    this.logger = config.logger || Logger.getInstance({
-      level: config.logLevel || "info",
-      module: "HCS5Client",
-      silent: config.silent
-    });
-    this.mirrorNode = new HederaMirrorNode(this.network, this.logger);
+import BigNumber from "bignumber.js";
+const TINYBAR_DIVISOR = 1e8;
+function safePositiveTransfers(transfers) {
+  if (!Array.isArray(transfers)) {
+    return [];
   }
+  return transfers.filter(
+    (transfer) => typeof transfer.amount === "number" && transfer.amount > 0
+  ).map((transfer) => ({
+    account: transfer.account,
+    amountTinybar: transfer.amount
+  }));
+}
+function resolvePayerDebitTinybar(transfers, payerAccountId) {
+  if (!Array.isArray(transfers)) {
+    return null;
+  }
+  const payerDebit = transfers.find(
+    (transfer) => transfer.account === payerAccountId && typeof transfer.amount === "number" && transfer.amount < 0
+  );
+  if (!payerDebit || typeof payerDebit.amount !== "number") {
+    return null;
+  }
+  return Math.abs(payerDebit.amount);
+}
+function toHbarString(tinybar) {
+  return new BigNumber(tinybar).dividedBy(TINYBAR_DIVISOR).toFixed();
+}
+function fallbackFeeTinybar(chargedTxFee) {
+  if (typeof chargedTxFee !== "number" || !Number.isFinite(chargedTxFee)) {
+    return null;
+  }
+  if (chargedTxFee <= 0) {
+    return null;
+  }
+  return chargedTxFee;
+}
+function computeInscriptionCostSummary(params) {
+  const { txn, payerAccountId } = params;
+  const positiveTransfers = safePositiveTransfers(txn.transfers);
+  const payerDebitTinybar = resolvePayerDebitTinybar(
+    txn.transfers,
+    payerAccountId
+  );
+  const transferOutflowTinybar = payerDebitTinybar ?? positiveTransfers.reduce((sum, t) => sum + t.amountTinybar, 0);
+  const chargedFeeTinybar = fallbackFeeTinybar(txn.charged_tx_fee);
+  const resolvedTotalTinybar = transferOutflowTinybar > 0 ? transferOutflowTinybar : chargedFeeTinybar;
+  if (!resolvedTotalTinybar || resolvedTotalTinybar <= 0) {
+    return null;
+  }
+  const totalCostHbar = toHbarString(resolvedTotalTinybar);
+  const breakdownTransfers = positiveTransfers.length > 0 ? positiveTransfers.map((transfer) => ({
+    to: transfer.account,
+    amount: toHbarString(transfer.amountTinybar),
+    description: `HBAR transfer from ${payerAccountId}`
+  })) : [
+    {
+      to: "Hedera network",
+      amount: totalCostHbar,
+      description: `Transaction fee debited from ${payerAccountId}`
+    }
+  ];
+  return {
+    totalTinybar: resolvedTotalTinybar,
+    summary: {
+      totalCostHbar,
+      breakdown: {
+        transfers: breakdownTransfers
+      }
+    }
+  };
 }
 export {
-  HCS5BaseClient
+  computeInscriptionCostSummary
 };
 //# sourceMappingURL=standards-sdk.es167.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es167.js","sources":["../../src/hcs-5/base-client.ts"],"sourcesContent":["import { Logger, ILogger } from '../utils/logger';\nimport { HederaMirrorNode } from '../services/mirror-node';\nimport { HCS5ClientConfig } from './types';\nimport { NetworkType } from '../utils/types';\n\n/**\n * Base client for HCS-5 operations\n */\nexport abstract class HCS5BaseClient {\n  protected logger: ILogger;\n  protected mirrorNode: HederaMirrorNode;\n  protected network: NetworkType;\n\n  /**\n   * Create a new HCS-5 base client\n   */\n  constructor(config: HCS5ClientConfig) {\n    this.network = config.network;\n    this.logger =\n      config.logger ||\n      Logger.getInstance({\n        level: config.logLevel || 'info',\n        module: 'HCS5Client',\n        silent: config.silent,\n      });\n\n    this.mirrorNode = new HederaMirrorNode(this.network, this.logger);\n  }\n}\n"],"names":[],"mappings":";;AAQO,MAAe,eAAe;AAAA;AAAA;AAAA;AAAA,EAQnC,YAAY,QAA0B;AACpC,SAAK,UAAU,OAAO;AACtB,SAAK,SACH,OAAO,UACP,OAAO,YAAY;AAAA,MACjB,OAAO,OAAO,YAAY;AAAA,MAC1B,QAAQ;AAAA,MACR,QAAQ,OAAO;AAAA,IAAA,CAChB;AAEH,SAAK,aAAa,IAAI,iBAAiB,KAAK,SAAS,KAAK,MAAM;AAAA,EAClE;AACF;"}
+{"version":3,"file":"standards-sdk.es167.js","sources":["../../src/inscribe/inscription-cost.ts"],"sourcesContent":["import BigNumber from 'bignumber.js';\nimport { Transaction } from '../services/types';\nimport { QuoteResult, InscriptionCostSummary } from './types';\n\nconst TINYBAR_DIVISOR = 100000000;\n\ntype MirrorNodeTransactionLike = Pick<\n  Transaction,\n  'charged_tx_fee' | 'transfers'\n>;\n\ntype CostTransfer = QuoteResult['breakdown']['transfers'][number];\n\nfunction safePositiveTransfers(\n  transfers: Transaction['transfers'] | undefined,\n): Array<{ account: string; amountTinybar: number }> {\n  if (!Array.isArray(transfers)) {\n    return [];\n  }\n\n  return transfers\n    .filter(\n      transfer => typeof transfer.amount === 'number' && transfer.amount > 0,\n    )\n    .map(transfer => ({\n      account: transfer.account,\n      amountTinybar: transfer.amount,\n    }));\n}\n\nfunction resolvePayerDebitTinybar(\n  transfers: Transaction['transfers'] | undefined,\n  payerAccountId: string,\n): number | null {\n  if (!Array.isArray(transfers)) {\n    return null;\n  }\n\n  const payerDebit = transfers.find(\n    transfer =>\n      transfer.account === payerAccountId &&\n      typeof transfer.amount === 'number' &&\n      transfer.amount < 0,\n  );\n\n  if (!payerDebit || typeof payerDebit.amount !== 'number') {\n    return null;\n  }\n\n  return Math.abs(payerDebit.amount);\n}\n\nfunction toHbarString(tinybar: number): string {\n  return new BigNumber(tinybar).dividedBy(TINYBAR_DIVISOR).toFixed();\n}\n\nfunction fallbackFeeTinybar(chargedTxFee: unknown): number | null {\n  if (typeof chargedTxFee !== 'number' || !Number.isFinite(chargedTxFee)) {\n    return null;\n  }\n  if (chargedTxFee <= 0) {\n    return null;\n  }\n  return chargedTxFee;\n}\n\nexport function computeInscriptionCostSummary(params: {\n  txn: MirrorNodeTransactionLike;\n  payerAccountId: string;\n}): { summary: InscriptionCostSummary; totalTinybar: number } | null {\n  const { txn, payerAccountId } = params;\n\n  const positiveTransfers = safePositiveTransfers(txn.transfers);\n  const payerDebitTinybar = resolvePayerDebitTinybar(\n    txn.transfers,\n    payerAccountId,\n  );\n\n  const transferOutflowTinybar =\n    payerDebitTinybar ??\n    positiveTransfers.reduce((sum, t) => sum + t.amountTinybar, 0);\n  const chargedFeeTinybar = fallbackFeeTinybar(txn.charged_tx_fee);\n\n  const resolvedTotalTinybar =\n    transferOutflowTinybar > 0 ? transferOutflowTinybar : chargedFeeTinybar;\n\n  if (!resolvedTotalTinybar || resolvedTotalTinybar <= 0) {\n    return null;\n  }\n\n  const totalCostHbar = toHbarString(resolvedTotalTinybar);\n\n  const breakdownTransfers: CostTransfer[] =\n    positiveTransfers.length > 0\n      ? positiveTransfers.map(transfer => ({\n          to: transfer.account,\n          amount: toHbarString(transfer.amountTinybar),\n          description: `HBAR transfer from ${payerAccountId}`,\n        }))\n      : [\n          {\n            to: 'Hedera network',\n            amount: totalCostHbar,\n            description: `Transaction fee debited from ${payerAccountId}`,\n          },\n        ];\n\n  return {\n    totalTinybar: resolvedTotalTinybar,\n    summary: {\n      totalCostHbar,\n      breakdown: {\n        transfers: breakdownTransfers,\n      },\n    },\n  };\n}\n"],"names":[],"mappings":";AAIA,MAAM,kBAAkB;AASxB,SAAS,sBACP,WACmD;AACnD,MAAI,CAAC,MAAM,QAAQ,SAAS,GAAG;AAC7B,WAAO,CAAA;AAAA,EACT;AAEA,SAAO,UACJ;AAAA,IACC,cAAY,OAAO,SAAS,WAAW,YAAY,SAAS,SAAS;AAAA,EAAA,EAEtE,IAAI,CAAA,cAAa;AAAA,IAChB,SAAS,SAAS;AAAA,IAClB,eAAe,SAAS;AAAA,EAAA,EACxB;AACN;AAEA,SAAS,yBACP,WACA,gBACe;AACf,MAAI,CAAC,MAAM,QAAQ,SAAS,GAAG;AAC7B,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,UAAU;AAAA,IAC3B,CAAA,aACE,SAAS,YAAY,kBACrB,OAAO,SAAS,WAAW,YAC3B,SAAS,SAAS;AAAA,EAAA;AAGtB,MAAI,CAAC,cAAc,OAAO,WAAW,WAAW,UAAU;AACxD,WAAO;AAAA,EACT;AAEA,SAAO,KAAK,IAAI,WAAW,MAAM;AACnC;AAEA,SAAS,aAAa,SAAyB;AAC7C,SAAO,IAAI,UAAU,OAAO,EAAE,UAAU,eAAe,EAAE,QAAA;AAC3D;AAEA,SAAS,mBAAmB,cAAsC;AAChE,MAAI,OAAO,iBAAiB,YAAY,CAAC,OAAO,SAAS,YAAY,GAAG;AACtE,WAAO;AAAA,EACT;AACA,MAAI,gBAAgB,GAAG;AACrB,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,SAAS,8BAA8B,QAGuB;AACnE,QAAM,EAAE,KAAK,eAAA,IAAmB;AAEhC,QAAM,oBAAoB,sBAAsB,IAAI,SAAS;AAC7D,QAAM,oBAAoB;AAAA,IACxB,IAAI;AAAA,IACJ;AAAA,EAAA;AAGF,QAAM,yBACJ,qBACA,kBAAkB,OAAO,CAAC,KAAK,MAAM,MAAM,EAAE,eAAe,CAAC;AAC/D,QAAM,oBAAoB,mBAAmB,IAAI,cAAc;AAE/D,QAAM,uBACJ,yBAAyB,IAAI,yBAAyB;AAExD,MAAI,CAAC,wBAAwB,wBAAwB,GAAG;AACtD,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,aAAa,oBAAoB;AAEvD,QAAM,qBACJ,kBAAkB,SAAS,IACvB,kBAAkB,IAAI,CAAA,cAAa;AAAA,IACjC,IAAI,SAAS;AAAA,IACb,QAAQ,aAAa,SAAS,aAAa;AAAA,IAC3C,aAAa,sBAAsB,cAAc;AAAA,EAAA,EACjD,IACF;AAAA,IACE;AAAA,MACE,IAAI;AAAA,MACJ,QAAQ;AAAA,MACR,aAAa,gCAAgC,cAAc;AAAA,IAAA;AAAA,EAC7D;AAGR,SAAO;AAAA,IACL,cAAc;AAAA,IACd,SAAS;AAAA,MACP;AAAA,MACA,WAAW;AAAA,QACT,WAAW;AAAA,MAAA;AAAA,IACb;AAAA,EACF;AAEJ;"}