@mikashboks/capture-intelligence-core 0.1.0

package/dist/esm/types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Capture Intelligence Core — shared types, constants, and thresholds.
+ *
+ * All types are DOM-free. No HTMLElement, HTMLCanvasElement, HTMLVideoElement,
+ * HTMLImageElement, or any browser API references.
+ */
+export declare const CamState: {
+    readonly SEARCHING: 0;
+    readonly DETECTED: 1;
+    readonly STABILIZING: 2;
+    readonly CAPTURING: 3;
+    readonly DONE: 4;
+};
+export type CamStateValue = (typeof CamState)[keyof typeof CamState];
+export interface FrameMetrics {
+    brightness: number;
+    blurScore: number;
+    edgeEnergy: number;
+    frameDiff: number;
+    docAreaRatio: number;
+    docAspectRatio: number;
+    docCenterOffset: number;
+    edgeCoverage: number;
+}
+export interface DocumentReviewProfile {
+    aspectTargets: number[];
+    threshold: number;
+    expectedOrientation?: 'portrait' | 'landscape' | 'square' | 'either';
+}
+export interface DocumentLikelihoodResult {
+    isLikelyDoc: boolean;
+    confidence: number;
+    glareDetected: boolean;
+}
+export interface CropRect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface DocumentCropResult {
+    crop: CropRect | null;
+    cornersOk: boolean | null;
+}
+export interface OverlayRegion {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+export type OverlayVariant = 'card' | 'passport' | 'a4';
+export type QualityCheckResults = Record<string, boolean>;
+export interface FaceBoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface DetectedFace {
+    boundingBox: FaceBoundingBox;
+}
+export type ReviewOrientation = 'portrait' | 'landscape' | 'square';
+export interface MetadataReviewIssue {
+    key: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+export interface MetadataReviewResult {
+    passed: boolean;
+    issues: MetadataReviewIssue[];
+    orientation: ReviewOrientation;
+    isDocument: boolean;
+}
+export type ReviewMode = 'document' | 'address-document' | 'front-door' | 'selfie';
+export type QualityBucket = 'document_front' | 'document_back' | 'selfie' | 'address_document' | 'address_front_door';
+export interface ReviewDecisionOptions {
+    reviewMode: ReviewMode;
+    pendingMessage?: string;
+    failMessage?: string;
+}
+export declare const CAM_ANALYSIS_W = 160;
+export declare const CAM_ANALYSIS_H = 120;
+export declare const CAM_BRIGHTNESS_MIN = 28;
+export declare const CAM_BRIGHTNESS_MAX = 248;
+export declare const CAM_BLUR_THRESHOLD = 30;
+export declare const CAM_EDGE_THRESHOLD = 7;
+export declare const CAM_STABLE_FRAMES_NEEDED = 5;
+export declare const CAM_FRAME_DIFF_THRESHOLD = 15;
+export declare const CAM_EDGE_PIXEL_THRESHOLD = 60;
+export declare const CAM_EDGE_COVERAGE_THRESHOLD = 0.02;
+export declare const CAM_DOC_CENTER_OFFSET_MAX = 0.25;
+export declare const DOC_GALLERY_FAILURE_THRESHOLD = 1;
+export declare const DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD = 2;
+export declare const SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD = 2;
+export declare const ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD = 2;
+export declare const PICO_ANALYSIS_W = 240;
+export declare const PICO_ANALYSIS_H = 180;
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAIrE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACtE;AAID,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;CACxB;AAID,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B;AAID,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAID,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;AAIxD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAI1D,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,eAAe,CAAC;CAC9B;AAID,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;CACrB;AAID,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,kBAAkB,GAAG,YAAY,GAAG,QAAQ,CAAC;AAEnF,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,eAAe,GACf,QAAQ,GACR,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAChD,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAI9C,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAC/C,eAAO,MAAM,mCAAmC,IAAI,CAAC;AACrD,eAAO,MAAM,sCAAsC,IAAI,CAAC;AACxD,eAAO,MAAM,uCAAuC,IAAI,CAAC;AAIzD,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,eAAe,MAAM,CAAC"}

package/dist/esm/types.js

@@ -0,0 +1,35 @@
+/**
+ * Capture Intelligence Core — shared types, constants, and thresholds.
+ *
+ * All types are DOM-free. No HTMLElement, HTMLCanvasElement, HTMLVideoElement,
+ * HTMLImageElement, or any browser API references.
+ */
+/* -- Auto-capture state machine ------------------------------------------- */
+export const CamState = {
+    SEARCHING: 0,
+    DETECTED: 1,
+    STABILIZING: 2,
+    CAPTURING: 3,
+    DONE: 4,
+};
+/* -- Analysis canvas thresholds ------------------------------------------- */
+export const CAM_ANALYSIS_W = 160;
+export const CAM_ANALYSIS_H = 120;
+export const CAM_BRIGHTNESS_MIN = 28;
+export const CAM_BRIGHTNESS_MAX = 248;
+export const CAM_BLUR_THRESHOLD = 30;
+export const CAM_EDGE_THRESHOLD = 7;
+export const CAM_STABLE_FRAMES_NEEDED = 5; // ~0.33s at 15fps
+export const CAM_FRAME_DIFF_THRESHOLD = 15;
+export const CAM_EDGE_PIXEL_THRESHOLD = 60;
+export const CAM_EDGE_COVERAGE_THRESHOLD = 0.02;
+export const CAM_DOC_CENTER_OFFSET_MAX = 0.25;
+/* -- Retry escalation thresholds ------------------------------------------ */
+export const DOC_GALLERY_FAILURE_THRESHOLD = 1;
+export const DOC_SUBMIT_ANYWAY_FAILURE_THRESHOLD = 2;
+export const SELFIE_SUBMIT_ANYWAY_FAILURE_THRESHOLD = 2;
+export const ADDRESS_SUBMIT_ANYWAY_FAILURE_THRESHOLD = 2;
+/* -- Pico.js analysis dimensions ------------------------------------------ */
+export const PICO_ANALYSIS_W = 240;
+export const PICO_ANALYSIS_H = 180;
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAE/E,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;CACC,CAAC;AA+GX,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,CAAC,kBAAkB;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAChD,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,+EAA+E;AAE/E,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAC;AAEzD,+EAA+E;AAE/E,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AACnC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@mikashboks/capture-intelligence-core",
+  "version": "0.1.0",
+  "description": "DOM-free algorithmic core for capture intelligence: document classification, edge detection, frame metrics, and quality checks",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikashboks/ballerine.git",
+    "directory": "packages/capture-intelligence-core"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./__fixtures__/address-flow.fixtures": {
+      "import": {
+        "types": "./dist/esm/__fixtures__/address-flow.fixtures.d.ts",
+        "default": "./dist/esm/__fixtures__/address-flow.fixtures.js"
+      },
+      "require": {
+        "types": "./dist/cjs/__fixtures__/address-flow.fixtures.d.ts",
+        "default": "./dist/cjs/__fixtures__/address-flow.fixtures.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc --project tsconfig.esm.json",
+    "build:cjs": "tsc --project tsconfig.cjs.json",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepack": "npm run clean && npm run typecheck && npm run build",
+    "publish:npm": "npm publish --registry=https://registry.npmjs.org --access public",
+    "publish:github": "npm publish --registry=https://npm.pkg.github.com"
+  },
+  "keywords": [
+    "ballerine",
+    "capture-intelligence",
+    "document-classification",
+    "edge-detection",
+    "quality-check",
+    "sobel",
+    "kyc"
+  ],
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.4"
+  }
+}