everkit-state 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vladyslav Petrykov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# everkit-state
+
+Reusable client-state + persistence primitives for React Native / Expo apps. The storage backend is **injected**, so the core stays pure and testable outside a React Native runtime.
+
+## Exports
+
+- **`makeSecureStoreAdapter(api)`** → Zustand `StateStorage` — a thin, pass-through bridge from a SecureStore-shaped API (`getItemAsync`/`setItemAsync`/`deleteItemAsync`) to Zustand `persist`. Enforces the load-bearing contract: `getItem` resolves `null` (not `undefined`) on a miss and propagates errors; `removeItem` is idempotent.
+- **`makeSecureJsonStorage(api)`** — `createJSONStorage`-wrapped adapter; what `persist({ storage })` consumes. Lazy, so importing it doesn't touch the native store at boot.
+- **`createPreferencesSlice`** — a composable Zustand slice for the shared persisted shape: `theme` + `hasCompletedOnboarding` (+ setters). Spread into a bound store alongside app-specific runtime fields.
+- **`pickPersistedPreferences(state)`** — `partialize` helper: persists only `theme` + `hasCompletedOnboarding`, dropping actions and foreign fields.
+- **`ThemePreference`** — `'light' | 'dark' | 'system'` (owned here; re-exported by the theme package).
+
+## Peer dependencies
+
+- `zustand >= 5`
+
+## Test
+
+```sh
+npm test   # node --require sucrase/register --test "src/**/__tests__/**/*.test.ts"
+```

package/dist/commonjs/index.js

@@ -0,0 +1,28 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _secureStore = require("./secureStore.js");
+Object.keys(_secureStore).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _secureStore[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _secureStore[key];
+    }
+  });
+});
+var _preferences = require("./preferences.js");
+Object.keys(_preferences).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _preferences[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _preferences[key];
+    }
+  });
+});
+//# sourceMappingURL=index.js.map

package/dist/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_secureStore","require","Object","keys","forEach","key","exports","defineProperty","enumerable","get","_preferences"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAH,YAAA,EAAAI,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAL,YAAA,CAAAK,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAT,YAAA,CAAAK,GAAA;IAAA;EAAA;AAAA;AACA,IAAAK,YAAA,GAAAT,OAAA;AAAAC,MAAA,CAAAC,IAAA,CAAAO,YAAA,EAAAN,OAAA,WAAAC,GAAA;EAAA,IAAAA,GAAA,kBAAAA,GAAA;EAAA,IAAAA,GAAA,IAAAC,OAAA,IAAAA,OAAA,CAAAD,GAAA,MAAAK,YAAA,CAAAL,GAAA;EAAAH,MAAA,CAAAK,cAAA,CAAAD,OAAA,EAAAD,GAAA;IAAAG,UAAA;IAAAC,GAAA,WAAAA,CAAA;MAAA,OAAAC,YAAA,CAAAL,GAAA;IAAA;EAAA;AAAA","ignoreList":[]}

package/dist/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/commonjs/preferences.js

@@ -0,0 +1,55 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.createPreferencesSlice = void 0;
+exports.pickPersistedPreferences = pickPersistedPreferences;
+/**
+ * User-chosen theme mode. `'system'` defers to the OS appearance. This type
+ * is owned here (it backs the persisted preference); the theme-rendering
+ * package re-exports it so callers have a single source of truth.
+ */
+
+/**
+ * The slice of app state that is common to every app and persisted across a
+ * reload + reboot: the theme preference and the onboarding-completed flag.
+ * Apps compose this into their bound store alongside app-specific,
+ * runtime-only fields (auth session, bootstrap flags) which are NOT persisted.
+ */
+
+/**
+ * Zustand slice creator for the shared preferences. Spread it into a bound
+ * store:
+ *
+ *   create<AppState>()(persist((set, get, store) => ({
+ *     ...createPreferencesSlice(set, get, store),
+ *     // app-specific, runtime-only fields:
+ *     session: null,
+ *     setSession: (session) => set({ session }),
+ *   }), { name: 'app-store', storage, partialize: pickPersistedPreferences }))
+ */
+const createPreferencesSlice = set => ({
+  theme: 'light',
+  setTheme: pref => set({
+    theme: pref
+  }),
+  hasCompletedOnboarding: false,
+  setHasCompletedOnboarding: value => set({
+    hasCompletedOnboarding: value
+  })
+});
+
+/**
+ * `partialize` helper for `persist`: keep ONLY the persisted preference
+ * fields, dropping the action functions and any app-specific runtime fields
+ * (e.g. an auth session) that must never be written to disk.
+ */
+exports.createPreferencesSlice = createPreferencesSlice;
+function pickPersistedPreferences(state) {
+  return {
+    theme: state.theme,
+    hasCompletedOnboarding: state.hasCompletedOnboarding
+  };
+}
+//# sourceMappingURL=preferences.js.map

