@atproto/did 0.4.0-next.0 → 0.5.0

package/CHANGELOG.md

@@ -1,18 +1,22 @@
 # @atproto/did
 
-## 0.4.0-next.0
+## 0.5.0
 
 ### Minor Changes
 
-- [#4929](https://github.com/bluesky-social/atproto/pull/4929) [`bb7491c`](https://github.com/bluesky-social/atproto/commit/bb7491c29e06181e1d2f8cf6eb454f9bb8ab961b) Thanks [@devinivy](https://github.com/devinivy)! - **BREAKING:** Drop support for Node.js 18 and 20. Node.js 22 is now the minimum supported version. Docker images now use Node.js 24.
+- [#4992](https://github.com/bluesky-social/atproto/pull/4992) [`622d365`](https://github.com/bluesky-social/atproto/commit/622d365aeb240133f40763a3b1c43981112837fc) Thanks [@devinivy](https://github.com/devinivy)! - **BREAKING:** Remove `AtprotoAudience` and `isAtprotoAudience`. They are superseded by `AtprotoDidRefAbsolute` and `isAtprotoDidRefAbsolute`. Adds the related `DidRefAbsolute` and `DidRefRelative` types and predicates.
 
-- [#4943](https://github.com/bluesky-social/atproto/pull/4943) [`07ae5d4`](https://github.com/bluesky-social/atproto/commit/07ae5d4452df51e045e0239da7a04cf0bc154028) Thanks [@devinivy](https://github.com/devinivy)! - **BREAKING:** Convert to pure ESM. All packages now ship `"type": "module"` with ES module output and Node16 module resolution.
+## 0.4.0
 
-  Node.js 22's `require()` compatibility layer can still load these packages in CommonJS code.
+### Minor Changes
+
+- [#4929](https://github.com/bluesky-social/atproto/pull/4929) [`f01c59f`](https://github.com/bluesky-social/atproto/commit/f01c59f5bd3f75fb8b47a9eecd4858b84033fb7c) Thanks [@devinivy](https://github.com/devinivy)! - **BREAKING:** Drop support for Node.js 18 and 20. Node.js 22 is now the minimum supported version. Docker images now use Node.js 24.
 
-- [#4930](https://github.com/bluesky-social/atproto/pull/4930) [`042df15`](https://github.com/bluesky-social/atproto/commit/042df15087c0e62cd1e715fcbf58852fab875af9) Thanks [@devinivy](https://github.com/devinivy)! - Build with TypeScript 6.0. Emitted `.d.ts` files now use TypeScript 6's stricter `Uint8Array<ArrayBuffer>` typing in places where Web/Node APIs require buffer-backed (not shared-memory) byte arrays. Consumers compiling against these types on older TypeScript should see no runtime impact, but may need to widen or cast in spots that previously relied on `Uint8Array` defaulting to `<ArrayBufferLike>`.
+- [#4943](https://github.com/bluesky-social/atproto/pull/4943) [`c459153`](https://github.com/bluesky-social/atproto/commit/c459153395a30ce89e050892c8fab7dc98e019b9) Thanks [@devinivy](https://github.com/devinivy)! - **BREAKING:** Convert to pure ESM. All packages now ship `"type": "module"` with ES module output and Node16 module resolution.
+
+  Node.js 22's `require()` compatibility layer can still load these packages in CommonJS code.
 
-  Internal: tsconfig `moduleResolution: "node"` is silenced via `ignoreDeprecations: "6.0"` for now; the proper migration to `node16`/`bundler` resolution is deferred.
+- [#4930](https://github.com/bluesky-social/atproto/pull/4930) [`908bece`](https://github.com/bluesky-social/atproto/commit/908bece169258bff5ad121e5eec157d6ded6f705) Thanks [@devinivy](https://github.com/devinivy)! - Build with TypeScript 6.0.
 
 ## 0.3.0
 

package/dist/atproto.d.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { DidDocument, DidService } from './did-document.js';
+import { DidRefAbsolute } from './did-ref.js';
 import { Did } from './did.js';
 import { Identifier } from './utils.js';
 export type AtprotoIdentityDidMethods = 'plc' | 'web';
@@ -14,8 +15,6 @@ export declare function assertAtprotoDidWeb(input: unknown): asserts input is Di
  * @see {@link https://atproto.com/specs/did#blessed-did-methods}
  */
 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;
@@ -41,5 +40,10 @@ export type AtprotoVerificationMethod<M extends AtprotoIdentityDidMethods = Atpr
     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>;
+/**
+ * An atproto-constrained absolute DID reference: `${AtprotoDid}#${fragment}`.
+ */
+export type AtprotoDidRefAbsolute = DidRefAbsolute<AtprotoIdentityDidMethods>;
+export declare function isAtprotoDidRefAbsolute(value: unknown): value is AtprotoDidRefAbsolute;
 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,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAU9B,OAAO,EAAE,UAAU,EAAqB,MAAM,YAAY,CAAA;AAI1D,MAAM,MAAM,yBAAyB,GAAG,KAAK,GAAG,KAAK,CAAA;AACrD,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,yBAAyB,CAAC,CAAA;AACvD,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,yBAAyB,CAAC,CAAA;AAEvE,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,MAAM,MAAM,WAAW,CACrB,CAAC,SAAS,yBAAyB,GAAG,yBAAyB,IAC7D;IACF,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAA;IAClC,GAAG,CAAC,EAAE,gCAAgC,CAAC,CAAC,CAAC,CAAA;CAC1C,CAAA;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,yBAAyB,EACpE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,WAAW,CAAC,CAAC,CAAC,CAahB;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,GAAG,CAe/D;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,MAAM,EAAE,CAAA;AACzC,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,MAAM,MAAM,gCAAgC,CAC1C,CAAC,SAAS,yBAAyB,GAAG,yBAAyB,IAC7D,UAAU,GAAG;IACf,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAA;IACrC,IAAI,EAAE,2BAA2B,CAAA;IACjC,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wBAAgB,kCAAkC,CAChD,CAAC,SAAS,yBAAyB,GAAG,yBAAyB,EAE/D,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,OAAO,EAAE,IAAI,GAAG,SAAS,GAAG,UAAU,GACrC,OAAO,IAAI,gCAAgC,CAAC,CAAC,CAAC,CAOhD;AAED,eAAO,MAAM,iCAAiC,iGAInC,CAAA;AACX,MAAM,MAAM,sCAAsC,GAChD,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAA;AAEpD,KAAK,kBAAkB,GAAG,WAAW,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAA;AAChF,MAAM,MAAM,yBAAyB,CACnC,CAAC,SAAS,yBAAyB,GAAG,yBAAyB,IAC7D,OAAO,CAAC,kBAAkB,EAAE,MAAM,CAAC,GAAG;IACxC,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IACjC,IAAI,EAAE,sCAAsC,CAAA;IAC5C,kBAAkB,EAAE,MAAM,CAAA;CAC3B,CAAA;AAED,wBAAgB,2BAA2B,CACzC,CAAC,SAAS,yBAAyB,GAAG,yBAAyB,EAE/D,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EACpB,MAAM,EACF,IAAI,GACJ,SAAS,GACT,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,MAAM,CAAC,GAC5D,MAAM,IAAI,yBAAyB,CAAC,CAAC,CAAC,CASxC"}
+{"version":3,"file":"atproto.d.ts","sourceRoot":"","sources":["../src/atproto.ts"],"names":[],"mappings":"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"}

package/dist/atproto.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { DidError, InvalidDidError } from './did-error.js';
-import { canParse, isFragment } from './lib/uri.js';
+import { isDidRefAbsolute } from './did-ref.js';
+import { canParse } from './lib/uri.js';
 import { DID_PLC_PREFIX, DID_WEB_PREFIX, assertDidPlc, assertDidWeb, isDidPlc, isDidWeb, } from './methods.js';
 import { matchesIdentifier } from './utils.js';
 export const atprotoDidSchema = z
@@ -72,16 +73,6 @@ function isDidWebWithHttpsPort(did) {
             did.lastIndexOf('%3A', pathIdx) !== -1;
     return hasPort;
 }
-export const isAtprotoAudience = (value) => {
-    if (typeof value !== 'string')
-        return false;
-    const hashIndex = value.indexOf('#');
-    if (hashIndex === -1)
-        return false;
-    if (value.indexOf('#', hashIndex + 1) !== -1)
-        return false;
-    return (isFragment(value, hashIndex + 1) && isAtprotoDid(value.slice(0, hashIndex)));
-};
 export function extractAtprotoData(document) {
     return {
         did: document.id,
@@ -117,4 +108,9 @@ export function isAtprotoVerificationMethod(method) {
         ATPROTO_VERIFICATION_METHOD_TYPES.includes(method.type) &&
         matchesIdentifier(this.id, 'atproto', method.id));
 }
+export function isAtprotoDidRefAbsolute(value) {
+    if (!isDidRefAbsolute(value))
+        return false;
+    return isAtprotoDid(value.slice(0, value.indexOf('#')));
+}
 //# 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 { 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>\nexport type AtprotoDidDocument = DidDocument<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(document: AtprotoDidDocument): 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"]}
+{"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 { DidRefAbsolute, isDidRefAbsolute } from './did-ref.js'\nimport { Did } from './did.js'\nimport { canParse } 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>\nexport type AtprotoDidDocument = DidDocument<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 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(document: AtprotoDidDocument): 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\n/**\n * An atproto-constrained absolute DID reference: `${AtprotoDid}#${fragment}`.\n */\nexport type AtprotoDidRefAbsolute = DidRefAbsolute<AtprotoIdentityDidMethods>\n\nexport function isAtprotoDidRefAbsolute(\n  value: unknown,\n): value is AtprotoDidRefAbsolute {\n  if (!isDidRefAbsolute(value)) return false\n  return isAtprotoDid(value.slice(0, value.indexOf('#')))\n}\n"]}

package/dist/did-ref.d.ts

@@ -0,0 +1,15 @@
+import { Did } from './did.js';
+/**
+ * An absolute DID reference: `${Did}#${fragment}`.
+ *
+ * @see {@link https://www.w3.org/TR/did-core/#did-url-syntax}
+ */
+export type DidRefAbsolute<M extends string = string> = `${Did<M>}#${string}`;
+export declare const isDidRefAbsolute: (value: unknown) => value is DidRefAbsolute;
+/**
+ * A relative DID reference (a `#fragment` resolved against the surrounding
+ * DID document's `id`). The optional `id` parameter narrows the fragment.
+ */
+export type DidRefRelative<I extends string = string> = `#${I}`;
+export declare function isDidRefRelative<I extends string = string>(value: unknown, id?: I): value is DidRefRelative<I>;
+//# sourceMappingURL=did-ref.d.ts.map

package/dist/did-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-ref.d.ts","sourceRoot":"","sources":["../src/did-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAS,MAAM,UAAU,CAAA;AAGrC;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAA;AAE7E,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cAO1D,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,IAAI,CAAC,EAAE,CAAA;AAE/D,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EACxD,KAAK,EAAE,OAAO,EACd,EAAE,CAAC,EAAE,CAAC,GACL,KAAK,IAAI,cAAc,CAAC,CAAC,CAAC,CAQ5B"}

package/dist/did-ref.js

@@ -0,0 +1,30 @@
+import { isDid } from './did.js';
+import { isFragment } from './lib/uri.js';
+export const isDidRefAbsolute = (value) => {
+    if (typeof value !== 'string')
+        return false;
+    const hashIndex = value.indexOf('#');
+    if (hashIndex === -1)
+        return false; // no '#'
+    if (hashIndex === value.length - 1)
+        return false; // empty fragment
+    if (value.includes('#', hashIndex + 1))
+        return false; // more than one '#'
+    return isFragment(value, hashIndex + 1) && isDid(value.slice(0, hashIndex));
+};
+export function isDidRefRelative(value, id) {
+    if (typeof value !== 'string')
+        return false;
+    if (value.charCodeAt(0) !== 35 /* '#' */)
+        return false; // doesn't start with '#'
+    if (value.length < 2)
+        return false; // empty fragment
+    if (value.includes('#', 1))
+        return false; // more than one '#'
+    if (!isFragment(value, 1))
+        return false;
+    if (id !== undefined && value !== `#${id}`)
+        return false; // id mismatch
+    return true;
+}
+//# sourceMappingURL=did-ref.js.map

package/dist/did-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"did-ref.js","sourceRoot":"","sources":["../src/did-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AASzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAA2B,EAAE;IAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACpC,IAAI,SAAS,KAAK,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,SAAS;IAC5C,IAAI,SAAS,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,iBAAiB;IAClE,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,oBAAoB;IACzE,OAAO,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAA;AAC7E,CAAC,CAAA;AAQD,MAAM,UAAU,gBAAgB,CAC9B,KAAc,EACd,EAAM;IAEN,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAC3C,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,SAAS;QAAE,OAAO,KAAK,CAAA,CAAC,yBAAyB;IAChF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,iBAAiB;IACpD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA,CAAC,oBAAoB;IAC7D,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IACvC,IAAI,EAAE,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,EAAE;QAAE,OAAO,KAAK,CAAA,CAAC,cAAc;IACvE,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["import { Did, isDid } from './did.js'\nimport { isFragment } from './lib/uri.js'\n\n/**\n * An absolute DID reference: `${Did}#${fragment}`.\n *\n * @see {@link https://www.w3.org/TR/did-core/#did-url-syntax}\n */\nexport type DidRefAbsolute<M extends string = string> = `${Did<M>}#${string}`\n\nexport const isDidRefAbsolute = (value: unknown): value is DidRefAbsolute => {\n  if (typeof value !== 'string') return false\n  const hashIndex = value.indexOf('#')\n  if (hashIndex === -1) return false // no '#'\n  if (hashIndex === value.length - 1) return false // empty fragment\n  if (value.includes('#', hashIndex + 1)) return false // more than one '#'\n  return isFragment(value, hashIndex + 1) && isDid(value.slice(0, hashIndex))\n}\n\n/**\n * A relative DID reference (a `#fragment` resolved against the surrounding\n * DID document's `id`). The optional `id` parameter narrows the fragment.\n */\nexport type DidRefRelative<I extends string = string> = `#${I}`\n\nexport function isDidRefRelative<I extends string = string>(\n  value: unknown,\n  id?: I,\n): value is DidRefRelative<I> {\n  if (typeof value !== 'string') return false\n  if (value.charCodeAt(0) !== 35 /* '#' */) return false // doesn't start with '#'\n  if (value.length < 2) return false // empty fragment\n  if (value.includes('#', 1)) return false // more than one '#'\n  if (!isFragment(value, 1)) return false\n  if (id !== undefined && value !== `#${id}`) return false // id mismatch\n  return true\n}\n"]}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './atproto.js';
 export * from './did-document.js';
 export * from './did-error.js';
+export * from './did-ref.js';
 export * from './did.js';
 export * from './methods.js';
 export * from './utils.js';

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;AAC5B,cAAc,YAAY,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,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -1,6 +1,7 @@
 export * from './atproto.js';
 export * from './did-document.js';
 export * from './did-error.js';
+export * from './did-ref.js';
 export * from './did.js';
 export * from './methods.js';
 export * from './utils.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","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","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"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,UAAU,CAAA;AACxB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA","sourcesContent":["export * from './atproto.js'\nexport * from './did-document.js'\nexport * from './did-error.js'\nexport * from './did-ref.js'\nexport * from './did.js'\nexport * from './methods.js'\nexport * from './utils.js'\n"]}

package/jest.config.cjs

@@ -4,12 +4,19 @@ module.exports = {
   transform: {
     '^.+\\.(t|j)s$': [
       '@swc/jest',
-      { jsc: { transform: {} }, module: { type: 'es6' } },
+      {
+        jsc: {
+          parser: { syntax: 'typescript', importAttributes: true },
+          experimental: { keepImportAttributes: true },
+          transform: {},
+        },
+        module: { type: 'es6' },
+      },
     ],
   },
   extensionsToTreatAsEsm: ['.ts'],
   transformIgnorePatterns: [],
   testTimeout: 60000,
-  setupFiles: ['<rootDir>/../../jest.setup.ts'],
+  setupFiles: ['<rootDir>/../../test.setup.ts'],
   moduleNameMapper: { '^(\\.\\.?\\/.+)\\.js$': ['$1.ts', '$1.js'] },
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atproto/did",
-  "version": "0.4.0-next.0",
+  "version": "0.5.0",
   "engines": {
     "node": ">=22"
   },

package/src/atproto.ts

@@ -1,8 +1,9 @@
 import { z } from 'zod'
 import { DidDocument, DidService } from './did-document.js'
 import { DidError, InvalidDidError } from './did-error.js'
+import { DidRefAbsolute, isDidRefAbsolute } from './did-ref.js'
 import { Did } from './did.js'
-import { canParse, isFragment } from './lib/uri.js'
+import { canParse } from './lib/uri.js'
 import {
   DID_PLC_PREFIX,
   DID_WEB_PREFIX,
@@ -115,17 +116,6 @@ function isDidWebWithHttpsPort(did: Did<'web'>): boolean {
   return hasPort
 }
 
-export type AtprotoAudience = `${AtprotoDid}#${string}`
-export const isAtprotoAudience = (value: unknown): value is AtprotoAudience => {
-  if (typeof value !== 'string') return false
-  const hashIndex = value.indexOf('#')
-  if (hashIndex === -1) return false
-  if (value.indexOf('#', hashIndex + 1) !== -1) return false
-  return (
-    isFragment(value, hashIndex + 1) && isAtprotoDid(value.slice(0, hashIndex))
-  )
-}
-
 export type AtprotoData<
   M extends AtprotoIdentityDidMethods = AtprotoIdentityDidMethods,
 > = {
@@ -231,3 +221,15 @@ export function isAtprotoVerificationMethod<
     matchesIdentifier(this.id, 'atproto', method.id)
   )
 }
+
+/**
+ * An atproto-constrained absolute DID reference: `${AtprotoDid}#${fragment}`.
+ */
+export type AtprotoDidRefAbsolute = DidRefAbsolute<AtprotoIdentityDidMethods>
+
+export function isAtprotoDidRefAbsolute(
+  value: unknown,
+): value is AtprotoDidRefAbsolute {
+  if (!isDidRefAbsolute(value)) return false
+  return isAtprotoDid(value.slice(0, value.indexOf('#')))
+}

package/src/did-ref.ts

@@ -0,0 +1,37 @@
+import { Did, isDid } from './did.js'
+import { isFragment } from './lib/uri.js'
+
+/**
+ * An absolute DID reference: `${Did}#${fragment}`.
+ *
+ * @see {@link https://www.w3.org/TR/did-core/#did-url-syntax}
+ */
+export type DidRefAbsolute<M extends string = string> = `${Did<M>}#${string}`
+
+export const isDidRefAbsolute = (value: unknown): value is DidRefAbsolute => {
+  if (typeof value !== 'string') return false
+  const hashIndex = value.indexOf('#')
+  if (hashIndex === -1) return false // no '#'
+  if (hashIndex === value.length - 1) return false // empty fragment
+  if (value.includes('#', hashIndex + 1)) return false // more than one '#'
+  return isFragment(value, hashIndex + 1) && isDid(value.slice(0, hashIndex))
+}
+
+/**
+ * A relative DID reference (a `#fragment` resolved against the surrounding
+ * DID document's `id`). The optional `id` parameter narrows the fragment.
+ */
+export type DidRefRelative<I extends string = string> = `#${I}`
+
+export function isDidRefRelative<I extends string = string>(
+  value: unknown,
+  id?: I,
+): value is DidRefRelative<I> {
+  if (typeof value !== 'string') return false
+  if (value.charCodeAt(0) !== 35 /* '#' */) return false // doesn't start with '#'
+  if (value.length < 2) return false // empty fragment
+  if (value.includes('#', 1)) return false // more than one '#'
+  if (!isFragment(value, 1)) return false
+  if (id !== undefined && value !== `#${id}`) return false // id mismatch
+  return true
+}

package/src/index.ts

@@ -1,6 +1,7 @@
 export * from './atproto.js'
 export * from './did-document.js'
 export * from './did-error.js'
+export * from './did-ref.js'
 export * from './did.js'
 export * from './methods.js'
 export * from './utils.js'

package/tests/did-ref.test.ts

@@ -0,0 +1,69 @@
+import { isAtprotoDidRefAbsolute } from '../src/atproto.js'
+import { isDidRefRelative } from '../src/did-ref.js'
+
+describe('isAtprotoDidRefAbsolute', () => {
+  it('accepts well-formed absolute references', () => {
+    expect(
+      isAtprotoDidRefAbsolute('did:plc:l3rouwludahu3ui3bt66mfvj#atproto'),
+    ).toBe(true)
+    expect(isAtprotoDidRefAbsolute('did:web:example.com#service_id')).toBe(true)
+    expect(isAtprotoDidRefAbsolute('did:web:example.com#atproto_label')).toBe(
+      true,
+    )
+  })
+
+  it('rejects bare DIDs', () => {
+    expect(isAtprotoDidRefAbsolute('did:plc:l3rouwludahu3ui3bt66mfvj')).toBe(
+      false,
+    )
+    expect(isAtprotoDidRefAbsolute('did:web:example.com')).toBe(false)
+  })
+
+  it('rejects relative references', () => {
+    expect(isAtprotoDidRefAbsolute('#atproto')).toBe(false)
+  })
+
+  it('rejects malformed input', () => {
+    expect(isAtprotoDidRefAbsolute('')).toBe(false)
+    expect(isAtprotoDidRefAbsolute('did:plc:l3rouwludahu3ui3bt66mfvj#')).toBe(
+      false,
+    )
+    expect(
+      isAtprotoDidRefAbsolute('did:plc:l3rouwludahu3ui3bt66mfvj##foo'),
+    ).toBe(false)
+    expect(
+      isAtprotoDidRefAbsolute('did:plc:l3rouwludahu3ui3bt66mfvj#a#b'),
+    ).toBe(false)
+    expect(isAtprotoDidRefAbsolute('did:foo:bar#baz')).toBe(false)
+    expect(isAtprotoDidRefAbsolute(null)).toBe(false)
+    expect(isAtprotoDidRefAbsolute(123)).toBe(false)
+  })
+})
+
+describe('isDidRefRelative', () => {
+  it('accepts well-formed relative references', () => {
+    expect(isDidRefRelative('#atproto')).toBe(true)
+    expect(isDidRefRelative('#atproto_label')).toBe(true)
+    expect(isDidRefRelative('#a')).toBe(true)
+  })
+
+  it('narrows on a specific id when supplied', () => {
+    expect(isDidRefRelative('#atproto', 'atproto')).toBe(true)
+    expect(isDidRefRelative('#atproto_label', 'atproto')).toBe(false)
+  })
+
+  it('rejects absolute references and bare strings', () => {
+    expect(isDidRefRelative('did:plc:l3rouwludahu3ui3bt66mfvj#atproto')).toBe(
+      false,
+    )
+    expect(isDidRefRelative('atproto')).toBe(false)
+  })
+
+  it('rejects malformed input', () => {
+    expect(isDidRefRelative('')).toBe(false)
+    expect(isDidRefRelative('#')).toBe(false)
+    expect(isDidRefRelative('#a#b')).toBe(false)
+    expect(isDidRefRelative(null)).toBe(false)
+    expect(isDidRefRelative(123)).toBe(false)
+  })
+})

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/utils.ts","./src/lib/uri.ts","./src/methods/plc.ts","./src/methods/web.ts"],"version":"6.0.3"}
+{"root":["./src/atproto.ts","./src/did-document.ts","./src/did-error.ts","./src/did-ref.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":"6.0.3"}