@smileid/usesmileid 12.0.0-beta01 → 12.0.0

package/dist/data/compression/payload_compression_config.d.ts

@@ -0,0 +1,36 @@
+export declare const PayloadCompressionConfig: {
+    /** 1 MiB. Binary MB is the locked cross-SDK unit. */
+    readonly bytesPerMB: number;
+    /** Primary compression goal for the raw bundle. */
+    readonly rawTarget: number;
+    /** Relaxed raw ceiling, accepted only if the projected encoded size still fits the cap. */
+    readonly rawFallback: number;
+    /** The real guardrail: projected base64-encoded body must stay under this (margin under 6 MB). */
+    readonly hardEncodedCap: number;
+    /** Rule A trigger: combined document images larger than this start the document sub-pass. */
+    readonly docCombinedTrigger: number;
+    /** Rule A sub-target: pull the combined documents under this (back first, then front). */
+    readonly docCombinedTarget: number;
+    /** Rule B trigger: a selfie larger than this marks a face-heavy job (faces compressed first). */
+    readonly selfieTrigger: number;
+    /** Minimum JPEG quality for face images (selfie + liveness) — higher penalty. Pending DS sign-off. */
+    readonly faceMinQ: 0.45;
+    /** Minimum JPEG quality for document images — preserves OCR / MRZ. Pending DS sign-off. */
+    readonly docMinQ: 0.7;
+    /**
+     * Absolute JPEG-quality floor for the hard-guarantee pass. When a bundle is still over
+     * `rawFallback` after every image has hit its per-type floor (`faceMinQ` / `docMinQ`), the
+     * guarantee pass keeps stepping quality down to this value — below the per-type floors — so an
+     * oversized capture never fails submission on size. Matches v11's quality-10 floor.
+     */
+    readonly absoluteMinQ: 0.1;
+    /** Quality decrement per re-encode step. */
+    readonly qualityStep: 0.05;
+    /** Nominal re-encode start point; each asset steps down from its own capture quality. */
+    readonly startQ: 0.9;
+    /** Fixed allowance for multipart field names + part framing not counted in image/metadata totals. */
+    readonly structuralOverheadBytes: 2048;
+};
+/** base64 length of `n` raw bytes: `ceil(n / 3) * 4`. */
+export declare function base64Len(n: number): number;
+//# sourceMappingURL=payload_compression_config.d.ts.map

package/dist/data/compression/payload_compression_config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload_compression_config.d.ts","sourceRoot":"","sources":["../../../src/data/compression/payload_compression_config.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,wBAAwB;IACnC,qDAAqD;;IAErD,mDAAmD;;IAEnD,2FAA2F;;IAE3F,kGAAkG;;IAElG,6FAA6F;;IAE7F,0FAA0F;;IAE1F,iGAAiG;;IAEjG,sGAAsG;;IAEtG,2FAA2F;;IAE3F;;;;;OAKG;;IAEH,4CAA4C;;IAE5C,yFAAyF;;IAEzF,qGAAqG;;CAE7F,CAAC;AAEX,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C"}

package/dist/data/compression/payload_compression_config.js

@@ -0,0 +1,52 @@
+/**
+ * Shared byte-size guardrails and adaptive JPEG-compression constants for keeping a v3
+ * form-data submission under AWS Lambda's 6 MB synchronous payload limit.
+ *
+ * **Cross-SDK source of truth** — the same thresholds, order, floors, and {@link base64Len}
+ * formula are mirrored byte-for-byte in the Android, iOS, and Flutter SDKs. Do not diverge any
+ * value without updating all four platforms.
+ *
+ * Lambda sees the **base64-encoded** body forwarded by API Gateway (base64 expands binary by
+ * ~33%), so the real guardrail is `PayloadCompressor.projectedEncodedSize` against
+ * `hardEncodedCap` — not raw bytes. Units are **binary MB (MiB, 1 << 20)**, locked across all
+ * four SDKs.
+ */
+const BYTES_PER_MB = 1 << 20;
+export const PayloadCompressionConfig = {
+    /** 1 MiB. Binary MB is the locked cross-SDK unit. */
+    bytesPerMB: BYTES_PER_MB,
+    /** Primary compression goal for the raw bundle. */
+    rawTarget: 4 * BYTES_PER_MB,
+    /** Relaxed raw ceiling, accepted only if the projected encoded size still fits the cap. */
+    rawFallback: 4 * BYTES_PER_MB + BYTES_PER_MB / 2, // 4.5 MiB
+    /** The real guardrail: projected base64-encoded body must stay under this (margin under 6 MB). */
+    hardEncodedCap: Math.floor((57 * BYTES_PER_MB) / 10), // 5.7 MiB
+    /** Rule A trigger: combined document images larger than this start the document sub-pass. */
+    docCombinedTrigger: 4 * BYTES_PER_MB,
+    /** Rule A sub-target: pull the combined documents under this (back first, then front). */
+    docCombinedTarget: 3 * BYTES_PER_MB,
+    /** Rule B trigger: a selfie larger than this marks a face-heavy job (faces compressed first). */
+    selfieTrigger: 1 * BYTES_PER_MB,
+    /** Minimum JPEG quality for face images (selfie + liveness) — higher penalty. Pending DS sign-off. */
+    faceMinQ: 0.45,
+    /** Minimum JPEG quality for document images — preserves OCR / MRZ. Pending DS sign-off. */
+    docMinQ: 0.7,
+    /**
+     * Absolute JPEG-quality floor for the hard-guarantee pass. When a bundle is still over
+     * `rawFallback` after every image has hit its per-type floor (`faceMinQ` / `docMinQ`), the
+     * guarantee pass keeps stepping quality down to this value — below the per-type floors — so an
+     * oversized capture never fails submission on size. Matches v11's quality-10 floor.
+     */
+    absoluteMinQ: 0.1,
+    /** Quality decrement per re-encode step. */
+    qualityStep: 0.05,
+    /** Nominal re-encode start point; each asset steps down from its own capture quality. */
+    startQ: 0.9,
+    /** Fixed allowance for multipart field names + part framing not counted in image/metadata totals. */
+    structuralOverheadBytes: 2048,
+};
+/** base64 length of `n` raw bytes: `ceil(n / 3) * 4`. */
+export function base64Len(n) {
+    return Math.ceil(n / 3) * 4;
+}
+//# sourceMappingURL=payload_compression_config.js.map