package/dist/commonjs/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createPreferencesSlice","set","theme","setTheme","pref","hasCompletedOnboarding","setHasCompletedOnboarding","value","exports","pickPersistedPreferences","state"],"sourceRoot":"../../src","sources":["preferences.ts"],"mappings":";;;;;;;AAEA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMA,sBAAgF,GAC3FC,GAAG,KACC;EACJC,KAAK,EAAE,OAAO;EACdC,QAAQ,EAAGC,IAAI,IAAKH,GAAG,CAAC;IAAEC,KAAK,EAAEE;EAAK,CAAC,CAAC;EACxCC,sBAAsB,EAAE,KAAK;EAC7BC,yBAAyB,EAAGC,KAAK,IAAKN,GAAG,CAAC;IAAEI,sBAAsB,EAAEE;EAAM,CAAC;AAC7E,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AAJAC,OAAA,CAAAR,sBAAA,GAAAA,sBAAA;AAKO,SAASS,wBAAwBA,CACtCC,KAAQ,EACoD;EAC5D,OAAO;IAAER,KAAK,EAAEQ,KAAK,CAACR,KAAK;IAAEG,sBAAsB,EAAEK,KAAK,CAACL;EAAuB,CAAC;AACrF","ignoreList":[]}

package/dist/commonjs/secureStore.js

@@ -0,0 +1,71 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.makeSecureJsonStorage = makeSecureJsonStorage;
+exports.makeSecureStoreAdapter = makeSecureStoreAdapter;
+var _middleware = require("zustand/middleware");
+/**
+ * Pure SecureStore -> Zustand `StateStorage` bridge.
+ *
+ * Apps persist Zustand stores through a secure key-value store (e.g.
+ * `expo-secure-store`) so preferences (theme, onboarding flag, pinned ids)
+ * survive a reload AND a device reboot. The wrapping is a one-liner per
+ * method, but the contract has two load-bearing rules worth pinning with a
+ * test:
+ *
+ *   1. `getItem` MUST resolve to `null` when the key is missing. Zustand
+ *      treats `null` as «no persisted state» and falls back to the store's
+ *      initial state. SecureStore's `getItemAsync` already returns `null`
+ *      for a missing key, so the adapter just passes it through — but we
+ *      want a regression guard against accidentally translating that to
+ *      `undefined`, an empty string, or a thrown error.
+ *
+ *   2. `removeItem` MUST be idempotent. Logging out clears the persisted
+ *      slice, and a second logout (or a logout-on-cold-start cleanup pass)
+ *      MUST NOT throw. SecureStore's `deleteItemAsync` is idempotent, so
+ *      again the adapter just passes it through.
+ *
+ * The store API is INJECTED rather than imported, so this module never
+ * touches a native module: the production call site passes the real
+ * `expo-secure-store` functions in; tests pass an in-memory fake. That keeps
+ * the adapter loadable (and testable) in plain Node, outside a React Native
+ * runtime.
+ */
+
+/**
+ * The subset of `expo-secure-store` (or any compatible secure key-value
+ * store) the adapter depends on. Only the three async functions Zustand's
+ * `StateStorage` needs — `setItemAsync`, `getItemAsync`, `deleteItemAsync`.
+ * Typed against the platform contract so a future SDK widening of the return
+ * type fails compilation here, not at runtime.
+ */
+
+/**
+ * Build the `StateStorage` Zustand expects from a SecureStore-shaped API.
+ *
+ * Kept as a thin pass-through on purpose: any logic added here (caching,
+ * error swallowing, value transforms) would silently change the persisted
+ * shape across all stores. If you need such behaviour, add a SECOND wrapper
+ * around this one and document it next to the store that uses it.
+ */
+function makeSecureStoreAdapter(api) {
+  return {
+    getItem: key => api.getItemAsync(key),
+    setItem: (key, value) => api.setItemAsync(key, value),
+    removeItem: key => api.deleteItemAsync(key)
+  };
+}
+
+/**
+ * `createJSONStorage`-wrapped adapter — what `persist({ storage })` actually
+ * consumes. The factory function is invoked lazily by Zustand on first
+ * read/write, so importing this module does NOT touch the secure store at app
+ * boot. That matters because a native secure store is unavailable during SSR
+ * and during the test runner's module load.
+ */
+function makeSecureJsonStorage(api) {
+  return (0, _middleware.createJSONStorage)(() => makeSecureStoreAdapter(api));
+}
+//# sourceMappingURL=secureStore.js.map

