smartcomply-web-sdk 1.0.60 → 1.0.62

package/dist/utils/constants.d.ts

@@ -37,9 +37,17 @@ export declare const LIVENESS_TIME_LIMIT_SECONDS = 12;
 /** Ideal resolution for the front-facing liveness camera. */
 export declare const CAMERA_IDEAL_WIDTH = 640;
 export declare const CAMERA_IDEAL_HEIGHT = 480;
-/** Ideal resolution for rear-facing document capture camera. */
-export declare const DOC_CAMERA_IDEAL_WIDTH = 1280;
-export declare const DOC_CAMERA_IDEAL_HEIGHT = 960;
+/**
+ * Ideal resolution for rear-facing document capture camera. Matches the
+ * document-photo compression target (see compressImage calls in
+ * DocumentCapture.ts) — requesting less here would cap captured photos
+ * below what compression is allowed to keep, which is what let camera
+ * captures come out under-resolution for face-comparison cropping even
+ * after the compression target itself was raised. `ideal` (not `exact`)
+ * constraints degrade gracefully on hardware that can't hit this.
+ */
+export declare const DOC_CAMERA_IDEAL_WIDTH = 2000;
+export declare const DOC_CAMERA_IDEAL_HEIGHT = 1500;
 /**
  * Video bitrate used by MediaRecorder for liveness recordings — raised from
  * an earlier 250k baseline for sharper frames for SmartComply's face

package/dist/utils/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wDAAwD;AACxD,eAAO,MAAM,cAAc,QAAiB,CAAC;AAE7C,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAIpD,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,6CAA6C;AAC7C,eAAO,MAAM,cAAc,OAAQ,CAAC;AAIpC,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAElD,sDAAsD;AACtD,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAElD,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,oDAAqD,CAAC;AAEvF,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAIzC,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,0EAA2E,CAAC;AAE1G;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,oBAAqB,CAAC;AAE5D,iEAAiE;AACjE,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAI9C,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,MAAO,CAAC;AACvC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAC5C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,SAAU,CAAC;AAIjD,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAIvC,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AAErD,8EAA8E;AAC9E,eAAO,MAAM,eAAe,QAAS,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wDAAwD;AACxD,eAAO,MAAM,cAAc,QAAiB,CAAC;AAE7C,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,QAAgB,CAAC;AAIpD,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B,6CAA6C;AAC7C,eAAO,MAAM,cAAc,OAAQ,CAAC;AAIpC,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAElD,sDAAsD;AACtD,eAAO,MAAM,eAAe,QAAmB,CAAC;AAEhD,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,QAAkB,CAAC;AAElD,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,oDAAqD,CAAC;AAEvF,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAIzC,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,0EAA2E,CAAC;AAE1G;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,oBAAqB,CAAC;AAE5D,iEAAiE;AACjE,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAI9C,6DAA6D;AAC7D,eAAO,MAAM,kBAAkB,MAAO,CAAC;AACvC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAC5C,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,SAAU,CAAC;AAIjD,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAIvC,2EAA2E;AAC3E,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD,mEAAmE;AACnE,eAAO,MAAM,uBAAuB,gBAAgB,CAAC;AAErD,8EAA8E;AAC9E,eAAO,MAAM,eAAe,QAAS,CAAC"}

package/dist/utils/constants.js

@@ -45,9 +45,17 @@ exports.LIVENESS_TIME_LIMIT_SECONDS = 12;
 /** Ideal resolution for the front-facing liveness camera. */
 exports.CAMERA_IDEAL_WIDTH = 640;
 exports.CAMERA_IDEAL_HEIGHT = 480;
