memorio 4.9.10 → 4.9.31

package/index.cjs

@@ -645,24 +645,29 @@ var init_store = __esm({
             }, "value")
           },
           /**
-           * Calculates total size of all memorio items (characters).
+           * Calculates total size of all memorio items in kilobytes.
+           * Counts each prefixed key and its JSON-serialized value, summing their
+           * byte lengths and converting to whole kilobytes (Math.ceil). Replaces
+           * the previous character-only total which did not express real usage.
+           * @returns Total size in kilobytes (0 when empty / no memorio items).
            */
           size: {
             value: /* @__PURE__ */ __name(() => {
-              let totalSize = 0;
+              let totalBytes = 0;
               if (_hasStorage) {
-                Object.keys(_localStorage).forEach((key) => {
-                  if (key.startsWith(_getPrefix())) {
+                for (let i = 0; i < _localStorage.length; i++) {
+                  const key = _localStorage.key(i);
+                  if (key && key.startsWith(_getPrefix())) {
                     const item = _localStorage.getItem(key);
-                    if (item) totalSize += item.length;
+                    if (item) totalBytes += key.length + item.length;
                   }
-                });
+                }
               } else {
-                _getFallbackStorage().forEach((value) => {
-                  totalSize += value.length;
+                _getFallbackStorage().forEach((value, key) => {
+                  totalBytes += key.length + value.length;
                 });
               }
-              return totalSize;
+              return totalBytes === 0 ? 0 : Math.ceil(totalBytes / 1024);
             }, "value")
           },
           /**
@@ -1733,30 +1738,51 @@ var dispatch = {
   }, "set"),
   ///
   /**
-   * Listens for the specified event names and executes the callback when the event is triggered.
+   * Subscribes a callback to an event name. Maintains a *list* of handlers per
+   * name, so multiple subscribers on the same path (e.g. several
+   * `useObserver` calls observing `state.report`) each keep firing and each
+   * get an independent unsubscribe. The previous single-slot-per-name
+   * behaviour silently dropped the second subscriber and let any unsubscribe
+   * cancel every other subscriber on that path.
    * @param name The name of the event to listen for.
    * @param cb The callback function to execute when the event is triggered.
+   * @returns An unsubscribe function for this subscriber, or void if no callback.
    */
   listen: /* @__PURE__ */ __name((name, cb = null, _flag) => {
-    if (globalThis.events?.[name]) return;
-    const exec = cb ? (e) => {
+    if (!cb) return;
+    const wrapped = /* @__PURE__ */ __name((e) => {
       const target = e;
-      return globalThis.queueMicrotask ? globalThis.queueMicrotask(() => cb(target)) : Promise.resolve().then(() => cb(target));
-    } : void 0;
-    if (exec) globalThis.addEventListener(name, exec);
-    if (exec) globalThis.events[name] = exec;
+      if (globalThis.queueMicrotask) {
+        globalThis.queueMicrotask(() => cb(target));
+      } else {
+        Promise.resolve().then(() => cb(target));
+      }
+    }, "wrapped");
+    globalThis.addEventListener(name, wrapped);
+    const list = globalThis.events[name] = globalThis.events[name] ?? [];
+    list.push(wrapped);
+    return () => {
+      globalThis.removeEventListener(name, wrapped);
+      const idx = list.indexOf(wrapped);
+      if (idx > -1) list.splice(idx, 1);
+      if (!list.length) delete globalThis.events[name];
+    };
   }, "listen"),
   ///
   /**
-   * Removes the event listener for the specified event names.
-   * @param name The name of the event to remove the listener for.
+   * Removes ALL handlers for the specified event name (imperative bulk
+   * removal). For per-subscriber teardown, use the unsubscribe function
+   * returned by `listen`.
+   * @param name The name of the event to remove the listeners for.
    */
   remove: /* @__PURE__ */ __name((name) => {
-    const listener = globalThis.events?.[name];
-    if (listener) {
-      globalThis.removeEventListener(name, listener);
-      delete globalThis.events[name];
+    const entry = globalThis.events?.[name];
+    if (Array.isArray(entry)) {
+      entry.forEach((h) => globalThis.removeEventListener(name, h));
+    } else if (typeof entry === "function") {
+      globalThis.removeEventListener(name, entry);
     }
+    delete globalThis.events[name];
   }, "remove")
 };
 
@@ -2285,27 +2311,28 @@ if (globalThis[SESSION_INSTANCE_KEY]) {
         }, "value")
       },
       /**
-       * Gets total size of all sessionStorage items.
-       * @returns Total size in characters.
+       * Calculates total size of all memorio session items in kilobytes.
+       * Counts each prefixed key and its JSON-serialized value, summing their
+       * byte lengths and converting to whole kilobytes (Math.ceil).
+       * @returns Total size in kilobytes (0 when empty / no memorio items).
        */
       size: {
         value: /* @__PURE__ */ __name(() => {
-          let totalSize = 0;
+          let totalBytes = 0;
           if (_hasStorage2) {
-            Object.keys(_sessionStorage).forEach(
-              (key) => {
-                if (key.startsWith(_getPrefix2())) {
-                  const item = _sessionStorage.getItem(key);
-                  if (item) totalSize += item.length;
-                }
+            for (let i = 0; i < _sessionStorage.length; i++) {
+              const key = _sessionStorage.key(i);
+              if (key && key.startsWith(_getPrefix2())) {
+                const item = _sessionStorage.getItem(key);
+                if (item) totalBytes += key.length + item.length;
               }
-            );
+            }
           } else {
-            _getFallbackStorage2().forEach((value) => {
-              totalSize += value.length;
+            _getFallbackStorage2().forEach((value, key) => {
+              totalBytes += key.length + value.length;
             });
           }
-          return totalSize;
+          return totalBytes === 0 ? 0 : Math.ceil(totalBytes / 1024);
         }, "value")
       },
       /**
@@ -2524,6 +2551,7 @@ var useObserver = /* @__PURE__ */ __name(((func, deps = []) => {
     };
   }
   const handlers = [];
+  const unsubs = [];
   const depList = Array.isArray(deps) && !deps.__path ? deps : [deps];
   try {
     depList.forEach((dep) => {
@@ -2537,8 +2565,11 @@ var useObserver = /* @__PURE__ */ __name(((func, deps = []) => {
       if (t) {
         t = t.replace(/^(\(\)\s*=>\s*)/, "").replace(/^globalThis\./, "").replace(/^state\./, "");
         const path = t.startsWith("store.") || t.startsWith("state.") ? t : "state." + t;
-        dispatch.listen(path, () => func());
-        handlers.push(path);
+        if (!handlers.includes(path)) {
+          handlers.push(path);
+          const off = dispatch.listen(path, () => func());
+          if (typeof off === "function") unsubs.push({ path, off });
+        }
       } else {
         exports.internal.clearTrackedPaths();
         exports.internal.tracking = true;
@@ -2550,8 +2581,9 @@ var useObserver = /* @__PURE__ */ __name(((func, deps = []) => {
         exports.internal.trackedPaths.forEach((path) => {
           if (!handlers.includes(path)) {
             message_default(`useObserver: [Auto-Discovery] -> "${path}"`);
-            dispatch.listen(path, () => func());
             handlers.push(path);
+            const off = dispatch.listen(path, () => func());
+            if (typeof off === "function") unsubs.push({ path, off });
           }
         });
       }
@@ -2562,11 +2594,9 @@ var useObserver = /* @__PURE__ */ __name(((func, deps = []) => {
       console.warn(`useObserver: No paths resolved for monitoring. Check your dependencies!`);
     }
     return () => {
-      handlers.forEach((path) => {
-        if (typeof dispatch.remove === "function") {
-          dispatch.remove(path);
-          message_default(`useObserver: Stopped monitoring "${path}"`);
-        }
+      unsubs.forEach(({ path, off }) => {
+        off();
+        message_default(`useObserver: Stopped monitoring "${path}"`);
       });
     };
   } catch (err) {
@@ -3273,7 +3303,7 @@ init_internal();
 
 // package.json
 var package_default = {
-  version: "4.9.10"};
+  version: "4.9.31"};
 
 // core/global.ts
 init_env();

package/index.js

@@ -642,24 +642,29 @@ var init_store = __esm({
             }, "value")
           },
           /**
-           * Calculates total size of all memorio items (characters).
+           * Calculates total size of all memorio items in kilobytes.
+           * Counts each prefixed key and its JSON-serialized value, summing their
+           * byte lengths and converting to whole kilobytes (Math.ceil). Replaces
+           * the previous character-only total which did not express real usage.
+           * @returns Total size in kilobytes (0 when empty / no memorio items).
            */
           size: {
             value: /* @__PURE__ */ __name(() => {
-              let totalSize = 0;
+              let totalBytes = 0;
               if (_hasStorage) {
-                Object.keys(_localStorage).forEach((key) => {
-                  if (key.startsWith(_getPrefix())) {
+                for (let i = 0; i < _localStorage.length; i++) {
+                  const key = _localStorage.key(i);
+                  if (key && key.startsWith(_getPrefix())) {
                     const item = _localStorage.getItem(key);
-                    if (item) totalSize += item.length;
+                    if (item) totalBytes += key.length + item.length;
                   }
-                });
+                }
               } else {
-                _getFallbackStorage().forEach((value) => {
-                  totalSize += value.length;
+                _getFallbackStorage().forEach((value, key) => {
+                  totalBytes += key.length + value.length;
                 });
               }
-              return totalSize;
+              return totalBytes === 0 ? 0 : Math.ceil(totalBytes / 1024);
             }, "value")
           },
           /**
@@ -1730,30 +1735,51 @@ var dispatch = {
   }, "set"),
   ///
   /**
-   * Listens for the specified event names and executes the callback when the event is triggered.
+   * Subscribes a callback to an event name. Maintains a *list* of handlers per
+   * name, so multiple subscribers on the same path (e.g. several
+   * `useObserver` calls observing `state.report`) each keep firing and each
+   * get an independent unsubscribe. The previous single-slot-per-name
+   * behaviour silently dropped the second subscriber and let any unsubscribe
+   * cancel every other subscriber on that path.
    * @param name The name of the event to listen for.
    * @param cb The callback function to execute when the event is triggered.
+   * @returns An unsubscribe function for this subscriber, or void if no callback.
    */
   listen: /* @__PURE__ */ __name((name, cb = null, _flag) => {
-    if (globalThis.events?.[name]) return;
-    const exec = cb ? (e) => {
+    if (!cb) return;
+    const wrapped = /* @__PURE__ */ __name((e) => {
       const target = e;
-      return globalThis.queueMicrotask ? globalThis.queueMicrotask(() => cb(target)) : Promise.resolve().then(() => cb(target));
-    } : void 0;
-    if (exec) globalThis.addEventListener(name, exec);
-    if (exec) globalThis.events[name] = exec;
+      if (globalThis.queueMicrotask) {
+        globalThis.queueMicrotask(() => cb(target));
+      } else {
+        Promise.resolve().then(() => cb(target));
+      }
+    }, "wrapped");
+    globalThis.addEventListener(name, wrapped);
+    const list = globalThis.events[name] = globalThis.events[name] ?? [];
+    list.push(wrapped);
+    return () => {
+      globalThis.removeEventListener(name, wrapped);
+      const idx = list.indexOf(wrapped);
+      if (idx > -1) list.splice(idx, 1);
+      if (!list.length) delete globalThis.events[name];
+    };
   }, "listen"),
   ///
   /**
-   * Removes the event listener for the specified event names.
-   * @param name The name of the event to remove the listener for.
+   * Removes ALL handlers for the specified event name (imperative bulk
+   * removal). For per-subscriber teardown, use the unsubscribe function
+   * returned by `listen`.
+   * @param name The name of the event to remove the listeners for.
    */
   remove: /* @__PURE__ */ __name((name) => {
-    const listener = globalThis.events?.[name];
-    if (listener) {
-      globalThis.removeEventListener(name, listener);
-      delete globalThis.events[name];
+    const entry = globalThis.events?.[name];
+    if (Array.isArray(entry)) {
+      entry.forEach((h) => globalThis.removeEventListener(name, h));
+    } else if (typeof entry === "function") {
+      globalThis.removeEventListener(name, entry);
     }
+    delete globalThis.events[name];
   }, "remove")
 };
 
@@ -2282,27 +2308,28 @@ if (globalThis[SESSION_INSTANCE_KEY]) {
         }, "value")
       },
       /**
-       * Gets total size of all sessionStorage items.
-       * @returns Total size in characters.
+       * Calculates total size of all memorio session items in kilobytes.
+       * Counts each prefixed key and its JSON-serialized value, summing their
+       * byte lengths and converting to whole kilobytes (Math.ceil).
+       * @returns Total size in kilobytes (0 when empty / no memorio items).
        */
       size: {
         value: /* @__PURE__ */ __name(() => {
-          let totalSize = 0;
+          let totalBytes = 0;
           if (_hasStorage2) {
-            Object.keys(_sessionStorage).forEach(
-              (key) => {
-                if (key.startsWith(_getPrefix2())) {
-                  const item = _sessionStorage.getItem(key);
-                  if (item) totalSize += item.length;
-                }
+            for (let i = 0; i < _sessionStorage.length; i++) {
+              const key = _sessionStorage.key(i);
+              if (key && key.startsWith(_getPrefix2())) {
+                const item = _sessionStorage.getItem(key);
+                if (item) totalBytes += key.length + item.length;
               }
-            );
+            }
           } else {
-            _getFallbackStorage2().forEach((value) => {
-              totalSize += value.length;
+            _getFallbackStorage2().forEach((value, key) => {
+              totalBytes += key.length + value.length;
             });
           }
-          return totalSize;
+          return totalBytes === 0 ? 0 : Math.ceil(totalBytes / 1024);
         }, "value")
       },
       /**
@@ -2521,6 +2548,7 @@ var useObserver = /* @__PURE__ */ __name(((func, deps = []) => {
     };
   }
   const handlers = [];
+  const unsubs = [];
   const depList = Array.isArray(deps) && !deps.__path ? deps : [deps];
   try {
     depList.forEach((dep) => {
@@ -2534,8 +2562,11 @@ var useObserver = /* @__PURE__ */ __name(((func, deps = []) => {
       if (t) {
         t = t.replace(/^(\(\)\s*=>\s*)/, "").replace(/^globalThis\./, "").replace(/^state\./, "");
         const path2 = t.startsWith("store.") || t.startsWith("state.") ? t : "state." + t;
-        dispatch.listen(path2, () => func());
-        handlers.push(path2);
+        if (!handlers.includes(path2)) {
+          handlers.push(path2);
+          const off = dispatch.listen(path2, () => func());
+          if (typeof off === "function") unsubs.push({ path: path2, off });
+        }
       } else {
         internal_default.clearTrackedPaths();
         internal_default.tracking = true;
@@ -2547,8 +2578,9 @@ var useObserver = /* @__PURE__ */ __name(((func, deps = []) => {
         internal_default.trackedPaths.forEach((path2) => {
           if (!handlers.includes(path2)) {
             message_default(`useObserver: [Auto-Discovery] -> "${path2}"`);
-            dispatch.listen(path2, () => func());
             handlers.push(path2);
+            const off = dispatch.listen(path2, () => func());
+            if (typeof off === "function") unsubs.push({ path: path2, off });
           }
         });
       }
@@ -2559,11 +2591,9 @@ var useObserver = /* @__PURE__ */ __name(((func, deps = []) => {
       console.warn(`useObserver: No paths resolved for monitoring. Check your dependencies!`);
     }
     return () => {
-      handlers.forEach((path2) => {
-        if (typeof dispatch.remove === "function") {
-          dispatch.remove(path2);
-          message_default(`useObserver: Stopped monitoring "${path2}"`);
-        }
+      unsubs.forEach(({ path: path2, off }) => {
+        off();
+        message_default(`useObserver: Stopped monitoring "${path2}"`);
       });
     };
   } catch (err) {
@@ -3270,7 +3300,7 @@ init_internal();
 
 // package.json
 var package_default = {
-  version: "4.9.10"};
+  version: "4.9.31"};
 
 // core/global.ts
 init_env();

package/llms.txt

@@ -100,7 +100,7 @@ store.removeAll()
 store.clearAll()  // alias
 
 // Check size
-console.debug(store.size(), 'chars stored')
+console.debug(store.size(), 'kilobytes')
 
 // Check if persistent (real localStorage vs memory fallback)
 console.debug(store.isPersistent)  // true → real localStorage
@@ -134,7 +134,7 @@ session.removeAll()
 session.clearAll()  // alias
 
 // Check size
-console.debug(session.size(), 'chars stored')
+console.debug(session.size(), 'kilobytes')
 
 // Check if persistent
 console.debug(session.isPersistent)
@@ -466,15 +466,23 @@ MIT © Dario Passariello (BigLogic Inc Canada)
 
 Internal event system used by state changes; also usable directly for custom events.
 
+Listeners are stored as a *list* per event name, so multiple subscribers on the
+same name each keep firing. `dispatch.listen` returns an unsubscribe function
+for that specific subscriber - call it to remove only that one listener without
+affecting others registered under the same name.
+
 ```javascript
 // Dispatch a custom event
 memorio.dispatch.set('custom:event', { detail: { data: 'value' } })
 
-// Listen for an event
-memorio.dispatch.listen('custom:event', (e) => {
+// Listen for an event (returns an unsubscribe function)
+const off = memorio.dispatch.listen('custom:event', (e) => {
   console.debug('Event triggered:', e.detail)
 })
 
-// Remove listener
+// Remove only this listener via the returned unsubscribe
+off()
+
+// Remove *all* listeners for a name (imperative bulk removal)
 memorio.dispatch.remove('custom:event')
 ```