@smileid/usesmileid 12.0.0-beta01 → 12.0.1

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"}

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

@@ -11,13 +11,22 @@ import { LogLevel, } from "../../../core/models/network_config";
  * identity.
  */
 export class PartnerConfigBuilder {
+    /** Your Smile ID partner id. Required. */
     partnerId = "";
+    /**
+     * Optional webhook URL Smile ID calls with the job result. It is also
+     * sent as a per-request identity header.
+     */
     callbackUrl = "";
+    /**
+     * When true, routes requests to the sandbox environment instead of
+     * production. Defaults to false.
+     */
     useSandbox = false;
     /**
-     * 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;
     build() {
@@ -40,8 +49,14 @@ export class PartnerConfigBuilder {
  * redaction list with their own proxy-injected headers.
  */
 export class LoggingConfigBuilder {
+    /** Whether HTTP request/response logging is on. */
     enabled = true;
+    /** Logging verbosity: none, basic, headers, or full body. */
     level = LogLevel.basic;
+    /**
+     * Header names whose values are masked in logs (for example
+     * authorization headers).
+     */
     redactHeaders = [];
     build() {
         return Object.freeze({
@@ -64,31 +79,42 @@ export class LoggingConfigBuilder {
  * omit blocks they don't need.
  */
 export class ConfigBuilder {
+    /**
+     * The verification job this flow submits (for example smart-selfie
+     * enrollment, biometric KYC, or document verification). Required.
+     */
     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 = "";
     /**
-     * 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;
     _partnerConfig;
     _logging;
+    /**
+     * Configures partner identity and per-job environment settings —
+     * partner id, callback URL, sandbox mode, and partner params.
+     */
     partnerConfig(block) {
         if (!this._partnerConfig)
             this._partnerConfig = new PartnerConfigBuilder();
         block(this._partnerConfig);
     }
+    /**
+     * Configures HTTP request/response logging: on/off, verbosity, and
+     * redacted headers.
+     */
     logging(block) {
         if (!this._logging)
             this._logging = new LoggingConfigBuilder();

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

@@ -1 +1 @@
-{"version":3,"file":"config_builder.js","sourceRoot":"","sources":["../../../../src/data/dsl/builder/config_builder.ts"],"names":[],"mappings":"AACA,OAAO,EACL,QAAQ,GAIT,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;GAUG;AACH,MAAM,OAAO,oBAAoB;IAC/B,SAAS,GAAG,EAAE,CAAC;IACf,WAAW,GAAG,EAAE,CAAC;IACjB,UAAU,GAAG,KAAK,CAAC;IACnB;;;;OAIG;IACH,aAAa,CAA0B;IAEvC,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS;gBAClC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE;gBAC7D,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAoB;IAC/B,OAAO,GAAG,IAAI,CAAC;IACf,KAAK,GAAa,QAAQ,CAAC,KAAK,CAAC;IACjC,aAAa,GAAsB,EAAE,CAAC;IAEtC,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC;SACtD,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,aAAa;IACxB,OAAO,CAAW;IAElB;;;;;OAKG;IACH,KAAK,GAAG,EAAE,CAAC;IAEX;;;;;;;;OAQG;IACH,cAAc,CAA8C;IAEpD,cAAc,CAAwB;IACtC,QAAQ,CAAwB;IAExC,aAAa,CAAC,KAAwC;QACpD,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,IAAI,CAAC,cAAc,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,KAAwC;QAC9C,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAED,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,IAAI,CAAC,cAAc,KAAK,SAAS;gBACnC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE;gBACzC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,cAAc;gBACrB,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE;gBAChD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"config_builder.js","sourceRoot":"","sources":["../../../../src/data/dsl/builder/config_builder.ts"],"names":[],"mappings":"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"}

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

@@ -19,18 +19,20 @@ import { LogLevel, type Interceptor } from "../../../core/models/network_config"
  */
 export declare class InterceptorConfigBuilder {
     private _interceptors;
+    /** Appends a custom interceptor to the chain. */
     add(interceptor: Interceptor): void;
     /**
-     * Returns an interceptor that stamps `Accept-Encoding: gzip` on
-     * every outbound request. Hint-only — the SDK does not pull in a
-     * JS gzip dependency to compress request bodies. See
-     * [createGzipInterceptor] for the rationale.
+     * Adds the gzip interceptor, which requests compressed responses by
+     * stamping `Accept-Encoding: gzip` on every outbound request.
+     * Hint-only — the SDK does not pull in a JS gzip dependency to
+     * compress request bodies. See [createGzipInterceptor] for the
+     * rationale.
      */
     gzip(): Interceptor;
     /**
-     * Returns a logging interceptor configured by `configure`. The
-     * partner block mutates a `LoggingInterceptorBuilder` carrying
-     * `level` and `redactHeaders`.
+     * Adds the logging interceptor with the given verbosity. The partner
+     * block mutates a `LoggingInterceptorBuilder` carrying `level` and
+     * `redactHeaders`.
      */
     logging(configure?: (builder: LoggingInterceptorBuilder) => void): Interceptor;
     build(): readonly Interceptor[];

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

@@ -1 +1 @@
-{"version":3,"file":"interceptor_config_builder.d.ts","sourceRoot":"","sources":["../../../../src/data/dsl/builder/interceptor_config_builder.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,QAAQ,EACR,KAAK,WAAW,EAEjB,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,aAAa,CAAqB;IAE1C,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAInC;;;;;OAKG;IACH,IAAI,IAAI,WAAW;IAInB;;;;OAIG;IACH,OAAO,CACL,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,GACvD,WAAW;IAiBd,KAAK,IAAI,SAAS,WAAW,EAAE;CAGhC;AAED;;GAEG;AACH,qBAAa,yBAAyB;IACpC,OAAO,UAAQ;IACf,KAAK,EAAE,QAAQ,CAAkB;IACjC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAM;CACvC"}
+{"version":3,"file":"interceptor_config_builder.d.ts","sourceRoot":"","sources":["../../../../src/data/dsl/builder/interceptor_config_builder.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,QAAQ,EACR,KAAK,WAAW,EAEjB,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,aAAa,CAAqB;IAE1C,iDAAiD;IACjD,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IAInC;;;;;;OAMG;IACH,IAAI,IAAI,WAAW;IAInB;;;;OAIG;IACH,OAAO,CACL,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,yBAAyB,KAAK,IAAI,GACvD,WAAW;IAiBd,KAAK,IAAI,SAAS,WAAW,EAAE;CAGhC;AAED;;GAEG;AACH,qBAAa,yBAAyB;IACpC,OAAO,UAAQ;IACf,KAAK,EAAE,QAAQ,CAAkB;IACjC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAM;CACvC"}

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

@@ -21,22 +21,24 @@ import { LogLevel, } from "../../../core/models/network_config";
  */
 export class InterceptorConfigBuilder {
     _interceptors = [];
+    /** Appends a custom interceptor to the chain. */
     add(interceptor) {
         this._interceptors.push(interceptor);
     }
     /**
-     * Returns an interceptor that stamps `Accept-Encoding: gzip` on
-     * every outbound request. Hint-only — the SDK does not pull in a
-     * JS gzip dependency to compress request bodies. See
-     * [createGzipInterceptor] for the rationale.
+     * Adds the gzip interceptor, which requests compressed responses by
+     * stamping `Accept-Encoding: gzip` on every outbound request.
+     * Hint-only — the SDK does not pull in a JS gzip dependency to
+     * compress request bodies. See [createGzipInterceptor] for the
+     * rationale.
      */
     gzip() {
         return createGzipInterceptor();
     }
     /**
-     * Returns a logging interceptor configured by `configure`. The
-     * partner block mutates a `LoggingInterceptorBuilder` carrying
-     * `level` and `redactHeaders`.
+     * Adds the logging interceptor with the given verbosity. The partner
+     * block mutates a `LoggingInterceptorBuilder` carrying `level` and
+     * `redactHeaders`.
      */
     logging(configure) {
         const builder = new LoggingInterceptorBuilder();

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

@@ -1 +1 @@
-{"version":3,"file":"interceptor_config_builder.js","sourceRoot":"","sources":["../../../../src/data/dsl/builder/interceptor_config_builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EACL,QAAQ,GAGT,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,wBAAwB;IAC3B,aAAa,GAAkB,EAAE,CAAC;IAE1C,GAAG,CAAC,WAAwB;QAC1B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,IAAI;QACF,OAAO,qBAAqB,EAAE,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,OAAO,CACL,SAAwD;QAExD,MAAM,OAAO,GAAG,IAAI,yBAAyB,EAAE,CAAC;QAChD,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QACD,MAAM,aAAa,GAAyB,MAAM,CAAC,MAAM,CAAC;YACxD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;SACzD,CAAC,CAAC;QACH,OAAO;YACL,MAAM,CAAC,MAAqB;gBAC1B,wBAAwB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YAClD,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAChD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC,OAAO,GAAG,IAAI,CAAC;IACf,KAAK,GAAa,QAAQ,CAAC,KAAK,CAAC;IACjC,aAAa,GAAsB,EAAE,CAAC;CACvC"}
+{"version":3,"file":"interceptor_config_builder.js","sourceRoot":"","sources":["../../../../src/data/dsl/builder/interceptor_config_builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EACL,QAAQ,GAGT,MAAM,qCAAqC,CAAC;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,wBAAwB;IAC3B,aAAa,GAAkB,EAAE,CAAC;IAE1C,iDAAiD;IACjD,GAAG,CAAC,WAAwB;QAC1B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;OAMG;IACH,IAAI;QACF,OAAO,qBAAqB,EAAE,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,OAAO,CACL,SAAwD;QAExD,MAAM,OAAO,GAAG,IAAI,yBAAyB,EAAE,CAAC;QAChD,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QACD,MAAM,aAAa,GAAyB,MAAM,CAAC,MAAM,CAAC;YACxD,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;SACzD,CAAC,CAAC;QACH,OAAO;YACL,MAAM,CAAC,MAAqB;gBAC1B,wBAAwB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YAClD,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAChD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC,OAAO,GAAG,IAAI,CAAC;IACf,KAAK,GAAa,QAAQ,CAAC,KAAK,CAAC;IACjC,aAAa,GAAsB,EAAE,CAAC;CACvC"}

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

@@ -3,18 +3,33 @@ export { RetryStrategy };
 /**
  * DSL builder for request retry behaviour.
  *
- * Defaults to exponential backoff with 3 attempts, 1 s initial delay,
- * 32 s ceiling, ±20% jitter. `fixedDelay` is honoured only when
- * `strategy = RetryStrategy.fixed`.
+ * Defaults to no retry. Set `strategy` to opt in, and the remaining fields
+ * then apply: 3 attempts, 1 s initial delay, 32 s ceiling, ±20% jitter.
+ * `fixedDelay` is honoured only when `strategy = RetryStrategy.fixed`.
  */
 export declare class RetryConfigBuilder {
+    /** Attempts per request including the first; applies once `strategy` opts in. */
     maxAttempts: number;
+    /** Backoff strategy between attempts: exponential, fixed, or none. */
     strategy: RetryStrategy;
+    /** Delay before the first retry, in seconds (exponential strategy). */
     initialDelay: number;
+    /**
+     * Factor by which the delay grows after each attempt (exponential
+     * strategy).
+     */
     multiplier: number;
+    /**
+     * Upper bound on the delay between attempts, in seconds (exponential
+     * strategy).
+     */
     maxDelay: number;
-    /** ±20% randomized jitter on the computed delay, in [0, 1]. */
+    /**
+     * Random fraction between 0 and 1 added to each delay to avoid
+     * synchronized retry storms.
+     */
     jitter: number;
+    /** Constant delay between attempts, in seconds (fixed strategy). */
     fixedDelay: number;
     build(): RetryConfig;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"retry_config_builder.d.ts","sourceRoot":"","sources":["../../../../src/data/dsl/builder/retry_config_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EACjB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,WAAW,SAAK;IAChB,QAAQ,EAAE,aAAa,CAA6B;IACpD,YAAY,SAAK;IACjB,UAAU,SAAK;IACf,QAAQ,SAAM;IACd,+DAA+D;IAC/D,MAAM,SAAO;IACb,UAAU,SAAK;IAEf,KAAK,IAAI,WAAW;CAWrB"}
+{"version":3,"file":"retry_config_builder.d.ts","sourceRoot":"","sources":["../../../../src/data/dsl/builder/retry_config_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EACjB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAC7B,iFAAiF;IACjF,WAAW,SAAK;IAEhB,sEAAsE;IACtE,QAAQ,EAAE,aAAa,CAAsB;IAE7C,uEAAuE;IACvE,YAAY,SAAK;IAEjB;;;OAGG;IACH,UAAU,SAAK;IAEf;;;OAGG;IACH,QAAQ,SAAM;IAEd;;;OAGG;IACH,MAAM,SAAO;IAEb,oEAAoE;IACpE,UAAU,SAAK;IAEf,KAAK,IAAI,WAAW;CAWrB"}