memorio 3.0.2 → 4.1.0

package/index.cjs

@@ -1,3 +1,5 @@
+"use strict";
+
 var e = Object.getOwnPropertyNames, t = (t, o) => function() {
     return t && (o = (0, t[e(t)[0]])(t = 0)), o;
 }, o = {}, r = t({
@@ -6,13 +8,15 @@ var e = Object.getOwnPropertyNames, t = (t, o) => function() {
             if (!idb.db.support()) return r(new Error("IndexedDB not supported"));
             const s = globalThis.indexedDB.open(e, t);
             s.onerror = () => {
-                r(s.error);
+                memorio.message(`IndexedDB error: ${s.error?.message}`), r(s.error);
             }, s.onsuccess = () => {
-                idb.db.list(), o(s.result);
-            }, s.onupgradeneeded = () => {};
+                memorio.message(`Database ${e} connected successfully`), o(s.result);
+            }, s.onupgradeneeded = () => {
+                memorio.message(`Database ${e} upgrade/creation initiated`);
+            };
         });
     }
-}), s = {}, n = t({
+}), s = {}, i = t({
     "functions/idb/tools/db.list.ts"() {
         idb.db.list = async () => {
             if (!("indexedDB" in globalThis) || !indexedDB.databases) return [];
@@ -20,32 +24,35 @@ var e = Object.getOwnPropertyNames, t = (t, o) => function() {
                 const e = await indexedDB.databases();
                 return globalThis.idbases = e || [], await idb.db.size(), globalThis.idbases;
             } catch (e) {
-                return [];
+                return console.error("Error listing databases:", e), [];
             }
-        }, idb.db.list();
+        };
     }
-}), i = {}, l = t({
+}), n = {}, a = t({
     "functions/idb/tools/db.exist.ts"() {
         idb.db.exist = e => idbases?.some(t => t.name === e);
     }
-}), a = {}, c = t({
+}), l = {}, c = t({
     "functions/idb/tools/db.quota.ts"() {
         idb.db.quota = () => navigator.storage.estimate();
     }
-}), b = {}, u = t({
+}), m = {}, b = t({
     "functions/idb/tools/db.delete.ts"() {
         idb.db.delete = e => new Promise((t, o) => {
+            memorio.message(`Removing database ${e}...`);
             (() => {
                 const r = indexedDB.deleteDatabase(e);
                 r.onsuccess = () => {
-                    idb.db.list(), t();
+                    memorio.message(`${e} database removed successfully`), idb.db.list(), t();
                 }, r.onerror = () => {
-                    o(r.error);
-                }, r.onblocked = () => {};
+                    console.error(`Error removing ${e}:`, r.error), o(r.error);
+                }, r.onblocked = () => {
+                    console.warn(`Deletion of ${e} is blocked. Please close other tabs.`);
+                };
             })();
         });
     }
-}), d = {}, f = t({
+}), u = {}, d = t({
     "functions/idb/tools/db.size.ts"() {
         idb.db.size = async () => {
             if (idbases && 0 !== idbases.length) for (let e = 0; e < idbases.length; e++) {
@@ -57,11 +64,13 @@ var e = Object.getOwnPropertyNames, t = (t, o) => function() {
                         r += await idb.table.size(e, t);
                     }
                     t.size = r, e.close();
-                } catch (e) {}
+                } catch (e) {
+                    memorio.message(`Could not calculate size for ${t.name}:${e}`);
+                }
             }
         };
     }
