/**
 * Versioned store snapshots and strict drift-checking hydration.
 *
 * Sits *on top of* the simple `serializeStoreState()` / `hydrateStore()` pair
 * to give applications a way to:
 * - tag the snapshot with a schema version so a stale client can refuse to
 *   apply server data that no longer matches its store shape;
 * - opt into strict mode where unknown keys cause a warning;
 * - selectively serialize / hydrate a subset of stores.
 *
 * Backwards compatible: the existing helpers stay untouched and remain the
 * primary entry-point for simple use cases.
 *
 * @module bquery/ssr
 */
/** Versioned store snapshot. */
export interface SSRStoreSnapshot {
    /** Application-defined version string. Stable per schema. */
    version: string;
    /** Map of store ID → sanitized state. */
    state: Record<string, Record<string, unknown>>;
}
/** Result of `serializeStoreSnapshot()`. */
export interface SerializeSnapshotResult {
    snapshot: SSRStoreSnapshot;
    /** JSON-serialized snapshot. */
    json: string;
    /** `<script>` tag ready to embed (CSP-nonce-aware via `options.nonce`). */
    scriptTag: string;
}
/** Options for `serializeStoreSnapshot()`. */
export interface SerializeSnapshotOptions {
    /** Schema version. Required: hydration only succeeds when versions match. */
    version: string;
    /** Subset of store IDs to serialize. Defaults to all registered stores. */
    storeIds?: string[];
    /** Element ID for the generated `<script>` tag. */
    scriptId?: string;
    /** Global window key where the snapshot is assigned. */
    globalKey?: string;
    /** CSP nonce applied to the generated `<script>`. */
    nonce?: string;
}
/**
 * Captures every registered store's state into a versioned snapshot and
 * returns both the JSON payload and a ready-to-embed `<script>` tag.
 */
export declare const serializeStoreSnapshot: (options: SerializeSnapshotOptions) => SerializeSnapshotResult;
/** Options for `hydrateStoreSnapshot()`. */
export interface HydrateSnapshotOptions {
    /**
     * If set, the snapshot's `version` must match this value. Otherwise the
     * function returns early (and warns when `strict` is true).
     */
    expectedVersion?: string;
    /**
     * Strict mode: warn on version mismatch + warn on unknown store IDs (i.e.
     * the snapshot has IDs that aren't currently registered). Default: `false`.
     */
    strict?: boolean;
}
/** Result of `hydrateStoreSnapshot()`. */
export interface HydrateSnapshotResult {
    /** Whether the snapshot was applied. */
    applied: boolean;
    /** Reason when not applied (`'version-mismatch' | 'invalid-shape'`). */
    reason?: 'version-mismatch' | 'invalid-shape';
    /** IDs that were applied. */
    appliedIds: string[];
    /** IDs in the snapshot that no store exists for. */
    unknownIds: string[];
}
/**
 * Applies a previously-serialized `SSRStoreSnapshot` to the registered stores.
 *
 * Returns a structured result; never throws on drift unless an explicit error
 * is thrown by a store's `$patch()` implementation.
 */
export declare const hydrateStoreSnapshot: (snapshot: unknown, options?: HydrateSnapshotOptions) => HydrateSnapshotResult;
/**
 * Reads the snapshot emitted by `serializeStoreSnapshot()` from `window`,
 * cleans up the global, and returns the parsed `SSRStoreSnapshot`.
 *
 * Returns `null` when no snapshot was found or when it has the wrong shape.
 */
export declare const readStoreSnapshot: (globalKey?: string, scriptId?: string) => SSRStoreSnapshot | null;
//# sourceMappingURL=store-snapshot.d.ts.map