@croacroa/react-native-template 2.1.0 → 3.2.0

package/hooks/useFeatureFlag.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview React hooks for feature flag evaluation
+ * Provides `useFeatureFlag` for boolean checks and `useFeatureFlagValue`
+ * for typed flag values, both backed by the FeatureFlags facade.
+ * @module hooks/useFeatureFlag
+ */
+
+import { useState, useEffect } from "react";
+import { FeatureFlags } from "@/services/feature-flags/feature-flag-adapter";
+
+/**
+ * Hook that resolves a boolean feature flag.
+ *
+ * @param flag - The flag key to evaluate
+ * @param defaultValue - Value used until the flag is resolved (default `false`)
+ * @returns `{ isEnabled, isLoading }`
+ *
+ * @example
+ * ```tsx
+ * const { isEnabled, isLoading } = useFeatureFlag("new_checkout");
+ * if (isLoading) return <Loader />;
+ * return isEnabled ? <NewCheckout /> : <OldCheckout />;
+ * ```
+ */
+export function useFeatureFlag(flag: string, defaultValue = false) {
+  const [isEnabled, setIsEnabled] = useState(defaultValue);
+  const [isLoading, setIsLoading] = useState(true);
+
+  useEffect(() => {
+    setIsEnabled(FeatureFlags.isEnabled(flag, defaultValue));
+    setIsLoading(false);
+  }, [flag, defaultValue]);
+
+  return { isEnabled, isLoading };
+}
+
+/**
+ * Hook that resolves a feature flag with an arbitrary type.
+ *
+ * @param flag - The flag key to evaluate
+ * @param defaultValue - Value used until the flag is resolved
+ * @returns `{ value, isLoading }`
+ *
+ * @example
+ * ```tsx
+ * const { value: maxItems } = useFeatureFlagValue("max_cart_items", 10);
+ * ```
+ */
+export function useFeatureFlagValue<T>(flag: string, defaultValue: T) {
+  const [value, setValue] = useState<T>(defaultValue);
+  const [isLoading, setIsLoading] = useState(true);
+
+  useEffect(() => {
+    setValue(FeatureFlags.getValue(flag, defaultValue));
+    setIsLoading(false);
+  }, [flag, defaultValue]);
+
+  return { value, isLoading };
+}

package/hooks/useForceUpdate.ts

@@ -0,0 +1,91 @@
+/**
+ * @fileoverview Hook for app force-update checks
+ * Checks on mount whether the running app version satisfies the server's
+ * minimum version requirement and exposes the result to the UI.
+ * @module hooks/useForceUpdate
+ */
+
+import { useEffect, useState } from "react";
+import Constants from "expo-constants";
+
+import { FORCE_UPDATE } from "@/constants/config";
+import { checkForUpdate } from "@/services/force-update";
+import type { ForceUpdateResult } from "@/services/force-update";
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface UseForceUpdateReturn extends ForceUpdateResult {
+  /** Whether the check is still in progress */
+  isChecking: boolean;
+}
+
+// ============================================================================
+// Hook
+// ============================================================================
+
+/**
+ * Check on mount whether the app requires a mandatory native update.
+ *
+ * Uses `Constants.expoConfig?.version` as the current version and the
+ * `FORCE_UPDATE` configuration from `constants/config.ts`.
+ *
+ * When `FORCE_UPDATE.ENABLED` is `false` or `FORCE_UPDATE.CHECK_URL` is
+ * empty the hook returns immediately with `isUpdateRequired: false`.
+ *
+ * @returns Force-update state including loading indicator
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   const { isUpdateRequired, isChecking, storeUrl, currentVersion, minimumVersion } =
+ *     useForceUpdate();
+ *
+ *   if (isChecking) return <SplashScreen />;
+ *
+ *   if (isUpdateRequired) {
+ *     return (
+ *       <ForceUpdateScreen
+ *         storeUrl={storeUrl}
+ *         currentVersion={currentVersion}
+ *         minimumVersion={minimumVersion}
+ *       />
+ *     );
+ *   }
+ *
+ *   return <MainApp />;
+ * }
+ * ```
+ */
+export function useForceUpdate(): UseForceUpdateReturn {
+  const [isChecking, setIsChecking] = useState(true);
+  const [result, setResult] = useState<ForceUpdateResult>({
+    isUpdateRequired: false,
+    currentVersion: "",
+    minimumVersion: "",
+    storeUrl: "",
+  });
+
+  useEffect(() => {
+    // Skip the check entirely when force-update is disabled or unconfigured
+    if (!FORCE_UPDATE.ENABLED || !FORCE_UPDATE.CHECK_URL) {
+      setIsChecking(false);
+      return;
+    }
+
+    const currentVersion = Constants.expoConfig?.version ?? "1.0.0";
+
+    checkForUpdate({
+      checkUrl: FORCE_UPDATE.CHECK_URL,
+      currentVersion,
+    })
+      .then(setResult)
+      .finally(() => setIsChecking(false));
+  }, []);
+
+  return {
+    ...result,
+    isChecking,
+  };
+}