package/dist/commonjs/secureStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_middleware","require","makeSecureStoreAdapter","api","getItem","key","getItemAsync","setItem","value","setItemAsync","removeItem","deleteItemAsync","makeSecureJsonStorage","createJSONStorage"],"sourceRoot":"../../src","sources":["secureStore.ts"],"mappings":";;;;;;;AA4BA,IAAAA,WAAA,GAAAC,OAAA;AA5BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,sBAAsBA,CAACC,GAAmB,EAAgB;EACxE,OAAO;IACLC,OAAO,EAAGC,GAAW,IAAKF,GAAG,CAACG,YAAY,CAACD,GAAG,CAAC;IAC/CE,OAAO,EAAEA,CAACF,GAAW,EAAEG,KAAa,KAAKL,GAAG,CAACM,YAAY,CAACJ,GAAG,EAAEG,KAAK,CAAC;IACrEE,UAAU,EAAGL,GAAW,IAAKF,GAAG,CAACQ,eAAe,CAACN,GAAG;EACtD,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASO,qBAAqBA,CAACT,GAAmB,EAAE;EACzD,OAAO,IAAAU,6BAAiB,EAAC,MAAMX,sBAAsB,CAACC,GAAG,CAAC,CAAC;AAC7D","ignoreList":[]}

package/dist/module/index.js

@@ -0,0 +1,5 @@
+"use strict";
+
+export * from "./secureStore.js";
+export * from "./preferences.js";
+//# sourceMappingURL=index.js.map

package/dist/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,cAAc,kBAAe;AAC7B,cAAc,kBAAe","ignoreList":[]}

package/dist/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/module/preferences.js

@@ -0,0 +1,49 @@
+"use strict";
+
+/**
+ * User-chosen theme mode. `'system'` defers to the OS appearance. This type
+ * is owned here (it backs the persisted preference); the theme-rendering
+ * package re-exports it so callers have a single source of truth.
+ */
+
+/**
+ * The slice of app state that is common to every app and persisted across a
+ * reload + reboot: the theme preference and the onboarding-completed flag.
+ * Apps compose this into their bound store alongside app-specific,
+ * runtime-only fields (auth session, bootstrap flags) which are NOT persisted.
+ */
+
+/**
+ * Zustand slice creator for the shared preferences. Spread it into a bound
+ * store:
+ *
+ *   create<AppState>()(persist((set, get, store) => ({
+ *     ...createPreferencesSlice(set, get, store),
+ *     // app-specific, runtime-only fields:
+ *     session: null,
+ *     setSession: (session) => set({ session }),
+ *   }), { name: 'app-store', storage, partialize: pickPersistedPreferences }))
+ */
+export const createPreferencesSlice = set => ({
+  theme: 'light',
+  setTheme: pref => set({
+    theme: pref
+  }),
+  hasCompletedOnboarding: false,
+  setHasCompletedOnboarding: value => set({
+    hasCompletedOnboarding: value
+  })
+});
+
+/**
+ * `partialize` helper for `persist`: keep ONLY the persisted preference
+ * fields, dropping the action functions and any app-specific runtime fields
+ * (e.g. an auth session) that must never be written to disk.
+ */
+export function pickPersistedPreferences(state) {
+  return {
+    theme: state.theme,
+    hasCompletedOnboarding: state.hasCompletedOnboarding
+  };
+}
+//# sourceMappingURL=preferences.js.map

