@qiaopeng/tanstack-query-plus 0.5.8 → 0.5.10

package/dist/core/index.d.cts

@@ -0,0 +1,196 @@
+import { DefaultOptions, QueryKey, QueryFunction, UseQueryOptions, DefaultError } from '@tanstack/react-query';
+export { focusManager } from '@tanstack/react-query';
+export { DevToolsConfig, createDevToolsConfig, defaultDevToolsConfig, isDevToolsEnabled } from './devtools.cjs';
+export { ReactQueryDevtools } from '@tanstack/react-query-devtools';
+import 'react';
+
+declare const TIME_CONSTANTS: {
+    readonly THIRTY_SECONDS: number;
+    readonly ONE_MINUTE: number;
+    readonly FIVE_MINUTES: number;
+    readonly TEN_MINUTES: number;
+    readonly FIFTEEN_MINUTES: number;
+    readonly THIRTY_MINUTES: number;
+    readonly ONE_HOUR: number;
+    readonly ONE_DAY: number;
+};
+declare const DEFAULT_STALE_TIME: number;
+declare const DEFAULT_GC_TIME: number;
+/**
+ * 默认 Query 重试策略
+ * - 4XX 客户端错误：不重试（客户端问题，重试无意义）
+ * - 5XX 服务端错误：最多重试 1 次（避免过度重试）
+ * - 其他错误（网络等）：最多重试 2 次
+ */
+declare function defaultQueryRetryStrategy(failureCount: number, error: unknown): boolean;
+/**
+ * 默认 Mutation 重试策略
+ * - 4XX 客户端错误：不重试
+ * - 5XX 服务端错误：不重试（Mutation 更谨慎，避免重复操作）
+ * - 其他错误：最多重试 1 次
+ */
+declare function defaultMutationRetryStrategy(failureCount: number, error: unknown): boolean;
+declare function exponentialBackoff(attemptIndex: number): number;
+declare const DEFAULT_QUERY_CONFIG: NonNullable<DefaultOptions["queries"]>;
+declare const DEFAULT_MUTATION_CONFIG: NonNullable<DefaultOptions["mutations"]>;
+declare const GLOBAL_QUERY_CONFIG: DefaultOptions;
+declare const SMART_RETRY_MUTATION_CONFIG: DefaultOptions["mutations"];
+declare const DEVELOPMENT_CONFIG: DefaultOptions;
+declare const PRODUCTION_CONFIG: DefaultOptions;
+declare const LONG_CACHE_CONFIG: DefaultOptions;
+declare const REALTIME_CONFIG: DefaultOptions;
+declare function getConfigByEnvironment(env: "development" | "production" | "test" | "realtime" | "longCache"): DefaultOptions;
+declare function createCustomConfig(overrides: Partial<DefaultOptions>): DefaultOptions;
+declare function validateGcTime(staleTime: number, gcTime: number): {
+    isValid: boolean;
+    warning?: string;
+};
+declare function validateConfig(config: DefaultOptions): {
+    isValid: boolean;
+    warnings: string[];
+};
+declare function ensureBestPractices(config: DefaultOptions): DefaultOptions;
+/**
+ * 创建安全的重试策略
+ * @param maxRetries4xx - 4XX 错误最大重试次数（默认 0，不重试）
+ * @param maxRetries5xx - 5XX 错误最大重试次数（默认 0，不重试）
+ * @param maxRetriesOther - 其他错误最大重试次数（默认 1）
+ */
+declare function createSafeRetryStrategy(maxRetries4xx?: number, maxRetries5xx?: number, maxRetriesOther?: number): (failureCount: number, error: unknown) => boolean;
+/**
+ * 创建错误安全配置
+ * 适用于需要严格控制重试和 refetch 行为的场景
+ *
+ * @example
+ * ```typescript
+ * // 完全禁用重试
+ * const config = createErrorSafeConfig({
+ *   maxRetries4xx: 0,
+ *   maxRetries5xx: 0,
+ *   maxRetriesOther: 0,
+ *   disableFocus: true,
+ *   disableReconnect: true
+ * });
+ * ```
+ */
+declare function createErrorSafeConfig(options?: {
+    maxRetries4xx?: number;
+    maxRetries5xx?: number;
+    maxRetriesOther?: number;
+    disableFocus?: boolean;
+    disableReconnect?: boolean;
+    conditionalRefetchInterval?: number | ((query: any) => number | false) | ((data: unknown, query: any) => number | false);
+    overrides?: Partial<DefaultOptions>;
+}): DefaultOptions;
+
+declare const isProd: boolean;
+declare const isDev: boolean;
+declare const isTest: boolean;
+
+interface FocusManagerConfig {
+    enabled?: boolean;
+    customEventListener?: (handleFocus: () => void) => () => void;
+    refetchOnWindowFocus?: boolean;
+}
+declare function setupFocusManager(config?: FocusManagerConfig): void;
+declare function pauseFocusManager(): void;
+declare function resumeFocusManager(): void;
+declare class SmartFocusManager {
+    private pauseCount;
+    private originalFocusState;
+    private refetchHistory;
+    private serializeKey;
+    pause(): void;
+    resume(): void;
+    reset(): void;
+    destroy(): void;
+    shouldRefetch(queryKey: QueryKey, minInterval?: number): boolean;
+    clearHistory(): void;
+    clearHistoryByKey(queryKey: QueryKey): void;
+    getLastRefetchTime(queryKey: QueryKey): number | undefined;
+    getStats(): {
+        isPaused: boolean;
+        pauseCount: number;
+        isFocused: boolean;
+    };
+}
+declare function getSmartFocusManager(): SmartFocusManager;
+declare function resetSmartFocusManager(): void;
+
+declare const queryKeys: {
+    all: readonly ["tanstack-query"];
+    users: () => readonly ["tanstack-query", "users"];
+    user: (id: string) => readonly ["tanstack-query", "users", string];
+    userProfile: (id: string) => readonly ["tanstack-query", "users", string, "profile"];
+    userSettings: (id: string) => readonly ["tanstack-query", "users", string, "settings"];
+    usersByRole: (role: string) => readonly ["tanstack-query", "users", "by-role", string];
+    posts: () => readonly ["tanstack-query", "posts"];
+    post: (id: string) => readonly ["tanstack-query", "posts", string];
+    postsByUser: (userId: string) => readonly ["tanstack-query", "posts", "by-user", string];
+    postsByTag: (tag: string) => readonly ["tanstack-query", "posts", "by-tag", string];
+    postComments: (postId: string) => readonly ["tanstack-query", "posts", string, "comments"];
+    search: (query: string, type?: string) => readonly ["tanstack-query", "search", {
+        readonly query: string;
+        readonly type: string | undefined;
+    }];
+    notifications: () => readonly ["tanstack-query", "notifications"];
+    notification: (id: string) => readonly ["tanstack-query", "notifications", string];
+    unreadNotifications: () => readonly ["tanstack-query", "notifications", "unread"];
+    settings: () => readonly ["tanstack-query", "settings"];
+    appSettings: () => readonly ["tanstack-query", "settings", "app"];
+    userPreferences: (userId: string) => readonly ["tanstack-query", "settings", "preferences", string];
+};
+declare function createFilteredKey(baseKey: QueryKey, filters: Record<string, unknown>): QueryKey;
+declare function createPaginatedKey(baseKey: QueryKey, page: number, pageSize: number): QueryKey;
+declare function createSortedKey(baseKey: QueryKey, sortBy: string, sortOrder?: "asc" | "desc"): QueryKey;
+declare function createSearchKey(baseKey: QueryKey, searchTerm: string, searchFields?: string[]): QueryKey;
+declare function createComplexKey(baseKey: QueryKey, options: {
+    page?: number;
+    pageSize?: number;
+    filters?: Record<string, unknown>;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+    search?: string;
+}): QueryKey;
+declare function matchesKeyPattern(queryKey: QueryKey, pattern: QueryKey): boolean;
+declare function validateQueryKey(queryKey: QueryKey): boolean;
+declare function containsEntity(queryKey: QueryKey, entity: string): boolean;
+declare function extractEntityId(queryKey: QueryKey, entityIndex: number): string | undefined;
+declare function normalizeQueryKey(queryKey: QueryKey): QueryKey;
+declare function areKeysEqual(key1: QueryKey, key2: QueryKey): boolean;
+declare function createDomainKeyFactory(domain: string): {
+    all: () => readonly ["tanstack-query", string];
+    lists: () => readonly ["tanstack-query", string, "list"];
+    list: (params?: Record<string, unknown>) => readonly ["tanstack-query", string, "list"] | readonly ["tanstack-query", string, "list", Record<string, unknown>];
+    details: () => readonly ["tanstack-query", string, "detail"];
+    detail: (id: string | number) => readonly ["tanstack-query", string, "detail", string | number];
+    subResource: (id: string | number, resource: string) => readonly ["tanstack-query", string, "detail", string | number, string];
+    byRelation: (relation: string, relationId: string | number) => readonly ["tanstack-query", string, `by-${string}`, string | number];
+};
+declare function createMutationKeyFactory(domain: string): {
+    create: () => readonly [string, "create"];
+    update: (id?: string | number) => readonly [string, "update", string | number] | readonly [string, "update"];
+    delete: (id?: string | number) => readonly [string, "delete", string | number] | readonly [string, "delete"];
+    batch: (operation: string) => readonly [string, "batch", string];
+    custom: (operation: string, id?: string | number) => readonly [string, string, string | number] | readonly [string, string];
+};
+
+interface BaseQueryConfig<TData> {
+    queryKey: QueryKey;
+    queryFn: QueryFunction<TData, QueryKey>;
+    staleTime?: number;
+    gcTime?: number;
+    enabled?: boolean;
+}
+declare function createAppQueryOptions<TData>(config: BaseQueryConfig<TData>): UseQueryOptions<TData, DefaultError, TData, QueryKey>;
+interface SelectQueryConfig<TData, TSelected = TData> extends Omit<BaseQueryConfig<TData>, "enabled"> {
+    select: (data: TData) => TSelected;
+}
+declare function createAppQueryOptionsWithSelect<TData, TSelected = TData>(config: SelectQueryConfig<TData, TSelected>): UseQueryOptions<TData, DefaultError, TSelected, QueryKey>;
+interface ListQueryConfig<TData> extends Omit<BaseQueryConfig<TData>, "staleTime" | "gcTime"> {
+    staleTime?: number;
+    gcTime?: number;
+}
+declare function createListQueryOptions<TData>(config: ListQueryConfig<TData>): UseQueryOptions<TData, DefaultError, TData, QueryKey>;
+
+export { DEFAULT_GC_TIME, DEFAULT_MUTATION_CONFIG, DEFAULT_QUERY_CONFIG, DEFAULT_STALE_TIME, DEVELOPMENT_CONFIG, type FocusManagerConfig, GLOBAL_QUERY_CONFIG, LONG_CACHE_CONFIG, type ListQueryConfig, PRODUCTION_CONFIG, REALTIME_CONFIG, SMART_RETRY_MUTATION_CONFIG, SmartFocusManager, TIME_CONSTANTS, areKeysEqual, containsEntity, createAppQueryOptions, createAppQueryOptionsWithSelect, createComplexKey, createCustomConfig, createDomainKeyFactory, createErrorSafeConfig, createFilteredKey, createListQueryOptions, createMutationKeyFactory, createPaginatedKey, createSafeRetryStrategy, createSearchKey, createSortedKey, defaultMutationRetryStrategy, defaultQueryRetryStrategy, ensureBestPractices, exponentialBackoff, extractEntityId, getConfigByEnvironment, getSmartFocusManager, isDev, isProd, isTest, matchesKeyPattern, normalizeQueryKey, pauseFocusManager, queryKeys, resetSmartFocusManager, resumeFocusManager, setupFocusManager, validateConfig, validateGcTime, validateQueryKey };

