菜单
Validate persisted state with Standard Schema (~standard) via withStandardSchema / withStandardSchemaAsync / createStandardSchemaStorage. Use for Zod/Yup (etc.) sync vs async lanes and PersistDecodeRethrowError.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.
| name | persist-standard-schema |
| description | Validate persisted state with Standard Schema (~standard) via withStandardSchema / withStandardSchemaAsync / createStandardSchemaStorage. Use for Zod/Yup (etc.) sync vs async lanes and PersistDecodeRethrowError. |
| license | MIT |
| metadata | {"type":"composition","library":"@stainless-code/persist","library_version":"0.4.1"} |
| requires | ["persist"] |
| sources | ["stainless-code/persist:src/adapters/codecs/standard-schema.ts","stainless-code/persist:apps/docs/content/recipes/standard-schema.mdx"] |
Types for ~standard are vendored — no runtime peer. Bring Zod / Yup / Valibot yourself.
Validates persisted state only (not envelope version / timestamp / buster). Encode writes schema output (defaults/transforms applied).
| API | When |
|---|---|
withStandardSchema / createStandardSchemaStorage | Sync validate (Zod ≥3.24 / v4 via ~standard) |
withStandardSchemaAsync / createStandardSchemaStorageAsync | Async validate (Yup, async Zod) |
Wrong lane: sync wrap + async schema → PersistDecodeRethrowError (rethrown; not clearCorrupt). Async lane → async hydrate → gate UI (react-persist, …).
Sync wrap is still Promise-aware for async backend getItem (e.g. IDB).
import { withStandardSchema } from "@stainless-code/persist/codecs/standard-schema";
import { createIdbStorage } from "@stainless-code/persist/backends/idb";
const storage = withStandardSchema(createIdbStorage<Prefs>()!, prefsSchema, {
clearCorruptOnFailure: true,
});
JSON sugar: createStandardSchemaStorage(() => localStorage, schema).
state.useHydrated on the async lane.standardSchemaCodec — double-validates; pick one.standardSchemaCodec(schema) · withStandardSchema / withStandardSchemaAsynccreateStandardSchemaStorage / createStandardSchemaStorageAsyncSee also: persist-idb for async backends.