@hashgraphonline/standards-sdk 0.1.161 → 0.1.162

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

@@ -1,32 +1,9 @@
-import { multibaseB58btcDecode } from "./standards-sdk.es156.js";
-const UAID_DID_RESOLUTION_PROFILE_ID = "hcs-14.profile.uaid-did-resolution";
-function decodeSrcDid(src) {
-  try {
-    const bytes = multibaseB58btcDecode(src);
-    const decoded = Buffer.from(bytes).toString("utf8").trim();
-    return decoded || null;
-  } catch {
-    return null;
-  }
-}
-function buildHintedService(uaid, params) {
-  const proto = params["proto"];
-  const nativeId = params["nativeId"];
-  const domain = params["domain"];
-  if (!proto && !nativeId && !domain) {
-    return null;
-  }
-  return {
-    id: `${uaid}#hcs14-hinted-service-1`,
-    type: "HintedService",
-    serviceEndpoint: {
-      source: "uaid-parameters",
-      proto,
-      nativeId,
-      domain
-    }
-  };
-}
+import { nodeDnsTxtLookup } from "./standards-sdk.es66.js";
+import { uaidTargetFromParsed, isFqdn, normalizeDomain, buildCanonicalUaid, parseSemicolonFields } from "./standards-sdk.es159.js";
+import { AID_DNS_WEB_PROFILE_ID } from "./standards-sdk.es62.js";
+import { ANS_DNS_WEB_PROFILE_ID } from "./standards-sdk.es63.js";
+import { UAID_DID_RESOLUTION_PROFILE_ID } from "./standards-sdk.es65.js";
+const UAID_DNS_WEB_PROFILE_ID = "hcs-14.profile.uaid-dns-web";
 function buildErrorProfile(uaid, code, message, details) {
   const error = {
     code,
@@ -37,98 +14,242 @@ function buildErrorProfile(uaid, code, message, details) {
     id: uaid,
     error,
     metadata: {
-      profile: UAID_DID_RESOLUTION_PROFILE_ID,
+      profile: UAID_DNS_WEB_PROFILE_ID,
       resolved: false
     }
   };
 }
-function dedupeAlsoKnownAs(baseDid, existing = []) {
-  const values = /* @__PURE__ */ new Set([baseDid, ...existing]);
-  return [...values];
+function canonicalizeNativeDomainParams(params) {
+  const next = { ...params };
+  const nativeId = next["nativeId"];
+  if (nativeId && isFqdn(nativeId)) {
+    next["nativeId"] = normalizeDomain(nativeId);
+  }
+  const domain = next["domain"];
+  if (domain && isFqdn(domain)) {
+    next["domain"] = normalizeDomain(domain);
+  }
+  return next;
 }
-class UaidDidResolutionProfileResolver {
-  constructor() {
-    this.profile = UAID_DID_RESOLUTION_PROFILE_ID;
+function validateRecordFields(fields, queriedNativeId) {
+  const target = fields["target"];
+  const id = fields["id"];
+  const uid = fields["uid"];
+  const proto = fields["proto"];
+  const nativeId = fields["nativeId"];
+  if (target !== "aid" && target !== "did") {
+    return null;
+  }
+  if (!id || !uid || !proto || !nativeId) {
+    return null;
+  }
+  if (normalizeDomain(nativeId) !== queriedNativeId) {
+    return null;
+  }
+  if ("registry" in fields && !fields["registry"]) {
+    return null;
+  }
+  const did = fields["did"];
+  if (did && (target !== "did" || !did.startsWith("did:"))) {
+    return null;
+  }
+  const params = {
+    uid,
+    proto,
+    nativeId
+  };
+  if (fields["registry"]) {
+    params["registry"] = fields["registry"];
+  }
+  if (fields["domain"]) {
+    params["domain"] = fields["domain"];
+  }
+  if (fields["src"]) {
+    params["src"] = fields["src"];
+  }
+  return {
+    target,
+    id,
+    uid,
+    proto,
+    nativeId,
+    registry: fields["registry"],
+    domain: fields["domain"],
+    src: fields["src"],
+    did,
+    memo: fields["m"],
+    reconstructedUaid: buildCanonicalUaid(
+      target,
+      id,
+      canonicalizeNativeDomainParams(params)
+    )
+  };
+}
+function selectFollowupProfiles(parsed) {
+  const target = uaidTargetFromParsed(parsed);
+  if (target === "aid") {
+    if (parsed.params["registry"] === "ans") {
+      return [ANS_DNS_WEB_PROFILE_ID, AID_DNS_WEB_PROFILE_ID];
+    }
+    return [AID_DNS_WEB_PROFILE_ID];
+  }
+  return [UAID_DID_RESOLUTION_PROFILE_ID];
+}
+class UaidDnsWebProfileResolver {
+  constructor(options = {}) {
+    this.adapterKind = "uaid-profile-resolver";
+    this.profile = UAID_DNS_WEB_PROFILE_ID;
     this.meta = {
-      id: "hcs-14/uaid-did-resolution",
+      id: "hcs-14/uaid-dns-web",
       didMethods: ["*"],
-      displayName: "HCS-14 UAID DID Resolution Profile",
-      description: "Resolves uaid:did identifiers to DID Document-compatible output with profile metadata."
+      displayName: "HCS-14 UAID DNS TXT Profile",
+      description: "Binds UAIDs to DNS TXT records at _uaid.<nativeId> and can continue to follow-up profile resolution."
     };
+    this.dnsLookup = options.dnsLookup ?? nodeDnsTxtLookup;
+    this.dnssecValidation = options.dnssecValidation;
+    this.requireFullResolution = options.requireFullResolution ?? false;
+    this.enableFollowupResolution = options.enableFollowupResolution ?? true;
   }
   supports(_uaid, parsed) {
-    return parsed.method === "uaid";
+    const target = uaidTargetFromParsed(parsed);
+    if (target !== "aid" && target !== "did") {
+      return false;
+    }
+    const nativeId = parsed.params["nativeId"];
+    return !!nativeId && isFqdn(nativeId);
   }
   async resolveProfile(uaid, context) {
     const parsed = context.parsedUaid;
-    if (parsed.method !== "uaid") {
+    const target = uaidTargetFromParsed(parsed);
+    if (target !== "aid" && target !== "did") {
       return buildErrorProfile(
         uaid,
-        "ERR_INVALID_UAID",
-        "Identifier is not uaid:did and cannot be resolved by this profile.",
-        { uaid }
+        "ERR_NOT_APPLICABLE",
+        "UAID DNS/Web profile only applies to uaid:aid or uaid:did identifiers."
       );
     }
-    const src = parsed.params["src"];
-    const srcDid = src ? decodeSrcDid(src) : null;
-    const baseDid = srcDid ?? context.did ?? null;
-    if (!baseDid) {
+    const nativeId = parsed.params["nativeId"];
+    if (!nativeId || !isFqdn(nativeId)) {
       return buildErrorProfile(
         uaid,
-        "ERR_BASE_DID_UNDETERMINED",
-        "Unable to determine base DID; provide src parameter or configure method inference.",
-        { uaid }
+        "ERR_NOT_APPLICABLE",
+        "UAID DNS/Web profile requires an FQDN nativeId."
       );
     }
-    const didDocument = context.didDocument && context.didDocument.id === baseDid ? context.didDocument : await context.resolveDid(baseDid);
-    if (!didDocument) {
+    const normalizedNativeId = normalizeDomain(nativeId);
+    const dnsName = `_uaid.${normalizedNativeId}`;
+    const inputCanonical = buildCanonicalUaid(
+      uaidTargetFromParsed(parsed),
+      parsed.id,
+      canonicalizeNativeDomainParams(parsed.params)
+    );
+    const txtRecords = await this.dnsLookup(dnsName);
+    if (txtRecords.length === 0) {
       return buildErrorProfile(
         uaid,
-        "ERR_DID_RESOLUTION_FAILED",
-        "Base DID resolution failed.",
-        { uaid, baseDid }
+        "ERR_NO_DNS_RECORD",
+        "No UAID DNS TXT record was found for the requested nativeId.",
+        { dnsName }
       );
     }
-    if (!didDocument.id || typeof didDocument.id !== "string") {
+    const parsedRecords = txtRecords.map((record) => parseSemicolonFields(record)).map((fields) => validateRecordFields(fields, normalizedNativeId));
+    const validRecords = parsedRecords.filter(
+      (record) => record !== null
+    );
+    if (validRecords.length === 0) {
       return buildErrorProfile(
         uaid,
-        "ERR_DID_DOCUMENT_INVALID",
-        "Resolved DID document is malformed.",
-        { uaid, baseDid }
+        "ERR_INVALID_UAID_DNS_RECORD",
+        "DNS TXT payload at _uaid record is invalid.",
+        { dnsName }
       );
     }
-    const baseServices = didDocument.service ?? [];
-    const hintedService = buildHintedService(uaid, parsed.params);
-    const includeHintedService = baseServices.length === 0 && hintedService !== null;
-    const service = includeHintedService ? [...baseServices, hintedService] : baseServices;
+    const matchingRecords = validRecords.filter(
+      (record) => record.target === target && record.id === parsed.id && record.reconstructedUaid === inputCanonical
+    );
+    if (matchingRecords.length === 0) {
+      return buildErrorProfile(
+        uaid,
+        "ERR_UAID_MISMATCH",
+        "DNS TXT payload does not match the input UAID after canonical reconstruction.",
+        {
+          dnsName,
+          inputCanonical
+        }
+      );
+    }
+    const selected = [...matchingRecords].sort(
+      (a, b) => a.reconstructedUaid.localeCompare(b.reconstructedUaid)
+    )[0];
+    const dnssecValidated = this.dnssecValidation ? await this.dnssecValidation(dnsName) : false;
+    const verificationLevel = dnssecValidated ? "dns-binding-dnssec" : "dns-binding";
+    if (this.enableFollowupResolution) {
+      const followupProfiles = selectFollowupProfiles(parsed);
+      const failedFollowupProfileIds = [];
+      for (const followupProfileId of followupProfiles) {
+        const followup = await context.resolveUaidProfileById(
+          followupProfileId,
+          uaid
+        );
+        if (!followup) {
+          continue;
+        }
+        if (followup.error || followup.metadata?.resolved === false) {
+          failedFollowupProfileIds.push(followupProfileId);
+          continue;
+        }
+        return {
+          ...followup,
+          metadata: {
+            ...followup.metadata,
+            profile: UAID_DNS_WEB_PROFILE_ID,
+            resolved: true,
+            verificationLevel,
+            reconstructedUaid: selected.reconstructedUaid,
+            selectedFollowupProfile: followupProfileId,
+            resolutionMode: "full-resolution"
+          }
+        };
+      }
+      if (failedFollowupProfileIds.length > 0) {
+        return buildErrorProfile(
+          uaid,
+          "ERR_FOLLOWUP_RESOLUTION_FAILED",
+          "Follow-up profile resolution failed after successful DNS binding.",
+          {
+            followupProfileId: failedFollowupProfileIds[failedFollowupProfileIds.length - 1],
+            attemptedFailedProfiles: failedFollowupProfileIds,
+            dnsName
+          }
+        );
+      }
+    }
+    if (this.requireFullResolution) {
+      return buildErrorProfile(
+        uaid,
+        "ERR_NO_FOLLOWUP_PROFILE",
+        "Resolver policy requires full resolution, but no supported follow-up profile was available.",
+        { dnsName }
+      );
+    }
+    const did = selected.did ?? context.did ?? void 0;
+    const alsoKnownAs = did ? [did] : void 0;
     return {
       id: uaid,
-      did: baseDid,
-      alsoKnownAs: dedupeAlsoKnownAs(baseDid, didDocument.alsoKnownAs),
-      verificationMethod: didDocument.verificationMethod,
-      authentication: didDocument.authentication,
-      assertionMethod: didDocument.assertionMethod,
-      service: service.length > 0 ? service : void 0,
+      did,
+      alsoKnownAs,
       metadata: {
-        profile: UAID_DID_RESOLUTION_PROFILE_ID,
+        profile: UAID_DNS_WEB_PROFILE_ID,
         resolved: true,
-        baseDid,
-        baseDidResolved: true,
-        verification: {
-          method: "did-resolution",
-          assurance: "base-method",
-          details: "Validated according to base DID method rules"
-        },
-        services: {
-          copiedFromBaseDidDocument: baseServices.length > 0,
-          derivedFromUaidParameters: includeHintedService
-        }
+        reconstructedUaid: selected.reconstructedUaid,
+        verificationLevel,
+        resolutionMode: "dns-binding-only"
       }
     };
   }
 }
 export {
-  UAID_DID_RESOLUTION_PROFILE_ID,
-  UaidDidResolutionProfileResolver
+  UAID_DNS_WEB_PROFILE_ID,
+  UaidDnsWebProfileResolver
 };
 //# sourceMappingURL=standards-sdk.es64.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es64.js","sources":["../../src/hcs-14/resolvers/uaid-did-resolution-profile.ts"],"sourcesContent":["import { multibaseB58btcDecode } from '../base58';\nimport type {\n  DidResolutionProfile,\n  HintedServiceEndpoint,\n  ProfileResolutionError,\n  UaidProfileResolver,\n  UaidProfileResolverContext,\n} from './types';\nimport type { AdapterMeta } from '../adapters/types';\n\nexport const UAID_DID_RESOLUTION_PROFILE_ID =\n  'hcs-14.profile.uaid-did-resolution';\n\nfunction decodeSrcDid(src: string): string | null {\n  try {\n    const bytes = multibaseB58btcDecode(src);\n    const decoded = Buffer.from(bytes).toString('utf8').trim();\n    return decoded || null;\n  } catch {\n    return null;\n  }\n}\n\nfunction buildHintedService(\n  uaid: string,\n  params: Record<string, string>,\n): {\n  id: string;\n  type: string;\n  serviceEndpoint: HintedServiceEndpoint;\n} | null {\n  const proto = params['proto'];\n  const nativeId = params['nativeId'];\n  const domain = params['domain'];\n  if (!proto && !nativeId && !domain) {\n    return null;\n  }\n  return {\n    id: `${uaid}#hcs14-hinted-service-1`,\n    type: 'HintedService',\n    serviceEndpoint: {\n      source: 'uaid-parameters',\n      proto,\n      nativeId,\n      domain,\n    },\n  };\n}\n\nfunction buildErrorProfile(\n  uaid: string,\n  code: string,\n  message: string,\n  details?: Record<string, unknown>,\n): DidResolutionProfile {\n  const error: ProfileResolutionError = {\n    code,\n    message,\n    details,\n  };\n\n  return {\n    id: uaid,\n    error,\n    metadata: {\n      profile: UAID_DID_RESOLUTION_PROFILE_ID,\n      resolved: false,\n    },\n  };\n}\n\nfunction dedupeAlsoKnownAs(baseDid: string, existing: string[] = []): string[] {\n  const values = new Set<string>([baseDid, ...existing]);\n  return [...values];\n}\n\nexport class UaidDidResolutionProfileResolver implements UaidProfileResolver {\n  readonly profile = UAID_DID_RESOLUTION_PROFILE_ID;\n\n  readonly meta: AdapterMeta = {\n    id: 'hcs-14/uaid-did-resolution',\n    didMethods: ['*'],\n    displayName: 'HCS-14 UAID DID Resolution Profile',\n    description:\n      'Resolves uaid:did identifiers to DID Document-compatible output with profile metadata.',\n  };\n\n  supports(\n    _uaid: string,\n    parsed: UaidProfileResolverContext['parsedUaid'],\n  ): boolean {\n    return parsed.method === 'uaid';\n  }\n\n  async resolveProfile(\n    uaid: string,\n    context: UaidProfileResolverContext,\n  ): Promise<DidResolutionProfile | null> {\n    const parsed = context.parsedUaid;\n    if (parsed.method !== 'uaid') {\n      return buildErrorProfile(\n        uaid,\n        'ERR_INVALID_UAID',\n        'Identifier is not uaid:did and cannot be resolved by this profile.',\n        { uaid },\n      );\n    }\n\n    const src = parsed.params['src'];\n    const srcDid = src ? decodeSrcDid(src) : null;\n    const baseDid = srcDid ?? context.did ?? null;\n\n    if (!baseDid) {\n      return buildErrorProfile(\n        uaid,\n        'ERR_BASE_DID_UNDETERMINED',\n        'Unable to determine base DID; provide src parameter or configure method inference.',\n        { uaid },\n      );\n    }\n\n    const didDocument =\n      context.didDocument && context.didDocument.id === baseDid\n        ? context.didDocument\n        : await context.resolveDid(baseDid);\n\n    if (!didDocument) {\n      return buildErrorProfile(\n        uaid,\n        'ERR_DID_RESOLUTION_FAILED',\n        'Base DID resolution failed.',\n        { uaid, baseDid },\n      );\n    }\n\n    if (!didDocument.id || typeof didDocument.id !== 'string') {\n      return buildErrorProfile(\n        uaid,\n        'ERR_DID_DOCUMENT_INVALID',\n        'Resolved DID document is malformed.',\n        { uaid, baseDid },\n      );\n    }\n\n    const baseServices = didDocument.service ?? [];\n    const hintedService = buildHintedService(uaid, parsed.params);\n    const includeHintedService =\n      baseServices.length === 0 && hintedService !== null;\n    const service = includeHintedService\n      ? [...baseServices, hintedService]\n      : baseServices;\n\n    return {\n      id: uaid,\n      did: baseDid,\n      alsoKnownAs: dedupeAlsoKnownAs(baseDid, didDocument.alsoKnownAs),\n      verificationMethod: didDocument.verificationMethod,\n      authentication: didDocument.authentication,\n      assertionMethod: didDocument.assertionMethod,\n      service: service.length > 0 ? service : undefined,\n      metadata: {\n        profile: UAID_DID_RESOLUTION_PROFILE_ID,\n        resolved: true,\n        baseDid,\n        baseDidResolved: true,\n        verification: {\n          method: 'did-resolution',\n          assurance: 'base-method',\n          details: 'Validated according to base DID method rules',\n        },\n        services: {\n          copiedFromBaseDidDocument: baseServices.length > 0,\n          derivedFromUaidParameters: includeHintedService,\n        },\n      },\n    };\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"standards-sdk.es64.js","sources":["../../src/hcs-14/resolvers/uaid-dns-web-profile.ts"],"sourcesContent":["import type {\n  DidResolutionProfile,\n  ProfileResolutionError,\n  UaidProfileResolver,\n  UaidProfileResolverContext,\n} from './types';\nimport type { AdapterMeta } from '../adapters/types';\nimport { nodeDnsTxtLookup, type DnsTxtLookup } from './dns';\nimport {\n  buildCanonicalUaid,\n  isFqdn,\n  normalizeDomain,\n  parseSemicolonFields,\n  uaidTargetFromParsed,\n} from './profile-utils';\nimport { AID_DNS_WEB_PROFILE_ID } from './aid-dns-web-profile';\nimport { ANS_DNS_WEB_PROFILE_ID } from './ans-dns-web-profile';\nimport { UAID_DID_RESOLUTION_PROFILE_ID } from './uaid-did-resolution-profile';\n\nexport const UAID_DNS_WEB_PROFILE_ID = 'hcs-14.profile.uaid-dns-web';\n\ninterface UaidDnsWebRecord {\n  target: 'aid' | 'did';\n  id: string;\n  uid: string;\n  proto: string;\n  nativeId: string;\n  registry?: string;\n  domain?: string;\n  src?: string;\n  did?: string;\n  memo?: string;\n  reconstructedUaid: string;\n}\n\nexport interface UaidDnsWebResolverOptions {\n  dnsLookup?: DnsTxtLookup;\n  dnssecValidation?: (hostname: string) => Promise<boolean>;\n  requireFullResolution?: boolean;\n  enableFollowupResolution?: boolean;\n}\n\nfunction buildErrorProfile(\n  uaid: string,\n  code: string,\n  message: string,\n  details?: Record<string, unknown>,\n): DidResolutionProfile {\n  const error: ProfileResolutionError = {\n    code,\n    message,\n    details,\n  };\n\n  return {\n    id: uaid,\n    error,\n    metadata: {\n      profile: UAID_DNS_WEB_PROFILE_ID,\n      resolved: false,\n    },\n  };\n}\n\nfunction canonicalizeNativeDomainParams(\n  params: Record<string, string>,\n): Record<string, string> {\n  const next = { ...params };\n  const nativeId = next['nativeId'];\n  if (nativeId && isFqdn(nativeId)) {\n    next['nativeId'] = normalizeDomain(nativeId);\n  }\n  const domain = next['domain'];\n  if (domain && isFqdn(domain)) {\n    next['domain'] = normalizeDomain(domain);\n  }\n  return next;\n}\n\nfunction validateRecordFields(\n  fields: Record<string, string>,\n  queriedNativeId: string,\n): UaidDnsWebRecord | null {\n  const target = fields['target'];\n  const id = fields['id'];\n  const uid = fields['uid'];\n  const proto = fields['proto'];\n  const nativeId = fields['nativeId'];\n\n  if (target !== 'aid' && target !== 'did') {\n    return null;\n  }\n  if (!id || !uid || !proto || !nativeId) {\n    return null;\n  }\n  if (normalizeDomain(nativeId) !== queriedNativeId) {\n    return null;\n  }\n  if ('registry' in fields && !fields['registry']) {\n    return null;\n  }\n  const did = fields['did'];\n  if (did && (target !== 'did' || !did.startsWith('did:'))) {\n    return null;\n  }\n\n  const params: Record<string, string> = {\n    uid,\n    proto,\n    nativeId,\n  };\n  if (fields['registry']) {\n    params['registry'] = fields['registry'];\n  }\n  if (fields['domain']) {\n    params['domain'] = fields['domain'];\n  }\n  if (fields['src']) {\n    params['src'] = fields['src'];\n  }\n\n  return {\n    target,\n    id,\n    uid,\n    proto,\n    nativeId,\n    registry: fields['registry'],\n    domain: fields['domain'],\n    src: fields['src'],\n    did,\n    memo: fields['m'],\n    reconstructedUaid: buildCanonicalUaid(\n      target,\n      id,\n      canonicalizeNativeDomainParams(params),\n    ),\n  };\n}\n\nfunction selectFollowupProfiles(\n  parsed: UaidProfileResolverContext['parsedUaid'],\n): string[] {\n  const target = uaidTargetFromParsed(parsed);\n  if (target === 'aid') {\n    if (parsed.params['registry'] === 'ans') {\n      return [ANS_DNS_WEB_PROFILE_ID, AID_DNS_WEB_PROFILE_ID];\n    }\n    return [AID_DNS_WEB_PROFILE_ID];\n  }\n  return [UAID_DID_RESOLUTION_PROFILE_ID];\n}\n\nexport class UaidDnsWebProfileResolver implements UaidProfileResolver {\n  readonly adapterKind: 'uaid-profile-resolver' = 'uaid-profile-resolver';\n  readonly profile = UAID_DNS_WEB_PROFILE_ID;\n\n  readonly meta: AdapterMeta = {\n    id: 'hcs-14/uaid-dns-web',\n    didMethods: ['*'],\n    displayName: 'HCS-14 UAID DNS TXT Profile',\n    description:\n      'Binds UAIDs to DNS TXT records at _uaid.<nativeId> and can continue to follow-up profile resolution.',\n  };\n\n  private readonly dnsLookup: DnsTxtLookup;\n  private readonly dnssecValidation?: (hostname: string) => Promise<boolean>;\n  private readonly requireFullResolution: boolean;\n  private readonly enableFollowupResolution: boolean;\n\n  constructor(options: UaidDnsWebResolverOptions = {}) {\n    this.dnsLookup = options.dnsLookup ?? nodeDnsTxtLookup;\n    this.dnssecValidation = options.dnssecValidation;\n    this.requireFullResolution = options.requireFullResolution ?? false;\n    this.enableFollowupResolution = options.enableFollowupResolution ?? true;\n  }\n\n  supports(\n    _uaid: string,\n    parsed: UaidProfileResolverContext['parsedUaid'],\n  ): boolean {\n    const target = uaidTargetFromParsed(parsed);\n    if (target !== 'aid' && target !== 'did') {\n      return false;\n    }\n    const nativeId = parsed.params['nativeId'];\n    return !!nativeId && isFqdn(nativeId);\n  }\n\n  async resolveProfile(\n    uaid: string,\n    context: UaidProfileResolverContext,\n  ): Promise<DidResolutionProfile | null> {\n    const parsed = context.parsedUaid;\n    const target = uaidTargetFromParsed(parsed);\n    if (target !== 'aid' && target !== 'did') {\n      return buildErrorProfile(\n        uaid,\n        'ERR_NOT_APPLICABLE',\n        'UAID DNS/Web profile only applies to uaid:aid or uaid:did identifiers.',\n      );\n    }\n\n    const nativeId = parsed.params['nativeId'];\n    if (!nativeId || !isFqdn(nativeId)) {\n      return buildErrorProfile(\n        uaid,\n        'ERR_NOT_APPLICABLE',\n        'UAID DNS/Web profile requires an FQDN nativeId.',\n      );\n    }\n\n    const normalizedNativeId = normalizeDomain(nativeId);\n    const dnsName = `_uaid.${normalizedNativeId}`;\n    const inputCanonical = buildCanonicalUaid(\n      uaidTargetFromParsed(parsed),\n      parsed.id,\n      canonicalizeNativeDomainParams(parsed.params),\n    );\n\n    const txtRecords = await this.dnsLookup(dnsName);\n    if (txtRecords.length === 0) {\n      return buildErrorProfile(\n        uaid,\n        'ERR_NO_DNS_RECORD',\n        'No UAID DNS TXT record was found for the requested nativeId.',\n        { dnsName },\n      );\n    }\n\n    const parsedRecords = txtRecords\n      .map(record => parseSemicolonFields(record))\n      .map(fields => validateRecordFields(fields, normalizedNativeId));\n    const validRecords = parsedRecords.filter(\n      (record): record is UaidDnsWebRecord => record !== null,\n    );\n\n    if (validRecords.length === 0) {\n      return buildErrorProfile(\n        uaid,\n        'ERR_INVALID_UAID_DNS_RECORD',\n        'DNS TXT payload at _uaid record is invalid.',\n        { dnsName },\n      );\n    }\n\n    const matchingRecords = validRecords.filter(\n      record =>\n        record.target === target &&\n        record.id === parsed.id &&\n        record.reconstructedUaid === inputCanonical,\n    );\n\n    if (matchingRecords.length === 0) {\n      return buildErrorProfile(\n        uaid,\n        'ERR_UAID_MISMATCH',\n        'DNS TXT payload does not match the input UAID after canonical reconstruction.',\n        {\n          dnsName,\n          inputCanonical,\n        },\n      );\n    }\n\n    const selected = [...matchingRecords].sort((a, b) =>\n      a.reconstructedUaid.localeCompare(b.reconstructedUaid),\n    )[0];\n\n    const dnssecValidated = this.dnssecValidation\n      ? await this.dnssecValidation(dnsName)\n      : false;\n    const verificationLevel = dnssecValidated\n      ? 'dns-binding-dnssec'\n      : 'dns-binding';\n\n    if (this.enableFollowupResolution) {\n      const followupProfiles = selectFollowupProfiles(parsed);\n      const failedFollowupProfileIds: string[] = [];\n      for (const followupProfileId of followupProfiles) {\n        const followup = await context.resolveUaidProfileById(\n          followupProfileId,\n          uaid,\n        );\n        if (!followup) {\n          continue;\n        }\n        if (followup.error || followup.metadata?.resolved === false) {\n          failedFollowupProfileIds.push(followupProfileId);\n          continue;\n        }\n        return {\n          ...followup,\n          metadata: {\n            ...followup.metadata,\n            profile: UAID_DNS_WEB_PROFILE_ID,\n            resolved: true,\n            verificationLevel,\n            reconstructedUaid: selected.reconstructedUaid,\n            selectedFollowupProfile: followupProfileId,\n            resolutionMode: 'full-resolution',\n          },\n        };\n      }\n      if (failedFollowupProfileIds.length > 0) {\n        return buildErrorProfile(\n          uaid,\n          'ERR_FOLLOWUP_RESOLUTION_FAILED',\n          'Follow-up profile resolution failed after successful DNS binding.',\n          {\n            followupProfileId:\n              failedFollowupProfileIds[failedFollowupProfileIds.length - 1],\n            attemptedFailedProfiles: failedFollowupProfileIds,\n            dnsName,\n          },\n        );\n      }\n    }\n\n    if (this.requireFullResolution) {\n      return buildErrorProfile(\n        uaid,\n        'ERR_NO_FOLLOWUP_PROFILE',\n        'Resolver policy requires full resolution, but no supported follow-up profile was available.',\n        { dnsName },\n      );\n    }\n\n    const did = selected.did ?? context.did ?? undefined;\n    const alsoKnownAs = did ? [did] : undefined;\n\n    return {\n      id: uaid,\n      did,\n      alsoKnownAs,\n      metadata: {\n        profile: UAID_DNS_WEB_PROFILE_ID,\n        resolved: true,\n        reconstructedUaid: selected.reconstructedUaid,\n        verificationLevel,\n        resolutionMode: 'dns-binding-only',\n      },\n    };\n  }\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,50 +1,135 @@
-import { optionalImport } from "./standards-sdk.es157.js";
-let resolveTxtLoader = null;
-function isNoRecordError(error) {
-  if (!error || typeof error !== "object") {
-    return false;
-  }
-  const code = Reflect.get(error, "code");
-  if (typeof code !== "string") {
-    return false;
+import { multibaseB58btcDecode } from "./standards-sdk.es157.js";
+const UAID_DID_RESOLUTION_PROFILE_ID = "hcs-14.profile.uaid-did-resolution";
+function decodeSrcDid(src) {
+  try {
+    const bytes = multibaseB58btcDecode(src);
+    const decoded = Buffer.from(bytes).toString("utf8").trim();
+    return decoded || null;
+  } catch {
+    return null;
   }
-  return code === "ENOTFOUND" || code === "ENODATA" || code === "ENOENT" || code === "ENONAME" || code === "NXDOMAIN";
 }
-async function loadResolveTxt() {
-  if (!resolveTxtLoader) {
-    resolveTxtLoader = (async () => {
-      const nodeDnsModule = await optionalImport(
-        "node:dns/promises",
-        { preferImport: true }
-      );
-      if (nodeDnsModule?.resolveTxt) {
-        return nodeDnsModule.resolveTxt;
-      }
-      const dnsModule = await optionalImport(
-        "dns/promises",
-        { preferImport: true }
-      );
-      return dnsModule?.resolveTxt ?? null;
-    })();
+function buildHintedService(uaid, params) {
+  const proto = params["proto"];
+  const nativeId = params["nativeId"];
+  const domain = params["domain"];
+  if (!proto && !nativeId && !domain) {
+    return null;
   }
-  return resolveTxtLoader;
+  return {
+    id: `${uaid}#hcs14-hinted-service-1`,
+    type: "HintedService",
+    serviceEndpoint: {
+      source: "uaid-parameters",
+      proto,
+      nativeId,
+      domain
+    }
+  };
 }
-const nodeDnsTxtLookup = async (hostname) => {
-  const resolveTxt = await loadResolveTxt();
-  if (!resolveTxt) {
-    return [];
+function buildErrorProfile(uaid, code, message, details) {
+  const error = {
+    code,
+    message,
+    details
+  };
+  return {
+    id: uaid,
+    error,
+    metadata: {
+      profile: UAID_DID_RESOLUTION_PROFILE_ID,
+      resolved: false
+    }
+  };
+}
+function dedupeAlsoKnownAs(baseDid, existing = []) {
+  const values = /* @__PURE__ */ new Set([baseDid, ...existing]);
+  return [...values];
+}
+class UaidDidResolutionProfileResolver {
+  constructor() {
+    this.adapterKind = "uaid-profile-resolver";
+    this.profile = UAID_DID_RESOLUTION_PROFILE_ID;
+    this.meta = {
+      id: "hcs-14/uaid-did-resolution",
+      didMethods: ["*"],
+      displayName: "HCS-14 UAID DID Resolution Profile",
+      description: "Resolves uaid:did identifiers to DID Document-compatible output with profile metadata."
+    };
   }
-  try {
-    const response = await resolveTxt(hostname);
-    return response.map((chunks) => chunks.join(""));
-  } catch (error) {
-    if (isNoRecordError(error)) {
-      return [];
+  supports(_uaid, parsed) {
+    return parsed.method === "uaid";
+  }
+  async resolveProfile(uaid, context) {
+    const parsed = context.parsedUaid;
+    if (parsed.method !== "uaid") {
+      return buildErrorProfile(
+        uaid,
+        "ERR_INVALID_UAID",
+        "Identifier is not uaid:did and cannot be resolved by this profile.",
+        { uaid }
+      );
+    }
+    const src = parsed.params["src"];
+    const srcDid = src ? decodeSrcDid(src) : null;
+    const baseDid = srcDid ?? context.did ?? null;
+    if (!baseDid) {
+      return buildErrorProfile(
+        uaid,
+        "ERR_BASE_DID_UNDETERMINED",
+        "Unable to determine base DID; provide src parameter or configure method inference.",
+        { uaid }
+      );
+    }
+    const didDocument = context.didDocument && context.didDocument.id === baseDid ? context.didDocument : await context.resolveDid(baseDid);
+    if (!didDocument) {
+      return buildErrorProfile(
+        uaid,
+        "ERR_DID_RESOLUTION_FAILED",
+        "Base DID resolution failed.",
+        { uaid, baseDid }
+      );
     }
-    throw error;
+    if (!didDocument.id || typeof didDocument.id !== "string") {
+      return buildErrorProfile(
+        uaid,
+        "ERR_DID_DOCUMENT_INVALID",
+        "Resolved DID document is malformed.",
+        { uaid, baseDid }
+      );
+    }
+    const baseServices = didDocument.service ?? [];
+    const hintedService = buildHintedService(uaid, parsed.params);
+    const includeHintedService = baseServices.length === 0 && hintedService !== null;
+    const service = includeHintedService ? [...baseServices, hintedService] : baseServices;
+    return {
+      id: uaid,
+      did: baseDid,
+      alsoKnownAs: dedupeAlsoKnownAs(baseDid, didDocument.alsoKnownAs),
+      verificationMethod: didDocument.verificationMethod,
+      authentication: didDocument.authentication,
+      assertionMethod: didDocument.assertionMethod,
+      service: service.length > 0 ? service : void 0,
+      metadata: {
+        profile: UAID_DID_RESOLUTION_PROFILE_ID,
+        resolved: true,
+        baseDid,
+        baseDidResolved: true,
+        verification: {
+          method: "did-resolution",
+          assurance: "base-method",
+          details: "Validated according to base DID method rules"
+        },
+        services: {
+          copiedFromBaseDidDocument: baseServices.length > 0,
+          derivedFromUaidParameters: includeHintedService
+        }
+      }
+    };
   }
-};
+}
 export {
-  nodeDnsTxtLookup
+  UAID_DID_RESOLUTION_PROFILE_ID,
+  UaidDidResolutionProfileResolver
 };
 //# sourceMappingURL=standards-sdk.es65.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"standards-sdk.es65.js","sources":["../../src/hcs-14/resolvers/dns.ts"],"sourcesContent":["import { optionalImport } from '../../utils/dynamic-import';\n\ntype DnsResolveTxt = (hostname: string) => Promise<string[][]>;\n\ntype DnsPromisesModule = {\n  resolveTxt?: DnsResolveTxt;\n};\n\nexport type DnsTxtLookup = (hostname: string) => Promise<string[]>;\n\nlet resolveTxtLoader: Promise<DnsResolveTxt | null> | null = null;\n\nfunction isNoRecordError(error: unknown): boolean {\n  if (!error || typeof error !== 'object') {\n    return false;\n  }\n  const code = Reflect.get(error, 'code');\n  if (typeof code !== 'string') {\n    return false;\n  }\n  return (\n    code === 'ENOTFOUND' ||\n    code === 'ENODATA' ||\n    code === 'ENOENT' ||\n    code === 'ENONAME' ||\n    code === 'NXDOMAIN'\n  );\n}\n\nasync function loadResolveTxt(): Promise<DnsResolveTxt | null> {\n  if (!resolveTxtLoader) {\n    resolveTxtLoader = (async () => {\n      const nodeDnsModule = await optionalImport<DnsPromisesModule>(\n        'node:dns/promises',\n        { preferImport: true },\n      );\n      if (nodeDnsModule?.resolveTxt) {\n        return nodeDnsModule.resolveTxt;\n      }\n\n      const dnsModule = await optionalImport<DnsPromisesModule>(\n        'dns/promises',\n        { preferImport: true },\n      );\n      return dnsModule?.resolveTxt ?? null;\n    })();\n  }\n\n  return resolveTxtLoader;\n}\n\nexport const nodeDnsTxtLookup: DnsTxtLookup = async hostname => {\n  const resolveTxt = await loadResolveTxt();\n  if (!resolveTxt) {\n    return [];\n  }\n\n  try {\n    const response = await resolveTxt(hostname);\n    return response.map(chunks => chunks.join(''));\n  } catch (error) {\n    if (isNoRecordError(error)) {\n      return [];\n    }\n    throw error as Error;\n  }\n};\n"],"names":[],"mappings":";AAUA,IAAI,mBAAyD;AAE7D,SAAS,gBAAgB,OAAyB;AAChD,MAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,WAAO;AAAA,EACT;AACA,QAAM,OAAO,QAAQ,IAAI,OAAO,MAAM;AACtC,MAAI,OAAO,SAAS,UAAU;AAC5B,WAAO;AAAA,EACT;AACA,SACE,SAAS,eACT,SAAS,aACT,SAAS,YACT,SAAS,aACT,SAAS;AAEb;AAEA,eAAe,iBAAgD;AAC7D,MAAI,CAAC,kBAAkB;AACrB,wBAAoB,YAAY;AAC9B,YAAM,gBAAgB,MAAM;AAAA,QAC1B;AAAA,QACA,EAAE,cAAc,KAAA;AAAA,MAAK;AAEvB,UAAI,eAAe,YAAY;AAC7B,eAAO,cAAc;AAAA,MACvB;AAEA,YAAM,YAAY,MAAM;AAAA,QACtB;AAAA,QACA,EAAE,cAAc,KAAA;AAAA,MAAK;AAEvB,aAAO,WAAW,cAAc;AAAA,IAClC,GAAA;AAAA,EACF;AAEA,SAAO;AACT;AAEO,MAAM,mBAAiC,OAAM,aAAY;AAC9D,QAAM,aAAa,MAAM,eAAA;AACzB,MAAI,CAAC,YAAY;AACf,WAAO,CAAA;AAAA,EACT;AAEA,MAAI;AACF,UAAM,WAAW,MAAM,WAAW,QAAQ;AAC1C,WAAO,SAAS,IAAI,CAAA,WAAU,OAAO,KAAK,EAAE,CAAC;AAAA,EAC/C,SAAS,OAAO;AACd,QAAI,gBAAgB,KAAK,GAAG;AAC1B,aAAO,CAAA;AAAA,IACT;AACA,UAAM;AAAA,EACR;AACF;"}
+{"version":3,"file":"standards-sdk.es65.js","sources":["../../src/hcs-14/resolvers/uaid-did-resolution-profile.ts"],"sourcesContent":["import { multibaseB58btcDecode } from '../base58';\nimport type {\n  DidResolutionProfile,\n  HintedServiceEndpoint,\n  ProfileResolutionError,\n  UaidProfileResolver,\n  UaidProfileResolverContext,\n} from './types';\nimport type { AdapterMeta } from '../adapters/types';\n\nexport const UAID_DID_RESOLUTION_PROFILE_ID =\n  'hcs-14.profile.uaid-did-resolution';\n\nfunction decodeSrcDid(src: string): string | null {\n  try {\n    const bytes = multibaseB58btcDecode(src);\n    const decoded = Buffer.from(bytes).toString('utf8').trim();\n    return decoded || null;\n  } catch {\n    return null;\n  }\n}\n\nfunction buildHintedService(\n  uaid: string,\n  params: Record<string, string>,\n): {\n  id: string;\n  type: string;\n  serviceEndpoint: HintedServiceEndpoint;\n} | null {\n  const proto = params['proto'];\n  const nativeId = params['nativeId'];\n  const domain = params['domain'];\n  if (!proto && !nativeId && !domain) {\n    return null;\n  }\n  return {\n    id: `${uaid}#hcs14-hinted-service-1`,\n    type: 'HintedService',\n    serviceEndpoint: {\n      source: 'uaid-parameters',\n      proto,\n      nativeId,\n      domain,\n    },\n  };\n}\n\nfunction buildErrorProfile(\n  uaid: string,\n  code: string,\n  message: string,\n  details?: Record<string, unknown>,\n): DidResolutionProfile {\n  const error: ProfileResolutionError = {\n    code,\n    message,\n    details,\n  };\n\n  return {\n    id: uaid,\n    error,\n    metadata: {\n      profile: UAID_DID_RESOLUTION_PROFILE_ID,\n      resolved: false,\n    },\n  };\n}\n\nfunction dedupeAlsoKnownAs(baseDid: string, existing: string[] = []): string[] {\n  const values = new Set<string>([baseDid, ...existing]);\n  return [...values];\n}\n\nexport class UaidDidResolutionProfileResolver implements UaidProfileResolver {\n  readonly adapterKind: 'uaid-profile-resolver' = 'uaid-profile-resolver';\n  readonly profile = UAID_DID_RESOLUTION_PROFILE_ID;\n\n  readonly meta: AdapterMeta = {\n    id: 'hcs-14/uaid-did-resolution',\n    didMethods: ['*'],\n    displayName: 'HCS-14 UAID DID Resolution Profile',\n    description:\n      'Resolves uaid:did identifiers to DID Document-compatible output with profile metadata.',\n  };\n\n  supports(\n    _uaid: string,\n    parsed: UaidProfileResolverContext['parsedUaid'],\n  ): boolean {\n    return parsed.method === 'uaid';\n  }\n\n  async resolveProfile(\n    uaid: string,\n    context: UaidProfileResolverContext,\n  ): Promise<DidResolutionProfile | null> {\n    const parsed = context.parsedUaid;\n    if (parsed.method !== 'uaid') {\n      return buildErrorProfile(\n        uaid,\n        'ERR_INVALID_UAID',\n        'Identifier is not uaid:did and cannot be resolved by this profile.',\n        { uaid },\n      );\n    }\n\n    const src = parsed.params['src'];\n    const srcDid = src ? decodeSrcDid(src) : null;\n    const baseDid = srcDid ?? context.did ?? null;\n\n    if (!baseDid) {\n      return buildErrorProfile(\n        uaid,\n        'ERR_BASE_DID_UNDETERMINED',\n        'Unable to determine base DID; provide src parameter or configure method inference.',\n        { uaid },\n      );\n    }\n\n    const didDocument =\n      context.didDocument && context.didDocument.id === baseDid\n        ? context.didDocument\n        : await context.resolveDid(baseDid);\n\n    if (!didDocument) {\n      return buildErrorProfile(\n        uaid,\n        'ERR_DID_RESOLUTION_FAILED',\n        'Base DID resolution failed.',\n        { uaid, baseDid },\n      );\n    }\n\n    if (!didDocument.id || typeof didDocument.id !== 'string') {\n      return buildErrorProfile(\n        uaid,\n        'ERR_DID_DOCUMENT_INVALID',\n        'Resolved DID document is malformed.',\n        { uaid, baseDid },\n      );\n    }\n\n    const baseServices = didDocument.service ?? [];\n    const hintedService = buildHintedService(uaid, parsed.params);\n    const includeHintedService =\n      baseServices.length === 0 && hintedService !== null;\n    const service = includeHintedService\n      ? [...baseServices, hintedService]\n      : baseServices;\n\n    return {\n      id: uaid,\n      did: baseDid,\n      alsoKnownAs: dedupeAlsoKnownAs(baseDid, didDocument.alsoKnownAs),\n      verificationMethod: didDocument.verificationMethod,\n      authentication: didDocument.authentication,\n      assertionMethod: didDocument.assertionMethod,\n      service: service.length > 0 ? service : undefined,\n      metadata: {\n        profile: UAID_DID_RESOLUTION_PROFILE_ID,\n        resolved: true,\n        baseDid,\n        baseDidResolved: true,\n        verification: {\n          method: 'did-resolution',\n          assurance: 'base-method',\n          details: 'Validated according to base DID method rules',\n        },\n        services: {\n          copiedFromBaseDidDocument: baseServices.length > 0,\n          derivedFromUaidParameters: includeHintedService,\n        },\n      },\n    };\n  }\n}\n"],"names":[],"mappings":"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"}