package/dist/data/compression/payload_compression_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload_compression_config.js","sourceRoot":"","sources":["../../../src/data/compression/payload_compression_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,CAAC;AAE7B,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,qDAAqD;IACrD,UAAU,EAAE,YAAY;IACxB,mDAAmD;IACnD,SAAS,EAAE,CAAC,GAAG,YAAY;IAC3B,2FAA2F;IAC3F,WAAW,EAAE,CAAC,GAAG,YAAY,GAAG,YAAY,GAAG,CAAC,EAAE,UAAU;IAC5D,kGAAkG;IAClG,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,YAAY,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU;IAChE,6FAA6F;IAC7F,kBAAkB,EAAE,CAAC,GAAG,YAAY;IACpC,0FAA0F;IAC1F,iBAAiB,EAAE,CAAC,GAAG,YAAY;IACnC,iGAAiG;IACjG,aAAa,EAAE,CAAC,GAAG,YAAY;IAC/B,sGAAsG;IACtG,QAAQ,EAAE,IAAI;IACd,2FAA2F;IAC3F,OAAO,EAAE,GAAG;IACZ;;;;;OAKG;IACH,YAAY,EAAE,GAAG;IACjB,4CAA4C;IAC5C,WAAW,EAAE,IAAI;IACjB,yFAAyF;IACzF,MAAM,EAAE,GAAG;IACX,qGAAqG;IACrG,uBAAuB,EAAE,IAAI;CACrB,CAAC;AAEX,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC"}

package/dist/data/compression/payload_compression_runner.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Per-role JPEG sizes in MB, measured before compression (`*Original`) and after (`*Final`); equal
+ * when the image was not compressed, `undefined` for an absent role. Stamped into the submission
+ * metadata so the backend sees each file's original size and its compressed size.
+ */
+export interface PayloadCompressionSizes {
+    readonly selfieOriginalMb?: number | undefined;
+    readonly selfieFinalMb?: number | undefined;
+    readonly frontOriginalMb?: number | undefined;
+    readonly frontFinalMb?: number | undefined;
+    readonly backOriginalMb?: number | undefined;
+    readonly backFinalMb?: number | undefined;
+}
+/**
+ * Builds `CompressibleAssets` from a submission's captured JPEG URIs and runs `PayloadCompressor`
+ * to bring the bundle under the transmission cap, re-stamping the Smile EXIF `image_digest` (and
+ * re-encoding natively) per step. Best-effort: it compresses each image down to its quality floor
+ * and resolves — it never throws on size, so submission is never blocked.
+ */
+export declare const PayloadCompressionRunner: {
+    compress(args: {
+        selfieImage?: string | undefined;
+        livenessImages?: readonly string[] | undefined;
+        frontDocument?: string | undefined;
+        backDocument?: string | undefined;
+        metadataBytes: number;
+    }): Promise<PayloadCompressionSizes>;
+};
+//# sourceMappingURL=payload_compression_runner.d.ts.map

package/dist/data/compression/payload_compression_runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload_compression_runner.d.ts","sourceRoot":"","sources":["../../../src/data/compression/payload_compression_runner.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAQD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB;mBACd;QACnB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;QAC/C,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACnC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAClC,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAoDrC,CAAC"}

