/** Maximum permitted key length in characters (bytes after UTF-8 encoding may be larger). */
export const MAX_KEY_LENGTH = 1024;

/** Default data-file extension appended to every key. */
export const DEFAULT_FILE_EXTENSION = ".data";

/** Default metadata-file extension appended to every key. */
export const DEFAULT_METADATA_EXTENSION = ".meta";

/** Default retry maximum attempts on transient filesystem errors. */
export const DEFAULT_RETRY_MAX_ATTEMPTS = 3;

/** Default retry base delay in milliseconds. */
export const DEFAULT_RETRY_BASE_DELAY_MS = 50;

/** Default retry maximum delay in milliseconds. */
export const DEFAULT_RETRY_MAX_DELAY_MS = 5_000;

/** Prefix used for atomic-write temp files. */
export const TEMP_FILE_PREFIX = ".tmp-";

/** Transient errno values that are eligible for retry. */
export const TRANSIENT_ERRNO_CODES = new Set([
    "EBUSY",
    "EMFILE",
    "ENFILE",
    "EAGAIN",
]);