scandit-datacapture-frameworks-core 8.1.1 → 8.2.0

package/__mocks__/ScanditDataCaptureCore.ts

@@ -105,7 +105,14 @@ export class MockCaller implements NativeCaller {
   }
 
   async registerEvent(evName: string, handler: (args: any) => Promise<void>): Promise<any> {
-    return this.emitter.addListener(evName, handler);
+    // Wrap handler to catch and log errors
+    const wrappedHandler = (event: any) => {
+      const promise = handler(event);
+      promise.catch((error) => {
+        console.error(`Error in event handler for '${evName}':`, error);
+      });
+    };
+    return this.emitter.addListener(evName, wrappedHandler);
   }
 
   async unregisterEvent(evName: string, subscription: any): Promise<void> {

package/dist/dts/camera/Camera.d.ts

@@ -1,7 +1,7 @@
 import { DataCaptureContext } from "../context";
 import { FrameSource, FrameSourceListener, FrameSourceState } from "../frame";
 import { DefaultSerializeable } from "../serializable";
-import { CameraController } from "./CameraController";
+import { CameraController } from "./controller/CameraController";
 import { TorchState } from "./TorchState";
 import { CameraPosition } from "../camerahelpers/CameraPosition";
 import { CameraSettings } from "./CameraSettings";

package/dist/dts/camera/controller/CameraController.d.ts

@@ -0,0 +1,18 @@
+import { Camera } from "../Camera";
+import { FrameSourceState } from "../../frame";
+import { BaseController } from "../../controllers/BaseController";
+import { CoreProxy } from "../../generated";
+export declare class CameraController extends BaseController<CoreProxy> {
+    private camera;
+    private adapter;
+    constructor(camera: Camera);
+    private get privateCamera();
+    getCurrentState(): Promise<FrameSourceState>;
+    getIsTorchAvailable(): Promise<boolean>;
+    switchCameraToDesiredState(desiredState: FrameSourceState): Promise<void>;
+    subscribeListener(): Promise<void>;
+    unsubscribeListener(): Promise<void>;
+    dispose(): void;
+    private handleDidChangeStateEvent;
+    private handleDidChangeStateEventWrapper;
+}

package/dist/dts/camera/controller/FrameDataController.d.ts

@@ -0,0 +1,9 @@
+import { BaseController } from '../../controllers/BaseController';
+import { FrameData } from '../../frame';
+import { CoreProxy } from '../../generated';
+export declare class FrameDataController extends BaseController<CoreProxy> {
+    private adapter;
+    constructor();
+    getFrame(frameId: string): Promise<FrameData>;
+    getFrameOrNull(frameId: string): Promise<FrameData | null>;
+}

package/dist/dts/camera/index.d.ts

@@ -2,7 +2,8 @@ export * from "./FocusGesture";
 export * from "./TapToFocus";
 export * from "./PrivateFocusGestureDeserializer";
 export * from "./ZoomGesture";
-export * from "./CameraController";
+export * from "./controller/CameraController";
+export * from "./controller/FrameDataController";
 export * from "./Camera";
 export * from "./ZoomSwitchControl";
 export * from "./TorchSwitchControl";

package/dist/dts/context/controller/DataCaptureContextController.d.ts

@@ -1,33 +1,11 @@
 import { DataCaptureContext } from '../DataCaptureContext';
 import { DataCaptureMode } from '../DataCaptureMode';
 import { OpenSourceSoftwareLicenseInfo } from '../OpenSourceSoftwareLicenseInfo';
-import { NativeCallResult } from '../../common';
 import { BaseController } from '../../controllers/BaseController';
-import { BaseProxy } from '../../proxies/BaseProxy';
-export interface DataCaptureContextProxy extends BaseProxy {
+import { CoreProxy } from '../../generated';
+export interface DataCaptureContextProxy extends CoreProxy {
     get framework(): string;
     get frameworkVersion(): string;
-    $contextFromJSON({ contextJson }: {
-        contextJson: string;
-    }): Promise<NativeCallResult>;
-    $updateContextFromJSON({ contextJson }: {
-        contextJson: string;
-    }): Promise<void>;
-    /**
-     * Subscribe to context events with persistent listener.
-     * Uses `$$` prefix for automatic Cordova event registration detection.
-     */
-    $$subscribeContextListener(): Promise<void>;
-    $unsubscribeContextListener(): Promise<void>;
-    $addModeToContext({ modeJson }: {
-        modeJson: string;
-    }): Promise<void>;
-    $removeModeFromContext({ modeJson }: {
-        modeJson: string;
-    }): Promise<void>;
-    $removeAllModes(): Promise<void>;
-    $getOpenSourceSoftwareLicenseInfo(): Promise<NativeCallResult>;
-    $disposeContext(): Promise<void>;
 }
 export declare enum DataCaptureContextEvents {
     didChangeStatus = "DataCaptureContextListener.onStatusChanged",
@@ -36,6 +14,7 @@ export declare enum DataCaptureContextEvents {
 export declare class DataCaptureContextController extends BaseController<DataCaptureContextProxy> {
     private context;
     private _listenerRegistered;
+    private adapter;
     get framework(): string;
     get frameworkVersion(): string;
     private get privateContext();

package/dist/dts/defaults/index.d.ts

@@ -1,2 +1,3 @@
 export { CoreDefaults } from "./CoreDefaults";
 export { getCoreDefaults } from "./getCoreDefaults";
+export { setCoreDefaultsLoader, ensureCoreDefaults } from "./loadCoreDefaults";

package/dist/dts/defaults/loadCoreDefaults.d.ts

@@ -1 +1,4 @@
+import { CoreDefaults } from "./CoreDefaults";
+export declare function setCoreDefaultsLoader(loader: () => void): void;
+export declare function ensureCoreDefaults(): CoreDefaults;
 export declare function loadCoreDefaults(jsonDefaults: unknown): void;

package/dist/dts/feedback/FeedbackController.d.ts

@@ -1,13 +1,9 @@
 import { BaseController } from '../controllers/BaseController';
 import { Feedback } from './Feedback';
-import { BaseProxy } from '../proxies/BaseProxy';
-export interface FeedbackProxy extends BaseProxy {
-    $emitFeedback(args: {
-        feedbackJson: string;
-    }): Promise<void>;
-}
-export declare class FeedbackController extends BaseController<FeedbackProxy> {
+import { CoreProxy } from '../generated';
+export declare class FeedbackController extends BaseController<CoreProxy> {
     private feedback;
+    private adapter;
     static forFeedback(feedback: Feedback): FeedbackController;
     constructor(feedback: Feedback);
     emit(): void;

package/dist/dts/feedback/index.d.ts

@@ -2,7 +2,6 @@ export { Vibration, WaveFormVibration } from "./Vibration";
 export { VibrationType } from "./VibrationType";
 export { Sound } from "./Sound";
 export { Feedback } from "./Feedback";
-export { FeedbackProxy } from "./FeedbackController";
 export { VibrationJSON, PrivateVibration } from "./Vibration";
 export { SoundJSON, PrivateSound } from "./Sound";
 export { FeedbackJSON, PrivateFeedback } from "./Feedback";

package/dist/dts/frame/ImageFrameSourceController.d.ts

@@ -1,21 +1,10 @@
-import { FrameSourceState } from "./FrameSourceState";
-import { ImageFrameSource } from "./ImageFrameSource";
-import { CameraPosition } from "../camerahelpers/CameraPosition";
-import { NativeCallResult } from "../common";
-import { BaseController } from "../controllers/BaseController";
-import { BaseProxy } from "../proxies";
-export interface ImageFrameSourceProxy extends BaseProxy {
-    $getCurrentCameraState({ position }: {
-        position: CameraPosition;
-    }): Promise<NativeCallResult>;
-    $switchCameraToDesiredState({ desiredStateJson }: {
-        desiredStateJson: string;
-    }): Promise<void>;
-    $$registerListenerForCameraEvents(): Promise<void>;
-    $unregisterListenerForCameraEvents(): Promise<void>;
-}
-export declare class ImageFrameSourceController extends BaseController<ImageFrameSourceProxy> {
+import { FrameSourceState } from './FrameSourceState';
+import { ImageFrameSource } from './ImageFrameSource';
+import { BaseController } from '../controllers/BaseController';
+import { CoreProxy } from '../generated';
+export declare class ImageFrameSourceController extends BaseController<CoreProxy> {
     private imageFrameSource;
+    private adapter;
     constructor(imageFrameSource: ImageFrameSource);
     private get privateImageFrameSource();
     getCurrentState(): Promise<FrameSourceState>;

package/dist/dts/frame/index.d.ts

@@ -6,6 +6,5 @@ export { ImageBuffer } from "./ImageBuffer";
 export { FrameDataSettings } from "./FrameDataSettings";
 export { FrameDataSettingsBuilder } from "./FrameDataSettingsBuilder";
 export { ImageFrameSource } from "./ImageFrameSource";
-export { ImageFrameSourceProxy, } from "./ImageFrameSourceController";
 export { PrivateImageBuffer, ImageBufferJSON } from "./ImageBuffer";
 export { PrivateFrameData, FrameDataJSON } from "./FrameData";

package/dist/dts/generated/CoreProxy.d.ts

@@ -0,0 +1,30 @@
+import { BaseProxy } from '../proxies/BaseProxy';
+/**
+ * The datacapture core module
+ * Generated from schema definition.
+ *
+ * Single entry point interface - all operations go through $executeCore.
+ * The CoreController handles method-specific logic and calls this proxy.
+ * The NativeProxy automatically handles the `$` prefix for native method calls.
+ */
+export interface CoreProxy extends BaseProxy {
+    /**
+     * Single entry point for all Core operations.
+     * Routes to appropriate native command based on moduleName and methodName.
+     *
+     * @param params Object containing:
+     *   - moduleName: The name of the module to execute against
+     *   - methodName: The name of the method to execute
+     *   - ...other parameters specific to the method
+     *
+     * @returns Promise resolving to the result (type depends on methodName)
+     *
+     * Note: This method is called with the `$` prefix ($executeCore) which is
+     * automatically handled by NativeProxy to route to native implementation.
+     */
+    $executeCore(params: {
+        moduleName: string;
+        methodName: string;
+        [key: string]: any;
+    }): Promise<any>;
+}

package/dist/dts/generated/CoreProxyAdapter.d.ts

@@ -0,0 +1,148 @@
+import { CoreProxy } from './CoreProxy';
+import { FrameSourceState } from '../frame';
+/**
+ * Adapter class for Core operations.
+ * Provides typed methods that internally call $executeCore.
+ * Generated from schema definition to ensure parameter and method name consistency.
+ */
+export declare class CoreProxyAdapter {
+    private proxy;
+    constructor(proxy: CoreProxy);
+    /**
+     * Gets the camera state for a given position
+     * @param cameraPosition Camera position as JSON string
+     */
+    getCameraState({ cameraPosition }: {
+        cameraPosition: string;
+    }): Promise<FrameSourceState>;
+    /**
+     * Switches the camera to the desired state
+     * @param stateJson Desired camera state as JSON string
+     */
+    switchCameraToDesiredState({ stateJson }: {
+        stateJson: string;
+    }): Promise<void>;
+    /**
+     * Checks if torch is available for the given camera position
+     * @param cameraPosition Camera position as JSON string
+     */
+    isTorchAvailable({ cameraPosition }: {
+        cameraPosition: string;
+    }): Promise<boolean>;
+    /**
+     * Registers a persistent listener for frame source state change events
+     */
+    registerFrameSourceListener(): Promise<void>;
+    /**
+     * Unregisters the frame source event listener
+     */
+    unregisterFrameSourceListener(): Promise<void>;
+    /**
+     * Gets the last frame data by frame ID as JSON
+     * @param frameId Unique frame identifier
+     */
+    getLastFrameAsJson({ frameId }: {
+        frameId: string;
+    }): Promise<string>;
+    /**
+     * Gets the last frame data by frame ID as JSON, or null if not found
+     * @param frameId Unique frame identifier
+     */
+    getLastFrameOrNullAsJson({ frameId }: {
+        frameId: string;
+    }): Promise<string | null>;
+    /**
+     * Creates a DataCaptureContext from JSON
+     * @param contextJson DataCaptureContext configuration as JSON string
+     */
+    createContextFromJson({ contextJson }: {
+        contextJson: string;
+    }): Promise<void>;
+    /**
+     * Updates a DataCaptureContext from JSON
+     * @param contextJson Updated DataCaptureContext configuration as JSON string
+     */
+    updateContextFromJson({ contextJson }: {
+        contextJson: string;
+    }): Promise<void>;
+    /**
+     * Subscribes to context events with persistent listener
+     */
+    subscribeContextListener(): Promise<void>;
+    /**
+     * Unsubscribes from context events
+     */
+    unsubscribeContextListener(): Promise<void>;
+    /**
+     * Adds a mode to the DataCaptureContext
+     * @param modeJson Mode configuration as JSON string
+     */
+    addModeToContext({ modeJson }: {
+        modeJson: string;
+    }): Promise<void>;
+    /**
+     * Removes a mode from the DataCaptureContext
+     * @param modeJson Mode configuration as JSON string
+     */
+    removeModeFromContext({ modeJson }: {
+        modeJson: string;
+    }): Promise<void>;
+    /**
+     * Removes all modes from the DataCaptureContext
+     */
+    removeAllModes(): Promise<void>;
+    /**
+     * Gets open source software license information
+     */
+    getOpenSourceSoftwareLicenseInfo(): Promise<string>;
+    /**
+     * Disposes the DataCaptureContext and releases resources
+     */
+    disposeContext(): Promise<void>;
+    /**
+     * Converts a point from frame coordinates to view coordinates
+     * @param viewId View identifier
+     * @param pointJson Point in frame coordinates as JSON string
+     */
+    viewPointForFramePoint({ viewId, pointJson }: {
+        viewId: number;
+        pointJson: string;
+    }): Promise<string>;
+    /**
+     * Converts a quadrilateral from frame coordinates to view coordinates
+     * @param viewId View identifier
+     * @param quadrilateralJson Quadrilateral in frame coordinates as JSON string
+     */
+    viewQuadrilateralForFrameQuadrilateral({ viewId, quadrilateralJson, }: {
+        viewId: number;
+        quadrilateralJson: string;
+    }): Promise<string>;
+    /**
+     * Registers persistent event listener for view events
+     * @param viewId View identifier
+     */
+    registerListenerForViewEvents({ viewId }: {
+        viewId: number;
+    }): Promise<void>;
+    /**
+     * Unregisters the view event listener
+     * @param viewId View identifier
+     */
+    unregisterListenerForViewEvents({ viewId }: {
+        viewId: number;
+    }): Promise<void>;
+    /**
+     * Updates the DataCaptureView configuration
+     * @param viewJson Updated view configuration as JSON string
+     */
+    updateDataCaptureView({ viewJson }: {
+        viewJson: object | string;
+    }): Promise<void>;
+    /**
+     * Emits haptic/audio feedback
+     * @param feedbackJson Feedback configuration as JSON string
+     */
+    emitFeedback({ feedbackJson }: {
+        feedbackJson: string;
+    }): Promise<void>;
+}

package/dist/dts/generated/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generated exports for Core module.
+ * Exports all generated proxy interfaces and adapters.
+ */
+export * from './CoreProxy';
+export * from './CoreProxyAdapter';

package/dist/dts/index.d.ts

@@ -19,3 +19,4 @@ export { FactoryMaker } from "./FactoryMaker";
 export * from "./proxy-types";
 export * from "./proxy-registration";
 export * from "./helpers";
+export * from "./generated";

package/dist/dts/proxy-types.d.ts

@@ -1,5 +1,5 @@
 import { NativeCallerProvider } from './proxies/ProxyRegistration';
-export declare const CORE_PROXY_TYPE_NAMES: readonly ["DataCaptureViewProxy", "DataCaptureContextProxy", "CameraProxy", "ImageFrameSourceProxy", "FeedbackProxy"];
+export declare const CORE_PROXY_TYPE_NAMES: readonly ["CoreProxy", "DataCaptureViewProxy", "DataCaptureContextProxy"];
 export type CoreProxyType = typeof CORE_PROXY_TYPE_NAMES[number];
 export interface CoreNativeCallerProvider extends NativeCallerProvider<CoreProxyType> {
 }

package/dist/dts/view/DataCaptureView.d.ts

@@ -60,6 +60,7 @@ export declare class BaseDataCaptureView extends DefaultSerializeable {
     removeControl(control: Control): void;
     controlUpdated(): Promise<void>;
     createNativeView(viewId: number): Promise<void>;
+    private notifyOverlaysOfViewIdChange;
     removeNativeView(): Promise<void>;
     dispose(): void;
     setFrame(frame: Rect, isUnderContent?: boolean): Promise<void>;

package/dist/dts/view/DataCaptureViewController.d.ts

@@ -1,33 +1,8 @@
-import { NativeCallResult, Point, Quadrilateral } from "../common";
+import { Point, Quadrilateral } from "../common";
 import { BaseDataCaptureView } from "./DataCaptureView";
 import { BaseController } from "../controllers/BaseController";
-import { BaseProxy } from "../proxies/BaseProxy";
-export interface DataCaptureViewProxy extends BaseProxy {
-    $viewPointForFramePoint({ viewId, pointJson }: {
-        viewId: number;
-        pointJson: string;
-    }): Promise<NativeCallResult>;
-    $viewQuadrilateralForFrameQuadrilateral({ viewId, quadrilateralJson }: {
-        viewId: number;
-        quadrilateralJson: string;
-    }): Promise<NativeCallResult>;
-    /**
-     * Register persistent event listener for view events.
-     * Uses `$$` prefix for automatic Cordova event registration detection.
-     */
-    $$registerListenerForViewEvents({ viewId }: {
-        viewId: number;
-    }): Promise<void>;
-    $unregisterListenerForViewEvents({ viewId }: {
-        viewId: number;
-    }): Promise<void>;
-    $setDataCaptureViewPositionAndSize({ top, left, width, height, shouldBeUnderWebView }: {
-        top: number;
-        left: number;
-        width: number;
-        height: number;
-        shouldBeUnderWebView: boolean;
-    }): Promise<void>;
+import { CoreProxy } from "../generated";
+export interface DataCaptureViewProxy extends CoreProxy {
     $showDataCaptureView({ viewId }: {
         viewId: number;
     }): Promise<void>;
@@ -37,12 +12,16 @@ export interface DataCaptureViewProxy extends BaseProxy {
     $createDataCaptureView({ viewJson }: {
         viewJson: string;
     }): Promise<void>;
-    $updateDataCaptureView({ viewJson }: {
-        viewJson: string;
-    }): Promise<void>;
     $removeDataCaptureView({ viewId }: {
         viewId: number;
     }): Promise<void>;
+    $setDataCaptureViewPositionAndSize({ top, left, width, height, shouldBeUnderWebView }: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+        shouldBeUnderWebView: boolean;
+    }): Promise<void>;
 }
 export declare enum DataCaptureViewEvents {
     didChangeSize = "DataCaptureViewListener.onSizeChanged"
@@ -50,6 +29,7 @@ export declare enum DataCaptureViewEvents {
 export declare class DataCaptureViewController extends BaseController<DataCaptureViewProxy> {
     private view;
     private _listenerRegistered;
+    private adapter;
     constructor(view: BaseDataCaptureView);
     viewPointForFramePoint(point: Point): Promise<Point>;
     viewQuadrilateralForFrameQuadrilateral(quadrilateral: Quadrilateral): Promise<Quadrilateral>;