create-react-native-starter-kit 0.0.0-stage → 1.0.0

package/template/src/hooks/app/useGetProfile.ts

@@ -0,0 +1,38 @@
+import { useEffect } from 'react';
+import { useQuery } from '@tanstack/react-query';
+import { QUERY_KEYS } from '@/constants/queryKey';
+import { useAppDispatch } from '@/hooks/useAppDispatch';
+import { useAppSelector } from '@/hooks/useAppSelector';
+import { selectIsAuthenticated } from '@/redux/selectors/auth.selectors';
+import { setUserAction } from '@/redux/slice/user.slice';
+import { getProfile } from '@/services/api/user/user.api';
+import { ErrorHandler } from '@/services/errors';
+
+/**
+ * Reference query hook: fetch the signed-in profile, cache it, and mirror it into Redux.
+ * Pass `enabled: false` when a screen should not load the profile yet.
+ */
+export const useGetProfile = (enabled = true) => {
+  const dispatch = useAppDispatch();
+  const isAuthenticated = useAppSelector(selectIsAuthenticated);
+
+  const query = useQuery({
+    queryKey: [QUERY_KEYS.profile],
+    queryFn: getProfile,
+    enabled: enabled && isAuthenticated,
+  });
+
+  useEffect(() => {
+    if (query.data?.data) {
+      dispatch(setUserAction(query.data.data));
+    }
+  }, [dispatch, query.data]);
+
+  useEffect(() => {
+    if (query.error) {
+      ErrorHandler(query.error);
+    }
+  }, [query.error]);
+
+  return query;
+};

package/template/src/hooks/app/useUpdateProfile.ts

@@ -0,0 +1,21 @@
+import i18n from '@/i18n';
+import { QUERY_KEYS } from '@/constants/queryKey';
+import { updateProfile } from '@/services/api/user/user.api';
+import { ErrorHandler } from '@/services/errors';
+import { SuccessToast } from '@/services/toast';
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+
+export const useUpdateProfile = () => {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: updateProfile,
+    onSuccess: res => {
+      SuccessToast({
+        title: res.message || i18n.t('profile.updateSuccess'),
+      });
+      queryClient.invalidateQueries({ queryKey: [QUERY_KEYS.profile] });
+    },
+    onError: ErrorHandler,
+  });
+};

package/template/src/hooks/useAppDispatch.ts

@@ -0,0 +1,6 @@
+import { AppDispatch } from '@/store';
+import { useDispatch } from 'react-redux';
+
+export const useAppDispatch = () => {
+  return useDispatch<AppDispatch>();
+};

package/template/src/hooks/useAppSelector.ts

@@ -0,0 +1,4 @@
+import { RootStoreState } from '@/store/rootReducer';
+import { TypedUseSelectorHook, useSelector } from 'react-redux';
+
+export const useAppSelector: TypedUseSelectorHook<RootStoreState> = useSelector;

package/template/src/hooks/useDebounce.ts

@@ -0,0 +1,15 @@
+import { useEffect, useState } from 'react';
+
+export function useDebounce<T>(value: T, delay: number = 400): T {
+  const [debouncedValue, setDebouncedValue] = useState(value);
+
+  useEffect(() => {
+    const timer = setTimeout(() => {
+      setDebouncedValue(value);
+    }, delay);
+
+    return () => clearTimeout(timer);
+  }, [value, delay]);
+
+  return debouncedValue;
+}

package/template/src/hooks/useDocumentPicker.ts

