react-native-ensys-camera-x 1.0.7

package/lib/module/cpuOptimization.js

@@ -0,0 +1,296 @@
+"use strict";
+
+/// <reference lib="dom" />
+
+/**
+ * CPU optimization utilities for low-end devices
+ */
+
+import { devWarn } from "./logger.js";
+
+/**
+ * Debounce function optimized for low-end devices
+ * Longer default delay to reduce CPU load
+ */
+export function debounceForLowEnd(func, wait = 500 // Longer debounce for low-end
+) {
+  let timeout = null;
+  return function (...args) {
+    if (timeout) {
+      clearTimeout(timeout);
+    }
+    timeout = setTimeout(() => {
+      // Use requestIdleCallback if available for better CPU management
+      const nativeGlobal = global;
+      if (typeof nativeGlobal.requestIdleCallback === 'function') {
+        nativeGlobal.requestIdleCallback(() => func(...args), {
+          timeout: 1000
+        });
+      } else {
+        func(...args);
+      }
+    }, wait);
+  };
+}
+
+/**
+ * Throttle function optimized for low-end devices
+ * Longer limit to reduce CPU load
+ */
+export function throttleForLowEnd(func, limit = 1000 // Longer throttle for low-end
+) {
+  let lastFunc = null;
+  let lastRan = 0;
+  return function (...args) {
+    if (!lastRan) {
+      func(...args);
+      lastRan = Date.now();
+    } else {
+      if (lastFunc) {
+        clearTimeout(lastFunc);
+      }
+      lastFunc = setTimeout(() => {
+        if (Date.now() - lastRan >= limit) {
+          func(...args);
+          lastRan = Date.now();
+        }
+      }, limit - (Date.now() - lastRan));
+    }
+  };
+}
+
+/**
+ * Run operation in background with priority control
+ * Uses requestIdleCallback when available
+ */
+export async function runInBackgroundWithPriority(operation, priority = 'low') {
+  if (priority === 'low') {
+    await Promise.resolve();
+  }
+  await operation();
+}
+
+/**
+ * Create lazy initializer that defers execution
+ * Uses requestIdleCallback when available
+ */
+export function createLazyInitializer(initializer) {
+  let value = null;
+  let initialized = false;
+  let initializing = false;
+  let callbacks = [];
+  const initialize = () => {
+    if (initializing) return;
+    initializing = true;
+    const nativeGlobal = global;
+    if (typeof nativeGlobal.requestIdleCallback === 'function') {
+      nativeGlobal.requestIdleCallback(() => {
+        try {
+          value = initializer();
+          initialized = true;
+          callbacks.forEach(cb => cb(value));
+          callbacks = [];
+        } catch {
+          // Silently fail lazy initialization
+        }
+        initializing = false;
+      }, {
+        timeout: 1000
+      });
+
+      // Fallback if idle callback doesn't fire
+      setTimeout(() => {
+        if (!initialized && !initializing) {
+          try {
+            value = initializer();
+            initialized = true;
+            callbacks.forEach(cb => cb(value));
+            callbacks = [];
+          } catch {
+            // Silently fail
+          }
+        }
+      }, 1000);
+    } else {
+      try {
+        value = initializer();
+        initialized = true;
+        callbacks.forEach(cb => cb(value));
+        callbacks = [];
+      } catch {
+        // Silently fail
+      }
+    }
+  };
+  return () => {
+    if (!initialized) {
+      if (!initializing) {
+        initialize();
+      }
+      return new Promise(resolve => {
+        callbacks.push(resolve);
+      });
+    }
+    return value;
+  };
+}
+
+/**
+ * Process operations in chunks to avoid blocking UI
+ */
+export async function processInChunks(operations) {
+  const results = [];
+  for (const operation of operations) {
+    await Promise.resolve();
+    try {
+      const result = await operation();
+      results.push(result);
+    } catch (error) {
+      throw error;
+    }
+  }
+  return results;
+}
+
+/**
+ * CPU-efficient delay that yields to main thread
+ */
+export function efficientDelay(ms) {
+  return new Promise(resolve => {
+    if (ms <= 0) {
+      resolve();
+      return;
+    }
+    const start = performance.now();
+    while (performance.now() - start < ms) {
+      // Busy-wait briefly to provide a real delay without depending on timers
+    }
+    resolve();
+  });
+}
+
+/**
+ * Check if current thread is busy
+ */
+export function isMainThreadBusy() {
+  // Simple heuristic for busyness
+  const start = performance.now();
+  let computation = 0;
+
+  // Small computation to check responsiveness
+  for (let i = 0; i < 1000; i += 1) {
+    computation += i;
+  }
+  const duration = performance.now() - start;
+  if (computation === 0) {
+    return false;
+  }
+
+  // If simple computation takes too long, thread is busy
+  return duration > 5; // More than 5ms indicates busyness
+}
+
+/**
+ * Wait for main thread to be available
+ */
+export async function waitForMainThreadAvailable(maxWait = 1000, checkInterval = 50) {
+  const startTime = Date.now();
+  while (Date.now() - startTime < maxWait) {
+    if (!isMainThreadBusy()) {
+      return;
+    }
+    await efficientDelay(checkInterval);
+  }
+
+  // Timeout reached
+  devWarn('Main thread remained busy for too long');
+}
+
+/**
+ * CPU-efficient animation frame handler
+ */
+export function requestEfficientAnimationFrame(callback) {
+  if (isMainThreadBusy()) {
+    // If main thread is busy, use setTimeout instead
+    const handle = setTimeout(() => {
+      const time = performance.now();
+      callback(time);
+    }, 16); // ~60fps
+    return handle;
+  }
+  return requestAnimationFrame(callback);
+}
+
+/**
+ * Cancel efficient animation frame
+ */
+export function cancelEfficientAnimationFrame(handle) {
+  try {
+    cancelAnimationFrame(handle);
+  } catch {
+    // If it was a setTimeout, clear it
+    clearTimeout(handle);
+  }
+}
+
+/**
+ * Get CPU optimization level based on device specs
+ */
+export function getCpuOptimizationLevel(ram, processor) {
+  if (ram === 'low' || processor === 'weak') {
+    return 'aggressive';
+  }
+  if (ram === 'medium' || processor === 'medium') {
+    return 'moderate';
+  }
+  return 'none';
+}
+
+/**
+ * Check if device supports requestIdleCallback
+ */
+export function supportsIdleCallback() {
+  const nativeGlobal = global;
+  return typeof nativeGlobal.requestIdleCallback === 'function';
+}
+
+/**
+ * Polyfill for requestIdleCallback
+ */
+export function requestIdleCallbackPolyfill(callback, options) {
+  if (supportsIdleCallback()) {
+    const nativeGlobal = global;
+    const idleCallback = nativeGlobal.requestIdleCallback;
+    if (typeof idleCallback === 'function') {
+      return idleCallback(callback, options);
+    }
+  }
+
+  // Polyfill using setTimeout
+  const timeout = options?.timeout || 5000;
+  const start = Date.now();
+  const handle = setTimeout(() => {
+    callback({
+      didTimeout: false,
+      timeRemaining: () => Math.max(0, timeout - (Date.now() - start))
+    });
+  }, 16); // Next animation frame
+
+  return handle;
+}
+
+/**
+ * Cancel polyfilled idle callback
+ */
+export function cancelIdleCallbackPolyfill(handle) {
+  const nativeGlobal = global;
+  if (supportsIdleCallback() && typeof nativeGlobal.cancelIdleCallback === 'function') {
+    const idleCancelCallback = nativeGlobal.cancelIdleCallback;
+    if (typeof idleCancelCallback === 'function') {
+      idleCancelCallback(handle);
+    }
+  } else {
+    clearTimeout(handle);
+  }
+}
+//# sourceMappingURL=cpuOptimization.js.map