package/dist/data/compression/payload_compression_runner.js

@@ -0,0 +1,55 @@
+import { File } from "expo-file-system";
+import { ImageType } from "@smileid/usesmileid_bridge";
+import { CameraDefaults } from "../../camera/camera_defaults";
+import { CompressibleAssets } from "./compressible_asset";
+import { PayloadCompressor } from "./payload_compressor";
+import { UriCompressibleAsset } from "./uri_compressible_asset";
+// RN `CameraDefaults` only exposes the document JPEG quality; selfie/liveness capture quality
+// match the cross-SDK values. These seed only the recompress start, which steps DOWN from here
+// (never re-encoding above the capture quality, which would inflate).
+const SELFIE_CAPTURE_QUALITY = 0.95;
+const LIVENESS_CAPTURE_QUALITY = 0.8;
+const BYTES_PER_MB = 1024 * 1024;
+function sizeInMb(uri) {
+    if (uri === undefined)
+        return undefined;
+    const bytes = new File(uri).size ?? 0;
+    return bytes > 0 ? bytes / BYTES_PER_MB : undefined;
+}
+/**
+ * Builds `CompressibleAssets` from a submission's captured JPEG URIs and runs `PayloadCompressor`
+ * to bring the bundle under the transmission cap, re-stamping the Smile EXIF `image_digest` (and
+ * re-encoding natively) per step. Best-effort: it compresses each image down to its quality floor
+ * and resolves — it never throws on size, so submission is never blocked.
+ */
+export const PayloadCompressionRunner = {
+    async compress(args) {
+        // Original JPEG sizes, measured before the compressor rewrites the files in place.
+        const selfieOriginalMb = sizeInMb(args.selfieImage);
+        const frontOriginalMb = sizeInMb(args.frontDocument);
+        const backOriginalMb = sizeInMb(args.backDocument);
+        const assets = new CompressibleAssets({
+            selfie: args.selfieImage
+                ? new UriCompressibleAsset(ImageType.Selfie, args.selfieImage, SELFIE_CAPTURE_QUALITY)
+                : undefined,
+            liveness: (args.livenessImages ?? []).map((uri) => new UriCompressibleAsset(ImageType.Liveness, uri, LIVENESS_CAPTURE_QUALITY)),
+            documentFront: args.frontDocument
+                ? new UriCompressibleAsset(ImageType.DocumentFront, args.frontDocument, CameraDefaults.documentJpegQuality)
+                : undefined,
+            documentBack: args.backDocument
+                ? new UriCompressibleAsset(ImageType.DocumentBack, args.backDocument, CameraDefaults.documentJpegQuality)
+                : undefined,
+        });
+        await PayloadCompressor.prepareBundleForTransmission(assets, args.metadataBytes);
+        // Final JPEG sizes, measured after compression (equal to the originals when not compressed).
+        return {
+            selfieOriginalMb,
+            selfieFinalMb: sizeInMb(args.selfieImage),
+            frontOriginalMb,
+            frontFinalMb: sizeInMb(args.frontDocument),
+            backOriginalMb,
+            backFinalMb: sizeInMb(args.backDocument),
+        };
+    },
+};
+//# sourceMappingURL=payload_compression_runner.js.map

package/dist/data/compression/payload_compression_runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload_compression_runner.js","sourceRoot":"","sources":["../../../src/data/compression/payload_compression_runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,8FAA8F;AAC9F,+FAA+F;AAC/F,sEAAsE;AACtE,MAAM,sBAAsB,GAAG,IAAI,CAAC;AACpC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC,MAAM,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;AAgBjC,SAAS,QAAQ,CAAC,GAAuB;IACvC,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IACtC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,CAAC,QAAQ,CAAC,IAMd;QACC,mFAAmF;QACnF,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEnD,MAAM,MAAM,GAAG,IAAI,kBAAkB,CAAC;YACpC,MAAM,EAAE,IAAI,CAAC,WAAW;gBACtB,CAAC,CAAC,IAAI,oBAAoB,CACtB,SAAS,CAAC,MAAM,EAChB,IAAI,CAAC,WAAW,EAChB,sBAAsB,CACvB;gBACH,CAAC,CAAC,SAAS;YACb,QAAQ,EAAE,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CACvC,CAAC,GAAG,EAAE,EAAE,CACN,IAAI,oBAAoB,CACtB,SAAS,CAAC,QAAQ,EAClB,GAAG,EACH,wBAAwB,CACzB,CACJ;YACD,aAAa,EAAE,IAAI,CAAC,aAAa;gBAC/B,CAAC,CAAC,IAAI,oBAAoB,CACtB,SAAS,CAAC,aAAa,EACvB,IAAI,CAAC,aAAa,EAClB,cAAc,CAAC,mBAAmB,CACnC;gBACH,CAAC,CAAC,SAAS;YACb,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC7B,CAAC,CAAC,IAAI,oBAAoB,CACtB,SAAS,CAAC,YAAY,EACtB,IAAI,CAAC,YAAY,EACjB,cAAc,CAAC,mBAAmB,CACnC;gBACH,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;QACH,MAAM,iBAAiB,CAAC,4BAA4B,CAClD,MAAM,EACN,IAAI,CAAC,aAAa,CACnB,CAAC;QAEF,6FAA6F;QAC7F,OAAO;YACL,gBAAgB;YAChB,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;YACzC,eAAe;YACf,YAAY,EAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC;YAC1C,cAAc;YACd,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;SACzC,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/data/compression/payload_compressor.d.ts

