AGENT SKILL

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 createJSONStorage for Set/Map/Date — they won't round-trip.
  • Layering seroval on default IDB — persist-idb already uses structured clone / identityCodec.
  • Forgetting the seroval peer.

API surface

  • serovalCodec<S>() → StorageCodec<S>
  • createSerovalStorage(getStorage, options?) → PersistStorage | undefined

See also: persist-idb for structured-clone without seroval.

04 同仓库更多 Skills