@biglogic/rgs 3.9.8 → 3.9.10

package/index.js

@@ -1446,7 +1446,7 @@ function at(e, t) {
     }, [ u, i, e, r ]), d ];
 }
 
-var it, ct, lt, ut, dt, ft, yt = () => {
+var it = () => {
     const [e, t] = s({
         isOnline: !0,
         isSyncing: !1,
@@ -1472,12 +1472,21 @@ var it, ct, lt, ut, dt, ft, yt = () => {
         const n = Array.from(rt.values()).map(t => t.onStateChange(e));
         return () => n.forEach(e => e());
     }, []), e;
-}, pt = async e => {
+}, ct = async e => {
     const t = e || Xe?.namespace;
     if (!t) return;
     const n = rt.get(t);
     n && await n.flush();
-}, ht = (e, t) => {
+};
+
+function lt(r) {
+    const o = e(() => r || Xe, [ r ]), a = n(e => o ? o._subscribe(e) : () => {}, [ o ]), i = n(() => !0, []), c = n(() => !0, []);
+    t(a, i, c);
+    const [, l] = s(0);
+    return [ !0, n(() => l(e => e + 1), []) ];
+}
+
+var ut, dt, ft, yt, pt, ht, gt = (e, t) => {
     const n = t?.key || "async_data", r = t?.store || Ge({
         namespace: `async_${n}`,
         silent: !0
@@ -1531,22 +1540,22 @@ var it, ct, lt, ut, dt, ft, yt = () => {
             }
         }
     });
-}, gt = () => "undefined" == typeof window || void 0 === window.document, mt = () => !gt(), _t = e => {
+}, mt = () => "undefined" == typeof window || void 0 === window.document, _t = () => !mt(), St = e => {
     const t = e?.ssrSafe ?? !0, n = e?.deferHydration ?? !1;
     let r = e?.storage;
-    !r && t && gt() && (r = He());
+    !r && t && mt() && (r = He());
     const s = Ge({
         ...e,
         storage: r || void 0,
         persistByDefault: !n && (e?.persistByDefault ?? !1)
     });
     let o = !1, a = null;
-    e?.initialState && gt() && (Object.entries(e.initialState).forEach(([e, t]) => {
+    e?.initialState && mt() && (Object.entries(e.initialState).forEach(([e, t]) => {
         s._setSilently(e, t);
     }), a = JSON.stringify(e.initialState));
     return Object.assign(s, {
         hydrate: async () => {
-            if (!o && !gt()) {
+            if (!o && !mt()) {
                 if (t && !s.namespace.startsWith("async_")) {
                     const t = s.getSnapshot(), n = Ge({
                         ...e,
@@ -1561,33 +1570,33 @@ var it, ct, lt, ut, dt, ft, yt = () => {
                 await s.whenReady();
             }
         },
-        getSerializedState: () => gt() ? JSON.stringify(s.getSnapshot()) : a,
+        getSerializedState: () => mt() ? JSON.stringify(s.getSnapshot()) : a,
         isHydrated: () => o || s.isReady
     });
-}, St = async e => {
-    gt() || await e.whenReady();
-}, wt = e => JSON.stringify(e.getSnapshot()), bt = (e, t) => {
-    if (!gt()) try {
+}, wt = async e => {
+    mt() || await e.whenReady();
+}, bt = e => JSON.stringify(e.getSnapshot()), vt = (e, t) => {
+    if (!mt()) try {
         const n = JSON.parse(t);
         Object.entries(n).forEach(([t, n]) => {
             e._setSilently(t, n);
         });
     } catch (e) {}
-}, vt = () => (it || (it = f("react"), ct = it.useState, lt = it.useEffect, ut = it.useSyncExternalStore, 
-dt = it.useMemo, ft = it.useCallback), {
-    React: it,
-    useState: ct,
-    useEffect: lt,
-    useSyncExternalStore: ut,
-    useMemo: dt,
-    useCallback: ft
-}), Et = () => {
-    const {useSyncExternalStore: e} = vt();
-    return e(e => () => {}, () => mt(), () => !0);
-}, kt = () => {
-    const {useState: e, useEffect: t} = vt(), [n, r] = e(() => gt()), [s, o] = e(() => gt());
+}, Et = () => (ut || (ut = f("react"), dt = ut.useState, ft = ut.useEffect, yt = ut.useSyncExternalStore, 
+pt = ut.useMemo, ht = ut.useCallback), {
+    React: ut,
+    useState: dt,
+    useEffect: ft,
+    useSyncExternalStore: yt,
+    useMemo: pt,
+    useCallback: ht
+}), kt = () => {
+    const {useSyncExternalStore: e} = Et();
+    return e(e => () => {}, () => _t(), () => !0);
+}, Ot = () => {
+    const {useState: e, useEffect: t} = Et(), [n, r] = e(() => mt()), [s, o] = e(() => mt());
     return t(() => {
-        if (gt()) return;
+        if (mt()) return;
         r(!0);
         const e = setTimeout(() => {
             o(!0), r(!1);
@@ -1597,10 +1606,10 @@ dt = it.useMemo, ft = it.useCallback), {
         isHydrated: s,
         isHydrating: n
     };
-}, Ot = e => {
-    const {useState: t, useEffect: n, useMemo: r} = vt(), [s, o] = t(() => !!gt() || (e.isHydrated?.() ?? e.isReady));
+}, Ct = e => {
+    const {useState: t, useEffect: n, useMemo: r} = Et(), [s, o] = t(() => !!mt() || (e.isHydrated?.() ?? e.isReady));
     return n(() => {
-        if (gt()) return;
+        if (mt()) return;
         const t = () => {
             const t = e.isHydrated?.() ?? e.isReady;
             o(t);
@@ -1645,24 +1654,24 @@ dt = it.useMemo, ft = it.useCallback), {
             }
         };
     }, [ e, s ]);
-}, Ct = e => {
-    const t = _t(e);
+}, Dt = e => {
+    const t = St(e);
     return Object.assign(t, {
-        useHydrated: Et,
-        useHydrationStatus: kt,
+        useHydrated: kt,
+        useHydrationStatus: Ot,
         useDeferredStore: e => {
-            const n = Ot(t), {useCallback: r} = vt();
+            const n = Ct(t), {useCallback: r} = Et();
             return (e => {
-                const {useSyncExternalStore: t} = vt();
+                const {useSyncExternalStore: t} = Et();
                 return t(r(t => n._subscribe(t, e), [ n, e ]), r(() => n.get(e), [ n, e ]), () => {});
             })(e);
         }
     });
-}, Dt = e => e.getSnapshot(), Mt = (e, t) => {
-    gt() || Object.entries(t).forEach(([t, n]) => {
+}, Mt = e => e.getSnapshot(), At = (e, t) => {
+    mt() || Object.entries(t).forEach(([t, n]) => {
         e._setSilently(t, n);
     });
-}, At = (e, t) => {
+}, jt = (e, t) => {
     const n = t?.extraArgument, r = async t => {
         if ("function" == typeof t) return t(r, () => e.getSnapshot(), n);
         if (t.type) {
@@ -1681,10 +1690,10 @@ dt = it.useMemo, ft = it.useCallback), {
     return Object.assign(e, {
         dispatch: r
     });
-}, jt = (e, t) => {
-    const n = At(e);
+}, Rt = (e, t) => {
+    const n = jt(e);
     return Object.assign(n.dispatch, t);
-}, Rt = (e, t) => async (n, r) => {
+}, Pt = (e, t) => async (n, r) => {
     const s = r()[e];
     n({
         type: `SET_${e.toUpperCase()}`,
@@ -1714,31 +1723,31 @@ dt = it.useMemo, ft = it.useCallback), {
             }
         }), t;
     }
-}, Pt = (e, t) => {
-    At(e);
+}, Tt = (e, t) => {
+    jt(e);
     const n = {};
-    for (const [e, r] of Object.entries(t)) n[e] = Rt(e, r);
+    for (const [e, r] of Object.entries(t)) n[e] = Pt(e, r);
     return n;
-}, Tt = (e, ...t) => ({
+}, It = (e, ...t) => ({
     type: "call",
     fn: e,
     args: t
-}), It = e => ({
+}), zt = e => ({
     type: "put",
     action: e
-}), zt = e => ({
+}), xt = e => ({
     type: "select",
     selector: e
-}), xt = e => ({
+}), $t = e => ({
     type: "take",
     pattern: e
-}), $t = e => ({
+}), Vt = e => ({
     type: "all",
     effects: e
-}), Vt = e => ({
+}), Nt = e => ({
     type: "race",
     effects: e
-}), Nt = e => async (t, n) => {
+}), Ut = e => async (t, n) => {
     const r = async e => {
         switch (e.type) {
           case "call":
@@ -1767,18 +1776,18 @@ dt = it.useMemo, ft = it.useCallback), {
         let t = e.next();
         for (;!t.done; ) await r(t.value), t = e.next();
     } catch (e) {}
-}, Ut = (e, t) => (At(e).dispatch(t), () => {});
+}, Lt = (e, t) => (jt(e).dispatch(t), () => {});
 
 g();
 
-var Lt = () => ({
+var Ft = () => ({
     name: "gstate-immer",
     hooks: {
         onInstall: ({store: e}) => {
             e._registerMethod("immer", "setWithProduce", (t, n) => e.set(t, n));
         }
     }
-}), Ft = e => {
+}), Kt = e => {
     let t = [], n = -1, r = !1;
     const s = e?.limit || 50;
     return {
@@ -1810,7 +1819,7 @@ var Lt = () => ({
             }
         }
     };
-}, Kt = e => ({
+}, Jt = e => ({
     name: "gstate-schema",
     hooks: {
         onSet: ({key: t, value: n}) => {
@@ -1822,7 +1831,7 @@ var Lt = () => ({
             }
         }
     }
-}), Jt = e => {
+}), Bt = e => {
     const t = globalThis.__REDUX_DEVTOOLS_EXTENSION__;
     if (!t?.connect) return {
         name: "gstate-devtools-noop",
@@ -1845,7 +1854,7 @@ var Lt = () => ({
             }
         }
     };
-}, Bt = () => {
+}, Wt = () => {
     const e = new Map;
     return {
         name: "gstate-snapshot",
@@ -1865,7 +1874,7 @@ var Lt = () => ({
             }
         }
     };
-}, Wt = e => ({
+}, Qt = e => ({
     name: "gstate-guard",
     hooks: {
         onBeforeSet: ({key: t, value: n, store: r}) => {
@@ -1874,7 +1883,7 @@ var Lt = () => ({
             s && s(n);
         }
     }
-}), Qt = e => ({
+}), qt = e => ({
     name: "gstate-analytics",
     hooks: {
         onSet: ({key: t, value: n}) => {
@@ -1892,7 +1901,7 @@ var Lt = () => ({
             }));
         }
     }
-}), qt = e => {
+}), Ht = e => {
     const t = new BroadcastChannel(e?.channelName || "gstate_sync");
     let n = !1;
     return {
@@ -1922,7 +1931,7 @@ var Lt = () => ({
             }
         }
     };
-}, Ht = () => {
+}, Gt = () => {
     if (Qe()) return {
         name: "gstate-debug-noop",
         hooks: {}
@@ -1960,7 +1969,7 @@ var Lt = () => ({
             }
         }
     };
-}, Gt = (e = {}) => {
+}, Xt = (e = {}) => {
     const t = e.dbName || "rgs-db", n = e.storeName || "states", r = e.version || 1;
     let s = null;
     const o = () => new Promise((e, o) => {
@@ -2028,7 +2037,7 @@ var Lt = () => ({
             }
         }
     };
-}, Xt = e => {
+}, Zt = e => {
     const {adapter: t, autoSyncInterval: n} = e, r = new Map, s = {
         lastSyncTimestamp: null,
         totalKeysSynced: 0,
@@ -2082,7 +2091,7 @@ var Lt = () => ({
             }
         }
     };
-}, Zt = (e, t) => ({
+}, Yt = (e, t) => ({
     name: "MongoDB-Atlas",
     save: async n => (await fetch(`${e}/action/updateOne`, {
         method: "POST",
@@ -2106,7 +2115,7 @@ var Lt = () => ({
             upsert: !0
         })
     })).ok
-}), Yt = (e, t) => ({
+}), en = (e, t) => ({
     name: "Firebase-Firestore",
     save: async e => {
         try {
@@ -2116,7 +2125,7 @@ var Lt = () => ({
             return !1;
         }
     }
-}), en = (e, t) => ({
+}), tn = (e, t) => ({
     name: "SQL-REST-API",
     save: async n => {
         const r = t();
@@ -2131,7 +2140,7 @@ var Lt = () => ({
             credentials: "same-origin"
         })).ok;
     }
-}), tn = e => ({
+}), nn = e => ({
     name: "gstate-logger",
     hooks: {
         onSet: ({key: e, value: t, version: n}) => {
@@ -2140,27 +2149,28 @@ var Lt = () => ({
         onRemove: ({key: e}) => {},
         onTransaction: ({key: e}) => {}
     }
-}), nn = (e, t) => {
+}), rn = (e, t) => {
     const n = Ge("string" == typeof t ? {
         namespace: t
     } : t);
     e && Object.entries(e).forEach(([e, t]) => {
         null === n.get(e) && n._setSilently(e, t);
     });
-    return "undefined" == typeof window || Qe() || (window.gstate = n, window.gState = n, 
-    window.rgs = n), Object.assign(e => nt(e, n), n);
-}, rn = (e, t) => tt()?.addAccessRule(e, t), sn = (e, t, n) => tt()?.hasPermission(e, t, n) ?? !0, on = (e, t, n) => {
+    const r = e => nt(e, n);
+    return "undefined" == typeof window || Qe() || (window.gstate = r, window.gState = n, 
+    window.rgs = n), Object.assign(r, n);
+}, sn = (e, t) => tt()?.addAccessRule(e, t), on = (e, t, n) => tt()?.hasPermission(e, t, n) ?? !0, an = (e, t, n) => {
     const r = tt();
     if (!r) throw new Error("[gstate] recordConsent failed: No store found. call initState() first.");
     return r.recordConsent(e, t, n);
-}, an = (e, t) => tt()?.hasConsent(e, t) ?? !1, cn = e => tt()?.getConsents(e) ?? [], ln = (e, t) => tt()?.revokeConsent(e, t), un = e => {
+}, cn = (e, t) => tt()?.hasConsent(e, t) ?? !1, ln = e => tt()?.getConsents(e) ?? [], un = (e, t) => tt()?.revokeConsent(e, t), dn = e => {
     const t = tt();
     if (!t) throw new Error("[gstate] exportUserData failed: No store found.");
     return t.exportUserData(e);
-}, dn = e => {
+}, fn = e => {
     const t = tt();
     if (!t) throw new Error("[gstate] deleteUserData failed: No store found.");
     return t.deleteUserData(e);
-}, fn = () => {}, yn = () => {};
+}, yn = () => {}, pn = () => {};
 
-export { c as SyncEngine, rn as addAccessRule, $t as all, Qt as analyticsPlugin, Tt as call, fn as clearAccessRules, yn as clearAllConsents, Xt as cloudSyncPlugin, jt as createActions, Rt as createAsyncAction, Pt as createAsyncActions, ht as createAsyncStore, Yt as createFirestoreAdapter, Zt as createMongoAdapter, Ct as createNextStore, _t as createSSRStore, Nt as createSaga, en as createSqlRestAdapter, Ge as createStore, l as createSyncEngine, At as createThunkStore, Ht as debugPlugin, wt as dehydrateStore, dn as deleteUserData, Re as deriveKeyFromPassword, Ye as destroyState, ot as destroySync, Jt as devToolsPlugin, Ie as exportKey, un as exportUserData, Te as generateEncryptionKey, Pe as generateSalt, cn as getConsents, Dt as getSSRInitialState, tt as getStore, nn as gstate, Wt as guardPlugin, an as hasConsent, sn as hasPermission, St as hydrateOnClient, Lt as immerPlugin, ze as importKey, Gt as indexedDBPlugin, Ze as initState, st as initSync, Mt as initializeFromSSR, mt as isClientSide, je as isCryptoAvailable, gt as isServerSide, Ue as logAudit, tn as loggerPlugin, It as put, Vt as race, on as recordConsent, bt as rehydrateStore, ln as revokeConsent, Ut as runSaga, Ke as sanitizeValue, Kt as schemaPlugin, zt as select, Ne as setAuditLogger, Bt as snapshotPlugin, qt as syncPlugin, xt as take, pt as triggerSync, Ft as undoRedoPlugin, Ot as useDeferredStore, nt as useGState, Et as useHydrated, kt as useHydrationStatus, et as useIsStoreReady, nt as useSimpleState, nt as useStore, yt as useSyncStatus, at as useSyncedState, Je as validateKey };
+export { c as SyncEngine, sn as addAccessRule, Vt as all, qt as analyticsPlugin, It as call, yn as clearAccessRules, pn as clearAllConsents, Zt as cloudSyncPlugin, Rt as createActions, Pt as createAsyncAction, Tt as createAsyncActions, gt as createAsyncStore, en as createFirestoreAdapter, Yt as createMongoAdapter, Dt as createNextStore, St as createSSRStore, Ut as createSaga, tn as createSqlRestAdapter, Ge as createStore, l as createSyncEngine, jt as createThunkStore, Gt as debugPlugin, bt as dehydrateStore, fn as deleteUserData, Re as deriveKeyFromPassword, Ye as destroyState, ot as destroySync, Bt as devToolsPlugin, Ie as exportKey, dn as exportUserData, Te as generateEncryptionKey, Pe as generateSalt, ln as getConsents, Mt as getSSRInitialState, tt as getStore, rn as gstate, Qt as guardPlugin, cn as hasConsent, on as hasPermission, wt as hydrateOnClient, Ft as immerPlugin, ze as importKey, Xt as indexedDBPlugin, Ze as initState, st as initSync, At as initializeFromSSR, _t as isClientSide, je as isCryptoAvailable, mt as isServerSide, Ue as logAudit, nn as loggerPlugin, zt as put, Nt as race, an as recordConsent, vt as rehydrateStore, un as revokeConsent, Lt as runSaga, Ke as sanitizeValue, Jt as schemaPlugin, xt as select, Ne as setAuditLogger, Wt as snapshotPlugin, Ht as syncPlugin, $t as take, ct as triggerSync, Kt as undoRedoPlugin, Ct as useDeferredStore, nt as useGState, kt as useHydrated, Ot as useHydrationStatus, et as useIsStoreReady, nt as useSimpleState, nt as useStore, lt as useStoreSubscribe, it as useSyncStatus, at as useSyncedState, Je as validateKey };

package/{docs/markdown → markdown}/api.md

@@ -6,6 +6,38 @@ Complete API reference for RGS (Argis) - Reactive Global State.
 
 ## Core Functions
 
+### `gstate`
+
+Creates a reactive store with a built-in typed hook in one line.
+
+```typescript
+function gstate<S extends Record<string, unknown>>(
+  initialState: S,
+  configOrNamespace?: string | StoreConfig<S>
+): (<K extends keyof S>(key: K) => readonly [S[K] | undefined, (val: S[K] | StateUpdater<S[K]>, options?: PersistOptions) => boolean]) & IStore<S>
+```
+
+**Parameters:**
+- `initialState` - Initial state object
+- `configOrNamespace` - Optional namespace string or full StoreConfig
+
+**Returns:** A callable function that returns typed hooks when called with a key, plus the full store interface.
+
+**Example:**
+```typescript
+const useCounter = gstate({ count: 0, name: 'John' })
+
+// Get typed hook for specific key
+const [count, setCount] = useCounter('count')
+const [name, setName] = useCounter('name')
+
+// Or use store methods directly
+useCounter.set('count', 5)
+useCounter.get('count')
+```
+
+---
+
 ### `initState`
 
 Initializes a global store instance.

package/markdown/getting-started.md

@@ -0,0 +1,62 @@
+# ⚡ Chapter 2: Quick Start - From Zero to State in 30 Seconds
+
+Stop wasting time on boilerplate. Here is how you deploy the RGS Panzer in your React project.
+
+## 1. Installation
+
+The engine is lightweight but armored.
+
+```bash
+npm install @biglogic/rgs
+```
+
+## 2. Quick Start: The Zen Way (Recommended)
+
+The simplest way to use RGS - one line creates both store and typed hook.
+
+```typescript
+import { gstate } from '@biglogic/rgs';
+
+// ONE line creates a typed store + hook
+const useCounter = gstate({ count: 0, name: 'John' })
+
+function Counter() {
+  // Get typed hook for specific keys
+  const [count, setCount] = useCounter('count')
+  const [name, setName] = useCounter('name')
+
+  return (
+    <div>
+      <p>Hello, {name}!</p>
+      <p>Count: {count}</p>
+      <button onClick={() =u003e setCount(count + 1)}>
+        +1
+      </button>
+    </div>
+  )
+}
+```
+
+Or use store methods directly:
+```typescript
+useCounter.set('count', 5)
+useCounter.get('count')
+```
+
+## 3. Classic Way (Global Store)
+
+If you prefer a global store approach:
+
+```typescript
+import { initState, useStore } from '@biglogic/rgs';
+
+// Initialize once at app root
+initState({
+  namespace: 'my-awesome-app',
+  persistence: true
+});
+
+// Use anywhere in your app
+const [count, setCount] = useStore('count')
+const [user, setUser] = useStore('user')
+```

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@biglogic/rgs",
   "code": "argis",
-  "version": "3.9.8",
+  "version": "3.9.10",
   "description": "Argis (RGS) - Reactive Global State: A react state everywhere made easy",
   "main": "./index.cjs",
   "browser": "./index.cjs",