@@ -0,0 +1,40 @@
+import { type CompressibleAsset, CompressibleAssets } from "./compressible_asset";
+/**
+ * Adaptive image-compression orchestrator that keeps a v3 submission under the Lambda payload
+ * cap. Pure decision logic over `CompressibleAssets` — the native JPEG encode + EXIF re-stamp
+ * lives behind `CompressibleAsset.recompress`.
+ *
+ * **Cross-SDK source of truth.** The size formulas, plan order, sub-rules, and loop here are
+ * mirrored byte-for-byte with the Android / iOS / Flutter SDKs. See `PayloadCompressionConfig`.
+ *
+ * Scope: image compression only. Metadata is **measured** (it counts toward the bundle and the
+ * projected encoded size) but never modified.
+ */
+export declare const PayloadCompressor: {
+    /** Raw bundle size: sum of current image bytes + serialized metadata JSON bytes. */
+    rawBundleSize(assets: CompressibleAssets, metadataBytes: number): number;
+    /**
+     * Projected size of the base64-encoded body API Gateway forwards to Lambda: images are
+     * base64-expanded, metadata JSON is counted raw, plus a fixed structural allowance. The real
+     * guardrail.
+     */
+    projectedEncodedSize(assets: CompressibleAssets, metadataBytes: number): number;
+    /**
+     * Ordered (asset, minQuality) plan. Faces take the higher penalty (lower floor); documents are
+     * preserved. Rule B (selfie > 1 MB → faces first), Rule A (documents > 4 MB → back, front,
+     * faces last), else generic (faces first).
+     */
+    buildCompressionPlan(assets: CompressibleAssets): Array<[CompressibleAsset, number]>;
+    /**
+     * Compress `assets` in place until the bundle is guaranteed to ship. Steps: early-out → Rule A
+     * document sub-target → walk the global plan to the per-type floors → hard-guarantee pass that
+     * drops past the floors (down to `absoluteMinQ`) until the bundle fits both caps. Never throws;
+     * a job never fails submission purely on payload size.
+     */
+    prepareBundleForTransmission(assets: CompressibleAssets, metadataBytes: number): Promise<void>;
+    /** True while the bundle exceeds the relaxed raw ceiling or the projected encoded cap. */
+    _overRelaxedCap(assets: CompressibleAssets, metadataBytes: number): boolean;
+    /** Reduce each asset in `group` (order matters) toward `target` as measured by `measure`. */
+    _compressGroupToTarget(group: CompressibleAsset[], minQuality: number, target: number, measure: () => number): Promise<void>;
+};
+//# sourceMappingURL=payload_compressor.d.ts.map

package/dist/data/compression/payload_compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload_compressor.d.ts","sourceRoot":"","sources":["../../../src/data/compression/payload_compressor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iBAAiB,EACtB,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAM9B;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB;IAC5B,oFAAoF;0BAC9D,kBAAkB,iBAAiB,MAAM,GAAG,MAAM;IAOxE;;;;OAIG;iCAEO,kBAAkB,iBACX,MAAM,GACpB,MAAM;IAUT;;;;OAIG;iCAEO,kBAAkB,GACzB,KAAK,CAAC,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;IAwBrC;;;;;OAKG;yCAEO,kBAAkB,iBACX,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAoDhB,0FAA0F;4BAClE,kBAAkB,iBAAiB,MAAM,GAAG,OAAO;IAO3E,6FAA6F;kCAEpF,iBAAiB,EAAE,cACd,MAAM,UACV,MAAM,WACL,MAAM,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;CAUjB,CAAC"}

package/dist/data/compression/payload_compressor.js

