@mikashboks/capture-intelligence-core 0.1.0

package/dist/cjs/__fixtures__/address-flow.fixtures.d.ts

@@ -0,0 +1,35 @@
+import type { AddressMethod, AddressMethodStartBehavior, AddressStepState } from '../address-proof.js';
+import type { FlowStepDefinition } from '../flow-routing.js';
+export interface AddressMethodContractFixture {
+    id: string;
+    allowedMethods: unknown;
+    expectedSanitized: AddressMethod[];
+    expectedStartBehavior?: AddressMethodStartBehavior;
+    selectedMethod?: AddressMethod | null;
+    expectedEffectiveMethod?: AddressMethod | null;
+    expectedRecommendedMethod?: AddressMethod | null;
+}
+export interface AddressCompletionContractFixture {
+    id: string;
+    allowedMethods: unknown;
+    address: AddressStepState;
+    expectedComplete: boolean;
+}
+export interface FlowRoutingContractFixture {
+    id: string;
+    currentStepId: string;
+    skipType?: string;
+    expectedNextStepId?: string;
+    expectedPreviousStepId?: string;
+}
+export declare const sharedStructuredAddressFixture: {
+    district: string;
+    chiefdom: string;
+    town: string;
+    line1: string;
+};
+export declare const addressMethodContractFixtures: AddressMethodContractFixture[];
+export declare const addressCompletionContractFixtures: AddressCompletionContractFixture[];
+export declare const flowRoutingContractSteps: FlowStepDefinition[];
+export declare const flowRoutingContractFixtures: FlowRoutingContractFixture[];
+//# sourceMappingURL=address-flow.fixtures.d.ts.map

package/dist/cjs/__fixtures__/address-flow.fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-flow.fixtures.d.ts","sourceRoot":"","sources":["../../../src/__fixtures__/address-flow.fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,WAAW,4BAA4B;IAC3C,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,aAAa,EAAE,CAAC;IACnC,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;IACnD,cAAc,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,uBAAuB,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/C,yBAAyB,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,gCAAgC;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,eAAO,MAAM,8BAA8B;;;;;CAKmC,CAAC;AAE/E,eAAO,MAAM,6BAA6B,EAAE,4BAA4B,EAuFvE,CAAC;AAEF,eAAO,MAAM,iCAAiC,EAAE,gCAAgC,EAiD/E,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,kBAAkB,EAOxD,CAAC;AAEF,eAAO,MAAM,2BAA2B,EAAE,0BAA0B,EA6BnE,CAAC"}

