holosphere 1.3.0-alpha5 → 1.3.0-alpha8

package/holosphere-bundle.js

@@ -1,5 +1,5 @@
 /**
- * HoloSphere Bundle v1.3.0-alpha5
+ * HoloSphere Bundle v1.3.0-alpha8
  * Holonic Geospatial Communication Infrastructure
  * 
  * Includes:
@@ -9,7 +9,7 @@
  * - Ajv (JSON schema validation)
  * 
  * Usage:
- * <script src="https://unpkg.com/holosphere@1.3.0-alpha5/holosphere-bundle.js"></script>
+ * <script src="https://unpkg.com/holosphere@1.3.0-alpha8/holosphere-bundle.js"></script>
  * <script>
  *   const hs = new HoloSphere('myapp');
  * </script>
@@ -24411,7 +24411,13 @@ var HoloSphere = (() => {
             resolveHolograms: followHolograms,
             visited: nextVisited,
             maxDepth,
-            currentDepth: currentDepth + 1
+            currentDepth: currentDepth + 1,
+            // The soul almost always points at a DIFFERENT holon's lens
+            // this peer never subscribed to, so the node is cold: Gun's
+            // `.once()` would fire `undefined` synchronously and we'd
+            // wrongly report "target not present locally". Wait for the
+            // network round-trip instead.
+            awaitNetwork: true
           }
         );
         if (originalData && !originalData._invalidHologram) {
@@ -25391,21 +25397,64 @@ var HoloSphere = (() => {
 
   // content.js
   var READ_TIMEOUT_MS = 8e3;
-  function onceWithTimeout(node, timeoutMs = READ_TIMEOUT_MS) {
+  var WRITE_TIMEOUT_MS = 5e3;
+  function onceWithTimeout(node, timeoutMs = READ_TIMEOUT_MS, { awaitNetwork = false } = {}) {
+    if (!awaitNetwork) {
+      return new Promise((resolve) => {
+        let done = false;
+        const finish = (v) => {
+          if (!done) {
+            done = true;
+            resolve(v);
+          }
+        };
+        node.once((data) => finish(data));
+        if (timeoutMs > 0) {
+          setTimeout(() => finish(null), timeoutMs);
+        }
+      });
+    }
     return new Promise((resolve) => {
       let done = false;
+      const detach = () => {
+        try {
+          if (node.off) node.off();
+        } catch {
+        }
+      };
       const finish = (v) => {
         if (!done) {
           done = true;
+          detach();
           resolve(v);
         }
       };
-      node.once((data) => finish(data));
+      node.on((data) => {
+        if (data === void 0) return;
+        finish(data);
+      });
       if (timeoutMs > 0) {
         setTimeout(() => finish(null), timeoutMs);
       }
     });
   }
+  function withWriteTimeout(promise, timeoutMs, queuedResult) {
+    if (!timeoutMs || timeoutMs <= 0) return promise;
+    return new Promise((resolve, reject) => {
+      let done = false;
+      const finish = (fn, val) => {
+        if (!done) {
+          done = true;
+          fn(val);
+        }
+      };
+      promise.then(
+        (v) => finish(resolve, v),
+        (e) => finish(reject, e)
+      );
+      setTimeout(() => finish(resolve, queuedResult), timeoutMs);
+    });
+  }
   function sanitizeForStorage(value, path = "", seen = /* @__PURE__ */ new WeakSet(), warnings = []) {
     if (value === null) return null;
     const t = typeof value;
@@ -25452,7 +25501,11 @@ var HoloSphere = (() => {
     if (!holon || !lens) {
       throw new Error("put: Missing required holon or lens parameters:", holon, lens);
     }
-    const { disableHologramRedirection = false } = options;
+    const {
+      disableHologramRedirection = false,
+      timeout: writeTimeoutOverride
+    } = options;
+    const writeTimeoutMs = writeTimeoutOverride !== void 0 ? writeTimeoutOverride : WRITE_TIMEOUT_MS;
     let targetHolon = holon;
     let targetLens = lens;
     let targetKey = data.id;
@@ -25540,7 +25593,7 @@ var HoloSphere = (() => {
           });
         });
       }