-/** Ideal resolution for rear-facing document capture camera. */
-exports.DOC_CAMERA_IDEAL_WIDTH = 1280;
-exports.DOC_CAMERA_IDEAL_HEIGHT = 960;
+/**
+ * Ideal resolution for rear-facing document capture camera. Matches the
+ * document-photo compression target (see compressImage calls in
+ * DocumentCapture.ts) — requesting less here would cap captured photos
+ * below what compression is allowed to keep, which is what let camera
+ * captures come out under-resolution for face-comparison cropping even
+ * after the compression target itself was raised. `ideal` (not `exact`)
+ * constraints degrade gracefully on hardware that can't hit this.
+ */
+exports.DOC_CAMERA_IDEAL_WIDTH = 2000;
+exports.DOC_CAMERA_IDEAL_HEIGHT = 1500;
 /**
  * Video bitrate used by MediaRecorder for liveness recordings — raised from
  * an earlier 250k baseline for sharper frames for SmartComply's face

package/dist/utils/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,gFAAgF;AAEhF,wDAAwD;AAC3C,QAAA,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7C,yDAAyD;AAC5C,QAAA,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEpD,gFAAgF;AAEhF,+CAA+C;AAClC,QAAA,kBAAkB,GAAG,KAAM,CAAC;AAEzC,+DAA+D;AAClD,QAAA,WAAW,GAAG,CAAC,CAAC;AAE7B,6CAA6C;AAChC,QAAA,cAAc,GAAG,IAAK,CAAC;AAEpC,gFAAgF;AAEhF,8DAA8D;AACjD,QAAA,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,sDAAsD;AACzC,QAAA,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD,+CAA+C;AAClC,QAAA,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,+CAA+C;AAClC,QAAA,oBAAoB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAEvF,6DAA6D;AAChD,QAAA,oBAAoB,GAAG,IAAI,CAAC;AAEzC,gFAAgF;AAEhF,uFAAuF;AAC1E,QAAA,iBAAiB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAE1G;;;;;;GAMG;AACU,QAAA,yBAAyB,GAAG,CAAC,OAAO,CAAU,CAAC;AAE5D,iEAAiE;AACpD,QAAA,2BAA2B,GAAG,EAAE,CAAC;AAE9C,gFAAgF;AAEhF,6DAA6D;AAChD,QAAA,kBAAkB,GAAI,GAAG,CAAC;AAC1B,QAAA,mBAAmB,GAAG,GAAG,CAAC;AAEvC,gEAAgE;AACnD,QAAA,sBAAsB,GAAI,IAAI,CAAC;AAC/B,QAAA,uBAAuB,GAAG,GAAG,CAAC;AAE3C;;;;GAIG;AACU,QAAA,yBAAyB,GAAG,MAAO,CAAC;AAEjD,gFAAgF;AAEhF,gFAAgF;AACnE,QAAA,sBAAsB,GAAG,KAAM,CAAC;AAE7C,wDAAwD;AAC3C,QAAA,mBAAmB,GAAG,GAAG,CAAC;AAEvC,gFAAgF;AAEhF,2EAA2E;AAC9D,QAAA,0BAA0B,GAAG,IAAK,CAAC;AAEhD,mEAAmE;AACtD,QAAA,uBAAuB,GAAG,aAAa,CAAC;AAErD,8EAA8E;AACjE,QAAA,eAAe,GAAG,KAAM,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/utils/constants.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,gFAAgF;AAEhF,wDAAwD;AAC3C,QAAA,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7C,yDAAyD;AAC5C,QAAA,sBAAsB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAEpD,gFAAgF;AAEhF,+CAA+C;AAClC,QAAA,kBAAkB,GAAG,KAAM,CAAC;AAEzC,+DAA+D;AAClD,QAAA,WAAW,GAAG,CAAC,CAAC;AAE7B,6CAA6C;AAChC,QAAA,cAAc,GAAG,IAAK,CAAC;AAEpC,gFAAgF;AAEhF,8DAA8D;AACjD,QAAA,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,sDAAsD;AACzC,QAAA,eAAe,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD,+CAA+C;AAClC,QAAA,kBAAkB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAElD,+CAA+C;AAClC,QAAA,oBAAoB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAEvF,6DAA6D;AAChD,QAAA,oBAAoB,GAAG,IAAI,CAAC;AAEzC,gFAAgF;AAEhF,uFAAuF;AAC1E,QAAA,iBAAiB,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,CAAU,CAAC;AAE1G;;;;;;GAMG;AACU,QAAA,yBAAyB,GAAG,CAAC,OAAO,CAAU,CAAC;AAE5D,iEAAiE;AACpD,QAAA,2BAA2B,GAAG,EAAE,CAAC;AAE9C,gFAAgF;AAEhF,6DAA6D;AAChD,QAAA,kBAAkB,GAAI,GAAG,CAAC;AAC1B,QAAA,mBAAmB,GAAG,GAAG,CAAC;AAEvC;;;;;;;;GAQG;AACU,QAAA,sBAAsB,GAAI,IAAI,CAAC;AAC/B,QAAA,uBAAuB,GAAG,IAAI,CAAC;AAE5C;;;;GAIG;AACU,QAAA,yBAAyB,GAAG,MAAO,CAAC;AAEjD,gFAAgF;AAEhF,gFAAgF;AACnE,QAAA,sBAAsB,GAAG,KAAM,CAAC;AAE7C,wDAAwD;AAC3C,QAAA,mBAAmB,GAAG,GAAG,CAAC;AAEvC,gFAAgF;AAEhF,2EAA2E;AAC9D,QAAA,0BAA0B,GAAG,IAAK,CAAC;AAEhD,mEAAmE;AACtD,QAAA,uBAAuB,GAAG,aAAa,CAAC;AAErD,8EAA8E;AACjE,QAAA,eAAe,GAAG,KAAM,CAAC"}

package/dist/utils/documentRules.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared document-type rules used by both the ID-type selection screen
+ * (SmartComplyFlow) and the capture component (DocumentCapture) — kept in
+ * one place so the two can't silently diverge on which documents need a
+ * back-side photo.
+ */
+/** Documents where the backend OCR pipeline needs the reverse side. */
+export declare function requiresBackSide(documentType: string): boolean;
+/**
+ * Scale ratio for fitting an image within maxWidth x maxHeight, never
+ * upscaling. Shared by DocumentCapture's canvas sizing and compressImage so
+ * both agree on the same clamp-at-1 behavior.
+ */
+export declare function computeScaleRatio(srcWidth: number, srcHeight: number, maxWidth: number, maxHeight: number): number;
+//# sourceMappingURL=documentRules.d.ts.map

