@savers_app/react-native-sandbox-sdk 1.2.6

package/package.json

@@ -0,0 +1,184 @@
+{
+  "name": "@savers_app/react-native-sandbox-sdk",
+  "version": "1.2.6",
+  "description": "Cross-platform React Native SDK exposing native features (maps, dial pad, browser), device ID/location and session utilities, a URL generator, and a WebView message bridge to trigger actions from web content.",
+  "main": "./lib/module/index.js",
+  "react-native": "./src/index.tsx",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "run:android": "yarn workspace @saversapp/react-native-sdk-example android",
+    "run:ios": "yarn workspace @saversapp/react-native-sdk-example ios",
+    "clean": "del-cli lib",
+    "prepare": "bob build",
+    "set:sandbox": "cross-env SDK_ENV=sandbox SDK_PACKAGE=@savers_app/react-native-sandbox-sdk node scripts/replace-config.js",
+    "set:production": "cross-env SDK_ENV=production SDK_PACKAGE=@savers_app/react-native-sdk node scripts/replace-config.js",
+    "prepare:sandbox": "yarn set:sandbox && yarn install && yarn prepare",
+    "prepare:production": "yarn set:production && yarn install && yarn prepare",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pm-code/savers-react-native-sdk.git"
+  },
+  "author": "Faisal Wahab <faisalwahab@live.com> (https://github.com/pm-code)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/pm-code/savers-react-native-sdk/issues"
+  },
+  "homepage": "https://github.com/pm-code/savers-react-native-sdk#readme",
+  "publishConfig": {
+      "access": "public",
+      "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native-community/netinfo": "^11.5.2",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@react-navigation/native": "^7.0.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.1.12",
+    "commitlint": "^19.8.1",
+    "cross-env": "^7.0.3",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "lefthook-darwin-arm64": "^2.1.3",
+    "prettier": "^3.8.1",
+    "react": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-builder-bob": "^0.40.13",
+    "release-it": "^19.0.4",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": "*",
+    "@react-native-community/geolocation": "*",
+    "@react-native-community/netinfo": "*",
+    "@react-navigation/native": "*",
+    "react": "*",
+    "react-native": "*",
+    "react-native-aes-gcm-crypto": "*",
+    "react-native-device-info": "*"
+  },
+  "workspaces": [
+    "example",
+    "."
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ],
+    "moduleNameMapper": {
+      "^@savers_app/react-native-sdk$": "<rootDir>/src/index.tsx",
+      "^@savers_app/react-native-sandbox-sdk$": "<rootDir>/src/index.tsx",
+      "^react-native-device-info$": "<rootDir>/src/__mocks__/react-native-device-info.ts",
+      "^@react-native-community/geolocation$": "<rootDir>/src/__mocks__/@react-native-community__geolocation.ts",
+      "^@react-native-async-storage/async-storage$": "<rootDir>/src/__mocks__/@react-native-async-storage__async-storage.ts"
+    }
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "library",
+    "languages": "js",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.56.1"
+  }
+}

package/src/@types/@react-native-async-storage__async-storage.d.ts

@@ -0,0 +1,7 @@
+declare module '@react-native-async-storage/async-storage' {
+  const AsyncStorage: {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+  };
+  export = AsyncStorage;
+}

package/src/@types/@react-native-community__geolocation.d.ts

@@ -0,0 +1,18 @@
+declare module '@react-native-community/geolocation' {
+  type Position = {
+    coords: { latitude: number; longitude: number };
+  };
+  type Options = {
+    enableHighAccuracy?: boolean;
+    timeout?: number;
+    maximumAge?: number;
+  };
+  const Geolocation: {
+    getCurrentPosition(
+      success: (pos: Position) => void,
+      error?: (err: unknown) => void,
+      options?: Options
+    ): void;
+  };
+  export default Geolocation;
+}

package/src/@types/react-native-aes-gcm-crypto.d.ts

@@ -0,0 +1,22 @@
+declare module 'react-native-aes-gcm-crypto' {
+  export type EncryptedData = {
+    iv: string;
+    tag: string;
+    content: string;
+  };
+  const AesGcmCrypto: {
+    encrypt(
+      plainText: string,
+      inBinary: boolean,
+      key: string
+    ): Promise<EncryptedData>;
+    decrypt(
+      base64Ciphertext: string,
+      key: string,
+      iv: string,
+      tag: string,
+      isBinary: boolean
+    ): Promise<string>;
+  };
+  export default AesGcmCrypto;
+}

package/src/@types/react-native-device-info.d.ts

@@ -0,0 +1,3 @@
+declare module 'react-native-device-info' {
+  export function getUniqueId(): Promise<string>;
+}

package/src/core/runtime.ts

