catalyst-core 0.3.0-beta.5 → 0.3.0-canary.2

package/dist/native/bridge/standardizedHooks.js

@@ -1,611 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.useIntent = exports.useFilePicker = exports.useCamera = void 0;
-var _react = require("react");
-var _useBaseHook = require("./useBaseHook");
-var _NativeBridge = _interopRequireDefault(require("./utils/NativeBridge.js"));
-var _NativeInterfaces = require("./constants/NativeInterfaces");
-var _errors = require("./errors");
-var _FileObjectConverter = require("./utils/FileObjectConverter.js");
-function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-/* eslint-disable react-compiler/react-compiler, react-hooks/exhaustive-deps, no-case-declarations */
-
-/**
- * Standardized Camera Superhook
- * Comprehensive camera functionality with integrated permission management
- * Follows standardized interface with execute as primary function
- *
- * @param {Object} options - Configuration options
- * @returns {Object} Standardized camera superhook interface
- */
-const useCamera = (options = {}) => {
-  const base = (0, _useBaseHook.useBaseHook)("useCamera", options);
-  const [permission, setPermission] = (0, _react.useState)({
-    status: "not_determined",
-    canRequest: true,
-    lastChecked: null
-  });
-
-  // Camera operations
-  const CAMERA_OPERATIONS = {
-    TAKE_PHOTO: "takePhoto",
-    REQUEST_PERMISSION: "requestPermission",
-    CHECK_PERMISSION: "checkPermission"
-  };
-
-  // Camera-specific progress phases
-  const CAMERA_PHASES = {
-    REQUESTING_PERMISSION: "requesting_permission",
-    CHECKING_PERMISSION: "checking_permission",
-    OPENING_CAMERA: "opening_camera",
-    CAPTURING: "capturing",
-    PROCESSING: "processing",
-    COMPLETE: "complete"
-  };
-  (0, _react.useEffect)(() => {
-    // Server-side rendering safety
-    if (typeof window === "undefined") return;
-    if (!window.WebBridge) {
-      console.warn("WebBridge not initialized. Camera functionality unavailable.");
-      return;
-    }
-
-    // Camera capture success handler
-    const handleCameraCapture = data => {
-      try {
-        const result = typeof data === "string" ? JSON.parse(data) : data;
-        base.updateProgress({
-          phase: CAMERA_PHASES.PROCESSING,
-          message: "Processing captured photo..."
-        });
-
-        // Handle new tri-transport format or legacy format
-        const photoData = result.fileSrc ? {
-          // New tri-transport format
-          fileSrc: result.fileSrc,
-          fileName: result.fileName,
-          size: result.size,
-          mimeType: result.mimeType,
-          transport: result.transport,
-          source: result.source,
-          filePath: result.filePath
-        } : {
-          // Legacy format (fallback)
-          fileSrc: result.imageUrl,
-          fileName: result.fileName || "camera_photo.jpg",
-          size: result.size || 0,
-          mimeType: result.mimeType || "image/jpeg",
-          transport: "LEGACY",
-          source: "camera",
-          filePath: result.filePath || null
-        };
-
-        // Create comprehensive data object with photo and permission info
-        const cameraData = {
-          ...photoData,
-          permission: permission,
-          lastOperation: CAMERA_OPERATIONS.TAKE_PHOTO,
-          operationSuccess: true,
-          timestamp: new Date().toISOString()
-        };
-        base.setDataAndComplete(cameraData);
-        console.log("📷 Photo captured successfully via transport:", photoData.transport);
-      } catch (parseError) {
-        console.error("📷 Error parsing camera capture data:", parseError);
-        const error = (0, _errors.createStandardError)(_errors.ERROR_CODES.INTERNAL_ERROR, "Failed to process captured photo", parseError);
-        base.handleNativeError(error);
-      }
-    };
-
-    // Camera permission status handler
-    const handlePermissionStatus = data => {
-      const permissionStatus = typeof data === "string" ? data : data.status || data;
-      const newPermission = {
-        status: permissionStatus.toLowerCase(),
-        canRequest: permissionStatus !== "permanently_denied",
-        lastChecked: new Date().toISOString()
-      };
-      setPermission(newPermission);
-      console.log("📷 Camera permission status:", newPermission);
-
-      // Update data with permission info
-      const permissionData = {
-        permission: newPermission,
-        lastOperation: CAMERA_OPERATIONS.REQUEST_PERMISSION,
-        operationSuccess: permissionStatus === "GRANTED",
-        timestamp: new Date().toISOString()
-      };
-      if (permissionStatus === "GRANTED") {
-        base.updateProgress({
-          phase: CAMERA_PHASES.OPENING_CAMERA,
-          message: "Camera permission granted, ready to capture..."
-        });
-        base.setDataAndComplete(permissionData);
-      } else if (permissionStatus === "DENIED") {
-        const error = (0, _errors.createStandardError)(_errors.ERROR_CODES.PERMISSION_DENIED, "Camera permission denied", null, "Camera permission is required to take photos");
-        base.handleNativeError(error);
-      }
-    };
-
-    // Camera error handler
-    const handleCameraError = data => {
-      console.error("📷 Camera error:", data);
-      base.handleNativeError(data);
-    };
-
-    // Register event listeners
-    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_CAPTURE, handleCameraCapture);
-    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.CAMERA_PERMISSION_STATUS, handlePermissionStatus);
-    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_ERROR, handleCameraError);
-
-    // Cleanup function
-    return () => {
-      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_CAPTURE);
-      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.CAMERA_PERMISSION_STATUS);
-      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_CAMERA_ERROR);
-    };
-  }, [base]);
-
-  // Main execute function for camera superhook
-  const executeCamera = (operation, ...args) => {
-    if (base.isWeb) {
-      console.warn(`Camera ${operation} requires web fallback implementation (isWeb: true)`);
-      return;
-    }
-    switch (operation) {
-      case CAMERA_OPERATIONS.TAKE_PHOTO:
-        return handleTakePhoto(args[0] || {});
-      case CAMERA_OPERATIONS.REQUEST_PERMISSION:
-        return handleRequestPermission();
-      case CAMERA_OPERATIONS.CHECK_PERMISSION:
-        return handleCheckPermission();
-      default:
-        const error = (0, _errors.createStandardError)(_errors.ERROR_CODES.INVALID_PARAMETERS, `Unknown camera operation: ${operation}`, null, `Valid operations: ${Object.values(CAMERA_OPERATIONS).join(", ")}`);
-        base.handleNativeError(error);
-    }
-  };
-
-  // Camera operation handlers
-  const handleTakePhoto = (cameraOptions = {}) => {
-    base.executeOperation(() => {
-      base.updateProgress({
-        phase: CAMERA_PHASES.REQUESTING_PERMISSION,
-        message: "Requesting camera permission..."
-      });
-      _NativeBridge.default.camera.open(cameraOptions);
-      console.log("📷 Camera open requested with options:", cameraOptions);
-    }, "photo capture");
-  };
-  const handleRequestPermission = () => {
-    base.executeOperation(() => {
-      base.updateProgress({
-        phase: CAMERA_PHASES.REQUESTING_PERMISSION,
-        message: "Requesting camera permission..."
-      });
-      if (_NativeBridge.default.camera.requestPermission) {
-        _NativeBridge.default.camera.requestPermission();
-      } else {
-        // Fallback method
-        _NativeBridge.default.camera.checkPermission();
-      }
-      console.log("📷 Camera permission requested");
-    }, "permission request");
-  };
-  const handleCheckPermission = () => {
-    base.executeOperation(() => {
-      base.updateProgress({
-        phase: CAMERA_PHASES.CHECKING_PERMISSION,
-        message: "Checking camera permission..."
-      });
-      _NativeBridge.default.camera.checkPermission();
-      console.log("📷 Camera permission check requested");
-    }, "permission check");
-  };
-
-  // Return standardized superhook interface
-  return {
-    // Standard interface (from useBaseHook)
-    data: base.data,
-    loading: base.loading,
-    progress: base.progress,
-    error: base.error,
-    isWeb: base.isWeb,
-    isNative: base.isNative,
-    clear: base.clear,
-    clearError: base.clearError,
-    // Main execute function
-    execute: executeCamera,
-    // Semantic aliases for execute
-    takePhoto: options => executeCamera(CAMERA_OPERATIONS.TAKE_PHOTO, options),
-    requestPermission: () => executeCamera(CAMERA_OPERATIONS.REQUEST_PERMISSION),
-    checkPermission: () => executeCamera(CAMERA_OPERATIONS.CHECK_PERMISSION),
-    // Current state info
-    permission: permission,
-    // Legacy compatibility
-    photo: base.data,
-    clearPhoto: base.clear
-  };
-};
-
-/**
- * Standardized File Picker Hook
- * Provides consistent interface with error standardization and environment detection
- *
- * @param {Object} options - Configuration options
- * @returns {Object} Standardized file picker interface
- */
-exports.useCamera = useCamera;
-const useFilePicker = (options = {}) => {
-  const base = (0, _useBaseHook.useBaseHook)("useFilePicker", options);
-
-  // Cache for converted File objects to prevent redundant conversions
-  const fileObjectCache = (0, _react.useRef)(null);
-
-  // File picker specific progress phases
-  const FILE_PICKER_PHASES = {
-    OPENING: "opening",
-    PROCESSING: "processing",
-    ROUTING: "routing",
-    COMPLETE: "complete"
-  };
-  (0, _react.useEffect)(() => {
-    // Server-side rendering safety
-    if (typeof window === "undefined") return;
-    if (!window.WebBridge) {
-      console.warn("WebBridge not initialized. File picker functionality unavailable.");
-      return;
-    }
-
-    // File picked success handler
-    const handleFilePicked = data => {
-      try {
-        const result = typeof data === "string" ? JSON.parse(data) : data;
-        console.log("📁 File picked result:", result);
-        base.updateProgress({
-          phase: FILE_PICKER_PHASES.PROCESSING,
-          message: "Processing selected file..."
-        });
-
-        // Handle tri-transport format
-        const fileData = {
-          fileSrc: result.fileSrc,
-          fileName: result.fileName,
-          size: result.size,
-          mimeType: result.mimeType,
-          transport: result.transport,
-          filePath: result.filePath
-        };
-
-        // Clear file object cache when new file is picked
-        fileObjectCache.current = null;
-        base.setDataAndComplete(fileData);
-        console.log("📁 File processed successfully via transport:", fileData.transport);
-      } catch (parseError) {
-        console.error("📁 Error parsing file picker data:", parseError);
-        const error = (0, _errors.createStandardError)(_errors.ERROR_CODES.INTERNAL_ERROR, "Failed to process selected file", parseError);
-        base.handleNativeError(error);
-      }
-    };
-
-    // File pick error handler
-    const handleFilePickError = data => {
-      console.error("📁 File pick error:", data);
-      base.handleNativeError(data);
-    };
-
-    // File pick cancelled handler
-    const handleFilePickCancelled = data => {
-      console.log("📁 File pick cancelled:", data);
-      const error = (0, _errors.createStandardError)(_errors.ERROR_CODES.OPERATION_CANCELLED, "File selection was cancelled", data);
-      base.handleNativeError(error);
-    };
-
-    // File picker state updates
-    const handleFilePickStateUpdate = data => {
-      try {
-        const stateData = typeof data === "string" ? JSON.parse(data) : data;
-        console.log("📁 File picker state:", stateData.state);
-        let phase = FILE_PICKER_PHASES.PROCESSING;
-        let message = "Processing...";
-        switch (stateData.state) {
-          case "opening":
-            phase = FILE_PICKER_PHASES.OPENING;
-            message = "Opening file picker...";
-            break;
-          case "processing":
-            phase = FILE_PICKER_PHASES.PROCESSING;
-            message = "Processing selected file...";
-            break;
-          case "routing":
-            phase = FILE_PICKER_PHASES.ROUTING;
-            message = "Determining transport method...";
-            break;
-          default:
-            message = stateData.state;
-        }
-        base.updateProgress({
-          phase,
-          message
-        });
-      } catch (parseError) {
-        console.error("📁 Error parsing file picker state:", parseError);
-      }
-    };
-
-    // Register event listeners
-    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_FILE_PICKED, handleFilePicked);
-    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_FILE_PICK_ERROR, handleFilePickError);
-    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_FILE_PICK_CANCELLED, handleFilePickCancelled);
-    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_FILE_PICK_STATE_UPDATE, handleFilePickStateUpdate);
-
-    // Cleanup function
-    return () => {
-      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_FILE_PICKED);
-      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_FILE_PICK_ERROR);
-      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_FILE_PICK_CANCELLED);
-      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_FILE_PICK_STATE_UPDATE);
-    };
-  }, [base]);
-
-  // Pick file function
-  const pickFile = (mimeType = null) => {
-    base.executeOperation(() => {
-      const finalMimeType = mimeType || "*/*";
-      base.updateProgress({
-        phase: FILE_PICKER_PHASES.OPENING,
-        message: `Opening file picker${mimeType ? ` for ${mimeType}` : ""}...`
-      });
-      _NativeBridge.default.file.pick(finalMimeType);
-      console.log("📁 File picker opened with MIME type:", finalMimeType);
-    }, "file selection");
-  };
-
-  /**
-   * Get File object from current file data
-   * Lazy loading - only converts when called
-   * Caches result to prevent redundant conversions
-   * @returns {Promise<File>} JavaScript File object for FormData/POST API
-   * @throws {Error} If file data is unavailable or transport is unsupported
-   */
-  const getFileObject = (0, _react.useCallback)(async () => {
-    // Validate file data exists
-    if (!base.data) {
-      throw new Error("No file data available. Please pick a file first.");
-    }
-
-    // Return cached File object if available
-    if (fileObjectCache.current) {
-      console.log("📁 Returning cached File object");
-      return fileObjectCache.current;
-    }
-    const {
-      fileSrc,
-      fileName,
-      mimeType,
-      transport
-    } = base.data;
-
-    // Check if transport supports File object creation
-    if (!(0, _FileObjectConverter.canCreateFileObject)(transport)) {
-      const errorMessage = (0, _FileObjectConverter.getUnsupportedTransportMessage)(transport);
-      console.error("❌", errorMessage);
-      throw new Error(errorMessage);
-    }
-    console.log("📁 Converting to File object", {
-      transport,
-      fileName,
-      mimeType
-    });
-    try {
-      let fileObject;
-      if (transport === "BRIDGE_BASE64") {
-        // Synchronous conversion for base64
-        fileObject = (0, _FileObjectConverter.base64ToFile)(fileSrc, fileName, mimeType);
-      } else if (transport === "FRAMEWORK_SERVER") {
-        // Asynchronous fetch and conversion for URL
-        fileObject = await (0, _FileObjectConverter.urlToFile)(fileSrc, fileName, mimeType);
-      }
-
-      // Cache the result
-      fileObjectCache.current = fileObject;
-      console.log("✅ File object created successfully", {
-        name: fileObject.name,
-        size: fileObject.size,
-        type: fileObject.type
-      });
-      return fileObject;
-    } catch (error) {
-      console.error("❌ Failed to create File object:", error);
-      throw new Error(`Failed to create File object: ${error.message}`);
-    }
-  }, [base.data]);
-
-  // Check if File object can be created from current file data
-  const canCreateFileObjectForCurrentFile = base.data ? (0, _FileObjectConverter.canCreateFileObject)(base.data.transport) : false;
-
-  // Return standardized interface
-  return {
-    // Standard interface
-    data: base.data,
-    loading: base.loading,
-    progress: base.progress,
-    error: base.error,
-    isWeb: base.isWeb,
-    isNative: base.isNative,
-    // Actions
-    execute: pickFile,
-    // Standard execute function
-    pickFile,
-    // Semantic alias
-    clear: base.clear,
-    clearError: base.clearError,
-    // File object conversion (NEW)
-    getFileObject,
-    // Lazy loading File object converter
-    canCreateFileObject: canCreateFileObjectForCurrentFile,
-    // Boolean flag
-
-    // Legacy compatibility (for gradual migration)
-    selectedFile: base.data,
-    // Legacy alias
-    isLoading: base.loading,
-    // Legacy alias
-    processingState: base.progress?.phase,
-    // Legacy alias
-    clearFile: base.clear // Legacy alias
-  };
-};
-
-/**
- * Standardized Intent Hook
- * Provides consistent interface with error standardization and environment detection
- *
- * @param {Object} options - Configuration options
- * @returns {Object} Standardized intent interface
- */
-exports.useFilePicker = useFilePicker;
-const useIntent = (options = {}) => {
-  const base = (0, _useBaseHook.useBaseHook)("useIntent", options);
-
-  // Intent specific progress phases
-  const INTENT_PHASES = {
-    PREPARING: "preparing",
-    DOWNLOADING: "downloading",
-    OPENING: "opening",
-    COMPLETE: "complete"
-  };
-  (0, _react.useEffect)(() => {
-    // Server-side rendering safety
-    if (typeof window === "undefined") return;
-    if (!window.WebBridge) {
-      console.warn("WebBridge not initialized. Intent functionality unavailable.");
-      return;
-    }
-
-    // Intent success handler
-    const handleIntentSuccess = data => {
-      try {
-        const result = typeof data === "string" ? JSON.parse(data) : data;
-        console.log("🔗 Intent success result:", result);
-        const intentData = {
-          url: result.url,
-          mimeType: result.mimeType,
-          success: result.success || true,
-          message: result.message || "File opened successfully"
-        };
-        base.setDataAndComplete(intentData);
-        console.log("🔗 Intent completed successfully");
-      } catch (parseError) {
-        console.error("🔗 Error parsing intent result:", parseError);
-        const error = (0, _errors.createStandardError)(_errors.ERROR_CODES.INTERNAL_ERROR, "Failed to process intent result", parseError);
-        base.handleNativeError(error);
-      }
-    };
-
-    // Intent error handler
-    const handleIntentError = data => {
-      console.error("🔗 Intent error:", data);
-      base.handleNativeError(data);
-    };
-
-    // Intent state updates (if available)
-    const handleIntentStateUpdate = data => {
-      try {
-        const stateData = typeof data === "string" ? JSON.parse(data) : data;
-        console.log("🔗 Intent state:", stateData.state);
-        let phase = INTENT_PHASES.PREPARING;
-        let message = "Processing...";
-        switch (stateData.state) {
-          case "preparing":
-            phase = INTENT_PHASES.PREPARING;
-            message = "Preparing to open file...";
-            break;
-          case "downloading":
-            phase = INTENT_PHASES.DOWNLOADING;
-            message = "Downloading file...";
-            break;
-          case "opening":
-            phase = INTENT_PHASES.OPENING;
-            message = "Opening with external app...";
-            break;
-          default:
-            message = stateData.state;
-        }
-        base.updateProgress({
-          phase,
-          message,
-          percentage: stateData.percentage || null
-        });
-      } catch (parseError) {
-        console.error("🔗 Error parsing intent state:", parseError);
-      }
-    };
-
-    // Register event listeners (some callbacks might not exist in legacy intent)
-    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_SUCCESS || "ON_INTENT_SUCCESS", handleIntentSuccess);
-    window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_ERROR || "ON_INTENT_ERROR", handleIntentError);
-
-    // Optional state updates (might not be implemented in current intent system)
-    if (_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_STATE_UPDATE) {
-      window.WebBridge.register(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_STATE_UPDATE, handleIntentStateUpdate);
-    }
-
-    // Cleanup function
-    return () => {
-      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_SUCCESS || "ON_INTENT_SUCCESS");
-      window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_ERROR || "ON_INTENT_ERROR");
-      if (_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_STATE_UPDATE) {
-        window.WebBridge.unregister(_NativeInterfaces.NATIVE_CALLBACKS.ON_INTENT_STATE_UPDATE);
-      }
-    };
-  }, [base]);
-
-  // Open file function
-  const openFile = (url, mimeType = null) => {
-    if (!url) {
-      const error = (0, _errors.createStandardError)(_errors.ERROR_CODES.INVALID_PARAMETERS, "URL is required for opening files", null, "Please provide a valid URL to open");
-      base.handleNativeError(error);
-      return;
-    }
-    base.executeOperation(() => {
-      const finalMimeType = mimeType || "*/*";
-      base.updateProgress({
-        phase: INTENT_PHASES.PREPARING,
-        message: `Preparing to open ${url}...`
-      });
-
-      // Check if intent system has specific methods
-      if (_NativeBridge.default.intent && _NativeBridge.default.intent.openFile) {
-        _NativeBridge.default.intent.openFile(url, finalMimeType);
-      } else {
-        // Fallback to generic method if available
-        _NativeBridge.default.openFile(url, finalMimeType);
-      }
-      console.log("🔗 Intent to open file:", url, "with MIME type:", finalMimeType);
-    }, "file opening");
-  };
-
-  // Return standardized interface
-  return {
-    // Standard interface
-    data: base.data,
-    loading: base.loading,
-    progress: base.progress,
-    error: base.error,
-    isWeb: base.isWeb,
-    isNative: base.isNative,
-    // Actions
-    execute: openFile,
-    // Standard execute function
-    openFile,
-    // Semantic alias
-    clear: base.clear,
-    clearError: base.clearError,
-    // Legacy compatibility (for gradual migration)
-    result: base.data // Legacy alias if needed
-  };
-};
-exports.useIntent = useIntent;

package/dist/router.js

@@ -1 +0,0 @@
-export * from "@tata1mg/router"