@atproto/did 0.2.2 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @atproto/did
 
+## 0.2.3
+
+### Patch Changes
+
+- [#4383](https://github.com/bluesky-social/atproto/pull/4383) [`8012627`](https://github.com/bluesky-social/atproto/commit/8012627a1226cb2f1c753385ad2497b6b43ffd2e) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Export `AtprotoData` type
+
+- [#4384](https://github.com/bluesky-social/atproto/pull/4384) [`d396de0`](https://github.com/bluesky-social/atproto/commit/d396de016d1d55d08cfad1dabd3ffd9eaeea76ea) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Expose `matchesIdentifier` and `extractAtprotoData` utilities.
+
 ## 0.2.2
 
 ### Patch Changes

package/dist/atproto.d.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
-import { DidDocument } from './did-document.js';
+import { DidDocument, DidService } from './did-document.js';
 import { Did } from './did.js';
+import { Identifier } from './utils.js';
 export type AtprotoIdentityDidMethods = 'plc' | 'web';
 export type AtprotoDid = Did<AtprotoIdentityDidMethods>;
 export declare const atprotoDidSchema: z.ZodEffects<z.ZodString, `did:plc:${string}` | `did:web:${string}`, string>;
@@ -14,5 +15,30 @@ export declare function assertAtprotoDidWeb(input: unknown): asserts input is Di
 export declare function isAtprotoDidWeb(input: unknown): input is Did<'web'>;
 export type AtprotoAudience = `${AtprotoDid}#${string}`;
 export declare const isAtprotoAudience: (value: unknown) => value is AtprotoAudience;
+export type AtprotoData<M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods> = {
+    did: Did<M>;
+    aka?: string;
+    key?: AtprotoVerificationMethod<M>;
+    pds?: AtprotoPersonalDataServerService<M>;
+};
+export declare function extractAtprotoData<M extends AtprotoIdentityDidMethods>(document: DidDocument<M>): AtprotoData<M>;
 export declare function extractPdsUrl(document: DidDocument<AtprotoIdentityDidMethods>): URL;
+export type AtprotoAka = `at://${string}`;
+export declare function isAtprotoAka(value: string): value is AtprotoAka;
+export type AtprotoPersonalDataServerService<M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods> = DidService & {
+    id: Identifier<Did<M>, 'atproto_pds'>;
+    type: 'AtprotoPersonalDataServer';
+    serviceEndpoint: string;
+};
+export declare function isAtprotoPersonalDataServerService<M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods>(this: DidDocument<M>, service: null | undefined | DidService): service is AtprotoPersonalDataServerService<M>;
+export declare const ATPROTO_VERIFICATION_METHOD_TYPES: readonly ["EcdsaSecp256r1VerificationKey2019", "EcdsaSecp256k1VerificationKey2019", "Multikey"];
+export type SupportedAtprotoVerificationMethodType = (typeof ATPROTO_VERIFICATION_METHOD_TYPES)[number];
+type VerificationMethod = NonNullable<DidDocument['verificationMethod']>[number];
+export type AtprotoVerificationMethod<M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods> = Extract<VerificationMethod, object> & {
+    id: Identifier<Did<M>, 'atproto'>;
+    type: SupportedAtprotoVerificationMethodType;
+    publicKeyMultibase: string;
+};
+export declare function isAtprotoVerificationMethod<M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods>(this: DidDocument<M>, method: null | undefined | NonNullable<DidDocument<M>['verificationMethod']>[number]): method is AtprotoVerificationMethod<M>;
+export {};
 //# sourceMappingURL=atproto.d.ts.map

package/dist/atproto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atproto.d.ts","sourceRoot":"","sources":["../src/atproto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAa9B,MAAM,MAAM,yBAAyB,GAAG,KAAK,GAAG,KAAK,CAAA;AACrD,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,yBAAyB,CAAC,CAAA;AAEvD,eAAO,MAAM,gBAAgB,8EAE6C,CAAA;AAE1E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEhE;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,yDAGvC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,UAAU,CAa5E;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAgB7B;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAcnE;AA+BD,MAAM,MAAM,eAAe,GAAG,GAAG,UAAU,IAAI,MAAM,EAAE,CAAA;AACvD,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAQ3D,CAAA;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,CAAC,yBAAyB,CAAC,GAC/C,GAAG,CAyBL"}
+{"version":3,"file":"atproto.d.ts","sourceRoot":"","sources":["../src/atproto.ts"],"names":[],"mappings":"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"}

package/dist/atproto.js

@@ -1,16 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isAtprotoAudience = exports.atprotoDidSchema = void 0;
+exports.ATPROTO_VERIFICATION_METHOD_TYPES = exports.isAtprotoAudience = exports.atprotoDidSchema = void 0;
 exports.isAtprotoDid = isAtprotoDid;
 exports.asAtprotoDid = asAtprotoDid;
 exports.assertAtprotoDid = assertAtprotoDid;
 exports.assertAtprotoDidWeb = assertAtprotoDidWeb;
 exports.isAtprotoDidWeb = isAtprotoDidWeb;
+exports.extractAtprotoData = extractAtprotoData;
 exports.extractPdsUrl = extractPdsUrl;
+exports.isAtprotoAka = isAtprotoAka;
+exports.isAtprotoPersonalDataServerService = isAtprotoPersonalDataServerService;
+exports.isAtprotoVerificationMethod = isAtprotoVerificationMethod;
 const zod_1 = require("zod");
 const did_error_js_1 = require("./did-error.js");
 const uri_js_1 = require("./lib/uri.js");
 const methods_js_1 = require("./methods.js");
+const utils_js_1 = require("./utils.js");
 exports.atprotoDidSchema = zod_1.z
     .string()
     .refine(isAtprotoDid, `Atproto only allows "plc" and "web" DID methods`);
@@ -91,23 +96,39 @@ const isAtprotoAudience = (value) => {
     return ((0, uri_js_1.isFragment)(value, hashIndex + 1) && isAtprotoDid(value.slice(0, hashIndex)));
 };
 exports.isAtprotoAudience = isAtprotoAudience;
+function extractAtprotoData(document) {
+    return {
+        did: document.id,
+        aka: document.alsoKnownAs?.find(isAtprotoAka)?.slice(5),
+        key: document.verificationMethod?.find((isAtprotoVerificationMethod), document),
+        pds: document.service?.find((isAtprotoPersonalDataServerService), document),
+    };
+}
 function extractPdsUrl(document) {
-    const service = document.service?.find((isAtprotoPersonalDataServerService), document);
+    const service = document.service?.find(isAtprotoPersonalDataServerService, document);
     if (!service) {
-        throw new did_error_js_1.DidError(document.id, `Identity "${document.id}" does not have a PDS URL`, 'did-service-not-found');
-    }
-    try {
-        return new URL(service.serviceEndpoint);
-    }
-    catch (cause) {
-        throw new did_error_js_1.DidError(document.id, `Invalid PDS URL in DID document: ${service.serviceEndpoint}`, 'did-document-format-error', undefined, cause);
+        throw new did_error_js_1.DidError(document.id, `Document ${document.id} does not contain a (valid) #atproto_pds service URL`, 'did-service-not-found');
     }
+    return new URL(service.serviceEndpoint);
+}
+function isAtprotoAka(value) {
+    return value.startsWith('at://');
+}
+function isAtprotoPersonalDataServerService(service) {
+    return (service?.type === 'AtprotoPersonalDataServer' &&
+        typeof service.serviceEndpoint === 'string' &&
+        (0, uri_js_1.canParse)(service.serviceEndpoint) &&
+        (0, utils_js_1.matchesIdentifier)(this.id, 'atproto_pds', service.id));
 }
-function isAtprotoPersonalDataServerService(s) {
-    return (typeof s.serviceEndpoint === 'string' &&
-        s.type === 'AtprotoPersonalDataServer' &&
-        (s.id.startsWith('#')
-            ? s.id === '#atproto_pds'
-            : s.id === `${this.id}#atproto_pds`));
+exports.ATPROTO_VERIFICATION_METHOD_TYPES = Object.freeze([
+    'EcdsaSecp256r1VerificationKey2019',
+    'EcdsaSecp256k1VerificationKey2019',
+    'Multikey',
+]);
+function isAtprotoVerificationMethod(method) {
+    return (typeof method === 'object' &&
+        typeof method?.publicKeyMultibase === 'string' &&
+        exports.ATPROTO_VERIFICATION_METHOD_TYPES.includes(method.type) &&
+        (0, utils_js_1.matchesIdentifier)(this.id, 'atproto', method.id));
 }
 //# sourceMappingURL=atproto.js.map

package/dist/atproto.js.map

@@ -1 +1 @@
-{"version":3,"file":"atproto.js","sourceRoot":"","sources":["../src/atproto.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod'\nimport { DidDocument, DidService } from './did-document.js'\nimport { DidError, InvalidDidError } from './did-error.js'\nimport { Did } from './did.js'\nimport { isFragment } from './lib/uri.js'\nimport {\n  DID_PLC_PREFIX,\n  DID_WEB_PREFIX,\n  assertDidPlc,\n  assertDidWeb,\n  isDidPlc,\n  isDidWeb,\n} from './methods.js'\n\n// This file contains atproto-specific DID validation utilities.\n\nexport type AtprotoIdentityDidMethods = 'plc' | 'web'\nexport type AtprotoDid = Did<AtprotoIdentityDidMethods>\n\nexport const atprotoDidSchema = z\n  .string()\n  .refine(isAtprotoDid, `Atproto only allows \"plc\" and \"web\" DID methods`)\n\nexport function isAtprotoDid(input: unknown): input is AtprotoDid {\n  return isDidPlc(input) || isAtprotoDidWeb(input)\n}\n\nexport function asAtprotoDid<T>(input: T) {\n  assertAtprotoDid(input)\n  return input\n}\n\nexport function assertAtprotoDid(input: unknown): asserts input is AtprotoDid {\n  if (typeof input !== 'string') {\n    throw new InvalidDidError(typeof input, `DID must be a string`)\n  } else if (input.startsWith(DID_PLC_PREFIX)) {\n    assertDidPlc(input)\n  } else if (input.startsWith(DID_WEB_PREFIX)) {\n    assertAtprotoDidWeb(input)\n  } else {\n    throw new InvalidDidError(\n      input,\n      `Atproto only allows \"plc\" and \"web\" DID methods`,\n    )\n  }\n}\n\nexport function assertAtprotoDidWeb(\n  input: unknown,\n): asserts input is Did<'web'> {\n  assertDidWeb(input)\n\n  if (isDidWebWithPath(input)) {\n    throw new InvalidDidError(\n      input,\n      `Atproto does not allow path components in Web DIDs`,\n    )\n  }\n\n  if (isDidWebWithHttpsPort(input)) {\n    throw new InvalidDidError(\n      input,\n      `Atproto does not allow port numbers in Web DIDs, except for localhost`,\n    )\n  }\n}\n\n/**\n * @see {@link https://atproto.com/specs/did#blessed-did-methods}\n */\nexport function isAtprotoDidWeb(input: unknown): input is Did<'web'> {\n  if (!isDidWeb(input)) {\n    return false\n  }\n\n  if (isDidWebWithPath(input)) {\n    return false\n  }\n\n  if (isDidWebWithHttpsPort(input)) {\n    return false\n  }\n\n  return true\n}\n\nfunction isDidWebWithPath(did: Did<'web'>): boolean {\n  return did.includes(':', DID_WEB_PREFIX.length)\n}\n\nfunction isLocalhostDid(did: Did<'web'>): boolean {\n  return (\n    did === 'did:web:localhost' ||\n    did.startsWith('did:web:localhost:') ||\n    did.startsWith('did:web:localhost%3A')\n  )\n}\n\nfunction isDidWebWithHttpsPort(did: Did<'web'>): boolean {\n  if (isLocalhostDid(did)) return false\n\n  const pathIdx = did.indexOf(':', DID_WEB_PREFIX.length)\n\n  const hasPort =\n    pathIdx === -1\n      ? // No path component, check if there's a port separator anywhere after\n        // the \"did:web:\" prefix\n        did.includes('%3A', DID_WEB_PREFIX.length)\n      : // There is a path component; if there is an encoded colon *before* it,\n        // then there is a port number\n        did.lastIndexOf('%3A', pathIdx) !== -1\n\n  return hasPort\n}\n\nexport type AtprotoAudience = `${AtprotoDid}#${string}`\nexport const isAtprotoAudience = (value: unknown): value is AtprotoAudience => {\n  if (typeof value !== 'string') return false\n  const hashIndex = value.indexOf('#')\n  if (hashIndex === -1) return false\n  if (value.indexOf('#', hashIndex + 1) !== -1) return false\n  return (\n    isFragment(value, hashIndex + 1) && isAtprotoDid(value.slice(0, hashIndex))\n  )\n}\n\nexport function extractPdsUrl(\n  document: DidDocument<AtprotoIdentityDidMethods>,\n): URL {\n  const service = document.service?.find(\n    isAtprotoPersonalDataServerService<AtprotoIdentityDidMethods>,\n    document,\n  )\n\n  if (!service) {\n    throw new DidError(\n      document.id,\n      `Identity \"${document.id}\" does not have a PDS URL`,\n      'did-service-not-found',\n    )\n  }\n\n  try {\n    return new URL(service.serviceEndpoint)\n  } catch (cause) {\n    throw new DidError(\n      document.id,\n      `Invalid PDS URL in DID document: ${service.serviceEndpoint}`,\n      'did-document-format-error',\n      undefined,\n      cause,\n    )\n  }\n}\n\nfunction isAtprotoPersonalDataServerService<M extends string>(\n  this: DidDocument<M>,\n  s: DidService,\n): s is {\n  id: '#atproto_pds' | `${Did<M>}#atproto_pds`\n  type: 'AtprotoPersonalDataServer'\n  serviceEndpoint: string\n} {\n  return (\n    typeof s.serviceEndpoint === 'string' &&\n    s.type === 'AtprotoPersonalDataServer' &&\n    (s.id.startsWith('#')\n      ? s.id === '#atproto_pds'\n      : s.id === `${this.id}#atproto_pds`)\n  )\n}\n"]}
+{"version":3,"file":"atproto.js","sourceRoot":"","sources":["../src/atproto.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod'\nimport { DidDocument, DidService } from './did-document.js'\nimport { DidError, InvalidDidError } from './did-error.js'\nimport { Did } from './did.js'\nimport { canParse, isFragment } from './lib/uri.js'\nimport {\n  DID_PLC_PREFIX,\n  DID_WEB_PREFIX,\n  assertDidPlc,\n  assertDidWeb,\n  isDidPlc,\n  isDidWeb,\n} from './methods.js'\nimport { Identifier, matchesIdentifier } from './utils.js'\n\n// This file contains atproto-specific DID validation utilities.\n\nexport type AtprotoIdentityDidMethods = 'plc' | 'web'\nexport type AtprotoDid = Did<AtprotoIdentityDidMethods>\n\nexport const atprotoDidSchema = z\n  .string()\n  .refine(isAtprotoDid, `Atproto only allows \"plc\" and \"web\" DID methods`)\n\nexport function isAtprotoDid(input: unknown): input is AtprotoDid {\n  return isDidPlc(input) || isAtprotoDidWeb(input)\n}\n\nexport function asAtprotoDid<T>(input: T) {\n  assertAtprotoDid(input)\n  return input\n}\n\nexport function assertAtprotoDid(input: unknown): asserts input is AtprotoDid {\n  if (typeof input !== 'string') {\n    throw new InvalidDidError(typeof input, `DID must be a string`)\n  } else if (input.startsWith(DID_PLC_PREFIX)) {\n    assertDidPlc(input)\n  } else if (input.startsWith(DID_WEB_PREFIX)) {\n    assertAtprotoDidWeb(input)\n  } else {\n    throw new InvalidDidError(\n      input,\n      `Atproto only allows \"plc\" and \"web\" DID methods`,\n    )\n  }\n}\n\nexport function assertAtprotoDidWeb(\n  input: unknown,\n): asserts input is Did<'web'> {\n  assertDidWeb(input)\n\n  if (isDidWebWithPath(input)) {\n    throw new InvalidDidError(\n      input,\n      `Atproto does not allow path components in Web DIDs`,\n    )\n  }\n\n  if (isDidWebWithHttpsPort(input)) {\n    throw new InvalidDidError(\n      input,\n      `Atproto does not allow port numbers in Web DIDs, except for localhost`,\n    )\n  }\n}\n\n/**\n * @see {@link https://atproto.com/specs/did#blessed-did-methods}\n */\nexport function isAtprotoDidWeb(input: unknown): input is Did<'web'> {\n  if (!isDidWeb(input)) {\n    return false\n  }\n\n  if (isDidWebWithPath(input)) {\n    return false\n  }\n\n  if (isDidWebWithHttpsPort(input)) {\n    return false\n  }\n\n  return true\n}\n\nfunction isDidWebWithPath(did: Did<'web'>): boolean {\n  return did.includes(':', DID_WEB_PREFIX.length)\n}\n\nfunction isLocalhostDid(did: Did<'web'>): boolean {\n  return (\n    did === 'did:web:localhost' ||\n    did.startsWith('did:web:localhost:') ||\n    did.startsWith('did:web:localhost%3A')\n  )\n}\n\nfunction isDidWebWithHttpsPort(did: Did<'web'>): boolean {\n  if (isLocalhostDid(did)) return false\n\n  const pathIdx = did.indexOf(':', DID_WEB_PREFIX.length)\n\n  const hasPort =\n    pathIdx === -1\n      ? // No path component, check if there's a port separator anywhere after\n        // the \"did:web:\" prefix\n        did.includes('%3A', DID_WEB_PREFIX.length)\n      : // There is a path component; if there is an encoded colon *before* it,\n        // then there is a port number\n        did.lastIndexOf('%3A', pathIdx) !== -1\n\n  return hasPort\n}\n\nexport type AtprotoAudience = `${AtprotoDid}#${string}`\nexport const isAtprotoAudience = (value: unknown): value is AtprotoAudience => {\n  if (typeof value !== 'string') return false\n  const hashIndex = value.indexOf('#')\n  if (hashIndex === -1) return false\n  if (value.indexOf('#', hashIndex + 1) !== -1) return false\n  return (\n    isFragment(value, hashIndex + 1) && isAtprotoDid(value.slice(0, hashIndex))\n  )\n}\n\nexport type AtprotoData<\n  M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,\n> = {\n  did: Did<M>\n  aka?: string\n  key?: AtprotoVerificationMethod<M>\n  pds?: AtprotoPersonalDataServerService<M>\n}\n\nexport function extractAtprotoData<M extends AtprotoIdentityDidMethods>(\n  document: DidDocument<M>,\n): AtprotoData<M> {\n  return {\n    did: document.id,\n    aka: document.alsoKnownAs?.find(isAtprotoAka)?.slice(5),\n    key: document.verificationMethod?.find(\n      isAtprotoVerificationMethod<M>,\n      document,\n    ),\n    pds: document.service?.find(\n      isAtprotoPersonalDataServerService<M>,\n      document,\n    ),\n  }\n}\n\nexport function extractPdsUrl(\n  document: DidDocument<AtprotoIdentityDidMethods>,\n): URL {\n  const service = document.service?.find(\n    isAtprotoPersonalDataServerService,\n    document,\n  )\n\n  if (!service) {\n    throw new DidError(\n      document.id,\n      `Document ${document.id} does not contain a (valid) #atproto_pds service URL`,\n      'did-service-not-found',\n    )\n  }\n\n  return new URL(service.serviceEndpoint)\n}\n\nexport type AtprotoAka = `at://${string}`\nexport function isAtprotoAka(value: string): value is AtprotoAka {\n  return value.startsWith('at://')\n}\n\nexport type AtprotoPersonalDataServerService<\n  M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,\n> = DidService & {\n  id: Identifier<Did<M>, 'atproto_pds'>\n  type: 'AtprotoPersonalDataServer'\n  serviceEndpoint: string\n}\n\nexport function isAtprotoPersonalDataServerService<\n  M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,\n>(\n  this: DidDocument<M>,\n  service: null | undefined | DidService,\n): service is AtprotoPersonalDataServerService<M> {\n  return (\n    service?.type === 'AtprotoPersonalDataServer' &&\n    typeof service.serviceEndpoint === 'string' &&\n    canParse(service.serviceEndpoint) &&\n    matchesIdentifier(this.id, 'atproto_pds', service.id)\n  )\n}\n\nexport const ATPROTO_VERIFICATION_METHOD_TYPES = Object.freeze([\n  'EcdsaSecp256r1VerificationKey2019',\n  'EcdsaSecp256k1VerificationKey2019',\n  'Multikey',\n] as const)\nexport type SupportedAtprotoVerificationMethodType =\n  (typeof ATPROTO_VERIFICATION_METHOD_TYPES)[number]\n\ntype VerificationMethod = NonNullable<DidDocument['verificationMethod']>[number]\nexport type AtprotoVerificationMethod<\n  M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,\n> = Extract<VerificationMethod, object> & {\n  id: Identifier<Did<M>, 'atproto'>\n  type: SupportedAtprotoVerificationMethodType\n  publicKeyMultibase: string\n}\n\nexport function isAtprotoVerificationMethod<\n  M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,\n>(\n  this: DidDocument<M>,\n  method:\n    | null\n    | undefined\n    | NonNullable<DidDocument<M>['verificationMethod']>[number],\n): method is AtprotoVerificationMethod<M> {\n  return (\n    typeof method === 'object' &&\n    typeof method?.publicKeyMultibase === 'string' &&\n    (ATPROTO_VERIFICATION_METHOD_TYPES as readonly unknown[]).includes(\n      method.type,\n    ) &&\n    matchesIdentifier(this.id, 'atproto', method.id)\n  )\n}\n"]}

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export * from './did-document.js';
 export * from './did-error.js';
 export * from './did.js';
 export * from './methods.js';
+export * from './utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -19,4 +19,5 @@ __exportStar(require("./did-document.js"), exports);
 __exportStar(require("./did-error.js"), exports);
 __exportStar(require("./did.js"), exports);
 __exportStar(require("./methods.js"), exports);
+__exportStar(require("./utils.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,oDAAiC;AACjC,iDAA8B;AAC9B,2CAAwB;AACxB,+CAA4B","sourcesContent":["export * from './atproto.js'\nexport * from './did-document.js'\nexport * from './did-error.js'\nexport * from './did.js'\nexport * from './methods.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA4B;AAC5B,oDAAiC;AACjC,iDAA8B;AAC9B,2CAAwB;AACxB,+CAA4B;AAC5B,6CAA0B","sourcesContent":["export * from './atproto.js'\nexport * from './did-document.js'\nexport * from './did-error.js'\nexport * from './did.js'\nexport * from './methods.js'\nexport * from './utils.js'\n"]}

package/dist/lib/uri.d.ts

@@ -4,4 +4,5 @@
  */
 export declare function isFragment(value: string, startIdx?: number, endIdx?: number): boolean;
 export declare function isHexDigit(code: number): boolean;
+export declare const canParse: (url: string | URL, base?: string | URL) => boolean;
 //# sourceMappingURL=uri.d.ts.map

package/dist/lib/uri.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uri.d.ts","sourceRoot":"","sources":["../../src/lib/uri.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,QAAQ,SAAI,EACZ,MAAM,SAAe,GACpB,OAAO,CAkDT;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhD"}
+{"version":3,"file":"uri.d.ts","sourceRoot":"","sources":["../../src/lib/uri.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,QAAQ,SAAI,EACZ,MAAM,SAAe,GACpB,OAAO,CAkDT;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMhD;AAED,eAAO,MAAM,QAAQ,qDASjB,CAAA"}

package/dist/lib/uri.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.canParse = void 0;
 exports.isFragment = isFragment;
 exports.isHexDigit = isHexDigit;
 /**
@@ -65,4 +66,14 @@ function isHexDigit(code) {
         (code >= 97 && code <= 102) // a-f
     );
 }
+exports.canParse = URL.canParse?.bind(URL) ??
+    ((url, base) => {
+        try {
+            new URL(url, base);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
 //# sourceMappingURL=uri.js.map

package/dist/lib/uri.js.map

@@ -1 +1 @@
-{"version":3,"file":"uri.js","sourceRoot":"","sources":["../../src/lib/uri.ts"],"names":[],"mappings":";;AAIA,gCAsDC;AAED,gCAMC;AAlED;;;GAGG;AACH,SAAgB,UAAU,CACxB,KAAa,EACb,QAAQ,GAAG,CAAC,EACZ,MAAM,GAAG,KAAK,CAAC,MAAM;IAErB,IAAI,QAAgB,CAAA;IACpB,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAE9B,uCAAuC;QACvC,kEAAkE;QAClE,sDAAsD;QACtD,kCAAkC;QAClC,gFAAgF;QAChF,IACE,CAAC,QAAQ,IAAI,EAAE,CAAC,OAAO,IAAI,QAAQ,IAAI,EAAE,CAAC,CAAC,OAAO;YAClD,CAAC,QAAQ,IAAI,EAAE,CAAC,OAAO,IAAI,QAAQ,IAAI,GAAG,CAAC,CAAC,OAAO;YACnD,CAAC,QAAQ,IAAI,EAAE,CAAC,OAAO,IAAI,QAAQ,IAAI,EAAE,CAAC,CAAC,OAAO;YAClD,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,GAAG,CAAC,SAAS,EAC1B,CAAC;YACD,aAAa;QACf,CAAC;aAAM,IACL,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS;YACzB,QAAQ,KAAK,EAAE,CAAC,SAAS,EACzB,CAAC;YACD,aAAa;QACf,CAAC;aAAM,IAAI,QAAQ,KAAK,EAAE,CAAC,SAAS,IAAI,QAAQ,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC;YAClE,cAAc;QAChB,CAAC;aAAM,IAAI,QAAQ,KAAK,EAAE,CAAC,SAAS,IAAI,QAAQ,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC;YAClE,iBAAiB;QACnB,CAAC;aAAM,IAAI,QAAQ,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC;YACrC,UAAU;YACV,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM;gBAAE,OAAO,KAAK,CAAA;YACjC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAA;YACtD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAA;YACtD,CAAC,IAAI,CAAC,CAAA;QACR,CAAC;aAAM,CAAC;YACN,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC;AAED,SAAgB,UAAU,CAAC,IAAY;IACrC,OAAO,CACL,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,MAAM;QACpC,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,MAAM;QACpC,CAAC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,MAAM;KACnC,CAAA;AACH,CAAC","sourcesContent":["/**\n * @see {@link https://www.w3.org/TR/did-1.0/#dfn-did-fragments}\n * @see {@link https://datatracker.ietf.org/doc/html/rfc3986#section-3.5}\n */\nexport function isFragment(\n  value: string,\n  startIdx = 0,\n  endIdx = value.length,\n): boolean {\n  let charCode: number\n  for (let i = startIdx; i < endIdx; i++) {\n    charCode = value.charCodeAt(i)\n\n    // fragment    = *( pchar / \"/\" / \"?\" )\n    // pchar       = unreserved / pct-encoded / sub-delims / \":\" / \"@\"\n    // unreserved  = ALPHA / DIGIT / \"-\" / \".\" / \"_\" / \"~\"\n    // pct-encoded = \"%\" HEXDIG HEXDIG\n    // sub-delims  = \"!\" / \"$\" / \"&\" / \"'\" / \"(\" / \")\" / \"*\" / \"+\" / \",\" / \";\" / \"=\"\n    if (\n      (charCode >= 65 /* A */ && charCode <= 90) /* Z */ ||\n      (charCode >= 97 /* a */ && charCode <= 122) /* z */ ||\n      (charCode >= 48 /* 0 */ && charCode <= 57) /* 9 */ ||\n      charCode === 45 /* \"-\" */ ||\n      charCode === 46 /* \".\" */ ||\n      charCode === 95 /* \"_\" */ ||\n      charCode === 126 /* \"~\" */\n    ) {\n      // unreserved\n    } else if (\n      charCode === 33 /* \"!\" */ ||\n      charCode === 36 /* \"$\" */ ||\n      charCode === 38 /* \"&\" */ ||\n      charCode === 39 /* \"'\" */ ||\n      charCode === 40 /* \"(\" */ ||\n      charCode === 41 /* \")\" */ ||\n      charCode === 42 /* \"*\" */ ||\n      charCode === 43 /* \"+\" */ ||\n      charCode === 44 /* \",\" */ ||\n      charCode === 59 /* \";\" */ ||\n      charCode === 61 /* \"=\" */\n    ) {\n      // sub-delims\n    } else if (charCode === 58 /* \":\" */ || charCode === 64 /* \"@\" */) {\n      // pchar extra\n    } else if (charCode === 47 /* \"/\" */ || charCode === 63 /* \"?\" */) {\n      // fragment extra\n    } else if (charCode === 37 /* \"%\" */) {\n      // pct-enc\n      if (i + 2 >= endIdx) return false\n      if (!isHexDigit(value.charCodeAt(i + 1))) return false\n      if (!isHexDigit(value.charCodeAt(i + 2))) return false\n      i += 2\n    } else {\n      return false\n    }\n  }\n\n  return true\n}\n\nexport function isHexDigit(code: number): boolean {\n  return (\n    (code >= 48 && code <= 57) || // 0-9\n    (code >= 65 && code <= 70) || // A-F\n    (code >= 97 && code <= 102) // a-f\n  )\n}\n"]}
+{"version":3,"file":"uri.js","sourceRoot":"","sources":["../../src/lib/uri.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @see {@link https://www.w3.org/TR/did-1.0/#dfn-did-fragments}\n * @see {@link https://datatracker.ietf.org/doc/html/rfc3986#section-3.5}\n */\nexport function isFragment(\n  value: string,\n  startIdx = 0,\n  endIdx = value.length,\n): boolean {\n  let charCode: number\n  for (let i = startIdx; i < endIdx; i++) {\n    charCode = value.charCodeAt(i)\n\n    // fragment    = *( pchar / \"/\" / \"?\" )\n    // pchar       = unreserved / pct-encoded / sub-delims / \":\" / \"@\"\n    // unreserved  = ALPHA / DIGIT / \"-\" / \".\" / \"_\" / \"~\"\n    // pct-encoded = \"%\" HEXDIG HEXDIG\n    // sub-delims  = \"!\" / \"$\" / \"&\" / \"'\" / \"(\" / \")\" / \"*\" / \"+\" / \",\" / \";\" / \"=\"\n    if (\n      (charCode >= 65 /* A */ && charCode <= 90) /* Z */ ||\n      (charCode >= 97 /* a */ && charCode <= 122) /* z */ ||\n      (charCode >= 48 /* 0 */ && charCode <= 57) /* 9 */ ||\n      charCode === 45 /* \"-\" */ ||\n      charCode === 46 /* \".\" */ ||\n      charCode === 95 /* \"_\" */ ||\n      charCode === 126 /* \"~\" */\n    ) {\n      // unreserved\n    } else if (\n      charCode === 33 /* \"!\" */ ||\n      charCode === 36 /* \"$\" */ ||\n      charCode === 38 /* \"&\" */ ||\n      charCode === 39 /* \"'\" */ ||\n      charCode === 40 /* \"(\" */ ||\n      charCode === 41 /* \")\" */ ||\n      charCode === 42 /* \"*\" */ ||\n      charCode === 43 /* \"+\" */ ||\n      charCode === 44 /* \",\" */ ||\n      charCode === 59 /* \";\" */ ||\n      charCode === 61 /* \"=\" */\n    ) {\n      // sub-delims\n    } else if (charCode === 58 /* \":\" */ || charCode === 64 /* \"@\" */) {\n      // pchar extra\n    } else if (charCode === 47 /* \"/\" */ || charCode === 63 /* \"?\" */) {\n      // fragment extra\n    } else if (charCode === 37 /* \"%\" */) {\n      // pct-enc\n      if (i + 2 >= endIdx) return false\n      if (!isHexDigit(value.charCodeAt(i + 1))) return false\n      if (!isHexDigit(value.charCodeAt(i + 2))) return false\n      i += 2\n    } else {\n      return false\n    }\n  }\n\n  return true\n}\n\nexport function isHexDigit(code: number): boolean {\n  return (\n    (code >= 48 && code <= 57) || // 0-9\n    (code >= 65 && code <= 70) || // A-F\n    (code >= 97 && code <= 102) // a-f\n  )\n}\n\nexport const canParse =\n  URL.canParse?.bind(URL) ??\n  ((url, base) => {\n    try {\n      new URL(url, base)\n      return true\n    } catch {\n      return false\n    }\n  })\n"]}

package/dist/methods/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/methods/web.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAiB,MAAM,WAAW,CAAA;AAE9C,eAAO,MAAM,cAAc,aAAkC,CAAA;AAa7D;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAa5D;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,2BAGnC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAmBxE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC;cAG3B,OAAO,GAAG,QAAQ;EAKjC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAKhD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAetD"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/methods/web.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAiB,MAAM,WAAW,CAAA;AAG9C,eAAO,MAAM,cAAc,aAAkC,CAAA;AAE7D;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAa5D;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,2BAGnC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAmBxE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC;cAG3B,OAAO,GAAG,QAAQ;EAKjC;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAKhD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAetD"}

package/dist/methods/web.js

@@ -9,17 +9,8 @@ exports.urlToDidWeb = urlToDidWeb;
 exports.buildDidWebUrl = buildDidWebUrl;
 const did_error_js_1 = require("../did-error.js");
 const did_js_1 = require("../did.js");
+const uri_js_1 = require("../lib/uri.js");
 exports.DID_WEB_PREFIX = `did:web:`;
-const canParse = URL.canParse?.bind(URL) ??
-    ((url, base) => {
-        try {
-            new URL(url, base);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    });
 /**
  * This function checks if the input is a valid Web DID, as per DID spec.
  */
@@ -37,7 +28,7 @@ function isDidWeb(input) {
     catch {
         return false;
     }
-    return canParse(buildDidWebUrl(input));
+    return (0, uri_js_1.canParse)(buildDidWebUrl(input));
 }
 function asDidWeb(input) {
     assertDidWeb(input);
@@ -55,7 +46,7 @@ function assertDidWeb(input) {
     }
     // Make sure every char is valid (per DID spec)
     (0, did_js_1.assertDidMsid)(input, exports.DID_WEB_PREFIX.length);
-    if (!canParse(buildDidWebUrl(input))) {
+    if (!(0, uri_js_1.canParse)(buildDidWebUrl(input))) {
         throw new did_error_js_1.InvalidDidError(input, 'Invalid Web DID');
     }
 }

package/dist/methods/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/methods/web.ts"],"names":[],"mappings":"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","sourcesContent":["import { InvalidDidError } from '../did-error.js'\nimport { Did, assertDidMsid } from '../did.js'\n\nexport const DID_WEB_PREFIX = `did:web:` satisfies Did<'web'>\n\nconst canParse =\n  URL.canParse?.bind(URL) ??\n  ((url, base) => {\n    try {\n      new URL(url, base)\n      return true\n    } catch {\n      return false\n    }\n  })\n\n/**\n * This function checks if the input is a valid Web DID, as per DID spec.\n */\nexport function isDidWeb(input: unknown): input is Did<'web'> {\n  // Optimization: make cheap checks first\n  if (typeof input !== 'string') return false\n  if (!input.startsWith(DID_WEB_PREFIX)) return false\n  if (input.charAt(DID_WEB_PREFIX.length) === ':') return false\n\n  try {\n    assertDidMsid(input, DID_WEB_PREFIX.length)\n  } catch {\n    return false\n  }\n\n  return canParse(buildDidWebUrl(input as Did<'web'>))\n}\n\nexport function asDidWeb<T>(input: T) {\n  assertDidWeb(input)\n  return input\n}\n\nexport function assertDidWeb(input: unknown): asserts input is Did<'web'> {\n  if (typeof input !== 'string') {\n    throw new InvalidDidError(typeof input, `DID must be a string`)\n  }\n\n  if (!input.startsWith(DID_WEB_PREFIX)) {\n    throw new InvalidDidError(input, `Invalid did:web prefix`)\n  }\n\n  if (input.charAt(DID_WEB_PREFIX.length) === ':') {\n    throw new InvalidDidError(input, 'did:web MSID must not start with a colon')\n  }\n\n  // Make sure every char is valid (per DID spec)\n  assertDidMsid(input, DID_WEB_PREFIX.length)\n\n  if (!canParse(buildDidWebUrl(input as Did<'web'>))) {\n    throw new InvalidDidError(input, 'Invalid Web DID')\n  }\n}\n\nexport function didWebToUrl(did: Did<'web'>) {\n  try {\n    return new URL(buildDidWebUrl(did)) as URL & {\n      protocol: 'http:' | 'https:'\n    }\n  } catch (cause) {\n    throw new InvalidDidError(did, 'Invalid Web DID', cause)\n  }\n}\n\nexport function urlToDidWeb(url: URL): Did<'web'> {\n  const port = url.port ? `%3A${url.port}` : ''\n  const path = url.pathname === '/' ? '' : url.pathname.replaceAll('/', ':')\n\n  return `did:web:${url.hostname}${port}${path}`\n}\n\nexport function buildDidWebUrl(did: Did<'web'>): string {\n  const hostIdx = DID_WEB_PREFIX.length\n  const pathIdx = did.indexOf(':', hostIdx)\n\n  const hostEnc =\n    pathIdx === -1 ? did.slice(hostIdx) : did.slice(hostIdx, pathIdx)\n  const host = hostEnc.replaceAll('%3A', ':')\n  const path = pathIdx === -1 ? '' : did.slice(pathIdx).replaceAll(':', '/')\n  const proto =\n    host.startsWith('localhost') &&\n    (host.length === 9 || host.charCodeAt(9) === 58) /* ':' */\n      ? 'http'\n      : 'https'\n\n  return `${proto}://${host}${path}`\n}\n"]}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/methods/web.ts"],"names":[],"mappings":"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","sourcesContent":["import { InvalidDidError } from '../did-error.js'\nimport { Did, assertDidMsid } from '../did.js'\nimport { canParse } from '../lib/uri.js'\n\nexport const DID_WEB_PREFIX = `did:web:` satisfies Did<'web'>\n\n/**\n * This function checks if the input is a valid Web DID, as per DID spec.\n */\nexport function isDidWeb(input: unknown): input is Did<'web'> {\n  // Optimization: make cheap checks first\n  if (typeof input !== 'string') return false\n  if (!input.startsWith(DID_WEB_PREFIX)) return false\n  if (input.charAt(DID_WEB_PREFIX.length) === ':') return false\n\n  try {\n    assertDidMsid(input, DID_WEB_PREFIX.length)\n  } catch {\n    return false\n  }\n\n  return canParse(buildDidWebUrl(input as Did<'web'>))\n}\n\nexport function asDidWeb<T>(input: T) {\n  assertDidWeb(input)\n  return input\n}\n\nexport function assertDidWeb(input: unknown): asserts input is Did<'web'> {\n  if (typeof input !== 'string') {\n    throw new InvalidDidError(typeof input, `DID must be a string`)\n  }\n\n  if (!input.startsWith(DID_WEB_PREFIX)) {\n    throw new InvalidDidError(input, `Invalid did:web prefix`)\n  }\n\n  if (input.charAt(DID_WEB_PREFIX.length) === ':') {\n    throw new InvalidDidError(input, 'did:web MSID must not start with a colon')\n  }\n\n  // Make sure every char is valid (per DID spec)\n  assertDidMsid(input, DID_WEB_PREFIX.length)\n\n  if (!canParse(buildDidWebUrl(input as Did<'web'>))) {\n    throw new InvalidDidError(input, 'Invalid Web DID')\n  }\n}\n\nexport function didWebToUrl(did: Did<'web'>) {\n  try {\n    return new URL(buildDidWebUrl(did)) as URL & {\n      protocol: 'http:' | 'https:'\n    }\n  } catch (cause) {\n    throw new InvalidDidError(did, 'Invalid Web DID', cause)\n  }\n}\n\nexport function urlToDidWeb(url: URL): Did<'web'> {\n  const port = url.port ? `%3A${url.port}` : ''\n  const path = url.pathname === '/' ? '' : url.pathname.replaceAll('/', ':')\n\n  return `did:web:${url.hostname}${port}${path}`\n}\n\nexport function buildDidWebUrl(did: Did<'web'>): string {\n  const hostIdx = DID_WEB_PREFIX.length\n  const pathIdx = did.indexOf(':', hostIdx)\n\n  const hostEnc =\n    pathIdx === -1 ? did.slice(hostIdx) : did.slice(hostIdx, pathIdx)\n  const host = hostEnc.replaceAll('%3A', ':')\n  const path = pathIdx === -1 ? '' : did.slice(pathIdx).replaceAll(':', '/')\n  const proto =\n    host.startsWith('localhost') &&\n    (host.length === 9 || host.charCodeAt(9) === 58) /* ':' */\n      ? 'http'\n      : 'https'\n\n  return `${proto}://${host}${path}`\n}\n"]}

package/dist/utils.d.ts

@@ -0,0 +1,3 @@
+export type Identifier<D extends string, I extends string> = `#${I}` | `${D}#${I}`;
+export declare function matchesIdentifier<D extends string, I extends string>(did: D, id: I, candidate: string): candidate is Identifier<D, I>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,IACrD,IAAI,CAAC,EAAE,GACP,GAAG,CAAC,IAAI,CAAC,EAAE,CAAA;AACf,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAClE,GAAG,EAAE,CAAC,EACN,EAAE,EAAE,CAAC,EACL,SAAS,EAAE,MAAM,GAChB,SAAS,IAAI,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAU/B"}

package/dist/utils.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchesIdentifier = matchesIdentifier;
+function matchesIdentifier(did, id, candidate) {
+    // optimized implementation of:
+    // return candidate === `#${id}` || candidate === `${did}#${id}`
+    return candidate.charCodeAt(0) === 35 // '#'
+        ? candidate.length === id.length + 1 && candidate.endsWith(id)
+        : candidate.length === id.length + 1 + did.length &&
+            candidate.charCodeAt(did.length) === 35 && // '#'
+            candidate.startsWith(did) &&
+            candidate.endsWith(id);
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAGA,8CAcC;AAdD,SAAgB,iBAAiB,CAC/B,GAAM,EACN,EAAK,EACL,SAAiB;IAEjB,+BAA+B;IAC/B,gEAAgE;IAEhE,OAAO,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,MAAM;QAC1C,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9D,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM;YAC7C,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,MAAM;YACjD,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;YACzB,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;AAC9B,CAAC","sourcesContent":["export type Identifier<D extends string, I extends string> =\n  | `#${I}`\n  | `${D}#${I}`\nexport function matchesIdentifier<D extends string, I extends string>(\n  did: D,\n  id: I,\n  candidate: string,\n): candidate is Identifier<D, I> {\n  // optimized implementation of:\n  // return candidate === `#${id}` || candidate === `${did}#${id}`\n\n  return candidate.charCodeAt(0) === 35 // '#'\n    ? candidate.length === id.length + 1 && candidate.endsWith(id)\n    : candidate.length === id.length + 1 + did.length &&\n        candidate.charCodeAt(did.length) === 35 && // '#'\n        candidate.startsWith(did) &&\n        candidate.endsWith(id)\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atproto/did",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "license": "MIT",
   "description": "DID resolution and verification library",
   "keywords": [

package/src/atproto.ts

@@ -2,7 +2,7 @@ import { z } from 'zod'
 import { DidDocument, DidService } from './did-document.js'
 import { DidError, InvalidDidError } from './did-error.js'
 import { Did } from './did.js'
-import { isFragment } from './lib/uri.js'
+import { canParse, isFragment } from './lib/uri.js'
 import {
   DID_PLC_PREFIX,
   DID_WEB_PREFIX,
@@ -11,6 +11,7 @@ import {
   isDidPlc,
   isDidWeb,
 } from './methods.js'
+import { Identifier, matchesIdentifier } from './utils.js'
 
 // This file contains atproto-specific DID validation utilities.
 
@@ -124,48 +125,110 @@ export const isAtprotoAudience = (value: unknown): value is AtprotoAudience => {
   )
 }
 
+export type AtprotoData<
+  M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,
+> = {
+  did: Did<M>
+  aka?: string
+  key?: AtprotoVerificationMethod<M>
+  pds?: AtprotoPersonalDataServerService<M>
+}
+
+export function extractAtprotoData<M extends AtprotoIdentityDidMethods>(
+  document: DidDocument<M>,
+): AtprotoData<M> {
+  return {
+    did: document.id,
+    aka: document.alsoKnownAs?.find(isAtprotoAka)?.slice(5),
+    key: document.verificationMethod?.find(
+      isAtprotoVerificationMethod<M>,
+      document,
+    ),
+    pds: document.service?.find(
+      isAtprotoPersonalDataServerService<M>,
+      document,
+    ),
+  }
+}
+
 export function extractPdsUrl(
   document: DidDocument<AtprotoIdentityDidMethods>,
 ): URL {
   const service = document.service?.find(
-    isAtprotoPersonalDataServerService<AtprotoIdentityDidMethods>,
+    isAtprotoPersonalDataServerService,
     document,
   )
 
   if (!service) {
     throw new DidError(
       document.id,
-      `Identity "${document.id}" does not have a PDS URL`,
+      `Document ${document.id} does not contain a (valid) #atproto_pds service URL`,
       'did-service-not-found',
     )
   }
 
-  try {
-    return new URL(service.serviceEndpoint)
-  } catch (cause) {
-    throw new DidError(
-      document.id,
-      `Invalid PDS URL in DID document: ${service.serviceEndpoint}`,
-      'did-document-format-error',
-      undefined,
-      cause,
-    )
-  }
+  return new URL(service.serviceEndpoint)
 }
 
-function isAtprotoPersonalDataServerService<M extends string>(
-  this: DidDocument<M>,
-  s: DidService,
-): s is {
-  id: '#atproto_pds' | `${Did<M>}#atproto_pds`
+export type AtprotoAka = `at://${string}`
+export function isAtprotoAka(value: string): value is AtprotoAka {
+  return value.startsWith('at://')
+}
+
+export type AtprotoPersonalDataServerService<
+  M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,
+> = DidService & {
+  id: Identifier<Did<M>, 'atproto_pds'>
   type: 'AtprotoPersonalDataServer'
   serviceEndpoint: string
-} {
+}
+
+export function isAtprotoPersonalDataServerService<
+  M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,
+>(
+  this: DidDocument<M>,
+  service: null | undefined | DidService,
+): service is AtprotoPersonalDataServerService<M> {
+  return (
+    service?.type === 'AtprotoPersonalDataServer' &&
+    typeof service.serviceEndpoint === 'string' &&
+    canParse(service.serviceEndpoint) &&
+    matchesIdentifier(this.id, 'atproto_pds', service.id)
+  )
+}
+
+export const ATPROTO_VERIFICATION_METHOD_TYPES = Object.freeze([
+  'EcdsaSecp256r1VerificationKey2019',
+  'EcdsaSecp256k1VerificationKey2019',
+  'Multikey',
+] as const)
+export type SupportedAtprotoVerificationMethodType =
+  (typeof ATPROTO_VERIFICATION_METHOD_TYPES)[number]
+
+type VerificationMethod = NonNullable<DidDocument['verificationMethod']>[number]
+export type AtprotoVerificationMethod<
+  M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,
+> = Extract<VerificationMethod, object> & {
+  id: Identifier<Did<M>, 'atproto'>
+  type: SupportedAtprotoVerificationMethodType
+  publicKeyMultibase: string
+}
+
+export function isAtprotoVerificationMethod<
+  M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,
+>(
+  this: DidDocument<M>,
+  method:
+    | null
+    | undefined
+    | NonNullable<DidDocument<M>['verificationMethod']>[number],
+): method is AtprotoVerificationMethod<M> {
   return (
-    typeof s.serviceEndpoint === 'string' &&
-    s.type === 'AtprotoPersonalDataServer' &&
-    (s.id.startsWith('#')
-      ? s.id === '#atproto_pds'
-      : s.id === `${this.id}#atproto_pds`)
+    typeof method === 'object' &&
+    typeof method?.publicKeyMultibase === 'string' &&
+    (ATPROTO_VERIFICATION_METHOD_TYPES as readonly unknown[]).includes(
+      method.type,
+    ) &&
+    matchesIdentifier(this.id, 'atproto', method.id)
   )
 }

package/src/index.ts

@@ -3,3 +3,4 @@ export * from './did-document.js'
 export * from './did-error.js'
 export * from './did.js'
 export * from './methods.js'
+export * from './utils.js'

package/src/lib/uri.ts

@@ -65,3 +65,14 @@ export function isHexDigit(code: number): boolean {
     (code >= 97 && code <= 102) // a-f
   )
 }
+
+export const canParse =
+  URL.canParse?.bind(URL) ??
+  ((url, base) => {
+    try {
+      new URL(url, base)
+      return true
+    } catch {
+      return false
+    }
+  })

package/src/methods/web.ts

@@ -1,19 +1,9 @@
 import { InvalidDidError } from '../did-error.js'
 import { Did, assertDidMsid } from '../did.js'
+import { canParse } from '../lib/uri.js'
 
 export const DID_WEB_PREFIX = `did:web:` satisfies Did<'web'>
 
-const canParse =
-  URL.canParse?.bind(URL) ??
-  ((url, base) => {
-    try {
-      new URL(url, base)
-      return true
-    } catch {
-      return false
-    }
-  })
-
 /**
  * This function checks if the input is a valid Web DID, as per DID spec.
  */

package/src/utils.ts

@@ -0,0 +1,18 @@
+export type Identifier<D extends string, I extends string> =
+  | `#${I}`
+  | `${D}#${I}`
+export function matchesIdentifier<D extends string, I extends string>(
+  did: D,
+  id: I,
+  candidate: string,
+): candidate is Identifier<D, I> {
+  // optimized implementation of:
+  // return candidate === `#${id}` || candidate === `${did}#${id}`
+
+  return candidate.charCodeAt(0) === 35 // '#'
+    ? candidate.length === id.length + 1 && candidate.endsWith(id)
+    : candidate.length === id.length + 1 + did.length &&
+        candidate.charCodeAt(did.length) === 35 && // '#'
+        candidate.startsWith(did) &&
+        candidate.endsWith(id)
+}

package/tsconfig.build.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/atproto.ts","./src/did-document.ts","./src/did-error.ts","./src/did.ts","./src/index.ts","./src/methods.ts","./src/lib/uri.ts","./src/methods/plc.ts","./src/methods/web.ts"],"version":"5.8.2"}
+{"root":["./src/atproto.ts","./src/did-document.ts","./src/did-error.ts","./src/did.ts","./src/index.ts","./src/methods.ts","./src/utils.ts","./src/lib/uri.ts","./src/methods/plc.ts","./src/methods/web.ts"],"version":"5.8.2"}