catalyst-core 0.2.0-beta.2 → 0.3.0-beta.1

package/dist/native/bridge/useBaseHook.js

@@ -1,47 +1,283 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.useEnvironmentInfo=exports.useBaseHook=exports.PROGRESS_STATES=void 0;var _react=require("react");var _NativeBridge=_interopRequireDefault(require("./utils/NativeBridge.js"));var _errors=require("./errors");function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/**
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useEnvironmentInfo = exports.useBaseHook = exports.PROGRESS_STATES = void 0;
+var _react = require("react");
+var _NativeBridge = _interopRequireDefault(require("./utils/NativeBridge.js"));
+var _errors = require("./errors");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
  * Base hook utility that provides standardized interface for all Catalyst hooks
  * Handles environment detection, error standardization, and common state management
  *
  * @param {string} hookName - Name of the hook for debugging purposes
  * @returns {Object} Base hook interface with common functionality
- */const useBaseHook=(hookName,{hasWebFallback=false,webFallback}={})=>{// Environment detection — live check at call time, never stale from SSR
-const isNative=(0,_react.useCallback)(()=>{if(typeof window==="undefined")return false;return!!(window.WebBridge&&_NativeBridge.default.isAvailable());},[]);const isWeb=(0,_react.useCallback)(()=>{return!isNative();},[isNative]);// Web fallback state — only meaningful when isWeb() and hook declared hasWebFallback:true
-// State tracks imperative setWebFallback() calls. The prop is the synchronous source of truth
-// when provided — prop wins so there is no async gap between prop change and disabled state.
-const[webFallbackState,setWebFallback]=(0,_react.useState)(true);// When prop is explicitly provided, use it directly (synchronous). When undefined, fall back to state.
-const webFallbackResolved=webFallback!==undefined?!!webFallback:webFallbackState;const webFallbackActive=isWeb()&&hasWebFallback&&webFallbackResolved;const webFallbackDisabled=isWeb()&&hasWebFallback&&!webFallbackResolved;// Common state management
-const[data,setData]=(0,_react.useState)(null);const[loading,setLoading]=(0,_react.useState)(false);const[error,setError]=(0,_react.useState)(null);const[progress,setProgress]=(0,_react.useState)({state:"idle",// 'idle' | 'opening' | 'processing' | 'routing' | 'complete' | 'error'
-percentage:null,// 0-100 or null
-message:null,// Human readable message or null
-phase:null,// Operation specific phase or null
-transport:null,// Transport method being used
-bytesLoaded:null,// Bytes processed
-bytesTotal:null// Total bytes
-});// Progress management utilities
-const updateProgress=(0,_react.useCallback)(updates=>{setProgress(prev=>({...prev,...updates}));},[]);const resetProgress=(0,_react.useCallback)(()=>{setProgress({state:"idle",percentage:null,message:null,phase:null,transport:null,bytesLoaded:null,bytesTotal:null});},[]);const startProgress=(0,_react.useCallback)((phase=null,message=null)=>{updateProgress({state:"active",phase,message,percentage:null});},[updateProgress]);const completeProgress=(0,_react.useCallback)(()=>{updateProgress({state:"complete",percentage:100});},[updateProgress]);const errorProgress=(0,_react.useCallback)(()=>{updateProgress({state:"error"});},[updateProgress]);// Error handling utilities
-const handleNativeError=(0,_react.useCallback)(nativeError=>{const standardError=(0,_errors.translateError)(nativeError);setError(standardError);setLoading(false);errorProgress();// Development logging
-if((0,_errors.isDevelopment)()){console.group(`🚨 ${hookName} Error`);console.log("Standard Error:",standardError);console.log("Native Error:",nativeError);console.groupEnd();}return standardError;},[hookName,errorProgress]);const clearError=(0,_react.useCallback)(()=>{setError(null);if(progress.state==="error"){resetProgress();}},[progress.state,resetProgress]);// Data management utilities
-const setDataAndComplete=(0,_react.useCallback)(newData=>{setData(newData);setLoading(false);completeProgress();setError(null);if((0,_errors.isDevelopment)()){console.log("✅ Native hook success:",hookName,newData);}},[hookName,completeProgress]);const clear=(0,_react.useCallback)(()=>{setData(null);setError(null);resetProgress();if((0,_errors.isDevelopment)()){console.log(`🗑️ ${hookName} Cleared`);}},[hookName,resetProgress]);// Fire-and-forget native call — no-ops silently on web, routes errors through handleNativeError on native
-const callNative=(0,_react.useCallback)(fn=>{if(!isNative()){if((0,_errors.isDevelopment)()){console.warn(`${hookName} callNative skipped — not in native environment`);}return;}try{fn();}catch(err){if((0,_errors.isDevelopment)()){console.warn("Native hook call failed silently:",hookName,err);}}},[hookName,isNative]);// Operation wrapper that handles common patterns
-const executeOperation=(0,_react.useCallback)((operationCallback,operationName="operation")=>{try{if(isWeb()){console.warn(`${hookName} requires web fallback implementation (isWeb: true)`);return;}if(!isNative()){console.error(`${hookName} executeOperation: Native bridge not available`);return;}setLoading(true);setError(null);startProgress("starting",`Starting ${operationName}...`);if((0,_errors.isDevelopment)()){console.log(`🚀 ${hookName} ${operationName} started`);}// Execute the actual operation
-operationCallback();}catch(err){handleNativeError(err);console.error("❌ Native hook operation failed:",hookName,operationName,err);}},[hookName,isWeb,isNative,startProgress,handleNativeError]);// Environment flags (computed values, not functions)
-const environmentFlags={isWeb:isWeb(),isNative:isNative()};// Return standardized interface
-return{// Data state
-data,// Loading states
-loading,progress,// Error handling
-error,// Environment detection
-...environmentFlags,// Web fallback control
-webFallbackActive,webFallbackDisabled,setWebFallback,// Actions
-clear,clearError,// Internal utilities for specific hooks
-setData,setLoading,setError,setProgress,updateProgress,resetProgress,startProgress,completeProgress,errorProgress,setDataAndComplete,handleNativeError,callNative,executeOperation};};/**
+ */
+const useBaseHook = (hookName, {
+  hasWebFallback = false,
+  webFallback
+} = {}) => {
+  // Environment detection — live check at call time, never stale from SSR
+  const isNative = (0, _react.useCallback)(() => {
+    if (typeof window === "undefined") return false;
+    return !!(window.WebBridge && _NativeBridge.default.isAvailable());
+  }, []);
+  const isWeb = (0, _react.useCallback)(() => {
+    return !isNative();
+  }, [isNative]);
+
+  // Web fallback state — only meaningful when isWeb() and hook declared hasWebFallback:true
+  // State tracks imperative setWebFallback() calls. The prop is the synchronous source of truth
+  // when provided — prop wins so there is no async gap between prop change and disabled state.
+  const [webFallbackState, setWebFallback] = (0, _react.useState)(true);
+
+  // When prop is explicitly provided, use it directly (synchronous). When undefined, fall back to state.
+  const webFallbackResolved = webFallback !== undefined ? !!webFallback : webFallbackState;
+  const webFallbackActive = isWeb() && hasWebFallback && webFallbackResolved;
+  const webFallbackDisabled = isWeb() && hasWebFallback && !webFallbackResolved;
+
+  // Common state management
+  const [data, setData] = (0, _react.useState)(null);
+  const [loading, setLoading] = (0, _react.useState)(false);
+  const [error, setError] = (0, _react.useState)(null);
+  const [progress, setProgress] = (0, _react.useState)({
+    state: "idle",
+    // 'idle' | 'opening' | 'processing' | 'routing' | 'complete' | 'error'
+    percentage: null,
+    // 0-100 or null
+    message: null,
+    // Human readable message or null
+    phase: null,
+    // Operation specific phase or null
+    transport: null,
+    // Transport method being used
+    bytesLoaded: null,
+    // Bytes processed
+    bytesTotal: null // Total bytes
+  });
+
+  // Progress management utilities
+  const updateProgress = (0, _react.useCallback)(updates => {
+    setProgress(prev => ({
+      ...prev,
+      ...updates
+    }));
+  }, []);
+  const resetProgress = (0, _react.useCallback)(() => {
+    setProgress({
+      state: "idle",
+      percentage: null,
+      message: null,
+      phase: null,
+      transport: null,
+      bytesLoaded: null,
+      bytesTotal: null
+    });
+  }, []);
+  const startProgress = (0, _react.useCallback)((phase = null, message = null) => {
+    updateProgress({
+      state: "active",
+      phase,
+      message,
+      percentage: null
+    });
+  }, [updateProgress]);
+  const completeProgress = (0, _react.useCallback)(() => {
+    updateProgress({
+      state: "complete",
+      percentage: 100
+    });
+  }, [updateProgress]);
+  const errorProgress = (0, _react.useCallback)(() => {
+    updateProgress({
+      state: "error"
+    });
+  }, [updateProgress]);
+
+  // Error handling utilities
+  const handleNativeError = (0, _react.useCallback)(nativeError => {
+    const standardError = (0, _errors.translateError)(nativeError);
+    setError(standardError);
+    setLoading(false);
+    errorProgress();
+
+    // Development logging
+    if ((0, _errors.isDevelopment)()) {
+      console.group(`🚨 ${hookName} Error`);
+      console.log("Standard Error:", standardError);
+      console.log("Native Error:", nativeError);
+      console.groupEnd();
+    }
+    return standardError;
+  }, [hookName, errorProgress]);
+  const clearError = (0, _react.useCallback)(() => {
+    setError(null);
+    if (progress.state === "error") {
+      resetProgress();
+    }
+  }, [progress.state, resetProgress]);
+
+  // Data management utilities
+  const setDataAndComplete = (0, _react.useCallback)(newData => {
+    setData(newData);
+    setLoading(false);
+    completeProgress();
+    setError(null);
+    if ((0, _errors.isDevelopment)()) {
+      console.log("✅ Native hook success:", hookName, newData);
+    }
+  }, [hookName, completeProgress]);
+  const clear = (0, _react.useCallback)(() => {
+    setData(null);
+    setError(null);
+    resetProgress();
+    if ((0, _errors.isDevelopment)()) {
+      console.log(`🗑️ ${hookName} Cleared`);
+    }
+  }, [hookName, resetProgress]);
+
+  // Fire-and-forget native call — no-ops silently on web, routes errors through handleNativeError on native
+  const callNative = (0, _react.useCallback)(fn => {
+    if (!isNative()) {
+      if ((0, _errors.isDevelopment)()) {
+        console.warn(`${hookName} callNative skipped — not in native environment`);
+      }
+      return;
+    }
+    try {
+      fn();
+    } catch (err) {
+      if ((0, _errors.isDevelopment)()) {
+        console.warn("Native hook call failed silently:", hookName, err);
+      }
+    }
+  }, [hookName, isNative]);
+
+  // Operation wrapper that handles common patterns
+  const executeOperation = (0, _react.useCallback)((operationCallback, operationName = "operation") => {
+    try {
+      if (isWeb()) {
+        console.warn(`${hookName} requires web fallback implementation (isWeb: true)`);
+        return;
+      }
+      if (!isNative()) {
+        console.error(`${hookName} executeOperation: Native bridge not available`);
+        return;
+      }
+      setLoading(true);
+      setError(null);
+      startProgress("starting", `Starting ${operationName}...`);
+      if ((0, _errors.isDevelopment)()) {
+        console.log(`🚀 ${hookName} ${operationName} started`);
+      }
+
+      // Execute the actual operation
+      operationCallback();
+    } catch (err) {
+      handleNativeError(err);
+      console.error("❌ Native hook operation failed:", hookName, operationName, err);
+    }
+  }, [hookName, isWeb, isNative, startProgress, handleNativeError]);
+
+  // Environment flags (computed values, not functions)
+  const environmentFlags = {
+    isWeb: isWeb(),
+    isNative: isNative()
+  };
+
+  // Return standardized interface
+  return {
+    // Data state
+    data,
+    // Loading states
+    loading,
+    progress,
+    // Error handling
+    error,
+    // Environment detection
+    ...environmentFlags,
+    // Web fallback control
+    webFallbackActive,
+    webFallbackDisabled,
+    setWebFallback,
+    // Actions
+    clear,
+    clearError,
+    // Internal utilities for specific hooks
+    setData,
+    setLoading,
+    setError,
+    setProgress,
+    updateProgress,
+    resetProgress,
+    startProgress,
+    completeProgress,
+    errorProgress,
+    setDataAndComplete,
+    handleNativeError,
+    callNative,
+    executeOperation
+  };
+};
+
+/**
  * Hook for development debugging and testing
  * @param {string} hookName
  * @returns {Object} Environment information and utilities
- */exports.useBaseHook=useBaseHook;const useEnvironmentInfo=hookName=>{const isNativeAvailable=()=>{if(typeof window==="undefined")return false;return!!(window.WebBridge&&_NativeBridge.default.isAvailable());};const getEnvironmentDetails=()=>{const details={hasWindow:typeof window!=="undefined",hasWebBridge:typeof window!=="undefined"&&!!window.WebBridge,nativeBridgeAvailable:false,userAgent:typeof navigator!=="undefined"?navigator.userAgent:"SSR",timestamp:new Date().toISOString()};if(details.hasWebBridge){details.nativeBridgeAvailable=_NativeBridge.default.isAvailable();}return details;};if((0,_errors.isDevelopment)()){console.log("🔍 Native hook environment:",hookName,getEnvironmentDetails());}return{isNative:isNativeAvailable(),isWeb:!isNativeAvailable(),environmentDetails:getEnvironmentDetails()};};/**
+ */
+exports.useBaseHook = useBaseHook;
+const useEnvironmentInfo = hookName => {
+  const isNativeAvailable = () => {
+    if (typeof window === "undefined") return false;
+    return !!(window.WebBridge && _NativeBridge.default.isAvailable());
+  };
+  const getEnvironmentDetails = () => {
+    const details = {
+      hasWindow: typeof window !== "undefined",
+      hasWebBridge: typeof window !== "undefined" && !!window.WebBridge,
+      nativeBridgeAvailable: false,
+      userAgent: typeof navigator !== "undefined" ? navigator.userAgent : "SSR",
+      timestamp: new Date().toISOString()
+    };
+    if (details.hasWebBridge) {
+      details.nativeBridgeAvailable = _NativeBridge.default.isAvailable();
+    }
+    return details;
+  };
+  if ((0, _errors.isDevelopment)()) {
+    console.log("🔍 Native hook environment:", hookName, getEnvironmentDetails());
+  }
+  return {
+    isNative: isNativeAvailable(),
+    isWeb: !isNativeAvailable(),
+    environmentDetails: getEnvironmentDetails()
+  };
+};
+
+/**
  * Progress state constants for consistency across hooks
- */exports.useEnvironmentInfo=useEnvironmentInfo;const PROGRESS_STATES=exports.PROGRESS_STATES={// Common states
-IDLE:"idle",STARTING:"starting",COMPLETE:"complete",ERROR:"error",// File Picker states
-OPENING:"opening",PROCESSING:"processing",ROUTING:"routing",// Camera states
-REQUESTING:"requesting",CAPTURING:"capturing",// Intent states
-DOWNLOADING:"downloading",OPENING_FILE:"opening_file",// Server states
-CONNECTING:"connecting",UPLOADING:"uploading",SERVING:"serving"};
+ */
+exports.useEnvironmentInfo = useEnvironmentInfo;
+const PROGRESS_STATES = exports.PROGRESS_STATES = {
+  // Common states
+  IDLE: "idle",
+  STARTING: "starting",
+  COMPLETE: "complete",
+  ERROR: "error",
+  // File Picker states
+  OPENING: "opening",
+  PROCESSING: "processing",
+  ROUTING: "routing",
+  // Camera states
+  REQUESTING: "requesting",
+  CAPTURING: "capturing",
+  // Intent states
+  DOWNLOADING: "downloading",
+  OPENING_FILE: "opening_file",
+  // Server states
+  CONNECTING: "connecting",
+  UPLOADING: "uploading",
+  SERVING: "serving"
+};