@@ -0,0 +1,102 @@
+import { useState, useCallback, useRef } from 'react';
+import { pickDocument } from '@/utils/documentPickerHandler';
+import { getFileNameFromUri } from '@/utils/getFileNameFromUri';
+import { pickImage } from '@/utils/imagePickerHandler';
+
+export type PickedFile = {
+  uri: string;
+  name?: string;
+  type?: string | null;
+  width?: number;
+  height?: number;
+};
+
+interface UseDocumentPickerOptions {
+  multiple?: boolean;
+  /** Camera capture max size (photos of documents). */
+  maxSize?: number;
+  quality?: number;
+}
+
+/**
+ * Document upload flow: files via document picker, camera via image capture.
+ */
+export const useDocumentPicker = (options?: UseDocumentPickerOptions) => {
+  const { multiple = false, maxSize = 1024, quality = 85 } = options || {};
+
+  const [documents, setDocuments] = useState<PickedFile[]>([]);
+  const isPickerOpen = useRef(false);
+
+  const appendOrReplace = useCallback(
+    (next: PickedFile[]) => {
+      if (!next.length) return;
+      if (multiple) {
+        setDocuments(prev => [...prev, ...next]);
+      } else {
+        setDocuments(next);
+      }
+    },
+    [multiple],
+  );
+
+  const pickFromFiles = useCallback(async () => {
+    if (isPickerOpen.current) return;
+
+    try {
+      isPickerOpen.current = true;
+      const result = await pickDocument({ multiple });
+      if (result.cancelled || !result.documents.length) return;
+
+      appendOrReplace(
+        result.documents.map(doc => ({
+          uri: doc.uri,
+          name: doc.name,
+          type: doc.type,
+        })),
+      );
+    } finally {
+      isPickerOpen.current = false;
+    }
+  }, [appendOrReplace, multiple]);
+
+  const captureFromCamera = useCallback(async () => {
+    if (isPickerOpen.current) return;
+
+    try {
+      isPickerOpen.current = true;
+      const result = await pickImage({
+        source: 'camera',
+        multiple: false,
+        maxSize,
+        quality,
+      });
+
+      if (result.cancelled || !result.images.length) return;
+
+      appendOrReplace(
+        result.images.map(img => ({
+          uri: img.uri,
+          width: img.width,
+          height: img.height,
+          name: getFileNameFromUri(img.uri),
+        })),
+      );
+    } finally {
+      isPickerOpen.current = false;
+    }
+  }, [appendOrReplace, maxSize, quality]);
+
+  const removeDocument = useCallback((uri: string) => {
+    setDocuments(prev => prev.filter(doc => doc.uri !== uri));
+  }, []);
+
+  const resetDocuments = useCallback(() => setDocuments([]), []);
+
+  return {
+    documents,
+    pickFromFiles,
+    captureFromCamera,
+    removeDocument,
+    resetDocuments,
+  };
+};

package/template/src/hooks/useImagePicker.ts

@@ -0,0 +1,83 @@
+import { useState, useCallback, useRef } from 'react';
+import { pickImage } from '@/utils/imagePickerHandler';
+
+type ImageResult = {
+  uri: string;
+  width: number;
+  height: number;
+};
+
+interface UseImagePickerOptions {
+  maxSize?: number;
+  quality?: number;
+
+  //For multiple Image select
+  multiple?: boolean;
+  selectionLimit?: number;
+}
+
+export const useImagePicker = (options?: UseImagePickerOptions) => {
+  const {
+    multiple = false,
+    maxSize = 512,
+    quality = 80,
+    selectionLimit = 0, //0 means unlimited selection
+  } = options || {};
+
+  const [images, setImages] = useState<ImageResult[]>([]);
+  const isImagePickerOpen = useRef<boolean>(false);
+
+  // ─────────────────────────────────────────────
+  // Internal picker handler
+  // ─────────────────────────────────────────────
+  const handlePick = useCallback(
+    async (source: 'camera' | 'gallery') => {
+      if (isImagePickerOpen.current) {
+        return;
+      }
+      try {
+        isImagePickerOpen.current = true;
+
+        const result = await pickImage({
+          source,
+          multiple,
+          maxSize,
+          quality,
+          selectionLimit,
+        });
+
+        if (!result.cancelled && result.images.length) {
+          if (multiple) {
+            setImages((prev: ImageResult[]) => [...prev, ...result.images]);
+          } else {
+            setImages(result.images);
+          }
+        }
+      } finally {
+        isImagePickerOpen.current = false;
+      }
+    },
+    [multiple, maxSize, quality, selectionLimit],
+  );
+
+  // ─────────────────────────────────────────────
+  // Public functions
+  // ─────────────────────────────────────────────
+  const pickFromGallery = () => handlePick('gallery');
+
+  const captureFromCamera = () => handlePick('camera');
+
+  const removeImage = (uri: string) => {
+    setImages((prev: ImageResult[]) => prev.filter(img => img.uri !== uri));
+  };
+
+  const resetImages = () => setImages([]);
+
+  return {
+    images,
+    pickFromGallery,
+    captureFromCamera,
+    removeImage,
+    resetImages,
+  };
+};

package/template/src/i18n/i18next.d.ts

