@fairfox/polly 0.57.0 → 0.59.0

package/dist/src/mesh.d.ts

@@ -21,14 +21,14 @@ export type { EncryptedEnvelope, SealedBytes, } from "./shared/lib/encryption";
 export { decrypt, decryptOrThrow, EncryptionError, encrypt, generateDocumentKey, KEY_BYTES as ENCRYPTION_KEY_BYTES, NONCE_BYTES as ENCRYPTION_NONCE_BYTES, TAG_BYTES as ENCRYPTION_TAG_BYTES, } from "./shared/lib/encryption";
 export type { KeyringStorage } from "./shared/lib/keyring-storage";
 export { deserialiseKeyring, memoryKeyringStorage, serialiseKeyring, } from "./shared/lib/keyring-storage";
-export type { CreateMeshClientOptions, MeshClient, MeshClientHandleSnapshot, MeshClientPeerStateSnapshot, } from "./shared/lib/mesh-client";
+export type { CreateMeshClientOptions, MeshClient, MeshClientHandleSnapshot, MeshClientPeerStateSnapshot, MeshStateModuleDiagnostics, } from "./shared/lib/mesh-client";
 export { createMeshClient } from "./shared/lib/mesh-client";
 export type { MeshKeyring, MeshNetworkAdapterOptions, } from "./shared/lib/mesh-network-adapter";
 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, resetMeshState, } from "./shared/lib/mesh-state";
+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 { 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

@@ -1764,16 +1764,62 @@ function fieldEquals(a, b) {
 
 // src/shared/lib/mesh-state.ts
 var defaultRepo;
+var MESH_STATE_MODULE_ID = `mesh-state-${typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID() : Math.random().toString(36).slice(2) + Date.now().toString(36)}`;
+function getMeshStateModuleId() {
+  return MESH_STATE_MODULE_ID;
+}
+var lastConfiguredRepoPeerId;
+function getLastConfiguredRepoPeerId() {
+  return lastConfiguredRepoPeerId;
+}
 function configureMeshState(repo) {
   defaultRepo = repo;
+  lastConfiguredRepoPeerId = repo.peerId;
 }
 function resetMeshState() {
   defaultRepo = undefined;
+  lastConfiguredRepoPeerId = undefined;
+  meshStateEverResolved = false;
+  lazyInvocations = 0;
+  lazyReachedRepo = 0;
+  lastLoadedRejection = undefined;
+}
+function isMeshStateConfigured() {
+  return defaultRepo !== undefined;
+}
+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()
+  };
 }
 function resolveRepo(option) {
+  meshStateEverResolved = true;
   const repo = option ?? defaultRepo;
   if (!repo) {
-    throw new Error("Polly $meshState: no Repo configured. Call configureMeshState(repo) at startup or pass { repo } in the primitive options.");
+    if (typeof console !== "undefined" && typeof console.warn === "function") {
+      console.warn(`[polly#107 H5] $meshState resolved against unconfigured module instance ${MESH_STATE_MODULE_ID}. If createMeshClient was called elsewhere, the consumer's wrappers and the mesh client are reaching different module instances — see polly#107.`);
+    }
+    throw new Error(`Polly $meshState: no Repo configured (module instance ${MESH_STATE_MODULE_ID}). Call configureMeshState(repo) at startup or pass { repo } in the primitive options. If you have called configureMeshState elsewhere, the most likely cause is that the call resolved to a different module instance than this one — see polly#107.`);
   }
   return repo;
 }
@@ -1787,26 +1833,39 @@ 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++;
+    try {
+      const cached = repo.handles[documentId];
+      lazyReachedRepo++;
+      if (cached) {
+        await cached.whenReady(["ready", "unavailable"]);
+        if (cached.state === "ready") {
+          return cached;
+        }
       }
+      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;
+    } catch (err) {
+      recordLoadedRejection(err);
+      throw err;
     }
-    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,
@@ -1814,37 +1873,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
@@ -3000,7 +3059,18 @@ async function createMeshClient(options) {
             runCount: 0,
             lastRunAt: undefined
           },
-          peers: []
+          peers: [],
+          meshStateModule: {
+            moduleId: getMeshStateModuleId(),
+            configured: isMeshStateConfigured(),
+            lastConfiguredRepoPeerId: getLastConfiguredRepoPeerId(),
+            wasResolved: wasMeshStateResolved(),
+            lazyInvocations: getLazyInvocations(),
+            lazyReachedRepo: getLazyReachedRepo(),
+            lastLoadedRejection: getLastLoadedRejection()
+          },
+          repoHandleCount: Object.keys(repo.handles).length,
+          repoHandleIds: Object.keys(repo.handles)
         };
       }
       const base = webrtcAdapter.getPeerStateSnapshot();
@@ -3012,7 +3082,18 @@ async function createMeshClient(options) {
         knownPeerIds: base.knownPeerIds,
         presentPeerIds: base.presentPeerIds,
         sweep: base.sweep,
-        peers: enrichedPeers
+        peers: enrichedPeers,
+        meshStateModule: {
+          moduleId: getMeshStateModuleId(),
+          configured: isMeshStateConfigured(),
+          lastConfiguredRepoPeerId: getLastConfiguredRepoPeerId(),
+          wasResolved: wasMeshStateResolved(),
+          lazyInvocations: getLazyInvocations(),
+          lazyReachedRepo: getLazyReachedRepo(),
+          lastLoadedRejection: getLastLoadedRejection()
+        },
+        repoHandleCount: knownHandleIds.length,
+        repoHandleIds: knownHandleIds
       };
       return out;
     },
@@ -3382,6 +3463,7 @@ function decodeRevocation(bytes, keyring) {
   return record;
 }
 export {
+  wasMeshStateResolved,
   verify,
   signingKeyPairFromSecret,
   sign,
@@ -3392,7 +3474,13 @@ export {
   parsePairingToken,
   memoryKeyringStorage,
   isPairingTokenExpired,
+  isMeshStateConfigured,
   isBlobRef,
+  getMeshStateModuleId,
+  getLazyReachedRepo,
+  getLazyInvocations,
+  getLastLoadedRejection,
+  getLastConfiguredRepoPeerId,
   generateSigningKeyPair,
   generateDocumentKey,
   encrypt,
@@ -3427,6 +3515,7 @@ export {
   MeshSignalingClient,
   MeshNetworkAdapter,
   MemoryBlobCache,
+  MESH_STATE_MODULE_ID,
   IndexedDBBlobCache,
   EncryptionError,
   TAG_BYTES as ENCRYPTION_TAG_BYTES,
@@ -3441,4 +3530,4 @@ export {
   $meshCounter
 };
 
-//# debugId=DAB92455464EE0D864756E2164756E21
+//# debugId=5E68DFAAE223E09564756E2164756E21