@trulioo/docv-capture-web 2.14.0 → 2.14.2

package/README.md

@@ -60,12 +60,18 @@ documentCamera.renderCamera("parent-element-id", cameraProps).then((_) => {
 })
 ```
 
-To remove/unrender the current camera on the screen, call the `removeCamera` function.
+To remove the current camera on the screen, call the `removeCamera` function.
 
 ```javascript showLineNumbers
 documentCamera.removeCamera()
 ```
 
+Additionally, if we want to resume the camera feed again after a successful auto or manual capture, we can call the `resumeCamera` function.
+
+```javascript showLineNumbers
+documentCamera.resumeCamera()
+```
+
 ### Starting the document capture flow
 
 
@@ -77,7 +83,7 @@ currently active/rendered camera component. The promise will only resolve when t
 
 ```javascript showLineNumbers
 truliooCapture.startFeedback(documentCamera.id).then((result: TruliooCaptureResponse) => {
-    console.log(`Succesfully captured a good image: ${result}`)
+    console.log(`Succesfully captured a good image with imageId: ${result.imageId}`)
 })
 ```
 
@@ -87,7 +93,32 @@ We can also stop the feedback by calling the `stopFeedback` function. This will
 truliooCapture.stopFeedback(documentCamera.id)
 
 ```
+Note that if the `stopFeedback` function is called during an ongoing `startFeedback` promise, the `startFeedback` promise is expected to be rejected with the specific `FeedbackStopped` error.
+It is recommended to check this specific error to make sure it is not treated as an unexpected error.
 
+```javascript showLineNumbers
+import { HandledError } from '@trulioo/docv-capture-web'
+
+truliooCapture.startFeedback(documentCamera.id).then((result: TruliooCaptureResponse) => {
+    console.log(`Succesfully captured a good image with imageId: ${result.imageId}`)
+}).catch((error: unknown) => {
+    if (error == HandledError.FeedbackStopped) {
+        console.log("startFeedback is stopped.")
+    } else {
+        // Other error handling
+    }
+})
+```
+
+Additionally, if we want to do a manual capture instead. We can call the `captureLatestFrame` function. This will return a `TruliooManualCaptureResponse` that is similar to the `TruliooCaptureResponse` excluding the auto capture specific fields.
+Note that we would want to make sure the camera feed is currently running before triggering the manual capture, hence we can resume the camera again after a successful auto or manual capture using the `resumeCamera` function if we want to trigger another capture.
+
+```javascript showLineNumbers
+truliooCapture.captureLatestFrame(documentCamera.id).then((result: TruliooManualCaptureResponse) => {
+    console.log(`Succesfully captured an image with manual capture with imageId: ${result.imageId}`)
+})
+
+```
 
 The SDK also provides the `onFeedbackState` function that we can listen to for the ongoing capture state updates that is started by the `startFeedback` function.
 This allows us to add any logic needed or render any necessary custom UI needed based on the current capture state.
@@ -122,7 +153,7 @@ Note that the above flow is the same for the selfie capture type too.
 ### Analysing the captured image result through post capture verify feedback
 
 
-Once we have the resulting `TruliooCaptureResponse` image data, we are able to get a post capture feedback by simply calling the `verifyImage` function that is
+Once we have the resulting `TruliooCaptureResponse` or `TruliooManualCaptureResponse` image data, we are able to get a post capture feedback by simply calling the `verifyImage` function that is
 part of the response data. This will give use more information regarding the captured image and let us decide whether we should submit the captured image for
 verification by calling the `acceptImage` function.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trulioo/docv-capture-web",
-  "version": "2.14.0",
+  "version": "2.14.2",
   "main": "trulioo-docv-capture-web.js",
   "types": "trulioo-docv-capture-web.d.ts",
   "devDependencies": {
@@ -15,10 +15,10 @@
     "@connectrpc/connect": "1.4.0",
     "@connectrpc/connect-web": "1.4.0",
     "@bufbuild/protobuf": "1.10.0",
-    "format-util": "^1.0.5",
     "node-fetch": "2.6.7",
     "abort-controller": "3.0.0",
     "ws": "8.5.0",
+    "format-util": "^1.0.5",
     "@js-joda/core": "3.2.0"
   },
   "dependencies": {},

package/trulioo-docv-capture-web.d.ts

@@ -40,6 +40,38 @@ export declare namespace com.trulioo.docv.core.workflow {
         equals(other: Nullable<any>): boolean;
     }
 }