-}), m = {}, g = t({
+}), g = {}, f = t({
     "functions/idb/tools/db.version.ts"() {
         idb.db.version = e => {
             let t = 0;
@@ -76,125 +85,127 @@ var e = Object.getOwnPropertyNames, t = (t, o) => function() {
     "functions/idb/tools/db.support.ts"() {
         idb.db.support = () => {
             const e = "indexedDB" in globalThis;
-            return e;
+            return e || memorio.message("Your environment doesn't support IndexedDB"), e;
         };
     }
 }), v = {}, y = t({
     "functions/idb/tools/table.create.ts"() {
         idb.table.create = (e, t) => new Promise(async (o, r) => {
             try {
-                const s = (Number(idb.db.version(e)) || 0) + 1, n = indexedDB.open(e, s);
-                n.onupgradeneeded = e => {
-                    const o = e.target.result;
-                    if (!o.objectStoreNames.contains(t)) {
-                        const e = o.createObjectStore(t, {
+                const s = (Number(idb.db.version(e)) || 0) + 1, i = indexedDB.open(e, s);
+                i.onupgradeneeded = o => {
+                    const r = o.target.result;
+                    if (!r.objectStoreNames.contains(t)) {
+                        const o = r.createObjectStore(t, {
                             keyPath: "id",
                             autoIncrement: !0
                         });
-                        e.createIndex("id", "id", {
+                        o.createIndex("id", "id", {
                             unique: !0
-                        }), e.createIndex("data", "data", {
+                        }), o.createIndex("data", "data", {
                             unique: !1
-                        });
+                        }), memorio.message(`Table ${t} created in ${e}`);
                     }
-                }, n.onsuccess = () => {
-                    n.result.close(), idb.db.list(), o();
-                }, n.onerror = () => {
-                    r(n.error);
+                }, i.onsuccess = () => {
+                    i.result.close(), idb.db.list(), o();
+                }, i.onerror = () => {
+                    console.error(`Error creating table ${t}:`, i.error), r(i.error);
                 };
             } catch (e) {
-                r(e);
+                console.error("Critical error in table.create:", e), r(e);
             }
         });
     }
-}), T = {}, j = t({
+}), T = {}, O = t({
     "functions/idb/tools/table.size.ts"() {
         idb.table.size = (e, t) => new Promise((o, r) => {
             if (!e) return r(new Error("Database instance is required"));
             if (!e.objectStoreNames.contains(t)) return o(0);
-            let s = 0, n = 0;
-            const i = e.transaction([ t ], "readonly").objectStore(t).openCursor();
-            i.onsuccess = async e => {
+            let s = 0, i = 0;
+            const n = e.transaction([ t ], "readonly").objectStore(t).openCursor();
+            n.onsuccess = async e => {
                 const t = e.target.result;
                 if (t) {
                     try {
                         const e = t.value;
                         s += JSON.stringify(e).length;
-                    } catch (e) {}
-                    n++, n % 200 == 0 && await new Promise(e => setTimeout(e, 0)), t.continue();
+                    } catch (e) {
+                        memorio.message(`Error stringifying IDB value tracking size:${e}`);
+                    }
+                    i++, i % 200 == 0 && await new Promise(e => setTimeout(e, 0)), t.continue();
                 } else o(s);
-            }, i.onerror = () => {
-                r(i.error);
+            }, n.onerror = () => {
+                r(n.error);
             };
         });
     }
-}), P = {}, O = t({
+}), j = {}, w = t({
     "functions/idb/crud/data.delete.ts"() {
         idb.data.delete = (e, t, o) => new Promise((r, s) => {
-            const n = indexedDB.open(e);
-            n.onsuccess = () => {
-                const e = n.result;
+            const i = indexedDB.open(e);
+            i.onsuccess = () => {
+                const e = i.result;
                 if (!e.objectStoreNames.contains(t)) return e.close(), s(new Error(`Table ${t} not found`));
-                const i = e.transaction(t, "readwrite").objectStore(t).delete(o);
-                i.onsuccess = () => {
-                    e.close(), r();
-                }, i.onerror = () => {
-                    e.close(), s(i.error);
+                const n = e.transaction(t, "readwrite").objectStore(t).delete(o);
+                n.onsuccess = () => {
+                    e.close(), memorio.message(`Record ${o} deleted from ${t}`), r();
+                }, n.onerror = () => {
+                    e.close(), s(n.error);
                 };
-            }, n.onerror = () => s(n.error);
+            }, i.onerror = () => s(i.error);
         }), idb.data.delete.all = (e, t) => new Promise((o, r) => {
             const s = indexedDB.open(e);
             s.onsuccess = e => {
                 const s = e.target.result;
                 if (!s.objectStoreNames.contains(t)) return s.close(), r(new Error(`Table ${t} not found`));
-                const n = s.transaction(t, "readwrite").objectStore(t).clear();
-                n.onsuccess = () => {
-                    s.close(), o();
-                }, n.onerror = () => {
-                    s.close(), r(n.error);
+                const i = s.transaction(t, "readwrite").objectStore(t).clear();
+                i.onsuccess = () => {
+                    s.close(), memorio.message(`All data cleared from ${t}`), o();
+                }, i.onerror = () => {
+                    s.close(), r(i.error);
                 };
             }, s.onerror = () => r(s.error);
         });
     }
-}), w = {}, S = t({
+}), S = {}, P = t({
     "functions/idb/crud/data.set.ts"() {
         idb.data.set = (e, t, o) => new Promise((r, s) => {
-            const n = indexedDB.open(e);
-            n.onsuccess = () => {
-                const i = n.result;
-                if (!i.objectStoreNames.contains(t)) return i.close(), s(new Error(`Table ${t} does not exist in ${e}`));
-                const l = i.transaction(t, "readwrite").objectStore(t).put(o);
-                l.onsuccess = () => {
-                    i.close(), r(l.result);
-                }, l.onerror = e => {
-                    i.close(), s(l.error);
+            const i = indexedDB.open(e);
+            i.onsuccess = () => {
+                const n = i.result;
+                if (!n.objectStoreNames.contains(t)) return n.close(), s(new Error(`Table ${t} does not exist in ${e}`));
+                const a = n.transaction(t, "readwrite").objectStore(t).put(o);
+                a.onsuccess = () => {
+                    n.close(), memorio.message(`Data saved in ${e}.${t}`), r(a.result);
+                }, a.onerror = e => {
+                    n.close(), memorio.message(`Database insert error: ${a.error?.message}`), s(a.error);
                 };
-            }, n.onerror = () => {
-                s(n.error);
+            }, i.onerror = () => {
+                s(i.error);
             };
         });
     }
-}), _ = {}, k = t({
+}), E = {}, $ = t({
     "functions/idb/crud/data.get.ts"() {
         idb.data.get = (e, t, o) => new Promise((r, s) => {
-            const n = indexedDB.open(e);
-            n.onsuccess = n => {
-                const i = n.target.result;
-                if (!i.objectStoreNames.contains(t)) return i.close(), s(new Error(`Table ${t} not found in ${e}`));
-                const l = i.transaction(t, "readonly").objectStore(t).get(o);
-                l.onsuccess = () => {
-                    i.close(), r(l.result);
-                }, l.onerror = () => {
-                    i.close(), s(l.error);
+            const i = indexedDB.open(e);
+            i.onsuccess = i => {
+                const n = i.target.result;
+                if (!n.objectStoreNames.contains(t)) return n.close(), s(new Error(`Table ${t} not found in ${e}`));
+                const a = n.transaction(t, "readonly").objectStore(t).get(o);
+                a.onsuccess = () => {
+                    n.close(), r(a.result);
+                }, a.onerror = () => {
+                    n.close(), s(a.error);
                 };
-            }, n.onerror = () => {
-                s(n.error);
+            }, i.onerror = () => {
+                s(i.error);
             };
         });
     }
 });
 
-function E() {
+function k() {
     const e = globalThis;
     if (void 0 !== e.crypto && e.crypto.randomUUID) return e.crypto.randomUUID();
     if (void 0 !== e.crypto && e.crypto.getRandomValues) {
@@ -204,12 +215,12 @@ function E() {
     return `session_${Date.now()}_${Math.random().toString(36).substring(2, 15)}`;
 }
 
-function x() {
+function _() {
     const e = globalThis;
     return e.Deno && e.Deno.version ? "deno" : "undefined" != typeof process && process.versions && process.versions.node ? "node" : "undefined" != typeof globalThis && void 0 !== globalThis.ServiceWorkerGlobalScope ? "edge" : "undefined" != typeof window && "undefined" != typeof document ? "browser" : "unknown";
 }
 
-function N() {
+function D() {
     try {
         if ("undefined" != typeof sessionStorage) {
             const e = "__memorio_test__";
@@ -219,7 +230,7 @@ function N() {
     return null;
 }
 
-function I() {
+function x() {
     try {
         if ("undefined" != typeof localStorage) {
             const e = "__memorio_test__";
@@ -229,37 +240,37 @@ function I() {
     return null;
 }
 
-function D() {
+function I() {
     return "undefined" != typeof indexedDB;
 }
 
-function A() {
-    const e = x(), t = void 0 !== globalThis.isSecureContext ? globalThis.isSecureContext : "browser" === e;
+function N() {
+    const e = _(), t = void 0 !== globalThis.isSecureContext ? globalThis.isSecureContext : "browser" === e;
     return {
         platform: e,
-        hasSessionStorage: null !== N(),
-        hasLocalStorage: null !== I(),
-        hasIndexedDB: D(),
+        hasSessionStorage: null !== D(),
+        hasLocalStorage: null !== x(),
+        hasIndexedDB: I(),
         hasDispatchEvent: "function" == typeof globalThis.dispatchEvent,
         hasNavigator: "undefined" != typeof navigator,
         hasProcess: "undefined" != typeof process,
         isSecureContext: t,
-        sessionId: E()
+        sessionId: k()
     };
 }
 
-var z = new Map;
+var A = new Map;
 
-var J = new Map;
+var z = new Map;
 
-function B(e) {
-    const t = e || `context_${E()}`, o = {
+function J(e) {
+    const t = e || `context_${k()}`, o = {
         state: {},
         store: new Map,
         session: new Map,
         cache: new Map
     };
-    return J.set(t, o), {
+    return z.set(t, o), {
         id: t,
         state: o.state,
         store: {
@@ -312,13 +323,17 @@ Object.defineProperty(globalThis, "memorio", {
 }), Object.defineProperty(memorio, "version", {
     writable: !1,
     enumerable: !1,
-    value: "3.0.2"
+    value: "4.1.0"
+}), Object.defineProperty(memorio, "debug", {
+    writable: !0,
+    enumerable: !1,
+    value: !1
 });
 
-var C = [ "list", "state", "store", "idb", "observer", "useObserver", "remove", "removeAll", "_platform", "_capabilities", "_sessionId" ];
+var B = [ "list", "state", "store", "idb", "observer", "useObserver", "remove", "removeAll", "_platform", "_capabilities", "_sessionId" ];
 
 !function() {
-    const e = A(), t = globalThis;
+    const e = N(), t = globalThis;
     void 0 !== t.memorio && (t.memorio._platform = e.platform, t.memorio._capabilities = e), 
     e.hasDispatchEvent || (t.dispatchEvent = function(e) {
         return !0;
@@ -329,43 +344,45 @@ var C = [ "list", "state", "store", "idb", "observer", "useObserver", "remove",
             this.type = e, this.detail = t;
         }
     })), "function" != typeof t.addEventListener && (t.addEventListener = function(e, t) {
-        z.has(e) || z.set(e, []), z.get(e).push(t);
+        A.has(e) || A.set(e, []), A.get(e).push(t);
     }, t.removeEventListener = function(e, t) {
-        const o = z.get(e);
+        const o = A.get(e);
         if (o) {
             const e = o.indexOf(t);
             e > -1 && o.splice(e, 1);
         }
     }, t.dispatchEvent = function(e) {
-        const t = z.get(e.type);
+        const t = A.get(e.type);
         return t && t.forEach(t => {
             try {
                 t(e);
-            } catch (e) {}
+            } catch (e) {
+                console.error("Event listener error:", e);
+            }
         }), !0;
     });
 }();
 
-var $ = A();
+var C = N();
 
 Object.defineProperty(memorio, "_sessionId", {
     writable: !1,
     enumerable: !1,
-    value: $.sessionId
-}), memorio.createContext = B, memorio.listContexts = function() {
-    return Array.from(J.keys());
+    value: C.sessionId
+}), memorio.createContext = J, memorio.listContexts = function() {
+    return Array.from(z.keys());
 }, memorio.deleteContext = function(e) {
-    return J.delete(e);
+    return z.delete(e);
 }, memorio.isBrowser = function() {
-    return "browser" === x();
+    return "browser" === _();
 }, memorio.isNode = function() {
-    return "node" === x();
+    return "node" === _();
 }, memorio.isDeno = function() {
-    return "deno" === x();
+    return "deno" === _();
 }, memorio.isEdge = function() {
-    return "edge" === x();
-}, memorio.getCapabilities = A, memorio.isolate = function(e) {
-    return B(e);
+    return "edge" === _();
+}, memorio.getCapabilities = N, memorio.isolate = function(e) {
+    return J(e);
 }, Object.defineProperty(memorio, "dispatch", {
     writable: !1,
     enumerable: !1,
@@ -383,7 +400,9 @@ Object.defineProperty(memorio, "_sessionId", {
             t && (globalThis.removeEventListener(e, t), delete globalThis.events[e]);
         }
     }
-}), memorio.propertyName = (e, t) => String(t).replace("() => ", ""), Object.defineProperty(memorio, "objPath", {
+}), memorio.propertyName = (e, t) => String(t).replace("() => ", ""), memorio.message = (...e) => {
+    !0 === memorio.debug && console.debug(...e);
+}, Object.defineProperty(memorio, "objPath", {
     writable: !1,
     enumerable: !1,
     value: (e, t, o = ".") => {
@@ -394,10 +413,11 @@ Object.defineProperty(memorio, "_sessionId", {
 }), globalThis.memorio._tracking = !1, globalThis.memorio._trackedPaths = new Set, 
 globalThis.memorio._locked = !1;
 
-var R = (e, t, o = []) => new Proxy(e, {
+var M = (e, t, o = []) => new Proxy(e, {
     get(e, r) {
         if ("__path" === r) return o.length > 0 ? "state." + o.join(".") : "state";
-        if ("list" === r) return JSON.parse(JSON.stringify(globalThis.state));
+        if ("list" === r) return memorio.message('Some state could be hidden when you use "state.list". Use "state" to see the complete list '), 
+        JSON.parse(JSON.stringify(globalThis.state));
         if (globalThis.memorio._tracking && "string" == typeof r) {
             const e = o.length > 0 ? "state." + o.concat(r).join(".") : "state." + r;
             globalThis.memorio._trackedPaths?.add(e);
@@ -406,7 +426,9 @@ var R = (e, t, o = []) => new Proxy(e, {
         if ("removeAll" === r) return () => {
             try {
                 for (const t in e) "function" == typeof e[t] || [ "list", "remove", "removeAll", "lock", "unlock" ].includes(t) || delete e[t];
-            } catch (e) {}
+            } catch (e) {
+                console.error(e);
+            }
         };
         if (Object.isFrozen(e[r])) return e[r];
         if ("lock" === r || "unlock" === r) {
@@ -415,21 +437,24 @@ var R = (e, t, o = []) => new Proxy(e, {
         }
         try {
             const s = Reflect.get(e, r);
-            return s && "object" == typeof s && [ "Array", "Object" ].includes(s.constructor.name) ? R(s, t, o.concat(r)) : s;
+            return s && "object" == typeof s && [ "Array", "Object" ].includes(s.constructor.name) ? M(s, t, o.concat(r)) : s;
         } catch (e) {
-            return;
+            return void console.error("Error: ", e);
         }
     },
     set(e, r, s) {
-        if (globalThis.memorio._locked) return !1;
-        if (C.includes(r)) return !1;
-        if (e[r] && "object" == typeof e[r] && Object.isFrozen(e[r])) return !1;
-        if (e[r] && "object" == typeof e[r] && e[r].__locked) return !1;
+        if (globalThis.memorio._locked) return console.error("Error: state is locked. Use state.unlock() to enable modifications."), 
+        !1;
+        if (B.includes(r)) return console.error("key " + r + " is protected"), !1;
+        if (e[r] && "object" == typeof e[r] && Object.isFrozen(e[r])) return console.error(`Error: state '${r}' is locked`), 
+        !1;
+        if (e[r] && "object" == typeof e[r] && e[r].__locked) return console.error(`Error: state '${r}' is locked. Use state.${r}.unlock() to enable modifications.`), 
+        !1;
         try {
-            const n = globalThis.memorio.objPath?.(r, o) ?? r;
+            const i = globalThis.memorio.objPath?.(r, o) ?? r;
             if (t({
                 action: "set",
-                path: n,
+                path: i,
                 target: e,
                 newValue: s,
                 previousValue: Reflect.get(e, r)
@@ -441,7 +466,7 @@ var R = (e, t, o = []) => new Proxy(e, {
                         }
                     });
                 } catch (e) {}
-            })("state." + n), Reflect.set(e, r, s), e[r] && "object" == typeof e[r]) {
+            })("state." + i), Reflect.set(e, r, s), e[r] && "object" == typeof e[r]) {
                 const t = e[r];
                 if (t && "object" == typeof t) try {
                     Object.defineProperty(t, "__locked", {
@@ -459,7 +484,7 @@ var R = (e, t, o = []) => new Proxy(e, {
                                 enumerable: !1,
                                 configurable: !1,
                                 value: !0
-                            });
+                            }), memorio.message(`State '${r}' is now locked.`);
                         }
                     }), Object.defineProperty(t, "unlock", {
                         writable: !1,
@@ -471,14 +496,14 @@ var R = (e, t, o = []) => new Proxy(e, {
                                 enumerable: !1,
                                 configurable: !1,
                                 value: !1
-                            });
+                            }), memorio.message(`State '${r}' is now unlocked.`);
                         }
                     });
                 } catch (e) {}
             }
             return !0;
         } catch (e) {
-            return !1;
+            return console.error("Error in set trap:", e), !1;
         }
     },
     deleteProperty(e, r) {
@@ -490,17 +515,17 @@ var R = (e, t, o = []) => new Proxy(e, {
                 target: e
             }), Reflect.deleteProperty(e, r);
         } catch (e) {
-            return !1;
+            return console.error("Error in deleteProperty trap:", e), !1;
         }
     },
     ownKeys: e => Reflect.ownKeys(e),
     getOwnPropertyDescriptor: (e, t) => Reflect.getOwnPropertyDescriptor(e, t)
 });
 
-globalThis?.state || (globalThis.state = R({}, () => {})), globalThis.state.lock = () => {
-    globalThis.memorio._locked = !0;
+globalThis?.state || (globalThis.state = M({}, () => {})), globalThis.state.lock = () => {
+    globalThis.memorio._locked = !0, memorio.message("State is now locked. All modifications are blocked.");
 }, globalThis.state.unlock = () => {
-    globalThis.memorio._locked = !1;
+    globalThis.memorio._locked = !1, memorio.message("State is now unlocked. Modifications are allowed.");
 }, Object.defineProperty(globalThis, "state", {
     enumerable: !1,
     configurable: !0
@@ -510,26 +535,29 @@ globalThis?.state || (globalThis.state = R({}, () => {})), globalThis.state.lock
 });
 
 globalThis.observer = (e, t = null, o = !0) => {
+    console.warn('DEPRECATED: "observer" is deprecated and will be removed in future versions. Please use "useObserver" instead.');
     try {
-        if (!(e => "state" === e.split(".")[0])(e)) return;
+        if (!(e => "state" === e.split(".")[0] || (console.error(`Observer Error: You need to declare 'state.' or 'store.'. The '${e}' string is incorrect!`), 
+        !1))(e)) return;
     } catch (e) {
-        return;
+        return void console.error(e);
     }
-    if ((e || t) && (e || !t)) {
+    if (e || t) if (e || !t) {
         if (e && !t) {
             const t = {
                 detail: {
                     name: String(e)
                 }
             }, o = globalThis.observer;
-            return o?.list?.[e] && globalThis.memorio.dispatch.remove(t), void (o?.list?.[e] || globalThis.memorio.dispatch.listen(t));
+            return o?.list?.[e] && globalThis.memorio.dispatch.remove(t), o?.list?.[e] || globalThis.memorio.dispatch.listen(t), 
+            void memorio.message(`called: ${e}`);
         }
         if (e && t) {
-            if ("string" != typeof e || "function" != typeof t) return;
+            if ("string" != typeof e || "function" != typeof t) return void console.error("Observer Error: name of state need to be a 'string' like 'state.test' and the callback need to be a 'function'");
             const r = globalThis.observer;
             return r?.list?.[e] && globalThis.memorio.dispatch.remove(e, t, o), void (r?.list?.[e] || globalThis.memorio.dispatch.listen(e, t, o));
         }
-    }
+    } else console.error("Observer Error: You need to declare what state need to be monitored as string like 'state.test'."); else console.error("Observer Error: You need to setup observer correctly, Some parameters are missed!");
 }, Object.defineProperties(globalThis.observer, {
     list: {
         get: () => globalThis.events
@@ -575,23 +603,28 @@ globalThis.observer = (e, t = null, o = !0) => {
                     e();
                 } catch (e) {}
                 globalThis.memorio._tracking = !1, globalThis.memorio._trackedPaths?.forEach(t => {
-                    o.includes(t) || (globalThis.memorio.dispatch.listen(t, () => e()), o.push(t));
+                    o.includes(t) || (memorio.message(`useObserver: [Auto-Discovery] -> "${t}"`), globalThis.memorio.dispatch.listen(t, () => e()), 
+                    o.push(t));
                 });
             }
-        }), o.length, () => {
+        }), o.length > 0 ? memorio.message(`useObserver: Monitoring ${o.length} paths.`) : console.warn("useObserver: No paths resolved for monitoring. Check your dependencies!"), 
+        () => {
             o.forEach(e => {
-                globalThis.memorio.dispatch && "function" == typeof globalThis.memorio.dispatch.remove && globalThis.memorio.dispatch.remove(e);
+                globalThis.memorio.dispatch && "function" == typeof globalThis.memorio.dispatch.remove && (globalThis.memorio.dispatch.remove(e), 
+                memorio.message(`useObserver: Stopped monitoring "${e}"`));
             });
         };
     } catch (e) {
-        return () => {};
+        return memorio.message(`useObserver Error: ${e}`), () => {};
     }
 }, Object.freeze(globalThis.useObserver);
 
-var W = I(), M = new Map, q = null !== W, L = "memorio_store_";
+var W = x(), R = new Map, U = null !== W, K = "memorio_store_";
 
-function U(e) {
-    return e && "string" == typeof e ? e.length > 512 ? "" : /^[a-zA-Z0-9_.-]+$/.test(e) ? L + e : "" : "";
+function F(e) {
+    return e && "string" == typeof e ? e.length > 512 ? (memorio.message("Key too long (max 512 characters)"), 
+    "") : /^[a-zA-Z0-9_.-]+$/.test(e) ? K + e : (memorio.message("Key contains invalid characters (only a-z, A-Z, 0-9, _, ., - allowed)"), 
+    "") : "";
 }
 
 Object.defineProperty(globalThis, "store", {
@@ -602,41 +635,47 @@ Object.defineProperty(globalThis, "store", {
     get: {
         value: e => {
             if (!e) return;
-            const t = U(e);
+            const t = F(e);
             try {
-                if (q) {
+                if (U) {
                     const e = W.getItem(t);
                     return e ? JSON.parse(e) : e;
                 }
                 {
-                    const e = M.get(t);
+                    const e = R.get(t);
                     return e ? JSON.parse(e) : e;
                 }
-            } catch (e) {}
+            } catch (t) {
+                memorio.message(`Error parsing store item '${e}': ${t}`);
+            }
             return null;
         }
     },
     set: {
         value: (e, t) => {
             if (!e) return;
-            const o = U(e);
+            const o = F(e);
             try {
-                if (q) {
-                    if (null == t) W.setItem(o, JSON.stringify(null)); else if ("object" == typeof t || "number" == typeof t || "boolean" == typeof t || "string" == typeof t) W.setItem(o, JSON.stringify(t)); else if ("function" == typeof t) return;
-                } else if (null == t) M.set(o, JSON.stringify(null)); else if ("object" == typeof t || "number" == typeof t || "boolean" == typeof t || "string" == typeof t) M.set(o, JSON.stringify(t)); else if ("function" == typeof t) return;
-            } catch (e) {}
+                if (U) {
+                    if (null == t) W.setItem(o, JSON.stringify(null)); else if ("object" == typeof t || "number" == typeof t || "boolean" == typeof t || "string" == typeof t) W.setItem(o, JSON.stringify(t)); else if ("function" == typeof t) return void memorio.message("Storing functions is not secure and is blocked for safety.");
+                } else if (null == t) R.set(o, JSON.stringify(null)); else if ("object" == typeof t || "number" == typeof t || "boolean" == typeof t || "string" == typeof t) R.set(o, JSON.stringify(t)); else if ("function" == typeof t) return void memorio.message("Storing functions is not secure and is blocked for safety.");
+            } catch (t) {
+                memorio.message(`Error setting store item '${e}': ${t}`);
+            }
             return null;
         }
     },
     remove: {
         value: e => {
             if (!e) return;
-            const t = U(e);
+            const t = F(e);
             try {
-                if (q) {
+                if (U) {
                     if (W.getItem(t)) return W.removeItem(t), !0;
-                } else if (M.has(t)) return M.delete(t), !0;
-            } catch (e) {}
+                } else if (R.has(t)) return R.delete(t), !0;
+            } catch (t) {
+                memorio.message(`Error removing store item '${e}': ${t}`);
+            }
             return !1;
         }
     },
@@ -645,14 +684,14 @@ Object.defineProperty(globalThis, "store", {
     },
     removeAll: {
         value: () => {
-            if (q) {
+            if (U) {
                 const e = [];
                 for (let t = 0; t < W.length; t++) {
                     const o = W.key(t);
-                    o?.startsWith(L) && e.push(o);
+                    o?.startsWith(K) && e.push(o);
                 }
                 e.forEach(e => W.removeItem(e));
-            } else M.clear();
+            } else R.clear();
             return !0;
         }
     },
@@ -665,25 +704,57 @@ Object.defineProperty(globalThis, "store", {
     size: {
         value: () => {
             let e = 0;
-            return q ? Object.keys(W).forEach(t => {
-                if (t.startsWith(L)) {
+            return U ? Object.keys(W).forEach(t => {
+                if (t.startsWith(K)) {
                     const o = W.getItem(t);
                     o && (e += o.length);
                 }
-            }) : M.forEach(t => {
+            }) : R.forEach(t => {
                 e += t.length;
             }), e;
         }
     },
     isPersistent: {
-        get: () => q
+        get: () => U
+    },
+    list: {
+        value: () => {
+            const e = {};
+            try {
+                if (U) for (let t = 0; t < W.length; t++) {
+                    const o = W.key(t);
+                    if (o?.startsWith(K)) {
+                        const t = o.replace(K, ""), r = W.getItem(o);
+                        if (null !== r) try {
+                            e[t] = JSON.parse(r);
+                        } catch {
+                            e[t] = r;
+                        }
+                    }
+                } else R.forEach((t, o) => {
+                    if (o.startsWith(K)) {
+                        const r = o.replace(K, "");
+                        try {
+                            e[r] = JSON.parse(t);
+                        } catch {
+                            e[r] = t;
+                        }
+                    }
+                });
+            } catch (e) {
+                memorio.message(`Error listing store items: ${e}`);
+            }
+            return e;
+        }
     }
 }), Object.freeze(store);
 
-var V = N(), F = new Map, K = null !== V, Z = "memorio_session_";
+var q = D(), L = new Map, H = null !== q, V = "memorio_session_";
 
-function G(e) {
-    return e && "string" == typeof e ? e.length > 512 ? "" : /^[a-zA-Z0-9_.-]+$/.test(e) ? Z + e : "" : "";
+function Y(e) {
+    return e && "string" == typeof e ? e.length > 512 ? (memorio.message("Key too long (max 512 characters)"), 
+    "") : /^[a-zA-Z0-9_.-]+$/.test(e) ? V + e : (memorio.message("Key contains invalid characters (only a-z, A-Z, 0-9, _, ., - allowed)"), 
+    "") : "";
 }
 
 Object.defineProperty(globalThis, "session", {
@@ -694,37 +765,43 @@ Object.defineProperty(globalThis, "session", {
     get: {
         value: e => {
             if (!e) return;
-            const t = G(e);
+            const t = Y(e);
             try {
-                if (K) {
-                    const e = V.getItem(t);
+                if (H) {
+                    const e = q.getItem(t);
                     return e ? JSON.parse(e) : e;
                 }
                 {
-                    const e = F.get(t);
+                    const e = L.get(t);
                     return e ? JSON.parse(e) : e;
                 }
-            } catch (e) {}
+            } catch (t) {
+                memorio.message(`Error parsing session item '${e}':${t}`);
+            }
         }
     },
     set: {
         value: (e, t) => {
             if (!e) return;
-            const o = G(e);
+            const o = Y(e);
             try {
-                K ? null == t ? V.setItem(o, JSON.stringify(null)) : "object" != typeof t && "number" != typeof t && "boolean" != typeof t && "string" != typeof t || V.setItem(o, JSON.stringify(t)) : null == t ? F.set(o, JSON.stringify(null)) : "object" != typeof t && "number" != typeof t && "boolean" != typeof t && "string" != typeof t || F.set(o, JSON.stringify(t));
-            } catch (e) {}
+                H ? null == t ? q.setItem(o, JSON.stringify(null)) : "object" == typeof t || "number" == typeof t || "boolean" == typeof t || "string" == typeof t ? q.setItem(o, JSON.stringify(t)) : "function" == typeof t && memorio.message("It's not secure to session functions.") : null == t ? L.set(o, JSON.stringify(null)) : "object" == typeof t || "number" == typeof t || "boolean" == typeof t || "string" == typeof t ? L.set(o, JSON.stringify(t)) : "function" == typeof t && memorio.message("It's not secure to session functions.");
+            } catch (t) {
+                memorio.message(`Error setting session item '${e}': ${t}`);
+            }
         }
     },
     remove: {
         value: e => {
             if (!e) return;
-            const t = G(e);
+            const t = Y(e);
             try {
-                if (K) {
-                    if (V.getItem(t)) return V.removeItem(t), !0;
-                } else if (F.has(t)) return F.delete(t), !0;
-            } catch (e) {}
+                if (H) {
+                    if (q.getItem(t)) return q.removeItem(t), !0;
+                } else if (L.has(t)) return L.delete(t), !0;
+            } catch (t) {
+                memorio.message(`Error removing session item '${e}': ${t}`);
+            }
         }
     },
     delete: {
@@ -732,14 +809,14 @@ Object.defineProperty(globalThis, "session", {
     },
     removeAll: {
         value: () => {
-            if (K) {
+            if (H) {
                 const e = [];
-                for (let t = 0; t < V.length; t++) {
-                    const o = V.key(t);
-                    o?.startsWith(Z) && e.push(o);
+                for (let t = 0; t < q.length; t++) {
+                    const o = q.key(t);
+                    o?.startsWith(V) && e.push(o);
                 }
-                e.forEach(e => V.removeItem(e));
-            } else F.clear();
+                e.forEach(e => q.removeItem(e));
+            } else L.clear();
             return !0;
         }
     },
@@ -752,35 +829,67 @@ Object.defineProperty(globalThis, "session", {
     size: {
         value: () => {
             let e = 0;
-            return K ? Object.keys(V).forEach(t => {
-                if (t.startsWith(Z)) {
-                    const o = V.getItem(t);
+            return H ? Object.keys(q).forEach(t => {
+                if (t.startsWith(V)) {
+                    const o = q.getItem(t);
                     o && (e += o.length);
                 }
-            }) : F.forEach(t => {
+            }) : L.forEach(t => {
                 e += t.length;
             }), e;
         }
     },
     isPersistent: {
-        get: () => K
+        get: () => H
+    },
+    list: {
+        value: () => {
+            const e = {};
+            try {
+                if (H) for (let t = 0; t < q.length; t++) {
+                    const o = q.key(t);
+                    if (o?.startsWith(V)) {
+                        const t = o.replace(V, ""), r = q.getItem(o);
+                        if (null !== r) try {
+                            e[t] = JSON.parse(r);
+                        } catch {
+                            e[t] = r;
+                        }
+                    }
+                } else L.forEach((t, o) => {
+                    if (o.startsWith(V)) {
+                        const r = o.replace(V, "");
+                        try {
+                            e[r] = JSON.parse(t);
+                        } catch {
+                            e[r] = t;
+                        }
+                    }
+                });
+            } catch (e) {
+                memorio.message(`Error listing session items: ${e}`);
+            }
+            return e;
+        }
     }
 }), Object.freeze(session);
 
-var H = {};
+var Z = {};
 
 Object.defineProperty(globalThis, "cache", {
     value: new Proxy({}, {
-        get: (e, t) => "get" === t ? e => H[e] : "set" === t ? (e, t) => {
-            H[e] = t;
-        } : "remove" === t ? e => (delete H[e], !0) : "removeAll" === t || "clear" === t ? () => (Object.keys(H).forEach(e => delete H[e]), 
-        !0) : H[t],
-        set: (e, t, o) => (H[t] = o, !0),
-        deleteProperty: (e, t) => (delete H[t], !0)
+        get: (e, t) => "get" === t ? e => Z[e] : "set" === t ? (e, t) => {
+            Z[e] = t;
+        } : "remove" === t ? e => (delete Z[e], !0) : "removeAll" === t || "clear" === t ? () => (Object.keys(Z).forEach(e => delete Z[e]), 
+        !0) : "list" === t ? () => ({
+            ...Z
+        }) : Z[t],
+        set: (e, t, o) => (Z[t] = o, !0),
+        deleteProperty: (e, t) => (delete Z[t], !0)
     }),
     enumerable: !1,
     configurable: !0
-}), Object.freeze(cache), D() ? (async () => {
+}), Object.freeze(cache), I() ? (async () => {
     Object.defineProperty(globalThis, "idb", {
         value: {
             db: {},
@@ -795,13 +904,13 @@ Object.defineProperty(globalThis, "cache", {
         writable: !0,
         configurable: !0,
         enumerable: !1
-    }), await Promise.all([ Promise.resolve().then(() => (r(), o)), Promise.resolve().then(() => (n(), 
-    s)), Promise.resolve().then(() => (l(), i)), Promise.resolve().then(() => (c(), 
-    a)), Promise.resolve().then(() => (u(), b)), Promise.resolve().then(() => (f(), 
-    d)), Promise.resolve().then(() => (g(), m)), Promise.resolve().then(() => (p(), 
-    h)), Promise.resolve().then(() => (y(), v)), Promise.resolve().then(() => (j(), 
-    T)), Promise.resolve().then(() => (O(), P)), Promise.resolve().then(() => (S(), 
-    w)), Promise.resolve().then(() => (k(), _)) ]), Object.preventExtensions(idb), Object.seal(idb), 
+    }), await Promise.all([ Promise.resolve().then(() => (r(), o)), Promise.resolve().then(() => (i(), 
+    s)), Promise.resolve().then(() => (a(), n)), Promise.resolve().then(() => (c(), 
+    l)), Promise.resolve().then(() => (b(), m)), Promise.resolve().then(() => (d(), 
+    u)), Promise.resolve().then(() => (f(), g)), Promise.resolve().then(() => (p(), 
+    h)), Promise.resolve().then(() => (y(), v)), Promise.resolve().then(() => (O(), 
+    T)), Promise.resolve().then(() => (w(), j)), Promise.resolve().then(() => (P(), 
+    S)), Promise.resolve().then(() => ($(), E)) ]), Object.preventExtensions(idb), Object.seal(idb), 
     Object.freeze(idb);
 })() : (Object.defineProperty(globalThis, "idb", {
     value: {
@@ -819,4 +928,209 @@ Object.defineProperty(globalThis, "cache", {
     writable: !0,
     configurable: !0,
     enumerable: !1
-}));
+}), console.warn("Memorio IDB: IndexedDB is not available in this environment. Use store or session for data persistence."));
+
+var G = (globalThis.memorio || {}).globals;
+
+function Q() {
+    if (!globalThis.store) return {};
+    const e = {}, t = globalThis.store;
+    if ("function" == typeof t.list) try {
+        return t.list();
+    } catch {}
+    if ("function" == typeof t.get) for (const o of Object.keys(t)) if (![ "get", "set", "remove", "delete", "removeAll", "clearAll", "size", "isPersistent", "list" ].includes(o)) try {
+        const r = t.get(o);
+        null != r && (e[o] = r);
+    } catch {}
+    return e;
+}
+
+function X() {
+    if (!globalThis.session) return {};
+    const e = {}, t = globalThis.session;
+    if ("function" == typeof t.list) try {
+        return t.list();
+    } catch {}
+    if ("function" == typeof t.get) for (const o of Object.keys(t)) if (![ "get", "set", "remove", "delete", "removeAll", "clearAll", "size", "isPersistent", "list" ].includes(o)) try {
+        const r = t.get(o);
+        null != r && (e[o] = r);
+    } catch {}
+    return e;
+}
+
+var ee, te = e => {
+    globalThis[e] && "function" == typeof globalThis[e].clear ? globalThis[e].clear() : console.error(`Module ${e} not found or does not support clear()`);
+};
+
+void 0 !== globalThis.memorio && Object.defineProperty(globalThis.memorio, "devtools", {
+    enumerable: !1,
+    configurable: !0,
+    value: {
+        inspect: () => {
+            if (!0 === globalThis.memorio?.debug) {
+                if (globalThis.state) {
+                    const e = globalThis.state.list;
+                    let t;
+                    t = "function" == typeof e ? e() : "object" == typeof e && null !== e ? e : globalThis.state, 
+                    console.table(t);
+                }
+                if (globalThis.store && console.table(Q()), globalThis.session && console.table(X()), 
+                globalThis.cache) {
+                    const e = globalThis.cache.list;
+                    let t;
+                    t = "function" == typeof e ? e() : "object" == typeof e && null !== e ? e : globalThis.cache, 
+                    console.table(t);
+                }
+            }
+        },
+        stats: () => {
+            const e = e => {
+                if (!e) return 0;
+                if ("function" == typeof e.list) try {
+                    const t = e.list();
+                    return Object.keys(t).length;
+                } catch {}
+                return Object.keys(e).length;
+            };
+            return {
+                stateKeys: e(globalThis.state),
+                storeKeys: e(globalThis.store),
+                sessionKeys: e(globalThis.session),
+                cacheKeys: e(globalThis.cache),
+                idbDatabases: 0,
+                lastUpdate: (new Date).toISOString()
+            };
+        },
+        clear: te,
+        clearAll: () => {
+            te("state"), te("store"), te("session"), te("cache");
+        },
+        exportData: () => {
+            const e = {
+                state: (() => {
+                    if (globalThis.state) try {
+                        return "function" == typeof globalThis.state.list ? globalThis.state.list() : globalThis.state;
+                    } catch {
+                        return;
+                    }
+                })(),
+                store: Q(),
+                session: X(),
+                cache: (() => {
+                    if (globalThis.cache) try {
+                        return "function" == typeof globalThis.cache.list ? globalThis.cache.list() : globalThis.cache;
+                    } catch {
+                        return;
+                    }
+                })(),
+                exportedAt: (new Date).toISOString()
+            };
+            return JSON.stringify(e, null, 2);
+        },
+        importData: e => {
+            try {
+                const t = JSON.parse(e);
+                t.state && Object.entries(t.state).forEach(([e, t]) => {
+                    globalThis.state && "list" !== e && "remove" !== e && "removeAll" !== e && (globalThis.state[e] = t);
+                }), t.store && globalThis.store && "function" == typeof globalThis.store.set && Object.entries(t.store).forEach(([e, t]) => {
+                    globalThis.store.set(e, t);
+                }), t.session && globalThis.session && "function" == typeof globalThis.session.set && Object.entries(t.session).forEach(([e, t]) => {
+                    globalThis.session.set(e, t);
+                }), t.cache && globalThis.cache && Object.entries(t.cache).forEach(([e, t]) => {
+                    globalThis.cache && "get" !== e && "set" !== e && "remove" !== e && "clear" !== e && (globalThis.cache[e] = t);
+                });
+            } catch (e) {
+                console.error("%c✗ Import failed:", "color: #F44336", e);
+            }
+        },
+        help: () => {
+            console.log("\n🧠 Memorio DevTools Help\n\nAvailable commands:\n  memorio.devtools.inspect()          - Inspect all state modules\n  memorio.devtools.stats()            - Show statistics\n  memorio.devtools.clear('module')    - Clear specific module\n  memorio.devtools.clearAll()         - Clear all modules\n  memorio.devtools.exportData()       - Export all data as JSON\n  memorio.devtools.importData(json)   - Import data from JSON\n  memorio.devtools.help()             - Show this help\n\nShortcuts:\n  state    - globalThis.state\n  store    - globalThis.store\n  session  - globalThis.session\n  cache    - globalThis.cache\n");
+        }
+    }
+}), ee = "devtools", !1 === G || G && "object" == typeof G && !1 === G[ee] || (Object.defineProperty(globalThis, "$state", {
+    get: () => globalThis.state,
+    configurable: !0
+}), Object.defineProperty(globalThis, "$store", {
+    get: () => globalThis.store,
+    configurable: !0
+}), Object.defineProperty(globalThis, "$session", {
+    get: () => globalThis.session,
+    configurable: !0
+}), Object.defineProperty(globalThis, "$cache", {
+    get: () => globalThis.cache,
+    configurable: !0
+}));
+
+var oe = {
+    enabled: !0,
+    logToConsole: !0,
+    modules: [ "state", "store", "session", "cache", "idb" ],
+    maxEntries: 1e3
+}, re = [], se = e => oe.enabled && oe.modules.includes(e), ie = e => ({
+    state: "#4CAF50",
+    store: "#2196F3",
+    session: "#FF9800",
+    cache: "#9C27B0",
+    idb: "#F44336"
+}[e] || "#888888");
+
+void 0 !== globalThis.memorio && Object.defineProperty(globalThis.memorio, "logger", {
+    enumerable: !1,
+    configurable: !0,
+    value: {
+        configure: e => {
+            oe = {
+                ...oe,
+                ...e
+            };
+        },
+        enable: () => {
+            oe.enabled = !0;
+        },
+        disable: () => {
+            oe.enabled = !1;
+        },
+        isEnabled: se,
+        log: (e, t, o, r, s) => {
+            if (!se(e)) return;
+            const i = {
+                timestamp: (new Date).toISOString(),
+                module: e,
+                action: t,
+                path: o,
+                value: r,
+                previousValue: s
+            };
+            if (re.push(i), re.length > oe.maxEntries && re.shift(), oe.logToConsole && !0 === globalThis.memorio?.debug) {
+                const i = `[Memorio:${e.toUpperCase()}]`, n = ie(e);
+                memorio.message(`%c${i}%c ${t} ${o},\n      color: ${n}; font-weight: bold,\n      color: inherit`), 
+                void 0 !== r && memorio.message(`  → value:${r}`), void 0 !== s && memorio.message(`  ← previous:${s}`);
+            }
+            oe.customHandler && oe.customHandler(i);
+        },
+        getHistory: () => [ ...re ],
+        clearHistory: () => {
+            re.length = 0;
+        },
+        getStats: () => {
+            const e = {
+                total: re.length,
+                state: 0,
+                store: 0,
+                session: 0,
+                cache: 0,
+                idb: 0,
+                set: 0,
+                get: 0,
+                delete: 0,
+                clear: 0
+            };
+            for (const t of re) if (t) {
+                const o = t.module, r = t.action;
+                o && "number" == typeof e[o] && e[o]++, r && "number" == typeof e[r] && e[r]++;
+            }
+            return e;
+        },
+        exportLogs: () => JSON.stringify(re, null, 2)
+    }
+});