@smileid/usesmileid 12.0.0-beta01 → 12.0.0

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

@@ -8,13 +8,28 @@ export { RetryStrategy };
  * `strategy = RetryStrategy.fixed`.
  */
 export declare class RetryConfigBuilder {
+    /** Maximum number of attempts per request, including the first. */
     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,mEAAmE;IACnE,WAAW,SAAK;IAEhB,sEAAsE;IACtE,QAAQ,EAAE,aAAa,CAA6B;IAEpD,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"}

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

@@ -8,13 +8,28 @@ export { RetryStrategy };
  * `strategy = RetryStrategy.fixed`.
  */
 export class RetryConfigBuilder {
+    /** Maximum number of attempts per request, including the first. */
     maxAttempts = 3;
+    /** Backoff strategy between attempts: exponential, fixed, or none. */
     strategy = RetryStrategy.exponential;
+    /** Delay before the first retry, in seconds (exponential strategy). */
     initialDelay = 1;
+    /**
+     * Factor by which the delay grows after each attempt (exponential
+     * strategy).
+     */
     multiplier = 2;
+    /**
+     * Upper bound on the delay between attempts, in seconds (exponential
+     * strategy).
+     */
     maxDelay = 32;
-    /** ±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 = 0.2;
+    /** Constant delay between attempts, in seconds (fixed strategy). */
     fixedDelay = 1;
     build() {
         return Object.freeze({

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

@@ -1 +1 @@
-{"version":3,"file":"retry_config_builder.js","sourceRoot":"","sources":["../../../../src/data/dsl/builder/retry_config_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAEd,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IAC7B,WAAW,GAAG,CAAC,CAAC;IAChB,QAAQ,GAAkB,aAAa,CAAC,WAAW,CAAC;IACpD,YAAY,GAAG,CAAC,CAAC;IACjB,UAAU,GAAG,CAAC,CAAC;IACf,QAAQ,GAAG,EAAE,CAAC;IACd,+DAA+D;IAC/D,MAAM,GAAG,GAAG,CAAC;IACb,UAAU,GAAG,CAAC,CAAC;IAEf,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"retry_config_builder.js","sourceRoot":"","sources":["../../../../src/data/dsl/builder/retry_config_builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAEd,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;;;;GAMG;AACH,MAAM,OAAO,kBAAkB;IAC7B,mEAAmE;IACnE,WAAW,GAAG,CAAC,CAAC;IAEhB,sEAAsE;IACtE,QAAQ,GAAkB,aAAa,CAAC,WAAW,CAAC;IAEpD,uEAAuE;IACvE,YAAY,GAAG,CAAC,CAAC;IAEjB;;;OAGG;IACH,UAAU,GAAG,CAAC,CAAC;IAEf;;;OAGG;IACH,QAAQ,GAAG,EAAE,CAAC;IAEd;;;OAGG;IACH,MAAM,GAAG,GAAG,CAAC;IAEb,oEAAoE;IACpE,UAAU,GAAG,CAAC,CAAC;IAEf,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -7,9 +7,13 @@ import type { TimeoutConfig } from "../../../core/models/network_config";
  * the end-to-end ceiling for the whole request including retries.
  */
 export declare class TimeoutConfigBuilder {
+    /** Maximum time to establish a connection, in seconds. */
     connect: number;
+    /** Maximum time to wait for response data, in seconds. */
     read: number;
+    /** Maximum time to send request data, in seconds. */
     write: number;
+    /** Maximum total time for the entire request, in seconds. */
     call: number;
     build(): TimeoutConfig;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"timeout_config_builder.d.ts","sourceRoot":"","sources":["../../../../src/data/dsl/builder/timeout_config_builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,SAAM;IACb,IAAI,SAAM;IACV,KAAK,SAAM;IACX,IAAI,SAAO;IAEX,KAAK,IAAI,aAAa;CAQvB"}
+{"version":3,"file":"timeout_config_builder.d.ts","sourceRoot":"","sources":["../../../../src/data/dsl/builder/timeout_config_builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAC/B,0DAA0D;IAC1D,OAAO,SAAM;IAEb,0DAA0D;IAC1D,IAAI,SAAM;IAEV,qDAAqD;IACrD,KAAK,SAAM;IAEX,6DAA6D;IAC7D,IAAI,SAAO;IAEX,KAAK,IAAI,aAAa;CAQvB"}

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

@@ -6,9 +6,13 @@
  * the end-to-end ceiling for the whole request including retries.
  */
 export class TimeoutConfigBuilder {
+    /** Maximum time to establish a connection, in seconds. */
     connect = 60;
+    /** Maximum time to wait for response data, in seconds. */
     read = 60;
+    /** Maximum time to send request data, in seconds. */
     write = 60;
+    /** Maximum total time for the entire request, in seconds. */
     call = 120;
     build() {
         return Object.freeze({

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

@@ -1 +1 @@
-{"version":3,"file":"timeout_config_builder.js","sourceRoot":"","sources":["../../../../src/data/dsl/builder/timeout_config_builder.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAC/B,OAAO,GAAG,EAAE,CAAC;IACb,IAAI,GAAG,EAAE,CAAC;IACV,KAAK,GAAG,EAAE,CAAC;IACX,IAAI,GAAG,GAAG,CAAC;IAEX,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"timeout_config_builder.js","sourceRoot":"","sources":["../../../../src/data/dsl/builder/timeout_config_builder.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAC/B,0DAA0D;IAC1D,OAAO,GAAG,EAAE,CAAC;IAEb,0DAA0D;IAC1D,IAAI,GAAG,EAAE,CAAC;IAEV,qDAAqD;IACrD,KAAK,GAAG,EAAE,CAAC;IAEX,6DAA6D;IAC7D,IAAI,GAAG,GAAG,CAAC;IAEX,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/data/dsl/use_smile_id_network_builder.d.ts

@@ -27,10 +27,27 @@ export declare class UseSmileIDNetworkBuilder {
     private _cache?;
     private _retry?;
     private _interceptors?;
+    /**
+     * Configures the job type, authentication token, token-refresh
+     * callback, and partner identity for this flow.
+     */
     config(block: (c: ConfigBuilder) => void): void;
+    /**
+     * Configures per-phase HTTP timeouts — connect, read, write, and
+     * overall call — in seconds.
+     */
     timeouts(block: (t: TimeoutConfigBuilder) => void): void;
+    /** Configures the HTTP response cache (on/off and maximum size). */
     cache(block: (c: CacheConfigBuilder) => void): void;
+    /**
+     * Configures automatic retry of failed requests: strategy, attempt
+     * count, and backoff.
+     */
     retry(block: (r: RetryConfigBuilder) => void): void;
+    /**
+     * Registers additional request/response interceptors, appended to the
+     * SDK's interceptor chain.
+     */
     interceptors(block: (i: InterceptorConfigBuilder) => void): void;
     build(): NetworkConfig;
 }

package/dist/data/dsl/use_smile_id_network_builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use_smile_id_network_builder.d.ts","sourceRoot":"","sources":["../../../src/data/dsl/use_smile_id_network_builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAC,CAAuB;IACzC,OAAO,CAAC,MAAM,CAAC,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAC,CAAqB;IACpC,OAAO,CAAC,aAAa,CAAC,CAA2B;IAEjD,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAK/C,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI;IAKxD,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAKnD,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAKnD,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,wBAAwB,KAAK,IAAI,GAAG,IAAI;IAMhE,KAAK,IAAI,aAAa;CAWvB"}
+{"version":3,"file":"use_smile_id_network_builder.d.ts","sourceRoot":"","sources":["../../../src/data/dsl/use_smile_id_network_builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,SAAS,CAAC,CAAuB;IACzC,OAAO,CAAC,MAAM,CAAC,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAC,CAAqB;IACpC,OAAO,CAAC,aAAa,CAAC,CAA2B;IAEjD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAK/C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI;IAKxD,oEAAoE;IACpE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAKnD;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAKnD;;;OAGG;IACH,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,wBAAwB,KAAK,IAAI,GAAG,IAAI;IAMhE,KAAK,IAAI,aAAa;CAWvB"}

package/dist/data/dsl/use_smile_id_network_builder.js

@@ -26,26 +26,43 @@ export class UseSmileIDNetworkBuilder {
     _cache;
     _retry;
     _interceptors;
+    /**
+     * Configures the job type, authentication token, token-refresh
+     * callback, and partner identity for this flow.
+     */
     config(block) {
         if (!this._config)
             this._config = new ConfigBuilder();
         block(this._config);
     }
+    /**
+     * Configures per-phase HTTP timeouts — connect, read, write, and
+     * overall call — in seconds.
+     */
     timeouts(block) {
         if (!this._timeouts)
             this._timeouts = new TimeoutConfigBuilder();
         block(this._timeouts);
     }
+    /** Configures the HTTP response cache (on/off and maximum size). */
     cache(block) {
         if (!this._cache)
             this._cache = new CacheConfigBuilder();
         block(this._cache);
     }
+    /**
+     * Configures automatic retry of failed requests: strategy, attempt
+     * count, and backoff.
+     */
     retry(block) {
         if (!this._retry)
             this._retry = new RetryConfigBuilder();
         block(this._retry);
     }
+    /**
+     * Registers additional request/response interceptors, appended to the
+     * SDK's interceptor chain.
+     */
     interceptors(block) {
         if (!this._interceptors)
             this._interceptors = new InterceptorConfigBuilder();

package/dist/data/dsl/use_smile_id_network_builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"use_smile_id_network_builder.js","sourceRoot":"","sources":["../../../src/data/dsl/use_smile_id_network_builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,wBAAwB;IAC3B,OAAO,CAAiB;IACxB,SAAS,CAAwB;IACjC,MAAM,CAAsB;IAC5B,MAAM,CAAsB;IAC5B,aAAa,CAA4B;IAEjD,MAAM,CAAC,KAAiC;QACtC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED,QAAQ,CAAC,KAAwC;QAC/C,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,KAAsC;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAsC;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,YAAY,CAAC,KAA4C;QACvD,IAAI,CAAC,IAAI,CAAC,aAAa;YACrB,IAAI,CAAC,aAAa,GAAG,IAAI,wBAAwB,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,aAAa;gBACpB,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE;gBAC9C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"use_smile_id_network_builder.js","sourceRoot":"","sources":["../../../src/data/dsl/use_smile_id_network_builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,wBAAwB;IAC3B,OAAO,CAAiB;IACxB,SAAS,CAAwB;IACjC,MAAM,CAAsB;IAC5B,MAAM,CAAsB;IAC5B,aAAa,CAA4B;IAEjD;;;OAGG;IACH,MAAM,CAAC,KAAiC;QACtC,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAwC;QAC/C,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,KAAsC;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAsC;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAA4C;QACvD,IAAI,CAAC,IAAI,CAAC,aAAa;YACrB,IAAI,CAAC,aAAa,GAAG,IAAI,wBAAwB,EAAE,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,aAAa;gBACpB,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE;gBAC9C,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/data/factory/networking_factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"networking_factory.d.ts","sourceRoot":"","sources":["../../../src/data/factory/networking_factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EACL,UAAU,EAIX,MAAM,qBAAqB,CAAC;AAU7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EAGrB,aAAa,GAAE,MAAM,MAAoD,GACxE;IACD,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC,CAoHA"}
+{"version":3,"file":"networking_factory.d.ts","sourceRoot":"","sources":["../../../src/data/factory/networking_factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EACL,UAAU,EAIX,MAAM,qBAAqB,CAAC;AAY7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EAGrB,aAAa,GAAE,MAAM,MAAoD,GACxE;IACD,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC,CA+HA"}

package/dist/data/factory/networking_factory.js

@@ -5,6 +5,8 @@ import { SmileIntegrityInterceptor } from "../api/interceptors/smile_integrity_i
 import { TokenRefreshInterceptor } from "../api/interceptors/token_refresh_interceptor";
 import { TokenHolder } from "../api/auth/token_holder";
 import { SmileIDCryptoManager } from "../security/smile_id_crypto_manager";
+import { SecurityPolicy } from "../security/security_policy";
+import { decodeSecurityPolicyBitCode } from "../util/use_smile_id_token_decoder";
 import { Attestation, SigningSecretProvider } from "@smileid/usesmileid_bridge";
 import { MissingPartnerConfigException } from "../../core/exception";
 import { UseSmileIDMetadataFactory } from "../../metadata/use_smile_id_metadata_factory";
@@ -88,6 +90,11 @@ signingSecret = () => SigningSecretProvider.signingSecret()) {
     // TokenRefreshInterceptor writes a refreshed value on a 401 so the
     // next outgoing request automatically picks up the new token.
     const tokenHolder = new TokenHolder(config.config?.token ?? "");
+    // Server-driven security policy for this flow, decoded from the top-level `policy` claim on the
+    // JWT (a sibling of `sdk_config`). Decoding is fail-secure: a malformed token, an absent claim, or an absent
+    // bit-code all resolve to "every behaviour active", so a token without the claim keeps the
+    // pre-policy behaviour rather than dropping security.
+    const securityPolicy = SecurityPolicy.fromBitCode(decodeSecurityPolicyBitCode(config.config?.token ?? ""));
     // 1. Gzip is registered FIRST so it runs LAST on the request path
     //    (innermost / closest to the wire). It stamps `Accept-Encoding:
     //    gzip` so the server can compress responses (axios
@@ -107,7 +114,9 @@ signingSecret = () => SigningSecretProvider.signingSecret()) {
     //    request path — it reads the `smileid-request-mac` header the MAC
     //    interceptor sets and binds the per-request token to it. Per-request
     //    opt-in via `config._useSmileIDAttestation`; pass-through otherwise.
-    const integrityInterceptor = new SmileIntegrityInterceptor();
+    const integrityInterceptor = new SmileIntegrityInterceptor({
+        securityPolicy,
+    });
     integrityInterceptor.attach(client);
     // 4. Request MAC runs after auth (so the `smileid-*` headers + timestamp it
     //    signs are present) and before integrity (which binds to the MAC). The
@@ -116,6 +125,7 @@ signingSecret = () => SigningSecretProvider.signingSecret()) {
     const cryptoManager = new SmileIDCryptoManager(signingSecret());
     const requestMacInterceptor = new SmileRequestMacInterceptor({
         cryptoManager,
+        securityPolicy,
     });
     requestMacInterceptor.attach(client);
     // 5. Auth is registered LAST of these three so it runs FIRST on the request

package/dist/data/factory/networking_factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"networking_factory.js","sourceRoot":"","sources":["../../../src/data/factory/networking_factory.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,mDAAmD,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AACxF,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAGzF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAqB;AACrB,8EAA8E;AAC9E,gEAAgE;AAChE,gBAA8B,GAAG,EAAE,CAAC,qBAAqB,CAAC,aAAa,EAAE;IAMzE,4DAA4D;IAC5D,qEAAqE;IACrE,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;IACnD,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5D,MAAM,6BAA6B,CAAC,gBAAgB,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/D,MAAM,6BAA6B,CAAC,gBAAgB,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACxC,8DAA8D;IAC9D,yDAAyD;IACzD,mEAAmE;IACnE,+DAA+D;IAC/D,iEAAiE;IACjE,gEAAgE;IAChE,gDAAgD;IAChD,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAElD,iEAAiE;IACjE,6DAA6D;IAC7D,mEAAmE;IACnE,mEAAmE;IACnE,wEAAwE;IACxE,UAAU;IACV,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;QACnC,kEAAkE;IACpE,CAAC,CAAC,CAAC;IAEH,6DAA6D;IAC7D,uDAAuD;IACvD,mEAAmE;IACnE,8DAA8D;IAC9D,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAEhE,kEAAkE;IAClE,oEAAoE;IACpE,uDAAuD;IACvD,kCAAkC;IAClC,MAAM,IAAI,GAAG,qBAAqB,EAAE,CAAC;IACrC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEpB,mEAAmE;IACnE,6DAA6D;IAC7D,4DAA4D;IAC5D,iEAAiE;IACjE,qDAAqD;IACrD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvC,IAAI,OAAO,EAAE,CAAC;QACZ,wBAAwB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,wEAAwE;IACxE,sEAAsE;IACtE,yEAAyE;IACzE,yEAAyE;IACzE,MAAM,oBAAoB,GAAG,IAAI,yBAAyB,EAAE,CAAC;IAC7D,oBAAoB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEpC,4EAA4E;IAC5E,2EAA2E;IAC3E,8EAA8E;IAC9E,wEAAwE;IACxE,MAAM,aAAa,GAAG,IAAI,oBAAoB,CAAC,aAAa,EAAE,CAAC,CAAC;IAChE,MAAM,qBAAqB,GAAG,IAAI,0BAA0B,CAAC;QAC3D,aAAa;KACd,CAAC,CAAC;IACH,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAErC,4EAA4E;IAC5E,4EAA4E;IAC5E,oEAAoE;IACpE,4EAA4E;IAC5E,8EAA8E;IAC9E,gCAAgC;IAChC,MAAM,eAAe,GAAG,IAAI,oBAAoB,CAAC;QAC/C,aAAa;QACb,WAAW;KACZ,CAAC,CAAC;IACH,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE/B,oEAAoE;IACpE,kEAAkE;IAClE,+DAA+D;IAC/D,+DAA+D;IAC/D,iEAAiE;IACjE,mEAAmE;IACnE,4DAA4D;IAC5D,MAAM,uBAAuB,GAAG,IAAI,uBAAuB,CAAC;QAC1D,WAAW;QACX,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc;KAC9C,CAAC,CAAC;IACH,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEvC,iEAAiE;IACjE,gEAAgE;IAChE,8DAA8D;IAC9D,oCAAoC;IACpC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YAC9C,gEAAgE;YAChE,2DAA2D;YAC3D,8DAA8D;YAC9D,MAAM,OAAO,GAAG,WAAkB,CAAC;YACnC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,OAAO,OAAO,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;gBACjD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"networking_factory.js","sourceRoot":"","sources":["../../../src/data/factory/networking_factory.ts"],"names":[],"mappings":"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"}

package/dist/data/repository/use_smile_id_repository_impl.d.ts

@@ -16,6 +16,12 @@ export declare class UseSmileIDRepositoryImpl {
     private readonly _retry;
     constructor(api: SmileIDAPI, retry: RetryConfig);
     submit(request: JobRequest): Promise<UseSmileIDResult<JobSubmissionResponse>>;
+    /**
+     * Pre-flight payload compression entry — extracts the captured image URIs for the job type and
+     * compresses the bundle under the transmission cap (metadata is measured, never modified).
+     * No-op for job types that carry no captured images (Enhanced KYC / BVN).
+     */
+    private _compressPayload;
     private _dispatch;
     /**
      * Translate any caught error into the typed

package/dist/data/repository/use_smile_id_repository_impl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use_smile_id_repository_impl.d.ts","sourceRoot":"","sources":["../../../src/data/repository/use_smile_id_repository_impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAWjE;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW;IAKzC,MAAM,CACV,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;IA8BnD,OAAO,CAAC,SAAS;IAmBjB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;CAGlB"}
+{"version":3,"file":"use_smile_id_repository_impl.d.ts","sourceRoot":"","sources":["../../../src/data/repository/use_smile_id_repository_impl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAkCjE;;;;;;;GAOG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW;IAKzC,MAAM,CACV,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;IAiDnD;;;;OAIG;YACW,gBAAgB;IA2B9B,OAAO,CAAC,SAAS;IAgCjB;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;CAGlB"}

package/dist/data/repository/use_smile_id_repository_impl.js

@@ -4,6 +4,22 @@ import { withRetry } from "../util/retry_util";
 import { InvalidFieldValueException } from "../../core/exception/job_validation_exceptions";
 import { UseSmileIDValidationException } from "../../core/exception/use_smile_id_validation_exception";
 import { mapAxiosError, } from "../../core/exception/use_smile_id_network_exception";
+import { PayloadCompressionRunner, } from "../compression/payload_compression_runner";
+/** Builds the per-image original/final compressed size wire entries, omitting absent/zero sizes. */
+function compressionSizeEntries(sizes) {
+    const entries = [];
+    const push = (name, value) => {
+        if (value !== undefined && value > 0)
+            entries.push({ name, value: String(value) });
+    };
+    push("selfie_original_size", sizes.selfieOriginalMb);
+    push("selfie_final_compressed_size", sizes.selfieFinalMb);
+    push("document_front_original_size", sizes.frontOriginalMb);
+    push("document_front_final_compressed_size", sizes.frontFinalMb);
+    push("document_back_original_size", sizes.backOriginalMb);
+    push("document_back_final_compressed_size", sizes.backFinalMb);
+    return entries;
+}
 /**
  * Concrete repository.
  *
@@ -30,8 +46,26 @@ export class UseSmileIDRepositoryImpl {
                 reason: "BVN submission is not yet supported",
             }));
         }
+        // Pre-flight payload compression — best effort: shrink the captured JPEGs under the Lambda
+        // cap before transmission (runs once, outside the retry loop), but never block submission, so
+        // any compression failure ships the captured images as-is and lets the server validate. The
+        // per-image original + final compressed sizes are stamped onto the metadata for telemetry.
+        let submitted = request;
+        try {
+            const sizes = await this._compressPayload(request);
+            const sizeEntries = sizes ? compressionSizeEntries(sizes) : [];
+            if (sizeEntries.length > 0) {
+                submitted = {
+                    ...request,
+                    metadata: request.metadata.withAdditionalEntries(sizeEntries),
+                };
+            }
+        }
+        catch {
+            // Best-effort: compression is an optimization; submit the captured images as-is on failure.
+        }
         try {
-            const response = await withRetry(this._retry, () => this._dispatch(request));
+            const response = await withRetry(this._retry, (attempt) => this._dispatch(submitted, attempt));
             return success(response);
         }
         catch (error) {
@@ -45,20 +79,60 @@ export class UseSmileIDRepositoryImpl {
             return failure(this._mapError(error));
         }
     }
-    _dispatch(request) {
+    /**
+     * Pre-flight payload compression entry — extracts the captured image URIs for the job type and
+     * compresses the bundle under the transmission cap (metadata is measured, never modified).
+     * No-op for job types that carry no captured images (Enhanced KYC / BVN).
+     */
+    async _compressPayload(request) {
+        const metadataBytes = JSON.stringify(request.metadata.toEntries()).length;
         switch (request.jobType) {
             case JobType.smartSelfieEnrollment:
-                return this._api.smartSelfieEnrollment(request);
             case JobType.smartSelfieAuthentication:
-                return this._api.smartSelfieAuthentication(request);
+            case JobType.biometricKyc:
+                return PayloadCompressionRunner.compress({
+                    selfieImage: request.selfieImage,
+                    livenessImages: request.livenessImages,
+                    metadataBytes,
+                });
+            case JobType.documentVerification:
+            case JobType.enhancedDocumentVerification:
+                return PayloadCompressionRunner.compress({
+                    selfieImage: request.selfieImage,
+                    livenessImages: request.livenessImages,
+                    frontDocument: request.frontDocument,
+                    backDocument: request.backDocument,
+                    metadataBytes,
+                });
+            default:
+                return undefined;
+        }
+    }
+    _dispatch(request, attempt) {
+        // Stamp how many network retries preceded this attempt onto the metadata
+        // (re-evaluated per attempt inside the retry loop). Appended as a flow-state
+        // entry so the already-appended document / config entries are preserved.
+        const stamped = attempt > 0
+            ? {
+                ...request,
+                metadata: request.metadata.withAdditionalEntries([
+                    { name: "network_retries", value: String(attempt) },
+                ]),
+            }
+            : request;
+        switch (stamped.jobType) {
+            case JobType.smartSelfieEnrollment:
+                return this._api.smartSelfieEnrollment(stamped);
+            case JobType.smartSelfieAuthentication:
+                return this._api.smartSelfieAuthentication(stamped);
             case JobType.enhancedKyc:
-                return this._api.enhancedKyc(request);
+                return this._api.enhancedKyc(stamped);
             case JobType.biometricKyc:
-                return this._api.biometricKyc(request);
+                return this._api.biometricKyc(stamped);
             case JobType.documentVerification:
-                return this._api.documentVerification(request);
+                return this._api.documentVerification(stamped);
             case JobType.enhancedDocumentVerification:
-                return this._api.enhancedDocumentVerification(request);
+                return this._api.enhancedDocumentVerification(stamped);
         }
     }
     /**

package/dist/data/repository/use_smile_id_repository_impl.js.map

@@ -1 +1 @@
-{"version":3,"file":"use_smile_id_repository_impl.js","sourceRoot":"","sources":["../../../src/data/repository/use_smile_id_repository_impl.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,gDAAgD,CAAC;AAC5F,OAAO,EAAE,6BAA6B,EAAE,MAAM,wDAAwD,CAAC;AACvG,OAAO,EACL,aAAa,GAEd,MAAM,qDAAqD,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,OAAO,wBAAwB;IAClB,IAAI,CAAa;IACjB,MAAM,CAAc;IAErC,YAAY,GAAe,EAAE,KAAkB;QAC7C,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,OAAmB;QAEnB,iEAAiE;QACjE,kEAAkE;QAClE,6DAA6D;QAC7D,UAAU;QACV,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;YACpC,OAAO,OAAO,CACZ,IAAI,0BAA0B,CAAC;gBAC7B,SAAS,EAAE,SAAS;gBACpB,MAAM,EAAE,qCAAqC;aAC9C,CAAC,CACH,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CACjD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CACxB,CAAC;YACF,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,6DAA6D;YAC7D,iEAAiE;YACjE,oEAAoE;YACpE,uDAAuD;YACvD,IAAI,KAAK,YAAY,6BAA6B,EAAE,CAAC;gBACnD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC;YACD,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAEO,SAAS,CACf,OAA6D;QAE7D,QAAQ,OAAO,CAAC,OAAO,EAAE,CAAC;YACxB,KAAK,OAAO,CAAC,qBAAqB;gBAChC,OAAO,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAClD,KAAK,OAAO,CAAC,yBAAyB;gBACpC,OAAO,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC;YACtD,KAAK,OAAO,CAAC,WAAW;gBACtB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACxC,KAAK,OAAO,CAAC,YAAY;gBACvB,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACzC,KAAK,OAAO,CAAC,oBAAoB;gBAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;YACjD,KAAK,OAAO,CAAC,4BAA4B;gBACvC,OAAO,IAAI,CAAC,IAAI,CAAC,4BAA4B,CAAC,OAAO,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,SAAS,CAAC,KAAc;QAC9B,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;CACF"}
+{"version":3,"file":"use_smile_id_repository_impl.js","sourceRoot":"","sources":["../../../src/data/repository/use_smile_id_repository_impl.ts"],"names":[],"mappings":"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"}