@hashgraphonline/standards-sdk 0.1.166 → 0.1.168

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

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