@@ -0,0 +1,9 @@
+import 'i18next';
+import { resources } from './resources';
+
+declare module 'i18next' {
+  interface CustomTypeOptions {
+    defaultNS: 'translation';
+    resources: (typeof resources)['en'];
+  }
+}

package/template/src/i18n/index.ts

@@ -0,0 +1,16 @@
+import i18n from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import { resources } from './resources';
+
+i18n.use(initReactI18next).init({
+  resources,
+  lng: 'en',
+  fallbackLng: 'en',
+  supportedLngs: ['en', 'ru'],
+  interpolation: {
+    escapeValue: false,
+  },
+  compatibilityJSON: 'v4',
+});
+
+export default i18n;

package/template/src/i18n/locales/en.json

@@ -0,0 +1,274 @@
+{
+  "common": {
+    "loading": "Loading...",
+    "error": "Error",
+    "success": "Success",
+    "cancel": "Cancel",
+    "confirm": "Confirm",
+    "save": "Save",
+    "delete": "Delete",
+    "edit": "Edit",
+    "done": "Done",
+    "next": "Next",
+    "back": "Back",
+    "skip": "Skip",
+    "retry": "Retry",
+    "ok": "OK",
+    "yes": "Yes",
+    "no": "No",
+    "close": "Close",
+    "search": "Search",
+    "noResults": "No results found",
+    "emptyState": "Nothing here yet",
+    "continue": "Continue",
+    "info": "Info"
+  },
+  "auth": {
+    "login": "Login",
+    "signup": "Sign Up",
+    "logout": "Logout",
+    "email": "Email",
+    "password": "Password",
+    "confirmPassword": "Confirm Password",
+    "forgotPassword": "Forgot Password?",
+    "resetPassword": "Reset Password",
+    "rememberMe": "Remember me",
+    "dontHaveAccount": "Don't have an account?",
+    "alreadyHaveAccount": "Already have an account?",
+    "createAccount": "Create Account",
+    "welcomeBack": "Welcome back!",
+    "signInToContinue": "Sign in to continue",
+    "welcome-back": "Welcome Back 👋",
+    "reset": "Reset",
+    "dont-have-an-account": "Don’t have an account?",
+    "create-account": "Create Account",
+    "by-continuing-you-agree-to-our": "By continuing, you agree to our",
+    "terms-of-service": "Terms of Service",
+    "privacy-policy": "Privacy Policy",
+    "lets-get-started": "Let’s Get Started 🚀",
+    "send-now": "Send Now"
+  },
+  "user": {
+    "name": "Name",
+    "phone-number": "Phone number",
+    "gender": "Gender",
+    "date-of-birth": "Date of Birth",
+    "current-time": "Current time",
+    "address": "Address",
+    "enter-your-address": "Enter your address"
+  },
+  "navigation": {
+    "home": "Home",
+    "search": "Search",
+    "notifications": "Notifications",
+    "profile": "Profile",
+    "settings": "Settings"
+  },
+  "home": {
+    "greeting": "Hello, {{name}}",
+    "welcomeBack": "Welcome back!",
+    "recentActivity": "Recent Activity",
+    "noActivity": "No recent activity",
+    "quickActions": "Quick Actions"
+  },
+  "profile": {
+    "editProfile": "Edit Profile",
+    "myAccount": "My Account",
+    "preferences": "Preferences",
+    "privacy": "Privacy & Security",
+    "appearance": "Appearance",
+    "notifications": "Notifications",
+    "help": "Help & Support",
+    "about": "About",
+    "termsOfService": "Terms of Service",
+    "privacyPolicy": "Privacy Policy",
+    "rateApp": "Rate App",
+    "version": "Version {{version}}",
+    "updateSuccess": "Profile updated successfully"
+  },
+  "settings": {
+    "general": "General",
+    "account": "Account",
+    "notifications": "Notifications",
+    "privacy": "Privacy",
+    "language": "Language",
+    "theme": "Theme",
+    "darkMode": "Dark Mode",
+    "lightMode": "Light Mode",
+    "systemDefault": "System Default",
+    "changePassword": "Change Password",
+    "deleteAccount": "Delete Account",
+    "deleteAccountWarning": "This action cannot be undone. All your data will be permanently deleted."
+  },
+  "validation": {
+    "required": "{{field}} is required",
+    "minLength": "{{field}} must be at least {{min}} characters",
+    "maxLength": "{{field}} must be at most {{max}} characters",
+    "invalidEmail": "Please enter a valid email address",
+    "invalidPhone": "Please enter a valid phone number",
+    "hasLetter": "{{field}} must contain at least one letter",
+    "invalidZip": "Invalid zip code",
+    "strongPassword": "Password must include upper, lower, number & symbol",
+    "selectOption": "Please select an option for {{field}}"
+  },
+  "alerts": {
+    "logoutTitle": "Logout",
+    "logoutMessage": "Are you sure you want to logout?",
+    "deleteTitle": "Delete",
+    "deleteMessage": "Are you sure you want to delete this item?",
+    "unsavedChangesTitle": "Unsaved Changes",
+    "unsavedChangesMessage": "You have unsaved changes. Are you sure you want to leave?"
+  },
+  "placeholder": {
+    "search": "Search...",
+    "enterEmail": "Enter your email",
+    "enterPassword": "Enter your password",
+    "enterName": "Enter your name",
+    "enterPhone": "Enter your phone number",
+    "select-your-gender": "Select your gender",
+    "select-your-date-of-birth": "Select your date of birth",
+    "enter-your-current-time": "Enter your current time",
+    "enterAddress": "Enter your address"
+  },
+  "apiErrors": {
+    "userNotFound": "We couldn’t find an account with this information.",
+    "invalidToken": "Your session has expired. Please log in again.",
+    "emailExists": "An account with this email already exists.",
+    "weakPassword": "Your password is too weak. Please choose a stronger one.",
+    "accountDisabled": "Your account has been disabled. Please contact support."
+  },
+  "errors": {
+    "generic": "Something went wrong. Please try again.",
+    "network": "Network error. Please check your connection.",
+    "server": "Server error. Please try again later.",
+    "unauthorized": "You are not authorized. Please log in again.",
+    "notFound": "The requested resource could not be found.",
+    "validation": "Some information is invalid. Please check your input."
+  },
+  "firebase": {
+    "tooManyRequests": "Too many attempts. Please wait a moment and try again.",
+    "claimsTooLarge": "Something went wrong while verifying your account.",
+    "emailExists": "An account with this email already exists.",
+    "userNotFound": "No account found with this email.",
+    "wrongPassword": "The password you entered is incorrect.",
+    "emailAlreadyInUse": "This email is already linked to another account.",
+    "insufficientPermission": "You don’t have permission to perform this action.",
+    "internalError": "Something went wrong. Please try again.",
+    "invalidArgument": "Some information is invalid. Please check and try again.",
+    "invalidClaims": "Your account data could not be verified.",
+    "invalidContinueUri": "This action link is no longer valid.",
+    "invalidCreationTime": "There was an issue with your account data.",
+    "invalidCredential": "Your login details are invalid.",
+    "invalidDisabledField": "Some required information is missing.",
+    "invalidDisplayName": "Please enter a valid display name.",
+    "invalidDynamicLinkDomain": "This sign-in link is not supported.",
+    "invalidEmail": "Please enter a valid email address.",
+    "invalidEmailVerified": "Your email could not be verified.",
+    "invalidHashAlgorithm": "There was a security verification issue.",
+    "invalidHashBlockSize": "There was a security verification issue.",
+    "invalidHashDerivedKeyLength": "There was a security verification issue.",
+    "invalidHashKey": "There was a security verification issue.",
+    "invalidHashMemoryCost": "There was a security verification issue.",
+    "invalidHashParallelization": "There was a security verification issue.",
+    "invalidHashRounds": "There was a security verification issue.",
+    "invalidHashSaltSeparator": "There was a security verification issue.",
+    "invalidIdToken": "Your session has expired. Please sign in again.",
+    "invalidLastSignInTime": "We couldn’t verify your last login.",
+    "invalidPageToken": "We couldn’t load your data. Please try again.",
+    "invalidPassword": "Your password is not valid.",
+    "invalidPasswordHash": "There was a security issue. Please reset your password.",
+    "invalidPasswordSalt": "There was a security issue. Please reset your password.",
+    "invalidPhoneNumber": "Please enter a valid phone number.",
+    "invalidPhotoUrl": "Your profile image is not valid.",
+    "invalidProviderData": "Your sign-in provider data is invalid.",
+    "invalidProviderId": "This sign-in method is not supported.",
+    "invalidOauthResponseType": "This sign-in method is not supported.",
+    "invalidSessionCookieDuration": "Your session settings are invalid.",
+    "invalidUid": "We couldn’t verify your account.",
+    "invalidUserImport": "There was an issue importing your account.",
+    "maximumUserCountExceeded": "User limit reached. Please contact support.",
+    "missingAndroidPkgName": "This action is not supported on your device.",
+    "missingContinueUri": "This action link is incomplete.",
+    "missingHashAlgorithm": "There was a security verification issue.",
+    "missingIosBundleId": "This action is not supported on your device.",
+    "missingUid": "We couldn’t verify your account.",
+    "missingOauthClientSecret": "Configuration issue. Please try again later.",
+    "operationNotAllowed": "This action is currently disabled.",
+    "phoneNumberExists": "This phone number is already linked to another account.",
+    "projectNotFound": "App configuration error. Please try again later.",
+    "reservedClaims": "Your account could not be verified.",
+    "sessionCookieExpired": "Your session has expired. Please sign in again.",
+    "sessionCookieRevoked": "Your session has been revoked. Please sign in again.",
+    "uidExists": "This account already exists.",
+    "unauthorizedContinueUri": "This sign-in link is not authorized.",
+    "networkFailed": "Network error. Please check your connection.",
+    "developerError": "App configuration issue. Please contact support."
+  },
+  "http": {
+    "100": "Please wait, the request is still being processed.",
+    "101": "Connection is being updated. Please try again.",
+    "200": "Request completed successfully.",
+    "201": "Created successfully.",
+    "202": "Your request is being processed.",
+    "203": "Some information may be outdated.",
+    "204": "No content available for this request.",
+    "205": "Please refresh the page.",
+    "206": "Only part of the data was loaded. Try again.",
+    "300": "Multiple options found for this request.",
+    "301": "This resource has moved permanently.",
+    "302": "This resource has moved temporarily.",
+    "303": "Please follow the new link provided.",
+    "304": "Nothing has changed since your last request.",
+    "305": "Unable to access this resource right now.",
+    "307": "This resource is temporarily unavailable.",
+    "400": "Invalid request. Please check your input.",
+    "401": "Your session has expired. Please log in again.",
+    "402": "Payment is required to continue.",
+    "403": "You do not have permission to perform this action.",
+    "404": "We couldn’t find what you were looking for.",
+    "405": "This action is not allowed.",
+    "406": "The server cannot return the requested format.",
+    "407": "Authentication is required to proceed.",
+    "408": "The request timed out. Please try again.",
+    "409": "There was a conflict. Please try again.",
+    "410": "This resource is no longer available.",
+    "411": "Required information is missing.",
+    "412": "The request conditions were not met.",
+    "413": "The data is too large to process.",
+    "414": "The request URL is too long.",
+    "415": "Unsupported file or data type.",
+    "416": "Requested range is not available.",
+    "417": "The server could not meet the request expectations.",
+    "422": "Some information is invalid. Please check your input.",
+    "426": "Please update your app to continue.",
+    "428": "Additional conditions are required to continue.",
+    "429": "Too many requests. Please slow down.",
+    "431": "Request headers are too large.",
+    "500": "Something went wrong on our side. Please try again later.",
+    "501": "This feature is not supported yet.",
+    "502": "Server connection failed. Please try again.",
+    "503": "Service is temporarily unavailable. Try again later.",
+    "504": "Server took too long to respond. Try again.",
+    "505": "Your request could not be processed due to a protocol issue."
+  },
+  "home-screen": "Home Screen",
+  "network": {
+    "unavailableTitle": "No internet connection",
+    "unavailableMessage": "Internet is not available. Please check your connection.",
+    "unavailableBody": "Please check your Wi-Fi or mobile data and try again."
+  },
+  "imagePicker": {
+    "title": "Add a photo",
+    "subtitle": "Pick a clear photo for your profile.",
+    "camera": "Take photo",
+    "cameraHint": "Capture a new picture with your camera",
+    "gallery": "Choose from gallery",
+    "galleryHint": "Select an existing photo from your device",
+    "docTitle": "Upload a file",
+    "docSubtitle": "You can upload images, PDFs, and other documents.",
+    "docCamera": "Take photo",
+    "docCameraHint": "Capture a new photo with your camera",
+    "docGallery": "Choose from device",
+    "docGalleryHint": "Select an image, PDF, or other document"
+  }
+}