/**
 * Plain CLI preferences store.
 *
 * Stored at ~/.workos/preferences.json as plain JSON. These are NOT secrets —
 * knowing that someone opted out of telemetry leaks nothing — so this
 * deliberately avoids the keyring abstraction (config-store.ts) to prevent a
 * non-secret write from ever triggering the insecure-fallback security warning.
 *
 * Mirrors the structural pattern of device-id.ts: a synchronous accessor backed
 * by a cache, an async prewarm that populates that cache off the blocking-fs
 * path, and a never-throws contract on every read/parse so a corrupt file can
 * never break a command.
 */
export interface CliPreferences {
    telemetry?: {
        /** true => the user explicitly opted out of telemetry. */
        optedOut?: boolean;
        /** ISO timestamp the first-run notice was shown — written in Phase 2 only. */
        noticeShownAt?: string;
    };
}
/** Effective source of the resolved telemetry-enabled decision. */
export type TelemetrySource = 'env' | 'preference' | 'default';
export declare function getPreferencesPath(): string;
/**
 * Asynchronously load preferences and warm the cache the synchronous
 * getPreferences() reads. Memoized: the first call performs the IO, concurrent
 * and later callers await the same promise. Prewarming this at startup keeps
 * the synchronous telemetry path off blocking fs IO. Never rejects.
 */
export declare function loadPreferences(): Promise<CliPreferences>;
/**
 * Synchronous accessor. Returns the prewarmed value when loadPreferences() has
 * run; otherwise performs a one-time synchronous read of the same file. On any
 * IO/parse failure returns {} (telemetry stays at its default-on state). Never
 * throws.
 */
export declare function getPreferences(): CliPreferences;
/**
 * Read-modify-write the on-disk preferences, merging `next` over the current
 * persisted value so future fields are never clobbered, then update the cache.
 * Throws on write failure so callers on the command path (opt-out/opt-in) can
 * surface a clear error — the read path swallows, the write path does not.
 */
export declare function savePreferences(next: CliPreferences): void;
/** Whether the user has explicitly opted out via the saved preference. */
export declare function isTelemetryOptedOut(): boolean;
/** Persist the opt-out flag. Throws on write failure (see savePreferences). */
export declare function setTelemetryOptedOut(value: boolean): void;
/** Whether the first-run telemetry notice has already been shown (ever). */
export declare function isNoticeShown(): boolean;
/**
 * Persist the first-run notice as shown, stamping the current time. Uses the
 * read-modify-write savePreferences so it never clobbers the optedOut flag.
 * Throws on write failure (see savePreferences) — the caller in
 * telemetry-notice.ts swallows it so a read-only FS never blocks a command.
 */
export declare function markNoticeShown(): void;
/**
 * Tri-state env override for telemetry.
 *
 * Only the explicit strings 'true' / 'false' count as an override. Any other
 * value — including unset or garbage like '1' — returns undefined and falls
 * through to the saved preference.
 *
 * This is a deliberate, documented change from the old `WORKOS_TELEMETRY !==
 * 'false'` behaviour: previously `WORKOS_TELEMETRY=1` forced telemetry on even
 * for opted-out users; now an opt-out is respected unless the env var
 * explicitly says 'true'.
 */
export declare function envTelemetryOverride(): boolean | undefined;
/**
 * Effective telemetry-enabled decision.
 *
 * Resolution order:
 *   1. envTelemetryOverride() if defined — env wins in BOTH directions.
 *   2. otherwise !isTelemetryOptedOut() — default-on unless explicitly opted out.
 */
export declare function isTelemetryEnabled(): boolean;
/**
 * Which signal produced the effective telemetry decision. Mirrors the
 * precedence in isTelemetryEnabled() so the `telemetry status` command and the
 * resolver can never drift.
 *
 * Note: an explicit opt-in (optedOut === false) reads as 'default', not
 * 'preference' — its outcome is identical to a fresh install, and the resolver
 * only treats optedOut === true as a non-default signal, so reporting
 * 'preference' here would imply a behavioral difference that does not exist.
 */
export declare function getTelemetrySource(): TelemetrySource;
/**
 * Delete the preferences file, returning telemetry to its fresh-install state
 * (opted-in, first-run notice unseen). Used by `debug reset` to wipe stored CLI
 * state alongside credentials and config. No-op if the file does not exist;
 * throws on a real delete failure (e.g. permission denied) so the caller can
 * surface it, mirroring clearConfig/clearCredentials. Resets the in-memory
 * cache so subsequent reads in this process reflect the cleared state.
 */
export declare function clearPreferences(): void;
/** Test seam — resets the in-memory cache between test cases. */
export declare function __resetPreferencesCache(): void;