package/lib/module/cpuOptimization.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["devWarn","debounceForLowEnd","func","wait","timeout","args","clearTimeout","setTimeout","nativeGlobal","global","requestIdleCallback","throttleForLowEnd","limit","lastFunc","lastRan","Date","now","runInBackgroundWithPriority","operation","priority","Promise","resolve","createLazyInitializer","initializer","value","initialized","initializing","callbacks","initialize","forEach","cb","push","processInChunks","operations","results","result","error","efficientDelay","ms","start","performance","isMainThreadBusy","computation","i","duration","waitForMainThreadAvailable","maxWait","checkInterval","startTime","requestEfficientAnimationFrame","callback","handle","time","requestAnimationFrame","cancelEfficientAnimationFrame","cancelAnimationFrame","getCpuOptimizationLevel","ram","processor","supportsIdleCallback","requestIdleCallbackPolyfill","options","idleCallback","didTimeout","timeRemaining","Math","max","cancelIdleCallbackPolyfill","cancelIdleCallback","idleCancelCallback"],"sourceRoot":"..\\..\\src","sources":["cpuOptimization.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/db/DatabaseManager.js

@@ -0,0 +1,191 @@
+"use strict";
+
+/**
+ * DatabaseManager — the single, centralized owner of the encrypted SQLCipher
+ * connection.
+ *
+ * Responsibilities:
+ *   - Lazily open the encrypted database exactly once (idempotent `init`).
+ *   - Provision the encryption key via the Keystore-backed `secureKey` helper.
+ *   - Run schema migrations on open.
+ *   - Expose small, safe primitives (`exec`, `query`, `transaction`) that the
+ *     repository layer builds on — nothing above this file touches the raw driver.
+ *
+ * The `react-native-sqlcipher` native driver is imported lazily so the bundle
+ * still loads on platforms where it is absent (e.g. web); callers get a clear
+ * error instead of a hard crash at import time.
+ */
+import { Platform } from 'react-native';
+import { getDatabaseKey } from "./secureKey.js";
+import { runMigrations } from "./migrations.js";
+const DATABASE_NAME = 'media_secure.db';
+const DATABASE_LOCATION = 'default';
+
+/** A single parameterized statement for {@link DatabaseManager.batch}. */
+
+/** Loads the native SQLCipher module lazily. Returns null when unavailable. */
+function loadDriver() {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const mod = require('react-native-sqlcipher');
+    return mod?.default ?? mod;
+  } catch {
+    return null;
+  }
+}
+export class DatabaseManager {
+  db = null;
+  initPromise = null;
+
+  /** True once the encrypted database is open and migrated. */
+  get isReady() {
+    return this.db !== null;
+  }
+
+  /**
+   * Opens (once) the encrypted database and applies migrations. Concurrent
+   * callers share a single in-flight open, so `init` is safe to call from
+   * multiple screens/hooks simultaneously.
+   */
+  async init() {
+    if (this.db) return this.db;
+    if (this.initPromise) return this.initPromise;
+    this.initPromise = this.open().then(db => {
+      this.db = db;
+      return db;
+    }).catch(error => {
+      // Reset so a later attempt can retry from scratch.
+      this.initPromise = null;
+      throw error;
+    });
+    return this.initPromise;
+  }
+  async open() {
+    const SQLite = loadDriver();
+    if (!SQLite) {
+      throw new Error(`[DatabaseManager] 'react-native-sqlcipher' is not available on ` + `platform '${Platform.OS}'. Install the package and rebuild the ` + `native app to enable the encrypted media database.`);
+    }
+    SQLite.enablePromise(true);
+    const key = await getDatabaseKey();
+    const db = await SQLite.openDatabase({
+      name: DATABASE_NAME,
+      key,
+      location: DATABASE_LOCATION
+    });
+
+    // Pragmas: WAL for concurrent read/write throughput, FK enforcement on.
+    await db.executeSql('PRAGMA foreign_keys = ON;');
+    try {
+      await db.executeSql('PRAGMA journal_mode = WAL;');
+    } catch {
+      // WAL is an optimization; ignore if the platform rejects it.
+    }
+    await runMigrations(this.createMigrationExecutor(db));
+    return db;
+  }
+
+  /** Ensures the DB is open and returns the live connection. */
+  async requireDb() {
+    return this.db ?? (await this.init());
+  }
+
+  /**
+   * Executes a write/DDL statement. Returns the raw result set for callers that
+   * need `insertId` / `rowsAffected`.
+   */
+  async exec(sql, params = []) {
+    const db = await this.requireDb();
+    const [result] = await db.executeSql(sql, params);
+    return result;
+  }
+
+  /** Executes a SELECT and returns the rows as an array of `T`. */
+  async query(sql, params = []) {
+    const db = await this.requireDb();
+    const [result] = await db.executeSql(sql, params);
+    const rows = [];
+    for (let i = 0; i < result.rows.length; i++) {
+      rows.push(result.rows.item(i));
+    }
+    return rows;
+  }
+
+  /** Convenience: SELECT returning the first scalar column of the first row. */
+  async queryScalar(sql, params = []) {
+    const rows = await this.query(sql, params);
+    if (rows.length === 0) return null;
+    const first = rows[0];
+    const firstKey = Object.keys(first)[0];
+    return firstKey === undefined ? null : first[firstKey];
+  }
+
+  /**
+   * Runs a set of statements atomically in a single transaction.
+   *
+   * The `react-native-sqlcipher` driver requires every `executeSql` to be queued
+   * *synchronously* inside the transaction scope, so this takes a pre-built list
+   * of statements rather than an async callback — guaranteeing all-or-nothing
+   * semantics (used by `insertMany` and the migration runner).
+   */
+  async batch(statements) {
+    if (statements.length === 0) return;
+    const db = await this.requireDb();
+    await db.transaction(tx => {
+      for (const {
+        sql,
+        params
+      } of statements) {
+        tx.executeSql(sql, params ?? []);
+      }
+    });
+  }
+
+  /** Adapts this manager to the migration executor contract. */
+  createMigrationExecutor(db) {
+    return {
+      getVersion: async () => {
+        const [result] = await db.executeSql('PRAGMA user_version;');
+        const row = result.rows.item(0);
+        return Number(row?.user_version ?? 0);
+      },
+      runBatch: async statements => {
+        await db.transaction(tx => {
+          for (const sql of statements) {
+            tx.executeSql(sql, []);
+          }
+        });
+      }
+    };
+  }
+
+  /** Closes the connection (e.g. on teardown). Safe to call when not open. */
+  async close() {
+    const db = this.db;
+    this.db = null;
+    this.initPromise = null;
+    if (db) {
+      try {
+        await db.close();
+      } catch (error) {
+        console.warn('[DatabaseManager] close failed', error);
+      }
+    }
+  }
+}
+
+// Process-wide singleton — every consumer shares one encrypted connection.
+let managerInstance = null;
+
+/** Returns the shared `DatabaseManager` singleton. */
+export function getDatabaseManager() {
+  if (!managerInstance) {
+    managerInstance = new DatabaseManager();
+  }
+  return managerInstance;
+}
+
+/** Opens + migrates the encrypted database. Call once at app startup. */
+export async function initializeMediaDatabase() {
+  await getDatabaseManager().init();
+}
+//# sourceMappingURL=DatabaseManager.js.map

package/lib/module/db/DatabaseManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","getDatabaseKey","runMigrations","DATABASE_NAME","DATABASE_LOCATION","loadDriver","mod","require","default","DatabaseManager","db","initPromise","isReady","init","open","then","catch","error","SQLite","Error","OS","enablePromise","key","openDatabase","name","location","executeSql","createMigrationExecutor","requireDb","exec","sql","params","result","query","rows","i","length","push","item","queryScalar","first","firstKey","Object","keys","undefined","batch","statements","transaction","tx","getVersion","row","Number","user_version","runBatch","close","console","warn","managerInstance","getDatabaseManager","initializeMediaDatabase"],"sourceRoot":"..\\..\\..\\src","sources":["db/DatabaseManager.ts"],"mappings":"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","ignoreList":[]}