stroid 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stroid",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Named-store state engine for JavaScript/React with optional persistence, async caching, sync, and devtools.",
   "keywords": [
     "state-management",
@@ -56,6 +56,14 @@
       "types": "./dist/async.d.ts",
       "import": "./dist/async.js"
     },
+    "./feature": {
+      "types": "./dist/feature.d.ts",
+      "import": "./dist/feature.js"
+    },
+    "./install": {
+      "types": "./dist/install.d.ts",
+      "import": "./dist/install.js"
+    },
     "./persist": {
       "types": "./dist/persist.d.ts",
       "import": "./dist/persist.js"
@@ -102,8 +110,8 @@
     "./dist/devtools.js"
   ],
   "scripts": {
-    "test": "node --import ./tests/preload.mjs --import tsx --import ./tests/setup.ts --test tests/async-cleanup.test.ts tests/async-revalidate-cleanup.test.ts tests/async.test.ts tests/computed.test.ts tests/helpers.test.ts tests/options-adapter.test.ts tests/persist.test.ts tests/react-hooks.test.tsx tests/regressions.test.ts tests/selectors-devfreeze.test.ts tests/ssr-carrier.test.ts tests/store.core.test.ts tests/store.node-env.test.ts tests/strict-missing-features.test.ts tests/sync.core.test.ts tests/testing.test.ts tests/utils.test.ts",
-    "test:coverage": "c8 --check-coverage --lines 80 --branches 80 --functions 80 --statements 80 node --import ./tests/preload.mjs --import tsx --import ./tests/setup.ts --test tests/async-cleanup.test.ts tests/async-revalidate-cleanup.test.ts tests/async.test.ts tests/computed.test.ts tests/helpers.test.ts tests/options-adapter.test.ts tests/persist.test.ts tests/react-hooks.test.tsx tests/regressions.test.ts tests/selectors-devfreeze.test.ts tests/ssr-carrier.test.ts tests/store.core.test.ts tests/store.node-env.test.ts tests/strict-missing-features.test.ts tests/sync.core.test.ts tests/testing.test.ts tests/utils.test.ts",
+    "test": "node --import ./tests/preload.mjs --import tsx --import ./tests/setup.ts --test tests/async-cleanup.test.ts tests/async-revalidate-cleanup.test.ts tests/async.test.ts tests/computed.test.ts tests/coverage-extra.test.ts tests/feature-api.test.ts tests/helpers.test.ts tests/options-adapter.test.ts tests/persist.test.ts tests/react-hooks.test.tsx tests/regressions.test.ts tests/selectors-devfreeze.test.ts tests/ssr-carrier.test.ts tests/store.core.test.ts tests/store.node-env.test.ts tests/strict-missing-features.test.ts tests/sync.core.test.ts tests/testing.test.ts tests/utils.test.ts",
+    "test:coverage": "c8 --check-coverage --lines 80 --branches 80 --functions 80 --statements 80 node --import ./tests/preload.mjs --import tsx --import ./tests/setup.ts --test tests/async-cleanup.test.ts tests/async-revalidate-cleanup.test.ts tests/async.test.ts tests/computed.test.ts tests/coverage-extra.test.ts tests/feature-api.test.ts tests/helpers.test.ts tests/options-adapter.test.ts tests/persist.test.ts tests/react-hooks.test.tsx tests/regressions.test.ts tests/selectors-devfreeze.test.ts tests/ssr-carrier.test.ts tests/store.core.test.ts tests/store.node-env.test.ts tests/strict-missing-features.test.ts tests/sync.core.test.ts tests/testing.test.ts tests/utils.test.ts",
     "test:heavy": "node --import tsx --test tests/heavy/store.heavy.ts",
     "test:types": "npm run build && tsc -p tsconfig.typetests.json",
     "typecheck": "tsc -p tsconfig.types.json",
@@ -118,6 +126,7 @@
     "react": ">=18"
   },
   "devDependencies": {
+    "@microsoft/api-extractor": "^7.57.7",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.2.0",
     "@types/node": "^22.9.0",

package/dist/async-cache-DFHwcBQL.d.cts

@@ -1,52 +0,0 @@
-type AsyncStateSnapshot = {
-    data?: unknown;
-    loading: boolean;
-    error: string | null;
-    status: "idle" | "loading" | "success" | "error" | "aborted";
-    cached?: boolean;
-    revalidating?: boolean;
-};
-type AsyncStateAdapter = (ctx: {
-    name: string;
-    prev: unknown;
-    next: AsyncStateSnapshot;
-    set: (value: unknown | ((draft: any) => void)) => void;
-}) => void;
-interface FetchOptions {
-    transform?: (result: unknown) => unknown;
-    onSuccess?: (data: unknown) => void;
-    onError?: (message: string) => void;
-    /**
-     * Optional adapter to write async state into a custom store shape.
-     * When provided, default AsyncState writes are skipped.
-     */
-    stateAdapter?: AsyncStateAdapter;
-    method?: string;
-    headers?: Record<string, string>;
-    body?: unknown;
-    ttl?: number;
-    staleWhileRevalidate?: boolean;
-    dedupe?: boolean;
-    retry?: number;
-    retryDelay?: number;
-    retryBackoff?: number;
-    signal?: AbortSignal;
-    cacheKey?: string;
-    responseType?: "auto" | "json" | "text" | "arrayBuffer" | "blob" | "formData";
-    /**
-     * Auto-create the backing store if missing.
-     * Defaults to the global config setting (true by default).
-     */
-    autoCreate?: boolean;
-    /**
-     * Clone strategy for transformed results.
-     * - "none" (default): store by reference.
-     * - "shallow": shallow clone objects/arrays.
-     * - "deep": deep clone objects/arrays.
-     */
-    cloneResult?: "none" | "shallow" | "deep";
-}
-
-type FetchInput = string | Promise<unknown> | (() => string | Promise<unknown>);
-
-export type { AsyncStateAdapter as A, FetchOptions as F, FetchInput as a, AsyncStateSnapshot as b };

package/dist/async-cache-DFHwcBQL.d.ts

@@ -1,52 +0,0 @@
-type AsyncStateSnapshot = {
-    data?: unknown;
-    loading: boolean;
-    error: string | null;
-    status: "idle" | "loading" | "success" | "error" | "aborted";
-    cached?: boolean;
-    revalidating?: boolean;
-};
-type AsyncStateAdapter = (ctx: {
-    name: string;
-    prev: unknown;
-    next: AsyncStateSnapshot;
-    set: (value: unknown | ((draft: any) => void)) => void;
-}) => void;
-interface FetchOptions {
-    transform?: (result: unknown) => unknown;
-    onSuccess?: (data: unknown) => void;
-    onError?: (message: string) => void;
-    /**
-     * Optional adapter to write async state into a custom store shape.
-     * When provided, default AsyncState writes are skipped.
-     */
-    stateAdapter?: AsyncStateAdapter;
-    method?: string;
-    headers?: Record<string, string>;
-    body?: unknown;
-    ttl?: number;
-    staleWhileRevalidate?: boolean;
-    dedupe?: boolean;
-    retry?: number;
-    retryDelay?: number;
-    retryBackoff?: number;
-    signal?: AbortSignal;
-    cacheKey?: string;
-    responseType?: "auto" | "json" | "text" | "arrayBuffer" | "blob" | "formData";
-    /**
-     * Auto-create the backing store if missing.
-     * Defaults to the global config setting (true by default).
-     */
-    autoCreate?: boolean;
-    /**
-     * Clone strategy for transformed results.
-     * - "none" (default): store by reference.
-     * - "shallow": shallow clone objects/arrays.
-     * - "deep": deep clone objects/arrays.
-     */
-    cloneResult?: "none" | "shallow" | "deep";
-}
-
-type FetchInput = string | Promise<unknown> | (() => string | Promise<unknown>);
-
-export type { AsyncStateAdapter as A, FetchOptions as F, FetchInput as a, AsyncStateSnapshot as b };

package/dist/computed-BbAZm1Dq.d.cts

@@ -1,17 +0,0 @@
-import { S as StoreName, a as StoreDefinition, b as StoreValue, c as StoreKey, d as StateFor } from './types-grvlY4BX.cjs';
-
-type ComputedOptions = {
-    autoDispose?: boolean;
-    onError?: (err: unknown) => void;
-};
-type DepHandle = StoreDefinition<string, StoreValue> | StoreKey<string, StoreValue>;
-type DepValue<T> = T extends StoreDefinition<string, infer S> ? Readonly<S> | null : T extends StoreKey<string, infer S> ? Readonly<S> | null : T extends StoreName ? Readonly<StateFor<T>> | null : StoreValue | null;
-declare function createComputed<TResult, Deps extends readonly (StoreName | DepHandle)[]>(name: string, deps: Deps, compute: (...args: {
-    [K in keyof Deps]: DepValue<Deps[K]>;
-}) => TResult, options?: ComputedOptions): StoreDefinition<string, TResult> | undefined;
-declare const invalidateComputed: (name: string) => void;
-declare const deleteComputed: (name: string) => void;
-declare const isComputedStore: (name: string) => boolean;
-declare const _resetComputedForTests: () => void;
-
-export { _resetComputedForTests as _, isComputedStore as a, createComputed as c, deleteComputed as d, invalidateComputed as i };

package/dist/computed-CccdgY5j.d.ts

@@ -1,17 +0,0 @@
-import { S as StoreName, a as StoreDefinition, b as StoreValue, c as StoreKey, d as StateFor } from './types-grvlY4BX.js';
-
-type ComputedOptions = {
-    autoDispose?: boolean;
-    onError?: (err: unknown) => void;
-};
-type DepHandle = StoreDefinition<string, StoreValue> | StoreKey<string, StoreValue>;
-type DepValue<T> = T extends StoreDefinition<string, infer S> ? Readonly<S> | null : T extends StoreKey<string, infer S> ? Readonly<S> | null : T extends StoreName ? Readonly<StateFor<T>> | null : StoreValue | null;
-declare function createComputed<TResult, Deps extends readonly (StoreName | DepHandle)[]>(name: string, deps: Deps, compute: (...args: {
-    [K in keyof Deps]: DepValue<Deps[K]>;
-}) => TResult, options?: ComputedOptions): StoreDefinition<string, TResult> | undefined;
-declare const invalidateComputed: (name: string) => void;
-declare const deleteComputed: (name: string) => void;
-declare const isComputedStore: (name: string) => boolean;
-declare const _resetComputedForTests: () => void;
-
-export { _resetComputedForTests as _, isComputedStore as a, createComputed as c, deleteComputed as d, invalidateComputed as i };

package/dist/options-CB35e3Xo.d.cts

@@ -1,245 +0,0 @@
-type StoreValue = unknown;
-interface PersistDriver {
-    getItem?: (k: string) => string | null | Promise<string | null>;
-    setItem?: (k: string, v: string) => void | Promise<void>;
-    removeItem?: (k: string) => void | Promise<void>;
-    [key: string]: unknown;
-}
-type StoreScope = "request" | "global" | "temp";
-type SnapshotMode = "deep" | "shallow" | "ref";
-type ValidateFn<State = StoreValue> = (next: State) => boolean | State;
-type SchemaValidateOption = {
-    safeParse: (value: unknown) => {
-        success: true;
-        data: unknown;
-    } | {
-        success: false;
-        error?: unknown;
-    };
-} | {
-    parse: (value: unknown) => unknown;
-} | {
-    validateSync: (value: unknown) => unknown;
-} | {
-    isValidSync: (value: unknown) => boolean;
-} | {
-    validate: (value: unknown) => unknown;
-};
-type ValidateOption<State = StoreValue> = ValidateFn<State> | SchemaValidateOption;
-interface PersistOptions<State = StoreValue> {
-    driver?: PersistDriver;
-    storage?: PersistDriver;
-    key?: string;
-    serialize?: (v: unknown) => string;
-    deserialize?: (v: string) => unknown;
-    /**
-     * Optional encryption hook for persisted payloads.
-     *
-     * Default is identity (no encryption). Data is stored in plaintext.
-     */
-    encrypt?: (v: string) => string;
-    /**
-     * Optional async encryption hook for persisted payloads.
-     *
-     * When provided, persistence will encrypt in the background and hydrate asynchronously.
-     */
-    encryptAsync?: (v: string) => Promise<string>;
-    /**
-     * Optional decryption hook for persisted payloads.
-     *
-     * Default is identity (no encryption). Data is stored in plaintext.
-     */
-    decrypt?: (v: string) => string;
-    /**
-     * Optional async decryption hook for persisted payloads.
-     *
-     * When provided, persistence will hydrate asynchronously after store creation.
-     */
-    decryptAsync?: (v: string) => Promise<string>;
-    /**
-     * Explicitly allow plaintext persistence when encrypt/decrypt are identity.
-     *
-     * In production builds, plaintext persistence is blocked unless this is true.
-     */
-    allowPlaintext?: boolean;
-    /**
-     * Marks this store's persisted data as sensitive (secrets/PII).
-     *
-     * When `true`, stroid throws at store creation time unless a non-identity
-     * `encrypt` hook is provided.
-     */
-    sensitiveData?: boolean;
-    /**
-     * Integrity check mode for persisted payloads.
-     * - "hash" (default): store and validate a checksum.
-     * - "none": skip checksum generation/validation.
-     * - "sha256": store a SHA-256 hash for stronger tamper detection (may be async in browsers).
-     */
-    checksum?: "hash" | "none" | "sha256";
-    version?: number;
-    migrations?: Record<number, (state: State) => State>;
-    onMigrationFail?: "reset" | "keep" | ((state: unknown) => unknown);
-    onStorageCleared?: (info: {
-        name: string;
-        key: string;
-        reason: "clear" | "remove" | "missing";
-    }) => void;
-}
-interface PersistConfig {
-    driver: PersistDriver;
-    key: string;
-    serialize: (v: unknown) => string;
-    deserialize: (v: string) => unknown;
-    encrypt: (v: string) => string;
-    decrypt: (v: string) => string;
-    encryptAsync?: (v: string) => Promise<string>;
-    decryptAsync?: (v: string) => Promise<string>;
-    allowPlaintext?: boolean;
-    sensitiveData?: boolean;
-    checksum: "hash" | "none" | "sha256";
-    onMigrationFail?: "reset" | "keep" | ((state: unknown) => unknown);
-    onStorageCleared?: (info: {
-        name: string;
-        key: string;
-        reason: "clear" | "remove" | "missing";
-    }) => void;
-}
-interface MiddlewareCtx {
-    action: string;
-    name: string;
-    prev: StoreValue;
-    next: StoreValue;
-    path: unknown;
-}
-interface SyncOptions {
-    channel?: string;
-    maxPayloadBytes?: number;
-    /**
-     * Optional shared token for lightweight cross-tab authentication.
-     * When set, incoming sync messages without a matching token are rejected.
-     */
-    authToken?: string;
-    conflictResolver?: (args: {
-        local: StoreValue;
-        incoming: StoreValue;
-        localUpdated: number;
-        incomingUpdated: number;
-    }) => StoreValue | void;
-    /**
-     * Optional checksum mode for sync payloads.
-     * - "hash" (default): include a checksum of the payload.
-     * - "none": skip checksum generation.
-     */
-    checksum?: "hash" | "none";
-    /**
-     * Optional signer for sync payloads. The returned value is attached to the message as `auth`.
-     */
-    sign?: (payload: SyncMessage) => unknown;
-    /**
-     * Optional verifier for incoming sync payloads.
-     * Return true to accept the message, false to reject it.
-     */
-    verify?: (payload: SyncMessage) => boolean;
-    /**
-     * Optional resolver for updatedAt timestamps when conflicts are resolved.
-     */
-    resolveUpdatedAt?: (args: {
-        localUpdated: number;
-        incomingUpdated: number | undefined;
-        now: number;
-    }) => number;
-}
-type SyncMessage = {
-    v: number;
-    protocol: number;
-    type: "sync-request" | "sync-state";
-    name: string;
-    clock: number;
-    source: string;
-    updatedAt?: number;
-    data?: StoreValue;
-    checksum?: number | null;
-    auth?: unknown;
-    token?: string;
-    requestedAt?: number;
-};
-interface DevtoolsOptions<State = StoreValue> {
-    enabled?: boolean;
-    historyLimit?: number;
-    redactor?: (state: State) => State;
-}
-interface LifecycleOptions<State = StoreValue> {
-    middleware?: Array<(ctx: MiddlewareCtx) => StoreValue | void>;
-    onSet?: (prev: State, next: State) => void;
-    onReset?: (prev: State, next: State) => void;
-    onDelete?: (prev: State) => void;
-    onCreate?: (initial: State) => void;
-}
-interface StoreOptions<State = StoreValue> {
-    scope?: StoreScope;
-    lazy?: boolean;
-    /**
-     * Allow `setStore(name, path, value)` to create missing **leaf** keys on object nodes.
-     *
-     * Default: `false` (strict path writes).
-     *
-     * Notes:
-     * - Does not expand arrays (out-of-bounds indices are still rejected).
-     * - Does not create missing intermediate objects for deep paths; define the shape up-front.
-     */
-    pathCreate?: boolean;
-    validate?: ValidateOption<State>;
-    persist?: boolean | string | PersistOptions<State>;
-    devtools?: boolean | DevtoolsOptions<State>;
-    lifecycle?: LifecycleOptions<State>;
-    middleware?: Array<(ctx: MiddlewareCtx) => StoreValue | void>;
-    onSet?: (prev: State, next: State) => void;
-    onReset?: (prev: State, next: State) => void;
-    onDelete?: (prev: State) => void;
-    onCreate?: (initial: State) => void;
-    onError?: (err: string) => void;
-    /** @deprecated use validate instead */
-    validator?: (next: State) => boolean;
-    /** @deprecated use validate instead */
-    schema?: unknown;
-    migrations?: Record<number, (state: State) => State>;
-    version?: number;
-    redactor?: (state: State) => State;
-    historyLimit?: number;
-    allowSSRGlobalStore?: boolean;
-    sync?: boolean | SyncOptions;
-    /**
-     * Snapshot cloning strategy used by subscriptions and selector snapshots.
-     *
-     * - "deep" (default): deep clone and dev-freeze snapshot values.
-     * - "shallow": shallow clone (top-level) only; nested references are shared.
-     * - "ref": return the live store reference (no cloning).
-     */
-    snapshot?: SnapshotMode;
-}
-interface NormalizedOptions {
-    scope: StoreScope;
-    lazy: boolean;
-    pathCreate: boolean;
-    persist: PersistConfig | null;
-    devtools: boolean;
-    middleware: Array<(ctx: MiddlewareCtx) => StoreValue | void>;
-    onSet?: (prev: StoreValue, next: StoreValue) => void;
-    onReset?: (prev: StoreValue, next: StoreValue) => void;
-    onDelete?: (prev: StoreValue) => void;
-    onCreate?: (initial: StoreValue) => void;
-    onError?: (err: string) => void;
-    validate?: ValidateOption;
-    migrations: Record<number, (state: any) => any>;
-    version: number;
-    redactor?: (state: StoreValue) => StoreValue;
-    historyLimit: number;
-    allowSSRGlobalStore?: boolean;
-    sync?: boolean | SyncOptions;
-    snapshot: SnapshotMode;
-    explicitPersist: boolean;
-    explicitSync: boolean;
-    explicitDevtools: boolean;
-}
-
-export type { MiddlewareCtx as M, NormalizedOptions as N, PersistOptions as P, StoreOptions as S, StoreValue as a, SnapshotMode as b, SyncOptions as c };

package/dist/options-CB35e3Xo.d.ts

@@ -1,245 +0,0 @@
-type StoreValue = unknown;
-interface PersistDriver {
-    getItem?: (k: string) => string | null | Promise<string | null>;
-    setItem?: (k: string, v: string) => void | Promise<void>;
-    removeItem?: (k: string) => void | Promise<void>;
-    [key: string]: unknown;
-}
-type StoreScope = "request" | "global" | "temp";
-type SnapshotMode = "deep" | "shallow" | "ref";
-type ValidateFn<State = StoreValue> = (next: State) => boolean | State;
-type SchemaValidateOption = {
-    safeParse: (value: unknown) => {
-        success: true;
-        data: unknown;
-    } | {
-        success: false;
-        error?: unknown;
-    };
-} | {
-    parse: (value: unknown) => unknown;
-} | {
-    validateSync: (value: unknown) => unknown;
-} | {
-    isValidSync: (value: unknown) => boolean;
-} | {
-    validate: (value: unknown) => unknown;
-};
-type ValidateOption<State = StoreValue> = ValidateFn<State> | SchemaValidateOption;
-interface PersistOptions<State = StoreValue> {
-    driver?: PersistDriver;
-    storage?: PersistDriver;
-    key?: string;
-    serialize?: (v: unknown) => string;
-    deserialize?: (v: string) => unknown;
-    /**
-     * Optional encryption hook for persisted payloads.
-     *
-     * Default is identity (no encryption). Data is stored in plaintext.
-     */
-    encrypt?: (v: string) => string;
-    /**
-     * Optional async encryption hook for persisted payloads.
-     *
-     * When provided, persistence will encrypt in the background and hydrate asynchronously.
-     */
-    encryptAsync?: (v: string) => Promise<string>;
-    /**
-     * Optional decryption hook for persisted payloads.
-     *
-     * Default is identity (no encryption). Data is stored in plaintext.
-     */
-    decrypt?: (v: string) => string;
-    /**
-     * Optional async decryption hook for persisted payloads.
-     *
-     * When provided, persistence will hydrate asynchronously after store creation.
-     */
-    decryptAsync?: (v: string) => Promise<string>;
-    /**
-     * Explicitly allow plaintext persistence when encrypt/decrypt are identity.
-     *
-     * In production builds, plaintext persistence is blocked unless this is true.
-     */
-    allowPlaintext?: boolean;
-    /**
-     * Marks this store's persisted data as sensitive (secrets/PII).
-     *
-     * When `true`, stroid throws at store creation time unless a non-identity
-     * `encrypt` hook is provided.
-     */
-    sensitiveData?: boolean;
-    /**
-     * Integrity check mode for persisted payloads.
-     * - "hash" (default): store and validate a checksum.
-     * - "none": skip checksum generation/validation.
-     * - "sha256": store a SHA-256 hash for stronger tamper detection (may be async in browsers).
-     */
-    checksum?: "hash" | "none" | "sha256";
-    version?: number;
-    migrations?: Record<number, (state: State) => State>;
-    onMigrationFail?: "reset" | "keep" | ((state: unknown) => unknown);
-    onStorageCleared?: (info: {
-        name: string;
-        key: string;
-        reason: "clear" | "remove" | "missing";
-    }) => void;
-}
-interface PersistConfig {
-    driver: PersistDriver;
-    key: string;
-    serialize: (v: unknown) => string;
-    deserialize: (v: string) => unknown;
-    encrypt: (v: string) => string;
-    decrypt: (v: string) => string;
-    encryptAsync?: (v: string) => Promise<string>;
-    decryptAsync?: (v: string) => Promise<string>;
-    allowPlaintext?: boolean;
-    sensitiveData?: boolean;
-    checksum: "hash" | "none" | "sha256";
-    onMigrationFail?: "reset" | "keep" | ((state: unknown) => unknown);
-    onStorageCleared?: (info: {
-        name: string;
-        key: string;
-        reason: "clear" | "remove" | "missing";
-    }) => void;
-}
-interface MiddlewareCtx {
-    action: string;
-    name: string;
-    prev: StoreValue;
-    next: StoreValue;
-    path: unknown;
-}
-interface SyncOptions {
-    channel?: string;
-    maxPayloadBytes?: number;
-    /**
-     * Optional shared token for lightweight cross-tab authentication.
-     * When set, incoming sync messages without a matching token are rejected.
-     */
-    authToken?: string;
-    conflictResolver?: (args: {
-        local: StoreValue;
-        incoming: StoreValue;
-        localUpdated: number;
-        incomingUpdated: number;
-    }) => StoreValue | void;
-    /**
-     * Optional checksum mode for sync payloads.
-     * - "hash" (default): include a checksum of the payload.
-     * - "none": skip checksum generation.
-     */
-    checksum?: "hash" | "none";
-    /**
-     * Optional signer for sync payloads. The returned value is attached to the message as `auth`.
-     */
-    sign?: (payload: SyncMessage) => unknown;
-    /**
-     * Optional verifier for incoming sync payloads.
-     * Return true to accept the message, false to reject it.
-     */
-    verify?: (payload: SyncMessage) => boolean;
-    /**
-     * Optional resolver for updatedAt timestamps when conflicts are resolved.
-     */
-    resolveUpdatedAt?: (args: {
-        localUpdated: number;
-        incomingUpdated: number | undefined;
-        now: number;
-    }) => number;
-}
-type SyncMessage = {
-    v: number;
-    protocol: number;
-    type: "sync-request" | "sync-state";
-    name: string;
-    clock: number;
-    source: string;
-    updatedAt?: number;
-    data?: StoreValue;
-    checksum?: number | null;
-    auth?: unknown;
-    token?: string;
-    requestedAt?: number;
-};
-interface DevtoolsOptions<State = StoreValue> {
-    enabled?: boolean;
-    historyLimit?: number;
-    redactor?: (state: State) => State;
-}
-interface LifecycleOptions<State = StoreValue> {
-    middleware?: Array<(ctx: MiddlewareCtx) => StoreValue | void>;
-    onSet?: (prev: State, next: State) => void;
-    onReset?: (prev: State, next: State) => void;
-    onDelete?: (prev: State) => void;
-    onCreate?: (initial: State) => void;
-}
-interface StoreOptions<State = StoreValue> {
-    scope?: StoreScope;
-    lazy?: boolean;
-    /**
-     * Allow `setStore(name, path, value)` to create missing **leaf** keys on object nodes.
-     *
-     * Default: `false` (strict path writes).
-     *
-     * Notes:
-     * - Does not expand arrays (out-of-bounds indices are still rejected).
-     * - Does not create missing intermediate objects for deep paths; define the shape up-front.
-     */
-    pathCreate?: boolean;
-    validate?: ValidateOption<State>;
-    persist?: boolean | string | PersistOptions<State>;
-    devtools?: boolean | DevtoolsOptions<State>;
-    lifecycle?: LifecycleOptions<State>;
-    middleware?: Array<(ctx: MiddlewareCtx) => StoreValue | void>;
-    onSet?: (prev: State, next: State) => void;
-    onReset?: (prev: State, next: State) => void;
-    onDelete?: (prev: State) => void;
-    onCreate?: (initial: State) => void;
-    onError?: (err: string) => void;
-    /** @deprecated use validate instead */
-    validator?: (next: State) => boolean;
-    /** @deprecated use validate instead */
-    schema?: unknown;
-    migrations?: Record<number, (state: State) => State>;
-    version?: number;
-    redactor?: (state: State) => State;
-    historyLimit?: number;
-    allowSSRGlobalStore?: boolean;
-    sync?: boolean | SyncOptions;
-    /**
-     * Snapshot cloning strategy used by subscriptions and selector snapshots.
-     *
-     * - "deep" (default): deep clone and dev-freeze snapshot values.
-     * - "shallow": shallow clone (top-level) only; nested references are shared.
-     * - "ref": return the live store reference (no cloning).
-     */
-    snapshot?: SnapshotMode;
-}
-interface NormalizedOptions {
-    scope: StoreScope;
-    lazy: boolean;
-    pathCreate: boolean;
-    persist: PersistConfig | null;
-    devtools: boolean;
-    middleware: Array<(ctx: MiddlewareCtx) => StoreValue | void>;
-    onSet?: (prev: StoreValue, next: StoreValue) => void;
-    onReset?: (prev: StoreValue, next: StoreValue) => void;
-    onDelete?: (prev: StoreValue) => void;
-    onCreate?: (initial: StoreValue) => void;
-    onError?: (err: string) => void;
-    validate?: ValidateOption;
-    migrations: Record<number, (state: any) => any>;
-    version: number;
-    redactor?: (state: StoreValue) => StoreValue;
-    historyLimit: number;
-    allowSSRGlobalStore?: boolean;
-    sync?: boolean | SyncOptions;
-    snapshot: SnapshotMode;
-    explicitPersist: boolean;
-    explicitSync: boolean;
-    explicitDevtools: boolean;
-}
-
-export type { MiddlewareCtx as M, NormalizedOptions as N, PersistOptions as P, StoreOptions as S, StoreValue as a, SnapshotMode as b, SyncOptions as c };