/**
 * @license
 * Copyright 2025 Steven Roussey <sroussey@gmail.com>
 * SPDX-License-Identifier: Apache-2.0
 */
import type { BaseTabularStorage } from "../tabular/BaseTabularStorage";
import { DefaultKeyValueKey, DefaultKeyValueSchema } from "./IKvStorage";
import { KvStorage } from "./KvStorage";
export declare abstract class KvViaTabularStorage<Key extends string = string, Value = any, Combined = {
    key: Key;
    value: Value;
}> extends KvStorage<Key, Value, Combined> {
    abstract tabularRepository: BaseTabularStorage<typeof DefaultKeyValueSchema, typeof DefaultKeyValueKey>;
    private get needsJsonSerialization();
    private _needsJsonSerialization;
    /**
     * Deserialize a stored value back to the runtime form. When the schema
     * isn't a primitive we round-trip through JSON; if the stored bytes
     * aren't valid JSON we return them as-is so callers see what's on disk
     * rather than an exception.
     */
    private deserialize;
    /** Must be called before using any other methods. */
    setupDatabase(): Promise<void>;
    put(key: Key, value: Value): Promise<void>;
    putBulk(items: Array<{
        key: Key;
        value: Value;
    }>): Promise<void>;
    get(key: Key): Promise<Value | undefined>;
    /**
     * Delegates to the underlying tabular `getBulk` so SQL-backed KV stores
     * (Postgres, SQLite) get push-down for free.
     */
    getBulk(keys: readonly Key[]): Promise<Combined[]>;
    delete(key: Key): Promise<void>;
    getAll(): Promise<Combined[] | undefined>;
    deleteAll(): Promise<void>;
    size(): Promise<number>;
    destroy(): void;
}
//# sourceMappingURL=KvViaTabularStorage.d.ts.map