-      return new Promise((resolve, reject) => {
+      const ackPromise = new Promise((resolve, reject) => {
         try {
           const sanitizeWarnings = [];
           let dataToStore = sanitizeForStorage(data, "", /* @__PURE__ */ new WeakSet(), sanitizeWarnings) || {};
@@ -25573,16 +25626,17 @@ var HoloSphere = (() => {
                 }
               }
               let updatedHolograms = [];
-              if (!isHologram2 && !options.isHologramUpdate) {
+              const currentDataSoul = `${holoInstance.appname}/${targetHolon}/${targetLens}/${targetKey}`;
+              const cascadeVisited = new Set(options._cascadeVisited || []);
+              if (!cascadeVisited.has(currentDataSoul)) {
+                cascadeVisited.add(currentDataSoul);
                 try {
-                  const currentDataSoul = `${holoInstance.appname}/${targetHolon}/${targetLens}/${targetKey}`;
                   const currentNodeRef = holoInstance.getNodeRef(currentDataSoul);
                   await new Promise((resolveHologramUpdate) => {
                     currentNodeRef.get("_holograms").once(async (hologramsSet) => {
                       if (hologramsSet) {
                         const hologramSouls = Object.keys(hologramsSet).filter(
-                          (k) => k !== "_" && hologramsSet[k] === true
-                          // Only active holograms (deleted ones are null/removed)
+                          (k) => k !== "_" && hologramsSet[k] === true && !cascadeVisited.has(k)
                         );
                         if (hologramSouls.length > 0) {
                           const updatePromises = hologramSouls.map(async (hologramSoul) => {
@@ -25611,8 +25665,12 @@ var HoloSphere = (() => {
                                       // Don't auto-propagate hologram updates
                                       disableHologramRedirection: true,
                                       // Prevent redirection when updating holograms
-                                      isHologramUpdate: true
-                                      // Prevent recursive hologram updates
+                                      isHologramUpdate: true,
+                                      // Carry the visited set forward so the
+                                      // recursive put keeps cascading through
+                                      // this hop's `_holograms` set without
+                                      // looping back through us.
+                                      _cascadeVisited: cascadeVisited
                                     }
                                   );
                                   updatedHolograms.push({
@@ -25690,6 +25748,16 @@ var HoloSphere = (() => {
           reject(error);
         }
       });
+      return withWriteTimeout(ackPromise, writeTimeoutMs, {
+        success: true,
+        queued: true,
+        isHologramAtPath: isHologram2,
+        pathHolon: targetHolon,
+        pathLens: targetLens,
+        pathKey: targetKey,
+        propagationResult: null,
+        updatedHolograms: []
+      });
     } catch (error) {
       console.error("Error in put:", error);
       throw error;
@@ -25705,6 +25773,11 @@ var HoloSphere = (() => {
       validationOptions = {},
       visited,
       timeout = READ_TIMEOUT_MS,
+      // Network-aware read: skip Gun's cold synchronous `undefined` and wait
+      // (up to `timeout`) for a peer to answer. Used by hologram soul
+      // resolution so cross-holon reads aren't misreported as missing. See
+      // `onceWithTimeout`. Off by default to keep same-holon reads fast.
+      awaitNetwork = false,
       // `_deleted: true` is the soft-tombstone convention used by the bot,
       // the web dashboard, and the MCP council tools. Pre-this fix the
       // library was unaware of it and every caller filtered defensively.
@@ -25790,7 +25863,7 @@ var HoloSphere = (() => {
           }
         };
         const dataPath = password ? user.get("private").get(lens).get(key) : holoInstance.gun.get(holoInstance.appname).get(holon).get(lens).get(key);
-        onceWithTimeout(dataPath, timeout).then(handleData);
+        onceWithTimeout(dataPath, timeout, { awaitNetwork }).then(handleData);
       });
     } catch (error) {
       console.error("Error in get:", error);
@@ -26362,7 +26435,25 @@ var HoloSphere = (() => {
   }
 
   // global.js
-  async function putGlobal(holoInstance, tableName, data, password = null) {
+  var WRITE_TIMEOUT_MS2 = 5e3;
+  function withWriteTimeout2(promise, timeoutMs, queuedResult) {
+    if (!timeoutMs || timeoutMs <= 0) return promise;
+    return new Promise((resolve, reject) => {
+      let done = false;
+      const finish = (fn, val) => {
+        if (!done) {
+          done = true;
+          fn(val);
+        }
+      };
+      promise.then(
+        (v) => finish(resolve, v),
+        (e) => finish(reject, e)
+      );
+      setTimeout(() => finish(resolve, queuedResult), timeoutMs);
+    });
+  }
+  async function putGlobal(holoInstance, tableName, data, password = null, options = {}) {
     try {
       if (!tableName || !data) {
         throw new Error("Table name and data are required");
@@ -26409,7 +26500,8 @@ var HoloSphere = (() => {
           });
         });
       }
-      return new Promise((resolve, reject) => {
+      const writeTimeoutMs = options.timeout !== void 0 ? options.timeout : WRITE_TIMEOUT_MS2;
+      const ackPromise = new Promise((resolve, reject) => {
         try {
           let dataToStore = { ...data };
           if (dataToStore._meta !== void 0) {
@@ -26471,6 +26563,17 @@ var HoloSphere = (() => {
           reject(error);
         }
       });
+      const ACK_OK = Symbol("ackOk");
+      return withWriteTimeout2(
+        ackPromise.then(() => ACK_OK),
+        writeTimeoutMs,
+        void 0
+      ).then((result) => {
+        if (result !== ACK_OK) {
+          console.warn(`putGlobal: no ack within ${writeTimeoutMs}ms for table=${tableName} \u2014 write queued locally, will replay on reconnect`);
+        }
+        return void 0;
+      });
     } catch (error) {
       console.error("Error in putGlobal:", error);
       throw error;
@@ -27193,7 +27296,11 @@ var HoloSphere = (() => {
           try {
             let parsed = await holoInstance.parse(data);
             if (parsed && holoInstance.isHologram(parsed)) {
+              const hologramSoul = parsed.soul;
               const resolved = await holoInstance.resolveHologram(parsed, { followHolograms: true });
+              if (resolved === null) {
+                console.warn(`Hologram at ${holon}/${lens}/${key} did not resolve (soul=${hologramSoul}); skipping.`);
+              }
               if (resolved !== parsed) {
                 parsed = resolved;
               }
@@ -30554,14 +30661,14 @@ var HoloSphere = (() => {
       return deleteNode(this, holon, lens, key);
     }
     // ================================ GLOBAL FUNCTIONS ================================
-    async putGlobal(tableName, data, password = null) {
-      return putGlobal(this, tableName, data, password);
+    async putGlobal(tableName, data, password = null, options = {}) {
+      return putGlobal(this, tableName, data, password, options);
     }
     /**
      * v2-compatible alias for putGlobal (no password param)
      */
-    async writeGlobal(tableName, data) {
-      return putGlobal(this, tableName, data, null);
+    async writeGlobal(tableName, data, options = {}) {
+      return putGlobal(this, tableName, data, null, options);
     }
     async getGlobal(tableName, key, password = null) {
       return getGlobal(this, tableName, key, password);