@@ -0,0 +1,126 @@
+import { base64Len, PayloadCompressionConfig as C, } from "./payload_compression_config";
+/**
+ * Adaptive image-compression orchestrator that keeps a v3 submission under the Lambda payload
+ * cap. Pure decision logic over `CompressibleAssets` — the native JPEG encode + EXIF re-stamp
+ * lives behind `CompressibleAsset.recompress`.
+ *
+ * **Cross-SDK source of truth.** The size formulas, plan order, sub-rules, and loop here are
+ * mirrored byte-for-byte with the Android / iOS / Flutter SDKs. See `PayloadCompressionConfig`.
+ *
+ * Scope: image compression only. Metadata is **measured** (it counts toward the bundle and the
+ * projected encoded size) but never modified.
+ */
+export const PayloadCompressor = {
+    /** Raw bundle size: sum of current image bytes + serialized metadata JSON bytes. */
+    rawBundleSize(assets, metadataBytes) {
+        return (assets.all().reduce((sum, asset) => sum + asset.encodedSize(), 0) +
+            metadataBytes);
+    },
+    /**
+     * Projected size of the base64-encoded body API Gateway forwards to Lambda: images are
+     * base64-expanded, metadata JSON is counted raw, plus a fixed structural allowance. The real
+     * guardrail.
+     */
+    projectedEncodedSize(assets, metadataBytes) {
+        return (assets
+            .all()
+            .reduce((sum, asset) => sum + base64Len(asset.encodedSize()), 0) +
+            metadataBytes +
+            C.structuralOverheadBytes);
+    },
+    /**
+     * Ordered (asset, minQuality) plan. Faces take the higher penalty (lower floor); documents are
+     * preserved. Rule B (selfie > 1 MB → faces first), Rule A (documents > 4 MB → back, front,
+     * faces last), else generic (faces first).
+     */
+    buildCompressionPlan(assets) {
+        const plan = [];
+        const selfieSize = assets.selfie?.encodedSize() ?? 0;
+        const docCombined = assets.documentCombinedSize();
+        if (assets.selfie && selfieSize > C.selfieTrigger) {
+            plan.push([assets.selfie, C.faceMinQ]);
+            for (const frame of assets.liveness)
+                plan.push([frame, C.faceMinQ]);
+            if (assets.documentBack)
+                plan.push([assets.documentBack, C.docMinQ]);
+            if (assets.documentFront)
+                plan.push([assets.documentFront, C.docMinQ]);
+        }
+        else if (docCombined > C.docCombinedTrigger) {
+            if (assets.documentBack)
+                plan.push([assets.documentBack, C.docMinQ]);
+            if (assets.documentFront)
+                plan.push([assets.documentFront, C.docMinQ]);
+            if (assets.selfie)
+                plan.push([assets.selfie, C.faceMinQ]);
+            for (const frame of assets.liveness)
+                plan.push([frame, C.faceMinQ]);
+        }
+        else {
+            if (assets.selfie)
+                plan.push([assets.selfie, C.faceMinQ]);
+            for (const frame of assets.liveness)
+                plan.push([frame, C.faceMinQ]);
+            if (assets.documentBack)
+                plan.push([assets.documentBack, C.docMinQ]);
+            if (assets.documentFront)
+                plan.push([assets.documentFront, C.docMinQ]);
+        }
+        return plan;
+    },
+    /**
+     * Compress `assets` in place until the bundle is guaranteed to ship. Steps: early-out → Rule A
+     * document sub-target → walk the global plan to the per-type floors → hard-guarantee pass that
+     * drops past the floors (down to `absoluteMinQ`) until the bundle fits both caps. Never throws;
+     * a job never fails submission purely on payload size.
+     */
+    async prepareBundleForTransmission(assets, metadataBytes) {
+        // Step 0: already within both guardrails.
+        if (this.projectedEncodedSize(assets, metadataBytes) <= C.hardEncodedCap &&
+            this.rawBundleSize(assets, metadataBytes) <= C.rawTarget) {
+            return;
+        }
+        // Step 1 (Rule A): pull the documents under the combined sub-target first (back, then front).
+        if (assets.documentCombinedSize() > C.docCombinedTrigger) {
+            const group = [assets.documentBack, assets.documentFront].filter((a) => a !== undefined);
+            await this._compressGroupToTarget(group, C.docMinQ, C.docCombinedTarget, () => assets.documentCombinedSize());
+        }
+        // Step 2: walk the global plan, re-measuring after each decrement, down to the per-type floors.
+        for (const [asset, minQuality] of this.buildCompressionPlan(assets)) {
+            while (this.rawBundleSize(assets, metadataBytes) > C.rawTarget &&
+                asset.quality() > minQuality) {
+                await asset.recompress(Math.max(minQuality, asset.quality() - C.qualityStep));
+            }
+            if (this.rawBundleSize(assets, metadataBytes) <= C.rawTarget)
+                return;
+        }
+        // Step 3 (hard guarantee): if the bundle is still over the relaxed raw ceiling or the encoded
+        // cap after every image hit its per-type floor, keep stepping quality down past the floors to
+        // `absoluteMinQ` — faces first per the plan order — so the bundle always ships under the cap
+        // regardless of any per-type quality floor.
+        for (const [asset] of this.buildCompressionPlan(assets)) {
+            while (this._overRelaxedCap(assets, metadataBytes) &&
+                asset.quality() > C.absoluteMinQ) {
+                await asset.recompress(Math.max(C.absoluteMinQ, asset.quality() - C.qualityStep));
+            }
+            if (!this._overRelaxedCap(assets, metadataBytes))
+                return;
+        }
+    },
+    /** True while the bundle exceeds the relaxed raw ceiling or the projected encoded cap. */
+    _overRelaxedCap(assets, metadataBytes) {
+        return (this.rawBundleSize(assets, metadataBytes) > C.rawFallback ||
+            this.projectedEncodedSize(assets, metadataBytes) > C.hardEncodedCap);
+    },
+    /** Reduce each asset in `group` (order matters) toward `target` as measured by `measure`. */
+    async _compressGroupToTarget(group, minQuality, target, measure) {
+        for (const asset of group) {
+            while (measure() > target && asset.quality() > minQuality) {
+                await asset.recompress(Math.max(minQuality, asset.quality() - C.qualityStep));
+            }
+            if (measure() <= target)
+                return;
+        }
+    },
+};
+//# sourceMappingURL=payload_compressor.js.map

