scandit-datacapture-frameworks-core 7.6.1 → 8.0.0-beta.1

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

@@ -11,11 +11,14 @@ export declare class Camera extends DefaultSerializeable implements FrameSource
     private position;
     private _desiredTorchState;
     private _desiredState;
+    private currentCameraState;
     private listeners;
     private _context;
+    private static readonly _cameraInstances;
     private static get coreDefaults();
     private set context(value);
     private get context();
+    private get isActiveCamera();
     private controller;
     static get default(): Camera | null;
     static withSettings(settings: CameraSettings): Camera | null;
@@ -25,13 +28,10 @@ export declare class Camera extends DefaultSerializeable implements FrameSource
     set desiredTorchState(desiredTorchState: TorchState);
     get desiredTorchState(): TorchState;
     private constructor();
+    static create(position?: CameraPosition, settings?: CameraSettings | null, desiredTorchState?: TorchState, desiredState?: FrameSourceState): Camera | null;
     switchToDesiredState(state: FrameSourceState): Promise<void>;
     getCurrentState(): Promise<FrameSourceState>;
     getIsTorchAvailable(): Promise<boolean>;
-    /**
-     * @deprecated
-     */
-    get isTorchAvailable(): boolean;
     addListener(listener: FrameSourceListener | null): void;
     removeListener(listener: FrameSourceListener | null): void;
     applySettings(settings: CameraSettings): Promise<void>;
@@ -41,10 +41,12 @@ export interface PrivateCamera {
     context: DataCaptureContext | null;
     position: CameraPosition;
     _desiredState: FrameSourceState;
+    currentCameraState: FrameSourceState;
     desiredTorchState: TorchState;
-    settings: CameraSettings;
+    settings: CameraSettings | null;
     listeners: FrameSourceListener[];
     controller: CameraController;
+    get isActiveCamera(): boolean;
     initialize: () => void;
     didChange: () => Promise<void>;
 }

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

