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

package/dist/native/bridge/constants/NativeInterfaces.d.ts

@@ -0,0 +1,391 @@
+export declare const NATIVE_COMMANDS: {
+    OPEN_CAMERA: string;
+    REQUEST_CAMERA_PERMISSION: string;
+    START_VIDEO_STREAM: string;
+    STOP_VIDEO_STREAM: string;
+    SET_VIDEO_STREAM_ZOOM: string;
+    SET_VIDEO_STREAM_TORCH: string;
+    SET_VIDEO_STREAM_FPS: string;
+    FLIP_VIDEO_STREAM: string;
+    PICK_FILE: string;
+    OPEN_FILE_WITH_INTENT: string;
+    REQUEST_HAPTIC_FEEDBACK: string;
+    SCHEDULE_LOCAL_NOTIFICATION: string;
+    CANCEL_LOCAL_NOTIFICATION: string;
+    REQUEST_NOTIFICATION_PERMISSION: string;
+    REGISTER_FOR_PUSH_NOTIFICATIONS: string;
+    UPDATE_BADGE_COUNT: string;
+    SUBSCRIBE_TO_TOPIC: string;
+    UNSUBSCRIBE_FROM_TOPIC: string;
+    GET_SUBSCRIBED_TOPICS: string;
+    GET_DEVICE_INFO: string;
+    GET_NETWORK_STATUS: string;
+    GOOGLE_SIGN_IN: string;
+    START_TRANSITION: string;
+    COMMIT_TRANSITION: string;
+    CANCEL_TRANSITION: string;
+    GET_SAFE_AREA: string;
+    SET_SCREEN_SECURE: string;
+    GET_SCREEN_SECURE: string;
+    CLEAR_WEB_DATA: string;
+    INIT_AI: string;
+    GENERATE_NATIVE: string;
+};
+export declare const NATIVE_CALLBACKS: {
+    CAMERA_PERMISSION_STATUS: string;
+    ON_CAMERA_CAPTURE: string;
+    ON_CAMERA_ERROR: string;
+    ON_VIDEO_STREAM_READY: string;
+    ON_VIDEO_STREAM_STOPPED: string;
+    ON_QR_DETECTED: string;
+    ON_TORCH_CHANGED: string;
+    ON_ZOOM_CHANGED: string;
+    ON_FILE_PICKED: string;
+    ON_FILE_PICK_ERROR: string;
+    ON_FILE_PICK_CANCELLED: string;
+    ON_FILE_PICK_STATE_UPDATE: string;
+    ON_INTENT_SUCCESS: string;
+    ON_INTENT_ERROR: string;
+    ON_INTENT_CANCELLED: string;
+    HAPTIC_FEEDBACK: string;
+    NOTIFICATION_PERMISSION_STATUS: string;
+    LOCAL_NOTIFICATION_SCHEDULED: string;
+    LOCAL_NOTIFICATION_CANCELLED: string;
+    PUSH_NOTIFICATION_TOKEN: string;
+    NOTIFICATION_RECEIVED: string;
+    NOTIFICATION_ACTION_PERFORMED: string;
+    NOTIFICATION_TAPPED: string;
+    TOPIC_SUBSCRIPTION_RESULT: string;
+    SUBSCRIBED_TOPICS_RESULT: string;
+    ON_DEVICE_INFO_SUCCESS: string;
+    ON_DEVICE_INFO_ERROR: string;
+    ON_GOOGLE_SIGN_IN_SUCCESS: string;
+    ON_GOOGLE_SIGN_IN_ERROR: string;
+    ON_GOOGLE_SIGN_IN_CANCELLED: string;
+    NETWORK_STATUS_CHANGED: string;
+    ON_SAFE_AREA_INSETS_UPDATED: string;
+    ON_TRANSITION_COMMITTED: string;
+    ON_TRANSITION_CANCELLED: string;
+    ON_TRANSITION_TIMEOUT: string;
+    ON_SCREEN_SECURE_SET: string;
+    ON_SCREEN_SECURE_STATUS: string;
+    ON_SCREEN_SECURE_ERROR: string;
+    ON_WEB_DATA_CLEARED: string;
+    ON_WEB_DATA_CLEAR_ERROR: string;
+    ON_AI_READY: string;
+    ON_AI_TOKEN: string;
+    ON_AI_DONE: string;
+    ON_AI_ERROR: string;
+    ON_AI_PROGRESS: string;
+    ON_AI_LOG: string;
+    CATALYST_PERF_EVENT: string;
+};
+export declare const INTERFACE_CATEGORIES: {
+    CAMERA: {
+        commands: string[];
+        callbacks: string[];
+    };
+    FILE: {
+        commands: string[];
+        callbacks: string[];
+    };
+    INTENT: {
+        commands: string[];
+        callbacks: string[];
+    };
+    HAPTIC: {
+        commands: string[];
+        callbacks: string[];
+    };
+    NOTIFICATION: {
+        commands: string[];
+        callbacks: string[];
+    };
+    DEVICE_INFO: {
+        commands: string[];
+        callbacks: string[];
+    };
+    AUTH: {
+        commands: string[];
+        callbacks: string[];
+    };
+    NETWORK: {
+        commands: string[];
+        callbacks: string[];
+    };
+    SECURITY: {
+        commands: string[];
+        callbacks: string[];
+    };
+    TRANSITION: {
+        commands: string[];
+        callbacks: string[];
+    };
+    AI: {
+        commands: string[];
+        callbacks: string[];
+    };
+};
+export declare const ALL_COMMANDS: string[];
+export declare const ALL_CALLBACKS: string[];
+export declare const ALL_INTERFACES: string[];
+export declare const PERMISSION_STATUS: {
+    GRANTED: string;
+    DENIED: string;
+    NOT_DETERMINED: string;
+    RESTRICTED: string;
+};
+export declare const HAPTIC_FEEDBACK_TYPES: {
+    VIRTUAL_KEY: string;
+    LONG_PRESS: string;
+    DEFAULT: string;
+    LIGHT: string;
+    MEDIUM: string;
+    HEAVY: string;
+};
+export declare const FILE_PICKER_STATES: {
+    OPENING: string;
+    PROCESSING: string;
+    IDLE: any;
+};
+export declare const INTENT_STATES: {
+    PROCESSING: string;
+    DOWNLOADING: string;
+    OPENING: string;
+    IDLE: any;
+};
+export declare const CAMERA_QUALITY: {
+    HIGH: string;
+    MEDIUM: string;
+    LOW: string;
+};
+export declare const CAMERA_FORMAT: {
+    JPEG: string;
+    PNG: string;
+};
+export declare const CAMERA_DEVICE: {
+    FRONT: string;
+    REAR: string;
+    BACK: string;
+};
+export declare const CAMERA_FLASH_MODE: {
+    AUTO: string;
+    ON: string;
+    OFF: string;
+};
+export declare const TRANSPORT_TYPES: {
+    BASE64: string;
+    FILE_URL: string;
+    FRAMEWORK_SERVER: string;
+};
+export declare const CAMERA_SOURCE: {
+    CAMERA: string;
+    FILE_PICKER: string;
+};
+export declare const RESPONSE_STATUS: {
+    SUCCESS: string;
+    ERROR: string;
+    CANCELLED: string;
+};
+export declare const isValidCommand: (command: any) => boolean;
+export declare const isValidCallback: (callback: any) => boolean;
+export declare const isValidInterface: (interfaceName: any) => boolean;
+export declare const getInterfacesByCategory: (category: any) => any;
+export declare const debugInterfaces: () => void;
+declare const _default: {
+    NATIVE_COMMANDS: {
+        OPEN_CAMERA: string;
+        REQUEST_CAMERA_PERMISSION: string;
+        START_VIDEO_STREAM: string;
+        STOP_VIDEO_STREAM: string;
+        SET_VIDEO_STREAM_ZOOM: string;
+        SET_VIDEO_STREAM_TORCH: string;
+        SET_VIDEO_STREAM_FPS: string;
+        FLIP_VIDEO_STREAM: string;
+        PICK_FILE: string;
+        OPEN_FILE_WITH_INTENT: string;
+        REQUEST_HAPTIC_FEEDBACK: string;
+        SCHEDULE_LOCAL_NOTIFICATION: string;
+        CANCEL_LOCAL_NOTIFICATION: string;
+        REQUEST_NOTIFICATION_PERMISSION: string;
+        REGISTER_FOR_PUSH_NOTIFICATIONS: string;
+        UPDATE_BADGE_COUNT: string;
+        SUBSCRIBE_TO_TOPIC: string;
+        UNSUBSCRIBE_FROM_TOPIC: string;
+        GET_SUBSCRIBED_TOPICS: string;
+        GET_DEVICE_INFO: string;
+        GET_NETWORK_STATUS: string;
+        GOOGLE_SIGN_IN: string;
+        START_TRANSITION: string;
+        COMMIT_TRANSITION: string;
+        CANCEL_TRANSITION: string;
+        GET_SAFE_AREA: string;
+        SET_SCREEN_SECURE: string;
+        GET_SCREEN_SECURE: string;
+        CLEAR_WEB_DATA: string;
+        INIT_AI: string;
+        GENERATE_NATIVE: string;
+    };
+    NATIVE_CALLBACKS: {
+        CAMERA_PERMISSION_STATUS: string;
+        ON_CAMERA_CAPTURE: string;
+        ON_CAMERA_ERROR: string;
+        ON_VIDEO_STREAM_READY: string;
+        ON_VIDEO_STREAM_STOPPED: string;
+        ON_QR_DETECTED: string;
+        ON_TORCH_CHANGED: string;
+        ON_ZOOM_CHANGED: string;
+        ON_FILE_PICKED: string;
+        ON_FILE_PICK_ERROR: string;
+        ON_FILE_PICK_CANCELLED: string;
+        ON_FILE_PICK_STATE_UPDATE: string;
+        ON_INTENT_SUCCESS: string;
+        ON_INTENT_ERROR: string;
+        ON_INTENT_CANCELLED: string;
+        HAPTIC_FEEDBACK: string;
+        NOTIFICATION_PERMISSION_STATUS: string;
+        LOCAL_NOTIFICATION_SCHEDULED: string;
+        LOCAL_NOTIFICATION_CANCELLED: string;
+        PUSH_NOTIFICATION_TOKEN: string;
+        NOTIFICATION_RECEIVED: string;
+        NOTIFICATION_ACTION_PERFORMED: string;
+        NOTIFICATION_TAPPED: string;
+        TOPIC_SUBSCRIPTION_RESULT: string;
+        SUBSCRIBED_TOPICS_RESULT: string;
+        ON_DEVICE_INFO_SUCCESS: string;
+        ON_DEVICE_INFO_ERROR: string;
+        ON_GOOGLE_SIGN_IN_SUCCESS: string;
+        ON_GOOGLE_SIGN_IN_ERROR: string;
+        ON_GOOGLE_SIGN_IN_CANCELLED: string;
+        NETWORK_STATUS_CHANGED: string;
+        ON_SAFE_AREA_INSETS_UPDATED: string;
+        ON_TRANSITION_COMMITTED: string;
+        ON_TRANSITION_CANCELLED: string;
+        ON_TRANSITION_TIMEOUT: string;
+        ON_SCREEN_SECURE_SET: string;
+        ON_SCREEN_SECURE_STATUS: string;
+        ON_SCREEN_SECURE_ERROR: string;
+        ON_WEB_DATA_CLEARED: string;
+        ON_WEB_DATA_CLEAR_ERROR: string;
+        ON_AI_READY: string;
+        ON_AI_TOKEN: string;
+        ON_AI_DONE: string;
+        ON_AI_ERROR: string;
+        ON_AI_PROGRESS: string;
+        ON_AI_LOG: string;
+        CATALYST_PERF_EVENT: string;
+    };
+    INTERFACE_CATEGORIES: {
+        CAMERA: {
+            commands: string[];
+            callbacks: string[];
+        };
+        FILE: {
+            commands: string[];
+            callbacks: string[];
+        };
+        INTENT: {
+            commands: string[];
+            callbacks: string[];
+        };
+        HAPTIC: {
+            commands: string[];
+            callbacks: string[];
+        };
+        NOTIFICATION: {
+            commands: string[];
+            callbacks: string[];
+        };
+        DEVICE_INFO: {
+            commands: string[];
+            callbacks: string[];
+        };
+        AUTH: {
+            commands: string[];
+            callbacks: string[];
+        };
+        NETWORK: {
+            commands: string[];
+            callbacks: string[];
+        };
+        SECURITY: {
+            commands: string[];
+            callbacks: string[];
+        };
+        TRANSITION: {
+            commands: string[];
+            callbacks: string[];
+        };
+        AI: {
+            commands: string[];
+            callbacks: string[];
+        };
+    };
+    ALL_COMMANDS: string[];
+    ALL_CALLBACKS: string[];
+    ALL_INTERFACES: string[];
+    PERMISSION_STATUS: {
+        GRANTED: string;
+        DENIED: string;
+        NOT_DETERMINED: string;
+        RESTRICTED: string;
+    };
+    HAPTIC_FEEDBACK_TYPES: {
+        VIRTUAL_KEY: string;
+        LONG_PRESS: string;
+        DEFAULT: string;
+        LIGHT: string;
+        MEDIUM: string;
+        HEAVY: string;
+    };
+    FILE_PICKER_STATES: {
+        OPENING: string;
+        PROCESSING: string;
+        IDLE: any;
+    };
+    INTENT_STATES: {
+        PROCESSING: string;
+        DOWNLOADING: string;
+        OPENING: string;
+        IDLE: any;
+    };
+    CAMERA_QUALITY: {
+        HIGH: string;
+        MEDIUM: string;
+        LOW: string;
+    };
+    CAMERA_FORMAT: {
+        JPEG: string;
+        PNG: string;
+    };
+    CAMERA_DEVICE: {
+        FRONT: string;
+        REAR: string;
+        BACK: string;
+    };
+    CAMERA_FLASH_MODE: {
+        AUTO: string;
+        ON: string;
+        OFF: string;
+    };
+    TRANSPORT_TYPES: {
+        BASE64: string;
+        FILE_URL: string;
+        FRAMEWORK_SERVER: string;
+    };
+    CAMERA_SOURCE: {
+        CAMERA: string;
+        FILE_PICKER: string;
+    };
+    RESPONSE_STATUS: {
+        SUCCESS: string;
+        ERROR: string;
+        CANCELLED: string;
+    };
+    isValidCommand: typeof isValidCommand;
+    isValidCallback: typeof isValidCallback;
+    isValidInterface: typeof isValidInterface;
+    getInterfacesByCategory: typeof getInterfacesByCategory;
+    debugInterfaces: typeof debugInterfaces;
+};
+export default _default;

