persist-seroval
Persist Set/Map/Date (and richer graphs) with @stainless-code/persist/codecs/seroval (serovalCodec / createSerovalStorage). Use when JSON.stringify would lose types on string-wire backends.
- License 许可
- MIT
- 最近更新
- 2026-11-01
- Stars
- ★ 5
- Forks
- 0
01 前言 Front Matter
- name
- persist-seroval
- license
- MIT
- sources
- [ "stainless-code/persist:src/adapters/codecs/seroval.ts" ]
- metadata
- { "type": "composition", "library": "@stainless-code/persist", "framework": "seroval", "library_version": "0.4.1" }
- requires
- [ "persist" ]
- description
- Persist Set/Map/Date (and richer graphs) with @stainless-code/persist/codecs/seroval (serovalCodec / createSerovalStorage). Use when JSON.stringify would lose types on string-wire backends.
03 SKILL.md 正文
Seroval codec
@stainless-code/persist/codecs/seroval round-trips values JSON cannot (Set/Map/Date) via seroval toJSON/fromJSON on string-wire backends (localStorage, etc.).
Install
bun add @stainless-code/persist seroval
Peer: seroval >=1.0.0 (optional of this subpath).
Minimal wiring
import { createSerovalStorage } from "@stainless-code/persist/codecs/seroval";
const storage = createSerovalStorage<Prefs>(() => localStorage, {
clearCorruptOnFailure: true,
});
Or createStorage(getStorage, serovalCodec(), opts).
Common mistakes
- Using
createJSONStoragefor Set/Map/Date — they won't round-trip. - Layering seroval on default IDB —
persist-idbalready uses structured clone /identityCodec. - Forgetting the
serovalpeer.
API surface
serovalCodec<S>() → StorageCodec<S>createSerovalStorage(getStorage, options?) → PersistStorage | undefined
See also: persist-idb for structured-clone without seroval.
04 同仓库更多 Skills
vue-persist
Gate Vue 3 UI on Persist hydration with useHydrated (shallowRef). Use in setup/effectScope when avoiding flash of default state on async backends.
svelte-store-persist
Gate Svelte store-based UI on Persist hydration with hydratedStore (Readable). Use for Svelte 3–4 or Svelte 5 apps that still use stores; runes UI → svelte-persist.
svelte-persist
Gate Svelte 5 runes UI on Persist hydration with hydratedRune (.current). Use for Svelte 5; for stores / Svelte 3–4 use svelte-store-persist.
solid-persist
Gate Solid UI on Persist hydration with useHydrated (Accessor). Use when avoiding flash of default state on async backends; read hydrated() in reactive scopes.
react-persist
Gate React UI on Persist hydration with useHydrated + toHydrationSignal. Use when avoiding flash of default state on async backends (IndexedDB), SSR snapshot true, or wiring HydrationSignal into React 18/19.
preact-persist
Gate Preact UI on Persist hydration with useHydrated (preact/compat useSyncExternalStore). Use when avoiding flash of default state on async backends or wiring HydrationSignal into Preact.