holosphere 1.3.0-alpha3 → 1.3.0-alpha5

package/global.js

@@ -743,15 +743,18 @@ export async function deleteAllGlobal(holoInstance, tableName, password = null)
 
 /**
  * Subscribe to real-time changes in a global table.
+ *
+ * Returns synchronously — see {@link subscribe} for the same rationale.
+ *
  * @param {HoloSphere} holoInstance - The HoloSphere instance.
  * @param {string} tableName - The table name to subscribe to.
  * @param {string|null} key - Specific key to subscribe to, or null for all keys.
  * @param {function} callback - Callback for data changes.
  * @param {object} [options] - Subscription options.
  * @param {boolean} [options.realtimeOnly] - Only fire for new changes.
- * @returns {Promise<{ unsubscribe: () => void }>}
+ * @returns {{ unsubscribe: () => void, stop: () => void }}
  */
-export async function subscribeGlobal(holoInstance, tableName, key, callback, options = {}) {
+export function subscribeGlobal(holoInstance, tableName, key, callback, options = {}) {
     const dataPath = holoInstance.gun.get(holoInstance.appname).get(tableName);
     let active = true;
 

package/hologram.js

@@ -175,11 +175,28 @@ export async function resolveHologram(holoInstance, hologram, options = {}) {
             if (originalData && !originalData._invalidHologram) {
                     // Attach the canonical `_hologram` envelope. This is the only
                     // resolved-hologram indicator HoloSphere emits.
-                    return attachHologramMeta(originalData, hologram.soul);
+                    const withMeta = attachHologramMeta(originalData, hologram.soul);
+                    // Stamp the source holon's display name so every consumer
+                    // (subscribe, get, getAll, getFederated) has it without a
+                    // second round-trip. Cached on the instance, so a batch of
+                    // holograms from the same source resolves the name once.
+                    if (withMeta._hologram?.sourceHolon && typeof holoInstance.getHolonName === 'function') {
+                        try {
+                            const sourceHolonName = await holoInstance.getHolonName(withMeta._hologram.sourceHolon);
+                            if (sourceHolonName) {
+                                withMeta._hologram = { ...withMeta._hologram, sourceHolonName };
+                            }
+                        } catch { /* best-effort — name lookup must not fail the resolve */ }
+                    }
+                    return withMeta;
                 } else {
-                console.warn(`!!! Original data NOT FOUND for soul: ${hologram.soul}. Removing broken hologram.`);
-                
-                // Return null to indicate the hologram should be removed
+                // Note: this is informational, not a permission to delete. The
+                // source soul may simply not be reachable yet (peer offline,
+                // federation propagation in flight). Callers must decide on
+                // their own GC policy; this function only reports the miss.
+                console.warn(`Could not resolve hologram soul: ${hologram.soul} (target not present locally)`);
+
+                // Return null so the caller skips this entry.
                 return null;
                 }
             } else {