export interface InitdbCachedOptions {
  initdbBin: string
  dataDir: string
  user: string
  args?: readonly string[]
  env?: Record<string, string | undefined>
}

/**
 * Initializes an embedded Postgres data directory from a deterministic initdb template cache.
 * Falls back to running initdb directly when the cache cannot be used.
 * Throws if dataDir exists and is not empty (same contract as initdb itself).
 */
export declare function initdbCached(options: InitdbCachedOptions): Promise<void>