nusm 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nusm contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,240 @@
+<p align="center">
+  <img src="./logo.svg" alt="nusm" height="100" />
+</p>
+
+# nusm 
+Non Uniform State Manager (nusm) > Pronounced **noose em** (/ˈnuːs əm/)
+is a persistence-ready wrapper around
+[@tanstack/store](https://github.com/TanStack/store) with adapter-based storage
+
+## Features
+
+- Same store semantics as @tanstack/store
+- Optional persistence via adapters
+- Entire-store or slice-based persistence
+- Async hydration with deep merge
+- Debounced persistence via @tanstack/pacer
+- Adapter events for cross-tab or external updates
+- React hooks (via `nusm/react`)
+- @tanstack/devtools event support (panel coming soon)
+
+## Install
+
+```bash
+bun install `nusm`
+```
+
+## Quick Start
+
+```ts
+import { createNusmStore, createLocalStorageAdapter } from 'nusm'
+
+const store = createNusmStore(
+	{ count: 0 },
+	{
+		storeId: 'counter',
+		adapter: createLocalStorageAdapter(),
+		persist: { strategy: 'entire' },
+	},
+)
+
+await store.ready
+store.setState((state) => ({ count: state.count + 1 }))
+```
+
+## API
+
+### `createNusmStore(initialState, options?)`
+
+Creates a nusm-backed store.
+
+```ts
+import { createNusmStore } from 'nusm'
+
+const nusm = createNusmStore(initialState, {
+	storeId: 'settings',
+	adapter,
+	persist: {
+		strategy: 'entire',
+	},
+})
+```
+
+Return value:
+
+- A @tanstack/store instance extended with `ready` (resolves when hydration completes).
+
+### Persistence strategies
+
+**Entire store**
+
+```ts
+persist: { strategy: 'entire' }
+```
+
+**Slices**
+
+```ts
+persist: {
+	strategy: 'slices',
+	slices: [
+		{
+			key: 'todos',
+			select: (state) => state.todos,
+			apply: (state, sliceValue) => ({ ...state, todos: sliceValue }),
+		},
+	],
+}
+```
+
+### Hydration configuration
+
+```ts
+persist: {
+	strategy: 'entire',
+	hydrate: {
+		discardPersisted: false,
+		validate: (persisted) => ({ ok: true, value: persisted }),
+		merge: ({ initial, persisted }) => ({ ...initial, ...persisted }),
+	},
+}
+```
+
+## Adapters
+
+Adapters control persistence. They define how nusm reads/writes state and how
+external changes (for example, another tab) are observed.
+
+### Adapter interface
+
+```ts
+type NusmAdapter = {
+	name: string
+	getItem(key: string): unknown | null | Promise<unknown | null>
+	setItem(key: string, value: unknown): void | Promise<void>
+	removeItem(key: string): void | Promise<void>
+	getAllKeys?(): string[] | Promise<string[]>
+	clear?(): void | Promise<void>
+	subscribe?(listener: (event: { type: 'set' | 'remove' | 'clear'; key?: string }) => void): () => void
+	resolveKey?(params: { storeId: string; sliceKey?: string; kind: 'entire' | 'slice' }): string
+	pacer?: false | { wait?: number; maxWait?: number; leading?: boolean; trailing?: boolean }
+}
+```
+
+Notes:
+
+- `getAllKeys` enables more complete persisted snapshots.
+- `resolveKey` lets you control key layout. When omitted, nusm uses
+	`nusm:<storeId>:entire` and `nusm:<storeId>:slice:<sliceKey>`.
+- `subscribe` should emit adapter events for cross-tab or external updates.
+- `pacer` controls debouncing of writes. Use `false` to write immediately.
+
+### Creating a custom adapter
+
+```ts
+const memoryAdapter: NusmAdapter = {
+	name: 'memory',
+	getItem: (key) => store.get(key) ?? null,
+	setItem: (key, value) => store.set(key, value),
+	removeItem: (key) => store.delete(key),
+	getAllKeys: () => Array.from(store.keys()),
+	resolveKey: ({ storeId, kind, sliceKey }) =>
+		kind === 'entire'
+			? `nusm:${storeId}:entire`
+			: `nusm:${storeId}:slice:${sliceKey}`,
+}
+```
+
+### Local Storage
+
+```ts
+import { createLocalStorageAdapter } from 'nusm'
+
+const adapter = createLocalStorageAdapter()
+```
+
+Options:
+
+- `storage`: a `Storage`-like implementation (defaults to `window.localStorage`).
+- `prefix`: key prefix (default: `nusm`).
+- `serialize`: custom serializer (default: `superjson.stringify`).
+- `deserialize`: custom deserializer (default: `superjson.parse`).
+- `pacer`: persistence debouncer configuration.
+
+### Session Storage
+
+```ts
+import { createSessionStorageAdapter } from 'nusm'
+
+const adapter = createSessionStorageAdapter()
+```
+
+Options:
+
+- `storage`: a `Storage`-like implementation (defaults to `window.sessionStorage`).
+- `prefix`: key prefix (default: `nusm`).
+- `serialize`: custom serializer (default: `superjson.stringify`).
+- `deserialize`: custom deserializer (default: `superjson.parse`).
+- `pacer`: persistence debouncer configuration.
+
+### IndexDB
+
+```ts
+import { createIndexDbAdapter } from 'nusm'
+
+const adapter = createIndexDbAdapter({ dbName: 'my-db' })
+```
+
+Options:
+
+- `dbName`: database name (default: `nusm`).
+- `storeName`: object store name (default: `nusm`).
+- `version`: database version (default: `1`).
+- `serialize`: custom serializer (default: `superjson.stringify`).
+- `deserialize`: custom deserializer (default: `superjson.parse`).
+- `pacer`: persistence debouncer configuration (default: trailing, 100ms).
+
+## React Hooks
+
+```ts
+import { useStore } from 'nusm/react'
+```
+
+`useStore` uses React 19's `useSyncExternalStore` and supports selectors and
+configurable equality checks.
+
+### `useStore(store, selector?, options?)`
+
+Arguments:
+
+- `store`: a Nusm store instance returned by `createNusmStore`.
+- `selector` (optional): function that receives the full state and returns the
+	selected slice. Defaults to identity (returns full state).
+- `options` (optional): configuration object with:
+	- `equal`: when `true`, uses deep equality (`fast-equals` `deepEqual`). When
+		`false` or omitted, uses shallow equality (`fast-equals` `shallowEqual`).
+
+Example:
+
+```ts
+const store = createNusmStore({ user: { name: 'Ada' } })
+
+const name = useStore(store, (state) => state.user.name)
+const user = useStore(store, (state) => state.user, { equal: true })
+```
+
+## Tests
+
+```bash
+bun test
+```
+
+## Build
+
+```bash
+bun run build
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/dist/adapters/indexDbAdapter.d.ts

@@ -0,0 +1,3 @@
+import type { IndexDbAdapterOptions, NusmAdapter } from "../types";
+export declare const createIndexDbAdapter: (options?: IndexDbAdapterOptions) => NusmAdapter;
+//# sourceMappingURL=indexDbAdapter.d.ts.map

package/dist/adapters/indexDbAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexDbAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/indexDbAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AA+CnE,eAAO,MAAM,oBAAoB,GAC/B,UAAU,qBAAqB,KAC9B,WAsCF,CAAC"}

package/dist/adapters/indexDbAdapter.js

@@ -0,0 +1,53 @@
+import superjson from "superjson";
+const openIndexDb = (dbName, storeName, version) => {
+    return new Promise((resolve, reject) => {
+        const request = indexedDB.open(dbName, version);
+        request.onerror = () => reject(request.error);
+        request.onupgradeneeded = () => {
+            const db = request.result;
+            if (!db.objectStoreNames.contains(storeName)) {
+                db.createObjectStore(storeName);
+            }
+        };
+        request.onsuccess = () => resolve(request.result);
+    });
+};
+const withStore = async (dbName, storeName, mode, action) => {
+    const db = await openIndexDb(dbName, storeName, 1);
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(storeName, mode);
+        const store = tx.objectStore(storeName);
+        const request = action(store);
+        request.onerror = () => reject(request.error);
+        request.onsuccess = () => resolve(request.result);
+    });
+};
+const defaultResolveKey = (params) => {
+    if (params.kind === "entire") {
+        return `nusm:${params.storeId}:entire`;
+    }
+    return `nusm:${params.storeId}:slice:${params.sliceKey}`;
+};
+export const createIndexDbAdapter = (options) => {
+    if (typeof indexedDB === "undefined") {
+        throw new Error("IndexDB adapter requires a browser environment.");
+    }
+    const dbName = options?.dbName ?? "nusm";
+    const storeName = options?.storeName ?? "nusm";
+    const serialize = options?.serialize ?? ((value) => superjson.stringify(value));
+    const deserialize = options?.deserialize ?? ((raw) => superjson.parse(raw));
+    return {
+        clear: () => withStore(dbName, storeName, "readwrite", (store) => store.clear()).then(() => undefined),
+        getAllKeys: async () => {
+            const keys = await withStore(dbName, storeName, "readonly", (store) => store.getAllKeys());
+            return keys.map((key) => String(key));
+        },
+        getItem: (key) => withStore(dbName, storeName, "readonly", (store) => store.get(key)).then((raw) => (raw == null ? null : deserialize(String(raw)))),
+        name: "indexdb",
+        pacer: options?.pacer ?? { trailing: true, wait: 100 },
+        removeItem: (key) => withStore(dbName, storeName, "readwrite", (store) => store.delete(key)).then(() => undefined),
+        resolveKey: defaultResolveKey,
+        setItem: (key, value) => withStore(dbName, storeName, "readwrite", (store) => store.put(serialize(value), key)).then(() => undefined),
+    };
+};
+//# sourceMappingURL=indexDbAdapter.js.map

package/dist/adapters/indexDbAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexDbAdapter.js","sourceRoot":"","sources":["../../src/adapters/indexDbAdapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/localStorageAdapter.d.ts

@@ -0,0 +1,3 @@
+import type { NusmAdapter, StorageAdapterOptions } from "../types";
+export declare const createLocalStorageAdapter: (options?: StorageAdapterOptions) => NusmAdapter;
+//# sourceMappingURL=localStorageAdapter.d.ts.map

package/dist/adapters/localStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localStorageAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/localStorageAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGnE,eAAO,MAAM,yBAAyB,GACpC,UAAU,qBAAqB,KAC9B,WAQA,CAAC"}

package/dist/adapters/localStorageAdapter.js

@@ -0,0 +1,6 @@
+import { createStorageAdapter } from "./storageAdapter";
+export const createLocalStorageAdapter = (options) => createStorageAdapter("localStorage", typeof window === "undefined" ? undefined : window.localStorage, {
+    pacer: { trailing: true, wait: 50 },
+    ...options,
+});
+//# sourceMappingURL=localStorageAdapter.js.map

package/dist/adapters/localStorageAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localStorageAdapter.js","sourceRoot":"","sources":["../../src/adapters/localStorageAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,OAA+B,EAClB,EAAE,CACf,oBAAoB,CAClB,cAAc,EACd,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,EAC/D;IACE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;IACnC,GAAG,OAAO;CACX,CACF,CAAC"}

package/dist/adapters/sessionStorageAdapter.d.ts

@@ -0,0 +1,3 @@
+import type { NusmAdapter, StorageAdapterOptions } from "../types";
+export declare const createSessionStorageAdapter: (options?: StorageAdapterOptions) => NusmAdapter;
+//# sourceMappingURL=sessionStorageAdapter.d.ts.map

package/dist/adapters/sessionStorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStorageAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/sessionStorageAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGnE,eAAO,MAAM,2BAA2B,GACtC,UAAU,qBAAqB,KAC9B,WAQA,CAAC"}

package/dist/adapters/sessionStorageAdapter.js

@@ -0,0 +1,6 @@
+import { createStorageAdapter } from "./storageAdapter";
+export const createSessionStorageAdapter = (options) => createStorageAdapter("sessionStorage", typeof window === "undefined" ? undefined : window.sessionStorage, {
+    pacer: { trailing: true, wait: 50 },
+    ...options,
+});
+//# sourceMappingURL=sessionStorageAdapter.js.map

package/dist/adapters/sessionStorageAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStorageAdapter.js","sourceRoot":"","sources":["../../src/adapters/sessionStorageAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,OAA+B,EAClB,EAAE,CACf,oBAAoB,CAClB,gBAAgB,EAChB,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,EACjE;IACE,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;IACnC,GAAG,OAAO;CACX,CACF,CAAC"}

package/dist/adapters/storageAdapter.d.ts

@@ -0,0 +1,3 @@
+import type { NusmAdapter, StorageAdapterOptions, StorageLike } from "../types";
+export declare const createStorageAdapter: (name: string, defaultStorage: StorageLike | undefined, options?: StorageAdapterOptions) => NusmAdapter;
+//# sourceMappingURL=storageAdapter.d.ts.map

package/dist/adapters/storageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageAdapter.d.ts","sourceRoot":"","sources":["../../src/adapters/storageAdapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,WAAW,EACX,qBAAqB,EACrB,WAAW,EACZ,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,gBAAgB,WAAW,GAAG,SAAS,EACvC,UAAU,qBAAqB,KAC9B,WAmEF,CAAC"}

package/dist/adapters/storageAdapter.js

@@ -0,0 +1,62 @@
+import superjson from "superjson";
+export const createStorageAdapter = (name, defaultStorage, options) => {
+    const storage = options?.storage ?? defaultStorage;
+    if (!storage) {
+        throw new Error(`${name} adapter requires a storage implementation.`);
+    }
+    const prefix = options?.prefix ?? "nusm";
+    const serialize = options?.serialize ?? ((value) => superjson.stringify(value));
+    const deserialize = options?.deserialize ?? ((raw) => superjson.parse(raw));
+    const resolveKey = (params) => {
+        if (params.kind === "entire") {
+            return `${prefix}:${params.storeId}:entire`;
+        }
+        return `${prefix}:${params.storeId}:slice:${params.sliceKey}`;
+    };
+    const getAllKeys = () => {
+        if (typeof storage.length !== "number" || !storage.key)
+            return [];
+        const keys = [];
+        for (let i = 0; i < storage.length; i += 1) {
+            const key = storage.key(i);
+            if (key)
+                keys.push(key);
+        }
+        return keys;
+    };
+    const subscribe = (listener) => {
+        if (typeof window === "undefined" || !("addEventListener" in window)) {
+            return () => undefined;
+        }
+        const handler = (event) => {
+            if (!event.key)
+                return;
+            if (!event.key.startsWith(prefix))
+                return;
+            if (event.newValue === null) {
+                listener({ key: event.key, type: "remove" });
+                return;
+            }
+            listener({ key: event.key, type: "set" });
+        };
+        window.addEventListener("storage", handler);
+        return () => window.removeEventListener("storage", handler);
+    };
+    return {
+        clear: storage.clear ? () => storage.clear?.() : undefined,
+        getAllKeys,
+        getItem: (key) => {
+            const raw = storage.getItem(key);
+            return raw == null ? null : deserialize(raw);
+        },
+        name,
+        pacer: options?.pacer,
+        removeItem: (key) => storage.removeItem(key),
+        resolveKey,
+        setItem: (key, value) => {
+            storage.setItem(key, serialize(value));
+        },
+        subscribe,
+    };
+};
+//# sourceMappingURL=storageAdapter.js.map

package/dist/adapters/storageAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageAdapter.js","sourceRoot":"","sources":["../../src/adapters/storageAdapter.ts"],"names":[],"mappings":"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"}

package/dist/core/createNusmStore.d.ts

@@ -0,0 +1,3 @@
+import type { CreateNusmStoreOptions, NusmStore } from "../types";
+export declare function createNusmStore<TState>(initialState: TState, options?: CreateNusmStoreOptions<TState>): NusmStore<TState>;
+//# sourceMappingURL=createNusmStore.d.ts.map

package/dist/core/createNusmStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createNusmStore.d.ts","sourceRoot":"","sources":["../../src/core/createNusmStore.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,sBAAsB,EAItB,SAAS,EACV,MAAM,UAAU,CAAC;AAwDlB,wBAAgB,eAAe,CAAC,MAAM,EACpC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,GACvC,SAAS,CAAC,MAAM,CAAC,CAggBnB"}