package/dist/cjs/__fixtures__/address-flow.fixtures.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flowRoutingContractFixtures = exports.flowRoutingContractSteps = exports.addressCompletionContractFixtures = exports.addressMethodContractFixtures = exports.sharedStructuredAddressFixture = void 0;
+exports.sharedStructuredAddressFixture = {
+    district: 'Western Area Urban',
+    chiefdom: 'Freetown',
+    town: 'Freetown',
+    line1: '12 Wilkinson Road',
+};
+exports.addressMethodContractFixtures = [
+    {
+        id: 'fallback-order-preserves-supported-methods',
+        allowedMethods: ['front_door_photo', 'front_door_photo', 'bogus', 'typed_address'],
+        expectedSanitized: ['front_door_photo', 'typed_address'],
+        expectedStartBehavior: {
+            kind: 'manual_choice',
+            effectiveMethod: null,
+            recommendedMethod: 'front_door_photo',
+        },
+        selectedMethod: null,
+        expectedEffectiveMethod: null,
+        expectedRecommendedMethod: 'front_door_photo',
+    },
+    {
+        id: 'missing-methods-default-to-canonical-order',
+        allowedMethods: undefined,
+        expectedSanitized: ['address_document', 'front_door_photo', 'typed_address'],
+        expectedStartBehavior: {
+            kind: 'manual_choice',
+            effectiveMethod: null,
+            recommendedMethod: 'address_document',
+        },
+        selectedMethod: null,
+        expectedEffectiveMethod: null,
+        expectedRecommendedMethod: 'address_document',
+    },
+    {
+        id: 'invalid-only-methods-fall-back-to-default-order',
+        allowedMethods: ['bogus'],
+        expectedSanitized: ['address_document', 'front_door_photo', 'typed_address'],
+        expectedStartBehavior: {
+            kind: 'manual_choice',
+            effectiveMethod: null,
+            recommendedMethod: 'address_document',
+        },
+        selectedMethod: null,
+        expectedEffectiveMethod: null,
+        expectedRecommendedMethod: 'address_document',
+    },
+    {
+        id: 'typed-only-address-skips-directly-to-form',
+        allowedMethods: ['typed_address'],
+        expectedSanitized: ['typed_address'],
+        expectedStartBehavior: {
+            kind: 'skip_to_form',
+            effectiveMethod: 'typed_address',
+            recommendedMethod: null,
+        },
+        selectedMethod: null,
+        expectedEffectiveMethod: 'typed_address',
+        expectedRecommendedMethod: null,
+    },
+    {
+        id: 'single-proof-method-auto-selects-proof-capture',
+        allowedMethods: ['front_door_photo'],
+        expectedSanitized: ['front_door_photo'],
+        expectedStartBehavior: {
+            kind: 'auto_select_proof',
+            effectiveMethod: 'front_door_photo',
+            recommendedMethod: 'front_door_photo',
+        },
+        selectedMethod: null,
+        expectedEffectiveMethod: 'front_door_photo',
+        expectedRecommendedMethod: 'front_door_photo',
+    },
+    {
+        id: 'invalid-explicit-selection-does-not-get-auto-inferred',
+        allowedMethods: ['typed_address'],
+        expectedSanitized: ['typed_address'],
+        selectedMethod: 'front_door_photo',
+        expectedEffectiveMethod: null,
+        expectedRecommendedMethod: null,
+    },
+    {
+        id: 'manual-choice-prefers-address-document-over-typed-address',
+        allowedMethods: ['typed_address', 'address_document'],
+        expectedSanitized: ['address_document', 'typed_address'],
+        expectedStartBehavior: {
+            kind: 'manual_choice',
+            effectiveMethod: null,
+            recommendedMethod: 'address_document',
+        },
+        selectedMethod: 'typed_address',
+        expectedEffectiveMethod: 'typed_address',
+        expectedRecommendedMethod: 'address_document',
+    },
+];
+exports.addressCompletionContractFixtures = [
+    {
+        id: 'typed-address-completes-with-structured-fields-only',
+        allowedMethods: ['typed_address'],
+        address: {
+            ...exports.sharedStructuredAddressFixture,
+            method: 'typed_address',
+            proofUri: null,
+            coordinates: null,
+        },
+        expectedComplete: true,
+    },
+    {
+        id: 'address-document-requires-proof-upload',
+        allowedMethods: ['address_document'],
+        address: {
+            ...exports.sharedStructuredAddressFixture,
+            method: 'address_document',
+            proofUri: null,
+            coordinates: null,
+        },
+        expectedComplete: false,
+    },
+    {
+        id: 'front-door-photo-requires-gps-coordinates',
+        allowedMethods: ['front_door_photo'],
+        address: {
+            ...exports.sharedStructuredAddressFixture,
+            method: 'front_door_photo',
+            proofUri: 'file://front-door.jpg',
+            coordinates: null,
+        },
+        expectedComplete: false,
+    },
+    {
+        id: 'front-door-photo-completes-with-proof-and-gps',
+        allowedMethods: ['front_door_photo'],
+        address: {
+            ...exports.sharedStructuredAddressFixture,
+            method: 'front_door_photo',
+            proofUri: 'file://front-door.jpg',
+            coordinates: {
+                lat: 8.48,
+                lng: -13.23,
+                accuracy: 12,
+            },
+        },
+        expectedComplete: true,
+    },
+];
+exports.flowRoutingContractSteps = [
+    { id: 'welcome' },
+    { id: 'address-proof-start' },
+    { id: 'address-input', type: 'address-form' },
+    { id: 'address-proof-photo', type: 'address-proof' },
+    { id: 'check-address-proof', type: 'address-proof' },
+    { id: 'loading' },
+];
+exports.flowRoutingContractFixtures = [
+    {
+        id: 'proof-capture-mode-skips-address-form',
+        currentStepId: 'address-proof-start',
+        skipType: 'address-form',
+        expectedNextStepId: 'address-proof-photo',
+        expectedPreviousStepId: 'welcome',
+    },
+    {
+        id: 'typed-address-mode-skips-proof-capture-segment',
+        currentStepId: 'address-input',
+        skipType: 'address-proof',
+        expectedNextStepId: 'loading',
+        expectedPreviousStepId: 'address-proof-start',
+    },
+    {
+        id: 'back-navigation-returns-to-method-selection-when-form-is-skipped',
+        currentStepId: 'address-proof-photo',
+        skipType: 'address-form',
+        expectedNextStepId: 'check-address-proof',
+        expectedPreviousStepId: 'address-proof-start',
+    },
+    {
+        id: 'skip-resolution-works-even-when-current-step-is-in-the-skipped-type',
+        currentStepId: 'address-proof-photo',
+        skipType: 'address-proof',
+        expectedNextStepId: 'loading',
+        expectedPreviousStepId: 'address-input',
+    },
+];
+//# sourceMappingURL=address-flow.fixtures.js.map