package/dist/core/index.d.ts

@@ -1,9 +1,196 @@
-export { createCustomConfig, DEFAULT_GC_TIME, DEFAULT_MUTATION_CONFIG, DEFAULT_QUERY_CONFIG, DEFAULT_STALE_TIME, defaultMutationRetryStrategy, defaultQueryRetryStrategy, DEVELOPMENT_CONFIG, ensureBestPractices, exponentialBackoff, getConfigByEnvironment, GLOBAL_QUERY_CONFIG, LONG_CACHE_CONFIG, PRODUCTION_CONFIG, REALTIME_CONFIG, createErrorSafeConfig, createSafeRetryStrategy, SMART_RETRY_MUTATION_CONFIG, TIME_CONSTANTS, validateConfig, validateGcTime } from "./config.js";
-export { createDevToolsConfig, defaultDevToolsConfig, type DevToolsConfig, isDevToolsEnabled } from "./devtools.js";
-export { ReactQueryDevtools } from "./devtools.js";
-export { isDev, isProd, isTest } from "./env.js";
-export { focusManager, type FocusManagerConfig, getSmartFocusManager, pauseFocusManager, resetSmartFocusManager, resumeFocusManager, setupFocusManager, SmartFocusManager } from "./focusManager.js";
-export { areKeysEqual, containsEntity, createComplexKey, createDomainKeyFactory, createFilteredKey, createMutationKeyFactory, createPaginatedKey, createSearchKey, createSortedKey, extractEntityId, matchesKeyPattern, normalizeQueryKey, queryKeys, validateQueryKey } from "./keys.js";
-export { createAppQueryOptions, createAppQueryOptionsWithSelect } from "./queryOptions.js";
-export { createListQueryOptions, type ListQueryConfig } from "./queryOptions.js";
-//# sourceMappingURL=index.d.ts.map
+import { DefaultOptions, QueryKey, QueryFunction, UseQueryOptions, DefaultError } from '@tanstack/react-query';
+export { focusManager } from '@tanstack/react-query';
+export { DevToolsConfig, createDevToolsConfig, defaultDevToolsConfig, isDevToolsEnabled } from './devtools.js';
+export { ReactQueryDevtools } from '@tanstack/react-query-devtools';
+import 'react';
+
+declare const TIME_CONSTANTS: {
+    readonly THIRTY_SECONDS: number;
+    readonly ONE_MINUTE: number;
+    readonly FIVE_MINUTES: number;
+    readonly TEN_MINUTES: number;
+    readonly FIFTEEN_MINUTES: number;
+    readonly THIRTY_MINUTES: number;
+    readonly ONE_HOUR: number;
+    readonly ONE_DAY: number;
+};
+declare const DEFAULT_STALE_TIME: number;
+declare const DEFAULT_GC_TIME: number;
+/**
+ * 默认 Query 重试策略
+ * - 4XX 客户端错误：不重试（客户端问题，重试无意义）
+ * - 5XX 服务端错误：最多重试 1 次（避免过度重试）
+ * - 其他错误（网络等）：最多重试 2 次
+ */
+declare function defaultQueryRetryStrategy(failureCount: number, error: unknown): boolean;
+/**
+ * 默认 Mutation 重试策略
+ * - 4XX 客户端错误：不重试
+ * - 5XX 服务端错误：不重试（Mutation 更谨慎，避免重复操作）
+ * - 其他错误：最多重试 1 次
+ */
+declare function defaultMutationRetryStrategy(failureCount: number, error: unknown): boolean;
+declare function exponentialBackoff(attemptIndex: number): number;
+declare const DEFAULT_QUERY_CONFIG: NonNullable<DefaultOptions["queries"]>;
+declare const DEFAULT_MUTATION_CONFIG: NonNullable<DefaultOptions["mutations"]>;
+declare const GLOBAL_QUERY_CONFIG: DefaultOptions;
+declare const SMART_RETRY_MUTATION_CONFIG: DefaultOptions["mutations"];
+declare const DEVELOPMENT_CONFIG: DefaultOptions;
+declare const PRODUCTION_CONFIG: DefaultOptions;
+declare const LONG_CACHE_CONFIG: DefaultOptions;
+declare const REALTIME_CONFIG: DefaultOptions;
+declare function getConfigByEnvironment(env: "development" | "production" | "test" | "realtime" | "longCache"): DefaultOptions;
+declare function createCustomConfig(overrides: Partial<DefaultOptions>): DefaultOptions;
+declare function validateGcTime(staleTime: number, gcTime: number): {
+    isValid: boolean;
+    warning?: string;
+};
+declare function validateConfig(config: DefaultOptions): {
+    isValid: boolean;
+    warnings: string[];
+};
+declare function ensureBestPractices(config: DefaultOptions): DefaultOptions;
+/**
+ * 创建安全的重试策略
+ * @param maxRetries4xx - 4XX 错误最大重试次数（默认 0，不重试）
+ * @param maxRetries5xx - 5XX 错误最大重试次数（默认 0，不重试）
+ * @param maxRetriesOther - 其他错误最大重试次数（默认 1）
+ */
+declare function createSafeRetryStrategy(maxRetries4xx?: number, maxRetries5xx?: number, maxRetriesOther?: number): (failureCount: number, error: unknown) => boolean;
+/**
+ * 创建错误安全配置
+ * 适用于需要严格控制重试和 refetch 行为的场景
+ *
+ * @example
+ * ```typescript
+ * // 完全禁用重试
+ * const config = createErrorSafeConfig({
+ *   maxRetries4xx: 0,
+ *   maxRetries5xx: 0,
+ *   maxRetriesOther: 0,
+ *   disableFocus: true,
+ *   disableReconnect: true
+ * });
+ * ```
+ */
+declare function createErrorSafeConfig(options?: {
+    maxRetries4xx?: number;
+    maxRetries5xx?: number;
+    maxRetriesOther?: number;
+    disableFocus?: boolean;
+    disableReconnect?: boolean;
+    conditionalRefetchInterval?: number | ((query: any) => number | false) | ((data: unknown, query: any) => number | false);
+    overrides?: Partial<DefaultOptions>;
+}): DefaultOptions;
+
+declare const isProd: boolean;
+declare const isDev: boolean;
+declare const isTest: boolean;
+
+interface FocusManagerConfig {
+    enabled?: boolean;
+    customEventListener?: (handleFocus: () => void) => () => void;
+    refetchOnWindowFocus?: boolean;
+}
+declare function setupFocusManager(config?: FocusManagerConfig): void;
+declare function pauseFocusManager(): void;
+declare function resumeFocusManager(): void;
+declare class SmartFocusManager {
+    private pauseCount;
+    private originalFocusState;
+    private refetchHistory;
+    private serializeKey;
+    pause(): void;
+    resume(): void;
+    reset(): void;
+    destroy(): void;
+    shouldRefetch(queryKey: QueryKey, minInterval?: number): boolean;
+    clearHistory(): void;
+    clearHistoryByKey(queryKey: QueryKey): void;
+    getLastRefetchTime(queryKey: QueryKey): number | undefined;
+    getStats(): {
+        isPaused: boolean;
+        pauseCount: number;
+        isFocused: boolean;
+    };
+}
+declare function getSmartFocusManager(): SmartFocusManager;
+declare function resetSmartFocusManager(): void;
+
+declare const queryKeys: {
+    all: readonly ["tanstack-query"];
+    users: () => readonly ["tanstack-query", "users"];
+    user: (id: string) => readonly ["tanstack-query", "users", string];
+    userProfile: (id: string) => readonly ["tanstack-query", "users", string, "profile"];
+    userSettings: (id: string) => readonly ["tanstack-query", "users", string, "settings"];
+    usersByRole: (role: string) => readonly ["tanstack-query", "users", "by-role", string];
+    posts: () => readonly ["tanstack-query", "posts"];
+    post: (id: string) => readonly ["tanstack-query", "posts", string];
+    postsByUser: (userId: string) => readonly ["tanstack-query", "posts", "by-user", string];
+    postsByTag: (tag: string) => readonly ["tanstack-query", "posts", "by-tag", string];
+    postComments: (postId: string) => readonly ["tanstack-query", "posts", string, "comments"];
+    search: (query: string, type?: string) => readonly ["tanstack-query", "search", {
+        readonly query: string;
+        readonly type: string | undefined;
+    }];
+    notifications: () => readonly ["tanstack-query", "notifications"];
+    notification: (id: string) => readonly ["tanstack-query", "notifications", string];
+    unreadNotifications: () => readonly ["tanstack-query", "notifications", "unread"];
+    settings: () => readonly ["tanstack-query", "settings"];
+    appSettings: () => readonly ["tanstack-query", "settings", "app"];
+    userPreferences: (userId: string) => readonly ["tanstack-query", "settings", "preferences", string];
+};
+declare function createFilteredKey(baseKey: QueryKey, filters: Record<string, unknown>): QueryKey;
+declare function createPaginatedKey(baseKey: QueryKey, page: number, pageSize: number): QueryKey;
+declare function createSortedKey(baseKey: QueryKey, sortBy: string, sortOrder?: "asc" | "desc"): QueryKey;
+declare function createSearchKey(baseKey: QueryKey, searchTerm: string, searchFields?: string[]): QueryKey;
+declare function createComplexKey(baseKey: QueryKey, options: {
+    page?: number;
+    pageSize?: number;
+    filters?: Record<string, unknown>;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+    search?: string;
+}): QueryKey;
+declare function matchesKeyPattern(queryKey: QueryKey, pattern: QueryKey): boolean;
+declare function validateQueryKey(queryKey: QueryKey): boolean;
+declare function containsEntity(queryKey: QueryKey, entity: string): boolean;
+declare function extractEntityId(queryKey: QueryKey, entityIndex: number): string | undefined;
+declare function normalizeQueryKey(queryKey: QueryKey): QueryKey;
+declare function areKeysEqual(key1: QueryKey, key2: QueryKey): boolean;
+declare function createDomainKeyFactory(domain: string): {
+    all: () => readonly ["tanstack-query", string];
+    lists: () => readonly ["tanstack-query", string, "list"];
+    list: (params?: Record<string, unknown>) => readonly ["tanstack-query", string, "list"] | readonly ["tanstack-query", string, "list", Record<string, unknown>];
+    details: () => readonly ["tanstack-query", string, "detail"];
+    detail: (id: string | number) => readonly ["tanstack-query", string, "detail", string | number];
+    subResource: (id: string | number, resource: string) => readonly ["tanstack-query", string, "detail", string | number, string];
+    byRelation: (relation: string, relationId: string | number) => readonly ["tanstack-query", string, `by-${string}`, string | number];
+};
+declare function createMutationKeyFactory(domain: string): {
+    create: () => readonly [string, "create"];
+    update: (id?: string | number) => readonly [string, "update", string | number] | readonly [string, "update"];
+    delete: (id?: string | number) => readonly [string, "delete", string | number] | readonly [string, "delete"];
+    batch: (operation: string) => readonly [string, "batch", string];
+    custom: (operation: string, id?: string | number) => readonly [string, string, string | number] | readonly [string, string];
+};
+
+interface BaseQueryConfig<TData> {
+    queryKey: QueryKey;
+    queryFn: QueryFunction<TData, QueryKey>;
+    staleTime?: number;
+    gcTime?: number;
+    enabled?: boolean;
+}
+declare function createAppQueryOptions<TData>(config: BaseQueryConfig<TData>): UseQueryOptions<TData, DefaultError, TData, QueryKey>;
+interface SelectQueryConfig<TData, TSelected = TData> extends Omit<BaseQueryConfig<TData>, "enabled"> {
+    select: (data: TData) => TSelected;
+}
+declare function createAppQueryOptionsWithSelect<TData, TSelected = TData>(config: SelectQueryConfig<TData, TSelected>): UseQueryOptions<TData, DefaultError, TSelected, QueryKey>;
+interface ListQueryConfig<TData> extends Omit<BaseQueryConfig<TData>, "staleTime" | "gcTime"> {
+    staleTime?: number;
+    gcTime?: number;
+}
+declare function createListQueryOptions<TData>(config: ListQueryConfig<TData>): UseQueryOptions<TData, DefaultError, TData, QueryKey>;
+
+export { DEFAULT_GC_TIME, DEFAULT_MUTATION_CONFIG, DEFAULT_QUERY_CONFIG, DEFAULT_STALE_TIME, DEVELOPMENT_CONFIG, type FocusManagerConfig, GLOBAL_QUERY_CONFIG, LONG_CACHE_CONFIG, type ListQueryConfig, PRODUCTION_CONFIG, REALTIME_CONFIG, SMART_RETRY_MUTATION_CONFIG, SmartFocusManager, TIME_CONSTANTS, areKeysEqual, containsEntity, createAppQueryOptions, createAppQueryOptionsWithSelect, createComplexKey, createCustomConfig, createDomainKeyFactory, createErrorSafeConfig, createFilteredKey, createListQueryOptions, createMutationKeyFactory, createPaginatedKey, createSafeRetryStrategy, createSearchKey, createSortedKey, defaultMutationRetryStrategy, defaultQueryRetryStrategy, ensureBestPractices, exponentialBackoff, extractEntityId, getConfigByEnvironment, getSmartFocusManager, isDev, isProd, isTest, matchesKeyPattern, normalizeQueryKey, pauseFocusManager, queryKeys, resetSmartFocusManager, resumeFocusManager, setupFocusManager, validateConfig, validateGcTime, validateQueryKey };