package/dist/module/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createPreferencesSlice","set","theme","setTheme","pref","hasCompletedOnboarding","setHasCompletedOnboarding","value","pickPersistedPreferences","state"],"sourceRoot":"../../src","sources":["preferences.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,sBAAgF,GAC3FC,GAAG,KACC;EACJC,KAAK,EAAE,OAAO;EACdC,QAAQ,EAAGC,IAAI,IAAKH,GAAG,CAAC;IAAEC,KAAK,EAAEE;EAAK,CAAC,CAAC;EACxCC,sBAAsB,EAAE,KAAK;EAC7BC,yBAAyB,EAAGC,KAAK,IAAKN,GAAG,CAAC;IAAEI,sBAAsB,EAAEE;EAAM,CAAC;AAC7E,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CACtCC,KAAQ,EACoD;EAC5D,OAAO;IAAEP,KAAK,EAAEO,KAAK,CAACP,KAAK;IAAEG,sBAAsB,EAAEI,KAAK,CAACJ;EAAuB,CAAC;AACrF","ignoreList":[]}

package/dist/module/secureStore.js

@@ -0,0 +1,67 @@
+"use strict";
+
+/**
+ * Pure SecureStore -> Zustand `StateStorage` bridge.
+ *
+ * Apps persist Zustand stores through a secure key-value store (e.g.
+ * `expo-secure-store`) so preferences (theme, onboarding flag, pinned ids)
+ * survive a reload AND a device reboot. The wrapping is a one-liner per
+ * method, but the contract has two load-bearing rules worth pinning with a
+ * test:
+ *
+ *   1. `getItem` MUST resolve to `null` when the key is missing. Zustand
+ *      treats `null` as «no persisted state» and falls back to the store's
+ *      initial state. SecureStore's `getItemAsync` already returns `null`
+ *      for a missing key, so the adapter just passes it through — but we
+ *      want a regression guard against accidentally translating that to
+ *      `undefined`, an empty string, or a thrown error.
+ *
+ *   2. `removeItem` MUST be idempotent. Logging out clears the persisted
+ *      slice, and a second logout (or a logout-on-cold-start cleanup pass)
+ *      MUST NOT throw. SecureStore's `deleteItemAsync` is idempotent, so
+ *      again the adapter just passes it through.
+ *
+ * The store API is INJECTED rather than imported, so this module never
+ * touches a native module: the production call site passes the real
+ * `expo-secure-store` functions in; tests pass an in-memory fake. That keeps
+ * the adapter loadable (and testable) in plain Node, outside a React Native
+ * runtime.
+ */
+
+import { createJSONStorage } from 'zustand/middleware';
+
+/**
+ * The subset of `expo-secure-store` (or any compatible secure key-value
+ * store) the adapter depends on. Only the three async functions Zustand's
+ * `StateStorage` needs — `setItemAsync`, `getItemAsync`, `deleteItemAsync`.
+ * Typed against the platform contract so a future SDK widening of the return
+ * type fails compilation here, not at runtime.
+ */
+
+/**
+ * Build the `StateStorage` Zustand expects from a SecureStore-shaped API.
+ *
+ * Kept as a thin pass-through on purpose: any logic added here (caching,
+ * error swallowing, value transforms) would silently change the persisted
+ * shape across all stores. If you need such behaviour, add a SECOND wrapper
+ * around this one and document it next to the store that uses it.
+ */
+export function makeSecureStoreAdapter(api) {
+  return {
+    getItem: key => api.getItemAsync(key),
+    setItem: (key, value) => api.setItemAsync(key, value),
+    removeItem: key => api.deleteItemAsync(key)
+  };
+}
+
+/**
+ * `createJSONStorage`-wrapped adapter — what `persist({ storage })` actually
+ * consumes. The factory function is invoked lazily by Zustand on first
+ * read/write, so importing this module does NOT touch the secure store at app
+ * boot. That matters because a native secure store is unavailable during SSR
+ * and during the test runner's module load.
+ */
+export function makeSecureJsonStorage(api) {
+  return createJSONStorage(() => makeSecureStoreAdapter(api));
+}
+//# sourceMappingURL=secureStore.js.map

