@biglogic/rgs 3.9.8 → 3.9.9

package/SKILL.md

@@ -0,0 +1,148 @@
+---
+name: biglogic-rgs
+description: Reactive global state management library for React - simple, secure, scalable
+---
+
+# @biglogic/rgs - Reactive Global State
+
+## Overview
+
+RGS (Argis) is a reactive global state management library for React. Simple, secure, and scalable. It provides typed state management with built-in persistence, security, and sync capabilities.
+
+## Instructions
+
+### Constraints
+
+1. **TypeScript Strict**: Always use strict typing - avoid `any` unless absolutely necessary
+2. **No console.log**: Use `console.debug` for debugging, or `console.warn`/`console.error` for warnings/errors
+3. **Build before commit**: Always run `npm run build` successfully before any commit
+4. **Test TypeScript**: Run `npx tsc --noEmit` to verify no type errors
+5. **No console.log debugging**: Never leave console.log statements in production code
+6. **Use arrow functions**: Prefer arrow functions over function declarations
+
+### Workflow
+
+1. **For new features**:
+   - Create in `core/` folder
+   - Export from `index.ts` if public API
+   - Add types to `core/types.ts`
+   - Run build and type-check
+
+2. **For bug fixes**:
+   - Run `npx tsc --noEmit` to identify issues
+   - Fix type errors first
+   - Verify build succeeds
+
+3. **For testing**:
+   - Run `npm run build` or `npm run test`
+   - Config is in `tests/` folder
+
+### Output Format
+
+When adding new hooks or functions:
+
+```typescript
+/**
+ * Description of what the hook does.
+ * @param param - Description of parameter
+ * @returns Description of return value
+ */
+export const myHook = (param: string): boolean => {
+  // Implementation
+}
+```
+
+## Usage Examples
+
+### Basic Store Creation
+
+```typescript
+import { gstate } from '@biglogic/rgs'
+
+// Create store with typed hook
+const store = gstate({ count: 0, name: 'John' })
+
+// Use typed hook for specific keys
+const [count, setCount] = store('count')
+const [name, setName] = store('name')
+
+// Or use store directly
+store.set('count', 5)
+store.get('count')
+```
+
+### SSR Support
+
+```typescript
+import { isServerSide, hydrateOnClient } from '@biglogic/rgs'
+
+if (isServerSide()) {
+  // Server-side logic
+}
+
+hydrateOnClient(myStore)
+```
+
+### Security
+
+```typescript
+import { generateEncryptionKey, validateKey } from '@biglogic/rgs'
+
+// Generate encryption key for secure persistence
+const key = generateEncryptionKey()
+
+// Validate keys to prevent XSS
+if (validateKey(userInput)) {
+  store.set(userInput, value)
+}
+```
+
+## API Quick Reference
+
+### Core
+
+| Function | Description |
+|----------|-------------|
+| `gstate(initialState, config?)` | Creates store + returns typed hook |
+| `useStore(key, store?)` | React hook for state subscription |
+| `createStore(config?)` | Creates store instance |
+| `initState(config?)` | Initializes global store |
+| `getStore()` | Gets current default store |
+
+### SSR
+
+| Function | Description |
+|----------|-------------|
+| `isServerSide()` | Check if running on server |
+| `isClientSide()` | Check if running on client |
+| `hydrateOnClient(store)` | Hydrate store on client |
+
+### Security
+
+| Function | Description |
+|----------|-------------|
+| `generateEncryptionKey()` | Generate AES-256 key |
+| `validateKey(key)` | Validate key format (XSS prevention) |
+| `sanitizeValue(value)` | Sanitize value |
+
+## Project Structure
+
+```
+core/
+├── hooks.ts       # React hooks (useStore, useSyncedState)
+├── store.ts       # Core store implementation
+├── types.ts       # TypeScript types
+├── security.ts    # Security utilities
+├── persistence.ts # Storage persistence
+├── sync.ts        # Sync engine
+└── ssr.ts        # SSR support
+```
+
+## Dependencies
+
+- **peerDependencies**: `react`, `react-dom` (>=16.8.0)
+- **devDependencies**: `typescript`, `tsup`, `terser`
+
+## License
+
+MIT - Copyright Dario Passariello

