holosphere 1.1.16 → 1.1.18

package/holosphere-bundle.esm.js

@@ -1,9 +1,9 @@
 /**
- * HoloSphere ESM Bundle v1.1.16
+ * HoloSphere ESM Bundle v1.1.18
  * ES6 Module version with all dependencies bundled
  * 
  * Usage:
- * import HoloSphere from 'https://unpkg.com/holosphere@1.1.16/holosphere-bundle.esm.js';
+ * import HoloSphere from 'https://unpkg.com/holosphere@1.1.18/holosphere-bundle.esm.js';
  * const hs = new HoloSphere('myapp');
  */
 var __create = Object.create;
@@ -30412,16 +30412,14 @@ async function propagate(holosphere, holon, lens, data, options = {}) {
       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}`);
             }
@@ -30429,10 +30427,8 @@ async function propagate(holosphere, holon, lens, data, options = {}) {
             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++;
         }
@@ -30441,12 +30437,10 @@ async function propagate(holosphere, holon, lens, data, options = {}) {
           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++;
@@ -30458,13 +30452,10 @@ async function propagate(holosphere, holon, lens, data, options = {}) {
             }
           }
           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,
@@ -30480,7 +30471,6 @@ async function propagate(holosphere, holon, lens, data, options = {}) {
                 };
                 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' }
@@ -30497,7 +30487,6 @@ async function propagate(holosphere, holon, lens, data, options = {}) {
                     }
                   };
                 }
-                console.log(`[Federation] Storing in parent hexagon ${parentHexagon} with payload:`, payloadToPut);
                 await holosphere.put(parentHexagon, lens, payloadToPut, null, {
                   disableHologramRedirection: true,
                   autoPropagate: false
@@ -30514,7 +30503,6 @@ async function propagate(holosphere, holon, lens, data, options = {}) {
             });
             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++;
           }
@@ -30524,8 +30512,6 @@ async function propagate(holosphere, holon, lens, data, options = {}) {
         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;
@@ -30769,7 +30755,6 @@ async function put(holoInstance, holon, lens, data, password = null, options = {
         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;
@@ -30860,7 +30845,6 @@ async function put(holoInstance, holon, lens, data, password = null, options = {
                   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.`);
                 }
@@ -30881,7 +30865,6 @@ async function put(holoInstance, holon, lens, data, password = null, options = {
                         // 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);
@@ -30912,7 +30895,6 @@ async function put(holoInstance, holon, lens, data, password = null, options = {
                                     // Prevent recursive hologram updates
                                   }
                                 );
-                                console.log(`Updated hologram at ${hologramSoul} with timestamp`);
                                 updatedHolograms.push({
                                   soul: hologramSoul,
                                   holon: hologramSoulInfo.holon,
@@ -31037,16 +31019,22 @@ async function get(holoInstance, holon, lens, key, password = null, options = {}
           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;
             }
           }
@@ -31138,18 +31126,35 @@ async function getAll(holoInstance, holon, lens, password = null) {
           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;
             }
           }
@@ -31212,16 +31217,38 @@ async function parse(holoInstance, rawData) {
       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;
     }
   }
@@ -31300,7 +31327,6 @@ async function deleteFunc(holoInstance, holon, lens, key, password = null) {
               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();
             });
           });
@@ -31412,7 +31438,6 @@ async function deleteAll(holoInstance, holon, lens, password = null) {
                       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();
                     });
                   });
@@ -31477,7 +31502,6 @@ async function putNode(holoInstance, holon, lens, data) {
                 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.`);
               }
@@ -31584,7 +31608,6 @@ async function deleteNode(holoInstance, holon, lens, key) {
               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();
             });
           });
@@ -31682,7 +31705,6 @@ async function putGlobal(holoInstance, tableName, data, password = null) {
                     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.`);
                   }
@@ -31705,7 +31727,6 @@ async function putGlobal(holoInstance, tableName, data, password = null) {
                     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.`);
                   }
@@ -31789,7 +31810,6 @@ async function getGlobal(holoInstance, tableName, key, password = null) {
               // 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) {
@@ -31899,7 +31919,6 @@ async function getAllGlobal(holoInstance, tableName, password = null) {
                       // 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) {
@@ -32013,7 +32032,6 @@ async function deleteGlobal(holoInstance, tableName, key, password = null) {
               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();
             });
           });
@@ -32132,7 +32150,6 @@ async function deleteAllGlobal(holoInstance, tableName, password = null) {
                         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();
                       });
                     });
@@ -32184,7 +32201,6 @@ async function deleteAllGlobal(holoInstance, tableName, password = null) {
 // 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
@@ -32226,57 +32242,69 @@ async function resolveHologram(holoInstance, hologram, options = {}) {
   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;
   }
 }
 
@@ -32650,7 +32678,7 @@ function userName(holoInstance, holonId) {
 }
 
 // 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.
@@ -32672,7 +32700,8 @@ var HoloSphere = class {
     });
     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 };
@@ -32765,6 +32794,24 @@ var HoloSphere = class {
   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.
@@ -33193,7 +33240,7 @@ export {
 };
 /**
  * @module holosphere
- * @version 1.1.12
+ * @version 1.1.18
  * @description Holonic Geospatial Communication Infrastructure
  * @author Roberto Valenti
  * @license GPL-3.0-or-later