package/dist/native/bridge/errors.d.ts

@@ -0,0 +1,67 @@
+import type { CatalystError } from "../../errors/index.js";
+export declare const ERROR_CODES: {
+    PERMISSION_DENIED: any;
+    PERMISSION_REQUIRED: any;
+    NETWORK_UNAVAILABLE: any;
+    DOWNLOAD_FAILED: any;
+    FILE_NOT_FOUND: any;
+    FILE_TOO_LARGE: any;
+    STORAGE_FULL: any;
+    FILE_CORRUPTED: any;
+    OPERATION_CANCELLED: any;
+    NO_FILE_SELECTED: any;
+    INVALID_FILE_TYPE: any;
+    INVALID_PARAMETERS: any;
+    BRIDGE_UNAVAILABLE: any;
+    FEATURE_UNSUPPORTED: any;
+    INTERNAL_ERROR: any;
+    CAMERA_UNAVAILABLE: any;
+    CAMERA_IN_USE: any;
+};
+/** One of the {@link ERROR_CODES} values — a shared `RUNTIME-NATIVE-xxx` code. */
+export type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+/**
+ * Broad grouping an error code belongs to.
+ *
+ * Categories are owned by the shared registry (`../../errors/registry.js`) and
+ * are the code's prefix — every code this module aliases is `"RUNTIME-NATIVE"`.
+ * `"UNKNOWN"` is what the registry substitutes for a code it does not own.
+ */
+export type ErrorCategory = string;
+/**
+ * The error object every hook reports through its `error` key.
+ *
+ * Now an alias of the shared {@link CatalystError} (a real `Error` subclass)
+ * rather than a plain object literal: the shared error system owns the shape.
+ * Compared with the pre-merge local shape, `message`/`details`/`code` survive,
+ * `category` is a registry category string, `action` is now `suggestedAction`,
+ * `nativeError` is now the standard `cause`, and `recoverable`/`timestamp` are
+ * gone — the registry does not track recoverability, and verbose/debug
+ * formatting stamps its own timestamp at print time.
+ *
+ * Two hooks predate this contract and still report a plain string: `error` on
+ * `useDeviceInfo` and `useNetworkStatus` stays a string until 2.0.
+ */
+export type StandardError = CatalystError;
+/**
+ * Create a standardized error object (CatalystError instance) for a
+ * RUNTIME-NATIVE-xxx code, with the native error attached as `cause`.
+ *
+ * @param code - Error code from ERROR_CODES
+ * @param userMessage - Custom user-friendly message (optional)
+ * @param nativeError - Original native error for debugging
+ * @param customDetails - Custom details (optional)
+ * @returns Standardized error object
+ */
+export declare const createStandardError: (code: ErrorCode, userMessage?: string | null, nativeError?: any, customDetails?: string | null) => StandardError;
+/**
+ * Translate native error to standardized error
+ * @param nativeError - Native error from Android/iOS
+ * @returns Standardized error object
+ */
+export declare const translateError: (nativeError: any) => StandardError;
+/**
+ * Check if development mode is enabled
+ * @returns True if in development mode
+ */
+export declare const isDevelopment: () => boolean;