@oxyhq/services 23.0.2 → 23.1.0

package/lib/typescript/module/ui/hooks/mutations/useAccountMutations.d.ts

@@ -0,0 +1,297 @@
+import type { AssetUploadInput, NotificationPreferences, PrivacySettings, User, UserPreferences } from '@oxyhq/core';
+/**
+ * Update user profile with optimistic updates and offline queue support
+ */
+export declare const useUpdateProfile: () => import("@tanstack/react-query").UseMutationResult<User, Error, import("zod").objectOutputType<{
+    name: import("zod").ZodOptional<import("zod").ZodObject<{
+        first: import("zod").ZodOptional<import("zod").ZodString>;
+        last: import("zod").ZodOptional<import("zod").ZodString>;
+    }, "strip", import("zod").ZodTypeAny, {
+        first?: string | undefined;
+        last?: string | undefined;
+    }, {
+        first?: string | undefined;
+        last?: string | undefined;
+    }>>;
+    username: import("zod").ZodOptional<import("zod").ZodString>;
+    email: import("zod").ZodOptional<import("zod").ZodString>;
+    avatar: import("zod").ZodOptional<import("zod").ZodString>;
+    color: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodString>>;
+    bio: import("zod").ZodOptional<import("zod").ZodString>;
+    description: import("zod").ZodOptional<import("zod").ZodString>;
+    phone: import("zod").ZodOptional<import("zod").ZodString>;
+    address: import("zod").ZodOptional<import("zod").ZodString>;
+    birthday: import("zod").ZodOptional<import("zod").ZodString>;
+    locations: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodUnknown, "many">>;
+    links: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+    linksMetadata: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
+        url: import("zod").ZodString;
+        title: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        image: import("zod").ZodOptional<import("zod").ZodString>;
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+    }, "strip", import("zod").ZodTypeAny, {
+        url: string;
+        description?: string | undefined;
+        id?: string | undefined;
+        title?: string | undefined;
+        image?: string | undefined;
+    }, {
+        url: string;
+        description?: string | undefined;
+        id?: string | undefined;
+        title?: string | undefined;
+        image?: string | undefined;
+    }>, "many">>;
+    languages: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString, "many">>;
+    accountExpiresAfterInactivityDays: import("zod").ZodOptional<import("zod").ZodNullable<import("zod").ZodNumber>>;
+    notificationPreferences: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    userPreferences: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    privacySettings: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+    themePreference: import("zod").ZodOptional<import("zod").ZodType<import("@oxyhq/contracts").ThemePreference, import("zod").ZodTypeDef, import("@oxyhq/contracts").ThemePreference>>;
+}, import("zod").ZodTypeAny, "passthrough">, {
+    previousUser: User | undefined;
+}>;
+/**
+ * Upload avatar with progress tracking and offline queue support
+ */
+export declare const useUploadAvatar: () => import("@tanstack/react-query").UseMutationResult<User, Error, {
+    uri: string;
+    type?: string;
+    name?: string;
+    size?: number;
+}, {
+    previousUser: User | undefined;
+}>;
+/**
+ * Variables accepted by the `useUpdateAccountSettings` mutation.
+ *
+ * `currentUser` is captured at dispatch time so the rebuilt user object the
+ * mutation returns is computed against a stable snapshot — NOT the cache
+ * value at the moment the API call settles. Reading from the cache inside
+ * `mutationFn` would race with sibling optimistic updates: a concurrent
+ * write could already have overwritten the cache by the time the privacy
+ * update returns, causing the rebuilt user to clobber the sibling's
+ * optimistic value.
+ */
+interface UpdateAccountSettingsVariables {
+    /** Subset of privacy fields to write. */
+    updates: Partial<PrivacySettings>;
+    /**
+     * The User snapshot captured at mutation dispatch time. The mutation
+     * rebuilds this user with the updated `privacySettings` and returns it
+     * to `onSuccess`. Required to avoid the race described above.
+     */
+    currentUser: User;
+}
+/**
+ * Update account settings (privacy preferences).
+ *
+ * Privacy settings are not part of the `PUT /users/me` allow-list; the API
+ * would silently drop them. Route through `updatePrivacySettings` so the
+ * dedicated `PATCH /privacy/:id/privacy` endpoint performs a dot-path merge
+ * and returns the updated `privacySettings` object.
+ *
+ * The returned object exposes the standard mutation surface PLUS a
+ * convenience `mutate(updates)` / `mutateAsync(updates)` that snapshots
+ * the current user from `useOxy()` at dispatch time. Callers that need to
+ * supply their own user snapshot (testing, server-side) can call the
+ * underlying `.mutate({ updates, currentUser })` form via `.mutation`.
+ */
+export declare const useUpdateAccountSettings: () => {
+    mutate: (updates: Partial<PrivacySettings>) => void;
+    mutateAsync: (updates: Partial<PrivacySettings>) => Promise<User>;
+    data: undefined;
+    variables: undefined;
+    error: null;
+    isError: false;
+    isIdle: true;
+    isPending: false;
+    isSuccess: false;
+    status: "idle";
+    reset: () => void;
+    context: {
+        previousUser: User | undefined;
+    } | undefined;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+} | {
+    mutate: (updates: Partial<PrivacySettings>) => void;
+    mutateAsync: (updates: Partial<PrivacySettings>) => Promise<User>;
+    data: undefined;
+    variables: UpdateAccountSettingsVariables;
+    error: null;
+    isError: false;
+    isIdle: false;
+    isPending: true;
+    isSuccess: false;
+    status: "pending";
+    reset: () => void;
+    context: {
+        previousUser: User | undefined;
+    } | undefined;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+} | {
+    mutate: (updates: Partial<PrivacySettings>) => void;
+    mutateAsync: (updates: Partial<PrivacySettings>) => Promise<User>;
+    data: undefined;
+    error: Error;
+    variables: UpdateAccountSettingsVariables;
+    isError: true;
+    isIdle: false;
+    isPending: false;
+    isSuccess: false;
+    status: "error";
+    reset: () => void;
+    context: {
+        previousUser: User | undefined;
+    } | undefined;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+} | {
+    mutate: (updates: Partial<PrivacySettings>) => void;
+    mutateAsync: (updates: Partial<PrivacySettings>) => Promise<User>;
+    data: {
+        privacySettings: PrivacySettings;
+        id: string;
+        publicKey: string;
+        username: string;
+        email?: string;
+        avatar?: string | null;
+        color?: string | null;
+        name: import("@oxyhq/contracts").UserNameResponse;
+        bio?: string;
+        description?: string;
+        phone?: string;
+        address?: string;
+        birthday?: string;
+        website?: string;
+        createdAt?: string;
+        updatedAt?: string;
+        links?: string[];
+        linksMetadata?: Array<{
+            url: string;
+            title?: string;
+            description?: string;
+            image?: string;
+            id?: string;
+        }>;
+        _count?: {
+            followers?: number;
+            following?: number;
+        };
+        accountExpiresAfterInactivityDays?: number | null;
+        type?: "local" | "federated" | "agent" | "automated";
+        isFederated?: boolean;
+        fediverseSharing?: boolean;
+        isAgent?: boolean;
+        isAutomated?: boolean;
+        instance?: string;
+        federation?: {
+            actorUri?: string;
+            domain?: string;
+            actorId?: string;
+        };
+        automation?: {
+            ownerId?: string;
+        };
+        isManagedAccount?: boolean;
+        managedBy?: string;
+        organizationCategory?: import("@oxyhq/contracts").OrganizationCategory;
+        languages?: string[];
+        notificationPreferences?: NotificationPreferences;
+        userPreferences?: UserPreferences;
+        themePreference?: import("@oxyhq/contracts").ThemePreference;
+        relationship?: import("@oxyhq/contracts").UserRelationship;
+    };
+    error: null;
+    variables: UpdateAccountSettingsVariables;
+    isError: false;
+    isIdle: false;
+    isPending: false;
+    isSuccess: true;
+    status: "success";
+    reset: () => void;
+    context: {
+        previousUser: User | undefined;
+    } | undefined;
+    failureCount: number;
+    failureReason: Error | null;
+    isPaused: boolean;
+    submittedAt: number;
+};
+/**
+ * Update privacy settings with optimistic updates and authentication handling
+ */
+export declare const useUpdatePrivacySettings: () => import("@tanstack/react-query").UseMutationResult<PrivacySettings, Error, {
+    settings: Partial<PrivacySettings>;
+    userId?: string;
+}, {
+    previousPrivacySettings: unknown;
+    previousUser: User | undefined;
+} | undefined>;
+/** Uploaded file data structure from API */
+interface UploadedFile {
+    id: string;
+    originalName?: string;
+    sha256?: string;
+    mime?: string;
+    size?: number;
+    createdAt?: string;
+    metadata?: Record<string, unknown>;
+    variants?: Array<{
+        type: string;
+        key: string;
+        width?: number;
+        height?: number;
+        readyAt?: string;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+/** Upload result type that supports both single file and batch responses */
+interface UploadResult {
+    file?: UploadedFile;
+    files?: UploadedFile[];
+    id?: string;
+}
+/**
+ * Update the authenticated user's notification preferences with optimistic
+ * updates. Persisted on the User document via `PUT /users/me` — same cache-
+ * invalidation behaviour as `useUpdateProfile`.
+ */
+export declare const useUpdateNotificationPreferences: () => import("@tanstack/react-query").UseMutationResult<User, Error, Partial<NotificationPreferences>, {
+    previousUser: User | undefined;
+}>;
+/**
+ * Update the authenticated user's general preferences (language, theme,
+ * reduce-motion, timezone). Persisted on the User document via
+ * `PUT /users/me`.
+ */
+export declare const useUpdateUserPreferences: () => import("@tanstack/react-query").UseMutationResult<User, Error, Partial<UserPreferences>, {
+    previousUser: User | undefined;
+}>;
+/**
+ * Revoke the current user's grant for a connected application (by its
+ * `applicationId`). Removes the grant so the app no longer appears in the user's
+ * "Connected apps" list — next sign-in for that app will require explicit
+ * re-consent.
+ */
+export declare const useRevokeConnectedApp: () => import("@tanstack/react-query").UseMutationResult<void, Error, string, unknown>;
+/**
+ * Upload file with authentication handling and progress tracking
+ */
+export declare const useUploadFile: () => import("@tanstack/react-query").UseMutationResult<UploadResult, Error, {
+    file: AssetUploadInput;
+    visibility?: "private" | "public" | "unlisted";
+    metadata?: Record<string, unknown>;
+    onProgress?: (progress: number) => void;
+}, unknown>;
+export {};
+//# sourceMappingURL=useAccountMutations.d.ts.map

package/lib/typescript/module/ui/hooks/mutations/useAccountMutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAccountMutations.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/mutations/useAccountMutations.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/ui/hooks/mutations/useServicesMutations.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Switch active session
+ */
+export declare const useSwitchSession: () => import("@tanstack/react-query").UseMutationResult<import("@oxyhq/core").User, Error, string, unknown>;
+/**
+ * Logout from a session
+ */
+export declare const useLogoutSession: () => import("@tanstack/react-query").UseMutationResult<string, Error, string | undefined, {
+    previousSessions: unknown;
+}>;
+/**
+ * Logout from all sessions
+ */
+export declare const useLogoutAll: () => import("@tanstack/react-query").UseMutationResult<void, Error, void, unknown>;
+/**
+ * Update device name
+ */
+export declare const useUpdateDeviceName: () => import("@tanstack/react-query").UseMutationResult<any, Error, string, unknown>;
+/**
+ * Remove a device
+ */
+export declare const useRemoveDevice: () => import("@tanstack/react-query").UseMutationResult<string, Error, string, unknown>;
+//# sourceMappingURL=useServicesMutations.d.ts.map

package/lib/typescript/module/ui/hooks/mutations/useServicesMutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useServicesMutations.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/mutations/useServicesMutations.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,eAAO,MAAM,gBAAgB,6GAuB5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;EAiD5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,qFAuBxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,sFAuB/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,yFAoB3B,CAAC"}

package/lib/typescript/module/ui/hooks/queries/paymentTypes.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Payment / wallet / subscription domain types.
+ *
+ * These model the JSON shapes the Oxy API actually returns for the
+ * payment-related read endpoints, so the corresponding query hooks
+ * (`useUserSubscription`, `useUserPayments`, `useUserWallet`,
+ * `useUserWalletTransactions`) expose precise types instead of `any`.
+ *
+ * Source of truth (API):
+ *  - Subscription:  GET /subscription/:userId   -> `Subscription` model JSON,
+ *                   or the fallback `{ plan: 'basic' }` when none exists.
+ *  - Payments:      GET /payments/user          -> `Payment[]` (sendSuccess).
+ *  - Wallet:        GET /wallet/:userId         -> `Wallet` (sendSuccess).
+ *  - Transactions:  GET /wallet/transactions/:userId
+ *                   -> `WalletTransactionsResponse` (sendPaginated envelope).
+ *
+ * All `Date` columns are serialized as ISO-8601 strings over the wire.
+ *
+ * Note: `@oxyhq/services` deliberately does NOT re-export these from
+ * `@oxyhq/core`. They live here because they describe the return shape of
+ * the services-layer query hooks; consumers that need core domain types
+ * import those directly from `@oxyhq/core`.
+ */
+/** Subscription tier. Mirrors the `plan` enum on the API `Subscription` model. */
+export type SubscriptionPlan = 'basic' | 'pro' | 'business';
+/** Lifecycle state of a subscription. */
+export type SubscriptionStatus = 'active' | 'canceled' | 'expired';
+/** Feature flags toggled by the active subscription plan. */
+export interface SubscriptionFeatures {
+    analytics: boolean;
+    premiumBadge: boolean;
+    unlimitedFollowing: boolean;
+    higherUploadLimits: boolean;
+    promotedPosts: boolean;
+    businessTools: boolean;
+}
+/**
+ * A user's subscription.
+ *
+ * When a user has never subscribed, the API returns the minimal fallback
+ * `{ plan: 'basic' }`; every other field is therefore optional so the type
+ * covers both the persisted document and the fallback.
+ */
+export interface Subscription {
+    plan: SubscriptionPlan;
+    status?: SubscriptionStatus;
+    /** Account this subscription belongs to (absent on the basic fallback). */
+    userId?: string;
+    /** ISO-8601 timestamp the current period started. */
+    startDate?: string;
+    /** ISO-8601 timestamp the current period ends / renews. */
+    endDate?: string;
+    autoRenew?: boolean;
+    paymentMethod?: string;
+    latestInvoice?: string;
+    features?: SubscriptionFeatures;
+    /** ISO-8601 creation timestamp. */
+    createdAt?: string;
+    /** ISO-8601 last-update timestamp. */
+    updatedAt?: string;
+}
+/**
+ * A billing / payment history entry, derived from `deposit` and `purchase`
+ * transactions on the API side (`GET /payments/user`).
+ */
+export interface Payment {
+    id: string;
+    userId: string;
+    type: string;
+    amount: number;
+    status: string;
+    description?: string;
+    itemId?: string;
+    itemType?: string;
+    /** ISO-8601 timestamp the payment was created (maps to `createdAt`). */
+    timestamp?: string;
+    /** ISO-8601 timestamp the payment settled, when applicable. */
+    completedAt?: string;
+}
+/** FairCoin wallet balance for a user (`GET /wallet/:userId`). */
+export interface Wallet {
+    userId: string;
+    balance: number;
+    /** On-chain withdrawal address, `null` until one is set. */
+    address: string | null;
+}
+/** Direction/category of a wallet transaction. */
+export type WalletTransactionType = 'deposit' | 'withdrawal' | 'transfer' | 'purchase';
+/** Settlement state of a wallet transaction. */
+export type WalletTransactionStatus = 'pending' | 'completed' | 'failed' | 'cancelled';
+/**
+ * A single wallet ledger entry returned by the transaction-history endpoint.
+ *
+ * The populated `userId` / `recipientId` may arrive either as a bare id
+ * string or as a `{ _id, username }` object depending on Mongoose
+ * population, so both shapes are modelled.
+ */
+export interface WalletTransaction {
+    id: string;
+    userId: string | {
+        _id: string;
+        username?: string;
+    };
+    type: WalletTransactionType;
+    amount: number;
+    status: WalletTransactionStatus;
+    description?: string;
+    recipientId?: string | {
+        _id: string;
+        username?: string;
+    } | null;
+    itemId?: string;
+    itemType?: string;
+    /** ISO-8601 creation timestamp (maps to `createdAt`). */
+    timestamp?: string;
+    /** ISO-8601 settlement timestamp, when applicable. */
+    completedAt?: string;
+}
+/** Pagination metadata attached to a paginated list response. */
+export interface WalletPagination {
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+}
+/**
+ * Paginated envelope returned by `GET /wallet/transactions/:userId`.
+ *
+ * The HTTP layer preserves the `{ data, pagination }` shape for paginated
+ * responses (it only unwraps the plain `{ data }` success envelope), so
+ * callers receive the list under `data`.
+ */
+export interface WalletTransactionsResponse {
+    data: WalletTransaction[];
+    pagination: WalletPagination;
+}
+//# sourceMappingURL=paymentTypes.d.ts.map

package/lib/typescript/module/ui/hooks/queries/paymentTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentTypes.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/queries/paymentTypes.ts"],"names":[],"mappings":"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"}

package/lib/typescript/module/ui/hooks/queries/queryKeys.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Centralized query keys for TanStack Query
+ *
+ * Following best practices:
+ * - Use arrays for hierarchical keys
+ * - Include all parameters in the key
+ * - Use consistent naming conventions
+ */
+import type { QueryClient } from '@tanstack/react-query';
+export declare const queryKeys: {
+    readonly accounts: {
+        readonly all: readonly ["accounts"];
+        readonly lists: () => readonly ["accounts", "list"];
+        readonly list: (sessionIds: string[]) => readonly ["accounts", "list", string[]];
+        readonly details: () => readonly ["accounts", "detail"];
+        readonly detail: (sessionId: string) => readonly ["accounts", "detail", string];
+        readonly current: (sessionId?: string | null) => readonly ["accounts", "current", string] | readonly ["accounts", "current"];
+        readonly settings: () => readonly ["accounts", "settings"];
+    };
+    readonly users: {
+        readonly all: readonly ["users"];
+        readonly lists: () => readonly ["users", "list"];
+        readonly list: (userIds: string[]) => readonly ["users", "list", string[]];
+        readonly details: () => readonly ["users", "detail"];
+        readonly detail: (userId: string) => readonly ["users", "detail", string];
+        /** Viewer-scoped single-profile fetch by user id (`relationship` is viewer-relative). */
+        readonly detailForViewer: (userId: string, viewerId: string) => readonly ["users", "detail", string, "viewer", string];
+        /**
+         * Viewer-scoped single-profile fetch by username (`relationship` is
+         * viewer-relative). Username is normalized to `trim().toLowerCase()` here
+         * so the hook key and any external seeder (e.g. Mention's precache) agree
+         * by construction — normalize once, never at call sites.
+         */
+        readonly byUsername: (username: string, viewerId: string) => readonly ["users", "detail", "username", string, "viewer", string];
+        readonly profile: (sessionId: string) => readonly ["users", "detail", string, "profile"];
+    };
+    readonly sessions: {
+        readonly all: readonly ["sessions"];
+        readonly lists: () => readonly ["sessions", "list"];
+        readonly list: (userId?: string) => readonly ["sessions", "list", string | undefined];
+        readonly details: () => readonly ["sessions", "detail"];
+        readonly detail: (sessionId: string) => readonly ["sessions", "detail", string];
+        readonly active: () => readonly ["sessions", "active"];
+        readonly device: (deviceId: string) => readonly ["sessions", "device", string];
+    };
+    readonly devices: {
+        readonly all: readonly ["devices"];
+        readonly lists: () => readonly ["devices", "list"];
+        readonly list: (accountScope?: string) => readonly ["devices", "list", string | undefined];
+        readonly details: () => readonly ["devices", "detail"];
+        readonly detail: (deviceId: string) => readonly ["devices", "detail", string];
+    };
+    readonly privacy: {
+        readonly all: readonly ["privacy"];
+        readonly settings: (userId?: string) => readonly ["privacy", "settings", string];
+    };
+    readonly security: {
+        readonly all: readonly ["security"];
+        readonly activity: (limit?: number, offset?: number, eventType?: string) => readonly ["security", "activity", number | undefined, number | undefined, string | undefined];
+        readonly recent: (limit: number) => readonly ["security", "recent", number];
+        readonly infinite: (limit: number, eventType?: string) => readonly ["security", "infinite", number, string | undefined];
+    };
+    readonly authMethods: {
+        readonly all: readonly ["authMethods"];
+        readonly list: (userId?: string) => readonly ["authMethods", "list", string];
+    };
+    readonly storage: {
+        readonly all: readonly ["storage"];
+        readonly usage: (accountScope?: string) => readonly ["storage", "usage", string | undefined];
+    };
+    readonly files: {
+        readonly all: readonly ["files"];
+        readonly list: (ownerId?: string) => readonly ["files", "list", string];
+    };
+    readonly connectedApps: {
+        readonly all: readonly ["connectedApps"];
+        readonly list: () => readonly ["connectedApps", "list"];
+    };
+    readonly follow: {
+        readonly all: readonly ["follow"];
+        readonly counts: (userId: string) => readonly ["follow", "counts", string];
+    };
+    readonly payments: {
+        readonly all: readonly ["payments"];
+        readonly subscription: (userId?: string) => readonly ["payments", "subscription", string];
+        readonly history: (userId?: string) => readonly ["payments", "history", string];
+        readonly wallet: (userId?: string) => readonly ["payments", "wallet", string];
+        readonly walletTransactions: (limit?: number, offset?: number, userId?: string) => readonly ["payments", "wallet", string, "transactions", number | undefined, number | undefined];
+    };
+};
+/**
+ * Helper to invalidate all account-related queries
+ */
+export declare const invalidateAccountQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate all user-related queries
+ */
+export declare const invalidateUserQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate all session-related queries
+ */
+export declare const invalidateSessionQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate all device-related queries
+ */
+export declare const invalidateDeviceQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate all privacy-settings queries
+ */
+export declare const invalidatePrivacyQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate all security-activity queries
+ */
+export declare const invalidateSecurityQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate all storage-usage queries
+ */
+export declare const invalidateStorageQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate the user's linked auth-methods list (call after linking
+ * or removing a passkey / password / identity key).
+ */
+export declare const invalidateAuthMethodsQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate all payments / wallet / subscription queries
+ */
+export declare const invalidatePaymentsQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate the user's connected-apps list
+ */
+export declare const invalidateConnectedAppsQueries: (queryClient: QueryClient) => void;
+/**
+ * Helper to invalidate the user's file library (all owners). Pass an ownerId via
+ * `queryKeys.files.list(ownerId)` for a scoped invalidation instead.
+ */
+export declare const invalidateFileQueries: (queryClient: QueryClient) => void;
+//# sourceMappingURL=queryKeys.d.ts.map

package/lib/typescript/module/ui/hooks/queries/queryKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queryKeys.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/hooks/queries/queryKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,SAAS;;;;oCAKC,MAAM,EAAE;;qCAEP,MAAM;uCACJ,MAAM,GAAG,IAAI;;;;;;iCAWnB,MAAM,EAAE;;kCAEP,MAAM;QACvB,yFAAyF;2CAC/D,MAAM,YAAY,MAAM;QAElD;;;;;WAKG;wCACoB,MAAM,YAAY,MAAM;sCAQ1B,MAAM;;;;;iCAOX,MAAM;;qCAEF,MAAM;;oCAEP,MAAM;;;;;uCAOH,MAAM;;oCAET,MAAM;;;;qCAML,MAAM;;;;oCAMP,MAAM,WAAW,MAAM,cAAc,MAAM;iCAE9C,MAAM;mCAEJ,MAAM,cAAc,MAAM;;;;iCAO5B,MAAM;;;;wCAMC,MAAM;;;;kCAOZ,MAAM;;;;;;;;kCAYN,MAAM;;;;yCAMC,MAAM;oCAEX,MAAM;mCAEP,MAAM;8CAEK,MAAM,WAAW,MAAM,WAAW,MAAM;;CAU/D,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,WAAW,KAAG,IAEhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,aAAa,WAAW,KAAG,IAElE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,aAAa,WAAW,KAAG,IAEpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,IAEnE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,GAAI,aAAa,WAAW,KAAG,IAEvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,GAAI,aAAa,WAAW,KAAG,IAEpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8BAA8B,GAAI,aAAa,WAAW,KAAG,IAEzE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,WAAW,KAAG,IAEhE,CAAC"}