@@ -0,0 +1,84 @@
+// Utilities
+import { logger } from '../utils/logger';
+import { SDKRequirements } from '../utils/dependencyManager';
+
+// Data / Storage
+import {
+  setApiKey,
+  setEncryptionKey,
+  setPRefCode,
+  setAuthMode,
+} from '../data/storage/keysManager';
+import { getDeviceId } from '../data/storage/deviceIdManager';
+import { setReactRef } from '../data/storage/reactRefManager';
+
+// Services
+// import { getDeviceLocation } from '../services/device/location';
+
+export function initializeSDK(providedKeys: {
+  apiKey: string;
+  encryptionKey: string;
+  pRefCode: string;
+  authMode: string;
+  navigationRef: any;
+}) {
+  const keys = providedKeys;
+  const missing: string[] = [];
+  if (!keys.apiKey) missing.push('apiKey');
+  if (!keys.encryptionKey) missing.push('encryptionKey');
+  if (!keys.pRefCode) missing.push('pRefCode');
+  if (!keys.authMode) missing.push('authMode');
+  if (!keys.navigationRef) missing.push('navigationRef');
+
+  if (missing.length) {
+    const msg = `[SDK] Missing required keys: ${missing.join(', ')}`;
+    logger.warn(msg);
+    throw new Error(msg);
+  }
+  setApiKey(keys.apiKey);
+  setEncryptionKey(keys.encryptionKey);
+  setPRefCode(keys.pRefCode);
+  setAuthMode(keys.authMode);
+  setReactRef(keys.navigationRef);
+
+  getDeviceId()
+    .then((id) => {
+      logger.info('[SDK] Device ID availability', { deviceId: Boolean(id) });
+    })
+    .catch(() => {
+      logger.warn('[SDK] Device ID unavailable');
+    });
+
+  // getDeviceLocation()
+  //   .then((loc) => {
+  //     logger.info('[SDK] Device location availability', {
+  //       location: Boolean(loc),
+  //     });
+  //   })
+  //   .catch(() => {
+  //     logger.warn('[SDK] Device location unavailable');
+  //   });
+
+  const { asyncStorage, geolocation, deviceInfo } = SDKRequirements;
+  if (asyncStorage && geolocation && deviceInfo) return;
+  if (!asyncStorage) {
+    logger.warn(
+      '[SDK] Missing AsyncStorage. Install @react-native-async-storage/async-storage for session/device features.'
+    );
+  }
+  if (!geolocation) {
+    logger.warn(
+      '[SDK] Missing Geolocation. Install @react-native-community/geolocation for location features.'
+    );
+  }
+
+  if (!deviceInfo) {
+    logger.warn(
+      '[SDK] Missing DeviceInfo. Install react-native-device-info for device identification.'
+    );
+  }
+}
+
+export const SaversAppSDK = {
+  initialized: initializeSDK,
+};

package/src/data/models/apiResponse.ts

@@ -0,0 +1,28 @@
+export type ApiResponse<T> = {
+  data?: T | null;
+  status?: boolean;
+  message?: string;
+  fromCache: boolean;
+};
+
+export function apiError(message?: string): ApiResponse<null> {
+  return {
+    data: null,
+    status: false,
+    message: message ?? '',
+    fromCache: false,
+  };
+}
+
+export function apiSuccess<T>(
+  data: T,
+  message?: string,
+  fromCache?: boolean
+): ApiResponse<T> {
+  return {
+    data,
+    status: true,
+    message: message ?? '',
+    fromCache: !!fromCache,
+  };
+}

package/src/data/models/onboardingModel.ts

