@webority-technologies/mobile 0.0.1

package/README.md

@@ -0,0 +1,399 @@
+# @webority-technologies/mobile
+
+The single React Native package for Webority projects: 41 UI components, theme, API client, auth, logging, storage, formatters, validators, network, permissions, and version-check — all in one import path.
+
+`v0.0.1` · MIT · React Native 0.81+ · React 19 · TypeScript strict
+
+---
+
+## Install
+
+```bash
+npm install @webority-technologies/mobile
+```
+
+### Peer dependencies
+
+`react` 19.1 and `react-native` 0.81+ are required. Everything else is **optional** — install only what the modules you use need:
+
+| Peer dep                                          | Needed for                                                        |
+| ------------------------------------------------- | ----------------------------------------------------------------- |
+| `react-native-reanimated` (3.x)                   | `BottomSheet`, `Drawer`, `Swipeable` (others use native Animated) |
+| `react-native-gesture-handler` (2.x)              | `BottomSheet`, swipe-to-dismiss interactions                      |
+| `react-native-safe-area-context` (5.x)            | Layout components, modals, toast positioning                      |
+| `react-native-vector-icons` (10.x)                | Icon-bearing components (`Button`, `Avatar`, etc.)                |
+| `@react-native-async-storage/async-storage` (2.x) | `Storage` module + token persistence                              |
+| `react-native-keychain` (9.x)                     | Secure credential storage (`storeToken` / `getToken`)             |
+| `react-native-device-info` (14.x)                 | `versionCheck` helpers                                            |
+| `@react-native-community/netinfo` (11.x)          | `useNetworkStatus`, `NetworkStatusBanner`                         |
+| `react-native-permissions` (4.x)                  | `Permissions` module                                              |
+| `react-native-compressor` (1.10+)                 | `compressImage` utility                                           |
+
+```bash
+npm install react-native-reanimated \
+            react-native-gesture-handler \
+            react-native-safe-area-context \
+            react-native-vector-icons \
+            @react-native-async-storage/async-storage \
+            react-native-keychain \
+            react-native-device-info \
+            @react-native-community/netinfo \
+            react-native-permissions \
+            react-native-compressor
+```
+
+Follow each library's native-setup steps (Reanimated babel plugin, Gesture Handler import at the top of the entry file, vector-icons font linking, etc.).
+
+---
+
+## Setup
+
+Wrap the app with `GestureHandlerRootView`, `SafeAreaProvider`, `ThemeProvider`, and `ToastProvider`. Initialize the SDK once at module scope.
+
+```tsx
+// App.tsx
+import 'react-native-gesture-handler';
+import React from 'react';
+import { GestureHandlerRootView } from 'react-native-gesture-handler';
+import { SafeAreaProvider } from 'react-native-safe-area-context';
+import {
+  initWebority,
+  initUserAuth,
+  ThemeProvider,
+  ToastProvider,
+  NetworkStatusBanner
+} from '@webority-technologies/mobile';
+import store from './store';
+import { logout, refreshToken } from './store/auth';
+
+initWebority({
+  baseUrl: 'https://api.example.com',
+  environment: __DEV__ ? 'Development' : 'Production',
+  country: 'in' // optional, defaults to 'in'
+});
+
+initUserAuth(store, { logout, refreshToken });
+
+export default function App(): JSX.Element {
+  return (
+    <GestureHandlerRootView style={{ flex: 1 }}>
+      <SafeAreaProvider>
+        <ThemeProvider>
+          <ToastProvider>
+            <NetworkStatusBanner />
+            {/* your screens */}
+          </ToastProvider>
+        </ThemeProvider>
+      </SafeAreaProvider>
+    </GestureHandlerRootView>
+  );
+}
+```
+
+`initUI` is also exported for advanced setups that need to register UI-only globals (theme overrides, default color mode) without the API/auth side of the SDK.
+
+---
+
+## API surface
+
+```ts
+import {
+  // bootstrap
+  initWebority,
+  initUserAuth,
+  initUI,
+
+  // configuration
+  setConfig,
+  getConfig,
+  getConfigValue,
+  resetConfig,
+
+  // theme
+  ThemeProvider,
+  useTheme,
+  useThemeMode,
+  mergeTheme,
+  lightTheme,
+  darkTheme,
+
+  // hooks
+  useToggle,
+  useDebounce,
+  usePressAnimation,
+
+  // http
+  publicClient,
+  userClient,
+
+  // auth
+  storeToken,
+  getToken,
+  removeToken,
+  decodeJWT,
+  isJWTExpired,
+  getJWTExpiry,
+
+  // storage
+  Storage,
+  setStorageImplementation,
+
+  // logger + remote sink (Crashlytics / Sentry adapter)
+  Logger,
+  setRemoteLogger,
+
+  // version + force update
+  VersionCheck,
+  useVersionCheck,
+  ForceUpdateDialog,
+
+  // network
+  useNetworkStatus,
+  getNetworkStatus,
+  NetworkStatusBanner,
+
+  // permissions
+  Permissions,
+
+  // formatters
+  formatDate,
+  formatTime,
+  formatRelativeTime,
+  formatPhone,
+  formatCurrency,
+  formatNumber,
+  formatPercent,
+  formatCompactNumber,
+  getInitials,
+
+  // validators
+  isEmail,
+  isIndianMobile,
+  isPhone,
+  isUrl,
+  isStrongPassword,
+  isPan,
+  isGstin,
+  isAadhaar,
+  isIfsc,
+  isIndianPincode,
+  isHexColor,
+  isNumeric,
+  isInteger,
+  isAlphanumeric,
+  isBetween,
+  minLength,
+  maxLength,
+
+  // utilities
+  Responsive,
+  Spacing,
+  Padding,
+  Margin,
+  isTablet,
+  shadowStyle,
+  triggerHaptic,
+  compressImage,
+
+  // toast
+  ToastProvider,
+  toast,
+  useToast
+
+  // …41 UI components
+} from '@webority-technologies/mobile';
+```
+
+---
+
+## HTTP clients
+
+### `publicClient`
+
+Axios instance for unauthenticated calls. Handles retries (network errors, 429, 503), 30s timeout, environment-aware base URL, and standard headers (including gzip `Accept-Encoding`).
+
+### `userClient`
+
+Axios instance for authenticated calls. Injects a Bearer token from Keychain, queues concurrent 401s while a single refresh is in flight, and replays them on success. Wires into the host app's Redux store via `initUserAuth(store, { logout, refreshToken })`.
+
+---
+
+## Auth & tokens
+
+```ts
+import {
+  storeToken,
+  getToken,
+  removeToken,
+  decodeJWT,
+  isJWTExpired
+} from '@webority-technologies/mobile';
+
+await storeToken('accessToken', token, expiry);
+const stored = await getToken('accessToken'); // { token, expiry } | null
+if (stored && isJWTExpired(stored.token)) {
+  /* refresh */
+}
+const claims = decodeJWT<{ sub: string; role: string }>(stored.token);
+```
+
+Tokens are persisted via `react-native-keychain` with biometry-friendly defaults and graceful recovery from "Key permanently invalidated" errors.
+
+---
+
+## Storage
+
+Typed `AsyncStorage` wrapper with safe JSON helpers. All operations swallow errors (logging them) and return falsy results so storage failures never crash the app.
+
+```ts
+import { Storage } from '@webority-technologies/mobile';
+
+await Storage.setItem('lang', 'en');
+const lang = await Storage.getItem('lang'); // string | null
+
+await Storage.setJson('user', { id: '1', name: 'Navneet' });
+const user = await Storage.getJson<User>('user'); // User | null
+
+await Storage.multiSet({ pushToken: '…', deviceId: '…' });
+await Storage.multiRemove(['pushToken']);
+```
+
+Override the backend (e.g. with MMKV) via `setStorageImplementation()`.
+
+---
+
+## Logger & crash reporting
+
+`Logger.info / warn / error` write to the console. `Logger.recordError`, `Logger.breadcrumb`, `Logger.setUser`, and `Logger.setAttribute` forward to an optional **remote sink** that you wire from your app — keeping the library Firebase- and Sentry-agnostic.
+
+```ts
+import { Logger, setRemoteLogger } from '@webority-technologies/mobile';
+import crashlytics from '@react-native-firebase/crashlytics';
+
+setRemoteLogger({
+  log: (level, message) => crashlytics().log(`[${level}] ${message}`),
+  recordError: (error, ctx) => {
+    if (ctx) Object.entries(ctx).forEach(([k, v]) => crashlytics().setAttribute(k, String(v)));
+    crashlytics().recordError(error instanceof Error ? error : new Error(String(error)));
+  },
+  breadcrumb: (msg, data) => crashlytics().log(data ? `${msg} ${JSON.stringify(data)}` : msg),
+  setUser: (id) => crashlytics().setUserId(id ?? ''),
+  setAttribute: (k, v) => crashlytics().setAttribute(k, v == null ? '' : String(v))
+});
+
+Logger.recordError(new Error('boom'), { route: '/checkout', orderId: 42 });
+```
+
+The same shape works for Sentry, Bugsnag, Datadog, or any custom backend — implement only the methods you need.
+
+---
+
+## Version check & force update
+
+```tsx
+import { useVersionCheck, ForceUpdateDialog } from '@webority-technologies/mobile';
+
+const { isUpdateRequired, updateUrl } = useVersionCheck(isAppReady);
+return <ForceUpdateDialog visible={isUpdateRequired} mandatory updateUrl={updateUrl} />;
+```
+
+`useVersionCheck` only runs in `'Production'`. Country code (used for App Store / Play Store lookups) is configurable via `initWebority({ country: 'us' })`; defaults to `'in'`.
+
+---
+
+## Network status
+
+```tsx
+import { useNetworkStatus, NetworkStatusBanner } from '@webority-technologies/mobile';
+
+// Mount once near the app root
+<NetworkStatusBanner />;
+
+// Or read it inside a screen
+const { isConnected, isInternetReachable, type } = useNetworkStatus();
+```
+
+Falls back to an optimistic "online" status when `@react-native-community/netinfo` is not installed.
+
+---
+
+## Permissions
+
+```ts
+import { Permissions } from '@webority-technologies/mobile';
+
+await Permissions.isAuthorized('camera'); // boolean
+const status = await Permissions.ensure('photos'); // 'granted' | 'denied' | 'limited' | 'blocked' | 'unavailable'
+if (status === 'blocked') await Permissions.openSettings();
+```
+
+Maps an abstract `PermissionKind` (camera, microphone, photos, location, contacts, calendar, notifications, bluetooth, …) to the right iOS / Android permission string under the hood.
+
+---
+
+## Formatters
+
+```ts
+formatDate(new Date(), 'medium'); // '8 Apr 2026'
+formatRelativeTime(then, now); // '5 minutes ago'
+formatPhone('9876512345'); // '+91 98765 12345'
+formatCurrency(150000); // '₹1,50,000'
+formatCurrency(99, { currency: 'USD', locale: 'en-US' }); // '$99.00'
+formatCompactNumber(1500000); // '15L' (en-IN)
+getInitials('Navneet Singh'); // 'NS'
+```
+
+All formatters default to `en-IN` locale (Indian numbering / DD-MMM-YYYY style) and accept overrides.
+
+---
+
+## Validators
+
+Pragmatic regex-based validators that match common Indian-app needs:
+
+```ts
+isEmail('a@b.co'); // true
+isIndianMobile('+919876512345'); // true
+isPan('ABCDE1234F'); // true
+isGstin('27AAPFU0939F1ZV'); // true
+isIfsc('HDFC0001234'); // true
+isIndianPincode('110001'); // true
+isStrongPassword('Aa1!@#$%', { requireSymbol: true }); // true
+```
+
+Plus generic helpers: `isUrl`, `isNumeric`, `isInteger`, `isAlphanumeric`, `isHexColor`, `isBetween`, `minLength`, `maxLength`.
+
+---
+
+## Theme
+
+`ThemeProvider` exposes the design-token surface (colors, typography, spacing, radius, shadows, motion) and tracks the system color-scheme automatically. Read it via `useTheme()`. Every shipped component reads from the active theme — no hard-coded colors anywhere. Customize with `mergeTheme` or `initUI({ light, dark })`.
+
+---
+
+## Toast
+
+Imperative `toast.success(...)` / `toast.error(...)` from anywhere in the tree, or `useToast().show(...)` inside components.
+
+```ts
+toast.success('Saved.');
+toast.error('Network is down', { description: 'Check your connection.' });
+```
+
+Mount `<ToastProvider>` once near the app root.
+
+---
+
+## Components
+
+41 components across Layout, Forms & Inputs, Feedback & Status, Overlay, Navigation, and Data Display.
+
+For the full catalog with props tables and minimal usage examples, see [`docs/COMPONENTS.md`](../../docs/COMPONENTS.md).
+
+For runnable usage of every component, see [`example/`](../../example/).
+
+---
+
+## License
+
+MIT. Copyright © Webority Technologies.

