@qiaopeng/tanstack-query-plus 0.1.0

package/dist/types/infinite.d.ts

@@ -0,0 +1,39 @@
+export interface CursorPaginatedResponse<T> {
+    items: T[];
+    cursor?: string | null;
+    hasMore?: boolean;
+}
+export interface OffsetPaginatedResponse<T> {
+    items: T[];
+    offset: number;
+    limit: number;
+    total: number;
+    hasMore?: boolean;
+}
+export interface PageNumberPaginatedResponse<T> {
+    items: T[];
+    page: number;
+    pageSize: number;
+    totalPages: number;
+    totalItems: number;
+}
+export interface PaginationParams {
+    cursor?: string;
+    offset?: number;
+    page?: number;
+    limit?: number;
+    pageSize?: number;
+}
+export interface PaginationMeta {
+    currentPage?: number;
+    totalPages?: number;
+    totalItems?: number;
+    pageSize?: number;
+    hasNextPage?: boolean;
+    hasPreviousPage?: boolean;
+}
+export interface PaginatedResponseWithMeta<T> {
+    items: T[];
+    meta: PaginationMeta;
+}
+//# sourceMappingURL=infinite.d.ts.map

package/dist/types/infinite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infinite.d.ts","sourceRoot":"","sources":["../../src/types/infinite.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB,CAAC,CAAC;IAAI,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;AACrG,MAAM,WAAW,uBAAuB,CAAC,CAAC;IAAI,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;AAC3H,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAAI,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACtI,MAAM,WAAW,gBAAgB;IAAG,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE;AACxH,MAAM,WAAW,cAAc;IAAG,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE;AACvK,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAAI,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,IAAI,EAAE,cAAc,CAAA;CAAE"}

package/dist/types/infinite.js

@@ -0,0 +1 @@
+export {};

package/dist/types/offline.d.ts