package/dist/data/compression/payload_compressor.js.map

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

package/dist/data/compression/uri_compressible_asset.d.ts

@@ -0,0 +1,23 @@
+import type { ImageTypeId } from "@smileid/usesmileid_bridge";
+import type { CompressibleAsset } from "./compressible_asset";
+/**
+ * `CompressibleAsset` backed by a captured JPEG at `uri`.
+ *
+ * The re-encode is **native** (`expo-image-manipulator`, per the spec's "do not reimplement
+ * compression in JS" rule), and the Smile EXIF `image_digest` re-stamp is **native**
+ * (`SmileExifTagger.finalize`). The original bytes are preserved once on the first `recompress`
+ * so every step re-encodes from source (no generational stacking; deterministic retries).
+ */
+export declare class UriCompressibleAsset implements CompressibleAsset {
+    readonly imageType: ImageTypeId;
+    private readonly uri;
+    private _quality;
+    private _size;
+    private _sourceUri;
+    constructor(imageType: ImageTypeId, uri: string, captureQuality: number);
+    encodedSize(): number;
+    quality(): number;
+    recompress(quality: number): Promise<void>;
+    private static _fileSize;
+}
+//# sourceMappingURL=uri_compressible_asset.d.ts.map

package/dist/data/compression/uri_compressible_asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri_compressible_asset.d.ts","sourceRoot":"","sources":["../../../src/data/compression/uri_compressible_asset.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,iBAAiB;IAM1D,QAAQ,CAAC,SAAS,EAAE,WAAW;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG;IANtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAqB;gBAG5B,SAAS,EAAE,WAAW,EACd,GAAG,EAAE,MAAM,EAC5B,cAAc,EAAE,MAAM;IAMxB,WAAW,IAAI,MAAM;IAIrB,OAAO,IAAI,MAAM;IAIX,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuChD,OAAO,CAAC,MAAM,CAAC,SAAS;CAOzB"}

package/dist/data/compression/uri_compressible_asset.js

