import type { EventEmitter } from "node:events";
import { type DbExec } from "../db/client.js";
export declare function getSettingsEmitter(): EventEmitter;
export declare const settingsStore: import("../db/store-registry.js").Store;
export declare function ensureTable(): Promise<void>;
export interface StoreReadOptions {
    /** Skip the per-request snapshot when a cross-request race must be checked. */
    bypassCache?: boolean;
    transaction?: DbExec;
}
export declare function getSetting(key: string, options?: StoreReadOptions): Promise<Record<string, unknown> | null>;
export type SettingEntry = {
    found: false;
} | {
    found: true;
    value: unknown;
};
/** Like `getSetting`, but a stored JSON `null` is found, not missing. */
export declare function getSettingEntry(key: string, options?: StoreReadOptions): Promise<SettingEntry>;
export declare function getSettings(keys: readonly string[], options?: StoreReadOptions): Promise<Map<string, Record<string, unknown> | null>>;
export interface StoreWriteOptions {
    requestSource?: string;
}
export declare function mutateSetting(key: string, updater: (current: Record<string, unknown> | null) => Record<string, unknown> | Promise<Record<string, unknown>>, options?: StoreWriteOptions): Promise<Record<string, unknown>>;
export declare function putSetting(key: string, value: Record<string, unknown>, options?: StoreWriteOptions): Promise<void>;
export declare function deleteSetting(key: string, options?: StoreWriteOptions): Promise<boolean>;
export declare function deleteSettingIfValue(key: string, expected: Record<string, unknown>, options?: StoreWriteOptions): Promise<boolean>;
export declare function deleteSettingsByPrefix(prefix: string, options?: StoreWriteOptions): Promise<number>;
export declare function listSettingsByPrefix(prefix: string, options?: {
    limit?: number;
}): Promise<Array<{
    key: string;
    value: Record<string, unknown>;
}>>;