@umituz/react-native-tanstack 1.0.0 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-tanstack",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "TanStack Query configuration and utilities for React Native apps - Pre-configured QueryClient with AsyncStorage persistence",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/index.ts

@@ -72,6 +72,14 @@ export {
   type OptimisticUpdateConfig,
 } from './presentation/hooks/useOptimisticUpdate';
 
+// Presentation - Utils
+export {
+  createConditionalRetry,
+  createQuotaAwareRetry,
+  type RetryFunction,
+  type ErrorChecker,
+} from './presentation/utils/RetryHelpers';
+
 // Re-export TanStack Query core for convenience
 export {
   useQuery,

package/src/infrastructure/config/QueryClientConfig.ts

@@ -59,6 +59,11 @@ export const CacheStrategies: Record<CacheStrategyType, CacheConfig> = {
   },
 };
 
+/**
+ * Retry function type
+ */
+export type RetryFunction = (failureCount: number, error: Error) => boolean;
+
 /**
  * QueryClient factory options
  */
@@ -77,9 +82,10 @@ export interface QueryClientFactoryOptions {
 
   /**
    * Default retry configuration
+   * Can be a boolean, number, or custom retry function
    * @default 3
    */
-  defaultRetry?: boolean | number;
+  defaultRetry?: boolean | number | RetryFunction;
 
   /**
    * Enable development mode logging

package/src/infrastructure/providers/TanstackProvider.tsx

@@ -109,7 +109,7 @@ export function TanstackProvider({
   persisterOptions,
   onPersistSuccess,
   onPersistError,
-}: TanstackProviderProps): JSX.Element {
+}: TanstackProviderProps): React.ReactElement {
   // Create QueryClient if not provided
   const [queryClient] = React.useState(() => providedQueryClient ?? createQueryClient(queryClientOptions));
 

package/src/presentation/utils/RetryHelpers.ts

@@ -0,0 +1,67 @@
+/**
+ * Retry Helpers
+ * Presentation layer - Utility functions for retry logic
+ *
+ * General-purpose retry helpers for any React Native app
+ */
+
+/**
+ * Retry function type for TanStack Query
+ */
+export type RetryFunction = (failureCount: number, error: Error) => boolean;
+
+/**
+ * Error checker function type
+ */
+export type ErrorChecker = (error: unknown) => boolean;
+
+/**
+ * Creates a retry function that stops retrying on specific errors
+ *
+ * @param shouldNotRetry - Function to check if error should NOT be retried
+ * @param maxRetries - Maximum number of retries (default: 1)
+ *
+ * @example
+ * ```typescript
+ * const isQuotaError = (error: unknown) => {
+ *   return error instanceof Error && error.message.includes('quota');
+ * };
+ *
+ * const retryFn = createConditionalRetry(isQuotaError, 1);
+ * ```
+ */
+export function createConditionalRetry(
+  shouldNotRetry: ErrorChecker,
+  maxRetries = 1,
+): RetryFunction {
+  return (failureCount: number, error: Error) => {
+    // Don't retry if error matches condition
+    if (shouldNotRetry(error)) {
+      return false;
+    }
+
+    // Retry up to maxRetries times
+    return failureCount < maxRetries;
+  };
+}
+
+/**
+ * Creates a quota-aware retry function
+ * Stops retrying on quota errors, retries other errors
+ *
+ * @param isQuotaError - Function to check if error is quota-related
+ * @param maxRetries - Maximum number of retries (default: 1)
+ *
+ * @example
+ * ```typescript
+ * import { isQuotaError } from '@umituz/react-native-firestore';
+ *
+ * const retryFn = createQuotaAwareRetry(isQuotaError);
+ * ```
+ */
+export function createQuotaAwareRetry(
+  isQuotaError: ErrorChecker,
+  maxRetries = 1,
+): RetryFunction {
+  return createConditionalRetry(isQuotaError, maxRetries);
+}