package/dist/module/secureStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createJSONStorage","makeSecureStoreAdapter","api","getItem","key","getItemAsync","setItem","value","setItemAsync","removeItem","deleteItemAsync","makeSecureJsonStorage"],"sourceRoot":"../../src","sources":["secureStore.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,iBAAiB,QAA2B,oBAAoB;;AAEzE;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAACC,GAAmB,EAAgB;EACxE,OAAO;IACLC,OAAO,EAAGC,GAAW,IAAKF,GAAG,CAACG,YAAY,CAACD,GAAG,CAAC;IAC/CE,OAAO,EAAEA,CAACF,GAAW,EAAEG,KAAa,KAAKL,GAAG,CAACM,YAAY,CAACJ,GAAG,EAAEG,KAAK,CAAC;IACrEE,UAAU,EAAGL,GAAW,IAAKF,GAAG,CAACQ,eAAe,CAACN,GAAG;EACtD,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,qBAAqBA,CAACT,GAAmB,EAAE;EACzD,OAAOF,iBAAiB,CAAC,MAAMC,sBAAsB,CAACC,GAAG,CAAC,CAAC;AAC7D","ignoreList":[]}

package/dist/typescript/commonjs/index.d.ts

@@ -0,0 +1,3 @@
+export * from './secureStore';
+export * from './preferences';
+//# sourceMappingURL=index.d.ts.map

package/dist/typescript/commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA"}

package/dist/typescript/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/typescript/commonjs/preferences.d.ts

@@ -0,0 +1,38 @@
+import type { StateCreator } from 'zustand';
+/**
+ * User-chosen theme mode. `'system'` defers to the OS appearance. This type
+ * is owned here (it backs the persisted preference); the theme-rendering
+ * package re-exports it so callers have a single source of truth.
+ */
+export type ThemePreference = 'light' | 'dark' | 'system';
+/**
+ * The slice of app state that is common to every app and persisted across a
+ * reload + reboot: the theme preference and the onboarding-completed flag.
+ * Apps compose this into their bound store alongside app-specific,
+ * runtime-only fields (auth session, bootstrap flags) which are NOT persisted.
+ */
+export interface PreferencesSlice {
+    theme: ThemePreference;
+    setTheme: (pref: ThemePreference) => void;
+    hasCompletedOnboarding: boolean;
+    setHasCompletedOnboarding: (value: boolean) => void;
+}
+/**
+ * Zustand slice creator for the shared preferences. Spread it into a bound
+ * store:
+ *
+ *   create<AppState>()(persist((set, get, store) => ({
+ *     ...createPreferencesSlice(set, get, store),
+ *     // app-specific, runtime-only fields:
+ *     session: null,
+ *     setSession: (session) => set({ session }),
+ *   }), { name: 'app-store', storage, partialize: pickPersistedPreferences }))
+ */
+export declare const createPreferencesSlice: StateCreator<PreferencesSlice, [], [], PreferencesSlice>;
+/**
+ * `partialize` helper for `persist`: keep ONLY the persisted preference
+ * fields, dropping the action functions and any app-specific runtime fields
+ * (e.g. an auth session) that must never be written to disk.
+ */
+export declare function pickPersistedPreferences<S extends PreferencesSlice>(state: S): Pick<PreferencesSlice, 'theme' | 'hasCompletedOnboarding'>;
+//# sourceMappingURL=preferences.d.ts.map