package/dist/cjs/__fixtures__/address-flow.fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-flow.fixtures.js","sourceRoot":"","sources":["../../../src/__fixtures__/address-flow.fixtures.ts"],"names":[],"mappings":"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"}

package/dist/cjs/__fixtures__/metadata-review.fixtures.d.ts

@@ -0,0 +1,11 @@
+import type { MetadataReviewInput } from '../metadata-review.js';
+import type { MetadataReviewResult } from '../types.js';
+export interface MetadataReviewFixture {
+    id: string;
+    input: MetadataReviewInput;
+    expected: Pick<MetadataReviewResult, 'passed' | 'orientation' | 'isDocument'> & {
+        issueKeys: string[];
+    };
+}
+export declare const metadataReviewFixtures: MetadataReviewFixture[];
+//# sourceMappingURL=metadata-review.fixtures.d.ts.map

package/dist/cjs/__fixtures__/metadata-review.fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-review.fixtures.d.ts","sourceRoot":"","sources":["../../../src/__fixtures__/metadata-review.fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,QAAQ,GAAG,aAAa,GAAG,YAAY,CAAC,GAAG;QAC9E,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,eAAO,MAAM,sBAAsB,EAAE,qBAAqB,EAgEzD,CAAC"}

package/dist/cjs/__fixtures__/metadata-review.fixtures.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.metadataReviewFixtures = void 0;
+exports.metadataReviewFixtures = [
+    {
+        id: 'passport-square-fails-shape-check',
+        input: {
+            type: 'document',
+            width: 1000,
+            height: 1000,
+            documentType: 'PASSPORT',
+            fileSize: 180_000,
+        },
+        expected: {
+            passed: false,
+            orientation: 'square',
+            isDocument: false,
+            issueKeys: ['bad_aspect'],
+        },
+    },
+    {
+        id: 'portrait-id-warns-for-rotation-only',
+        input: {
+            type: 'document',
+            width: 720,
+            height: 1280,
+            documentType: 'NATIONAL_ID',
+            fileSize: 260_000,
+        },
+        expected: {
+            passed: true,
+            orientation: 'portrait',
+            isDocument: true,
+            issueKeys: ['document_rotated'],
+        },
+    },
+    {
+        id: 'compressed-landscape-selfie-warns-without-failing',
+        input: {
+            type: 'selfie',
+            width: 1280,
+            height: 720,
+            fileSize: 10_000,
+        },
+        expected: {
+            passed: true,
+            orientation: 'landscape',
+            isDocument: false,
+            issueKeys: ['selfie_landscape', 'low_detail'],
+        },
+    },
+    {
+        id: 'tiny-document-fails-immediately',
+        input: {
+            type: 'document',
+            width: 180,
+            height: 120,
+            documentType: 'DRIVERS_LICENSE',
+            fileSize: 20_000,
+        },
+        expected: {
+            passed: false,
+            orientation: 'landscape',
+            isDocument: false,
+            issueKeys: ['too_small'],
+        },
+    },
+];
+//# sourceMappingURL=metadata-review.fixtures.js.map

