@pyreon/storage 0.12.15 → 0.13.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/lib/analysis/index.js.html +1 -1
- package/lib/index.js +5 -1
- package/lib/index.js.map +1 -1
- package/lib/types/index.d.ts.map +1 -1
- package/package.json +6 -4
- package/src/indexed-db.ts +9 -2
- package/src/manifest.ts +124 -0
- package/src/tests/manifest-snapshot.test.ts +74 -0
|
@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
|
|
|
5386
5386
|
</script>
|
|
5387
5387
|
<script>
|
|
5388
5388
|
/*<!--*/
|
|
5389
|
-
const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"
|
|
5389
|
+
const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"a379c11c-1","name":"registry.ts"},{"uid":"a379c11c-3","name":"utils.ts"},{"uid":"a379c11c-5","name":"cookie.ts"},{"uid":"a379c11c-7","name":"custom.ts"},{"uid":"a379c11c-9","name":"indexed-db.ts"},{"uid":"a379c11c-11","name":"local.ts"},{"uid":"a379c11c-13","name":"session.ts"},{"uid":"a379c11c-15","name":"clear.ts"},{"uid":"a379c11c-17","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"a379c11c-1":{"renderedLength":1076,"gzipLength":468,"brotliLength":0,"metaUid":"a379c11c-0"},"a379c11c-3":{"renderedLength":1231,"gzipLength":565,"brotliLength":0,"metaUid":"a379c11c-2"},"a379c11c-5":{"renderedLength":3215,"gzipLength":1193,"brotliLength":0,"metaUid":"a379c11c-4"},"a379c11c-7":{"renderedLength":2242,"gzipLength":890,"brotliLength":0,"metaUid":"a379c11c-6"},"a379c11c-9":{"renderedLength":4535,"gzipLength":1524,"brotliLength":0,"metaUid":"a379c11c-8"},"a379c11c-11":{"renderedLength":3217,"gzipLength":1141,"brotliLength":0,"metaUid":"a379c11c-10"},"a379c11c-13":{"renderedLength":932,"gzipLength":464,"brotliLength":0,"metaUid":"a379c11c-12"},"a379c11c-15":{"renderedLength":1489,"gzipLength":604,"brotliLength":0,"metaUid":"a379c11c-14"},"a379c11c-17":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"a379c11c-16"}},"nodeMetas":{"a379c11c-0":{"id":"/src/registry.ts","moduleParts":{"index.js":"a379c11c-1"},"imported":[],"importedBy":[{"uid":"a379c11c-16"},{"uid":"a379c11c-4"},{"uid":"a379c11c-6"},{"uid":"a379c11c-8"},{"uid":"a379c11c-10"},{"uid":"a379c11c-12"},{"uid":"a379c11c-14"}]},"a379c11c-2":{"id":"/src/utils.ts","moduleParts":{"index.js":"a379c11c-3"},"imported":[],"importedBy":[{"uid":"a379c11c-4"},{"uid":"a379c11c-6"},{"uid":"a379c11c-8"},{"uid":"a379c11c-10"},{"uid":"a379c11c-12"},{"uid":"a379c11c-14"}]},"a379c11c-4":{"id":"/src/cookie.ts","moduleParts":{"index.js":"a379c11c-5"},"imported":[{"uid":"a379c11c-18"},{"uid":"a379c11c-0"},{"uid":"a379c11c-2"}],"importedBy":[{"uid":"a379c11c-16"}]},"a379c11c-6":{"id":"/src/custom.ts","moduleParts":{"index.js":"a379c11c-7"},"imported":[{"uid":"a379c11c-18"},{"uid":"a379c11c-0"},{"uid":"a379c11c-2"}],"importedBy":[{"uid":"a379c11c-16"}]},"a379c11c-8":{"id":"/src/indexed-db.ts","moduleParts":{"index.js":"a379c11c-9"},"imported":[{"uid":"a379c11c-18"},{"uid":"a379c11c-0"},{"uid":"a379c11c-2"}],"importedBy":[{"uid":"a379c11c-16"}]},"a379c11c-10":{"id":"/src/local.ts","moduleParts":{"index.js":"a379c11c-11"},"imported":[{"uid":"a379c11c-18"},{"uid":"a379c11c-0"},{"uid":"a379c11c-2"}],"importedBy":[{"uid":"a379c11c-16"},{"uid":"a379c11c-12"}]},"a379c11c-12":{"id":"/src/session.ts","moduleParts":{"index.js":"a379c11c-13"},"imported":[{"uid":"a379c11c-18"},{"uid":"a379c11c-10"},{"uid":"a379c11c-0"},{"uid":"a379c11c-2"}],"importedBy":[{"uid":"a379c11c-16"}]},"a379c11c-14":{"id":"/src/clear.ts","moduleParts":{"index.js":"a379c11c-15"},"imported":[{"uid":"a379c11c-0"},{"uid":"a379c11c-2"}],"importedBy":[{"uid":"a379c11c-16"}]},"a379c11c-16":{"id":"/src/index.ts","moduleParts":{"index.js":"a379c11c-17"},"imported":[{"uid":"a379c11c-4"},{"uid":"a379c11c-6"},{"uid":"a379c11c-8"},{"uid":"a379c11c-10"},{"uid":"a379c11c-12"},{"uid":"a379c11c-14"},{"uid":"a379c11c-0"}],"importedBy":[],"isEntry":true},"a379c11c-18":{"id":"@pyreon/reactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"a379c11c-4"},{"uid":"a379c11c-6"},{"uid":"a379c11c-8"},{"uid":"a379c11c-10"},{"uid":"a379c11c-12"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
|
|
5390
5390
|
|
|
5391
5391
|
const run = () => {
|
|
5392
5392
|
const width = window.innerWidth;
|
package/lib/index.js
CHANGED
|
@@ -279,6 +279,7 @@ const useMemoryStorage = createStorage((() => {
|
|
|
279
279
|
|
|
280
280
|
//#endregion
|
|
281
281
|
//#region src/indexed-db.ts
|
|
282
|
+
const __DEV__ = import.meta.env?.DEV === true;
|
|
282
283
|
const dbCache = /* @__PURE__ */ new Map();
|
|
283
284
|
function openDB(dbName, storeName) {
|
|
284
285
|
if (typeof indexedDB === "undefined") return Promise.reject(/* @__PURE__ */ new Error("[Pyreon] indexedDB is not available in this environment"));
|
|
@@ -344,7 +345,10 @@ function useIndexedDB(key, defaultValue, options = {}) {
|
|
|
344
345
|
const value = deserialize(raw, defaultValue, options.deserializer, options.onError);
|
|
345
346
|
sig.set(value);
|
|
346
347
|
}
|
|
347
|
-
}).catch(() => {
|
|
348
|
+
}).catch((err) => {
|
|
349
|
+
if (__DEV__) console.warn(`[Pyreon] IndexedDB "${key}" init failed, using default:`, err);
|
|
350
|
+
options.onError?.(err instanceof Error ? err : new Error(String(err)));
|
|
351
|
+
});
|
|
348
352
|
let writeTimer = null;
|
|
349
353
|
let pendingValue;
|
|
350
354
|
function flushWrite() {
|
package/lib/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/registry.ts","../src/utils.ts","../src/cookie.ts","../src/custom.ts","../src/indexed-db.ts","../src/local.ts","../src/session.ts","../src/clear.ts"],"sourcesContent":["import type { StorageSignal } from './types'\n\n// ─── Signal Registry ─────────────────────────────────────────────────────────\n\ninterface RegistryEntry<T = unknown> {\n signal: StorageSignal<T>\n defaultValue: T\n backend: string\n}\n\nconst registry = new Map<string, RegistryEntry>()\n\n/**\n * Build a composite key from backend type + storage key to avoid\n * collisions between different backends using the same key name.\n */\nfunction registryKey(backend: string, key: string): string {\n return `${backend}:${key}`\n}\n\n/**\n * Get an existing signal from the registry.\n */\nexport function getEntry<T>(backend: string, key: string): RegistryEntry<T> | undefined {\n return registry.get(registryKey(backend, key)) as RegistryEntry<T> | undefined\n}\n\n/**\n * Register a new signal in the registry.\n */\nexport function setEntry<T>(\n backend: string,\n key: string,\n signal: StorageSignal<T>,\n defaultValue: T,\n): void {\n registry.set(registryKey(backend, key), { signal, defaultValue, backend })\n}\n\n/**\n * Remove an entry from the registry.\n */\nexport function removeEntry(backend: string, key: string): void {\n registry.delete(registryKey(backend, key))\n}\n\n/**\n * Get all entries for a specific backend.\n */\nexport function getEntriesByBackend(backend: string): RegistryEntry[] {\n const entries: RegistryEntry[] = []\n for (const entry of registry.values()) {\n if (entry.backend === backend) entries.push(entry)\n }\n return entries\n}\n\n/**\n * Clear all entries from the registry. Used for testing.\n */\nexport function _resetRegistry(): void {\n registry.clear()\n}\n","import type { StorageOptions } from './types'\n\n// ─── SSR Detection ───────────────────────────────────────────────────────────\n\n/**\n * Check if we're running in a browser environment.\n */\nexport function isBrowser(): boolean {\n return typeof window !== 'undefined' && typeof document !== 'undefined'\n}\n\n// ─── Serialization ───────────────────────────────────────────────────────────\n\n/**\n * Serialize a value to a string for storage.\n */\nexport function serialize<T>(value: T, serializer?: StorageOptions<T>['serializer']): string {\n if (serializer) return serializer(value)\n return JSON.stringify(value)\n}\n\n/**\n * Deserialize a raw string from storage back to a typed value.\n * Returns the default value if deserialization fails.\n */\nexport function deserialize<T>(\n raw: string,\n defaultValue: T,\n deserializer?: StorageOptions<T>['deserializer'],\n onError?: StorageOptions<T>['onError'],\n): T {\n try {\n if (deserializer) return deserializer(raw)\n return JSON.parse(raw) as T\n } catch (e) {\n if (onError) {\n const result = onError(e as Error)\n return result !== undefined ? result : defaultValue\n }\n return defaultValue\n }\n}\n\n// ─── Safe Storage Access ─────────────────────────────────────────────────────\n\n/**\n * Safely get a Web Storage instance (localStorage or sessionStorage).\n * Returns null if not available (SSR, security restrictions, etc.).\n */\nexport function getWebStorage(type: 'local' | 'session'): Storage | null {\n if (!isBrowser()) return null\n try {\n const storage = type === 'local' ? window.localStorage : window.sessionStorage\n // Test that it actually works (can throw in private browsing)\n const testKey = '__pyreon_storage_test__'\n storage.setItem(testKey, '1')\n storage.removeItem(testKey)\n return storage\n } catch {\n return null\n }\n}\n","import { signal } from '@pyreon/reactivity'\nimport { getEntry, removeEntry, setEntry } from './registry'\nimport type { CookieOptions, StorageSignal } from './types'\nimport { deserialize, isBrowser, serialize } from './utils'\n\n// ─── Server-side cookie source ───────────────────────────────────────────────\n\nlet serverCookieString = ''\n\n/**\n * Set the cookie source string for SSR. Call this once per request\n * with the raw Cookie header value.\n *\n * @example\n * ```ts\n * // In your SSR request handler\n * setCookieSource(request.headers.get('cookie') ?? '')\n * ```\n */\nexport function setCookieSource(cookieHeader: string): void {\n serverCookieString = cookieHeader\n}\n\n// ─── Cookie parsing ──────────────────────────────────────────────────────────\n\nfunction parseCookies(cookieString: string): Map<string, string> {\n const cookies = new Map<string, string>()\n if (!cookieString) return cookies\n\n for (const pair of cookieString.split(';')) {\n const eqIndex = pair.indexOf('=')\n if (eqIndex === -1) continue\n const name = pair.slice(0, eqIndex).trim()\n const value = pair.slice(eqIndex + 1).trim()\n if (name) cookies.set(name, decodeURIComponent(value))\n }\n\n return cookies\n}\n\nfunction getCookieString(): string {\n if (isBrowser()) return document.cookie\n return serverCookieString\n}\n\nfunction readCookie(key: string): string | null {\n const cookies = parseCookies(getCookieString())\n return cookies.get(key) ?? null\n}\n\n// ─── Cookie writing ──────────────────────────────────────────────────────────\n\nfunction writeCookie<T>(key: string, value: T, options: CookieOptions<T>): void {\n if (!isBrowser()) return\n\n const serialized = serialize(value, options.serializer)\n let cookie = `${encodeURIComponent(key)}=${encodeURIComponent(serialized)}`\n\n if (options.maxAge !== undefined) {\n cookie += `; max-age=${options.maxAge}`\n }\n if (options.expires) {\n cookie += `; expires=${options.expires.toUTCString()}`\n }\n cookie += `; path=${options.path ?? '/'}`\n if (options.domain) {\n cookie += `; domain=${options.domain}`\n }\n if (options.secure) {\n cookie += '; secure'\n }\n cookie += `; samesite=${options.sameSite ?? 'lax'}`\n\n document.cookie = cookie\n}\n\nfunction deleteCookie<T>(key: string, options: CookieOptions<T>): void {\n if (!isBrowser()) return\n\n let cookie = `${encodeURIComponent(key)}=; max-age=0`\n cookie += `; path=${options.path ?? '/'}`\n if (options.domain) {\n cookie += `; domain=${options.domain}`\n }\n\n document.cookie = cookie\n}\n\n// ─── useCookie ───────────────────────────────────────────────────────────────\n\n/**\n * Reactive signal backed by a browser cookie. SSR-compatible when\n * used with setCookieSource().\n *\n * @example\n * ```ts\n * const locale = useCookie('locale', 'en', {\n * maxAge: 60 * 60 * 24 * 365, // 1 year\n * path: '/',\n * sameSite: 'lax',\n * })\n * locale() // 'en'\n * locale.set('de') // sets cookie + updates signal\n * locale.remove() // deletes cookie, resets to default\n * ```\n */\nexport function useCookie<T>(\n key: string,\n defaultValue: T,\n options: CookieOptions<T> = {},\n): StorageSignal<T> {\n // Return existing signal if already registered\n const existing = getEntry<T>('cookie', key)\n if (existing) return existing.signal\n\n // Read initial value from cookie\n const raw = readCookie(key)\n const initialValue =\n raw !== null\n ? deserialize(raw, defaultValue, options.deserializer, options.onError)\n : defaultValue\n\n const sig = signal<T>(initialValue)\n\n // Build the storage signal\n const storageSig = (() => sig()) as unknown as StorageSignal<T>\n\n storageSig.peek = () => sig.peek()\n storageSig.subscribe = (listener: () => void) => sig.subscribe(listener)\n storageSig.direct = (updater: () => void) => sig.direct(updater)\n storageSig.debug = () => sig.debug()\n\n Object.defineProperty(storageSig, 'label', {\n get: () => sig.label,\n set: (v: string | undefined) => {\n sig.label = v\n },\n })\n\n storageSig.set = (value: T) => {\n sig.set(value)\n writeCookie(key, value, options)\n }\n\n storageSig.update = (fn: (current: T) => T) => {\n const newValue = fn(sig.peek())\n storageSig.set(newValue)\n }\n\n storageSig.remove = () => {\n sig.set(defaultValue)\n deleteCookie(key, options)\n removeEntry('cookie', key)\n }\n\n setEntry('cookie', key, storageSig, defaultValue)\n\n return storageSig\n}\n","import { signal } from '@pyreon/reactivity'\nimport { getEntry, removeEntry, setEntry } from './registry'\nimport type { StorageBackend, StorageOptions, StorageSignal } from './types'\nimport { deserialize, serialize } from './utils'\n\n// ─── createStorage ───────────────────────────────────────────────────────────\n\n/**\n * Create a custom storage hook backed by any synchronous storage backend.\n * Useful for encrypted storage, in-memory storage, or custom adapters.\n *\n * @example\n * ```ts\n * const useEncrypted = createStorage({\n * get: (key) => decrypt(localStorage.getItem(key)),\n * set: (key, value) => localStorage.setItem(key, encrypt(value)),\n * remove: (key) => localStorage.removeItem(key),\n * })\n *\n * const secret = useEncrypted('api-key', '')\n * ```\n */\nexport function createStorage(\n backend: StorageBackend,\n backendName?: string,\n): <T>(key: string, defaultValue: T, options?: StorageOptions<T>) => StorageSignal<T> {\n const name = backendName ?? 'custom'\n\n return function useCustomStorage<T>(\n key: string,\n defaultValue: T,\n options?: StorageOptions<T>,\n ): StorageSignal<T> {\n // Return existing signal if already registered\n const existing = getEntry<T>(name, key)\n if (existing) return existing.signal\n\n // Read initial value\n let initialValue = defaultValue\n try {\n const raw = backend.get(key)\n if (raw !== null) {\n initialValue = deserialize(raw, defaultValue, options?.deserializer, options?.onError)\n }\n } catch {\n // Backend read failed — use default\n }\n\n const sig = signal<T>(initialValue)\n\n // Build the storage signal\n const storageSig = (() => sig()) as unknown as StorageSignal<T>\n\n storageSig.peek = () => sig.peek()\n storageSig.subscribe = (listener: () => void) => sig.subscribe(listener)\n storageSig.direct = (updater: () => void) => sig.direct(updater)\n storageSig.debug = () => sig.debug()\n\n Object.defineProperty(storageSig, 'label', {\n get: () => sig.label,\n set: (v: string | undefined) => {\n sig.label = v\n },\n })\n\n storageSig.set = (value: T) => {\n sig.set(value)\n try {\n backend.set(key, serialize(value, options?.serializer))\n } catch {\n // Write failed — signal still updates\n }\n }\n\n storageSig.update = (fn: (current: T) => T) => {\n const newValue = fn(sig.peek())\n storageSig.set(newValue)\n }\n\n storageSig.remove = () => {\n sig.set(defaultValue)\n try {\n backend.remove(key)\n } catch {\n // Remove failed\n }\n removeEntry(name, key)\n }\n\n setEntry(name, key, storageSig, defaultValue)\n\n return storageSig\n }\n}\n\n// ─── Memory storage ──────────────────────────────────────────────────────────\n\n/**\n * In-memory storage backend. Useful for SSR, testing, or ephemeral state.\n * Values are lost on page unload.\n *\n * @example\n * ```ts\n * import { useMemoryStorage } from '@pyreon/storage'\n *\n * const temp = useMemoryStorage('key', 'default')\n * ```\n */\nexport const useMemoryStorage = createStorage(\n (() => {\n const store = new Map<string, string>()\n return {\n get: (key: string) => store.get(key) ?? null,\n set: (key: string, value: string) => store.set(key, value),\n remove: (key: string) => store.delete(key),\n }\n })(),\n 'memory',\n)\n","import { signal } from '@pyreon/reactivity'\nimport { getEntry, removeEntry, setEntry } from './registry'\nimport type { IndexedDBOptions, StorageSignal } from './types'\nimport { deserialize, isBrowser, serialize } from './utils'\n\n// ─── Database management ─────────────────────────────────────────────────────\n\nconst dbCache = new Map<string, Promise<IDBDatabase>>()\n\nfunction openDB(dbName: string, storeName: string): Promise<IDBDatabase> {\n if (typeof indexedDB === 'undefined') {\n return Promise.reject(new Error('[Pyreon] indexedDB is not available in this environment'))\n }\n const cacheKey = `${dbName}:${storeName}`\n const cached = dbCache.get(cacheKey)\n if (cached) return cached\n\n const promise = new Promise<IDBDatabase>((resolve, reject) => {\n const request = indexedDB.open(dbName, 1)\n\n request.onupgradeneeded = () => {\n const db = request.result\n if (!db.objectStoreNames.contains(storeName)) {\n db.createObjectStore(storeName)\n }\n }\n\n request.onsuccess = () => resolve(request.result)\n request.onerror = () => reject(request.error)\n })\n\n dbCache.set(cacheKey, promise)\n return promise\n}\n\nfunction idbGet(db: IDBDatabase, storeName: string, key: string): Promise<string | null> {\n return new Promise((resolve, reject) => {\n const tx = db.transaction(storeName, 'readonly')\n const store = tx.objectStore(storeName)\n const request = store.get(key)\n request.onsuccess = () =>\n resolve(request.result !== undefined ? (request.result as string) : null)\n request.onerror = () => reject(request.error)\n })\n}\n\nfunction idbSet(db: IDBDatabase, storeName: string, key: string, value: string): Promise<void> {\n return new Promise((resolve, reject) => {\n const tx = db.transaction(storeName, 'readwrite')\n const store = tx.objectStore(storeName)\n const request = store.put(value, key)\n request.onsuccess = () => resolve()\n request.onerror = () => reject(request.error)\n })\n}\n\nfunction idbDelete(db: IDBDatabase, storeName: string, key: string): Promise<void> {\n return new Promise((resolve, reject) => {\n const tx = db.transaction(storeName, 'readwrite')\n const store = tx.objectStore(storeName)\n const request = store.delete(key)\n request.onsuccess = () => resolve()\n request.onerror = () => reject(request.error)\n })\n}\n\n// ─── useIndexedDB ────────────────────────────────────────────────────────────\n\n/**\n * Reactive signal backed by IndexedDB. Suitable for large or structured\n * data that exceeds localStorage limits. Writes are debounced.\n *\n * The signal starts with `defaultValue` and updates asynchronously\n * when the stored value is read from IndexedDB.\n *\n * @example\n * ```ts\n * const draft = useIndexedDB('article-draft', { title: '', body: '' })\n * draft() // { title: '', body: '' } initially, then stored value\n * draft.set({ title: 'My Post', body: '...' }) // signal updates immediately, IDB write is debounced\n * ```\n */\nexport function useIndexedDB<T>(\n key: string,\n defaultValue: T,\n options: IndexedDBOptions<T> = {},\n): StorageSignal<T> {\n // Return existing signal if already registered\n const existing = getEntry<T>('indexeddb', key)\n if (existing) return existing.signal\n\n const dbName = options.dbName ?? 'pyreon-storage'\n const storeName = options.storeName ?? 'kv'\n const debounceMs = options.debounceMs ?? 100\n\n const sig = signal<T>(defaultValue)\n\n // Async initial load\n if (isBrowser() && typeof indexedDB !== 'undefined') {\n openDB(dbName, storeName)\n .then((db) => idbGet(db, storeName, key))\n .then((raw) => {\n if (raw !== null) {\n const value = deserialize(raw, defaultValue, options.deserializer, options.onError)\n sig.set(value)\n }\n })\n .catch(() => {\n // IndexedDB not available — signal keeps defaultValue\n })\n }\n\n // Debounced write\n let writeTimer: ReturnType<typeof setTimeout> | null = null\n let pendingValue: T | undefined\n\n function flushWrite(): void {\n if (pendingValue === undefined) return\n const value = pendingValue\n pendingValue = undefined\n\n if (!isBrowser() || typeof indexedDB === 'undefined') return\n\n openDB(dbName, storeName)\n .then((db) => idbSet(db, storeName, key, serialize(value, options.serializer)))\n .catch(() => {\n // Write failed — signal still has the correct value\n })\n }\n\n function scheduleWrite(value: T): void {\n pendingValue = value\n if (writeTimer !== null) clearTimeout(writeTimer)\n writeTimer = setTimeout(flushWrite, debounceMs)\n }\n\n // Build the storage signal\n const storageSig = (() => sig()) as unknown as StorageSignal<T>\n\n storageSig.peek = () => sig.peek()\n storageSig.subscribe = (listener: () => void) => sig.subscribe(listener)\n storageSig.direct = (updater: () => void) => sig.direct(updater)\n storageSig.debug = () => sig.debug()\n\n Object.defineProperty(storageSig, 'label', {\n get: () => sig.label,\n set: (v: string | undefined) => {\n sig.label = v\n },\n })\n\n storageSig.set = (value: T) => {\n sig.set(value)\n scheduleWrite(value)\n }\n\n storageSig.update = (fn: (current: T) => T) => {\n const newValue = fn(sig.peek())\n storageSig.set(newValue)\n }\n\n storageSig.remove = () => {\n sig.set(defaultValue)\n pendingValue = undefined\n if (writeTimer !== null) clearTimeout(writeTimer)\n\n if (isBrowser() && typeof indexedDB !== 'undefined') {\n openDB(dbName, storeName)\n .then((db) => idbDelete(db, storeName, key))\n .catch(() => {\n // Delete failed — signal already reset\n })\n }\n\n removeEntry('indexeddb', key)\n }\n\n setEntry('indexeddb', key, storageSig, defaultValue)\n\n return storageSig\n}\n\n/**\n * Reset the database cache. For testing only.\n */\nexport function _resetDBCache(): void {\n dbCache.clear()\n}\n","import { signal } from '@pyreon/reactivity'\nimport { getEntry, removeEntry, setEntry } from './registry'\nimport type { StorageOptions, StorageSignal } from './types'\nimport { deserialize, getWebStorage, isBrowser, serialize } from './utils'\n\n// ─── Cross-tab sync ──────────────────────────────────────────────────────────\n\n// Refcount the active localStorage signals so we can detach the `storage`\n// event listener when nothing subscribes anymore. Before the refcount, the\n// listener was attached on first `useStorage` and NEVER removed, leaking a\n// window-level handler across the lifetime of the page even after all\n// signals disposed via `.remove()`.\nlet activeCount = 0\nlet storageHandler: ((e: StorageEvent) => void) | null = null\n\nfunction onStorageEvent(e: StorageEvent): void {\n if (!e.key) return\n const entry = getEntry('local', e.key)\n if (!entry) return\n\n const newValue =\n e.newValue !== null ? deserialize(e.newValue, entry.defaultValue) : entry.defaultValue\n\n entry.signal.set(newValue)\n}\n\nfunction retainStorageListener(): void {\n if (!isBrowser()) return\n activeCount++\n if (storageHandler === null) {\n storageHandler = onStorageEvent\n window.addEventListener('storage', storageHandler)\n }\n}\n\n/**\n * Test-only: force-detach the cross-tab listener and reset the refcount.\n * Used in test teardown to keep `_resetRegistry` and listener state in sync.\n */\nexport function _resetStorageListener(): void {\n if (storageHandler !== null && isBrowser()) {\n window.removeEventListener('storage', storageHandler)\n }\n storageHandler = null\n activeCount = 0\n}\n\n/**\n * Release one refcount on the cross-tab listener. Detaches the window-level\n * handler when the count drops to zero. Called from `.remove()`.\n */\nexport function releaseStorageListener(): void {\n if (!isBrowser()) return\n if (activeCount === 0) return\n activeCount--\n if (activeCount === 0 && storageHandler !== null) {\n window.removeEventListener('storage', storageHandler)\n storageHandler = null\n }\n}\n\n// ─── useStorage ──────────────────────────────────────────────────────────────\n\n/**\n * Reactive signal backed by localStorage. Automatically syncs across\n * browser tabs via the native `storage` event.\n *\n * @example\n * ```ts\n * const theme = useStorage('theme', 'light')\n * theme() // 'light' (or stored value)\n * theme.set('dark') // updates signal + localStorage\n * theme.remove() // clears storage, resets to default\n * ```\n */\nexport function useStorage<T>(\n key: string,\n defaultValue: T,\n options?: StorageOptions<T>,\n): StorageSignal<T> {\n // Return existing signal if already registered\n const existing = getEntry<T>('local', key)\n if (existing) return existing.signal\n\n const storage = getWebStorage('local')\n\n // Read initial value from storage\n let initialValue = defaultValue\n if (storage) {\n const raw = storage.getItem(key)\n if (raw !== null) {\n initialValue = deserialize(raw, defaultValue, options?.deserializer, options?.onError)\n }\n }\n\n const sig = signal<T>(initialValue)\n\n // Create the storage signal by extending the base signal\n const storageSig = createStorageSignal(sig, key, defaultValue, 'local', options)\n\n setEntry('local', key, storageSig, defaultValue)\n retainStorageListener()\n\n return storageSig\n}\n\n// ─── Storage Signal Factory ──────────────────────────────────────────────────\n\n/**\n * Wraps a base signal with storage persistence behavior.\n * Used by both useStorage and useSessionStorage.\n */\nexport function createStorageSignal<T>(\n sig: ReturnType<typeof signal<T>>,\n key: string,\n defaultValue: T,\n backend: 'local' | 'session',\n options?: StorageOptions<T>,\n): StorageSignal<T> {\n const storage = getWebStorage(backend)\n\n // The callable signal function (read)\n const storageSig = (() => sig()) as unknown as StorageSignal<T>\n\n // Delegate all signal methods\n storageSig.peek = () => sig.peek()\n storageSig.subscribe = (listener: () => void) => sig.subscribe(listener)\n storageSig.direct = (updater: () => void) => sig.direct(updater)\n storageSig.debug = () => sig.debug()\n\n Object.defineProperty(storageSig, 'label', {\n get: () => sig.label,\n set: (v: string | undefined) => {\n sig.label = v\n },\n })\n\n // Override set to persist\n storageSig.set = (value: T) => {\n sig.set(value)\n if (storage) {\n try {\n storage.setItem(key, serialize(value, options?.serializer))\n } catch {\n // Storage full or blocked — signal still updates\n }\n }\n }\n\n // Override update to persist\n storageSig.update = (fn: (current: T) => T) => {\n const newValue = fn(sig.peek())\n storageSig.set(newValue)\n }\n\n // Add remove method\n storageSig.remove = () => {\n sig.set(defaultValue)\n if (storage) {\n storage.removeItem(key)\n }\n removeEntry(backend, key)\n if (backend === 'local') {\n releaseStorageListener()\n }\n }\n\n return storageSig\n}\n","import { signal } from '@pyreon/reactivity'\nimport { createStorageSignal } from './local'\nimport { getEntry, setEntry } from './registry'\nimport type { StorageOptions, StorageSignal } from './types'\nimport { deserialize, getWebStorage } from './utils'\n\n// ─── useSessionStorage ───────────────────────────────────────────────────────\n\n/**\n * Reactive signal backed by sessionStorage. Scoped to the current\n * browser tab — does not sync across tabs.\n *\n * @example\n * ```ts\n * const step = useSessionStorage('wizard-step', 0)\n * step() // 0 (or stored value)\n * step.set(3) // updates signal + sessionStorage\n * step.remove() // clears storage, resets to default\n * ```\n */\nexport function useSessionStorage<T>(\n key: string,\n defaultValue: T,\n options?: StorageOptions<T>,\n): StorageSignal<T> {\n // Return existing signal if already registered\n const existing = getEntry<T>('session', key)\n if (existing) return existing.signal\n\n const storage = getWebStorage('session')\n\n // Read initial value from storage\n let initialValue = defaultValue\n if (storage) {\n const raw = storage.getItem(key)\n if (raw !== null) {\n initialValue = deserialize(raw, defaultValue, options?.deserializer, options?.onError)\n }\n }\n\n const sig = signal<T>(initialValue)\n const storageSig = createStorageSignal(sig, key, defaultValue, 'session', options)\n\n setEntry('session', key, storageSig, defaultValue)\n\n return storageSig\n}\n","import { getEntriesByBackend, getEntry, removeEntry } from './registry'\nimport { getWebStorage, isBrowser } from './utils'\n\n// ─── Storage type mapping ────────────────────────────────────────────────────\n\ntype StorageType = 'local' | 'session' | 'cookie' | 'indexeddb' | 'all'\n\n// ─── removeStorage ───────────────────────────────────────────────────────────\n\n/**\n * Remove a specific key from storage and reset its signal to the default value.\n *\n * @example\n * ```ts\n * removeStorage('theme') // from localStorage\n * removeStorage('step', { type: 'session' }) // from sessionStorage\n * removeStorage('locale', { type: 'cookie' }) // deletes cookie\n * ```\n */\nexport function removeStorage(\n key: string,\n options?: { type?: 'local' | 'session' | 'cookie' | 'indexeddb' },\n): void {\n const type = options?.type ?? 'local'\n const entry = getEntry(type, key)\n\n if (entry) {\n entry.signal.remove()\n } else {\n // No signal registered — still try to clear the raw storage\n if (type === 'local' || type === 'session') {\n const storage = getWebStorage(type)\n if (storage) storage.removeItem(key)\n } else if (type === 'cookie' && isBrowser()) {\n document.cookie = `${encodeURIComponent(key)}=; max-age=0; path=/`\n }\n removeEntry(type, key)\n }\n}\n\n// ─── clearStorage ────────────────────────────────────────────────────────────\n\n/**\n * Clear all managed storage entries for a specific backend, or all backends.\n *\n * @example\n * ```ts\n * clearStorage() // clear all localStorage entries managed by @pyreon/storage\n * clearStorage('session') // clear all sessionStorage entries\n * clearStorage('cookie') // clear all managed cookies\n * clearStorage('all') // clear everything\n * ```\n */\nexport function clearStorage(type: StorageType = 'local'): void {\n if (type === 'all') {\n clearBackend('local')\n clearBackend('session')\n clearBackend('cookie')\n clearBackend('indexeddb')\n return\n }\n\n clearBackend(type)\n}\n\nfunction clearBackend(type: string): void {\n const entries = getEntriesByBackend(type)\n for (const entry of entries) {\n entry.signal.remove()\n }\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/registry.ts","../src/utils.ts","../src/cookie.ts","../src/custom.ts","../src/indexed-db.ts","../src/local.ts","../src/session.ts","../src/clear.ts"],"sourcesContent":["import type { StorageSignal } from './types'\n\n// ─── Signal Registry ─────────────────────────────────────────────────────────\n\ninterface RegistryEntry<T = unknown> {\n signal: StorageSignal<T>\n defaultValue: T\n backend: string\n}\n\nconst registry = new Map<string, RegistryEntry>()\n\n/**\n * Build a composite key from backend type + storage key to avoid\n * collisions between different backends using the same key name.\n */\nfunction registryKey(backend: string, key: string): string {\n return `${backend}:${key}`\n}\n\n/**\n * Get an existing signal from the registry.\n */\nexport function getEntry<T>(backend: string, key: string): RegistryEntry<T> | undefined {\n return registry.get(registryKey(backend, key)) as RegistryEntry<T> | undefined\n}\n\n/**\n * Register a new signal in the registry.\n */\nexport function setEntry<T>(\n backend: string,\n key: string,\n signal: StorageSignal<T>,\n defaultValue: T,\n): void {\n registry.set(registryKey(backend, key), { signal, defaultValue, backend })\n}\n\n/**\n * Remove an entry from the registry.\n */\nexport function removeEntry(backend: string, key: string): void {\n registry.delete(registryKey(backend, key))\n}\n\n/**\n * Get all entries for a specific backend.\n */\nexport function getEntriesByBackend(backend: string): RegistryEntry[] {\n const entries: RegistryEntry[] = []\n for (const entry of registry.values()) {\n if (entry.backend === backend) entries.push(entry)\n }\n return entries\n}\n\n/**\n * Clear all entries from the registry. Used for testing.\n */\nexport function _resetRegistry(): void {\n registry.clear()\n}\n","import type { StorageOptions } from './types'\n\n// ─── SSR Detection ───────────────────────────────────────────────────────────\n\n/**\n * Check if we're running in a browser environment.\n */\nexport function isBrowser(): boolean {\n return typeof window !== 'undefined' && typeof document !== 'undefined'\n}\n\n// ─── Serialization ───────────────────────────────────────────────────────────\n\n/**\n * Serialize a value to a string for storage.\n */\nexport function serialize<T>(value: T, serializer?: StorageOptions<T>['serializer']): string {\n if (serializer) return serializer(value)\n return JSON.stringify(value)\n}\n\n/**\n * Deserialize a raw string from storage back to a typed value.\n * Returns the default value if deserialization fails.\n */\nexport function deserialize<T>(\n raw: string,\n defaultValue: T,\n deserializer?: StorageOptions<T>['deserializer'],\n onError?: StorageOptions<T>['onError'],\n): T {\n try {\n if (deserializer) return deserializer(raw)\n return JSON.parse(raw) as T\n } catch (e) {\n if (onError) {\n const result = onError(e as Error)\n return result !== undefined ? result : defaultValue\n }\n return defaultValue\n }\n}\n\n// ─── Safe Storage Access ─────────────────────────────────────────────────────\n\n/**\n * Safely get a Web Storage instance (localStorage or sessionStorage).\n * Returns null if not available (SSR, security restrictions, etc.).\n */\nexport function getWebStorage(type: 'local' | 'session'): Storage | null {\n if (!isBrowser()) return null\n try {\n const storage = type === 'local' ? window.localStorage : window.sessionStorage\n // Test that it actually works (can throw in private browsing)\n const testKey = '__pyreon_storage_test__'\n storage.setItem(testKey, '1')\n storage.removeItem(testKey)\n return storage\n } catch {\n return null\n }\n}\n","import { signal } from '@pyreon/reactivity'\nimport { getEntry, removeEntry, setEntry } from './registry'\nimport type { CookieOptions, StorageSignal } from './types'\nimport { deserialize, isBrowser, serialize } from './utils'\n\n// ─── Server-side cookie source ───────────────────────────────────────────────\n\nlet serverCookieString = ''\n\n/**\n * Set the cookie source string for SSR. Call this once per request\n * with the raw Cookie header value.\n *\n * @example\n * ```ts\n * // In your SSR request handler\n * setCookieSource(request.headers.get('cookie') ?? '')\n * ```\n */\nexport function setCookieSource(cookieHeader: string): void {\n serverCookieString = cookieHeader\n}\n\n// ─── Cookie parsing ──────────────────────────────────────────────────────────\n\nfunction parseCookies(cookieString: string): Map<string, string> {\n const cookies = new Map<string, string>()\n if (!cookieString) return cookies\n\n for (const pair of cookieString.split(';')) {\n const eqIndex = pair.indexOf('=')\n if (eqIndex === -1) continue\n const name = pair.slice(0, eqIndex).trim()\n const value = pair.slice(eqIndex + 1).trim()\n if (name) cookies.set(name, decodeURIComponent(value))\n }\n\n return cookies\n}\n\nfunction getCookieString(): string {\n if (isBrowser()) return document.cookie\n return serverCookieString\n}\n\nfunction readCookie(key: string): string | null {\n const cookies = parseCookies(getCookieString())\n return cookies.get(key) ?? null\n}\n\n// ─── Cookie writing ──────────────────────────────────────────────────────────\n\nfunction writeCookie<T>(key: string, value: T, options: CookieOptions<T>): void {\n if (!isBrowser()) return\n\n const serialized = serialize(value, options.serializer)\n let cookie = `${encodeURIComponent(key)}=${encodeURIComponent(serialized)}`\n\n if (options.maxAge !== undefined) {\n cookie += `; max-age=${options.maxAge}`\n }\n if (options.expires) {\n cookie += `; expires=${options.expires.toUTCString()}`\n }\n cookie += `; path=${options.path ?? '/'}`\n if (options.domain) {\n cookie += `; domain=${options.domain}`\n }\n if (options.secure) {\n cookie += '; secure'\n }\n cookie += `; samesite=${options.sameSite ?? 'lax'}`\n\n document.cookie = cookie\n}\n\nfunction deleteCookie<T>(key: string, options: CookieOptions<T>): void {\n if (!isBrowser()) return\n\n let cookie = `${encodeURIComponent(key)}=; max-age=0`\n cookie += `; path=${options.path ?? '/'}`\n if (options.domain) {\n cookie += `; domain=${options.domain}`\n }\n\n document.cookie = cookie\n}\n\n// ─── useCookie ───────────────────────────────────────────────────────────────\n\n/**\n * Reactive signal backed by a browser cookie. SSR-compatible when\n * used with setCookieSource().\n *\n * @example\n * ```ts\n * const locale = useCookie('locale', 'en', {\n * maxAge: 60 * 60 * 24 * 365, // 1 year\n * path: '/',\n * sameSite: 'lax',\n * })\n * locale() // 'en'\n * locale.set('de') // sets cookie + updates signal\n * locale.remove() // deletes cookie, resets to default\n * ```\n */\nexport function useCookie<T>(\n key: string,\n defaultValue: T,\n options: CookieOptions<T> = {},\n): StorageSignal<T> {\n // Return existing signal if already registered\n const existing = getEntry<T>('cookie', key)\n if (existing) return existing.signal\n\n // Read initial value from cookie\n const raw = readCookie(key)\n const initialValue =\n raw !== null\n ? deserialize(raw, defaultValue, options.deserializer, options.onError)\n : defaultValue\n\n const sig = signal<T>(initialValue)\n\n // Build the storage signal\n const storageSig = (() => sig()) as unknown as StorageSignal<T>\n\n storageSig.peek = () => sig.peek()\n storageSig.subscribe = (listener: () => void) => sig.subscribe(listener)\n storageSig.direct = (updater: () => void) => sig.direct(updater)\n storageSig.debug = () => sig.debug()\n\n Object.defineProperty(storageSig, 'label', {\n get: () => sig.label,\n set: (v: string | undefined) => {\n sig.label = v\n },\n })\n\n storageSig.set = (value: T) => {\n sig.set(value)\n writeCookie(key, value, options)\n }\n\n storageSig.update = (fn: (current: T) => T) => {\n const newValue = fn(sig.peek())\n storageSig.set(newValue)\n }\n\n storageSig.remove = () => {\n sig.set(defaultValue)\n deleteCookie(key, options)\n removeEntry('cookie', key)\n }\n\n setEntry('cookie', key, storageSig, defaultValue)\n\n return storageSig\n}\n","import { signal } from '@pyreon/reactivity'\nimport { getEntry, removeEntry, setEntry } from './registry'\nimport type { StorageBackend, StorageOptions, StorageSignal } from './types'\nimport { deserialize, serialize } from './utils'\n\n// ─── createStorage ───────────────────────────────────────────────────────────\n\n/**\n * Create a custom storage hook backed by any synchronous storage backend.\n * Useful for encrypted storage, in-memory storage, or custom adapters.\n *\n * @example\n * ```ts\n * const useEncrypted = createStorage({\n * get: (key) => decrypt(localStorage.getItem(key)),\n * set: (key, value) => localStorage.setItem(key, encrypt(value)),\n * remove: (key) => localStorage.removeItem(key),\n * })\n *\n * const secret = useEncrypted('api-key', '')\n * ```\n */\nexport function createStorage(\n backend: StorageBackend,\n backendName?: string,\n): <T>(key: string, defaultValue: T, options?: StorageOptions<T>) => StorageSignal<T> {\n const name = backendName ?? 'custom'\n\n return function useCustomStorage<T>(\n key: string,\n defaultValue: T,\n options?: StorageOptions<T>,\n ): StorageSignal<T> {\n // Return existing signal if already registered\n const existing = getEntry<T>(name, key)\n if (existing) return existing.signal\n\n // Read initial value\n let initialValue = defaultValue\n try {\n const raw = backend.get(key)\n if (raw !== null) {\n initialValue = deserialize(raw, defaultValue, options?.deserializer, options?.onError)\n }\n } catch {\n // Backend read failed — use default\n }\n\n const sig = signal<T>(initialValue)\n\n // Build the storage signal\n const storageSig = (() => sig()) as unknown as StorageSignal<T>\n\n storageSig.peek = () => sig.peek()\n storageSig.subscribe = (listener: () => void) => sig.subscribe(listener)\n storageSig.direct = (updater: () => void) => sig.direct(updater)\n storageSig.debug = () => sig.debug()\n\n Object.defineProperty(storageSig, 'label', {\n get: () => sig.label,\n set: (v: string | undefined) => {\n sig.label = v\n },\n })\n\n storageSig.set = (value: T) => {\n sig.set(value)\n try {\n backend.set(key, serialize(value, options?.serializer))\n } catch {\n // Write failed — signal still updates\n }\n }\n\n storageSig.update = (fn: (current: T) => T) => {\n const newValue = fn(sig.peek())\n storageSig.set(newValue)\n }\n\n storageSig.remove = () => {\n sig.set(defaultValue)\n try {\n backend.remove(key)\n } catch {\n // Remove failed\n }\n removeEntry(name, key)\n }\n\n setEntry(name, key, storageSig, defaultValue)\n\n return storageSig\n }\n}\n\n// ─── Memory storage ──────────────────────────────────────────────────────────\n\n/**\n * In-memory storage backend. Useful for SSR, testing, or ephemeral state.\n * Values are lost on page unload.\n *\n * @example\n * ```ts\n * import { useMemoryStorage } from '@pyreon/storage'\n *\n * const temp = useMemoryStorage('key', 'default')\n * ```\n */\nexport const useMemoryStorage = createStorage(\n (() => {\n const store = new Map<string, string>()\n return {\n get: (key: string) => store.get(key) ?? null,\n set: (key: string, value: string) => store.set(key, value),\n remove: (key: string) => store.delete(key),\n }\n })(),\n 'memory',\n)\n","import { signal } from '@pyreon/reactivity'\nimport { getEntry, removeEntry, setEntry } from './registry'\nimport type { IndexedDBOptions, StorageSignal } from './types'\nimport { deserialize, isBrowser, serialize } from './utils'\n\n// @ts-ignore — import.meta.env.DEV is Vite/Rolldown literal-replaced at build time\nconst __DEV__: boolean = import.meta.env?.DEV === true\n\n// ─── Database management ─────────────────────────────────────────────────────\n\nconst dbCache = new Map<string, Promise<IDBDatabase>>()\n\nfunction openDB(dbName: string, storeName: string): Promise<IDBDatabase> {\n if (typeof indexedDB === 'undefined') {\n return Promise.reject(new Error('[Pyreon] indexedDB is not available in this environment'))\n }\n const cacheKey = `${dbName}:${storeName}`\n const cached = dbCache.get(cacheKey)\n if (cached) return cached\n\n const promise = new Promise<IDBDatabase>((resolve, reject) => {\n const request = indexedDB.open(dbName, 1)\n\n request.onupgradeneeded = () => {\n const db = request.result\n if (!db.objectStoreNames.contains(storeName)) {\n db.createObjectStore(storeName)\n }\n }\n\n request.onsuccess = () => resolve(request.result)\n request.onerror = () => reject(request.error)\n })\n\n dbCache.set(cacheKey, promise)\n return promise\n}\n\nfunction idbGet(db: IDBDatabase, storeName: string, key: string): Promise<string | null> {\n return new Promise((resolve, reject) => {\n const tx = db.transaction(storeName, 'readonly')\n const store = tx.objectStore(storeName)\n const request = store.get(key)\n request.onsuccess = () =>\n resolve(request.result !== undefined ? (request.result as string) : null)\n request.onerror = () => reject(request.error)\n })\n}\n\nfunction idbSet(db: IDBDatabase, storeName: string, key: string, value: string): Promise<void> {\n return new Promise((resolve, reject) => {\n const tx = db.transaction(storeName, 'readwrite')\n const store = tx.objectStore(storeName)\n const request = store.put(value, key)\n request.onsuccess = () => resolve()\n request.onerror = () => reject(request.error)\n })\n}\n\nfunction idbDelete(db: IDBDatabase, storeName: string, key: string): Promise<void> {\n return new Promise((resolve, reject) => {\n const tx = db.transaction(storeName, 'readwrite')\n const store = tx.objectStore(storeName)\n const request = store.delete(key)\n request.onsuccess = () => resolve()\n request.onerror = () => reject(request.error)\n })\n}\n\n// ─── useIndexedDB ────────────────────────────────────────────────────────────\n\n/**\n * Reactive signal backed by IndexedDB. Suitable for large or structured\n * data that exceeds localStorage limits. Writes are debounced.\n *\n * The signal starts with `defaultValue` and updates asynchronously\n * when the stored value is read from IndexedDB.\n *\n * @example\n * ```ts\n * const draft = useIndexedDB('article-draft', { title: '', body: '' })\n * draft() // { title: '', body: '' } initially, then stored value\n * draft.set({ title: 'My Post', body: '...' }) // signal updates immediately, IDB write is debounced\n * ```\n */\nexport function useIndexedDB<T>(\n key: string,\n defaultValue: T,\n options: IndexedDBOptions<T> = {},\n): StorageSignal<T> {\n // Return existing signal if already registered\n const existing = getEntry<T>('indexeddb', key)\n if (existing) return existing.signal\n\n const dbName = options.dbName ?? 'pyreon-storage'\n const storeName = options.storeName ?? 'kv'\n const debounceMs = options.debounceMs ?? 100\n\n const sig = signal<T>(defaultValue)\n\n // Async initial load\n if (isBrowser() && typeof indexedDB !== 'undefined') {\n openDB(dbName, storeName)\n .then((db) => idbGet(db, storeName, key))\n .then((raw) => {\n if (raw !== null) {\n const value = deserialize(raw, defaultValue, options.deserializer, options.onError)\n sig.set(value)\n }\n })\n .catch((err) => {\n if (__DEV__) {\n // oxlint-disable-next-line no-console\n console.warn(`[Pyreon] IndexedDB \"${key}\" init failed, using default:`, err)\n }\n options.onError?.(err instanceof Error ? err : new Error(String(err)))\n })\n }\n\n // Debounced write\n let writeTimer: ReturnType<typeof setTimeout> | null = null\n let pendingValue: T | undefined\n\n function flushWrite(): void {\n if (pendingValue === undefined) return\n const value = pendingValue\n pendingValue = undefined\n\n if (!isBrowser() || typeof indexedDB === 'undefined') return\n\n openDB(dbName, storeName)\n .then((db) => idbSet(db, storeName, key, serialize(value, options.serializer)))\n .catch(() => {\n // Write failed — signal still has the correct value\n })\n }\n\n function scheduleWrite(value: T): void {\n pendingValue = value\n if (writeTimer !== null) clearTimeout(writeTimer)\n writeTimer = setTimeout(flushWrite, debounceMs)\n }\n\n // Build the storage signal\n const storageSig = (() => sig()) as unknown as StorageSignal<T>\n\n storageSig.peek = () => sig.peek()\n storageSig.subscribe = (listener: () => void) => sig.subscribe(listener)\n storageSig.direct = (updater: () => void) => sig.direct(updater)\n storageSig.debug = () => sig.debug()\n\n Object.defineProperty(storageSig, 'label', {\n get: () => sig.label,\n set: (v: string | undefined) => {\n sig.label = v\n },\n })\n\n storageSig.set = (value: T) => {\n sig.set(value)\n scheduleWrite(value)\n }\n\n storageSig.update = (fn: (current: T) => T) => {\n const newValue = fn(sig.peek())\n storageSig.set(newValue)\n }\n\n storageSig.remove = () => {\n sig.set(defaultValue)\n pendingValue = undefined\n if (writeTimer !== null) clearTimeout(writeTimer)\n\n if (isBrowser() && typeof indexedDB !== 'undefined') {\n openDB(dbName, storeName)\n .then((db) => idbDelete(db, storeName, key))\n .catch(() => {\n // Delete failed — signal already reset\n })\n }\n\n removeEntry('indexeddb', key)\n }\n\n setEntry('indexeddb', key, storageSig, defaultValue)\n\n return storageSig\n}\n\n/**\n * Reset the database cache. For testing only.\n */\nexport function _resetDBCache(): void {\n dbCache.clear()\n}\n","import { signal } from '@pyreon/reactivity'\nimport { getEntry, removeEntry, setEntry } from './registry'\nimport type { StorageOptions, StorageSignal } from './types'\nimport { deserialize, getWebStorage, isBrowser, serialize } from './utils'\n\n// ─── Cross-tab sync ──────────────────────────────────────────────────────────\n\n// Refcount the active localStorage signals so we can detach the `storage`\n// event listener when nothing subscribes anymore. Before the refcount, the\n// listener was attached on first `useStorage` and NEVER removed, leaking a\n// window-level handler across the lifetime of the page even after all\n// signals disposed via `.remove()`.\nlet activeCount = 0\nlet storageHandler: ((e: StorageEvent) => void) | null = null\n\nfunction onStorageEvent(e: StorageEvent): void {\n if (!e.key) return\n const entry = getEntry('local', e.key)\n if (!entry) return\n\n const newValue =\n e.newValue !== null ? deserialize(e.newValue, entry.defaultValue) : entry.defaultValue\n\n entry.signal.set(newValue)\n}\n\nfunction retainStorageListener(): void {\n if (!isBrowser()) return\n activeCount++\n if (storageHandler === null) {\n storageHandler = onStorageEvent\n window.addEventListener('storage', storageHandler)\n }\n}\n\n/**\n * Test-only: force-detach the cross-tab listener and reset the refcount.\n * Used in test teardown to keep `_resetRegistry` and listener state in sync.\n */\nexport function _resetStorageListener(): void {\n if (storageHandler !== null && isBrowser()) {\n window.removeEventListener('storage', storageHandler)\n }\n storageHandler = null\n activeCount = 0\n}\n\n/**\n * Release one refcount on the cross-tab listener. Detaches the window-level\n * handler when the count drops to zero. Called from `.remove()`.\n */\nexport function releaseStorageListener(): void {\n if (!isBrowser()) return\n if (activeCount === 0) return\n activeCount--\n if (activeCount === 0 && storageHandler !== null) {\n window.removeEventListener('storage', storageHandler)\n storageHandler = null\n }\n}\n\n// ─── useStorage ──────────────────────────────────────────────────────────────\n\n/**\n * Reactive signal backed by localStorage. Automatically syncs across\n * browser tabs via the native `storage` event.\n *\n * @example\n * ```ts\n * const theme = useStorage('theme', 'light')\n * theme() // 'light' (or stored value)\n * theme.set('dark') // updates signal + localStorage\n * theme.remove() // clears storage, resets to default\n * ```\n */\nexport function useStorage<T>(\n key: string,\n defaultValue: T,\n options?: StorageOptions<T>,\n): StorageSignal<T> {\n // Return existing signal if already registered\n const existing = getEntry<T>('local', key)\n if (existing) return existing.signal\n\n const storage = getWebStorage('local')\n\n // Read initial value from storage\n let initialValue = defaultValue\n if (storage) {\n const raw = storage.getItem(key)\n if (raw !== null) {\n initialValue = deserialize(raw, defaultValue, options?.deserializer, options?.onError)\n }\n }\n\n const sig = signal<T>(initialValue)\n\n // Create the storage signal by extending the base signal\n const storageSig = createStorageSignal(sig, key, defaultValue, 'local', options)\n\n setEntry('local', key, storageSig, defaultValue)\n retainStorageListener()\n\n return storageSig\n}\n\n// ─── Storage Signal Factory ──────────────────────────────────────────────────\n\n/**\n * Wraps a base signal with storage persistence behavior.\n * Used by both useStorage and useSessionStorage.\n */\nexport function createStorageSignal<T>(\n sig: ReturnType<typeof signal<T>>,\n key: string,\n defaultValue: T,\n backend: 'local' | 'session',\n options?: StorageOptions<T>,\n): StorageSignal<T> {\n const storage = getWebStorage(backend)\n\n // The callable signal function (read)\n const storageSig = (() => sig()) as unknown as StorageSignal<T>\n\n // Delegate all signal methods\n storageSig.peek = () => sig.peek()\n storageSig.subscribe = (listener: () => void) => sig.subscribe(listener)\n storageSig.direct = (updater: () => void) => sig.direct(updater)\n storageSig.debug = () => sig.debug()\n\n Object.defineProperty(storageSig, 'label', {\n get: () => sig.label,\n set: (v: string | undefined) => {\n sig.label = v\n },\n })\n\n // Override set to persist\n storageSig.set = (value: T) => {\n sig.set(value)\n if (storage) {\n try {\n storage.setItem(key, serialize(value, options?.serializer))\n } catch {\n // Storage full or blocked — signal still updates\n }\n }\n }\n\n // Override update to persist\n storageSig.update = (fn: (current: T) => T) => {\n const newValue = fn(sig.peek())\n storageSig.set(newValue)\n }\n\n // Add remove method\n storageSig.remove = () => {\n sig.set(defaultValue)\n if (storage) {\n storage.removeItem(key)\n }\n removeEntry(backend, key)\n if (backend === 'local') {\n releaseStorageListener()\n }\n }\n\n return storageSig\n}\n","import { signal } from '@pyreon/reactivity'\nimport { createStorageSignal } from './local'\nimport { getEntry, setEntry } from './registry'\nimport type { StorageOptions, StorageSignal } from './types'\nimport { deserialize, getWebStorage } from './utils'\n\n// ─── useSessionStorage ───────────────────────────────────────────────────────\n\n/**\n * Reactive signal backed by sessionStorage. Scoped to the current\n * browser tab — does not sync across tabs.\n *\n * @example\n * ```ts\n * const step = useSessionStorage('wizard-step', 0)\n * step() // 0 (or stored value)\n * step.set(3) // updates signal + sessionStorage\n * step.remove() // clears storage, resets to default\n * ```\n */\nexport function useSessionStorage<T>(\n key: string,\n defaultValue: T,\n options?: StorageOptions<T>,\n): StorageSignal<T> {\n // Return existing signal if already registered\n const existing = getEntry<T>('session', key)\n if (existing) return existing.signal\n\n const storage = getWebStorage('session')\n\n // Read initial value from storage\n let initialValue = defaultValue\n if (storage) {\n const raw = storage.getItem(key)\n if (raw !== null) {\n initialValue = deserialize(raw, defaultValue, options?.deserializer, options?.onError)\n }\n }\n\n const sig = signal<T>(initialValue)\n const storageSig = createStorageSignal(sig, key, defaultValue, 'session', options)\n\n setEntry('session', key, storageSig, defaultValue)\n\n return storageSig\n}\n","import { getEntriesByBackend, getEntry, removeEntry } from './registry'\nimport { getWebStorage, isBrowser } from './utils'\n\n// ─── Storage type mapping ────────────────────────────────────────────────────\n\ntype StorageType = 'local' | 'session' | 'cookie' | 'indexeddb' | 'all'\n\n// ─── removeStorage ───────────────────────────────────────────────────────────\n\n/**\n * Remove a specific key from storage and reset its signal to the default value.\n *\n * @example\n * ```ts\n * removeStorage('theme') // from localStorage\n * removeStorage('step', { type: 'session' }) // from sessionStorage\n * removeStorage('locale', { type: 'cookie' }) // deletes cookie\n * ```\n */\nexport function removeStorage(\n key: string,\n options?: { type?: 'local' | 'session' | 'cookie' | 'indexeddb' },\n): void {\n const type = options?.type ?? 'local'\n const entry = getEntry(type, key)\n\n if (entry) {\n entry.signal.remove()\n } else {\n // No signal registered — still try to clear the raw storage\n if (type === 'local' || type === 'session') {\n const storage = getWebStorage(type)\n if (storage) storage.removeItem(key)\n } else if (type === 'cookie' && isBrowser()) {\n document.cookie = `${encodeURIComponent(key)}=; max-age=0; path=/`\n }\n removeEntry(type, key)\n }\n}\n\n// ─── clearStorage ────────────────────────────────────────────────────────────\n\n/**\n * Clear all managed storage entries for a specific backend, or all backends.\n *\n * @example\n * ```ts\n * clearStorage() // clear all localStorage entries managed by @pyreon/storage\n * clearStorage('session') // clear all sessionStorage entries\n * clearStorage('cookie') // clear all managed cookies\n * clearStorage('all') // clear everything\n * ```\n */\nexport function clearStorage(type: StorageType = 'local'): void {\n if (type === 'all') {\n clearBackend('local')\n clearBackend('session')\n clearBackend('cookie')\n clearBackend('indexeddb')\n return\n }\n\n clearBackend(type)\n}\n\nfunction clearBackend(type: string): void {\n const entries = getEntriesByBackend(type)\n for (const entry of entries) {\n entry.signal.remove()\n }\n}\n"],"mappings":"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"}
|
package/lib/types/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index2.d.ts","names":[],"sources":["../../../src/types.ts","../../../src/cookie.ts","../../../src/custom.ts","../../../src/indexed-db.ts","../../../src/local.ts","../../../src/session.ts","../../../src/clear.ts","../../../src/registry.ts"],"mappings":";;;;;AAQA;;UAAiB,aAAA,YAAyB,MAAA,CAAO,CAAA;EAAD;EAE9C,MAAA;AAAA;;;;UAQe,cAAA;EAAA;EAEf,UAAA,IAAc,KAAA,EAAO,CAAA;EAFQ;EAI7B,YAAA,IAAgB,GAAA,aAAgB,CAAA;EAAA;EAEhC,OAAA,IAAW,KAAA,EAAO,KAAA,KAAU,CAAA;AAAA;;;;UAQb,aAAA,YAAyB,cAAA,CAAe,CAAA;EAZlC;EAcrB,MAAA;EAZA;EAcA,OAAA,GAAU,IAAA;EAdsB;EAgBhC,IAAA;EAdkB;EAgBlB,MAAA;EAhB4B;EAkB5B,MAAA;EAlB6B;EAoB7B,QAAA;AAAA;;;;UAQe,gBAAA,YAA4B,cAAA,CAAe,CAAA;EApBJ;EAsBtD,MAAA;EAtB6B;EAwB7B,SAAA;EAxBuD;EA0BvD,UAAA;AAAA;;;;UAQe,cAAA;EAtBf;EAwBA,GAAA,CAAI,GAAA;EAxBI;EA0BR,GAAA,CAAI,GAAA,UAAa,KAAA;EAlBc;EAoB/B,MAAA,CAAO,GAAA;AAAA;;;;UAMQ,mBAAA;EAtBf;EAwBA,GAAA,CAAI,GAAA,WAAc,OAAA;EAtBR;EAwBV,GAAA,CAAI,GAAA,UAAa,KAAA,WAAgB,OAAA;EAhBlB;EAkBf,MAAA,CAAO,GAAA,WAAc,OAAA;AAAA;;;;;AA5EvB;;;;;;;;iBCWgB,eAAA,CAAgB,YAAA;;ADDhC;;;;;;;;;;;;;;;iBCwFgB,SAAA,GAAA,CACd,GAAA,UACA,YAAA,EAAc,CAAA,EACd,OAAA,GAAS,aAAA,CAAc,CAAA,IACtB,aAAA,CAAc,CAAA;;;;;ADtGjB;;;;;;;;;;AAUA;;;iBEIgB,aAAA,CACd,OAAA,EAAS,cAAA,EACT,WAAA,gBACK,GAAA,UAAa,YAAA,EAAc,CAAA,EAAG,OAAA,GAAU,cAAA,CAAe,CAAA,MAAO,aAAA,CAAc,CAAA;;;;;;;;;;;;cAmFtE,gBAAA,MAnFR,GAAA,UAAa,YAAA,EAAgB,CAAA,EAAC,OAAA,GAAY,cAAA,CAAe,CAAA,MAAO,aAAA,CAAc,CAAA;;;;;AFjBnF;;;;;;;;;;AAUA;;
|
|
1
|
+
{"version":3,"file":"index2.d.ts","names":[],"sources":["../../../src/types.ts","../../../src/cookie.ts","../../../src/custom.ts","../../../src/indexed-db.ts","../../../src/local.ts","../../../src/session.ts","../../../src/clear.ts","../../../src/registry.ts"],"mappings":";;;;;AAQA;;UAAiB,aAAA,YAAyB,MAAA,CAAO,CAAA;EAAD;EAE9C,MAAA;AAAA;;;;UAQe,cAAA;EAAA;EAEf,UAAA,IAAc,KAAA,EAAO,CAAA;EAFQ;EAI7B,YAAA,IAAgB,GAAA,aAAgB,CAAA;EAAA;EAEhC,OAAA,IAAW,KAAA,EAAO,KAAA,KAAU,CAAA;AAAA;;;;UAQb,aAAA,YAAyB,cAAA,CAAe,CAAA;EAZlC;EAcrB,MAAA;EAZA;EAcA,OAAA,GAAU,IAAA;EAdsB;EAgBhC,IAAA;EAdkB;EAgBlB,MAAA;EAhB4B;EAkB5B,MAAA;EAlB6B;EAoB7B,QAAA;AAAA;;;;UAQe,gBAAA,YAA4B,cAAA,CAAe,CAAA;EApBJ;EAsBtD,MAAA;EAtB6B;EAwB7B,SAAA;EAxBuD;EA0BvD,UAAA;AAAA;;;;UAQe,cAAA;EAtBf;EAwBA,GAAA,CAAI,GAAA;EAxBI;EA0BR,GAAA,CAAI,GAAA,UAAa,KAAA;EAlBc;EAoB/B,MAAA,CAAO,GAAA;AAAA;;;;UAMQ,mBAAA;EAtBf;EAwBA,GAAA,CAAI,GAAA,WAAc,OAAA;EAtBR;EAwBV,GAAA,CAAI,GAAA,UAAa,KAAA,WAAgB,OAAA;EAhBlB;EAkBf,MAAA,CAAO,GAAA,WAAc,OAAA;AAAA;;;;;AA5EvB;;;;;;;;iBCWgB,eAAA,CAAgB,YAAA;;ADDhC;;;;;;;;;;;;;;;iBCwFgB,SAAA,GAAA,CACd,GAAA,UACA,YAAA,EAAc,CAAA,EACd,OAAA,GAAS,aAAA,CAAc,CAAA,IACtB,aAAA,CAAc,CAAA;;;;;ADtGjB;;;;;;;;;;AAUA;;;iBEIgB,aAAA,CACd,OAAA,EAAS,cAAA,EACT,WAAA,gBACK,GAAA,UAAa,YAAA,EAAc,CAAA,EAAG,OAAA,GAAU,cAAA,CAAe,CAAA,MAAO,aAAA,CAAc,CAAA;;;;;;;;;;;;cAmFtE,gBAAA,MAnFR,GAAA,UAAa,YAAA,EAAgB,CAAA,EAAC,OAAA,GAAY,cAAA,CAAe,CAAA,MAAO,aAAA,CAAc,CAAA;;;;;AFjBnF;;;;;;;;;;AAUA;;iBGmEgB,YAAA,GAAA,CACd,GAAA,UACA,YAAA,EAAc,CAAA,EACd,OAAA,GAAS,gBAAA,CAAiB,CAAA,IACzB,aAAA,CAAc,CAAA;;;;iBAuGD,aAAA,CAAA;;;;AHxLhB;;;iBI+BgB,qBAAA,CAAA;;AJrBhB;;;;;;;;;;;iBIyDgB,UAAA,GAAA,CACd,GAAA,UACA,YAAA,EAAc,CAAA,EACd,OAAA,GAAU,cAAA,CAAe,CAAA,IACxB,aAAA,CAAc,CAAA;;;;;AJvEjB;;;;;;;;;;iBKYgB,iBAAA,GAAA,CACd,GAAA,UACA,YAAA,EAAc,CAAA,EACd,OAAA,GAAU,cAAA,CAAe,CAAA,IACxB,aAAA,CAAc,CAAA;;;KCnBZ,WAAA;;;ANGL;;;;;;;;iBMWgB,aAAA,CACd,GAAA,UACA,OAAA;EAAY,IAAA;AAAA;;;;;;;;;;;;iBAgCE,YAAA,CAAa,IAAA,GAAM,WAAA;;;;;;iBCOnB,cAAA,CAAA"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pyreon/storage",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.13.1",
|
|
4
4
|
"description": "Reactive client-side storage for Pyreon — localStorage, sessionStorage, cookies, IndexedDB",
|
|
5
5
|
"homepage": "https://github.com/pyreon/pyreon/tree/main/packages/storage#readme",
|
|
6
6
|
"bugs": {
|
|
@@ -42,10 +42,12 @@
|
|
|
42
42
|
},
|
|
43
43
|
"devDependencies": {
|
|
44
44
|
"@happy-dom/global-registrator": "^20.8.9",
|
|
45
|
-
"@pyreon/
|
|
46
|
-
"@
|
|
45
|
+
"@pyreon/manifest": "0.13.1",
|
|
46
|
+
"@pyreon/reactivity": "^0.13.1",
|
|
47
|
+
"@vitus-labs/tools-lint": "^1.15.5",
|
|
48
|
+
"bun-types": "^1.3.12"
|
|
47
49
|
},
|
|
48
50
|
"peerDependencies": {
|
|
49
|
-
"@pyreon/reactivity": "^0.
|
|
51
|
+
"@pyreon/reactivity": "^0.13.1"
|
|
50
52
|
}
|
|
51
53
|
}
|
package/src/indexed-db.ts
CHANGED
|
@@ -3,6 +3,9 @@ import { getEntry, removeEntry, setEntry } from './registry'
|
|
|
3
3
|
import type { IndexedDBOptions, StorageSignal } from './types'
|
|
4
4
|
import { deserialize, isBrowser, serialize } from './utils'
|
|
5
5
|
|
|
6
|
+
// @ts-ignore — import.meta.env.DEV is Vite/Rolldown literal-replaced at build time
|
|
7
|
+
const __DEV__: boolean = import.meta.env?.DEV === true
|
|
8
|
+
|
|
6
9
|
// ─── Database management ─────────────────────────────────────────────────────
|
|
7
10
|
|
|
8
11
|
const dbCache = new Map<string, Promise<IDBDatabase>>()
|
|
@@ -105,8 +108,12 @@ export function useIndexedDB<T>(
|
|
|
105
108
|
sig.set(value)
|
|
106
109
|
}
|
|
107
110
|
})
|
|
108
|
-
.catch(() => {
|
|
109
|
-
|
|
111
|
+
.catch((err) => {
|
|
112
|
+
if (__DEV__) {
|
|
113
|
+
// oxlint-disable-next-line no-console
|
|
114
|
+
console.warn(`[Pyreon] IndexedDB "${key}" init failed, using default:`, err)
|
|
115
|
+
}
|
|
116
|
+
options.onError?.(err instanceof Error ? err : new Error(String(err)))
|
|
110
117
|
})
|
|
111
118
|
}
|
|
112
119
|
|
package/src/manifest.ts
ADDED
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
import { defineManifest } from '@pyreon/manifest'
|
|
2
|
+
|
|
3
|
+
export default defineManifest({
|
|
4
|
+
name: '@pyreon/storage',
|
|
5
|
+
title: 'Reactive Storage',
|
|
6
|
+
tagline:
|
|
7
|
+
'Reactive client-side storage — localStorage, sessionStorage, cookies, IndexedDB',
|
|
8
|
+
description:
|
|
9
|
+
'Signal-backed persistence for Pyreon. Every stored value is a reactive signal that persists writes automatically to the underlying storage backend. `useStorage` (localStorage, cross-tab synced), `useSessionStorage`, `useCookie` (SSR-readable, configurable expiry), `useIndexedDB` (large data, debounced writes), and `useMemoryStorage` (ephemeral, SSR-safe). All hooks return `StorageSignal<T>` which extends `Signal<T>` with `.remove()`. `createStorage(backend)` enables custom backends (encrypted, remote, etc.). SSR-safe — browser-API hooks return the default value on the server.',
|
|
10
|
+
category: 'universal',
|
|
11
|
+
longExample: `import { useStorage, useSessionStorage, useCookie, useIndexedDB, useMemoryStorage, createStorage } from '@pyreon/storage'
|
|
12
|
+
|
|
13
|
+
// localStorage — persistent, cross-tab synced via storage events:
|
|
14
|
+
const theme = useStorage('theme', 'light')
|
|
15
|
+
theme() // 'light' — reactive signal read
|
|
16
|
+
theme.set('dark') // updates signal + writes to localStorage
|
|
17
|
+
theme.remove() // removes from storage, resets to default
|
|
18
|
+
|
|
19
|
+
// sessionStorage — per-tab, cleared on tab close:
|
|
20
|
+
const filter = useSessionStorage('filter', { query: '', page: 1 })
|
|
21
|
+
filter.set({ query: 'search', page: 2 })
|
|
22
|
+
|
|
23
|
+
// Cookie — SSR-readable, configurable expiry:
|
|
24
|
+
const locale = useCookie('locale', 'en', {
|
|
25
|
+
maxAge: 365 * 86400, // 1 year
|
|
26
|
+
path: '/',
|
|
27
|
+
sameSite: 'lax',
|
|
28
|
+
})
|
|
29
|
+
|
|
30
|
+
// IndexedDB — large data, debounced writes:
|
|
31
|
+
const draft = useIndexedDB('article-draft', {
|
|
32
|
+
title: '',
|
|
33
|
+
body: '',
|
|
34
|
+
tags: [] as string[],
|
|
35
|
+
})
|
|
36
|
+
|
|
37
|
+
// Memory storage — ephemeral, SSR-safe fallback:
|
|
38
|
+
const temp = useMemoryStorage('temp-data', { count: 0 })
|
|
39
|
+
|
|
40
|
+
// Custom backend — encrypted, remote, etc.:
|
|
41
|
+
const encryptedBackend = {
|
|
42
|
+
getItem: (key: string) => decrypt(localStorage.getItem(key)),
|
|
43
|
+
setItem: (key: string, value: string) => localStorage.setItem(key, encrypt(value)),
|
|
44
|
+
removeItem: (key: string) => localStorage.removeItem(key),
|
|
45
|
+
}
|
|
46
|
+
const useEncrypted = createStorage(encryptedBackend)
|
|
47
|
+
const secret = useEncrypted('api-key', '')`,
|
|
48
|
+
features: [
|
|
49
|
+
'useStorage — localStorage-backed with cross-tab sync via storage events',
|
|
50
|
+
'useSessionStorage — per-tab ephemeral storage',
|
|
51
|
+
'useCookie — SSR-readable with configurable path, maxAge, sameSite',
|
|
52
|
+
'useIndexedDB — large data with debounced async writes',
|
|
53
|
+
'useMemoryStorage — in-memory fallback, SSR-safe',
|
|
54
|
+
'createStorage(backend) — factory for custom storage backends',
|
|
55
|
+
'StorageSignal<T> extends Signal<T> with .remove()',
|
|
56
|
+
],
|
|
57
|
+
api: [
|
|
58
|
+
{
|
|
59
|
+
name: 'useStorage',
|
|
60
|
+
kind: 'hook',
|
|
61
|
+
signature: '<T>(key: string, defaultValue: T, options?: StorageOptions<T>) => StorageSignal<T>',
|
|
62
|
+
summary:
|
|
63
|
+
'Create a reactive signal backed by localStorage. Reads the stored value on creation (falling back to `defaultValue` if absent or on SSR), writes on every `.set()`, and syncs across browser tabs via `storage` events. Returns `StorageSignal<T>` which extends `Signal<T>` with `.remove()` to delete the key and reset to default. Serialization defaults to JSON; provide custom `serialize`/`deserialize` in options for non-JSON types.',
|
|
64
|
+
example: `const theme = useStorage('theme', 'light')
|
|
65
|
+
theme() // 'light'
|
|
66
|
+
theme.set('dark') // persists + cross-tab sync
|
|
67
|
+
theme.remove() // delete from storage, reset to default`,
|
|
68
|
+
mistakes: [
|
|
69
|
+
'Expecting cross-tab sync with `useSessionStorage` — only `useStorage` (localStorage) fires storage events across tabs',
|
|
70
|
+
'Storing non-serializable values (functions, class instances) without custom `serialize`/`deserialize` — JSON.stringify drops them silently',
|
|
71
|
+
'Reading `.remove()` return value — it returns void, not the removed value',
|
|
72
|
+
],
|
|
73
|
+
seeAlso: ['useSessionStorage', 'useCookie', 'useIndexedDB', 'createStorage'],
|
|
74
|
+
},
|
|
75
|
+
{
|
|
76
|
+
name: 'useCookie',
|
|
77
|
+
kind: 'hook',
|
|
78
|
+
signature: '<T>(key: string, defaultValue: T, options?: CookieOptions) => StorageSignal<T>',
|
|
79
|
+
summary:
|
|
80
|
+
'Reactive signal backed by browser cookies. SSR-readable — on the server, reads from the request cookie header via `setCookieSource()`. Options include `maxAge`, `path`, `domain`, `sameSite`, `secure`. Same `StorageSignal<T>` return type as other hooks.',
|
|
81
|
+
example: `const locale = useCookie('locale', 'en', { maxAge: 365 * 86400, path: '/' })
|
|
82
|
+
locale.set('fr')`,
|
|
83
|
+
seeAlso: ['useStorage', 'setCookieSource'],
|
|
84
|
+
},
|
|
85
|
+
{
|
|
86
|
+
name: 'useIndexedDB',
|
|
87
|
+
kind: 'hook',
|
|
88
|
+
signature: '<T>(key: string, defaultValue: T, options?: IndexedDBOptions) => StorageSignal<T>',
|
|
89
|
+
summary:
|
|
90
|
+
'Reactive signal backed by IndexedDB for large data. Writes are debounced to avoid excessive I/O. The signal initializes with `defaultValue` synchronously and hydrates from IndexedDB asynchronously — the value updates reactively once the read completes. Silent init error logging in dev mode.',
|
|
91
|
+
example: `const draft = useIndexedDB('article-draft', { title: '', body: '' })
|
|
92
|
+
draft.set({ title: 'New Article', body: 'Content...' })`,
|
|
93
|
+
seeAlso: ['useStorage', 'useMemoryStorage'],
|
|
94
|
+
},
|
|
95
|
+
{
|
|
96
|
+
name: 'createStorage',
|
|
97
|
+
kind: 'function',
|
|
98
|
+
signature: '(backend: StorageBackend | AsyncStorageBackend) => <T>(key: string, defaultValue: T, options?: StorageOptions<T>) => StorageSignal<T>',
|
|
99
|
+
summary:
|
|
100
|
+
'Factory for custom storage backends. Pass an object with `getItem`, `setItem`, `removeItem` methods (sync or async) and receive a hook function with the same signature as `useStorage`. Use for encrypted storage, remote backends, or any custom persistence layer.',
|
|
101
|
+
example: `const useEncrypted = createStorage({
|
|
102
|
+
getItem: (key) => decrypt(localStorage.getItem(key)),
|
|
103
|
+
setItem: (key, value) => localStorage.setItem(key, encrypt(value)),
|
|
104
|
+
removeItem: (key) => localStorage.removeItem(key),
|
|
105
|
+
})
|
|
106
|
+
const secret = useEncrypted('api-key', '')`,
|
|
107
|
+
seeAlso: ['useStorage'],
|
|
108
|
+
},
|
|
109
|
+
],
|
|
110
|
+
gotchas: [
|
|
111
|
+
{
|
|
112
|
+
label: 'SSR safety',
|
|
113
|
+
note: 'Browser-backed hooks (`useStorage`, `useSessionStorage`, `useIndexedDB`) return the default value on the server. `useCookie` is SSR-readable via `setCookieSource()` which reads from the request headers.',
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
label: 'Cross-tab sync',
|
|
117
|
+
note: 'Only `useStorage` (localStorage) syncs across tabs via `storage` events. `useSessionStorage` is per-tab. Cookies and IndexedDB have no built-in cross-tab notification.',
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
label: 'IndexedDB async init',
|
|
121
|
+
note: 'The IndexedDB hook initializes synchronously with the default value, then hydrates asynchronously. Components reading the value in their first render see the default — the value updates reactively once the IDB read completes.',
|
|
122
|
+
},
|
|
123
|
+
],
|
|
124
|
+
})
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import {
|
|
2
|
+
renderApiReferenceEntries,
|
|
3
|
+
renderLlmsFullSection,
|
|
4
|
+
renderLlmsTxtLine,
|
|
5
|
+
} from '@pyreon/manifest'
|
|
6
|
+
import manifest from '../manifest'
|
|
7
|
+
|
|
8
|
+
describe('gen-docs — storage snapshot', () => {
|
|
9
|
+
it('renders to llms.txt bullet', () => {
|
|
10
|
+
expect(renderLlmsTxtLine(manifest)).toMatchInlineSnapshot(`"- @pyreon/storage — Reactive client-side storage — localStorage, sessionStorage, cookies, IndexedDB. Browser-backed hooks (\`useStorage\`, \`useSessionStorage\`, \`useIndexedDB\`) return the default value on the server. \`useCookie\` is SSR-readable via \`setCookieSource()\` which reads from the request headers."`)
|
|
11
|
+
})
|
|
12
|
+
|
|
13
|
+
it('renders to llms-full.txt section', () => {
|
|
14
|
+
expect(renderLlmsFullSection(manifest)).toMatchInlineSnapshot(`
|
|
15
|
+
"## @pyreon/storage — Reactive Storage
|
|
16
|
+
|
|
17
|
+
Signal-backed persistence for Pyreon. Every stored value is a reactive signal that persists writes automatically to the underlying storage backend. \`useStorage\` (localStorage, cross-tab synced), \`useSessionStorage\`, \`useCookie\` (SSR-readable, configurable expiry), \`useIndexedDB\` (large data, debounced writes), and \`useMemoryStorage\` (ephemeral, SSR-safe). All hooks return \`StorageSignal<T>\` which extends \`Signal<T>\` with \`.remove()\`. \`createStorage(backend)\` enables custom backends (encrypted, remote, etc.). SSR-safe — browser-API hooks return the default value on the server.
|
|
18
|
+
|
|
19
|
+
\`\`\`typescript
|
|
20
|
+
import { useStorage, useSessionStorage, useCookie, useIndexedDB, useMemoryStorage, createStorage } from '@pyreon/storage'
|
|
21
|
+
|
|
22
|
+
// localStorage — persistent, cross-tab synced via storage events:
|
|
23
|
+
const theme = useStorage('theme', 'light')
|
|
24
|
+
theme() // 'light' — reactive signal read
|
|
25
|
+
theme.set('dark') // updates signal + writes to localStorage
|
|
26
|
+
theme.remove() // removes from storage, resets to default
|
|
27
|
+
|
|
28
|
+
// sessionStorage — per-tab, cleared on tab close:
|
|
29
|
+
const filter = useSessionStorage('filter', { query: '', page: 1 })
|
|
30
|
+
filter.set({ query: 'search', page: 2 })
|
|
31
|
+
|
|
32
|
+
// Cookie — SSR-readable, configurable expiry:
|
|
33
|
+
const locale = useCookie('locale', 'en', {
|
|
34
|
+
maxAge: 365 * 86400, // 1 year
|
|
35
|
+
path: '/',
|
|
36
|
+
sameSite: 'lax',
|
|
37
|
+
})
|
|
38
|
+
|
|
39
|
+
// IndexedDB — large data, debounced writes:
|
|
40
|
+
const draft = useIndexedDB('article-draft', {
|
|
41
|
+
title: '',
|
|
42
|
+
body: '',
|
|
43
|
+
tags: [] as string[],
|
|
44
|
+
})
|
|
45
|
+
|
|
46
|
+
// Memory storage — ephemeral, SSR-safe fallback:
|
|
47
|
+
const temp = useMemoryStorage('temp-data', { count: 0 })
|
|
48
|
+
|
|
49
|
+
// Custom backend — encrypted, remote, etc.:
|
|
50
|
+
const encryptedBackend = {
|
|
51
|
+
getItem: (key: string) => decrypt(localStorage.getItem(key)),
|
|
52
|
+
setItem: (key: string, value: string) => localStorage.setItem(key, encrypt(value)),
|
|
53
|
+
removeItem: (key: string) => localStorage.removeItem(key),
|
|
54
|
+
}
|
|
55
|
+
const useEncrypted = createStorage(encryptedBackend)
|
|
56
|
+
const secret = useEncrypted('api-key', '')
|
|
57
|
+
\`\`\`
|
|
58
|
+
|
|
59
|
+
> **SSR safety**: Browser-backed hooks (\`useStorage\`, \`useSessionStorage\`, \`useIndexedDB\`) return the default value on the server. \`useCookie\` is SSR-readable via \`setCookieSource()\` which reads from the request headers.
|
|
60
|
+
>
|
|
61
|
+
> **Cross-tab sync**: Only \`useStorage\` (localStorage) syncs across tabs via \`storage\` events. \`useSessionStorage\` is per-tab. Cookies and IndexedDB have no built-in cross-tab notification.
|
|
62
|
+
>
|
|
63
|
+
> **IndexedDB async init**: The IndexedDB hook initializes synchronously with the default value, then hydrates asynchronously. Components reading the value in their first render see the default — the value updates reactively once the IDB read completes.
|
|
64
|
+
"
|
|
65
|
+
`)
|
|
66
|
+
})
|
|
67
|
+
|
|
68
|
+
it('renders to MCP api-reference entries', () => {
|
|
69
|
+
const record = renderApiReferenceEntries(manifest)
|
|
70
|
+
expect(Object.keys(record).length).toBe(4)
|
|
71
|
+
expect(record['storage/useStorage']!.notes).toContain('localStorage')
|
|
72
|
+
expect(record['storage/useStorage']!.mistakes?.split('\n').length).toBe(3)
|
|
73
|
+
})
|
|
74
|
+
})
|