package/dist/typescript/commonjs/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../../src/preferences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,CAAA;IACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;IACzC,sBAAsB,EAAE,OAAO,CAAA;IAC/B,yBAAyB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACpD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAAY,CAAC,gBAAgB,EAAE,EAAE,EAAE,EAAE,EAAE,gBAAgB,CAO1F,CAAA;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,gBAAgB,EACjE,KAAK,EAAE,CAAC,GACP,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,wBAAwB,CAAC,CAE5D"}

package/dist/typescript/commonjs/secureStore.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Pure SecureStore -> Zustand `StateStorage` bridge.
+ *
+ * Apps persist Zustand stores through a secure key-value store (e.g.
+ * `expo-secure-store`) so preferences (theme, onboarding flag, pinned ids)
+ * survive a reload AND a device reboot. The wrapping is a one-liner per
+ * method, but the contract has two load-bearing rules worth pinning with a
+ * test:
+ *
+ *   1. `getItem` MUST resolve to `null` when the key is missing. Zustand
+ *      treats `null` as «no persisted state» and falls back to the store's
+ *      initial state. SecureStore's `getItemAsync` already returns `null`
+ *      for a missing key, so the adapter just passes it through — but we
+ *      want a regression guard against accidentally translating that to
+ *      `undefined`, an empty string, or a thrown error.
+ *
+ *   2. `removeItem` MUST be idempotent. Logging out clears the persisted
+ *      slice, and a second logout (or a logout-on-cold-start cleanup pass)
+ *      MUST NOT throw. SecureStore's `deleteItemAsync` is idempotent, so
+ *      again the adapter just passes it through.
+ *
+ * The store API is INJECTED rather than imported, so this module never
+ * touches a native module: the production call site passes the real
+ * `expo-secure-store` functions in; tests pass an in-memory fake. That keeps
+ * the adapter loadable (and testable) in plain Node, outside a React Native
+ * runtime.
+ */
+import { type StateStorage } from 'zustand/middleware';
+/**
+ * The subset of `expo-secure-store` (or any compatible secure key-value
+ * store) the adapter depends on. Only the three async functions Zustand's
+ * `StateStorage` needs — `setItemAsync`, `getItemAsync`, `deleteItemAsync`.
+ * Typed against the platform contract so a future SDK widening of the return
+ * type fails compilation here, not at runtime.
+ */
+export interface SecureStoreApi {
+    getItemAsync: (key: string) => Promise<string | null>;
+    setItemAsync: (key: string, value: string) => Promise<void>;
+    deleteItemAsync: (key: string) => Promise<void>;
+}
+/**
+ * Build the `StateStorage` Zustand expects from a SecureStore-shaped API.
+ *
+ * Kept as a thin pass-through on purpose: any logic added here (caching,
+ * error swallowing, value transforms) would silently change the persisted
+ * shape across all stores. If you need such behaviour, add a SECOND wrapper
+ * around this one and document it next to the store that uses it.
+ */
+export declare function makeSecureStoreAdapter(api: SecureStoreApi): StateStorage;
+/**
+ * `createJSONStorage`-wrapped adapter — what `persist({ storage })` actually
+ * consumes. The factory function is invoked lazily by Zustand on first
+ * read/write, so importing this module does NOT touch the secure store at app
+ * boot. That matters because a native secure store is unavailable during SSR
+ * and during the test runner's module load.
+ */
+export declare function makeSecureJsonStorage(api: SecureStoreApi): import("zustand/middleware").PersistStorage<unknown, unknown> | undefined;
+//# sourceMappingURL=secureStore.d.ts.map

package/dist/typescript/commonjs/secureStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secureStore.d.ts","sourceRoot":"","sources":["../../../src/secureStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACrD,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,GAAG,YAAY,CAMxE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,6EAExD"}

package/dist/typescript/module/index.d.ts

@@ -0,0 +1,3 @@
+export * from './secureStore.js';
+export * from './preferences.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/typescript/module/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAe,CAAA;AAC7B,cAAc,kBAAe,CAAA"}