package/dist/cjs/__fixtures__/metadata-review.fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-review.fixtures.js","sourceRoot":"","sources":["../../../src/__fixtures__/metadata-review.fixtures.ts"],"names":[],"mappings":";;;AAWa,QAAA,sBAAsB,GAA4B;IAC7D;QACE,EAAE,EAAE,mCAAmC;QACvC,KAAK,EAAE;YACL,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,UAAU;YACxB,QAAQ,EAAE,OAAO;SAClB;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,QAAQ;YACrB,UAAU,EAAE,KAAK;YACjB,SAAS,EAAE,CAAC,YAAY,CAAC;SAC1B;KACF;IACD;QACE,EAAE,EAAE,qCAAqC;QACzC,KAAK,EAAE;YACL,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,aAAa;YAC3B,QAAQ,EAAE,OAAO;SAClB;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,UAAU;YACvB,UAAU,EAAE,IAAI;YAChB,SAAS,EAAE,CAAC,kBAAkB,CAAC;SAChC;KACF;IACD;QACE,EAAE,EAAE,mDAAmD;QACvD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,GAAG;YACX,QAAQ,EAAE,MAAM;SACjB;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,KAAK;YACjB,SAAS,EAAE,CAAC,kBAAkB,EAAE,YAAY,CAAC;SAC9C;KACF;IACD;QACE,EAAE,EAAE,iCAAiC;QACrC,KAAK,EAAE;YACL,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,GAAG;YACV,MAAM,EAAE,GAAG;YACX,YAAY,EAAE,iBAAiB;YAC/B,QAAQ,EAAE,MAAM;SACjB;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,KAAK;YACb,WAAW,EAAE,WAAW;YACxB,UAAU,EAAE,KAAK;YACjB,SAAS,EAAE,CAAC,WAAW,CAAC;SACzB;KACF;CACF,CAAC"}

package/dist/cjs/address-proof.d.ts

@@ -0,0 +1,33 @@
+export declare const ADDRESS_METHOD_ORDER: readonly ["address_document", "front_door_photo", "typed_address"];
+export type AddressMethod = (typeof ADDRESS_METHOD_ORDER)[number];
+export type AddressProofMode = Exclude<AddressMethod, 'typed_address'>;
+export interface AddressCoordinatesLike {
+    latitude?: number | null;
+    longitude?: number | null;
+    lat?: number | null;
+    lng?: number | null;
+    accuracy?: number | null;
+}
+export interface AddressStepState {
+    district?: string | null;
+    chiefdom?: string | null;
+    town?: string | null;
+    line1?: string | null;
+    method?: AddressMethod | null;
+    proofUri?: string | null;
+    coordinates?: AddressCoordinatesLike | null;
+}
+export interface AddressMethodStartBehavior {
+    kind: 'skip_to_form' | 'auto_select_proof' | 'manual_choice';
+    effectiveMethod: AddressMethod | null;
+    recommendedMethod: AddressMethod | null;
+}
+export declare function isAddressMethod(value: unknown): value is AddressMethod;
+export declare function sanitizeAllowedAddressMethods(raw: unknown): AddressMethod[];
+export declare function getRecommendedAddressMethod(methods: unknown): AddressMethod | null;
+export declare function getAddressMethodStartBehavior(methods: unknown): AddressMethodStartBehavior;
+export declare function getEffectiveAddressMethod(selectedMethod: AddressMethod | null | undefined, methods: unknown): AddressMethod | null;
+export declare function hasAddressProofCoordinates(coordinates?: AddressCoordinatesLike | null): coordinates is AddressCoordinatesLike;
+export declare function hasStructuredAddress(address?: AddressStepState | null): boolean;
+export declare function isAddressStepComplete(address: AddressStepState | null | undefined, methods: unknown): boolean;
+//# sourceMappingURL=address-proof.d.ts.map

package/dist/cjs/address-proof.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-proof.d.ts","sourceRoot":"","sources":["../../src/address-proof.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,oEAIvB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,cAAc,GAAG,mBAAmB,GAAG,eAAe,CAAC;IAC7D,eAAe,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,iBAAiB,EAAE,aAAa,GAAG,IAAI,CAAC;CACzC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAMtE;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,EAAE,CAS3E;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAGlF;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,0BAA0B,CA2B1F;AAED,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EAChD,OAAO,EAAE,OAAO,GACf,aAAa,GAAG,IAAI,CAQtB;AAED,wBAAgB,0BAA0B,CACxC,WAAW,CAAC,EAAE,sBAAsB,GAAG,IAAI,GAC1C,WAAW,IAAI,sBAAsB,CASvC;AAED,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAW/E;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAC5C,OAAO,EAAE,OAAO,GACf,OAAO,CAoBT"}