@@ -0,0 +1,77 @@
+import { File } from "expo-file-system";
+import { ImageManipulator, SaveFormat } from "expo-image-manipulator";
+// SmileExifTagger is SDK-internal (not on the public barrel) — deep import, matching the capture screen.
+import { SmileExifTagger } from "@smileid/usesmileid_bridge/src/exif/smile_exif_tagger";
+/**
+ * `CompressibleAsset` backed by a captured JPEG at `uri`.
+ *
+ * The re-encode is **native** (`expo-image-manipulator`, per the spec's "do not reimplement
+ * compression in JS" rule), and the Smile EXIF `image_digest` re-stamp is **native**
+ * (`SmileExifTagger.finalize`). The original bytes are preserved once on the first `recompress`
+ * so every step re-encodes from source (no generational stacking; deterministic retries).
+ */
+export class UriCompressibleAsset {
+    imageType;
+    uri;
+    _quality;
+    _size;
+    _sourceUri;
+    constructor(imageType, uri, captureQuality) {
+        this.imageType = imageType;
+        this.uri = uri;
+        this._quality = Math.min(Math.max(captureQuality, 0), 1);
+        this._size = UriCompressibleAsset._fileSize(uri);
+    }
+    encodedSize() {
+        return this._size;
+    }
+    quality() {
+        return this._quality;
+    }
+    async recompress(quality) {
+        const target = new File(this.uri);
+        if (!target.exists)
+            return;
+        // Preserve the source once so each step re-encodes from the original (no generational loss).
+        if (this._sourceUri === undefined) {
+            const originalUri = `${this.uri}.orig`;
+            try {
+                target.copy(new File(originalUri));
+                this._sourceUri = originalUri;
+            }
+            catch {
+                // Copy failed — fall back to re-encoding in place (still functional, mild generational loss).
+                this._sourceUri = this.uri;
+            }
+        }
+        const clamped = Math.min(Math.max(quality, 0), 1);
+        const context = ImageManipulator.manipulate(this._sourceUri);
+        const rendered = await context.renderAsync();
+        const result = await rendered.saveAsync({
+            compress: clamped,
+            format: SaveFormat.JPEG,
+        });
+        // Overwrite the request's path with the re-encoded bytes.
+        try {
+            if (target.exists)
+                target.delete();
+            new File(result.uri).move(target);
+        }
+        catch {
+            // Move failed — leave the request pointing at its original path; best effort.
+        }
+        // Re-stamp the Smile EXIF image_digest over the new bytes (native; context set at capture).
+        await SmileExifTagger.finalize(this.uri, this.imageType);
+        this._quality = quality;
+        this._size = UriCompressibleAsset._fileSize(this.uri);
+    }
+    static _fileSize(uri) {
+        try {
+            return new File(uri).size ?? 0;
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+//# sourceMappingURL=uri_compressible_asset.js.map

package/dist/data/compression/uri_compressible_asset.js.map

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

package/dist/data/dsl/builder/cache_config_builder.d.ts

@@ -6,8 +6,9 @@ import type { CacheConfig } from "../../../core/models/network_config";
  * verification flows without aggressive trimming.
  */
 export declare class CacheConfigBuilder {
+    /** Whether HTTP response caching is on. */
     enabled: boolean;
-    /** Bytes — default 50 MB. */
+    /** Maximum on-disk cache size, in bytes. Default 50 MB. */
     maxSize: number;
     /**
      * Multiplier helper: `c.megabytes(50)` evaluates to `50 * 1024 * 1024`

package/dist/data/dsl/builder/cache_config_builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache_config_builder.d.ts","sourceRoot":"","sources":["../../../../src/data/dsl/builder/cache_config_builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAEvE;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,UAAQ;IACf,6BAA6B;IAC7B,OAAO,SAAoB;IAE3B;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC,KAAK,IAAI,WAAW;CAGrB"}
+{"version":3,"file":"cache_config_builder.d.ts","sourceRoot":"","sources":["../../../../src/data/dsl/builder/cache_config_builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAEvE;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,2CAA2C;IAC3C,OAAO,UAAQ;IAEf,2DAA2D;IAC3D,OAAO,SAAoB;IAE3B;;;;OAIG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIhC,KAAK,IAAI,WAAW;CAGrB"}

package/dist/data/dsl/builder/cache_config_builder.js

@@ -5,8 +5,9 @@
  * verification flows without aggressive trimming.
  */
 export class CacheConfigBuilder {
+    /** Whether HTTP response caching is on. */
     enabled = true;
-    /** Bytes — default 50 MB. */
+    /** Maximum on-disk cache size, in bytes. Default 50 MB. */
     maxSize = 50 * 1024 * 1024;
     /**
      * Multiplier helper: `c.megabytes(50)` evaluates to `50 * 1024 * 1024`

package/dist/data/dsl/builder/cache_config_builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache_config_builder.js","sourceRoot":"","sources":["../../../../src/data/dsl/builder/cache_config_builder.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAC7B,OAAO,GAAG,IAAI,CAAC;IACf,6BAA6B;IAC7B,OAAO,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,SAAS,CAAC,KAAa;QACrB,OAAO,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF"}
+{"version":3,"file":"cache_config_builder.js","sourceRoot":"","sources":["../../../../src/data/dsl/builder/cache_config_builder.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAC7B,2CAA2C;IAC3C,OAAO,GAAG,IAAI,CAAC;IAEf,2DAA2D;IAC3D,OAAO,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;IAE3B;;;;OAIG;IACH,SAAS,CAAC,KAAa;QACrB,OAAO,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/data/dsl/builder/config_builder.d.ts

@@ -12,13 +12,22 @@ import { LogLevel, type NetworkInnerConfig, type NetworkLoggingConfig, type Part
  * identity.
  */
 export declare class PartnerConfigBuilder {
+    /** Your Smile ID partner id. Required. */
     partnerId: string;
+    /**
+     * Optional webhook URL Smile ID calls with the job result. It is also
+     * sent as a per-request identity header.
+     */
     callbackUrl: string;
+    /**
+     * When true, routes requests to the sandbox environment instead of
+     * production. Defaults to false.
+     */
     useSandbox: boolean;
     /**
-     * Optional partner-supplied key/value metadata. Forwarded onto the
-     * `partner_params` JSON multipart form part on Enhanced / Biometric
-     * KYC submissions when set.
+     * Optional free-form key/value pairs echoed back on the job result for
+     * your own correlation. Forwarded onto the `partner_params` JSON
+     * multipart form part on Enhanced / Biometric KYC submissions when set.
      */
     partnerParams?: Record<string, string>;
     build(): PartnerConfig;
@@ -32,8 +41,14 @@ export declare class PartnerConfigBuilder {
  * redaction list with their own proxy-injected headers.
  */
 export declare class LoggingConfigBuilder {
+    /** Whether HTTP request/response logging is on. */
     enabled: boolean;
+    /** Logging verbosity: none, basic, headers, or full body. */
     level: LogLevel;
+    /**
+     * Header names whose values are masked in logs (for example
+     * authorization headers).
+     */
     redactHeaders: readonly string[];
     build(): NetworkLoggingConfig;
 }
@@ -50,27 +65,38 @@ export declare class LoggingConfigBuilder {
  * omit blocks they don't need.
  */
 export declare class ConfigBuilder {
+    /**
+     * The verification job this flow submits (for example smart-selfie
+     * enrollment, biometric KYC, or document verification). Required.
+     */
     jobType?: JobType;
     /**
-     * Short-lived v3 auth token issued by `/v3/token`. The partner
-     * application is responsible for exchanging its API key for a token
-     * before invoking the SDK and supplying the result here. Stamped as
-     * the `smileid-token` HTTP header on every authenticated request.
+     * The short-lived authentication token for this session. Your backend
+     * obtains it from Smile ID's `/v3/token` endpoint using your API key;
+     * the SDK never exchanges credentials itself. Stamped as the
+     * `smileid-token` HTTP header on every authenticated request.
      */
     token: string;
     /**
-     * Optional async refresh callback invoked when the server responds
-     * with `401 Unauthorized`. The callback receives the token the SDK
-     * was using and returns a fresh token; the SDK then retries the
-     * original request once with the new value. Concurrent 401s collapse
-     * to a single callback invocation via the SDK's shared `TokenHolder`.
-     * If the callback throws or the retry also returns 401, the original
-     * 401 response is surfaced unchanged.
+     * Optional async callback invoked when the server rejects the token
+     * with a 401. Return a fresh token and the SDK retries the request
+     * once with it. The callback receives the token the SDK was using.
+     * Concurrent 401s collapse to a single callback invocation via the
+     * SDK's shared `TokenHolder`. If the callback throws or the retry also
+     * returns 401, the original 401 response is surfaced unchanged.
      */
     onTokenExpired?: (previousToken: string) => Promise<string>;
     private _partnerConfig?;
     private _logging?;
+    /**
+     * Configures partner identity and per-job environment settings —
+     * partner id, callback URL, sandbox mode, and partner params.
+     */
     partnerConfig(block: (p: PartnerConfigBuilder) => void): void;
+    /**
+     * Configures HTTP request/response logging: on/off, verbosity, and
+     * redacted headers.
+     */
     logging(block: (l: LoggingConfigBuilder) => void): void;
     build(): NetworkInnerConfig;
 }

package/dist/data/dsl/builder/config_builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config_builder.d.ts","sourceRoot":"","sources":["../../../../src/data/dsl/builder/config_builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EACL,QAAQ,EACR,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,qBAAa,oBAAoB;IAC/B,SAAS,SAAM;IACf,WAAW,SAAM;IACjB,UAAU,UAAS;IACnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC,KAAK,IAAI,aAAa;CAUvB;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,UAAQ;IACf,KAAK,EAAE,QAAQ,CAAkB;IACjC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAM;IAEtC,KAAK,IAAI,oBAAoB;CAO9B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,KAAK,SAAM;IAEX;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5D,OAAO,CAAC,cAAc,CAAC,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,CAAuB;IAExC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI;IAK7D,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI;IAKvD,KAAK,IAAI,kBAAkB;CAa5B"}
+{"version":3,"file":"config_builder.d.ts","sourceRoot":"","sources":["../../../../src/data/dsl/builder/config_builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EACL,QAAQ,EACR,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EACnB,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,qBAAa,oBAAoB;IAC/B,0CAA0C;IAC1C,SAAS,SAAM;IAEf;;;OAGG;IACH,WAAW,SAAM;IAEjB;;;OAGG;IACH,UAAU,UAAS;IAEnB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC,KAAK,IAAI,aAAa;CAUvB;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAoB;IAC/B,mDAAmD;IACnD,OAAO,UAAQ;IAEf,6DAA6D;IAC7D,KAAK,EAAE,QAAQ,CAAkB;IAEjC;;;OAGG;IACH,aAAa,EAAE,SAAS,MAAM,EAAE,CAAM;IAEtC,KAAK,IAAI,oBAAoB;CAO9B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;OAKG;IACH,KAAK,SAAM;IAEX;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAE5D,OAAO,CAAC,cAAc,CAAC,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,CAAuB;IAExC;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI;IAK7D;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI;IAKvD,KAAK,IAAI,kBAAkB;CAa5B"}