package/dist/native/bridge/utils/CameraUtils.js

@@ -1,58 +1,203 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.default=void 0;var _NativeInterfaces=require("../constants/NativeInterfaces.js");var _NativeBridge=_interopRequireDefault(require("./NativeBridge.js"));function _interopRequireDefault(e){return e&&e.__esModule?e:{default:e};}/**
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _NativeInterfaces = require("../constants/NativeInterfaces.js");
+var _NativeBridge = _interopRequireDefault(require("./NativeBridge.js"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
  * Camera Utility Module
  * Provides Promise-based camera operations with proper option validation
- */class CameraUtils{/**
-     * Open camera and capture image
-     * @param {Object} options - Camera options
-     * @param {string} options.quality - Image quality: 'high', 'medium', 'low'
-     * @param {string} options.format - Image format: 'jpeg', 'png'
-     * @param {string} options.cameraDevice - Camera device: 'front', 'rear'
-     * @param {string} options.flashMode - Flash mode: 'auto', 'on', 'off'
-     * @param {boolean} options.allowEditing - Allow image editing after capture
-     * @param {Function} registerCallback - Callback registration function
-     * @param {Function} unregisterCallback - Callback unregistration function
-     * @returns {Promise<Object>} - Promise that resolves with camera result or rejects with error
-     */static openCamera(options={},registerCallback,unregisterCallback){return new Promise((resolve,reject)=>{const cleanup=()=>{unregisterCallback(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_CAPTURE);unregisterCallback(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_ERROR);};// Validate and set defaults for options
-const cameraOptions=CameraUtils.validateCameraOptions(options);registerCallback(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_CAPTURE,data=>{cleanup();try{const result=typeof data==="string"?JSON.parse(data):data;if(result.error){reject(new Error(result.error));}else{resolve(result);}}catch(error){reject(error);}});registerCallback(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_ERROR,error=>{cleanup();const errorMessage=typeof error==="string"?error:error.error||error.message||"Unknown camera error";reject(new Error(errorMessage));});try{_NativeBridge.default.camera.open(JSON.stringify(cameraOptions));}catch(error){cleanup();reject(error);}});}/**
-     * Request camera permission
-     * @param {Object} config - Permission configuration
-     * @param {boolean} config.includeDetails - Include detailed permission info in response
-     * @param {Function} registerCallback - Callback registration function
-     * @param {Function} unregisterCallback - Callback unregistration function
-     * @returns {Promise<Object>} - Promise that resolves with permission status or rejects with error
-     */static requestCameraPermission(config={},registerCallback,unregisterCallback){return new Promise((resolve,reject)=>{const cleanup=()=>{unregisterCallback(_NativeInterfaces.NATIVE_CALLBACKS.CAMERA_PERMISSION_STATUS);};// Validate and set defaults for config
-const permissionConfig={includeDetails:config.includeDetails||false,...config};registerCallback(_NativeInterfaces.NATIVE_CALLBACKS.CAMERA_PERMISSION_STATUS,data=>{cleanup();try{const result=typeof data==="string"?JSON.parse(data):data;if(result.error){reject(new Error(result.error));}else{resolve(result);}}catch(error){reject(error);}});try{_NativeBridge.default.camera.requestPermission(JSON.stringify(permissionConfig));}catch(error){cleanup();reject(error);}});}/**
-     * Validate camera options and set defaults
-     * @param {Object} options - Raw camera options
-     * @returns {Object} - Validated camera options with defaults
-     */static validateCameraOptions(options){const validated={};// Quality validation
-if(options.quality&&Object.values(_NativeInterfaces.CAMERA_QUALITY).includes(options.quality.toLowerCase())){validated.quality=options.quality.toLowerCase();}else{validated.quality=_NativeInterfaces.CAMERA_QUALITY.MEDIUM;// Default
-}// Format validation
-if(options.format&&Object.values(_NativeInterfaces.CAMERA_FORMAT).includes(options.format.toLowerCase())){validated.format=options.format.toLowerCase();}else{validated.format=_NativeInterfaces.CAMERA_FORMAT.JPEG;// Default
-}// Camera device validation
-if(options.cameraDevice&&Object.values(_NativeInterfaces.CAMERA_DEVICE).includes(options.cameraDevice.toLowerCase())){validated.cameraDevice=options.cameraDevice.toLowerCase();}// Flash mode validation
-if(options.flashMode&&Object.values(_NativeInterfaces.CAMERA_FLASH_MODE).includes(options.flashMode.toLowerCase())){validated.flashMode=options.flashMode.toLowerCase();}// Allow editing validation
-if(typeof options.allowEditing==="boolean"){validated.allowEditing=options.allowEditing;}else{validated.allowEditing=false;// Default
-}return validated;}/**
-     * Get default camera options
-     * @returns {Object} - Default camera options
-     */static getDefaultOptions(){return{quality:_NativeInterfaces.CAMERA_QUALITY.MEDIUM,format:_NativeInterfaces.CAMERA_FORMAT.JPEG,allowEditing:false};}/**
-     * Get default permission config
-     * @returns {Object} - Default permission config
-     */static getDefaultPermissionConfig(){return{includeDetails:false};}/**
-     * Validate camera quality
-     * @param {string} quality - Quality string to validate
-     * @returns {boolean} - True if valid quality
-     */static isValidQuality(quality){return quality&&Object.values(_NativeInterfaces.CAMERA_QUALITY).includes(quality.toLowerCase());}/**
-     * Validate camera format
-     * @param {string} format - Format string to validate
-     * @returns {boolean} - True if valid format
-     */static isValidFormat(format){return format&&Object.values(_NativeInterfaces.CAMERA_FORMAT).includes(format.toLowerCase());}/**
-     * Validate camera device
-     * @param {string} device - Device string to validate
-     * @returns {boolean} - True if valid device
-     */static isValidDevice(device){return device&&Object.values(_NativeInterfaces.CAMERA_DEVICE).includes(device.toLowerCase());}/**
-     * Validate flash mode
-     * @param {string} flashMode - Flash mode string to validate
-     * @returns {boolean} - True if valid flash mode
-     */static isValidFlashMode(flashMode){return flashMode&&Object.values(_NativeInterfaces.CAMERA_FLASH_MODE).includes(flashMode.toLowerCase());}}var _default=exports.default=CameraUtils;
+ */
+class CameraUtils {
+  /**
+   * Open camera and capture image
+   * @param {Object} options - Camera options
+   * @param {string} options.quality - Image quality: 'high', 'medium', 'low'
+   * @param {string} options.format - Image format: 'jpeg', 'png'
+   * @param {string} options.cameraDevice - Camera device: 'front', 'rear'
+   * @param {string} options.flashMode - Flash mode: 'auto', 'on', 'off'
+   * @param {boolean} options.allowEditing - Allow image editing after capture
+   * @param {Function} registerCallback - Callback registration function
+   * @param {Function} unregisterCallback - Callback unregistration function
+   * @returns {Promise<Object>} - Promise that resolves with camera result or rejects with error
+   */
+  static openCamera(options = {}, registerCallback, unregisterCallback) {
+    return new Promise((resolve, reject) => {
+      const cleanup = () => {
+        unregisterCallback(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_CAPTURE);
+        unregisterCallback(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_ERROR);
+      };
+
+      // Validate and set defaults for options
+      const cameraOptions = CameraUtils.validateCameraOptions(options);
+      registerCallback(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_CAPTURE, data => {
+        cleanup();
+        try {
+          const result = typeof data === "string" ? JSON.parse(data) : data;
+          if (result.error) {
+            reject(new Error(result.error));
+          } else {
+            resolve(result);
+          }
+        } catch (error) {
+          reject(error);
+        }
+      });
+      registerCallback(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_ERROR, error => {
+        cleanup();
+        const errorMessage = typeof error === "string" ? error : error.error || error.message || "Unknown camera error";
+        reject(new Error(errorMessage));
+      });
+      try {
+        _NativeBridge.default.camera.open(JSON.stringify(cameraOptions));
+      } catch (error) {
+        cleanup();
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Request camera permission
+   * @param {Object} config - Permission configuration
+   * @param {boolean} config.includeDetails - Include detailed permission info in response
+   * @param {Function} registerCallback - Callback registration function
+   * @param {Function} unregisterCallback - Callback unregistration function
+   * @returns {Promise<Object>} - Promise that resolves with permission status or rejects with error
+   */
+  static requestCameraPermission(config = {}, registerCallback, unregisterCallback) {
+    return new Promise((resolve, reject) => {
+      const cleanup = () => {
+        unregisterCallback(_NativeInterfaces.NATIVE_CALLBACKS.CAMERA_PERMISSION_STATUS);
+      };
+
+      // Validate and set defaults for config
+      const permissionConfig = {
+        includeDetails: config.includeDetails || false,
+        ...config
+      };
+      registerCallback(_NativeInterfaces.NATIVE_CALLBACKS.CAMERA_PERMISSION_STATUS, data => {
+        cleanup();
+        try {
+          const result = typeof data === "string" ? JSON.parse(data) : data;
+          if (result.error) {
+            reject(new Error(result.error));
+          } else {
+            resolve(result);
+          }
+        } catch (error) {
+          reject(error);
+        }
+      });
+      try {
+        _NativeBridge.default.camera.requestPermission(JSON.stringify(permissionConfig));
+      } catch (error) {
+        cleanup();
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Validate camera options and set defaults
+   * @param {Object} options - Raw camera options
+   * @returns {Object} - Validated camera options with defaults
+   */
+  static validateCameraOptions(options) {
+    const validated = {};
+
+    // Quality validation
+    if (options.quality && Object.values(_NativeInterfaces.CAMERA_QUALITY).includes(options.quality.toLowerCase())) {
+      validated.quality = options.quality.toLowerCase();
+    } else {
+      validated.quality = _NativeInterfaces.CAMERA_QUALITY.MEDIUM; // Default
+    }
+
+    // Format validation
+    if (options.format && Object.values(_NativeInterfaces.CAMERA_FORMAT).includes(options.format.toLowerCase())) {
+      validated.format = options.format.toLowerCase();
+    } else {
+      validated.format = _NativeInterfaces.CAMERA_FORMAT.JPEG; // Default
+    }
+
+    // Camera device validation
+    if (options.cameraDevice && Object.values(_NativeInterfaces.CAMERA_DEVICE).includes(options.cameraDevice.toLowerCase())) {
+      validated.cameraDevice = options.cameraDevice.toLowerCase();
+    }
+
+    // Flash mode validation
+    if (options.flashMode && Object.values(_NativeInterfaces.CAMERA_FLASH_MODE).includes(options.flashMode.toLowerCase())) {
+      validated.flashMode = options.flashMode.toLowerCase();
+    }
+
+    // Allow editing validation
+    if (typeof options.allowEditing === "boolean") {
+      validated.allowEditing = options.allowEditing;
+    } else {
+      validated.allowEditing = false; // Default
+    }
+    return validated;
+  }
+
+  /**
+   * Get default camera options
+   * @returns {Object} - Default camera options
+   */
+  static getDefaultOptions() {
+    return {
+      quality: _NativeInterfaces.CAMERA_QUALITY.MEDIUM,
+      format: _NativeInterfaces.CAMERA_FORMAT.JPEG,
+      allowEditing: false
+    };
+  }
+
+  /**
+   * Get default permission config
+   * @returns {Object} - Default permission config
+   */
+  static getDefaultPermissionConfig() {
+    return {
+      includeDetails: false
+    };
+  }
+
+  /**
+   * Validate camera quality
+   * @param {string} quality - Quality string to validate
+   * @returns {boolean} - True if valid quality
+   */
+  static isValidQuality(quality) {
+    return quality && Object.values(_NativeInterfaces.CAMERA_QUALITY).includes(quality.toLowerCase());
+  }
+
+  /**
+   * Validate camera format
+   * @param {string} format - Format string to validate
+   * @returns {boolean} - True if valid format
+   */
+  static isValidFormat(format) {
+    return format && Object.values(_NativeInterfaces.CAMERA_FORMAT).includes(format.toLowerCase());
+  }
+
+  /**
+   * Validate camera device
+   * @param {string} device - Device string to validate
+   * @returns {boolean} - True if valid device
+   */
+  static isValidDevice(device) {
+    return device && Object.values(_NativeInterfaces.CAMERA_DEVICE).includes(device.toLowerCase());
+  }
+
+  /**
+   * Validate flash mode
+   * @param {string} flashMode - Flash mode string to validate
+   * @returns {boolean} - True if valid flash mode
+   */
+  static isValidFlashMode(flashMode) {
+    return flashMode && Object.values(_NativeInterfaces.CAMERA_FLASH_MODE).includes(flashMode.toLowerCase());
+  }
+}
+var _default = exports.default = CameraUtils;