package/dist/cjs/address-proof.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ADDRESS_METHOD_ORDER = void 0;
+exports.isAddressMethod = isAddressMethod;
+exports.sanitizeAllowedAddressMethods = sanitizeAllowedAddressMethods;
+exports.getRecommendedAddressMethod = getRecommendedAddressMethod;
+exports.getAddressMethodStartBehavior = getAddressMethodStartBehavior;
+exports.getEffectiveAddressMethod = getEffectiveAddressMethod;
+exports.hasAddressProofCoordinates = hasAddressProofCoordinates;
+exports.hasStructuredAddress = hasStructuredAddress;
+exports.isAddressStepComplete = isAddressStepComplete;
+exports.ADDRESS_METHOD_ORDER = [
+    'address_document',
+    'front_door_photo',
+    'typed_address',
+];
+function isAddressMethod(value) {
+    return (value === 'address_document' ||
+        value === 'front_door_photo' ||
+        value === 'typed_address');
+}
+function sanitizeAllowedAddressMethods(raw) {
+    if (!Array.isArray(raw) || raw.length === 0) {
+        return [...exports.ADDRESS_METHOD_ORDER];
+    }
+    const requestedMethods = new Set(raw.filter(isAddressMethod));
+    const allowedMethods = exports.ADDRESS_METHOD_ORDER.filter(method => requestedMethods.has(method));
+    return allowedMethods.length > 0 ? allowedMethods : [...exports.ADDRESS_METHOD_ORDER];
+}
+function getRecommendedAddressMethod(methods) {
+    const allowedMethods = sanitizeAllowedAddressMethods(methods);
+    return allowedMethods.find(method => method !== 'typed_address') ?? null;
+}
+function getAddressMethodStartBehavior(methods) {
+    const allowedMethods = sanitizeAllowedAddressMethods(methods);
+    const proofMethods = allowedMethods.filter((method) => method !== 'typed_address');
+    if (proofMethods.length === 0) {
+        return {
+            kind: 'skip_to_form',
+            effectiveMethod: allowedMethods.includes('typed_address') ? 'typed_address' : null,
+            recommendedMethod: null,
+        };
+    }
+    if (proofMethods.length === 1 && !allowedMethods.includes('typed_address')) {
+        return {
+            kind: 'auto_select_proof',
+            effectiveMethod: proofMethods[0],
+            recommendedMethod: proofMethods[0],
+        };
+    }
+    return {
+        kind: 'manual_choice',
+        effectiveMethod: null,
+        recommendedMethod: getRecommendedAddressMethod(allowedMethods),
+    };
+}
+function getEffectiveAddressMethod(selectedMethod, methods) {
+    const allowedMethods = sanitizeAllowedAddressMethods(methods);
+    if (selectedMethod) {
+        return allowedMethods.includes(selectedMethod) ? selectedMethod : null;
+    }
+    return getAddressMethodStartBehavior(allowedMethods).effectiveMethod;
+}
+function hasAddressProofCoordinates(coordinates) {
+    if (!coordinates || typeof coordinates !== 'object') {
+        return false;
+    }
+    const latitude = coordinates.latitude ?? coordinates.lat;
+    const longitude = coordinates.longitude ?? coordinates.lng;
+    return typeof latitude === 'number' && typeof longitude === 'number';
+}
+function hasStructuredAddress(address) {
+    if (!address) {
+        return false;
+    }
+    return Boolean(address.district &&
+        address.chiefdom &&
+        address.town?.trim() &&
+        address.line1?.trim());
+}
+function isAddressStepComplete(address, methods) {
+    const effectiveMethod = getEffectiveAddressMethod(address?.method ?? null, methods);
+    if (!effectiveMethod || !hasStructuredAddress(address)) {
+        return false;
+    }
+    if (effectiveMethod === 'typed_address') {
+        return true;
+    }
+    if (!address?.proofUri) {
+        return false;
+    }
+    if (effectiveMethod === 'front_door_photo' && !hasAddressProofCoordinates(address.coordinates)) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=address-proof.js.map

package/dist/cjs/address-proof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-proof.js","sourceRoot":"","sources":["../../src/address-proof.ts"],"names":[],"mappings":";;;AAiCA,0CAMC;AAED,sEASC;AAED,kEAGC;AAED,sEA2BC;AAED,8DAWC;AAED,gEAWC;AAED,oDAWC;AAED,sDAuBC;AApJY,QAAA,oBAAoB,GAAG;IAClC,kBAAkB;IAClB,kBAAkB;IAClB,eAAe;CACP,CAAC;AA6BX,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,KAAK,KAAK,kBAAkB;QAC5B,KAAK,KAAK,kBAAkB;QAC5B,KAAK,KAAK,eAAe,CAC1B,CAAC;AACJ,CAAC;AAED,SAAgB,6BAA6B,CAAC,GAAY;IACxD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,GAAG,4BAAoB,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;IAC9D,MAAM,cAAc,GAAG,4BAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAE3F,OAAO,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,4BAAoB,CAAC,CAAC;AAChF,CAAC;AAED,SAAgB,2BAA2B,CAAC,OAAgB;IAC1D,MAAM,cAAc,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC9D,OAAO,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,eAAe,CAAC,IAAI,IAAI,CAAC;AAC3E,CAAC;AAED,SAAgB,6BAA6B,CAAC,OAAgB;IAC5D,MAAM,cAAc,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CACxC,CAAC,MAAM,EAA8B,EAAE,CAAC,MAAM,KAAK,eAAe,CACnE,CAAC;IAEF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,eAAe,EAAE,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI;YAClF,iBAAiB,EAAE,IAAI;SACxB,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;QAC3E,OAAO;YACL,IAAI,EAAE,mBAAmB;YACzB,eAAe,EAAE,YAAY,CAAC,CAAC,CAAC;YAChC,iBAAiB,EAAE,YAAY,CAAC,CAAC,CAAC;SACnC,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,2BAA2B,CAAC,cAAc,CAAC;KAC/D,CAAC;AACJ,CAAC;AAED,SAAgB,yBAAyB,CACvC,cAAgD,EAChD,OAAgB;IAEhB,MAAM,cAAc,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAE9D,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,cAAc,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,CAAC;IAED,OAAO,6BAA6B,CAAC,cAAc,CAAC,CAAC,eAAe,CAAC;AACvE,CAAC;AAED,SAAgB,0BAA0B,CACxC,WAA2C;IAE3C,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,IAAI,WAAW,CAAC,GAAG,CAAC;IACzD,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,GAAG,CAAC;IAE3D,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,SAAS,KAAK,QAAQ,CAAC;AACvE,CAAC;AAED,SAAgB,oBAAoB,CAAC,OAAiC;IACpE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,OAAO,CACZ,OAAO,CAAC,QAAQ;QACd,OAAO,CAAC,QAAQ;QAChB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE;QACpB,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,CACxB,CAAC;AACJ,CAAC;AAED,SAAgB,qBAAqB,CACnC,OAA4C,EAC5C,OAAgB;IAEhB,MAAM,eAAe,GAAG,yBAAyB,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,OAAO,CAAC,CAAC;IAEpF,IAAI,CAAC,eAAe,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,eAAe,KAAK,eAAe,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,eAAe,KAAK,kBAAkB,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/F,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cjs/document-classifier.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Document likelihood classifier -- 5-signal Bayesian heuristic.
+ *
+ * DOM-free: operates on raw greyscale (Uint8Array) and RGBA (Uint8ClampedArray)
+ * pixel data. No Canvas, no HTMLImageElement.
+ */
+import type { DocumentLikelihoodResult, DocumentReviewProfile } from './types.js';
+export declare function getDocumentReviewProfile(documentType: string | null | undefined): DocumentReviewProfile;
+/**
+ * Determine whether a greyscale + RGBA image looks like a document.
+ *
+ * @param grey      - Greyscale pixel array (w * h, one byte per pixel)
+ * @param imgData   - RGBA pixel array (w * h * 4 bytes)
+ * @param w         - Image width in pixels
+ * @param h         - Image height in pixels
+ * @param documentType - Optional document type hint for aspect-ratio matching
+ */
+export declare function checkDocumentLikelihood(grey: Uint8Array, imgData: Uint8ClampedArray, w: number, h: number, documentType?: string | null): DocumentLikelihoodResult;
+//# sourceMappingURL=document-classifier.d.ts.map

package/dist/cjs/document-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-classifier.d.ts","sourceRoot":"","sources":["../../src/document-classifier.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AA6BlF,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACtC,qBAAqB,CA+CvB;AAID;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,iBAAiB,EAC1B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,wBAAwB,CAgI1B"}