+export declare class TruliooError extends Error {
+    constructor(code?: number, message?: string);
+    get code(): number;
+}
+export declare abstract class NetworkError extends TruliooError {
+    protected constructor();
+    get code(): number;
+    static get NoInternet(): {
+        get code(): number;
+        toString(): string;
+        hashCode(): number;
+        equals(other: Nullable<any>): boolean;
+    } & NetworkError;
+}
+export declare class ConfigurationError extends TruliooError {
+    constructor(message: string);
+    get code(): number;
+}
+export declare abstract class HandledError extends TruliooError {
+    protected constructor();
+    get code(): number;
+    static get FeedbackStopped(): {
+        get code(): number;
+        toString(): string;
+        hashCode(): number;
+        equals(other: Nullable<any>): boolean;
+    } & HandledError;
+}
+export declare class GenericError extends TruliooError {
+    constructor(message: string);
+    get code(): number;
+}
 export declare interface TruliooCameraConfig {
     readonly detectionType: DetectionType;
     readonly __doNotUseOrImplementIt: {
@@ -69,30 +101,49 @@ export declare abstract class DetectionType {
     get name(): "DOCUMENT" | "PASSPORT" | "BIOMETRIC_SELFIE" | "NO_DETECTION";
     get ordinal(): 0 | 1 | 2 | 3;
 }
+export declare interface CaptureResponse {
+    readonly imageId: string;
+    readonly acceptImage: () => Promise<boolean>;
+    readonly verifyImage: () => Promise<TruliooVerifyFeedback>;
+    readonly __doNotUseOrImplementIt: {
+        readonly CaptureResponse: unique symbol;
+    };
+}
 export declare interface TruliooImageFeedback {
     readonly imageId: string;
     readonly detectionType: DetectionType;
     readonly hasAcceptableQuality: boolean;
     readonly hasBlur: boolean;
     readonly hasDetection: boolean;
+    readonly requiresBackCapture: boolean;
+    readonly tooClose: boolean;
+    readonly tooFar: boolean;
     readonly __doNotUseOrImplementIt: {
         readonly TruliooImageFeedback: unique symbol;
     };
 }
-export declare interface TruliooCaptureResponse extends TruliooImageFeedback {
+export declare interface TruliooCaptureResponse extends CaptureResponse, TruliooImageFeedback {
+    readonly imageId: string;
     readonly acceptImage: () => Promise<boolean>;
-    readonly requiresBackCapture: boolean;
-    readonly tooClose: boolean;
-    readonly tooFar: boolean;
     readonly verifyImage: () => Promise<TruliooVerifyFeedback>;
-    readonly imageId: string;
     readonly detectionType: DetectionType;
     readonly hasAcceptableQuality: boolean;
     readonly hasBlur: boolean;
     readonly hasDetection: boolean;
+    readonly requiresBackCapture: boolean;
+    readonly tooClose: boolean;
+    readonly tooFar: boolean;
     readonly __doNotUseOrImplementIt: {
         readonly TruliooCaptureResponse: unique symbol;
-    } & TruliooImageFeedback["__doNotUseOrImplementIt"];
+    } & CaptureResponse["__doNotUseOrImplementIt"] & TruliooImageFeedback["__doNotUseOrImplementIt"];
+}
+export declare interface TruliooManualCaptureResponse extends CaptureResponse {
+    readonly imageId: string;
+    readonly acceptImage: () => Promise<boolean>;
+    readonly verifyImage: () => Promise<TruliooVerifyFeedback>;
+    readonly __doNotUseOrImplementIt: {
+        readonly TruliooManualCaptureResponse: unique symbol;
+    } & CaptureResponse["__doNotUseOrImplementIt"];
 }
 export declare interface TruliooVerifyFeedback {
     readonly isVerifyAttemptAvailable: boolean;
@@ -216,6 +267,7 @@ export declare class TruliooCamera /* extends capture.Camera */ {
     get detectionType(): DetectionType;
     removeCamera(): void;
     renderCamera(parentElementId: string, cameraProps?: Nullable<CameraProps>): Promise<boolean>;
+    resumeCamera(): void;
 }
 export declare class CameraProps {
     constructor(onCaptureRegionChange: Nullable<(p0: CaptureRegion) => void>);
@@ -248,7 +300,8 @@ export declare class TruliooCapture {
     startFeedback(cameraId: string, imageFeedback?: Nullable<(p0: TruliooImageFeedback) => void>): Promise<TruliooCaptureResponse>;
     stopFeedback(cameraId: string): Promise<boolean>;
     onFeedbackState(feedback: (p0: TruliooFeedbackState) => void): void;
-    captureLatestFrame(): Promise<TruliooCaptureResponse>;
+    captureLatestFrame(cameraId: string): Promise<TruliooManualCaptureResponse>;
     submitTransaction(): Promise<boolean>;
+    static stopOngoingCaptureProcess$default($this: TruliooCapture, cameraController: any/* capture.CameraController */, isManual?: boolean): void;
 }
 export as namespace trulioo_docv_capture_web;