@@ -0,0 +1,97 @@
+export type OnBoardingImage = {
+  id?: number | null;
+  url?: string | null;
+};
+
+export function onBoardingImageFromJson(
+  json: Record<string, any>
+): OnBoardingImage {
+  return {
+    id: typeof json.id === 'number' ? json.id : null,
+    url: typeof json.url === 'string' ? json.url : null,
+  };
+}
+
+export function onBoardingImageListFromJson(list: any[]): OnBoardingImage[] {
+  const out: OnBoardingImage[] = [];
+  for (const item of list) {
+    if (item && typeof item === 'object' && !Array.isArray(item)) {
+      try {
+        out.push(onBoardingImageFromJson(item as Record<string, any>));
+      } catch {}
+    }
+  }
+  return out;
+}
+
+export type OnBoardingThemeData = {
+  total?: number | null;
+  images?: OnBoardingImage[] | null;
+};
+
+export function onBoardingThemeFromJson(json: any): OnBoardingThemeData {
+  const map = { ...(json as Record<string, any>) };
+  const imagesRaw = Array.isArray(map.images) ? (map.images as any[]) : [];
+  const images = onBoardingImageListFromJson(imagesRaw);
+  const total =
+    typeof map.total === 'number'
+      ? map.total
+      : typeof map.total === 'string'
+        ? Number(map.total)
+        : null;
+  return {
+    total: total ?? null,
+    images: images.length > 0 ? images : null,
+  };
+}
+
+export type OnBoardingData = {
+  day?: OnBoardingThemeData | null;
+  night?: OnBoardingThemeData | null;
+};
+
+export function onBoardingDataFromJson(json: any): OnBoardingData {
+  const map = { ...(json as Record<string, any>) };
+  const hasDayNight = 'day' in map || 'night' in map;
+  if (hasDayNight) {
+    const day = map.day ? onBoardingThemeFromJson(map.day) : null;
+    const night = map.night ? onBoardingThemeFromJson(map.night) : null;
+    return { day, night };
+  }
+  const legacyImages = Array.isArray(map.images)
+    ? onBoardingImageListFromJson(map.images as any[])
+    : [];
+  const legacyTotal =
+    typeof map.total === 'number'
+      ? map.total
+      : typeof map.total === 'string'
+        ? Number(map.total)
+        : null;
+  const legacyTheme: OnBoardingThemeData = {
+    total: legacyTotal ?? null,
+    images: legacyImages.length > 0 ? legacyImages : null,
+  };
+  return { day: legacyTheme, night: null };
+}
+
+export const images = (d?: OnBoardingData | null): OnBoardingImage[] | null =>
+  d?.day?.images ?? d?.night?.images ?? null;
+export const total = (d?: OnBoardingData | null): number | null =>
+  d?.day?.total ?? d?.night?.total ?? null;
+export const hasTotal = (d?: OnBoardingData | null): boolean =>
+  total(d) !== null;
+export const hasImages = (d?: OnBoardingData | null): boolean =>
+  !!images(d) && (images(d)?.length ?? 0) > 0;
+export const imageCount = (d?: OnBoardingData | null): number =>
+  images(d)?.length ?? 0;
+export const isValid = (d?: OnBoardingData | null): boolean =>
+  !!(d?.day?.total && d?.day?.images) ||
+  !!(d?.night?.total && d?.night?.images);
+export const getImage = (
+  d: OnBoardingData | null | undefined,
+  index: number
+): OnBoardingImage | null => {
+  const list = images(d);
+  if (list && index >= 0 && index < list.length) return list[index] ?? null;
+  return null;
+};

package/src/data/models/tokenModel.ts

@@ -0,0 +1,43 @@
+export type TokenResponse = {
+  token?: string | null;
+  statusCode?: number | null;
+  error?: string | null;
+  messages?: string[] | null;
+};
+
+export function tokenResponseFromJson(json: any): TokenResponse {
+  const map = { ...(json as Record<string, any>) };
+  const token =
+    typeof map.token === 'string' && map.token.length > 0 ? map.token : null;
+  const statusCode =
+    typeof map.statusCode === 'number'
+      ? map.statusCode
+      : typeof map.statusCode === 'string'
+        ? Number(map.statusCode)
+        : null;
+  const error =
+    typeof map.error === 'string' && map.error.length > 0 ? map.error : null;
+  const messages = Array.isArray(map.message)
+    ? (map.message.filter((m: any) => typeof m === 'string') as string[])
+    : null;
+  return {
+    token: token ?? null,
+    statusCode: statusCode ?? null,
+    error: error ?? null,
+    messages: messages && messages.length > 0 ? messages : null,
+  };
+}
+
+export const token = (d?: TokenResponse | null): string | null =>
+  d?.token ?? null;
+export const hasToken = (d?: TokenResponse | null): boolean =>
+  !!(d?.token && d.token.length > 0);
+export const isValid = (d?: TokenResponse | null): boolean => hasToken(d);
+export const status = (d?: TokenResponse | null): number | null =>
+  d?.statusCode ?? null;
+export const error = (d?: TokenResponse | null): string | null =>
+  d?.error ?? null;
+export const messages = (d?: TokenResponse | null): string[] | null =>
+  d?.messages ?? null;
+export const hasError = (d?: TokenResponse | null): boolean =>
+  !!(d?.error || (d?.messages && d.messages.length > 0) || d?.statusCode);

package/src/data/network/apiClient.ts

