Menu
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.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | persist-seroval |
| 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. |
| license | MIT |
| metadata | {"type":"composition","library":"@stainless-code/persist","library_version":"0.4.1","framework":"seroval"} |
| requires | ["persist"] |
| sources | ["stainless-code/persist:src/adapters/codecs/seroval.ts"] |
@stainless-code/persist/codecs/seroval round-trips values JSON cannot (Set/Map/Date) via seroval toJSON/fromJSON on string-wire backends (localStorage, etc.).
bun add @stainless-code/persist seroval
Peer: seroval >=1.0.0 (optional of this subpath).
import { createSerovalStorage } from "@stainless-code/persist/codecs/seroval";
const storage = createSerovalStorage<Prefs>(() => localStorage, {
clearCorruptOnFailure: true,
});
Or createStorage(getStorage, serovalCodec(), opts).
createJSONStorage for Set/Map/Date — they won't round-trip.persist-idb already uses structured clone / identityCodec.seroval peer.serovalCodec<S>() → StorageCodec<S>createSerovalStorage(getStorage, options?) → PersistStorage | undefinedSee also: persist-idb for structured-clone without seroval.
Gate Alpine.js UI on Persist hydration (Alpine.plugin + useHydrated / $hydrated). Use when wiring HydrationSignal into Alpine data components.
Gate Angular UI on Persist hydration with useHydrated (readonly Signal). Call inside an injection context; use when avoiding flash of default state on async backends.
Gate Lit element UI on Persist hydration with HydrationController. Use when wiring HydrationSignal into a ReactiveControllerHost; not a hook.
Persist with React Native AsyncStorage via @stainless-code/persist/backends/async-storage. Use for RN string-wire JSON state; always gate with useHydrated.
Compress a string-wire StateStorage with @stainless-code/persist/backends/compressed (gzip/deflate). Backend wrapper — compose with createStorage; stack compress-then-encrypt.
Cross-tab sync for backends without storage events via @stainless-code/persist/transport/crosstab (createBroadcastCrossTab). Wrap storage + pass crossTabEventTarget; call close() on teardown.