@fairfox/polly 0.59.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 { MeshStateLoadedRejectionBreadcrumb, MeshStateOptions, } from "./shared/lib/mesh-state";
-export { $meshCounter, $meshList, $meshState, $meshText, configureMeshState, getLastConfiguredRepoPeerId, getLastLoadedRejection, getLazyInvocations, getLazyReachedRepo, 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

@@ -1783,6 +1783,7 @@ function resetMeshState() {
   lazyInvocations = 0;
   lazyReachedRepo = 0;
   lastLoadedRejection = undefined;
+  lazyWrappers = [];
 }
 function isMeshStateConfigured() {
   return defaultRepo !== undefined;
@@ -1812,6 +1813,23 @@ function recordLoadedRejection(thrown) {
     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;
@@ -1834,26 +1852,43 @@ function buildHandleFactory(repo, key, initialDoc) {
   const documentId = deriveDocumentId(key);
   return async () => {
     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
+      });
     }
   };
 }
@@ -2951,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)
@@ -3060,15 +3107,7 @@ async function createMeshClient(options) {
             lastRunAt: undefined
           },
           peers: [],
-          meshStateModule: {
-            moduleId: getMeshStateModuleId(),
-            configured: isMeshStateConfigured(),
-            lastConfiguredRepoPeerId: getLastConfiguredRepoPeerId(),
-            wasResolved: wasMeshStateResolved(),
-            lazyInvocations: getLazyInvocations(),
-            lazyReachedRepo: getLazyReachedRepo(),
-            lastLoadedRejection: getLastLoadedRejection()
-          },
+          meshStateModule: buildMeshStateModuleDiagnostics(),
           repoHandleCount: Object.keys(repo.handles).length,
           repoHandleIds: Object.keys(repo.handles)
         };
@@ -3083,15 +3122,7 @@ async function createMeshClient(options) {
         presentPeerIds: base.presentPeerIds,
         sweep: base.sweep,
         peers: enrichedPeers,
-        meshStateModule: {
-          moduleId: getMeshStateModuleId(),
-          configured: isMeshStateConfigured(),
-          lastConfiguredRepoPeerId: getLastConfiguredRepoPeerId(),
-          wasResolved: wasMeshStateResolved(),
-          lazyInvocations: getLazyInvocations(),
-          lazyReachedRepo: getLazyReachedRepo(),
-          lastLoadedRejection: getLastLoadedRejection()
-        },
+        meshStateModule: buildMeshStateModuleDiagnostics(),
         repoHandleCount: knownHandleIds.length,
         repoHandleIds: knownHandleIds
       };
@@ -3477,6 +3508,7 @@ export {
   isMeshStateConfigured,
   isBlobRef,
   getMeshStateModuleId,
+  getLazyWrappers,
   getLazyReachedRepo,
   getLazyInvocations,
   getLastLoadedRejection,
@@ -3530,4 +3562,4 @@ export {
   $meshCounter
 };
 
-//# debugId=5E68DFAAE223E09564756E2164756E21
+//# debugId=CC67EB2297E1036764756E2164756E21