package/dist/core/index.js

@@ -1,8 +1,7 @@
-export { createCustomConfig, DEFAULT_GC_TIME, DEFAULT_MUTATION_CONFIG, DEFAULT_QUERY_CONFIG, DEFAULT_STALE_TIME, defaultMutationRetryStrategy, defaultQueryRetryStrategy, DEVELOPMENT_CONFIG, ensureBestPractices, exponentialBackoff, getConfigByEnvironment, GLOBAL_QUERY_CONFIG, LONG_CACHE_CONFIG, PRODUCTION_CONFIG, REALTIME_CONFIG, createErrorSafeConfig, createSafeRetryStrategy, SMART_RETRY_MUTATION_CONFIG, TIME_CONSTANTS, validateConfig, validateGcTime } from "./config.js";
-export { createDevToolsConfig, defaultDevToolsConfig, isDevToolsEnabled } from "./devtools.js";
-export { ReactQueryDevtools } from "./devtools.js";
-export { isDev, isProd, isTest } from "./env.js";
-export { focusManager, getSmartFocusManager, pauseFocusManager, resetSmartFocusManager, resumeFocusManager, setupFocusManager, SmartFocusManager } from "./focusManager.js";
-export { areKeysEqual, containsEntity, createComplexKey, createDomainKeyFactory, createFilteredKey, createMutationKeyFactory, createPaginatedKey, createSearchKey, createSortedKey, extractEntityId, matchesKeyPattern, normalizeQueryKey, queryKeys, validateQueryKey } from "./keys.js";
-export { createAppQueryOptions, createAppQueryOptionsWithSelect } from "./queryOptions.js";
-export { createListQueryOptions } from "./queryOptions.js";
+export { areKeysEqual, containsEntity, createAppQueryOptions, createAppQueryOptionsWithSelect, createComplexKey, createDomainKeyFactory, createFilteredKey, createListQueryOptions, createMutationKeyFactory, createPaginatedKey, createSearchKey, createSortedKey, extractEntityId, matchesKeyPattern, normalizeQueryKey, queryKeys, validateQueryKey } from '../chunk-ADS2QTMP.js';
+export { ReactQueryDevtools, createDevToolsConfig, defaultDevToolsConfig, isDevToolsEnabled } from '../chunk-ZUEMBY4W.js';
+export { SmartFocusManager, focusManager, getSmartFocusManager, pauseFocusManager, resetSmartFocusManager, resumeFocusManager, setupFocusManager } from '../chunk-KC62H4VJ.js';
+export { DEFAULT_GC_TIME, DEFAULT_MUTATION_CONFIG, DEFAULT_QUERY_CONFIG, DEFAULT_STALE_TIME, DEVELOPMENT_CONFIG, GLOBAL_QUERY_CONFIG, LONG_CACHE_CONFIG, PRODUCTION_CONFIG, REALTIME_CONFIG, SMART_RETRY_MUTATION_CONFIG, TIME_CONSTANTS, createCustomConfig, createErrorSafeConfig, createSafeRetryStrategy, defaultMutationRetryStrategy, defaultQueryRetryStrategy, ensureBestPractices, exponentialBackoff, getConfigByEnvironment, validateConfig, validateGcTime } from '../chunk-EXITP7QO.js';
+export { isDev, isProd, isTest } from '../chunk-JN2Y6RSY.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/features/index.cjs