package/core/hooks.d.ts

@@ -15,3 +15,4 @@ export declare function useSyncedState<T = unknown>(key: string, store?: IStore<
 ];
 export declare const useSyncStatus: () => SyncState;
 export declare const triggerSync: (namespace?: string) => Promise<void>;
+export declare function useStoreSubscribe<S extends Record<string, unknown> = Record<string, unknown>>(store?: IStore<S>): readonly [boolean, () => void];

package/docs/SKILL.md

@@ -0,0 +1,148 @@
+---
+name: biglogic-rgs
+description: Reactive global state management library for React - simple, secure, scalable
+---
+
+# @biglogic/rgs - Reactive Global State
+
+## Overview
+
+RGS (Argis) is a reactive global state management library for React. Simple, secure, and scalable. It provides typed state management with built-in persistence, security, and sync capabilities.
+
+## Instructions
+
+### Constraints
+
+1. **TypeScript Strict**: Always use strict typing - avoid `any` unless absolutely necessary
+2. **No console.log**: Use `console.debug` for debugging, or `console.warn`/`console.error` for warnings/errors
+3. **Build before commit**: Always run `npm run build` successfully before any commit
+4. **Test TypeScript**: Run `npx tsc --noEmit` to verify no type errors
+5. **No console.log debugging**: Never leave console.log statements in production code
+6. **Use arrow functions**: Prefer arrow functions over function declarations
+
+### Workflow
+
+1. **For new features**:
+   - Create in `core/` folder
+   - Export from `index.ts` if public API
+   - Add types to `core/types.ts`
+   - Run build and type-check
+
+2. **For bug fixes**:
+   - Run `npx tsc --noEmit` to identify issues
+   - Fix type errors first
+   - Verify build succeeds
+
+3. **For testing**:
+   - Run `npm run build` or `npm run test`
+   - Config is in `tests/` folder
+
+### Output Format
+
+When adding new hooks or functions:
+
+```typescript
+/**
+ * Description of what the hook does.
+ * @param param - Description of parameter
+ * @returns Description of return value
+ */
+export const myHook = (param: string): boolean => {
+  // Implementation
+}
+```
+
+## Usage Examples
+
+### Basic Store Creation
+
+```typescript
+import { gstate } from '@biglogic/rgs'
+
+// Create store with typed hook
+const store = gstate({ count: 0, name: 'John' })
+
+// Use typed hook for specific keys
+const [count, setCount] = store('count')
+const [name, setName] = store('name')
+
+// Or use store directly
+store.set('count', 5)
+store.get('count')
+```
+
+### SSR Support
+
+```typescript
+import { isServerSide, hydrateOnClient } from '@biglogic/rgs'
+
+if (isServerSide()) {
+  // Server-side logic
+}
+
+hydrateOnClient(myStore)
+```
+
+### Security
+
+```typescript
+import { generateEncryptionKey, validateKey } from '@biglogic/rgs'
+
+// Generate encryption key for secure persistence
+const key = generateEncryptionKey()
+
+// Validate keys to prevent XSS
+if (validateKey(userInput)) {
+  store.set(userInput, value)
+}
+```
+
+## API Quick Reference
+
+### Core
+
+| Function | Description |
+|----------|-------------|
+| `gstate(initialState, config?)` | Creates store + returns typed hook |
+| `useStore(key, store?)` | React hook for state subscription |
+| `createStore(config?)` | Creates store instance |
+| `initState(config?)` | Initializes global store |
+| `getStore()` | Gets current default store |
+
+### SSR
+
+| Function | Description |
+|----------|-------------|
+| `isServerSide()` | Check if running on server |
+| `isClientSide()` | Check if running on client |
+| `hydrateOnClient(store)` | Hydrate store on client |
+
+### Security
+
+| Function | Description |
+|----------|-------------|
+| `generateEncryptionKey()` | Generate AES-256 key |
+| `validateKey(key)` | Validate key format (XSS prevention) |
+| `sanitizeValue(value)` | Sanitize value |
+
+## Project Structure
+
+```
+core/
+├── hooks.ts       # React hooks (useStore, useSyncedState)
+├── store.ts       # Core store implementation
+├── types.ts       # TypeScript types
+├── security.ts    # Security utilities
+├── persistence.ts # Storage persistence
+├── sync.ts        # Sync engine
+└── ssr.ts        # SSR support
+```
+
+## Dependencies
+
+- **peerDependencies**: `react`, `react-dom` (>=16.8.0)
+- **devDependencies**: `typescript`, `tsup`, `terser`
+
+## License
+
+MIT - Copyright Dario Passariello

