@fairfox/polly 0.58.0 → 0.60.0

package/dist/src/mesh.d.ts

@@ -27,8 +27,8 @@ export type { MeshKeyring, MeshNetworkAdapterOptions, } from "./shared/lib/mesh-
 export { DEFAULT_MESH_KEY_ID, MeshNetworkAdapter, } from "./shared/lib/mesh-network-adapter";
 export type { MeshSignalingClientOptions, SignalingMessage as MeshSignalingMessage, } from "./shared/lib/mesh-signaling-client";
 export { MeshSignalingClient } from "./shared/lib/mesh-signaling-client";
-export type { MeshStateOptions } from "./shared/lib/mesh-state";
-export { $meshCounter, $meshList, $meshState, $meshText, configureMeshState, getLastConfiguredRepoPeerId, getMeshStateModuleId, isMeshStateConfigured, MESH_STATE_MODULE_ID, resetMeshState, wasMeshStateResolved, } from "./shared/lib/mesh-state";
+export type { LazyWrapperExitReason, MeshStateLazyWrapperRecord, MeshStateLoadedRejectionBreadcrumb, MeshStateOptions, } from "./shared/lib/mesh-state";
+export { $meshCounter, $meshList, $meshState, $meshText, configureMeshState, getLastConfiguredRepoPeerId, getLastLoadedRejection, getLazyInvocations, getLazyReachedRepo, getLazyWrappers, getMeshStateModuleId, isMeshStateConfigured, MESH_STATE_MODULE_ID, resetMeshState, wasMeshStateResolved, } from "./shared/lib/mesh-state";
 export type { HandleSyncSnapshot, InFlightSyncSnapshot, MeshWebRTCAdapterOptions, SlotInitiationDecision, SlotInitiationRejectionReason, SweepSnapshot, SyncHandshakeAttemptSnapshot, SyncProgressEvent, TransportSnapshot, } from "./shared/lib/mesh-webrtc-adapter";
 export { DEFAULT_ICE_SERVERS, MeshWebRTCAdapter } from "./shared/lib/mesh-webrtc-adapter";
 export type { CreatePairingTokenOptions, PairingToken, } from "./shared/lib/pairing";

package/dist/src/mesh.js