@@ -0,0 +1,148 @@
+/* eslint-disable prettier/prettier */
+
+// Utilities / Helpers
+import { logger } from '../../utils/logger';
+
+// Services / API clients
+import { AuthInterceptor } from './interceptors/authInterceptor';
+import { RetryInterceptor } from './interceptors/retryInterceptor';
+import { ErrorInterceptor } from './interceptors/errorInterceptor';
+import { NetworkInterceptor } from './interceptors/networkInterceptor';
+import { LoggingInterceptor } from './interceptors/loggingInterceptor';
+
+export enum Environment {
+  production = 'production',
+  staging = 'staging',
+}
+
+export class ApiClient {
+  private static readonly baseUrls: Record<Environment, string> = {
+    [Environment.production]: 'https://devapi.saversapp.com/clo/v1/',
+    [Environment.staging]: 'https://devapi.saversapp.com/clo/v1/',
+  };
+
+  private baseUrl: string;
+  private interceptors: any[] = [];
+
+  constructor(environment: Environment = Environment.production) {
+    this.baseUrl = ApiClient.baseUrls[environment];
+
+    this.interceptors = [
+      new LoggingInterceptor(),
+      new NetworkInterceptor(),
+      new AuthInterceptor(),
+      new RetryInterceptor(2),
+      new ErrorInterceptor(),
+    ];
+  }
+
+  async get(endpoint: string, params?: Record<string, any>): Promise<any> {
+    return this.request('GET', endpoint, undefined, params);
+  }
+
+  async post(
+    endpoint: string,
+    data?: any,
+    params?: Record<string, any>
+  ): Promise<any> {
+    return this.request('POST', endpoint, data, params);
+  }
+
+  async put(
+    endpoint: string,
+    data?: any,
+    params?: Record<string, any>
+  ): Promise<any> {
+    return this.request('PUT', endpoint, data, params);
+  }
+
+  async delete(
+    endpoint: string,
+    data?: any,
+    params?: Record<string, any>
+  ): Promise<any> {
+    return this.request('DELETE', endpoint, data, params);
+  }
+
+  private async request(
+    method: string,
+    endpoint: string,
+    data?: any,
+    params?: Record<string, any>
+  ): Promise<any> {
+    const url = this.buildUrl(endpoint, params);
+    let options: any = {
+      method,
+      url,
+      headers: {
+        'Content-Type': 'application/json',
+      },
+      body: data,
+      params, // kept for interceptors
+    };
+
+    // Apply request interceptors
+    for (const interceptor of this.interceptors) {
+      if (interceptor.onRequest) {
+        options = await interceptor.onRequest(options);
+        if (!options) throw new Error('Interceptor blocked request');
+      }
+    }
+
+    try {
+      const response = await fetch(options.url, {
+        method: options.method,
+        headers: options.headers,
+        body: options.body ? JSON.stringify(options.body) : undefined,
+      });
+
+      let responseData: any = null;
+      try {
+        responseData = await response.json();
+      } catch {
+        // ignore JSON parse error
+      }
+
+      // Apply response interceptors
+      let responseObj = {
+        data: responseData,
+        status: response.status,
+        statusText: response.statusText,
+      };
+
+      for (const interceptor of this.interceptors) {
+        if (interceptor.onResponse) {
+          responseObj = await interceptor.onResponse(responseObj);
+        }
+      }
+
+      return responseObj;
+    } catch (error) {
+      // Apply error interceptors
+      logger.error('API Request failed', error);
+      const handledError = error;
+      for (const interceptor of this.interceptors) {
+        if (interceptor.onError) {
+          // This is complex to mock fully without a real handler
+          // interceptor.onError(handledError, handler);
+        }
+      }
+      throw handledError;
+    }
+  }
+
+  private buildUrl(endpoint: string, params?: Record<string, any>): string {
+    let url = `${this.baseUrl}${endpoint}`;
+    if (params) {
+      const queryString = Object.keys(params)
+        .map(
+          (key) => `${encodeURIComponent(key)}=${encodeURIComponent(params[key])}`
+        )
+        .join('&');
+      if (queryString) {
+        url += `?${queryString}`;
+      }
+    }
+    return url;
+  }
+}

package/src/data/network/apiEndpoints.ts

@@ -0,0 +1,4 @@
+export const ApiEndpoints = {
+  onboarding: 'on-boarding/listings',
+  get_nonce: 'sys/sys/c/s/t',
+} as const;

package/src/data/network/apiExceptionHandler.ts

@@ -0,0 +1,16 @@
+export function getErrorMessage(status?: number, type?: string): string {
+  if (type === 'timeout') return 'Connection timeout. Please try again.';
+  if (type === 'sendtimeout') return 'Send timeout. Please try again.';
+  if (type === 'receivetimeout') return 'Receive timeout. Please try again.';
+  if (typeof status === 'number') {
+    if (status >= 400 && status < 500)
+      return `Request error [${status}]. Please check your input.`;
+    if (status >= 500)
+      return `Server error [${status}]. Please try again later.`;
+  }
+  return 'Something went wrong. Please try again.';
+}
+
+export function noInternetError(): string {
+  return 'No internet connection. Please check your network.';
+}