package/docs/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/docs/markdown/getting-started.md

@@ -7,62 +7,56 @@ Stop wasting time on boilerplate. Here is how you deploy the RGS Panzer in your
 The engine is lightweight but armored.
 
 ```bash
-npm install rgs
+npm install @biglogic/rgs
 ```
 
-## 2. Initialization: The "Big Bang"
+## 2. Quick Start: The Zen Way (Recommended)
 
-In your main entry file (e.g., `main.tsx` or `App.tsx`), wake up the engine once.
+The simplest way to use RGS - one line creates both store and typed hook.
 
 ```typescript
-import { initState, useStore } from '@biglogic/rgs';
+import { gstate } from '@biglogic/rgs';
 
-// Initialize with optional settings
-initState({
-  namespace: 'my-awesome-app',
-  persistence: true // Optional: Saves everything to localStorage automatically
-});
-```
-
-## 3. Usage: Instant Reactions
-
-Use the `useStore` hook. No providers, no wrappers. Just raw, atomic power.
-
-```tsx
-import { useStore } from '@biglogic/rgs';
+// ONE line creates a typed store + hook
+const useCounter = gstate({ count: 0, name: 'John' })
 
 function Counter() {
-  // If 'count' doesn't exist yet, it defaults to undefined. Easy.
-  const [count, setCount] = useStore<number>('count');
+  // Get typed hook for specific keys
+  const [count, setCount] = useCounter('count')
+  const [name, setName] = useCounter('name')
 
   return (
-    <div className="card">
-      <h1>Power Level: {count ?? 0}</h1>
-      <button onClick={() => setCount((prev) => (prev || 0) + 1)}>
-        Boost Power 💥
+    <div>
+      <p>Hello, {name}!</p>
+      <p>Count: {count}</p>
+      <button onClick={() =u003e setCount(count + 1)}>
+        +1
       </button>
     </div>
-  );
+  )
 }
 ```
 
-## 🧐 What just happened?
-
-- **Reactive Subscription**: `useStore('count')` tells React to watch the 'count' key. Surgical updates only.
-- **Global Scope**: `setCount` updates the value everywhere in the app, instantly.
-- **Resilient Nature**: If you access a key that hasn't been set yet, RGS returns `undefined` gracefully instead of throwing a tantrum.
+Or use store methods directly:
+```typescript
+useCounter.set('count', 5)
+useCounter.get('count')
+```
 
-## 🚨 Pro Tip: Direct Store Access
+## 3. Classic Way (Global Store)
 
-Need to access state outside of React components? Simple.
+If you prefer a global store approach:
 
 ```typescript
-import { getStore } from '@biglogic/rgs';
-
-const value = getStore()?.get('count');
-getStore()?.set('count', 9001);
-```
+import { initState, useStore } from '@biglogic/rgs';
 
----
+// Initialize once at app root
+initState({
+  namespace: 'my-awesome-app',
+  persistence: true
+});
 
