holosphere 1.1.16 → 1.1.18

package/holosphere-bundle.js

@@ -1,5 +1,5 @@
 /**
- * HoloSphere Bundle v1.1.16
+ * HoloSphere Bundle v1.1.18
  * Holonic Geospatial Communication Infrastructure
  * 
  * Includes:
@@ -9,7 +9,7 @@
  * - Ajv (JSON schema validation)
  * 
  * Usage:
- * <script src="https://unpkg.com/holosphere@1.1.16/holosphere-bundle.js"></script>
+ * <script src="https://unpkg.com/holosphere@1.1.18/holosphere-bundle.js"></script>
  * <script>
  *   const hs = new HoloSphere('myapp');
  * </script>
@@ -30435,16 +30435,14 @@ ${str(snapshot)}`);
         result.messages.push(`No federation found for ${holon} or no notification targets available.`);
       }
       if (propagateToParents) {
-        console.log(`[Federation] Starting parent propagation for holon: ${holon}`);
         try {
           let holonResolution;
           let isValidH3 = false;
-          if (typeof holon === "string" && holon.startsWith("8") && holon.length >= 15) {
+          if (typeof holon === "string" && /^[8][0-9A-Fa-f]+$/.test(holon) && holon.length >= 15) {
             try {
               holonResolution = getResolution(holon);
               if (holonResolution >= 0 && holonResolution <= 15) {
                 isValidH3 = true;
-                console.log(`[Federation] Holon ${holon} is valid H3 hexagon with resolution: ${holonResolution}`);
               } else {
                 console.log(`[Federation] Holon ${holon} has invalid resolution: ${holonResolution}`);
               }
@@ -30452,10 +30450,8 @@ ${str(snapshot)}`);
               console.log(`[Federation] Holon ${holon} failed H3 validation: ${error.message}`);
             }
           } else {
-            console.log(`[Federation] Holon ${holon} is not a valid H3 hexagon: does not start with '8' or too short`);
           }
           if (!isValidH3) {
-            console.log(`[Federation] Skipping parent propagation for non-H3 holon: ${holon}`);
             result.parentPropagation.messages.push(`Holon ${holon} is not a valid H3 hexagon. Skipping parent propagation.`);
             result.parentPropagation.skipped++;
           }
@@ -30464,12 +30460,10 @@ ${str(snapshot)}`);
             let currentHolon = holon;
             let currentRes = holonResolution;
             let levelsProcessed = 0;
-            console.log(`[Federation] Getting parent hexagons for ${holon} (resolution ${holonResolution}) up to ${maxParentLevels} levels`);
             while (currentRes > 0 && levelsProcessed < maxParentLevels) {
               try {
                 const parent = cellToParent(currentHolon, currentRes - 1);
                 parentHexagons.push(parent);
-                console.log(`[Federation] Found parent hexagon: ${parent} (resolution ${currentRes - 1})`);
                 currentHolon = parent;
                 currentRes--;
                 levelsProcessed++;
@@ -30481,13 +30475,10 @@ ${str(snapshot)}`);
               }
             }
             if (parentHexagons.length > 0) {
-              console.log(`[Federation] Found ${parentHexagons.length} parent hexagons to propagate to: ${parentHexagons.join(", ")}`);
               result.parentPropagation.messages.push(`Found ${parentHexagons.length} parent hexagons to propagate to: ${parentHexagons.join(", ")}`);
               const isAlreadyHologram = holosphere.isHologram(data);
-              console.log(`[Federation] Data is already hologram: ${isAlreadyHologram}`);
               const parentPropagatePromises = parentHexagons.map(async (parentHexagon) => {
                 try {
-                  console.log(`[Federation] Propagating to parent hexagon: ${parentHexagon}`);
                   let payloadToPut;
                   const parentFederationMeta = {
                     origin: holon,
@@ -30503,7 +30494,6 @@ ${str(snapshot)}`);
                   };
                   if (useHolograms && !isAlreadyHologram) {
                     const newHologram = holosphere.createHologram(holon, lens, data);
-                    console.log(`[Federation] Created hologram for parent propagation:`, newHologram);
                     payloadToPut = {
                       ...newHologram,
                       // This will be { id: data.id, soul: 'path/to/original' }
@@ -30520,7 +30510,6 @@ ${str(snapshot)}`);
                       }
                     };
                   }
-                  console.log(`[Federation] Storing in parent hexagon ${parentHexagon} with payload:`, payloadToPut);
                   await holosphere.put(parentHexagon, lens, payloadToPut, null, {
                     disableHologramRedirection: true,
                     autoPropagate: false
@@ -30537,7 +30526,6 @@ ${str(snapshot)}`);
               });
               await Promise.all(parentPropagatePromises);
             } else {
-              console.log(`[Federation] No parent hexagons found for ${holon} (already at resolution 0 or max levels reached)`);
               result.parentPropagation.messages.push(`No parent hexagons found for ${holon} (already at resolution 0 or max levels reached)`);
               result.parentPropagation.skipped++;
             }
@@ -30547,8 +30535,6 @@ ${str(snapshot)}`);
           result.parentPropagation.errors++;
           result.parentPropagation.messages.push(`Error during parent propagation: ${error.message}`);
         }
-      } else {
-        console.log(`[Federation] Parent propagation disabled for holon: ${holon}`);
       }
       result.propagated = result.success > 0 || result.parentPropagation.success > 0;
       return result;
@@ -30792,7 +30778,6 @@ ${str(snapshot)}`);
           if (soulInfo.appname !== holoInstance.appname) {
             console.warn(`Existing hologram at ${targetHolon}/${targetLens}/${targetKey} has appname (${soulInfo.appname}) in its soul ${existingItemAtPath.soul} which does not match current HoloSphere instance appname (${holoInstance.appname}). Redirecting put to soul's holon/lens within this instance.`);
           }
-          console.log(`Redirecting put for data (ID: ${data.id}). Original target ${targetHolon}/${targetLens}/${targetKey} contained hologram (ID: ${existingItemAtPath.id}, Soul: ${existingItemAtPath.soul}). New target is ${soulInfo.holon}/${soulInfo.lens}/${soulInfo.key}.`);
           targetHolon = soulInfo.holon;
           targetLens = soulInfo.lens;
           targetKey = soulInfo.key;
@@ -30883,7 +30868,6 @@ ${str(snapshot)}`);
                     const targetNodeRef = holoInstance.getNodeRef(data.soul);
                     const storedHologramInstanceSoul = `${holoInstance.appname}/${targetHolon}/${targetLens}/${targetKey}`;
                     targetNodeRef.get("_holograms").get(storedHologramInstanceSoul).put(true);
-                    console.log(`Data (ID: ${data.id}) being put is a hologram. Added its instance soul ${storedHologramInstanceSoul} to its target ${data.soul}'s _holograms set.`);
                   } else {
                     console.warn(`Data (ID: ${data.id}) being put is a hologram, but could not parse its soul ${data.soul} for tracking.`);
                   }
@@ -30904,7 +30888,6 @@ ${str(snapshot)}`);
                           // Only active holograms (deleted ones are null/removed)
                         );
                         if (hologramSouls.length > 0) {
-                          console.log(`Updating ${hologramSouls.length} active holograms for data ${data.id}`);
                           const updatePromises = hologramSouls.map(async (hologramSoul) => {
                             try {
                               const hologramSoulInfo = holoInstance.parseSoulPath(hologramSoul);
@@ -30935,7 +30918,6 @@ ${str(snapshot)}`);
                                       // Prevent recursive hologram updates
                                     }
                                   );
-                                  console.log(`Updated hologram at ${hologramSoul} with timestamp`);
                                   updatedHolograms.push({
                                     soul: hologramSoul,
                                     holon: hologramSoulInfo.holon,
@@ -31060,16 +31042,22 @@ ${str(snapshot)}`);
             if (resolveHolograms && holoInstance.isHologram(parsed)) {
               const resolvedValue = await holoInstance.resolveHologram(parsed, {
                 followHolograms: resolveHolograms,
-                visited
+                visited,
+                maxDepth: options.maxDepth || 10,
+                currentDepth: options.currentDepth || 0
               });
-              console.log(`### get/handleData received resolved value:`, resolvedValue);
               if (resolvedValue === null) {
-                console.warn(`Hologram at ${holon}/${lens}/${key} could not be fully resolved (target not found or sub-problem). Resolving null.`);
+                console.warn(`Broken hologram detected at ${holon}/${lens}/${key}. Removing it...`);
+                try {
+                  await holoInstance.delete(holon, lens, key, password);
+                  console.log(`Successfully removed broken hologram from ${holon}/${lens}/${key}`);
+                } catch (cleanupError) {
+                  console.error(`Failed to remove broken hologram at ${holon}/${lens}/${key}:`, cleanupError);
+                }
                 resolve(null);
                 return;
               }
               if (resolvedValue !== parsed) {
-                console.log(`### get/handleData using resolved data:`, resolvedValue);
                 parsed = resolvedValue;
               }
             }
@@ -31161,18 +31149,35 @@ ${str(snapshot)}`);
             const parsed = await holoInstance.parse(data);
             if (!parsed || !parsed.id) return;
             if (holoInstance.isHologram(parsed)) {
-              const resolved = await holoInstance.resolveHologram(parsed, {
-                followHolograms: true
-              });
-              if (resolved !== parsed) {
-                if (schema) {
-                  const valid = holoInstance.validator.validate(schema, resolved);
-                  if (valid || !holoInstance.strict) {
+              try {
+                const resolved = await holoInstance.resolveHologram(parsed, {
+                  followHolograms: true,
+                  maxDepth: 10,
+                  currentDepth: 0
+                });
+                if (resolved === null) {
+                  console.warn(`Broken hologram detected in getAll for key ${key}. Removing it...`);
+                  try {
+                    await holoInstance.delete(holon, lens, key, password);
+                    console.log(`Successfully removed broken hologram from ${holon}/${lens}/${key}`);
+                  } catch (cleanupError) {
+                    console.error(`Failed to remove broken hologram at ${holon}/${lens}/${key}:`, cleanupError);
+                  }
+                  return;
+                }
+                if (resolved && resolved !== parsed) {
+                  if (schema) {
+                    const valid = holoInstance.validator.validate(schema, resolved);
+                    if (valid || !holoInstance.strict) {
+                      output.set(resolved.id, resolved);
+                    }
+                  } else {
                     output.set(resolved.id, resolved);
                   }
-                } else {
-                  output.set(resolved.id, resolved);
+                  return;
                 }
+              } catch (hologramError) {
+                console.error(`Error resolving hologram for key ${key}:`, hologramError);
                 return;
               }
             }
@@ -31235,16 +31240,38 @@ ${str(snapshot)}`);
         console.warn("Parsing raw Gun object with metadata (_) - attempting cleanup:", rawData);
         const potentialData = Object.keys(rawData).reduce((acc, k) => {
           if (k !== "_") {
-            acc[k] = rawData[k];
+            if (rawData[k] && typeof rawData[k] === "object" && rawData[k]._) {
+              const parsedNested = parse(holoInstance, rawData[k]);
+              if (parsedNested !== null) {
+                acc[k] = parsedNested;
+              }
+            } else if (rawData[k] !== null) {
+              acc[k] = rawData[k];
+            }
           }
           return acc;
         }, {});
         if (Object.keys(potentialData).length === 0) {
-          console.warn("Raw Gun object had only metadata (_), returning null.");
+          console.warn("Raw Gun object had only metadata (_) or null values, returning null.");
+          return null;
+        }
+        const hasValidData = Object.values(potentialData).some(
+          (value) => value !== null && value !== void 0 && (typeof value !== "object" || Object.keys(value).length > 0)
+        );
+        if (!hasValidData) {
+          console.warn("Cleaned Gun object has no valid data, returning null.");
           return null;
         }
         return potentialData;
       } else {
+        if (Array.isArray(rawData)) {
+          const cleanedArray = rawData.map((item) => parse(holoInstance, item)).filter((item) => item !== null);
+          if (cleanedArray.length === 0) {
+            console.warn("Array contained only invalid/raw GunDB nodes, returning null.");
+            return null;
+          }
+          return cleanedArray;
+        }
         return rawData;
       }
     }
@@ -31323,7 +31350,6 @@ ${str(snapshot)}`);
                 if (ack.err) {
                   console.warn(`[deleteFunc] Error removing hologram ${deletedHologramSoul} from target ${targetSoul}:`, ack.err);
                 }
-                console.log(`Removed hologram ${deletedHologramSoul} from target ${targetSoul}'s _holograms list`);
                 resolveTrack();
               });
             });
@@ -31435,7 +31461,6 @@ ${str(snapshot)}`);
                         if (ack.err) {
                           console.warn(`[deleteAll] Error removing hologram ${deletedHologramSoul} from target ${targetSoul}:`, ack.err);
                         }
-                        console.log(`Removed hologram ${deletedHologramSoul} from target ${targetSoul}'s _holograms list`);
                         resolveTrack();
                       });
                     });
@@ -31500,7 +31525,6 @@ ${str(snapshot)}`);
                   const targetNodeRef = holoInstance.getNodeRef(data.value.soul);
                   const storedHologramInstanceSoul = `${holoInstance.appname}/${holon}/${lens}/value`;
                   targetNodeRef.get("_holograms").get(storedHologramInstanceSoul).put(true);
-                  console.log(`Data (ID: ${data.id}) being put is a hologram. Added its instance soul ${storedHologramInstanceSoul} to its target ${data.value.soul}'s _holograms set.`);
                 } else {
                   console.warn(`Data (ID: ${data.id}) being put is a hologram, but could not parse its soul ${data.value.soul} for tracking.`);
                 }
@@ -31607,7 +31631,6 @@ ${str(snapshot)}`);
                 if (ack.err) {
                   console.warn(`[deleteNode] Error removing hologram ${deletedHologramSoul} from target ${targetSoul}:`, ack.err);
                 }
-                console.log(`Removed hologram ${deletedHologramSoul} from target ${targetSoul}'s _holograms list`);
                 resolveTrack();
               });
             });
@@ -31705,7 +31728,6 @@ ${str(snapshot)}`);
                       const targetNodeRef = holoInstance.getNodeRef(dataToStore.soul);
                       const storedHologramInstanceSoul = `${holoInstance.appname}/${tableName}/${data.id}`;
                       targetNodeRef.get("_holograms").get(storedHologramInstanceSoul).put(true);
-                      console.log(`Data (ID: ${data.id}) being put is a hologram. Added its instance soul ${storedHologramInstanceSoul} to its target ${dataToStore.soul}'s _holograms set.`);
                     } else {
                       console.warn(`Data (ID: ${data.id}) being put is a hologram, but could not parse its soul ${dataToStore.soul} for tracking.`);
                     }
@@ -31728,7 +31750,6 @@ ${str(snapshot)}`);
                       const targetNodeRef = holoInstance.getNodeRef(dataToStore.soul);
                       const storedHologramInstanceSoul = `${holoInstance.appname}/${tableName}`;
                       targetNodeRef.get("_holograms").get(storedHologramInstanceSoul).put(true);
-                      console.log(`Data being put is a hologram. Added its instance soul ${storedHologramInstanceSoul} to its target ${dataToStore.soul}'s _holograms set.`);
                     } else {
                       console.warn(`Data being put is a hologram, but could not parse its soul ${dataToStore.soul} for tracking.`);
                     }
@@ -31812,7 +31833,6 @@ ${str(snapshot)}`);
                 // Always follow holograms
               });
               if (resolved === null) {
-                console.log(`Hologram at ${tableName}/${key} points to non-existent data. Deleting hologram.`);
                 try {
                   await holoInstance.deleteGlobal(tableName, key, password);
                 } catch (deleteError) {
@@ -31922,7 +31942,6 @@ ${str(snapshot)}`);
                         // Always follow holograms
                       });
                       if (resolved === null) {
-                        console.log(`Hologram at ${tableName}/${key} points to non-existent data. Deleting hologram.`);
                         try {
                           await holoInstance.deleteGlobal(tableName, key, password);
                         } catch (deleteError) {
@@ -32036,7 +32055,6 @@ ${str(snapshot)}`);
                 if (ack.err) {
                   console.warn(`[deleteGlobal] Error removing hologram ${deletedHologramSoul} from target ${targetSoul}:`, ack.err);
                 }
-                console.log(`Removed hologram ${deletedHologramSoul} from target ${targetSoul}'s _holograms list`);
                 resolveTrack();
               });
             });
@@ -32155,7 +32173,6 @@ ${str(snapshot)}`);
                           if (ack.err) {
                             console.warn(`[deleteAllGlobal] Error removing hologram ${deletedHologramSoul} from target ${targetSoul}:`, ack.err);
                           }
-                          console.log(`Removed hologram ${deletedHologramSoul} from target ${targetSoul}'s _holograms list`);
                           resolveTrack();
                         });
                       });
@@ -32207,7 +32224,6 @@ ${str(snapshot)}`);
   // hologram.js
   function createHologram(holoInstance, holon, lens, data) {
     if (isHologram(data)) {
-      console.warn("createHologram called with data that is already a hologram. Reusing existing soul:", data.soul);
       return {
         id: data.id,
         soul: data.soul
@@ -32249,57 +32265,69 @@ ${str(snapshot)}`);
     if (!isHologram(hologram)) {
       return hologram;
     }
-    const { followHolograms = true, visited = /* @__PURE__ */ new Set() } = options;
+    const {
+      followHolograms = true,
+      visited = /* @__PURE__ */ new Set(),
+      maxDepth = 10,
+      currentDepth = 0
+    } = options;
+    if (currentDepth >= maxDepth) {
+      console.warn(`!!! Maximum resolution depth (${maxDepth}) reached for soul: ${hologram.soul}. Stopping resolution.`);
+      return null;
+    }
     if (hologram.soul && visited.has(hologram.soul)) {
-      console.warn(`!!! CIRCULAR hologram detected for soul: ${hologram.soul}. Returning original hologram.`);
-      throw new Error(`CIRCULAR_REFERENCE:${hologram.soul}`);
-    } else {
-      try {
-        if (hologram.soul) {
-          const soulInfo = parseSoulPath(hologram.soul);
-          if (!soulInfo) {
-            console.warn(`Invalid soul format: ${hologram.soul}`);
-            return hologram;
-          }
-          const nextVisited = new Set(visited);
-          nextVisited.add(hologram.soul);
-          console.log(`Resolving hologram with soul: ${hologram.soul}`);
-          const originalData = await holoInstance.get(
-            soulInfo.holon,
-            soulInfo.lens,
-            soulInfo.key,
-            null,
-            {
-              resolveHolograms: followHolograms,
-              visited: nextVisited
-            }
-          );
-          console.log("### resolveHologram received originalData:", originalData);
-          if (originalData) {
-            console.log(`### Returning RESOLVED data for soul: ${hologram.soul}`);
-            return {
-              ...originalData,
-              _meta: {
-                ...originalData._meta || {},
-                // Preserve original _meta
-                resolvedFromHologram: true,
-                // This is now the primary indicator
-                hologramSoul: hologram.soul
-                // Clarified meta field
-              }
-            };
-          } else {
-            console.warn(`!!! Original data NOT FOUND for soul: ${hologram.soul}. Returning null.`);
-            return null;
+      console.warn(`!!! CIRCULAR hologram detected for soul: ${hologram.soul}. Breaking loop.`);
+      return null;
+    }
+    try {
+      if (hologram.soul) {
+        const soulInfo = parseSoulPath(hologram.soul);
+        if (!soulInfo) {
+          console.warn(`Invalid soul format: ${hologram.soul}`);
+          return null;
+        }
+        const nextVisited = new Set(visited);
+        nextVisited.add(hologram.soul);
+        const originalData = await holoInstance.get(
+          soulInfo.holon,
+          soulInfo.lens,
+          soulInfo.key,
+          null,
+          {
+            resolveHolograms: followHolograms,
+            visited: nextVisited,
+            maxDepth,
+            currentDepth: currentDepth + 1
           }
+        );
+        if (originalData && !originalData._invalidHologram) {
+          return {
+            ...originalData,
+            _meta: {
+              ...originalData._meta || {},
+              // Preserve original _meta
+              resolvedFromHologram: true,
+              // This is now the primary indicator
+              hologramSoul: hologram.soul,
+              // Clarified meta field
+              resolutionDepth: currentDepth
+            }
+          };
         } else {
-          console.warn("!!! resolveHologram called with object missing soul:", hologram);
-          return hologram;
+          console.warn(`!!! Original data NOT FOUND for soul: ${hologram.soul}. Removing broken hologram.`);
+          return null;
         }
-      } catch (error) {
-        console.error(`!!! Error resolving hologram: ${error.message}`, error);
-        return hologram;
+      } else {
+        console.warn("!!! resolveHologram called with object missing soul:", hologram);
+        return null;
       }
+    } catch (error) {
+      if (error.message?.startsWith("CIRCULAR_REFERENCE")) {
+        console.warn(`!!! Circular reference detected during hologram resolution: ${error.message}`);
+        return null;
+      }
+      console.error(`!!! Error resolving hologram: ${error.message}`, error);
+      return null;
     }
   }
 
@@ -32673,7 +32701,7 @@ ${str(snapshot)}`);
   }
 
   // holosphere.js
-  var HOLOSPHERE_VERSION = "1.1.16";
+  var HOLOSPHERE_VERSION = "1.1.18";
   var HoloSphere = class {
     /**
      * Initializes a new instance of the HoloSphere class.
@@ -32695,7 +32723,8 @@ ${str(snapshot)}`);
       });
       const defaultGunOptions = {
         peers: ["https://gun.holons.io/gun", "https://59.src.eco/gun"],
-        axe: false
+        axe: false,
+        localStorage: false
         // Add other potential defaults here if needed
       };
       const finalGunOptions = { ...defaultGunOptions, ...gunOptions };
@@ -32788,6 +32817,24 @@ ${str(snapshot)}`);
     async parse(rawData) {
       return parse(this, rawData);
     }
+    /**
+     * Filters an array of data, removing raw GunDB nodes and invalid entries.
+     * @param {Array} dataArray - Array of data that might contain raw GunDB nodes
+     * @returns {Promise<Array>} - Filtered array with only valid data
+     */
+    async filterValidData(dataArray) {
+      if (!Array.isArray(dataArray)) {
+        return [];
+      }
+      const validData = [];
+      for (const item of dataArray) {
+        const parsed = await this.parse(item);
+        if (parsed !== null) {
+          validData.push(parsed);
+        }
+      }
+      return validData;
+    }
     /**
      * Deletes a specific key from a given holon and lens.
      * @param {string} holon - The holon identifier.
@@ -33215,7 +33262,7 @@ ${str(snapshot)}`);
 })();
 /**
  * @module holosphere
- * @version 1.1.12
+ * @version 1.1.18
  * @description Holonic Geospatial Communication Infrastructure
  * @author Roberto Valenti
  * @license GPL-3.0-or-later