@atproto/identity 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @atproto/identity
 
+## 0.3.0
+
+### Minor Changes
+
+- [#1773](https://github.com/bluesky-social/atproto/pull/1773) [`bb039d8e`](https://github.com/bluesky-social/atproto/commit/bb039d8e4ce5b7f70c4f3e86d1327e210ef24dc3) Thanks [@dholms](https://github.com/dholms)! - Pass stale did doc into refresh cache functions
+
+### Patch Changes
+
+- [`35d108ce`](https://github.com/bluesky-social/atproto/commit/35d108ce94866ce1b3d147cd0620a0ba1c4ebcd7) Thanks [@devinivy](https://github.com/devinivy)! - Allow pds to serve did doc with credentials, API client to respect PDS listed in the did doc.
+
+- Updated dependencies [[`35d108ce`](https://github.com/bluesky-social/atproto/commit/35d108ce94866ce1b3d147cd0620a0ba1c4ebcd7)]:
+  - @atproto/common-web@0.2.2
+
 ## 0.2.1
 
 ### Patch Changes

package/dist/did/atproto-data.d.ts

@@ -1,9 +1,6 @@
 import { DidDocument, AtprotoData } from '../types';
-export declare const getDid: (doc: DidDocument) => string;
+import { getDid, getHandle, getPdsEndpoint, getFeedGenEndpoint, getNotifEndpoint } from '@atproto/common-web';
+export { getDid, getHandle, getPdsEndpoint as getPds, getFeedGenEndpoint as getFeedGen, getNotifEndpoint as getNotif, };
 export declare const getKey: (doc: DidDocument) => string | undefined;
-export declare const getHandle: (doc: DidDocument) => string | undefined;
-export declare const getPds: (doc: DidDocument) => string | undefined;
-export declare const getFeedGen: (doc: DidDocument) => string | undefined;
-export declare const getNotif: (doc: DidDocument) => string | undefined;
 export declare const parseToAtprotoDocument: (doc: DidDocument) => Partial<AtprotoData>;
 export declare const ensureAtpDocument: (doc: DidDocument) => AtprotoData;

package/dist/did/base-resolver.d.ts

@@ -1,11 +1,11 @@
-import { DidCache, AtprotoData, DidDocument } from '../types';
+import { DidCache, AtprotoData, DidDocument, CacheResult } from '../types';
 export declare abstract class BaseResolver {
     cache?: DidCache | undefined;
     constructor(cache?: DidCache | undefined);
     abstract resolveNoCheck(did: string): Promise<unknown | null>;
     validateDidDoc(did: string, val: unknown): DidDocument;
     resolveNoCache(did: string): Promise<DidDocument | null>;
-    refreshCache(did: string): Promise<void>;
+    refreshCache(did: string, prevResult?: CacheResult): Promise<void>;
     resolve(did: string, forceRefresh?: boolean): Promise<DidDocument | null>;
     ensureResolve(did: string, forceRefresh?: boolean): Promise<DidDocument>;
     resolveAtprotoData(did: string, forceRefresh?: boolean): Promise<AtprotoData>;

package/dist/index.js

@@ -21171,14 +21171,12 @@ __export(src_exports3, {
   didDocument: () => didDocument,
   ensureAtpDocument: () => ensureAtpDocument,
   getDid: () => getDid,
-  getFeedGen: () => getFeedGen,
+  getFeedGen: () => getFeedGenEndpoint,
   getHandle: () => getHandle,
   getKey: () => getKey,
-  getNotif: () => getNotif,
-  getPds: () => getPds,
-  parseToAtprotoDocument: () => parseToAtprotoDocument,
-  service: () => service,
-  verificationMethod: () => verificationMethod
+  getNotif: () => getNotifEndpoint,
+  getPds: () => getPdsEndpoint,
+  parseToAtprotoDocument: () => parseToAtprotoDocument
 });
 module.exports = __toCommonJS(src_exports3);
 
@@ -27950,26 +27948,7 @@ var DAY = HOUR * 24;
 // ../common-web/src/strings.ts
 var import_graphemer = __toESM(require_lib());
 
-// src/types.ts
-var verificationMethod = objectType({
-  id: stringType(),
-  type: stringType(),
-  controller: stringType(),
-  publicKeyMultibase: stringType().optional()
-});
-var service = objectType({
-  id: stringType(),
-  type: stringType(),
-  serviceEndpoint: unionType([stringType(), recordType(unknownType())])
-});
-var didDocument = objectType({
-  id: stringType(),
-  alsoKnownAs: arrayType(stringType()).optional(),
-  verificationMethod: arrayType(verificationMethod).optional(),
-  service: arrayType(service).optional()
-});
-
-// src/did/atproto-data.ts
+// ../common-web/src/did-doc.ts
 var getDid = (doc) => {
   const id = doc.id;
   if (typeof id !== "string") {
@@ -27977,7 +27956,16 @@ var getDid = (doc) => {
   }
   return id;
 };
-var getKey = (doc) => {
+var getHandle = (doc) => {
+  const aka = doc.alsoKnownAs;
+  if (!aka)
+    return void 0;
+  const found = aka.find((name2) => name2.startsWith("at://"));
+  if (!found)
+    return void 0;
+  return found.slice(5);
+};
+var getSigningKey = (doc) => {
   const did = getDid(doc);
   let keys = doc.verificationMethod;
   if (!keys)
@@ -27988,56 +27976,109 @@ var getKey = (doc) => {
     keys = [keys];
   }
   const found = keys.find((key) => key.id === "#atproto" || key.id === `${did}#atproto`);
-  if (!found)
-    return void 0;
-  if (!found.publicKeyMultibase)
+  if (!found?.publicKeyMultibase)
     return void 0;
-  const keyBytes = multibaseToBytes(found.publicKeyMultibase);
-  let didKey = void 0;
-  if (found.type === "EcdsaSecp256r1VerificationKey2019") {
-    didKey = formatDidKey(P256_JWT_ALG, keyBytes);
-  } else if (found.type === "EcdsaSecp256k1VerificationKey2019") {
-    didKey = formatDidKey(SECP256K1_JWT_ALG, keyBytes);
-  } else if (found.type === "Multikey") {
-    const parsed = parseMultikey(found.publicKeyMultibase);
-    didKey = formatDidKey(parsed.jwtAlg, parsed.keyBytes);
-  }
-  return didKey;
-};
-var getHandle = (doc) => {
-  const aka = doc.alsoKnownAs;
-  if (!aka)
-    return void 0;
-  const found = aka.find((name2) => name2.startsWith("at://"));
-  if (!found)
-    return void 0;
-  return found.slice(5);
+  return {
+    type: found.type,
+    publicKeyMultibase: found.publicKeyMultibase
+  };
 };
-var getPds = (doc) => {
+var getPdsEndpoint = (doc) => {
   return getServiceEndpoint(doc, {
     id: "#atproto_pds",
     type: "AtprotoPersonalDataServer"
   });
 };
-var getFeedGen = (doc) => {
+var getFeedGenEndpoint = (doc) => {
   return getServiceEndpoint(doc, {
     id: "#bsky_fg",
     type: "BskyFeedGenerator"
   });
 };
-var getNotif = (doc) => {
+var getNotifEndpoint = (doc) => {
   return getServiceEndpoint(doc, {
     id: "#bsky_notif",
     type: "BskyNotificationService"
   });
 };
+var getServiceEndpoint = (doc, opts) => {
+  const did = getDid(doc);
+  let services = doc.service;
+  if (!services)
+    return void 0;
+  if (typeof services !== "object")
+    return void 0;
+  if (!Array.isArray(services)) {
+    services = [services];
+  }
+  const found = services.find((service2) => service2.id === opts.id || service2.id === `${did}${opts.id}`);
+  if (!found)
+    return void 0;
+  if (found.type !== opts.type) {
+    return void 0;
+  }
+  if (typeof found.serviceEndpoint !== "string") {
+    return void 0;
+  }
+  return validateUrl(found.serviceEndpoint);
+};
+var validateUrl = (urlStr) => {
+  let url;
+  try {
+    url = new URL(urlStr);
+  } catch {
+    return void 0;
+  }
+  if (!["http:", "https:"].includes(url.protocol)) {
+    return void 0;
+  } else if (!url.hostname) {
+    return void 0;
+  } else {
+    return urlStr;
+  }
+};
+var verificationMethod = z.object({
+  id: z.string(),
+  type: z.string(),
+  controller: z.string(),
+  publicKeyMultibase: z.string().optional()
+});
+var service = z.object({
+  id: z.string(),
+  type: z.string(),
+  serviceEndpoint: z.union([z.string(), z.record(z.unknown())])
+});
+var didDocument = z.object({
+  id: z.string(),
+  alsoKnownAs: z.array(z.string()).optional(),
+  verificationMethod: z.array(verificationMethod).optional(),
+  service: z.array(service).optional()
+});
+
+// src/did/atproto-data.ts
+var getKey = (doc) => {
+  const key = getSigningKey(doc);
+  if (!key)
+    return void 0;
+  const keyBytes = multibaseToBytes(key.publicKeyMultibase);
+  let didKey = void 0;
+  if (key.type === "EcdsaSecp256r1VerificationKey2019") {
+    didKey = formatDidKey(P256_JWT_ALG, keyBytes);
+  } else if (key.type === "EcdsaSecp256k1VerificationKey2019") {
+    didKey = formatDidKey(SECP256K1_JWT_ALG, keyBytes);
+  } else if (key.type === "Multikey") {
+    const parsed = parseMultikey(key.publicKeyMultibase);
+    didKey = formatDidKey(parsed.jwtAlg, parsed.keyBytes);
+  }
+  return didKey;
+};
 var parseToAtprotoDocument = (doc) => {
   const did = getDid(doc);
   return {
     did,
     signingKey: getKey(doc),
     handle: getHandle(doc),
-    pds: getPds(doc)
+    pds: getPdsEndpoint(doc)
   };
 };
 var ensureAtpDocument = (doc) => {
@@ -28056,37 +28097,6 @@ var ensureAtpDocument = (doc) => {
   }
   return { did, signingKey, handle, pds };
 };
-var validateUrl = (url) => {
-  const { hostname, protocol } = new URL(url);
-  if (!["http:", "https:"].includes(protocol)) {
-    throw new Error("Invalid pds protocol");
-  }
-  if (!hostname) {
-    throw new Error("Invalid pds hostname");
-  }
-};
-var getServiceEndpoint = (doc, opts) => {
-  const did = getDid(doc);
-  let services = doc.service;
-  if (!services)
-    return void 0;
-  if (typeof services !== "object")
-    return void 0;
-  if (!Array.isArray(services)) {
-    services = [services];
-  }
-  const found = services.find((service2) => service2.id === opts.id || service2.id === `${did}${opts.id}`);
-  if (!found)
-    return void 0;
-  if (found.type !== opts.type) {
-    return void 0;
-  }
-  if (typeof found.serviceEndpoint !== "string") {
-    return void 0;
-  }
-  validateUrl(found.serviceEndpoint);
-  return found.serviceEndpoint;
-};
 
 // src/errors.ts
 var DidNotFoundError = class extends Error {
@@ -28141,16 +28151,17 @@ var BaseResolver = class {
       return null;
     return this.validateDidDoc(did, got);
   }
-  async refreshCache(did) {
-    await this.cache?.refreshCache(did, () => this.resolveNoCache(did));
+  async refreshCache(did, prevResult) {
+    await this.cache?.refreshCache(did, () => this.resolveNoCache(did), prevResult);
   }
   async resolve(did, forceRefresh = false) {
+    let fromCache = null;
     if (this.cache && !forceRefresh) {
-      const fromCache = await this.cache.checkCache(did);
-      if (fromCache?.stale) {
-        await this.refreshCache(did);
-      }
-      if (fromCache) {
+      fromCache = await this.cache.checkCache(did);
+      if (fromCache && !fromCache.expired) {
+        if (fromCache?.stale) {
+          await this.refreshCache(did, fromCache);
+        }
         return fromCache.doc;
       }
     }
@@ -28159,7 +28170,7 @@ var BaseResolver = class {
       await this.cache?.clearEntry(did);
       return null;
     }
-    await this.cache?.cacheDid(did, got);
+    await this.cache?.cacheDid(did, got, fromCache ?? void 0);
     return got;
   }
   async ensureResolve(did, forceRefresh = false) {
@@ -28296,13 +28307,12 @@ var MemoryCache = class {
       return null;
     const now = Date.now();
     const expired = now > val.updatedAt + this.maxTTL;
-    if (expired)
-      return null;
     const stale = now > val.updatedAt + this.staleTTL;
     return {
       ...val,
       did,
-      stale
+      stale,
+      expired
     };
   }
   async clearEntry(did) {
@@ -28350,7 +28360,7 @@ var HandleResolver = class {
     const url = new URL("/.well-known/atproto-did", `https://${handle}`);
     try {
       const res = await fetch(url, { signal });
-      const did = await res.text();
+      const did = (await res.text()).split("\n")[0].trim();
       if (typeof did === "string" && did.startsWith("did:")) {
         return did;
       }
@@ -28430,9 +28440,7 @@ var IdResolver = class {
   getKey,
   getNotif,
   getPds,
-  parseToAtprotoDocument,
-  service,
-  verificationMethod
+  parseToAtprotoDocument
 });
 /*!
  * mime-db