@@ -0,0 +1,97 @@
+import type { QueryKey } from "@tanstack/react-query";
+import type { NetworkStatus, OperationResult } from "./base";
+export interface OfflineRecoveryConfig {
+    enabled: boolean;
+    retryInterval: number;
+    maxRetries: number;
+    retryDelay: number;
+    customRetryDelay?: (attempt: number) => number;
+    networkCheckInterval: number;
+    retryOnReconnect: boolean;
+    refetchOnWindowFocus: boolean;
+    queryFilter?: (queryKey: QueryKey) => boolean;
+    checkInterval?: number;
+    refetchOnReconnect?: boolean;
+}
+export interface OfflineQueryInfo {
+    queryKey: QueryKey;
+    queryFn: () => Promise<unknown>;
+    failedAt: Date;
+    retryCount: number;
+    lastError?: Error;
+    isPaused: boolean;
+    metadata?: Record<string, unknown>;
+}
+export declare enum MutationOperationType {
+    CREATE = "create",
+    UPDATE = "update",
+    DELETE = "delete",
+    PATCH = "patch",
+    CUSTOM = "custom"
+}
+export interface OfflineMutationOperation {
+    id: string;
+    type: MutationOperationType;
+    mutationKey: QueryKey;
+    mutationFn: () => Promise<unknown>;
+    variables: unknown;
+    createdAt: Date;
+    retryCount: number;
+    lastError?: Error;
+    priority: number;
+    dependsOn?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface OfflineQueueConfig {
+    enabled: boolean;
+    maxSize: number;
+    persist: boolean;
+    storageKey: string;
+    autoExecuteInterval: number;
+    executeOnReconnect: boolean;
+    operationTimeout: number;
+    concurrency: number;
+}
+export interface MutationFunctionRegistry {
+    register: (key: string, fn: () => Promise<unknown>) => void;
+    get: (key: string) => (() => Promise<unknown>) | undefined;
+    unregister: (key: string) => void;
+    clear: () => void;
+    getKeys: () => string[];
+}
+export interface OfflineManagerConfig {
+    networkCheck: {
+        interval: number;
+        url?: string;
+        timeout: number;
+    };
+    queue: OfflineQueueConfig;
+    recovery: OfflineRecoveryConfig;
+    callbacks?: {
+        onNetworkChange?: (status: NetworkStatus) => void;
+        onQueueOperation?: (operation: OfflineMutationOperation, result: OperationResult) => void;
+        onRecoveryComplete?: (recoveredCount: number) => void;
+    };
+}
+export interface OfflineState {
+    isOffline: boolean;
+    networkStatus: NetworkStatus;
+    queuedOperations: number;
+    failedQueries: number;
+    lastSyncAt?: Date;
+    isRecovering: boolean;
+}
+export interface OfflineQueryOptions {
+    enabled?: boolean;
+    fallbackData?: unknown;
+    showStaleWhileOffline?: boolean;
+    onReconnect?: "refetch" | "keep" | "invalidate";
+}
+export interface OfflineMutationOptions {
+    enableQueue?: boolean;
+    priority?: number;
+    dependsOn?: string[];
+    optimisticUpdate?: (variables: unknown) => void;
+    rollback?: (variables: unknown) => void;
+}
+//# sourceMappingURL=offline.d.ts.map

package/dist/types/offline.d.ts.map

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

package/dist/types/offline.js

@@ -0,0 +1,8 @@
+export var MutationOperationType;
+(function (MutationOperationType) {
+    MutationOperationType["CREATE"] = "create";
+    MutationOperationType["UPDATE"] = "update";
+    MutationOperationType["DELETE"] = "delete";
+    MutationOperationType["PATCH"] = "patch";
+    MutationOperationType["CUSTOM"] = "custom";
+})(MutationOperationType || (MutationOperationType = {}));

package/dist/types/optimistic.d.ts

@@ -0,0 +1,126 @@
+import type { QueryKey } from "@tanstack/react-query";
+import type { EntityWithId } from "./selectors";
+export interface OptimisticUpdateConfig<TData = unknown, TVariables = unknown> {
+    queryKey: QueryKey;
+    updater: (oldData: TData | undefined, variables: TVariables) => TData | undefined;
+    rollback?: (previousData: TData, error: Error) => void;
+    enabled?: boolean;
+}
+export interface OptimisticContext<TData = unknown> {
+    previousData?: TData;
+    timestamp: number;
+    operationType: OptimisticOperationTypeValue;
+}
+export declare const OptimisticOperationType: {
+    readonly CREATE: "create";
+    readonly UPDATE: "update";
+    readonly DELETE: "delete";
+    readonly BATCH: "batch";
+};
+export type OptimisticOperationTypeValue = (typeof OptimisticOperationType)[keyof typeof OptimisticOperationType];
+export interface ListOperationConfig<T extends EntityWithId> {
+    queryKey: QueryKey;
+    operation: ListOperationType;
+    onRollback?: (error: Error, context: OptimisticContext<T[]>) => void;
+}
+export declare enum ListOperationType {
+    ADD = "add",
+    UPDATE = "update",
+    REMOVE = "remove"
+}
+export interface BatchQueryResult<TData = unknown, TError = Error> {
+    data: TData | undefined;
+    isLoading: boolean;
+    isError: boolean;
+    error: TError | null;
+    status: "pending" | "error" | "success";
+}
+export type OptimisticUpdater<TData = unknown, TVariables = unknown> = (oldData: TData | undefined, variables: TVariables) => TData;
+export type RollbackFunction<TData = unknown> = (previousData: TData, error: Error) => void;
+export type ListUpdater<T extends EntityWithId> = {
+    add: (items: T[] | undefined, newItem: T) => T[];
+    update: (items: T[] | undefined, updatedItem: Partial<T> & {
+        id: T["id"];
+    }) => T[];
+    remove: (items: T[] | undefined, itemId: T["id"]) => T[];
+};
+export interface OptimisticGlobalConfig {
+    enabledByDefault: boolean;
+    defaultRollbackDelay: number;
+    debugMode: boolean;
+    maxRetries: number;
+}
+export interface BatchQueryStats {
+    total: number;
+    loading: number;
+    success: number;
+    error: number;
+    stale: number;
+    successRate: number;
+    errorRate: number;
+}
+export interface BatchQueryConfig<TData = unknown, TError = Error> {
+    enableStats?: boolean;
+    enableBatchOperations?: boolean;
+    autoRefreshInterval?: number;
+    onBatchSuccess?: (results: TData[]) => void;
+    onBatchError?: (errors: TError[]) => void;
+    onBatchSettled?: (results: TData[], errors: TError[]) => void;
+    retryConfig?: BatchRetryConfig;
+    enablePartialSuccess?: boolean;
+    onPartialSuccess?: (report: BatchOperationReport<TData, TError>) => void;
+}
+export interface BatchRetryConfig {
+    maxRetries?: number;
+    retryDelay?: number | ((attemptIndex: number) => number);
+    retryOnlyFailed?: boolean;
+    shouldRetry?: (error: Error, attemptCount: number) => boolean;
+}
+export interface BatchOperationReport<TData = unknown, TError = Error> {
+    total: number;
+    successful: number;
+    failed: number;
+    successResults: Array<{
+        index: number;
+        data: TData;
+    }>;
+    failureErrors: Array<{
+        index: number;
+        error: TError;
+        queryKey?: unknown[];
+    }>;
+    isPartialSuccess: boolean;
+    isFullSuccess: boolean;
+    isFullFailure: boolean;
+    duration: number;
+    retryCount?: number;
+}
+export interface BatchErrorAggregate<TError = Error> {
+    totalErrors: number;
+    errors: Array<{
+        index: number;
+        error: TError;
+        queryKey?: unknown[];
+    }>;
+    errorsByType: Map<string, TError[]>;
+    firstError: TError | null;
+    lastError: TError | null;
+    errorSummary: string;
+}
+export interface BatchQueryOperations {
+    refetchAll: () => Promise<PromiseSettledResult<unknown>[]>;
+    invalidateAll: () => Promise<PromiseSettledResult<void>[]>;
+    cancelAll: () => Promise<PromiseSettledResult<void>[]>;
+    resetAll: () => Promise<PromiseSettledResult<void>[]>;
+    removeAll: () => void;
+    retryFailed: () => Promise<BatchOperationReport>;
+    getErrorAggregate: () => BatchErrorAggregate;
+    getOperationReport: () => BatchOperationReport;
+}
+export interface EnhancedBatchQueryResult<TData = unknown, TCombinedResult = TData, TError = Error> {
+    data: TCombinedResult;
+    stats: BatchQueryStats;
+    operations: BatchQueryOperations;
+    config: BatchQueryConfig<TData, TError>;
+}
+//# sourceMappingURL=optimistic.d.ts.map

package/dist/types/optimistic.d.ts.map

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

package/dist/types/optimistic.js

@@ -0,0 +1,7 @@
+export const OptimisticOperationType = { CREATE: "create", UPDATE: "update", DELETE: "delete", BATCH: "batch" };
+export var ListOperationType;
+(function (ListOperationType) {
+    ListOperationType["ADD"] = "add";
+    ListOperationType["UPDATE"] = "update";
+    ListOperationType["REMOVE"] = "remove";
+})(ListOperationType || (ListOperationType = {}));

package/dist/types/persistence.d.ts

@@ -0,0 +1,9 @@
+export interface StorageInfo {
+    type: import("./base").StorageType;
+    used: number;
+    total: number;
+    usage: number;
+    available: boolean;
+    error?: string;
+}
+//# sourceMappingURL=persistence.d.ts.map

package/dist/types/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../src/types/persistence.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,OAAO,QAAQ,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE"}

package/dist/types/persistence.js

@@ -0,0 +1 @@
+export {};

package/dist/types/selectors.d.ts

@@ -0,0 +1,11 @@
+export type Selector<TInput, TOutput> = (data: TInput | undefined) => TOutput;
+export type EntityWithId<T = string | number> = {
+    id: T;
+    [key: string]: unknown;
+};
+export type PaginatedData<T> = {
+    items: T[];
+    total?: number;
+    [key: string]: unknown;
+};
+//# sourceMappingURL=selectors.d.ts.map

package/dist/types/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../src/types/selectors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC;AAC9E,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,IAAI;IAAE,EAAE,EAAE,CAAC,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAClF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC"}

package/dist/types/selectors.js

@@ -0,0 +1 @@
+export {};

package/dist/types/suspense.d.ts

@@ -0,0 +1,67 @@
+import type { InfiniteData, QueryKey, UseSuspenseInfiniteQueryOptions, UseSuspenseInfiniteQueryResult, UseSuspenseQueryOptions, UseSuspenseQueryResult } from "@tanstack/react-query";
+import type { ReactNode } from "react";
+export interface EnhancedSuspenseQueryOptions<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey> extends Omit<UseSuspenseQueryOptions<TQueryFnData, TError, TData, TQueryKey>, "queryKey" | "queryFn"> {
+    enableAutoRefresh?: boolean;
+    refreshInterval?: number;
+}
+export interface EnhancedSuspenseInfiniteQueryOptions<TQueryFnData = unknown, TError = Error, TData = TQueryFnData, TQueryKey extends QueryKey = QueryKey, TPageParam = unknown> extends Omit<UseSuspenseInfiniteQueryOptions<TQueryFnData, TError, TData, TQueryKey, TPageParam>, "queryKey" | "queryFn"> {
+    enableAutoRefresh?: boolean;
+    refreshInterval?: number;
+}
+export type SuspenseQueryFunction<TQueryFnData = unknown, TQueryKey extends QueryKey = QueryKey> = (context: {
+    queryKey: TQueryKey;
+    signal: AbortSignal;
+}) => Promise<TQueryFnData>;
+export type SuspenseInfiniteQueryFunction<TQueryFnData = unknown, TQueryKey extends QueryKey = QueryKey, TPageParam = unknown> = (context: {
+    queryKey: TQueryKey;
+    signal: AbortSignal;
+    pageParam: TPageParam;
+}) => Promise<TQueryFnData>;
+export type EnhancedSuspenseQueryResult<TData = unknown, TError = Error> = UseSuspenseQueryResult<TData, TError>;
+export type EnhancedSuspenseInfiniteQueryResult<TData = unknown, TError = Error> = UseSuspenseInfiniteQueryResult<InfiniteData<TData>, TError>;
+export interface SuspenseWrapperProps {
+    children: ReactNode;
+    fallback?: ReactNode;
+    errorFallback?: (error: Error, resetErrorBoundary: () => void) => ReactNode;
+    onError?: (error: Error, errorInfo: {
+        componentStack: string;
+    }) => void;
+    resetKeys?: Array<string | number>;
+}
+export interface ErrorBoundaryProps {
+    children: ReactNode;
+    fallback?: (error: Error, resetErrorBoundary: () => void) => ReactNode;
+    onError?: (error: Error, errorInfo: {
+        componentStack: string;
+    }) => void;
+    onReset?: () => void;
+    resetKeys?: Array<string | number>;
+}
+export interface ErrorBoundaryState {
+    hasError: boolean;
+    error?: Error;
+}
+export interface LoadingFallbackProps {
+    message?: string;
+    size?: "small" | "medium" | "large";
+    className?: string;
+}
+export interface ErrorFallbackProps {
+    error: Error;
+    resetErrorBoundary: () => void;
+    className?: string;
+}
+export interface SuspenseConfig {
+    defaultStaleTime?: number;
+    defaultGcTime?: number;
+    defaultRetry?: number | boolean;
+    enableDevtools?: boolean;
+}
+export type QueryStatus = "pending" | "error" | "success";
+export interface QueryMetadata {
+    queryKey: QueryKey;
+    status: QueryStatus;
+    lastUpdated?: Date;
+    errorCount?: number;
+}
+//# sourceMappingURL=suspense.d.ts.map

package/dist/types/suspense.d.ts.map

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

package/dist/types/suspense.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/fieldMapper.d.ts

@@ -0,0 +1,9 @@
+import type { QueryClient } from "@tanstack/react-query";
+export interface FieldMappingConfig {
+    nameField: string;
+    configKey: string;
+}
+export declare function createFieldEnricher<T = any>(queryKey: any, mappings: Record<string, FieldMappingConfig>): (data: T, queryClient: QueryClient) => T;
+export declare function createTempId(prefix?: string): string;
+export declare function createOptimisticBase(customFields?: Record<string, any>): Record<string, any>;
+//# sourceMappingURL=fieldMapper.d.ts.map

package/dist/utils/fieldMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldMapper.d.ts","sourceRoot":"","sources":["../../src/utils/fieldMapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,MAAM,WAAW,kBAAkB;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;AAC5E,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,IAC9F,MAAM,CAAC,EAAE,aAAa,WAAW,KAAG,CAAC,CAe9C;AACD,wBAAgB,YAAY,CAAC,MAAM,SAAS,GAAG,MAAM,CAAgF;AACrI,wBAAgB,oBAAoB,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAG5F"}

package/dist/utils/fieldMapper.js

@@ -0,0 +1,27 @@
+export function createFieldEnricher(queryKey, mappings) {
+    return (data, queryClient) => {
+        const config = queryClient.getQueryData(queryKey);
+        if (!config)
+            return data;
+        const result = { ...data };
+        Object.entries(mappings).forEach(([idField, { nameField, configKey }]) => {
+            const idValue = data[idField];
+            if (idValue == null)
+                return;
+            const options = config[configKey];
+            if (!options?.length)
+                return;
+            const optionMap = new Map(options.map((item) => [String(item.value), item.label]));
+            const label = optionMap.get(String(idValue));
+            if (label) {
+                result[nameField] = label;
+            }
+        });
+        return result;
+    };
+}
+export function createTempId(prefix = "temp") { return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`; }
+export function createOptimisticBase(customFields) {
+    const now = new Date().toISOString();
+    return { createTime: now, updateTime: now, createUser: "", updateUser: "", deleteStatus: 0, ...customFields };
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,9 @@
+export { createFieldEnricher, createOptimisticBase, createTempId, type FieldMappingConfig } from "./fieldMapper.js";
+export { getNetworkInfo, getNetworkSpeed, isFastNetwork, isSlowNetwork, type NavigatorWithConnection } from "./network.js";
+export { batchRemoveItems, batchUpdateItems, conditionalUpdateItems, createAddItemConfig, createListOperationConfig, createRemoveItemConfig, createUpdateItemConfig, type ListOperationVariables, listUpdater, reorderItems } from "./optimisticUtils.js";
+export { keepPreviousData } from "./placeholderData.js";
+export { getPrefetchManager, type InteractionRecord, type NetworkSpeed, type PredictionResult, type PrefetchConfig, type PrefetchStats, type PrefetchTask, resetPrefetchManager, SmartPrefetchManager } from "./prefetchManager.js";
+export { createQueryKeyFactory, createSimpleQueryKeyFactory, extractParamsFromKey, isQueryKeyEqual, type NormalizeConfig, normalizeQueryParams, type QueryKeyFactory, type QueryKeyFactoryConfig } from "./queryKey.js";
+export { compose, selectById, selectByIds, selectCount, selectField, selectFields, selectFirst, selectItems, selectLast, selectMap, selectors, selectTotal, selectWhere } from "./selectors.js";
+export { deepClone, formatBytes, getStorageUsage, isStorageAvailable } from "./storage.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACpH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC3H,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC1P,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACpO,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACxN,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChM,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,8 @@
+export { createFieldEnricher, createOptimisticBase, createTempId } from "./fieldMapper.js";
+export { getNetworkInfo, getNetworkSpeed, isFastNetwork, isSlowNetwork } from "./network.js";
+export { batchRemoveItems, batchUpdateItems, conditionalUpdateItems, createAddItemConfig, createListOperationConfig, createRemoveItemConfig, createUpdateItemConfig, listUpdater, reorderItems } from "./optimisticUtils.js";
+export { keepPreviousData } from "./placeholderData.js";
+export { getPrefetchManager, resetPrefetchManager, SmartPrefetchManager } from "./prefetchManager.js";
+export { createQueryKeyFactory, createSimpleQueryKeyFactory, extractParamsFromKey, isQueryKeyEqual, normalizeQueryParams } from "./queryKey.js";
+export { compose, selectById, selectByIds, selectCount, selectField, selectFields, selectFirst, selectItems, selectLast, selectMap, selectors, selectTotal, selectWhere } from "./selectors.js";
+export { deepClone, formatBytes, getStorageUsage, isStorageAvailable } from "./storage.js";

package/dist/utils/network.d.ts

@@ -0,0 +1,9 @@
+import type { NetworkInformation } from "../types/base";
+export interface NavigatorWithConnection extends Navigator {
+    connection?: NetworkInformation;
+}
+export declare function isSlowNetwork(): boolean;
+export declare function getNetworkInfo(): NetworkInformation | null;
+export declare function isFastNetwork(): boolean;
+export declare function getNetworkSpeed(): "fast" | "medium" | "slow" | "unknown";
+//# sourceMappingURL=network.d.ts.map

package/dist/utils/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/utils/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,MAAM,WAAW,uBAAwB,SAAQ,SAAS;IAAG,UAAU,CAAC,EAAE,kBAAkB,CAAA;CAAE;AAE9F,wBAAgB,aAAa,IAAI,OAAO,CAMvC;AACD,wBAAgB,cAAc,IAAI,kBAAkB,GAAG,IAAI,CAI1D;AACD,wBAAgB,aAAa,IAAI,OAAO,CAIvC;AACD,wBAAgB,eAAe,IAAI,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAUxE"}

package/dist/utils/network.js

@@ -0,0 +1,43 @@
+function hasConnectionAPI(nav) { return "connection" in nav; }
+export function isSlowNetwork() {
+    if (typeof navigator === "undefined") {
+        return false;
+    }
+    if (!hasConnectionAPI(navigator)) {
+        return false;
+    }
+    const connection = navigator.connection;
+    if (!connection) {
+        return false;
+    }
+    return connection.effectiveType === "slow-2g" || connection.effectiveType === "2g" || connection.saveData === true;
+}
+export function getNetworkInfo() {
+    if (typeof navigator === "undefined") {
+        return null;
+    }
+    if (!hasConnectionAPI(navigator)) {
+        return null;
+    }
+    return navigator.connection || null;
+}
+export function isFastNetwork() {
+    const networkInfo = getNetworkInfo();
+    if (!networkInfo) {
+        return true;
+    }
+    return networkInfo.effectiveType === "4g" && networkInfo.saveData !== true;
+}
+export function getNetworkSpeed() {
+    const networkInfo = getNetworkInfo();
+    if (!networkInfo || !networkInfo.effectiveType) {
+        return "unknown";
+    }
+    switch (networkInfo.effectiveType) {
+        case "4g": return "fast";
+        case "3g": return "medium";
+        case "2g":
+        case "slow-2g": return "slow";
+        default: return "unknown";
+    }
+}

package/dist/utils/optimisticUtils.d.ts

@@ -0,0 +1,34 @@
+import type { QueryKey } from "@tanstack/react-query";
+import type { ListOperationConfig, OptimisticUpdateConfig } from "../types/optimistic";
+import type { EntityWithId } from "../types/selectors";
+import { ListOperationType } from "../types/optimistic.js";
+export declare const listUpdater: {
+    add: <T extends EntityWithId>(items: T[] | undefined, newItem: T) => T[];
+    update: <T extends EntityWithId>(items: T[] | undefined, updatedItem: Partial<T> & {
+        id: T["id"];
+    }) => T[];
+    remove: <T extends EntityWithId>(items: T[] | undefined, itemId: T["id"]) => T[];
+};
+export declare function createAddItemConfig<T extends EntityWithId>(queryKey: QueryKey, options?: {
+    addToTop?: boolean;
+    onRollback?: (error: Error) => void;
+}): OptimisticUpdateConfig<T[], T>;
+export declare function createUpdateItemConfig<T extends EntityWithId>(queryKey: QueryKey, options?: {
+    onRollback?: (error: Error) => void;
+}): OptimisticUpdateConfig<T[], Partial<T> & {
+    id: T["id"];
+}>;
+export declare function createRemoveItemConfig<T extends EntityWithId>(queryKey: QueryKey, options?: {
+    onRollback?: (error: Error) => void;
+}): OptimisticUpdateConfig<T[], T["id"]>;
+export type ListOperationVariables<T extends EntityWithId, TOperation extends ListOperationType> = TOperation extends ListOperationType.ADD ? T : TOperation extends ListOperationType.UPDATE ? Partial<T> & {
+    id: T["id"];
+} : TOperation extends ListOperationType.REMOVE ? T["id"] : never;
+export declare function createListOperationConfig<T extends EntityWithId, TOperation extends ListOperationType = ListOperationType>(config: ListOperationConfig<T>): OptimisticUpdateConfig<T[], ListOperationVariables<T, TOperation>>;
+export declare function batchUpdateItems<T extends EntityWithId>(items: T[] | undefined | null, updates: Array<Partial<T> & {
+    id: T["id"];
+}>): T[];
+export declare function batchRemoveItems<T extends EntityWithId>(items: T[] | undefined | null, itemIds: Array<T["id"]>): T[];
+export declare function reorderItems<T extends EntityWithId>(items: T[] | undefined | null, fromIndex: number, toIndex: number): T[];
+export declare function conditionalUpdateItems<T extends EntityWithId>(items: T[] | undefined | null, predicate: (item: T) => boolean, updater: (item: T) => Partial<T>): T[];
+//# sourceMappingURL=optimisticUtils.d.ts.map

package/dist/utils/optimisticUtils.d.ts.map

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