import { type Action, type Service } from '@atproto/lex';
import type { AtUriString, DatetimeString, DidString } from '@atproto/syntax';
import { type BskyAppProgressGuide, type MutedWord, type Nux, type PostInteractionSettingsPref, type Preferences, type SavedFeed, type VerificationPrefs } from '../lexicons/app/bsky/actor/defs.defs.js';
import type { LabelPreference } from '../moderation/index.js';
import type { BskyFeedViewPreference, BskyPreferences, BskyThreadViewPreference } from './types.js';
/**
 * Preference reads/writes target the user's account host by default (like
 * the client's own record helpers), regardless of the client's `service`
 * default — preferences live on the PDS, not behind the AppView proxy.
 * Pass `service` to override.
 *
 * @remarks Why not default to proxying to the Bluesky API? The Bluesky API
 * does not implement these endpoints — the reference PDS special-cases them,
 * intercepting the proxy header and serving them locally, but that intercept
 * is distro-dependent (it can be compiled/configured out, e.g. Tranquil PDS)
 * and other AppViews don't get the same treatment. Targeting the account
 * host directly is the honest description of where preferences live today.
 * See the discussion on bluesky-social/bsky#1 for the full picture.
 */
export interface PrefsServiceOptions {
    service?: Service | null;
}
type UpdatePreferencesInput = ((prefs: Preferences) => Preferences | false) | ({
    update: (prefs: Preferences) => Preferences | false;
} & PrefsServiceOptions);
/**
 * Low-level helper to update the raw preferences array on the server.
 *
 * Concurrent calls on the same Client are automatically serialized: each
 * read-modify-write cycle waits for the previous one to complete before
 * starting, matching the old Agent's per-instance AwaitLock behavior.
 */
export declare const updatePreferences: Action<UpdatePreferencesInput, Preferences>;
/**
 * Fetches and interprets the current user's preferences into a structured BskyPreferences object.
 * Migrates v1 savedFeeds to v2 on first read.
 */
export declare const getPreferences: Action<void | PrefsServiceOptions, BskyPreferences>;
export declare const setAdultContentEnabled: Action<boolean, void>;
export declare const setContentLabelPref: Action<{
    key: string;
    value: LabelPreference;
    labelerDid?: DidString;
}, void>;
export declare const addSavedFeeds: Action<Pick<SavedFeed, 'type' | 'value' | 'pinned'>[], SavedFeed[]>;
export declare const removeSavedFeeds: Action<string[], void>;
export declare const updateSavedFeeds: Action<SavedFeed[], void>;
export declare const overwriteSavedFeeds: Action<SavedFeed[], void>;
/**
 * @deprecated use updateSavedFeeds or removeSavedFeeds
 * (old agent.ts:856-862 addPinnedFeed)
 */
export declare const addPinnedFeed: Action<AtUriString, void>;
/**
 * @deprecated use updateSavedFeeds or removeSavedFeeds
 * (old agent.ts:864-870 removePinnedFeed)
 */
export declare const removePinnedFeed: Action<AtUriString, void>;
export declare const setFeedViewPrefs: Action<{
    feed: string;
} & Partial<BskyFeedViewPreference>, void>;
export declare const setThreadViewPrefs: Action<Partial<BskyThreadViewPreference>, void>;
export declare const setPersonalDetails: Action<{
    birthDate: Date | DatetimeString | undefined;
}, void>;
export declare const setInterestsPref: Action<{
    tags: string[];
}, void>;
/**
 * Add a single muted word. (old agent.ts:1070-1112)
 */
export declare const addMutedWord: Action<Pick<MutedWord, 'value' | 'targets' | 'actorTarget' | 'expiresAt'>, void>;
/**
 * Convenience method to add multiple muted words. (old agent.ts:1117-1119)
 */
export declare const addMutedWords: Action<MutedWord[], void>;
/**
 * @deprecated use addMutedWords or addMutedWord instead (old agent.ts:1124-1131)
 */
export declare const upsertMutedWords: Action<Pick<MutedWord, 'value' | 'targets' | 'actorTarget' | 'expiresAt'>[], void>;
/**
 * Update a muted word in user preferences. (old agent.ts:1136-1176)
 */
export declare const updateMutedWord: Action<MutedWord, void>;
/**
 * Remove a single muted word (old agent.ts:1182-1209)
 */
export declare const removeMutedWord: Action<MutedWord, void>;
/**
 * Convenience method to remove multiple muted words. (old agent.ts:1214-1216)
 */
export declare const removeMutedWords: Action<MutedWord[], void>;
export declare const hidePost: Action<AtUriString, void>;
export declare const unhidePost: Action<AtUriString, void>;
export declare const addLabeler: Action<DidString, void>;
export declare const removeLabeler: Action<DidString, void>;
export declare const queueNudges: Action<string[], void>;
export declare const dismissNudges: Action<string[], void>;
/**
 * Set the flag for participating in the beta features program.
 * (upstream agent.ts setIsBetaUser, atproto#5178)
 */
export declare const setIsBetaUser: Action<boolean, void>;
export declare const setActiveProgressGuide: Action<BskyAppProgressGuide | undefined, void>;
export declare const upsertNux: Action<Nux, void>;
export declare const removeNuxs: Action<string[], void>;
export declare const setVerificationPrefs: Action<VerificationPrefs, void>;
export declare const setPostInteractionSettings: Action<PostInteractionSettingsPref, void>;
/**
 * Update live event preferences. (old agent.ts:1380-1413)
 */
export declare const updateLiveEventPreferences: Action<{
    type: 'hideFeed';
    id: string;
} | {
    type: 'unhideFeed';
    id: string;
} | {
    type: 'toggleHideAllFeeds';
}, void>;
export {};
//# sourceMappingURL=preferences.d.ts.map