package/dist/utils/documentRules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentRules.d.ts","sourceRoot":"","sources":["../../src/utils/documentRules.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAU9D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}

package/dist/utils/documentRules.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Shared document-type rules used by both the ID-type selection screen
+ * (SmartComplyFlow) and the capture component (DocumentCapture) — kept in
+ * one place so the two can't silently diverge on which documents need a
+ * back-side photo.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requiresBackSide = requiresBackSide;
+exports.computeScaleRatio = computeScaleRatio;
+/** Documents where the backend OCR pipeline needs the reverse side. */
+function requiresBackSide(documentType) {
+    const type = documentType.toLowerCase();
+    return type.includes("voter") ||
+        type.includes("driver") ||
+        type.includes("license") ||
+        type.includes("national id") ||
+        type.includes("national id card") ||
+        type.includes("ghana");
+    // Passport: back side is the machine-readable zone but OCR reads from front only.
+    // NIN / NIN with face: front only needed — the NIN card is single-sided for OCR.
+}
+/**
+ * Scale ratio for fitting an image within maxWidth x maxHeight, never
+ * upscaling. Shared by DocumentCapture's canvas sizing and compressImage so
+ * both agree on the same clamp-at-1 behavior.
+ */
+function computeScaleRatio(srcWidth, srcHeight, maxWidth, maxHeight) {
+    return Math.min(maxWidth / srcWidth, maxHeight / srcHeight, 1);
+}
+//# sourceMappingURL=documentRules.js.map

package/dist/utils/documentRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentRules.js","sourceRoot":"","sources":["../../src/utils/documentRules.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAGH,4CAUC;AAOD,8CAOC;AAzBD,uEAAuE;AACvE,SAAgB,gBAAgB,CAAC,YAAoB;IACnD,MAAM,IAAI,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,kFAAkF;IAClF,iFAAiF;AACnF,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,QAAgB,EAChB,SAAiB,EACjB,QAAgB,EAChB,SAAiB;IAEjB,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,GAAG,QAAQ,EAAE,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;AACjE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "smartcomply-web-sdk",
-  "version": "1.0.60",
+  "version": "1.0.62",
   "description": "Drop-in identity verification (KYC) widget for web apps — face liveness, NIN/BVN, document verification",
   "main": "dist/index.js",
   "module": "dist/esm/index.js",
@@ -24,7 +24,9 @@
     "build:browser": "npx esbuild src/index.ts --bundle --format=iife --global-name=SmartComplySDK --outfile=dist/smartcomply.browser.js --target=es2020 --sourcemap --charset=utf8",
     "build:all": "npm run build && npm run build:esm && npm run build:browser",
     "prepublishOnly": "npm run build:all",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "repository": {
     "type": "git",
@@ -50,7 +52,8 @@
   "homepage": "https://github.com/386konsult/smartcomply-web-sdk#readme",
   "devDependencies": {
     "esbuild": "^0.28.0",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
   },
   "dependencies": {
     "@mediapipe/tasks-vision": "^0.10.32"