القائمة
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.