/**
 * @license
 * Copyright 2025 Steven Roussey <sroussey@gmail.com>
 * SPDX-License-Identifier: Apache-2.0
 */
import { EventEmitter } from "@workglow/util";
import { JsonSchema } from "@workglow/util/schema";
import { JSONValue } from "../tabular/ITabularStorage";
import { IKvStorage, KvEventListener, KvEventListeners, KvEventName, KvEventParameters } from "./IKvStorage";
export declare const KV_REPOSITORY: import("@workglow/util").ServiceToken<IKvStorage<any, any, any>>;
/**
 * Abstract base class for key-value storage repositories.
 * Emits {@link KvEventListeners} events for all mutations and reads.
 */
export declare abstract class KvStorage<Key extends string = string, Value = any, Combined = {
    key: Key;
    value: Value;
}> implements IKvStorage<Key, Value, Combined> {
    keySchema: JsonSchema;
    valueSchema: JsonSchema;
    protected events: EventEmitter<KvEventListeners<Key, Value, Combined>>;
    constructor(keySchema?: JsonSchema, valueSchema?: JsonSchema);
    abstract put(key: Key, value: Value): Promise<void>;
    abstract putBulk(items: Array<{
        key: Key;
        value: Value;
    }>): Promise<void>;
    abstract get(key: Key): Promise<Value | undefined>;
    /**
     * Retrieves multiple values by their keys in a single bulk operation.
     * Returns only the found records; missing keys produce no entry. The
     * returned `Combined` records carry both key and value so callers can
     * re-align by key.
     */
    abstract getBulk(keys: readonly Key[]): Promise<Combined[]>;
    abstract delete(key: Key): Promise<void>;
    abstract getAll(): Promise<Combined[] | undefined>;
    abstract deleteAll(): Promise<void>;
    abstract size(): Promise<number>;
    getObjectAsIdString(object: JSONValue): Promise<string>;
    on<Event extends KvEventName>(name: Event, fn: KvEventListener<Event, Key, Value, Combined>): void;
    off<Event extends KvEventName>(name: Event, fn: KvEventListener<Event, Key, Value, Combined>): void;
    once<Event extends KvEventName>(name: Event, fn: KvEventListener<Event, Key, Value, Combined>): void;
    emit<Event extends KvEventName>(name: Event, ...args: KvEventParameters<Event, Key, Value, Combined>): void;
    waitOn<Event extends KvEventName>(name: Event): Promise<KvEventParameters<Event, Key, Value, Combined>>;
}
//# sourceMappingURL=KvStorage.d.ts.map