-**Next step:** [The Magnetar Way: One-Liner Power](the-magnetar-way.md)
+// Use anywhere in your app
+const [count, setCount] = useStore('count')
+const [user, setUser] = useStore('user')
+```

package/index.cjs

@@ -315,20 +315,20 @@ function f(e, ...t) {
 var g = Object, h = g.getPrototypeOf, m = "constructor", S = "prototype", _ = "configurable", w = "enumerable", b = "writable", v = "value", E = e => !!e && !!e[y];
 
 function k(e) {
-    return !!e && (C(e) || j(e) || !!e[d] || !!e[m]?.[d] || T(e) || I(e));
+    return !!e && (O(e) || j(e) || !!e[d] || !!e[m]?.[d] || T(e) || I(e));
 }
 
-var x = g[S][m].toString(), O = new WeakMap;
+var x = g[S][m].toString(), C = new WeakMap;
 
-function C(e) {
+function O(e) {
     if (!e || !z(e)) return !1;
     const t = h(e);
     if (null === t || t === g[S]) return !0;
     const n = g.hasOwnProperty.call(t, m) && t[m];
     if (n === Object) return !0;
     if (!V(n)) return !1;
-    let r = O.get(n);
-    return void 0 === r && (r = Function.toString.call(n), O.set(n, r)), r === x;
+    let r = C.get(n);
+    return void 0 === r && (r = Function.toString.call(n), C.set(n, r)), r === x;
 }
 
 function A(e, t, n = !0) {
@@ -356,7 +356,7 @@ function L(e, t) {
     if (T(e)) return new Map(e);
     if (I(e)) return new Set(e);
     if (j(e)) return Array[S].slice.call(e);
-    const n = C(e);
+    const n = O(e);
     if (!0 === t || "class_only" === t && !n) {
         const t = g.getOwnPropertyDescriptors(e);
         delete t[y];
@@ -791,8 +791,8 @@ var we = (new class {
         iv: r
     }, t.key, s);
     return JSON.parse((new TextDecoder).decode(o));
-}, Oe = null, Ce = e => {
-    Oe && Oe(e);
+}, Ce = null, Oe = e => {
+    Ce && Ce(e);
 }, Ae = (e, t, n) => {
     e.set(t instanceof RegExp ? t.source : t, n);
 }, De = (e, t, n, r) => {
@@ -831,7 +831,7 @@ var we = (new class {
         granted: r,
         timestamp: Date.now()
     }, o = e.get(t) || [];
-    return o.push(s), e.set(t, o), Ce({
+    return o.push(s), e.set(t, o), Oe({
         timestamp: Date.now(),
         action: "set",
         key: `consent:${n}`,
@@ -866,7 +866,7 @@ var Te = () => {
         }
     };
 }, Ve = n => {
-    const r = new Map, s = new Map, o = new Map, a = new Set, i = new Map, u = new Set, d = new Map, y = new Map, p = new Map, f = new Map, g = new Map, h = new Map, m = new Map, S = new Map, _ = n?.namespace || "gstate", w = n?.silent ?? !1, b = n?.debounceTime ?? 150, v = n?.version ?? 0, E = n?.storage || Ie(), k = n?.onError, x = n?.maxObjectSize ?? 0, O = n?.maxTotalSize ?? 0, C = n?.encryptionKey ?? null, A = n?.validateInput ?? !0, D = n?.auditEnabled ?? !0, M = n?.userId, P = n?.immer ?? !0, R = n?.persistByDefault ?? n?.persistence ?? n?.persist ?? !1;
+    const r = new Map, s = new Map, o = new Map, a = new Set, i = new Map, u = new Set, d = new Map, y = new Map, p = new Map, f = new Map, g = new Map, h = new Map, m = new Map, S = new Map, _ = n?.namespace || "gstate", w = n?.silent ?? !1, b = n?.debounceTime ?? 150, v = n?.version ?? 0, E = n?.storage || Ie(), k = n?.onError, x = n?.maxObjectSize ?? 0, C = n?.maxTotalSize ?? 0, O = n?.encryptionKey ?? null, A = n?.validateInput ?? !0, D = n?.auditEnabled ?? !0, M = n?.userId, P = n?.immer ?? !0, R = n?.persistByDefault ?? n?.persistence ?? n?.persist ?? !1;
     n?.accessRules && n.accessRules.forEach(e => Ae(m, e.pattern, e.permissions));
     let j, T = !1, I = !1, z = !1, V = 0, $ = null, N = null;
     const U = new Promise(e => {
@@ -879,7 +879,7 @@ var Te = () => {
         storage: E,
         config: n || {},
         diskQueue: g,
-        encryptionKey: C,
+        encryptionKey: O,
         audit: q,
         onError: k,
         silent: w,
@@ -924,7 +924,7 @@ var Te = () => {
             }
         })(B(), e, t);
     }, q = (e, t, n, r) => {
-        D && null !== Oe && Ce && Ce({
+        D && null !== Ce && Oe && Oe({
             timestamp: Date.now(),
             action: e,
             key: t,
@@ -1038,7 +1038,7 @@ var Te = () => {
         })(K());
     }, X = {}, Z = {
         _setSilently: (t, n) => {
-            const a = o.get(t) || 0, i = P && null !== n && "object" == typeof n ? F(e(n), !0) : n, c = (x > 0 || O > 0) && !Te() ? J(i) : 0;
+            const a = o.get(t) || 0, i = P && null !== n && "object" == typeof n ? F(e(n), !0) : n, c = (x > 0 || C > 0) && !Te() ? J(i) : 0;
             V = V - a + c, o.set(t, c), r.set(t, i), s.set(t, (s.get(t) || 0) + 1), N = null;
         },
         _registerMethod: (e, t, n) => {
@@ -1058,7 +1058,7 @@ var Te = () => {
             });
             const p = P && null !== d && "object" == typeof d ? F(e(d), !0) : d;
             if (!t(l, p)) {
-                const e = (x > 0 || O > 0) && !Te() ? J(p) : 0;
+                const e = (x > 0 || C > 0) && !Te() ? J(p) : 0;
                 if (x > 0 && e > x) {
                     const t = new Error(`Object size (${e} bytes) exceeds maxObjectSize (${x} bytes)`);
                     return k && k(t, {
@@ -1066,10 +1066,10 @@ var Te = () => {
                         key: a
                     }), !1;
                 }
-                if (O > 0) {
+                if (C > 0) {
                     const t = V - y + e;
-                    if (t > O) {
-                        const e = new Error(`Total store size (${t} bytes) exceeds limit (${O} bytes)`);
+                    if (t > C) {
+                        const e = new Error(`Total store size (${t} bytes) exceeds limit (${C} bytes)`);
                         return k && k(e, {
                             operation: "set"
                         }), !1;
@@ -1291,7 +1291,7 @@ var Te = () => {
                 operation: "hydration"
             });
         }
-    })(K(), e => (x > 0 || O > 0) && !Te() ? J(e) : 0, () => {
+    })(K(), e => (x > 0 || C > 0) && !Te() ? J(e) : 0, () => {
         z = !0, N = null, j(), Q();
     }).then(() => {}) : (z = !0, j()), n?.sync) {
         const e = n.sync, t = async () => {
@@ -1871,8 +1871,9 @@ exports.getStore = Ne, exports.gstate = (e, t) => {
     e && Object.entries(e).forEach(([e, t]) => {
         null === n.get(e) && n._setSilently(e, t);
     });
-    return "undefined" == typeof window || Te() || (window.gstate = n, window.gState = n, 
-    window.rgs = n), Object.assign(e => Ue(e, n), n);
+    const r = e => Ue(e, n);
+    return "undefined" == typeof window || Te() || (window.gstate = r, window.gState = n, 
+    window.rgs = n), Object.assign(r, n);
 }, exports.guardPlugin = e => ({
     name: "gstate-guard",
     hooks: {
@@ -1982,7 +1983,7 @@ exports.hydrateOnClient = async e => {
         e._setSilently(t, n);
     });
 }, exports.isClientSide = Qe, exports.isCryptoAvailable = Ee, exports.isServerSide = He, 
-exports.logAudit = Ce, exports.loggerPlugin = e => ({
+exports.logAudit = Oe, exports.loggerPlugin = e => ({
     name: "gstate-logger",
     hooks: {
         onSet: ({key: e, value: t, version: n}) => {
@@ -2025,7 +2026,7 @@ exports.logAudit = Ce, exports.loggerPlugin = e => ({
     type: "select",
     selector: e
 }), exports.setAuditLogger = e => {
-    Oe = e;
+    Ce = e;
 }, exports.snapshotPlugin = () => {
     const e = new Map;
     return {
@@ -2120,7 +2121,12 @@ exports.logAudit = Ce, exports.loggerPlugin = e => ({
 exports.useHydrationStatus = Ye, exports.useIsStoreReady = e => {
     const t = e || $e, r = n.useMemo(() => e => t ? t._subscribe(e) : () => {}, [ t ]);
     return n.useSyncExternalStore(r, () => !!t && t.isReady, () => !0);
-}, exports.useSimpleState = Ue, exports.useStore = Ue, exports.useSyncStatus = () => {
+}, exports.useSimpleState = Ue, exports.useStore = Ue, exports.useStoreSubscribe = function(e) {
+    const t = n.useMemo(() => e || $e, [ e ]), r = n.useCallback(e => t ? t._subscribe(e) : () => {}, [ t ]), s = n.useCallback(() => !0, []), o = n.useCallback(() => !0, []);
+    n.useSyncExternalStore(r, s, o);
+    const [, a] = n.useState(0);
+    return [ !0, n.useCallback(() => a(e => e + 1), []) ];
+}, exports.useSyncStatus = () => {
     const [e, t] = n.useState({
         isOnline: !0,
         isSyncing: !1,

package/index.d.ts

@@ -2,7 +2,7 @@ import { createStore as baseCreateStore } from "./core/store";
 import { useStore as baseUseStore } from "./core/hooks";
 import * as Security from "./core/security";
 import type { IStore, StoreConfig } from "./core/types";
-export declare const gstate: <S extends Record<string, unknown>>(initialState: S, configOrNamespace?: string | StoreConfig<S>) => IStore<S> & (<K extends keyof S>(key: K) => readonly [S[K] | undefined, (val: S[K] | ((draft: S[K]) => S[K]), options?: unknown) => boolean]);
+export declare const 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] | import(".").StateUpdater<S[K]>, options?: import("./advanced").PersistOptions) => boolean]) & IStore<S>;
 export { baseCreateStore as createStore };
 export { useStore, useIsStoreReady, initState, getStore, destroyState, useStore as useGState, useStore as useSimpleState } from "./core/hooks";
 export { createAsyncStore } from "./core/async";
@@ -12,7 +12,7 @@ export { createThunkStore, createActions, createAsyncAction, createAsyncActions,
 export type { ThunkAction, ThunkDispatch, ThunkActionPayload, Effect } from "./core/thunk";
 export { SyncEngine, createSyncEngine } from "./core/sync";
 export type { SyncConfig, SyncState, SyncResult, SyncStrategy, ConflictInfo, ConflictResolution } from "./core/sync";
-export { initSync, destroySync, useSyncedState, useSyncStatus, triggerSync } from "./core/hooks";
+export { initSync, destroySync, useSyncedState, useSyncStatus, triggerSync, useStoreSubscribe } from "./core/hooks";
 export * from "./plugins/index";
 export { generateEncryptionKey, exportKey, importKey, isCryptoAvailable, setAuditLogger, logAudit, validateKey, sanitizeValue, deriveKeyFromPassword, generateSalt } from "./core/security";
 export declare const addAccessRule: (pattern: string | ((key: string, userId?: string) => boolean), perms: Security.Permission[]) => void | undefined;

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/package.json

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