holosphere 1.3.0-alpha3 → 1.3.0-alpha4

package/holosphere-bundle.js

@@ -1,5 +1,5 @@
 /**
- * HoloSphere Bundle v1.3.0-alpha3
+ * HoloSphere Bundle v1.3.0-alpha4
  * Holonic Geospatial Communication Infrastructure
  * 
  * Includes:
@@ -9,7 +9,7 @@
  * - Ajv (JSON schema validation)
  * 
  * Usage:
- * <script src="https://unpkg.com/holosphere@1.3.0-alpha3/holosphere-bundle.js"></script>
+ * <script src="https://unpkg.com/holosphere@1.3.0-alpha4/holosphere-bundle.js"></script>
  * <script>
  *   const hs = new HoloSphere('myapp');
  * </script>
@@ -24348,6 +24348,23 @@ var HoloSphere = (() => {
   }
 
   // federation.js
+  async function getHolonName(holosphere, space) {
+    if (!holosphere || !space) return null;
+    try {
+      const settings = await holosphere.get(space, "settings", space);
+      if (!settings) return null;
+      if (Array.isArray(settings)) {
+        const found = settings.find((s) => s && typeof s.name === "string" && s.name.trim() !== "");
+        return found ? found.name : null;
+      }
+      if (typeof settings.name === "string" && settings.name.trim() !== "") {
+        return settings.name;
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
   async function federate(holosphere, spaceId1, spaceId2, password1 = null, password2 = null, bidirectional = true, lensConfig = {}) {
     if (!spaceId1 || !spaceId2) {
       throw new Error("federate: Missing required space IDs");
@@ -24450,7 +24467,14 @@ var HoloSphere = (() => {
     }
     const subscriptions2 = [];
     let lastNotificationTime = {};
+    const partnerNames = /* @__PURE__ */ new Map();
     if (fedInfo.inbound && fedInfo.inbound.length > 0) {
+      await Promise.all(
+        fedInfo.inbound.map(async (space) => {
+          const name = await getHolonName(holosphere, space);
+          partnerNames.set(space, name);
+        })
+      );
       for (const federatedSpace of fedInfo.inbound) {
         for (const lens of lenses) {
           try {
@@ -24465,10 +24489,13 @@ var HoloSphere = (() => {
                   }
                   lastNotificationTime[key] = now;
                 }
-                if (!data.federation) {
-                  data.federation = {
+                if (!data._federation) {
+                  const partnerName = partnerNames.get(federatedSpace);
+                  data._federation = {
                     origin: federatedSpace,
-                    timestamp: now
+                    sourceLens: lens,
+                    timestamp: now,
+                    ...partnerName ? { originName: partnerName } : {}
                   };
                 }
                 await callback(data, federatedSpace, lens);
@@ -24661,6 +24688,25 @@ var HoloSphere = (() => {
       const federatedSpaces = maxFederatedSpaces === -1 ? fedInfo.inbound : fedInfo.inbound.slice(0, maxFederatedSpaces);
       spacesToQuery = spacesToQuery.concat(federatedSpaces);
     }
+    const remoteSpaces = spacesToQuery.filter((s) => s !== holon);
+    const spaceNames = /* @__PURE__ */ new Map();
+    await Promise.all(
+      remoteSpaces.map(async (space) => {
+        const name = await getHolonName(holosphere, space);
+        spaceNames.set(space, name);
+      })
+    );
+    const tagWithSource = (item, space) => {
+      if (!item || space === holon) return item;
+      const originName = spaceNames.get(space);
+      const fed = {
+        ...item._federation || {},
+        origin: space,
+        sourceLens: lens
+      };
+      if (originName) fed.originName = originName;
+      return { ...item, _federation: fed };
+    };
     for (const currentSpace of spacesToQuery) {
       if (queryIds && Array.isArray(queryIds)) {
         console.log(`Fetching specific IDs from ${currentSpace}: ${queryIds.join(", ")}`);
@@ -24669,7 +24715,7 @@ var HoloSphere = (() => {
           fetchPromises.push(
             holosphere.get(currentSpace, lens, itemId).then((item) => {
               if (item) {
-                fetchedItems.set(itemId, item);
+                fetchedItems.set(itemId, tagWithSource(item, currentSpace));
               }
             }).catch((err) => console.warn(`Error fetching item ${itemId} from ${currentSpace}: ${err.message}`))
           );
@@ -24683,7 +24729,7 @@ var HoloSphere = (() => {
           holosphere.getAll(currentSpace, lens).then((items) => {
             for (const item of items) {
               if (item && item[idField] && !fetchedItems.has(item[idField])) {
-                fetchedItems.set(item[idField], item);
+                fetchedItems.set(item[idField], tagWithSource(item, currentSpace));
               }
             }
           }).catch((err) => console.warn(`Error fetching all items from ${currentSpace}: ${err.message}`))
@@ -24715,7 +24761,21 @@ var HoloSphere = (() => {
               );
               console.log(`Original data found via soul path:`, JSON.stringify(originalData));
               if (originalData) {
-                result[i] = attachHologramMeta(originalData, item.soul);
+                const withMeta = attachHologramMeta(originalData, item.soul);
+                if (withMeta._hologram?.sourceHolon) {
+                  let sourceHolonName = spaceNames.get(withMeta._hologram.sourceHolon);
+                  if (sourceHolonName === void 0) {
+                    sourceHolonName = await getHolonName(holosphere, withMeta._hologram.sourceHolon);
+                    spaceNames.set(withMeta._hologram.sourceHolon, sourceHolonName);
+                  }
+                  if (sourceHolonName) {
+                    withMeta._hologram = {
+                      ...withMeta._hologram,
+                      sourceHolonName
+                    };
+                  }
+                }
+                result[i] = withMeta;
               } else {
                 result[i] = {
                   id: item.id,
@@ -24839,6 +24899,7 @@ var HoloSphere = (() => {
           });
           if (spaces.length > 0) {
             const isAlreadyHologram = holosphere.isHologram(data);
+            const ownName = await getHolonName(holosphere, holon);
             const propagatePromises = spaces.map(async (targetSpace) => {
               try {
                 let payloadToPut;
@@ -24848,7 +24909,8 @@ var HoloSphere = (() => {
                   sourceLens: lens,
                   // The lens from which this data is being propagated
                   propagatedAt: Date.now(),
-                  originalId: data.id
+                  originalId: data.id,
+                  ...ownName ? { originName: ownName } : {}
                 };
                 if (useHolograms && !isAlreadyHologram) {
                   const newHologram = holosphere.createHologram(holon, lens, data);
@@ -24933,6 +24995,7 @@ var HoloSphere = (() => {
             if (parentHexagons.length > 0) {
               result.parentPropagation.messages.push(`Found ${parentHexagons.length} parent hexagons to propagate to: ${parentHexagons.join(", ")}`);
               const isAlreadyHologram = holosphere.isHologram(data);
+              const ownNameParent = await getHolonName(holosphere, holon);
               const parentPropagatePromises = parentHexagons.map(async (parentHexagon) => {
                 try {
                   let payloadToPut;
@@ -24945,8 +25008,9 @@ var HoloSphere = (() => {
                     originalId: data.id,
                     propagationType: "parent",
                     // Indicate this is parent propagation
-                    parentLevel: holonResolution - getResolution(parentHexagon)
+                    parentLevel: holonResolution - getResolution(parentHexagon),
                     // How many levels up
+                    ...ownNameParent ? { originName: ownNameParent } : {}
                   };
                   if (useHolograms && !isAlreadyHologram) {
                     const newHologram = holosphere.createHologram(holon, lens, data);
@@ -25214,6 +25278,45 @@ var HoloSphere = (() => {
   }
 
   // content.js
+  function sanitizeForStorage(value, path = "", seen = /* @__PURE__ */ new WeakSet(), warnings = []) {
+    if (value === null) return null;
+    const t = typeof value;
+    if (t === "number") {
+      if (!Number.isFinite(value)) {
+        warnings.push(`${path || "<root>"}: ${value} (non-finite number)`);
+        return void 0;
+      }
+      return value;
+    }
+    if (t === "string" || t === "boolean") return value;
+    if (t === "undefined" || t === "function" || t === "symbol" || t === "bigint") {
+      warnings.push(`${path || "<root>"}: ${t}`);
+      return void 0;
+    }
+    if (t === "object") {
+      if (seen.has(value)) {
+        warnings.push(`${path || "<root>"}: circular reference`);
+        return void 0;
+      }
+      seen.add(value);
+      if (Array.isArray(value)) {
+        const out2 = [];
+        for (let i = 0; i < value.length; i++) {
+          const cleaned = sanitizeForStorage(value[i], `${path}[${i}]`, seen, warnings);
+          out2.push(cleaned === void 0 ? null : cleaned);
+        }
+        return out2;
+      }
+      const out = {};
+      for (const k of Object.keys(value)) {
+        const cleaned = sanitizeForStorage(value[k], path ? `${path}.${k}` : k, seen, warnings);
+        if (cleaned !== void 0) out[k] = cleaned;
+      }
+      return out;
+    }
+    warnings.push(`${path || "<root>"}: unsupported type ${t}`);
+    return void 0;
+  }
   async function put(holoInstance, holon, lens, data, password = null, options = {}) {
     if (!data) {
       throw new Error("put: Missing required data parameter");
@@ -25311,13 +25414,16 @@ var HoloSphere = (() => {
       }
       return new Promise((resolve, reject) => {
         try {
-          let dataToStore = { ...data };
-          if (dataToStore._meta !== void 0) {
-            delete dataToStore._meta;
-          }
-          if (dataToStore._hologram !== void 0) {
-            delete dataToStore._hologram;
+          const sanitizeWarnings = [];
+          let dataToStore = sanitizeForStorage(data, "", /* @__PURE__ */ new WeakSet(), sanitizeWarnings) || {};
+          if (sanitizeWarnings.length > 0) {
+            console.warn(
+              `holosphere.put: sanitized ${sanitizeWarnings.length} field(s) at ${targetHolon}/${targetLens}/${targetKey} (id=${data.id}):`,
+              sanitizeWarnings
+            );
           }
+          if (dataToStore._meta !== void 0) delete dataToStore._meta;
+          if (dataToStore._hologram !== void 0) delete dataToStore._hologram;
           const payload = JSON.stringify(dataToStore);
           const putCallback = async (ack) => {
             if (ack.err) {