@@ -1779,6 +1779,11 @@ function configureMeshState(repo) {
 function resetMeshState() {
   defaultRepo = undefined;
   lastConfiguredRepoPeerId = undefined;
+  meshStateEverResolved = false;
+  lazyInvocations = 0;
+  lazyReachedRepo = 0;
+  lastLoadedRejection = undefined;
+  lazyWrappers = [];
 }
 function isMeshStateConfigured() {
   return defaultRepo !== undefined;
@@ -1787,6 +1792,44 @@ var meshStateEverResolved = false;
 function wasMeshStateResolved() {
   return meshStateEverResolved;
 }
+var lazyInvocations = 0;
+function getLazyInvocations() {
+  return lazyInvocations;
+}
+var lazyReachedRepo = 0;
+function getLazyReachedRepo() {
+  return lazyReachedRepo;
+}
+var lastLoadedRejection;
+function getLastLoadedRejection() {
+  return lastLoadedRejection;
+}
+function recordLoadedRejection(thrown) {
+  const err = thrown instanceof Error ? thrown : new Error(typeof thrown === "string" ? thrown : String(thrown));
+  lastLoadedRejection = {
+    name: err.name,
+    message: err.message,
+    stack: err.stack,
+    at: Date.now()
+  };
+}
+var LAZY_WRAPPER_LOG_CAP = 64;
+var lazyWrappers = [];
+function getLazyWrappers() {
+  return lazyWrappers.slice();
+}
+function recordLazyWrapper(record) {
+  lazyWrappers.push(record);
+  if (lazyWrappers.length > LAZY_WRAPPER_LOG_CAP) {
+    lazyWrappers = lazyWrappers.slice(-LAZY_WRAPPER_LOG_CAP);
+  }
+}
+function peekHandleState(repo, documentId) {
+  const handle = repo.handles[documentId];
+  if (!handle)
+    return;
+  return typeof handle.state === "string" ? handle.state : String(handle.state ?? "unknown");
+}
 function resolveRepo(option) {
   meshStateEverResolved = true;
   const repo = option ?? defaultRepo;
@@ -1808,26 +1851,56 @@ function deriveDocumentId(key) {
 function buildHandleFactory(repo, key, initialDoc) {
   const documentId = deriveDocumentId(key);
   return async () => {
-    const cached = repo.handles[documentId];
-    if (cached) {
-      await cached.whenReady(["ready", "unavailable"]);
-      if (cached.state === "ready") {
-        return cached;
+    lazyInvocations++;
+    let exitReason = "threw";
+    let errorMessage;
+    try {
+      const cached = repo.handles[documentId];
+      lazyReachedRepo++;
+      if (cached) {
+        await cached.whenReady(["ready", "unavailable"]);
+        if (cached.state === "ready") {
+          exitReason = "returned-cached";
+          return cached;
+        }
       }
+      const stored = await repo.storageSubsystem?.loadDoc(documentId);
+      if (stored) {
+        exitReason = "loaded-from-storage";
+        return repo.find(documentId, { allowableStates: ["ready"] });
+      }
+      const seeded = Automerge.save(Automerge.from(initialDoc));
+      const handle = repo.import(seeded, { docId: documentId });
+      handle.doneLoading();
+      exitReason = "seeded-and-imported";
+      return handle;
+    } catch (err) {
+      errorMessage = err instanceof Error ? err.message : String(err);
+      recordLoadedRejection(err);
+      throw err;
+    } finally {
+      const handleState = peekHandleState(repo, documentId);
+      recordLazyWrapper({
+        key,
+        docId: documentId,
+        at: Date.now(),
+        exitReason,
+        handleRegistered: handleState !== undefined,
+        handleState,
+        errorMessage
+      });
     }
-    const stored = await repo.storageSubsystem?.loadDoc(documentId);
-    if (stored) {
-      return repo.find(documentId, { allowableStates: ["ready"] });
-    }
-    const seeded = Automerge.save(Automerge.from(initialDoc));
-    const handle = repo.import(seeded, { docId: documentId });
-    handle.doneLoading();
-    return handle;
   };
 }
+function attachLoadedRejectionSink(primitive) {
+  primitive.loaded.catch((err) => {
+    recordLoadedRejection(err);
+  });
+  return primitive;
+}
 function $meshState(key, initialValue, options = {}) {
   const repo = resolveRepo(options.repo);
-  return $crdtState({
+  return attachLoadedRejectionSink($crdtState({
     key,
     primitive: "meshState",
     initialValue,
@@ -1835,37 +1908,37 @@ function $meshState(key, initialValue, options = {}) {
     schemaVersion: options.schemaVersion,
     migrations: options.migrations,
     access: options.access
-  });
+  }));
 }
 function $meshText(key, initialValue, options = {}) {
   const repo = resolveRepo(options.repo);
-  return $crdtText(key, initialValue, {
+  return attachLoadedRejectionSink($crdtText(key, initialValue, {
     primitive: "meshState",
     getHandle: buildHandleFactory(repo, key, { text: initialValue }),
     schemaVersion: options.schemaVersion,
     migrations: options.migrations,
     access: options.access
-  });
+  }));
 }
 function $meshCounter(key, initialValue, options = {}) {
   const repo = resolveRepo(options.repo);
-  return $crdtCounter(key, initialValue, {
+  return attachLoadedRejectionSink($crdtCounter(key, initialValue, {
     primitive: "meshState",
     getHandle: buildHandleFactory(repo, key, {}),
     schemaVersion: options.schemaVersion,
     migrations: options.migrations,
     access: options.access
-  });
+  }));
 }
 function $meshList(key, initialValue, options = {}) {
   const repo = resolveRepo(options.repo);
-  return $crdtList(key, initialValue, {
+  return attachLoadedRejectionSink($crdtList(key, initialValue, {
     primitive: "meshState",
     getHandle: buildHandleFactory(repo, key, { items: initialValue }),
     schemaVersion: options.schemaVersion,
     migrations: options.migrations,
     access: options.access
-  });
+  }));
 }
 
 // src/shared/lib/mesh-webrtc-adapter.ts
@@ -2913,6 +2986,18 @@ function getReevaluateDocumentShare(repo) {
     return;
   return () => fn.call(sync);
 }
+function buildMeshStateModuleDiagnostics() {
+  return {
+    moduleId: getMeshStateModuleId(),
+    configured: isMeshStateConfigured(),
+    lastConfiguredRepoPeerId: getLastConfiguredRepoPeerId(),
+    wasResolved: wasMeshStateResolved(),
+    lazyInvocations: getLazyInvocations(),
+    lazyReachedRepo: getLazyReachedRepo(),
+    lastLoadedRejection: getLastLoadedRejection(),
+    lazyWrappers: getLazyWrappers()
+  };
+}
 function installPolly107SyncReevaluation(networkAdapter, repo) {
   const disable = typeof process !== "undefined" && process.env?.["POLLY_107_DISABLE_FIX"] === "1";
   if (disable)
@@ -3022,12 +3107,7 @@ async function createMeshClient(options) {
             lastRunAt: undefined
           },
           peers: [],
-          meshStateModule: {
-            moduleId: getMeshStateModuleId(),
-            configured: isMeshStateConfigured(),
-            lastConfiguredRepoPeerId: getLastConfiguredRepoPeerId(),
-            wasResolved: wasMeshStateResolved()
-          },
+          meshStateModule: buildMeshStateModuleDiagnostics(),
           repoHandleCount: Object.keys(repo.handles).length,
           repoHandleIds: Object.keys(repo.handles)
         };
@@ -3042,12 +3122,7 @@ async function createMeshClient(options) {
         presentPeerIds: base.presentPeerIds,
         sweep: base.sweep,
         peers: enrichedPeers,
-        meshStateModule: {
-          moduleId: getMeshStateModuleId(),
-          configured: isMeshStateConfigured(),
-          lastConfiguredRepoPeerId: getLastConfiguredRepoPeerId(),
-          wasResolved: wasMeshStateResolved()
-        },
+        meshStateModule: buildMeshStateModuleDiagnostics(),
         repoHandleCount: knownHandleIds.length,
         repoHandleIds: knownHandleIds
       };
@@ -3433,6 +3508,10 @@ export {
   isMeshStateConfigured,
   isBlobRef,
   getMeshStateModuleId,
+  getLazyWrappers,
+  getLazyReachedRepo,
+  getLazyInvocations,
+  getLastLoadedRejection,
   getLastConfiguredRepoPeerId,
   generateSigningKeyPair,
   generateDocumentKey,
@@ -3483,4 +3562,4 @@ export {
   $meshCounter
 };
 
-//# debugId=23078FA0DB4C154064756E2164756E21
+//# debugId=CC67EB2297E1036764756E2164756E21