package/dist/typescript/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/typescript/module/preferences.d.ts

@@ -0,0 +1,38 @@
+import type { StateCreator } from 'zustand';
+/**
+ * User-chosen theme mode. `'system'` defers to the OS appearance. This type
+ * is owned here (it backs the persisted preference); the theme-rendering
+ * package re-exports it so callers have a single source of truth.
+ */
+export type ThemePreference = 'light' | 'dark' | 'system';
+/**
+ * The slice of app state that is common to every app and persisted across a
+ * reload + reboot: the theme preference and the onboarding-completed flag.
+ * Apps compose this into their bound store alongside app-specific,
+ * runtime-only fields (auth session, bootstrap flags) which are NOT persisted.
+ */
+export interface PreferencesSlice {
+    theme: ThemePreference;
+    setTheme: (pref: ThemePreference) => void;
+    hasCompletedOnboarding: boolean;
+    setHasCompletedOnboarding: (value: boolean) => void;
+}
+/**
+ * Zustand slice creator for the shared preferences. Spread it into a bound
+ * store:
+ *
+ *   create<AppState>()(persist((set, get, store) => ({
+ *     ...createPreferencesSlice(set, get, store),
+ *     // app-specific, runtime-only fields:
+ *     session: null,
+ *     setSession: (session) => set({ session }),
+ *   }), { name: 'app-store', storage, partialize: pickPersistedPreferences }))
+ */
+export declare const createPreferencesSlice: StateCreator<PreferencesSlice, [], [], PreferencesSlice>;
+/**
+ * `partialize` helper for `persist`: keep ONLY the persisted preference
+ * fields, dropping the action functions and any app-specific runtime fields
+ * (e.g. an auth session) that must never be written to disk.
+ */
+export declare function pickPersistedPreferences<S extends PreferencesSlice>(state: S): Pick<PreferencesSlice, 'theme' | 'hasCompletedOnboarding'>;
+//# sourceMappingURL=preferences.d.ts.map

package/dist/typescript/module/preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.d.ts","sourceRoot":"","sources":["../../../src/preferences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEzD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,CAAA;IACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;IACzC,sBAAsB,EAAE,OAAO,CAAA;IAC/B,yBAAyB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACpD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,sBAAsB,EAAE,YAAY,CAAC,gBAAgB,EAAE,EAAE,EAAE,EAAE,EAAE,gBAAgB,CAO1F,CAAA;AAEF;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,gBAAgB,EACjE,KAAK,EAAE,CAAC,GACP,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,wBAAwB,CAAC,CAE5D"}