@@ -0,0 +1,76 @@
+'use strict';
+
+var chunkB4KO3K3E_cjs = require('../chunk-B4KO3K3E.cjs');
+require('../chunk-WEIXCDCA.cjs');
+require('../chunk-5J6OXSLW.cjs');
+require('../chunk-6MAYHLTE.cjs');
+require('../chunk-OFLCHKKE.cjs');
+
+
+
+Object.defineProperty(exports, "OfflineQueueManager", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.OfflineQueueManager; }
+});
+Object.defineProperty(exports, "calculateExponentialBackoff", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.calculateExponentialBackoff; }
+});
+Object.defineProperty(exports, "checkStorageSize", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.checkStorageSize; }
+});
+Object.defineProperty(exports, "clearCache", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.clearCache; }
+});
+Object.defineProperty(exports, "clearExpiredCache", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.clearExpiredCache; }
+});
+Object.defineProperty(exports, "configureOfflineQueries", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.configureOfflineQueries; }
+});
+Object.defineProperty(exports, "createOfflineQueueManager", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.createOfflineQueueManager; }
+});
+Object.defineProperty(exports, "createPersistOptions", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.createPersistOptions; }
+});
+Object.defineProperty(exports, "createPersister", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.createPersister; }
+});
+Object.defineProperty(exports, "getStorageStats", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.getStorageStats; }
+});
+Object.defineProperty(exports, "isOnline", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.isOnline; }
+});
+Object.defineProperty(exports, "migrateToIndexedDB", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.migrateToIndexedDB; }
+});
+Object.defineProperty(exports, "mutationRegistry", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.mutationRegistry; }
+});
+Object.defineProperty(exports, "serializeMutationKey", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.serializeMutationKey; }
+});
+Object.defineProperty(exports, "setupOnlineManager", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.setupOnlineManager; }
+});
+Object.defineProperty(exports, "subscribeToOnlineStatus", {
+  enumerable: true,
+  get: function () { return chunkB4KO3K3E_cjs.subscribeToOnlineStatus; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/features/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/features/index.d.cts

@@ -0,0 +1,86 @@
+import { QueryClient, Query } from '@tanstack/react-query';
+import { c as OfflineQueueConfig, b as OfflineMutationOperation, f as OfflineState, d as MutationFunctionRegistry } from '../offline-xxeA_-6V.cjs';
+import { Persister } from '@tanstack/react-query-persist-client';
+export { PersistedClient, Persister } from '@tanstack/react-query-persist-client';
+import '../base-CHnwqfyz.cjs';
+
+declare function setupOnlineManager(): void;
+declare const isOnline: () => boolean;
+declare function subscribeToOnlineStatus(callback: (online: boolean) => void): () => void;
+declare function configureOfflineQueries(_queryClient: QueryClient): void;
+declare function serializeMutationKey(mutationKey: unknown): string;
+declare function calculateExponentialBackoff(attempt: number, baseDelay?: number, maxDelay?: number): number;
+declare class MutationRegistry implements MutationFunctionRegistry {
+    private registry;
+    register(key: string, fn: () => Promise<unknown>): void;
+    get(key: string): (() => Promise<unknown>) | undefined;
+    unregister(key: string): void;
+    clear(): void;
+    getKeys(): string[];
+}
+declare const mutationRegistry: MutationRegistry;
+declare class OfflineQueueManager {
+    private queue;
+    private config;
+    private isExecuting;
+    private executionTimer;
+    private unsubscribeOnline;
+    private executingOperations;
+    constructor(config?: Partial<OfflineQueueConfig>);
+    add(operation: Omit<OfflineMutationOperation, "id" | "createdAt" | "retryCount">): Promise<string>;
+    remove(operationId: string): Promise<boolean>;
+    getState(): OfflineState;
+    getOperations(): OfflineMutationOperation[];
+    clear(): Promise<void>;
+    execute(): Promise<{
+        success: number;
+        failed: number;
+        skipped: number;
+    }>;
+    private executeOperation;
+    private sortOperationsByDependency;
+    private createBatches;
+    private persistQueue;
+    private loadQueue;
+    private cleanupOldOperations;
+    private setupOnlineListener;
+    private startAutoExecution;
+    private stopAutoExecution;
+    destroy(): void;
+}
+declare function createOfflineQueueManager(config?: Partial<OfflineQueueConfig>): OfflineQueueManager;
+
+interface PersistOptions {
+    maxAge?: number;
+    onlyPersistSuccess?: boolean;
+    dehydrateOptions?: {
+        shouldDehydrateQuery?: (query: Query) => boolean;
+    };
+}
+declare function createPersistOptions(config?: Partial<PersistOptions>): {
+    maxAge: number;
+    dehydrateOptions?: {
+        shouldDehydrateQuery?: (query: Query) => boolean;
+    };
+};
+declare function createPersister(storageKey?: string, storage?: Storage, onError?: (error: Error) => void): Persister | undefined;
+declare function clearCache(key?: string): void;
+declare function clearExpiredCache(key?: string, maxAge?: number): void;
+declare function migrateToIndexedDB(localStorageKey: string | undefined, indexedDBKey: string | undefined, indexedDBStorage: Storage | {
+    setItem: (key: string, value: string) => Promise<void>;
+}): Promise<boolean>;
+declare function checkStorageSize(key?: string): {
+    sizeInBytes: number;
+    sizeInMB: number;
+    shouldMigrate: boolean;
+    message: string;
+};
+declare function getStorageStats(key?: string): {
+    exists: boolean;
+    age?: number;
+    queriesCount?: number;
+    mutationsCount?: number;
+    sizeInfo: ReturnType<typeof checkStorageSize>;
+};
+
+export { OfflineQueueManager, type PersistOptions, calculateExponentialBackoff, checkStorageSize, clearCache, clearExpiredCache, configureOfflineQueries, createOfflineQueueManager, createPersistOptions, createPersister, getStorageStats, isOnline, migrateToIndexedDB, mutationRegistry, serializeMutationKey, setupOnlineManager, subscribeToOnlineStatus };