@atproto/did 0.5.2 → 0.5.3

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @atproto/did
 
+## 0.5.3
+
+### Patch Changes
+
+- [#5099](https://github.com/bluesky-social/atproto/pull/5099) [`b43ec31`](https://github.com/bluesky-social/atproto/commit/b43ec31f247f4461725b01226885f88bd430ca07) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Update TypeScript build to rely on references to composite internal projects
+
+- [#5099](https://github.com/bluesky-social/atproto/pull/5099) [`b43ec31`](https://github.com/bluesky-social/atproto/commit/b43ec31f247f4461725b01226885f88bd430ca07) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Bundle only necessary files in the NPM tarball, including the `CHANGELOG.md` and `README.md` files (if present).
+
+- [#5099](https://github.com/bluesky-social/atproto/pull/5099) [`b43ec31`](https://github.com/bluesky-social/atproto/commit/b43ec31f247f4461725b01226885f88bd430ca07) Thanks [@matthieusieben](https://github.com/matthieusieben)! - Build with `noImplicitAny` enabled
+
 ## 0.5.2
 
 ### Patch Changes

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

@@ -1 +1 @@
-{"version":3,"file":"did-error.d.ts","sourceRoot":"","sources":["../src/did-error.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;aAEf,GAAG,EAAE,MAAM;aAEX,IAAI,EAAE,MAAM;aACZ,MAAM;IAJxB,YACkB,GAAG,EAAE,MAAM,EAC3B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,MAAM,SAAM,EAC5B,KAAK,CAAC,EAAE,OAAO,EAGhB;IAED;;OAEG;IACH,IAAI,UAAU,WAEb;IAEQ,QAAQ,WAEhB;IAED,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAmBjD;CACF;AAED,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAExD;CACF"}
+{"version":3,"file":"did-error.d.ts","sourceRoot":"","sources":["../src/did-error.ts"],"names":[],"mappings":"AAEA,qBAAa,QAAS,SAAQ,KAAK;aAEf,GAAG,EAAE,MAAM;aAEX,IAAI,EAAE,MAAM;aACZ,MAAM;IAJxB,YACkB,GAAG,EAAE,MAAM,EAC3B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,MAAM,SAAM,EAC5B,KAAK,CAAC,EAAE,OAAO,EAGhB;IAED;;OAEG;IACH,IAAI,UAAU,WAEb;IAEQ,QAAQ,WAEhB;IAED,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAmBjD;CACF;AAED,qBAAa,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAExD;CACF"}

package/dist/did-error.js

@@ -1,3 +1,4 @@
+import { ifNumber } from './lib/number.js';
 export class DidError extends Error {
     constructor(did, message, code, status = 400, cause) {
         super(message, { cause });
@@ -23,10 +24,10 @@ export class DidError extends Error {
             : typeof cause === 'string'
                 ? cause
                 : 'An unknown error occurred';
-        const status = (typeof cause?.['statusCode'] === 'number'
-            ? cause['statusCode']
-            : undefined) ??
-            (typeof cause?.['status'] === 'number' ? cause['status'] : undefined);
+        const status = typeof cause === 'object' && cause != null
+            ? ('statusCode' in cause ? ifNumber(cause.statusCode) : undefined) ??
+                ('status' in cause ? ifNumber(cause.status) : undefined)
+            : undefined;
         return new DidError(did, message, 'did-unknown-error', status, cause);
     }
 }

package/dist/did-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"did-error.js","sourceRoot":"","sources":["../src/did-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YACkB,GAAW,EAC3B,OAAe,EACC,IAAY,EACZ,MAAM,GAAG,GAAG,EAC5B,KAAe;QAEf,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;mBANT,GAAG;oBAEH,IAAI;sBACJ,MAAM;IAIxB,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAEQ,QAAQ;QACf,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;IAC/E,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAc,EAAE,GAAW;QACrC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,OAAO,GACX,KAAK,YAAY,KAAK;YACpB,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;gBACzB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,2BAA2B,CAAA;QAEnC,MAAM,MAAM,GACV,CAAC,OAAO,KAAK,EAAE,CAAC,YAAY,CAAC,KAAK,QAAQ;YACxC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;YACrB,CAAC,CAAC,SAAS,CAAC;YACd,CAAC,OAAO,KAAK,EAAE,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAEvE,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;IACvE,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,GAAW,EAAE,OAAe,EAAE,KAAe;QACvD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IAChD,CAAC;CACF","sourcesContent":["export class DidError extends Error {\n  constructor(\n    public readonly did: string,\n    message: string,\n    public readonly code: string,\n    public readonly status = 400,\n    cause?: unknown,\n  ) {\n    super(message, { cause })\n  }\n\n  /**\n   * For compatibility with error handlers in common HTTP frameworks.\n   */\n  get statusCode() {\n    return this.status\n  }\n\n  override toString() {\n    return `${this.constructor.name} ${this.code} (${this.did}): ${this.message}`\n  }\n\n  static from(cause: unknown, did: string): DidError {\n    if (cause instanceof DidError) {\n      return cause\n    }\n\n    const message =\n      cause instanceof Error\n        ? cause.message\n        : typeof cause === 'string'\n          ? cause\n          : 'An unknown error occurred'\n\n    const status =\n      (typeof cause?.['statusCode'] === 'number'\n        ? cause['statusCode']\n        : undefined) ??\n      (typeof cause?.['status'] === 'number' ? cause['status'] : undefined)\n\n    return new DidError(did, message, 'did-unknown-error', status, cause)\n  }\n}\n\nexport class InvalidDidError extends DidError {\n  constructor(did: string, message: string, cause?: unknown) {\n    super(did, message, 'did-invalid', 400, cause)\n  }\n}\n"]}
+{"version":3,"file":"did-error.js","sourceRoot":"","sources":["../src/did-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YACkB,GAAW,EAC3B,OAAe,EACC,IAAY,EACZ,MAAM,GAAG,GAAG,EAC5B,KAAe;QAEf,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;mBANT,GAAG;oBAEH,IAAI;sBACJ,MAAM;IAIxB,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAEQ,QAAQ;QACf,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;IAC/E,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,KAAc,EAAE,GAAW;QACrC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAA;QACd,CAAC;QAED,MAAM,OAAO,GACX,KAAK,YAAY,KAAK;YACpB,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;gBACzB,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,2BAA2B,CAAA;QAEnC,MAAM,MAAM,GACV,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,IAAI;YACxC,CAAC,CAAC,CAAC,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAChE,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1D,CAAC,CAAC,SAAS,CAAA;QAEf,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,KAAK,CAAC,CAAA;IACvE,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,GAAW,EAAE,OAAe,EAAE,KAAe;QACvD,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;IAChD,CAAC;CACF","sourcesContent":["import { ifNumber } from './lib/number.js'\n\nexport class DidError extends Error {\n  constructor(\n    public readonly did: string,\n    message: string,\n    public readonly code: string,\n    public readonly status = 400,\n    cause?: unknown,\n  ) {\n    super(message, { cause })\n  }\n\n  /**\n   * For compatibility with error handlers in common HTTP frameworks.\n   */\n  get statusCode() {\n    return this.status\n  }\n\n  override toString() {\n    return `${this.constructor.name} ${this.code} (${this.did}): ${this.message}`\n  }\n\n  static from(cause: unknown, did: string): DidError {\n    if (cause instanceof DidError) {\n      return cause\n    }\n\n    const message =\n      cause instanceof Error\n        ? cause.message\n        : typeof cause === 'string'\n          ? cause\n          : 'An unknown error occurred'\n\n    const status =\n      typeof cause === 'object' && cause != null\n        ? ('statusCode' in cause ? ifNumber(cause.statusCode) : undefined) ??\n          ('status' in cause ? ifNumber(cause.status) : undefined)\n        : undefined\n\n    return new DidError(did, message, 'did-unknown-error', status, cause)\n  }\n}\n\nexport class InvalidDidError extends DidError {\n  constructor(did: string, message: string, cause?: unknown) {\n    super(did, message, 'did-invalid', 400, cause)\n  }\n}\n"]}

package/dist/lib/number.d.ts

@@ -0,0 +1,2 @@
+export declare const ifNumber: (value: unknown) => undefined | number;
+//# sourceMappingURL=number.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../src/lib/number.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,SAAS,GAAG,MACP,CAAA"}

package/dist/lib/number.js

@@ -0,0 +1,2 @@
+export const ifNumber = (value) => typeof value === 'number' ? value : undefined;
+//# sourceMappingURL=number.js.map

package/dist/lib/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../src/lib/number.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAsB,EAAE,CAC7D,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA","sourcesContent":["export const ifNumber = (value: unknown): undefined | number =>\n  typeof value === 'number' ? value : undefined\n"]}

package/package.json

@@ -1,9 +1,6 @@
 {
   "name": "@atproto/did",
-  "version": "0.5.2",
-  "engines": {
-    "node": ">=22"
-  },
+  "version": "0.5.3",
   "license": "MIT",
   "description": "DID resolution and verification library",
   "keywords": [
@@ -18,6 +15,10 @@
     "url": "https://github.com/bluesky-social/atproto",
     "directory": "packages/did"
   },
+  "files": [
+    "./dist",
+    "./CHANGELOG.md"
+  ],
   "type": "module",
   "exports": {
     ".": {
@@ -25,6 +26,9 @@
       "default": "./dist/index.js"
     }
   },
+  "engines": {
+    "node": ">=22"
+  },
   "dependencies": {
     "zod": "^3.23.8"
   },

package/jest.config.cjs

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

package/src/atproto.ts

@@ -1,235 +0,0 @@
-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 } from './lib/uri.js'
-import {
-  DID_PLC_PREFIX,
-  DID_WEB_PREFIX,
-  assertDidPlc,
-  assertDidWeb,
-  isDidPlc,
-  isDidWeb,
-} from './methods.js'
-import { Identifier, matchesIdentifier } from './utils.js'
-
-// This file contains atproto-specific DID validation utilities.
-
-export type AtprotoIdentityDidMethods = 'plc' | 'web'
-export type AtprotoDid = Did<AtprotoIdentityDidMethods>
-export type AtprotoDidDocument = DidDocument<AtprotoIdentityDidMethods>
-
-export const atprotoDidSchema = z
-  .string()
-  .refine(isAtprotoDid, `Atproto only allows "plc" and "web" DID methods`)
-
-export function isAtprotoDid(input: unknown): input is AtprotoDid {
-  return isDidPlc(input) || isAtprotoDidWeb(input)
-}
-
-export function asAtprotoDid<T>(input: T) {
-  assertAtprotoDid(input)
-  return input
-}
-
-export function assertAtprotoDid(input: unknown): asserts input is AtprotoDid {
-  if (typeof input !== 'string') {
-    throw new InvalidDidError(typeof input, `DID must be a string`)
-  } else if (input.startsWith(DID_PLC_PREFIX)) {
-    assertDidPlc(input)
-  } else if (input.startsWith(DID_WEB_PREFIX)) {
-    assertAtprotoDidWeb(input)
-  } else {
-    throw new InvalidDidError(
-      input,
-      `Atproto only allows "plc" and "web" DID methods`,
-    )
-  }
-}
-
-export function assertAtprotoDidWeb(
-  input: unknown,
-): asserts input is Did<'web'> {
-  assertDidWeb(input)
-
-  if (isDidWebWithPath(input)) {
-    throw new InvalidDidError(
-      input,
-      `Atproto does not allow path components in Web DIDs`,
-    )
-  }
-
-  if (isDidWebWithHttpsPort(input)) {
-    throw new InvalidDidError(
-      input,
-      `Atproto does not allow port numbers in Web DIDs, except for localhost`,
-    )
-  }
-}
-
-/**
- * @see {@link https://atproto.com/specs/did#blessed-did-methods}
- */
-export function isAtprotoDidWeb(input: unknown): input is Did<'web'> {
-  if (!isDidWeb(input)) {
-    return false
-  }
-
-  if (isDidWebWithPath(input)) {
-    return false
-  }
-
-  if (isDidWebWithHttpsPort(input)) {
-    return false
-  }
-
-  return true
-}
-
-function isDidWebWithPath(did: Did<'web'>): boolean {
-  return did.includes(':', DID_WEB_PREFIX.length)
-}
-
-function isLocalhostDid(did: Did<'web'>): boolean {
-  return (
-    did === 'did:web:localhost' ||
-    did.startsWith('did:web:localhost:') ||
-    did.startsWith('did:web:localhost%3A')
-  )
-}
-
-function isDidWebWithHttpsPort(did: Did<'web'>): boolean {
-  if (isLocalhostDid(did)) return false
-
-  const pathIdx = did.indexOf(':', DID_WEB_PREFIX.length)
-
-  const hasPort =
-    pathIdx === -1
-      ? // No path component, check if there's a port separator anywhere after
-        // the "did:web:" prefix
-        did.includes('%3A', DID_WEB_PREFIX.length)
-      : // There is a path component; if there is an encoded colon *before* it,
-        // then there is a port number
-        did.lastIndexOf('%3A', pathIdx) !== -1
-
-  return hasPort
-}
-
-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: AtprotoDidDocument): URL {
-  const service = document.service?.find(
-    isAtprotoPersonalDataServerService,
-    document,
-  )
-
-  if (!service) {
-    throw new DidError(
-      document.id,
-      `Document ${document.id} does not contain a (valid) #atproto_pds service URL`,
-      'did-service-not-found',
-    )
-  }
-
-  return new URL(service.serviceEndpoint)
-}
-
-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 method === 'object' &&
-    typeof method?.publicKeyMultibase === 'string' &&
-    (ATPROTO_VERIFICATION_METHOD_TYPES as readonly unknown[]).includes(
-      method.type,
-    ) &&
-    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-document.ts

@@ -1,159 +0,0 @@
-import { z } from 'zod'
-import { Did, didSchema } from './did.js'
-import { isFragment } from './lib/uri.js'
-
-/**
- * RFC3968 compliant URI
- *
- * @see {@link https://www.rfc-editor.org/rfc/rfc3986}
- */
-const rfc3968UriSchema = z.string().url('RFC3968 compliant URI')
-
-const didControllerSchema = z.union([didSchema, z.array(didSchema)])
-
-/**
- * @note this schema is too permissive
- */
-const didRelativeUriSchema = z.union([
-  rfc3968UriSchema.refine(
-    (value) => {
-      const fragmentIndex = value.indexOf('#')
-      if (fragmentIndex === -1) return false
-      return isFragment(value, fragmentIndex + 1)
-    },
-    {
-      message: 'Missing or invalid fragment in RFC3968 URI',
-    },
-  ),
-  z
-    .string()
-    .refine((value) => value.charCodeAt(0) === 35 /* # */, {
-      message: 'Fragment must start with #',
-    })
-    .refine((value) => isFragment(value, 1), {
-      message: 'Invalid char in URI fragment',
-    }),
-])
-
-/**
- * @see {@link https://www.w3.org/TR/did-1.0/#verification-material Verification Material}
- */
-const didVerificationMethodSchema = z.object({
-  id: didRelativeUriSchema,
-  type: z.string().min(1),
-  controller: didControllerSchema,
-  publicKeyJwk: z.record(z.string(), z.unknown()).optional(),
-  publicKeyMultibase: z.string().optional(),
-})
-
-/**
- * The value of the id property MUST be a URI conforming to [RFC3986]. A
- * conforming producer MUST NOT produce multiple service entries with the same
- * id. A conforming consumer MUST produce an error if it detects multiple
- * service entries with the same id.
- *
- * @note Normally, only rfc3968UriSchema should be allowed here. However, the
- *   did:plc uses relative URI. For this reason, we also allow relative URIs
- *   here.
- */
-const didServiceIdSchema = didRelativeUriSchema
-
-/**
- * The value of the type property MUST be a string or a set of strings. In order
- * to maximize interoperability, the service type and its associated properties
- * SHOULD be registered in the DID Specification Registries
- * [DID-SPEC-REGISTRIES].
- */
-const didServiceTypeSchema = z.union([z.string(), z.array(z.string())])
-
-/**
- * The value of the serviceEndpoint property MUST be a string, a map, or a set
- * composed of one or more strings and/or maps. All string values MUST be valid
- * URIs conforming to [RFC3986] and normalized according to the Normalization
- * and Comparison rules in RFC3986 and to any normalization rules in its
- * applicable URI scheme specification.
- */
-const didServiceEndpointSchema = z.union([
-  rfc3968UriSchema,
-  z.record(z.string(), rfc3968UriSchema),
-  z
-    .array(z.union([rfc3968UriSchema, z.record(z.string(), rfc3968UriSchema)]))
-    .nonempty(),
-])
-
-/**
- * Each service map MUST contain id, type, and serviceEndpoint properties.
- * @see {@link https://www.w3.org/TR/did-core/#services}
- */
-const didServiceSchema = z.object({
-  id: didServiceIdSchema,
-  type: didServiceTypeSchema,
-  serviceEndpoint: didServiceEndpointSchema,
-})
-
-export type DidService = z.infer<typeof didServiceSchema>
-
-/**
- * @see {@link https://www.w3.org/TR/did-1.0/#referring-to-verification-methods Referring to Verification Methods}
- */
-const verificationMethodReference = z.union([
-  //
-  didRelativeUriSchema,
-  didVerificationMethodSchema,
-])
-
-/**
- * @note This schema is incomplete
- * @see {@link https://www.w3.org/TR/did-core/#production-0}
- */
-export const didDocumentSchema = z.object({
-  '@context': z
-    .union([
-      z.literal('https://www.w3.org/ns/did/v1'),
-      z
-        .array(z.string().url())
-        .nonempty()
-        .refine((data) => data[0] === 'https://www.w3.org/ns/did/v1', {
-          message: 'First @context must be https://www.w3.org/ns/did/v1',
-        }),
-    ])
-    // @NOTE @context is required by producers, but optional for consumers.
-    .optional(),
-  id: didSchema,
-  controller: didControllerSchema.optional(),
-  alsoKnownAs: z.array(rfc3968UriSchema).optional(),
-  service: z.array(didServiceSchema).optional(),
-  authentication: z.array(verificationMethodReference).optional(),
-  verificationMethod: z.array(didVerificationMethodSchema).optional(),
-})
-
-export type DidDocument<Method extends string = string> = z.infer<
-  typeof didDocumentSchema
-> & { id: Did<Method> }
-
-// @TODO: add other refinements ?
-export const didDocumentValidator = didDocumentSchema
-  // Ensure that every service id is unique
-  .superRefine(({ id: did, service }, ctx) => {
-    if (service) {
-      const visited = new Set()
-
-      for (let i = 0; i < service.length; i++) {
-        const current = service[i]
-
-        const serviceId = current.id.startsWith('#')
-          ? `${did}${current.id}`
-          : current.id
-
-        if (!visited.has(serviceId)) {
-          visited.add(serviceId)
-        } else {
-          ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: `Duplicate service id (${current.id}) found in the document`,
-            path: ['service', i, 'id'],
-          })
-        }
-      }
-    }
-  })

package/src/did-error.ts

@@ -1,49 +0,0 @@
-export class DidError extends Error {
-  constructor(
-    public readonly did: string,
-    message: string,
-    public readonly code: string,
-    public readonly status = 400,
-    cause?: unknown,
-  ) {
-    super(message, { cause })
-  }
-
-  /**
-   * For compatibility with error handlers in common HTTP frameworks.
-   */
-  get statusCode() {
-    return this.status
-  }
-
-  override toString() {
-    return `${this.constructor.name} ${this.code} (${this.did}): ${this.message}`
-  }
-
-  static from(cause: unknown, did: string): DidError {
-    if (cause instanceof DidError) {
-      return cause
-    }
-
-    const message =
-      cause instanceof Error
-        ? cause.message
-        : typeof cause === 'string'
-          ? cause
-          : 'An unknown error occurred'
-
-    const status =
-      (typeof cause?.['statusCode'] === 'number'
-        ? cause['statusCode']
-        : undefined) ??
-      (typeof cause?.['status'] === 'number' ? cause['status'] : undefined)
-
-    return new DidError(did, message, 'did-unknown-error', status, cause)
-  }
-}
-
-export class InvalidDidError extends DidError {
-  constructor(did: string, message: string, cause?: unknown) {
-    super(did, message, 'did-invalid', 400, cause)
-  }
-}

package/src/did-ref.ts

@@ -1,37 +0,0 @@
-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
-}