package/dist/typescript/module/secureStore.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Pure SecureStore -> Zustand `StateStorage` bridge.
+ *
+ * Apps persist Zustand stores through a secure key-value store (e.g.
+ * `expo-secure-store`) so preferences (theme, onboarding flag, pinned ids)
+ * survive a reload AND a device reboot. The wrapping is a one-liner per
+ * method, but the contract has two load-bearing rules worth pinning with a
+ * test:
+ *
+ *   1. `getItem` MUST resolve to `null` when the key is missing. Zustand
+ *      treats `null` as «no persisted state» and falls back to the store's
+ *      initial state. SecureStore's `getItemAsync` already returns `null`
+ *      for a missing key, so the adapter just passes it through — but we
+ *      want a regression guard against accidentally translating that to
+ *      `undefined`, an empty string, or a thrown error.
+ *
+ *   2. `removeItem` MUST be idempotent. Logging out clears the persisted
+ *      slice, and a second logout (or a logout-on-cold-start cleanup pass)
+ *      MUST NOT throw. SecureStore's `deleteItemAsync` is idempotent, so
+ *      again the adapter just passes it through.
+ *
+ * The store API is INJECTED rather than imported, so this module never
+ * touches a native module: the production call site passes the real
+ * `expo-secure-store` functions in; tests pass an in-memory fake. That keeps
+ * the adapter loadable (and testable) in plain Node, outside a React Native
+ * runtime.
+ */
+import { type StateStorage } from 'zustand/middleware';
+/**
+ * The subset of `expo-secure-store` (or any compatible secure key-value
+ * store) the adapter depends on. Only the three async functions Zustand's
+ * `StateStorage` needs — `setItemAsync`, `getItemAsync`, `deleteItemAsync`.
+ * Typed against the platform contract so a future SDK widening of the return
+ * type fails compilation here, not at runtime.
+ */
+export interface SecureStoreApi {
+    getItemAsync: (key: string) => Promise<string | null>;
+    setItemAsync: (key: string, value: string) => Promise<void>;
+    deleteItemAsync: (key: string) => Promise<void>;
+}
+/**
+ * Build the `StateStorage` Zustand expects from a SecureStore-shaped API.
+ *
+ * Kept as a thin pass-through on purpose: any logic added here (caching,
+ * error swallowing, value transforms) would silently change the persisted
+ * shape across all stores. If you need such behaviour, add a SECOND wrapper
+ * around this one and document it next to the store that uses it.
+ */
+export declare function makeSecureStoreAdapter(api: SecureStoreApi): StateStorage;
+/**
+ * `createJSONStorage`-wrapped adapter — what `persist({ storage })` actually
+ * consumes. The factory function is invoked lazily by Zustand on first
+ * read/write, so importing this module does NOT touch the secure store at app
+ * boot. That matters because a native secure store is unavailable during SSR
+ * and during the test runner's module load.
+ */
+export declare function makeSecureJsonStorage(api: SecureStoreApi): import("zustand/middleware").PersistStorage<unknown, unknown> | undefined;
+//# sourceMappingURL=secureStore.d.ts.map

package/dist/typescript/module/secureStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secureStore.d.ts","sourceRoot":"","sources":["../../../src/secureStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEzE;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACrD,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3D,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAChD;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,cAAc,GAAG,YAAY,CAMxE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,cAAc,6EAExD"}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "everkit-state",
+  "version": "0.1.0",
+  "description": "Reusable client-state + persistence primitives for React Native / Expo apps: a SecureStore-to-Zustand StateStorage adapter and a composable preferences (theme + onboarding) slice. The storage backend is injected by the consumer, so the core stays pure and testable outside a React Native runtime.",
+  "private": false,
+  "license": "MIT",
+  "author": "Vladyslav Petrykov",
+  "keywords": [
+    "react-native",
+    "expo",
+    "zustand",
+    "secure-store",
+    "state",
+    "persistence"
+  ],
+  "source": "./src/index.ts",
+  "main": "./dist/commonjs/index.js",
+  "module": "./dist/module/index.js",
+  "types": "./dist/typescript/commonjs/index.d.ts",
+  "react-native": "./dist/module/index.js",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "import": {
+        "types": "./dist/typescript/module/index.d.ts",
+        "default": "./dist/module/index.js"
+      },
+      "require": {
+        "types": "./dist/typescript/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "package.json",
+    "!**/__tests__",
+    "!**/*.test.ts"
+  ],
+  "scripts": {
+    "build": "bob build",
+    "prepare": "bob build",
+    "typecheck": "tsc --noEmit",
+    "test": "node --require sucrase/register --test \"src/**/__tests__/**/*.test.ts\"",
+    "test:watch": "node --watch --require sucrase/register --test \"src/**/__tests__/**/*.test.ts\"",
+    "clean": "rm -rf dist"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "dist",
+    "exclude": "{**/{__tests__,__fixtures__,__mocks__}/**,**/*.test.ts,**/*.d.ts}",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true,
+          "configFile": false,
+          "babelrc": false
+        }
+      ],
+      [
+        "commonjs",
+        {
+          "esm": true,
+          "configFile": false,
+          "babelrc": false
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "peerDependencies": {
+    "zustand": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.29.0",
+    "@types/node": "^22.10.0",
+    "react-native-builder-bob": "^0.42.1",
+    "sucrase": "^3.35.1",
+    "typescript": "~5.9.2",
+    "zustand": "^5.0.11"
+  }
+}