package/lib/commonjs/api/publicClient.js

@@ -0,0 +1,73 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _axios = _interopRequireDefault(require("axios"));
+var _axiosRetry = _interopRequireDefault(require("axios-retry"));
+var _index = require("../config/index.js");
+var _index2 = require("../logger/index.js");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+// Define timeout for requests
+const REQUEST_TIMEOUT = 30000; // 30 seconds
+
+/**
+ * Public Axios Client
+ * - Base URL: Set your public API base URL.
+ * - No Authorization header is attached.
+ * - Includes timeout configuration and error handling.
+ * - Handles specific HTTP status codes.
+ */
+const publicClient = _axios.default.create({
+  baseURL: (0, _index.getConfigValue)('baseUrl') ?? undefined,
+  headers: {
+    'Content-Type': 'application/json',
+    Accept: 'application/json',
+    'Accept-Encoding': 'gzip, deflate, br'
+  },
+  timeout: REQUEST_TIMEOUT
+});
+
+// Configure axios-retry with modified exponential backoff
+const retryConfig = {
+  retries: 3,
+  retryDelay: retryCount => retryCount === 0 ? 0 : Math.pow(2, retryCount) * 1000,
+  // Immediate retry for the first attempt
+  retryCondition: error => {
+    // Retry on network errors or specific status codes
+    return _axiosRetry.default.isNetworkOrIdempotentRequestError(error) || [429, 503].includes(error.response?.status ?? 0);
+  }
+};
+(0, _axiosRetry.default)(publicClient, retryConfig);
+
+// Add request interceptor for logging
+publicClient.interceptors.request.use(config => {
+  _index2.Logger.info(`Request: ${config.method?.toUpperCase()} ${config.url}`);
+  return config;
+}, error => {
+  const message = error instanceof Error ? error.message : String(error);
+  _index2.Logger.error('Request error:', message);
+  return Promise.reject(error);
+});
+
+// Add response interceptor for error handling
+publicClient.interceptors.response.use(response => {
+  _index2.Logger.info(`Response: ${response.status} from ${response.config.url}`);
+  return response;
+}, error => {
+  if (_axios.default.isAxiosError(error)) {
+    const originalRequest = error.config;
+    if (!error.response) {
+      _index2.Logger.error(`Network error or no response from server: ${error.message}, URL: ${originalRequest?.url}`);
+    } else {
+      _index2.Logger.error(`Response error: ${error.response.data ?? error.message}, URL: ${originalRequest?.url}, Status: ${error.response.status}`);
+    }
+  } else {
+    const message = error instanceof Error ? error.message : String(error);
+    _index2.Logger.error(`Unknown response error: ${message}`);
+  }
+  return Promise.reject(error);
+});
+var _default = exports.default = publicClient;
+//# sourceMappingURL=publicClient.js.map