import { type Maybe } from '@dereekb/util';
import { type FirestoreQueryConstraint } from '../../common/firestore/query/constraint';
import { type StorageFilePurposeSubgroup, type StorageFilePurpose } from './storagefile.id';
import { type FirebaseAuthUserId } from '../../common/auth/auth';
/**
 * Returns query constraints for StorageFiles with `ps == QUEUED_FOR_PROCESSING`.
 *
 * Used by the server action service to find files awaiting processing task creation.
 *
 * @example
 * ```ts
 * const constraints = storageFilesQueuedForProcessingQuery();
 * const results = await collection.query(constraints);
 * ```
 *
 * @returns Firestore query constraints for StorageFiles queued for processing
 */
export declare function storageFilesQueuedForProcessingQuery(): FirestoreQueryConstraint[];
/**
 * Returns query constraints for StorageFiles whose scheduled delete date (`sdat`) has passed.
 *
 * Used by the cleanup service to find files ready for permanent deletion.
 *
 * @param now - reference time for comparison; defaults to current time
 * @returns Firestore query constraints for StorageFiles whose scheduled delete date has passed
 *
 * @example
 * ```ts
 * const constraints = storageFilesQueuedForDeleteQuery();
 * ```
 */
export declare function storageFilesQueuedForDeleteQuery(now?: Maybe<Date>): FirestoreQueryConstraint[];
/**
 * Input for querying StorageFiles by purpose and owning user, with optional subgroup filtering.
 */
export interface StorageFilePurposeAndUserQueryInput {
    readonly user: FirebaseAuthUserId;
    readonly purpose: StorageFilePurpose;
    /**
     * Target a specific subgroup
     */
    readonly purposeSubgroup?: Maybe<StorageFilePurposeSubgroup>;
}
/**
 * Returns query constraints for StorageFiles matching a specific purpose and user,
 * with optional subgroup filtering.
 *
 * @example
 * @param input - the user, purpose, and optional subgroup to filter by
 * @returns Firestore query constraints for the given purpose and user
 *
 * @example
 * ```ts
 * const constraints = storageFilePurposeAndUserQuery({
 *   user: 'user123',
 *   purpose: 'avatar'
 * });
 * ```
 */
export declare function storageFilePurposeAndUserQuery(input: StorageFilePurposeAndUserQueryInput): FirestoreQueryConstraint[];
/**
 * Returns query constraints for StorageFiles flagged for group synchronization (`gs == true`).
 *
 * Used by the sync service to find files whose group memberships need to be propagated.
 *
 * @example
 * @returns Firestore query constraints for StorageFiles flagged for group synchronization
 *
 * @example
 * ```ts
 * const constraints = storageFileFlaggedForSyncWithGroupsQuery();
 * ```
 */
export declare function storageFileFlaggedForSyncWithGroupsQuery(): FirestoreQueryConstraint[];
/**
 * Returns query constraints for StorageFileGroups that need initialization (`s == true`).
 *
 * Used by the initialization service to find newly-created groups that haven't been synced yet.
 *
 * @example
 * @returns Firestore query constraints for StorageFileGroups needing initialization
 *
 * @example
 * ```ts
 * const constraints = storageFileGroupsFlaggedForNeedsInitializationQuery();
 * ```
 */
export declare function storageFileGroupsFlaggedForNeedsInitializationQuery(): FirestoreQueryConstraint[];
/**
 * Returns query constraints for StorageFileGroups flagged for content regeneration (`re == true`).
 *
 * @example
 * @returns Firestore query constraints for StorageFileGroups flagged for content regeneration
 *
 * @example
 * ```ts
 * const constraints = storageFileGroupsFlaggedForContentRegenerationQuery();
 * ```
 */
export declare function storageFileGroupsFlaggedForContentRegenerationQuery(): FirestoreQueryConstraint[];
/**
 * Returns query constraints for StorageFileGroups flagged as invalid (`fi == true`).
 *
 * Invalid groups are typically cleaned up (deleted along with their associated files).
 *
 * @example
 * @returns Firestore query constraints for StorageFileGroups flagged as invalid
 *
 * @example
 * ```ts
 * const constraints = storageFileGroupsFlaggedInvalidQuery();
 * ```
 */
export declare function storageFileGroupsFlaggedInvalidQuery(): FirestoreQueryConstraint[];