@@ -14,7 +14,7 @@ export interface CameraProxy {
     $isTorchAvailable({ position }: {
         position: CameraPosition;
     }): Promise<NativeCallResult>;
-    $registerListenerForCameraEvents(): void;
+    $registerListenerForCameraEvents(): Promise<void>;
     $unregisterListenerForCameraEvents(): Promise<void>;
     $getFrame({ frameId }: {
         frameId: string;
@@ -27,16 +27,16 @@ export interface CameraProxy {
 export declare class CameraController extends BaseNewController<CameraProxy> {
     private camera;
     private static get _proxy();
-    static forCamera(camera: Camera): CameraController;
-    private constructor();
+    constructor(camera: Camera);
     private get privateCamera();
     static getFrame(frameId: string): Promise<FrameData>;
     static getFrameOrNull(frameId: string): Promise<FrameData | null>;
     getCurrentState(): Promise<FrameSourceState>;
     getIsTorchAvailable(): Promise<boolean>;
     switchCameraToDesiredState(desiredState: FrameSourceState): Promise<void>;
-    subscribeListener(): void;
-    unsubscribeListener(): void;
+    subscribeListener(): Promise<void>;
+    unsubscribeListener(): Promise<void>;
     dispose(): void;
     private handleDidChangeStateEvent;
+    private handleDidChangeStateEventWrapper;
 }

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

@@ -1,4 +1,5 @@
 export declare enum VideoResolution {
+    /** @deprecated Auto is deprecated. Please use the capture mode's recommendedCameraSettings for the best results. */
     Auto = "auto",
     HD = "hd",
     FullHD = "fullHd",

package/dist/dts/camerahelpers/CameraOwner.d.ts

@@ -0,0 +1,3 @@
+export interface CameraOwner {
+    readonly id: string;
+}

package/dist/dts/camerahelpers/CameraOwnershipHelper.d.ts

@@ -0,0 +1,42 @@
+import { Camera } from "../camera/Camera";
+import { CameraPosition } from "./CameraPosition";
+import { CameraOwner } from "./CameraOwner";
+export declare class CameraOwnershipHelper {
+    private static ownershipManager;
+    /**
+     * Get camera instance for the owner (only works if you own it)
+     */
+    static getCamera(position: CameraPosition, owner: CameraOwner): Camera | null;
+    /**
+     * Safely execute camera operations (only works if you own the camera)
+     */
+    static withCamera<T>(position: CameraPosition, owner: CameraOwner, operation: (camera: Camera) => Promise<T> | T): Promise<T | null>;
+    /**
+     * Execute camera operations, waiting for ownership if necessary
+     */
+    static withCameraWhenAvailable<T>(position: CameraPosition, owner: CameraOwner, operation: (camera: Camera) => Promise<T> | T, timeoutMs?: number): Promise<T | null>;
+    /**
+     * Request ownership and wait if necessary
+     */
+    static requestOwnership(position: CameraPosition, owner: CameraOwner, timeoutMs?: number): Promise<boolean>;
+    /**
+     * Release ownership
+     */
+    static releaseOwnership(position: CameraPosition, owner: CameraOwner): boolean;
+    /**
+     * Check if owner has ownership
+     */
+    static hasOwnership(position: CameraPosition, owner: CameraOwner): boolean;
+    /**
+     * Get the camera position currently owned by the owner (if any)
+     */
+    static getOwnedPosition(owner: CameraOwner): CameraPosition | null;
+    /**
+     * Get all camera positions currently owned by the owner
+     */
+    static getAllOwnedPositions(owner: CameraOwner): CameraPosition[];
+    /**
+     * Release ownership of all cameras owned by the owner
+     */
+    static releaseAllOwnerships(owner: CameraOwner): void;
+}

package/dist/dts/camerahelpers/CameraOwnershipManager.d.ts

@@ -0,0 +1,24 @@
+import { CameraPosition } from "./CameraPosition";
+import { CameraOwner } from "./CameraOwner";
+export declare class CameraOwnershipManager {
+    private static instance;
+    private readonly owners;
+    private readonly waitingQueue;
+    private readonly protectedCameras;
+    private constructor();
+    static getInstance(): CameraOwnershipManager;
+    requestOwnership(position: CameraPosition, owner: CameraOwner): boolean;
+    requestOwnershipAsync(position: CameraPosition, owner: CameraOwner, timeoutMs?: number): Promise<boolean>;
+    releaseOwnership(position: CameraPosition, owner: CameraOwner): boolean;
+    isOwner(position: CameraPosition, owner: CameraOwner): boolean;
+    getCurrentOwner(position: CameraPosition): CameraOwner | null;
+    checkOwnership(position: CameraPosition, owner: CameraOwner): boolean;
+    getOwnedPosition(owner: CameraOwner): CameraPosition | null;
+    getAllOwnedPositions(owner: CameraOwner): CameraPosition[];
+    private enableProtectionForOwner;
+    private disableProtectionForPosition;
+    private processWaitingQueue;
+    private removeFromQueue;
+    private protectCameraForOwner;
+    private unprotectCamera;
+}

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

@@ -1,2 +1,5 @@
 export * from "./CameraPosition";
 export * from "./FrameSourceListenerEvents";
+export * from "./CameraOwner";
+export * from "./CameraOwnershipManager";
+export * from "./CameraOwnershipHelper";

package/dist/dts/common/Payload.d.ts

@@ -1,3 +1,4 @@
+import { CameraPosition } from "../camerahelpers/CameraPosition";
 import { FrameSourceState } from "../frame/FrameSourceState";
 import { SizeJSON } from "./Size";
 export interface DidChangeSizeEventPayload {
@@ -23,4 +24,5 @@ export interface NativeCallResult {
 }
 export interface FrameSourceDidChangeStateEventPayload {
     state: FrameSourceState;
+    cameraPosition: CameraPosition;
 }

package/dist/dts/context/DataCaptureContext.d.ts

@@ -24,10 +24,6 @@ export declare class DataCaptureContext extends DefaultSerializeable {
     private static get coreDefaults();
     get frameSource(): FrameSource | null;
     static get deviceID(): string | null;
-    /**
-     * @deprecated
-     */
-    get deviceID(): string | null;
     static forLicenseKey(licenseKey: string): DataCaptureContext;
     static forLicenseKeyWithSettings(licenseKey: string, settings: DataCaptureContextSettings | null): DataCaptureContext;
     static forLicenseKeyWithOptions(licenseKey: string, options: DataCaptureContextCreationOptions | null): DataCaptureContext;

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

@@ -1,10 +1,10 @@
 import { DefaultSerializeable } from "../serializable";
-import { CameraPosition } from "../camerahelpers";
 import { DataCaptureContext } from "../context";
 import { FrameSourceListener } from "./FrameSourceListener";
 import { FrameSourceState } from "./FrameSourceState";
 import { FrameSource } from "./FrameSource";
 import { ImageFrameSourceController } from "./ImageFrameSourceController";
+import { CameraPosition } from "../camerahelpers/CameraPosition";
 export interface ImageFrameSourceJSON {
     image: string;
 }

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

@@ -1,22 +1,32 @@
+import EventEmitter from "eventemitter3";
 import { FrameSourceState } from "./FrameSourceState";
 import { ImageFrameSource } from "./ImageFrameSource";
-import { CameraPosition } from "../camerahelpers";
+import { CameraPosition } from "../camerahelpers/CameraPosition";
 import { NativeCallResult } from "../common";
+import { BaseNewController } from "../controllers/BaseNewController";
 export interface ImageFrameSourceProxy {
-    getCurrentCameraState(position: CameraPosition): Promise<NativeCallResult>;
-    switchCameraToDesiredState(desiredStateJson: string): Promise<void>;
-    registerListenerForEvents(): void;
-    unregisterListenerForEvents(): void;
-    subscribeDidChangeState?(): void;
+    $getCurrentCameraState({ position }: {
+        position: CameraPosition;
+    }): Promise<NativeCallResult>;
+    $switchCameraToDesiredState({ desiredStateJson }: {
+        desiredStateJson: string;
+    }): Promise<void>;
+    $registerListenerForCameraEvents(): Promise<void>;
+    $unregisterListenerForCameraEvents(): Promise<void>;
+    subscribeForEvents(events: string[]): void;
+    unsubscribeFromEvents(events: string[]): void;
+    dispose(): void;
+    eventEmitter: EventEmitter;
 }
-export declare class ImageFrameSourceController {
+export declare class ImageFrameSourceController extends BaseNewController<ImageFrameSourceProxy> {
     private imageFrameSource;
-    private eventEmitter;
-    private _proxy;
-    static forImage(imageFrameSource: ImageFrameSource): ImageFrameSourceController;
-    private constructor();
+    constructor(imageFrameSource: ImageFrameSource);
+    private get privateImageFrameSource();
     getCurrentState(): Promise<FrameSourceState>;
     switchCameraToDesiredState(desiredStateJson: string): Promise<void>;
-    subscribeListener(): void;
-    unsubscribeListener(): void;
+    subscribeListener(): Promise<void>;
+    unsubscribeListener(): Promise<void>;
+    dispose(): void;
+    private handleDidChangeStateEvent;
+    private handleDidChangeStateEventWrapper;
 }

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

@@ -48,8 +48,8 @@ export declare class BaseDataCaptureView extends DefaultSerializeable {
     private get privateContext();
     static forContext(context: DataCaptureContext | null): BaseDataCaptureView;
     constructor(context: DataCaptureContext | null);
-    addOverlay(overlay: DataCaptureOverlay): void;
-    removeOverlay(overlay: DataCaptureOverlay): void;
+    addOverlay(overlay: DataCaptureOverlay): Promise<void>;
+    removeOverlay(overlay: DataCaptureOverlay): Promise<void>;
     removeAllOverlays(): void;
     addListener(listener: DataCaptureViewListener): void;
     removeListener(listener: DataCaptureViewListener): void;

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

@@ -4,4 +4,4 @@ export * from "./DataCaptureOverlay";
 export * from "./DataCaptureViewListener";
 export * from "./DataCaptureView";
 export * from "./DataCaptureViewController";
-export * from "./ScreenStateManager";
+export * from "../camerahelpers/CameraOwner";