@smileid/usesmileid 12.0.0-beta01 → 12.0.0

package/dist/presentation/flow/dsl/use_smile_id_flow_builder.js

@@ -60,18 +60,18 @@ export class UseSmileIDFlowBuilder {
      */
     localizations;
     /**
-     * Notified when the flow completes (success or failure). Defaults
-     * to a no-op so partners who don't need result handling still get
-     * a valid configuration; in production set this to wire the
-     * server-issued `JobSubmissionResponse` (`userId` / `jobId` /
-     * `status` / `message` / `createdAt`) into the partner's job-status
-     * pipeline.
+     * Invoked once when the flow terminates — with the submitted job on
+     * success, a typed error on failure, or a cancellation when the user
+     * exits before completing. Wire the returned user id / job id into
+     * your job-status pipeline. Defaults to a no-op so partners who don't
+     * need result handling still get a valid configuration; the
+     * server-issued `JobSubmissionResponse` carries `userId` / `jobId` /
+     * `status` / `message` / `createdAt`.
      */
     onResult = () => { };
     /**
-     * Optional. Notified for each analytics event during the flow.
-     * Stub note: orchestrator does not yet emit events — see
-     * `docs/Architecture.md § Rollout`.
+     * Invoked for every analytics event the SDK emits during the flow.
+     * Optional — leave unset to ignore analytics.
      */
     onAnalyticsEvent;
     // --- Internal block builders ---------------------------------------------
@@ -81,11 +81,12 @@ export class UseSmileIDFlowBuilder {
     _ml;
     _screens;
     /**
-     * `b.config((c) => { c.enableCrashReporting = false; })`
+     * Configures global SDK feature flags (debug mode, offline mode, crash
+     * reporting). Repeated calls compose against the same configuration —
+     * `enableCrashReporting` set in one call and `enableDebugMode` set in
+     * another both end up on the final config.
      *
-     * Compose-friendly: repeated calls reuse the same builder, so
-     * `enableCrashReporting` set in one call and `enableDebugMode` set
-     * in another both end up on the final config.
+     * `b.config((c) => { c.enableCrashReporting = false; })`
      */
     config(block) {
         if (!this._config)
@@ -93,7 +94,10 @@ export class UseSmileIDFlowBuilder {
         block(this._config);
     }
     /**
-     * `b.theme((t) => { t.primaryColor = '#1A73E8'; t.buttonShape = 12; })`
+     * Configures the visual theme — colors, fonts, and corner shapes —
+     * applied to every SDK screen in the flow.
+     *
+     * `b.theme((t) => { t.primaryColor = t.color('#1A73E8', '#4DA3FF'); t.buttonShape = 12; })`
      *
      * Each call replaces the prior theme builder — partners typically
      * configure the theme in one place, and accumulating across helpers
@@ -105,6 +109,10 @@ export class UseSmileIDFlowBuilder {
         block(this._theme);
     }
     /**
+     * Configures the network stack: partner credentials, job type,
+     * timeouts, retry policy, response cache, and custom interceptors.
+     * Required for any flow that submits a job.
+     *
      * `b.network((n) => { n.config((c) => { c.partnerConfig((p) => { p.partnerId = ...; }); }); })`
      *
      * Each call replaces the prior network builder. Network config
@@ -116,6 +124,9 @@ export class UseSmileIDFlowBuilder {
         block(this._network);
     }
     /**
+     * Registers the on-device ML analyzers used for face and document
+     * detection, keyed by capture type.
+     *
      * `b.ml((m) => { m.analyzers((a) => { a.forCaptureType(CaptureType.selfie, (face) => face.add(useSmileIDVisionFace)); }); })`
      */
     ml(block) {
@@ -124,6 +135,10 @@ export class UseSmileIDFlowBuilder {
         block(this._ml);
     }
     /**
+     * Declares the ordered sequence of screens the flow presents. Screens
+     * render in the order they are added; the same screen type may be
+     * added more than once.
+     *
      * `b.screens((screens) => { screens.instructions(); screens.capture((c) => { c.captureType = CaptureType.selfie; }); })`
      *
      * Each screen-builder call appends a step to the orchestrator's
@@ -135,10 +150,11 @@ export class UseSmileIDFlowBuilder {
         block(this._screens);
     }
     /**
-     * Quick triage of the in-progress builder state. Today the only
-     * rule it surfaces is the empty-screens-block error — `b.screens`
-     * must register at least one screen before the builder can produce
-     * a flow.
+     * Runs a pre-flight check of the current builder configuration and
+     * returns a `ValidationState` describing any blocking issues, without
+     * throwing. Today the only rule it surfaces is the empty-screens-block
+     * error — `b.screens` must register at least one screen before the
+     * builder can produce a flow.
      *
      * The full rule set (screen ordering, dependency rules, KYC and
      * consent payload validation, etc.) runs inside `build()` and is
@@ -146,50 +162,60 @@ export class UseSmileIDFlowBuilder {
      * the full picture during configuration should call
      * `useSmileIDBuilder(...)` and pattern-match on the returned
      * `result.kind`.
+     *
+     * @returns a `ValidationState` describing any blocking issues.
      */
     validate() {
         return ValidationState.invalid(runBuilderValidation(this._screens?.build().steps ?? []));
     }
     /**
-     * Validate a `ConsentInformation` payload in isolation — useful
-     * when the source of truth is dynamic (e.g. a payload pulled from
-     * partner storage or a remote config) and the partner wants to
-     * pre-flight it before assigning to `b.consentInformation`.
+     * Validates a `ConsentInformation` payload in isolation and returns a
+     * `ValidationState`, without throwing. Useful when the payload comes
+     * from dynamic partner storage or remote config — pre-flight it before
+     * assigning to `b.consentInformation`.
      */
     validateConsent(consent) {
         return ValidationState.invalid(runConsentValidation(consent));
     }
     /**
-     * Validate an `EnhancedKYCParams` payload in isolation — useful
-     * when the partner pulls KYC fields from a form or remote config
-     * and wants to pre-flight them before assigning to
-     * `b.enhancedKYCParams`.
+     * Validates an `EnhancedKYCParams` payload in isolation and returns a
+     * `ValidationState`, without throwing. Useful when the partner pulls
+     * KYC fields from a form or remote config and wants to pre-flight them
+     * before assigning to `b.enhancedKYCParams`.
      */
     validateEnhancedKYCParams(params) {
         return ValidationState.invalid(runEnhancedKYCParamsValidation(params));
     }
     /**
-     * Validate a `BiometricKYCParams` payload in isolation. Same
-     * semantics as `validateEnhancedKYCParams` — same field rules,
-     * different param shape.
+     * Validates a `BiometricKYCParams` payload in isolation and returns a
+     * `ValidationState`, without throwing.
      */
     validateBiometricKYCParams(params) {
         return ValidationState.invalid(runBiometricKYCParamsValidation(params));
     }
-    /** Validate a `DocumentVerificationParams` payload in isolation. */
+    /**
+     * Validates a `DocumentVerificationParams` payload in isolation and
+     * returns a `ValidationState`, without throwing. Only `country` is
+     * required; `idType` is optional.
+     */
     validateDocumentVerificationParams(params) {
         return ValidationState.invalid(runDocumentVerificationParamsValidation(params));
     }
-    /** Validate an `EnhancedDocumentVerificationParams` payload in isolation. */
+    /**
+     * Validates an `EnhancedDocumentVerificationParams` payload in
+     * isolation and returns a `ValidationState`, without throwing. Both
+     * `country` and `idType` are required.
+     */
     validateEnhancedDocumentVerificationParams(params) {
         return ValidationState.invalid(runEnhancedDocumentVerificationParamsValidation(params));
     }
     /**
-     * Validate a `UserDetails` payload in isolation — useful when the
-     * partner pulls user PII from a form or remote config and wants to
-     * pre-flight it before assigning to `b.userDetails`. Surfaces the
-     * same dotted-path field names (`userDetails.givenNames` etc.) that
-     * the in-build validator emits.
+     * Validates a `UserDetails` payload in isolation and returns a
+     * `ValidationState`, without throwing. Useful when the partner pulls
+     * user PII from a form or remote config and wants to pre-flight it
+     * before assigning to `b.userDetails`. Surfaces the same dotted-path
+     * field names (`userDetails.givenNames` etc.) that the in-build
+     * validator emits.
      */
     validateUserDetails(userDetails) {
         return ValidationState.invalid(runUserDetailsValidation(userDetails));

package/dist/presentation/flow/dsl/use_smile_id_flow_builder.js.map

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

package/dist/presentation/flow/flow_navigation_manager.d.ts

@@ -3,10 +3,11 @@ import type { FlowConfigurationSnapshot } from "./dsl/use_smile_id_flow_builder"
 import type { JobSubmissionState } from "./job_submission_state";
 import type { UseSmileIDRepository } from "../../data/repository/use_smile_id_repository";
 import type { ConsentInformation } from "../../core/models/params";
-import type { DocumentType } from "../../core/models/document_type";
+import { type DocumentType } from "../../core/models/document_type";
 import type { JobSubmissionResponse } from "../../data/model/job_submission_response";
 import { type MetadataProvider } from "../../metadata/use_smile_id_metadata_factory";
 import { type DocumentImageOrigin } from "../../metadata/document_image_origin";
+import type { CaptureTelemetry } from "../screen/use_smile_id_capture_screen";
 import type { SdkConfig } from "../../data/model/sdk_config";
 import { DocumentSide } from "@smileid/usesmileid_bridge";
 /**
@@ -76,6 +77,11 @@ export declare class FlowNavigationManager {
      * removed when its side is retaken.
      */
     private readonly _documentImageOrigins;
+    private _selfieCaptureTelemetry;
+    private readonly _documentCaptureTelemetry;
+    private _cameraName;
+    private _devicePositions;
+    private _deviceMovementDetected;
     private _jobSubmissionState;
     private readonly _listeners;
     private readonly _steps;
@@ -91,6 +97,17 @@ export declare class FlowNavigationManager {
      * defaults apply throughout the flow in those cases.
      */
     readonly resolvedSdkConfig: SdkConfig | undefined;
+    /** Canonical `partner_id` decoded from the JWT (raw); resolved via the [partnerId] getter. */
+    private readonly _resolvedPartnerId;
+    /**
+     * Partner identifier the capture screen stamps into the Smile EXIF tag — the tag's HMAC/AES
+     * keys derive from it and the backend validates the tag against the request's partner_id.
+     *
+     * Sourced from the JWT `partner_id` claim (server-canonical form, e.g. `"002"`) so the stamped
+     * value matches what the backend keys on; falls back to the partner-supplied config value when
+     * the claim is absent/blank. Empty = skip tagging.
+     */
+    get partnerId(): string;
     /** Stable per-flow session id, stamped into every analytics event's `session_id`. */
     private readonly _sessionId;
     /** Submission attempts so far — stamped into `job_submitted` as `attempt`. */
@@ -101,6 +118,12 @@ export declare class FlowNavigationManager {
     get enhancedLivenessEnabled(): boolean;
     /** Document type from the flow's document capture step, if any (drives the instructions document variant). */
     get documentType(): DocumentType | undefined;
+    /**
+     * Resolved document capture-frame aspect ratio (width / height), shared by
+     * capture, preview, and processing. Precedence: type `knownAspectRatio` →
+     * partner `knownIdAspectRatio` → orientation default.
+     */
+    get documentFrameAspectRatio(): number | undefined;
     /** Read-only navigation stack; top is the active screen. */
     get navigationPath(): readonly ScreenSpec[];
     /** Active screen (top of the path); `undefined` only when no screens are configured. */
@@ -155,8 +178,20 @@ export declare class FlowNavigationManager {
      * metadata). Metadata-only, so it intentionally does not `_notify()`.
      */
     recordDocumentImageOrigin(side: DocumentSide, origin: DocumentImageOrigin): void;
+    /** Records selfie capture telemetry (duration + retries) at capture completion. */
+    recordSelfieCaptureTelemetry(telemetry: CaptureTelemetry): void;
+    /** Records per-side document capture telemetry at each side's completion. */
+    recordDocumentCaptureTelemetry(side: DocumentSide, telemetry: CaptureTelemetry): void;
+    private _captureCameraName;
     /** Per-side document origin wire entries (front then back; omitted when unset). */
     private _documentImageOriginEntries;
+    /**
+     * Capture telemetry + image-property wire entries. Durations and retries keep
+     * a meaningful 0 (capture ran) and are omitted only when that capture type
+     * never ran. Color depth / pixel config are emitted for each present capture;
+     * document sizes when measured.
+     */
+    private _captureTelemetryEntries;
     private _precedingStepIsDocumentCapture;
     setConsent(info: ConsentInformation): void;
     get jobSubmissionState(): JobSubmissionState;
@@ -207,10 +242,10 @@ export declare class FlowNavigationManager {
      */
     private _expectedLivenessImageCount;
     /**
-     * Decode the `sdk_config` JWT claim. `undefined` for offline mode,
-     * no token, or no valid claim — SDK defaults apply in those cases.
+     * Decode the partner JWT into its claims (`sdk_config`, `partner_id`). `undefined` for offline
+     * mode, no token, or an unparseable token — SDK defaults apply in those cases.
      */
-    private static _decodeSdkConfig;
+    private static _decodeToken;
     private _notify;
 }
 export {};

package/dist/presentation/flow/flow_navigation_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flow_navigation_manager.d.ts","sourceRoot":"","sources":["../../../src/presentation/flow/flow_navigation_manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flow_navigation_manager.d.ts","sourceRoot":"","sources":["../../../src/presentation/flow/flow_navigation_manager.ts"],"names":[],"mappings":"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"}

package/dist/presentation/flow/flow_navigation_manager.js

@@ -1,11 +1,14 @@
 import { JobType } from "../../core/models/job_type";
 import { CaptureType } from "../../core/models/ml_config";
+import { defaultFrameAspectRatio, } from "../../core/models/document_type";
 import { MissingRequiredFieldException } from "../../core/exception/job_validation_exceptions";
 import { UseSmileIDAnalyticsEventTypes, UseSmileIDAnalyticsParamKeys, UseSmileIDAnalyticsScreenNames, } from "./analytics/use_smile_id_analytics_event";
 import { UseSmileIDMetadataFactory, } from "../../metadata/use_smile_id_metadata_factory";
 import { DOCUMENT_BACK_IMAGE_ORIGIN_KEY, DOCUMENT_FRONT_IMAGE_ORIGIN_KEY, } from "../../metadata/document_image_origin";
+import { configurationMetadataEntries } from "../../metadata/metadata_configuration_mappers";
+import { CAPTURE_IMAGE_COLOR_DEPTH, CAPTURE_IMAGE_PIXEL_CONFIG, } from "../../metadata/captured_image_properties";
 import { numSamplesOverride } from "../../data/model/sdk_config";
-import { decodeSmileIDToken } from "../../data/util/use_smile_id_token_decoder";
+import { decodeSmileIDToken, } from "../../data/util/use_smile_id_token_decoder";
 import { DocumentSide, EnhancedSmartSelfieConfig, } from "@smileid/usesmileid_bridge";
 import { ScanPerformanceProfile } from "@smileid/usesmileid_bridge";
 const DEFAULT_CONSENT = Object.freeze({
@@ -35,6 +38,14 @@ export class FlowNavigationManager {
      * removed when its side is retaken.
      */
     _documentImageOrigins = new Map();
+    // Capture telemetry recorded at capture completion (selfie + per document side).
+    _selfieCaptureTelemetry;
+    _documentCaptureTelemetry = new Map();
+    // Identifier of the camera used for the most recent capture.
+    _cameraName;
+    // Accelerometer telemetry from the most recent capture (device_positions / movement).
+    _devicePositions = [];
+    _deviceMovementDetected = null;
     _jobSubmissionState = { kind: "notAttempted" };
     _listeners = new Set();
     _steps;
@@ -50,6 +61,22 @@ export class FlowNavigationManager {
      * defaults apply throughout the flow in those cases.
      */
     resolvedSdkConfig;
+    /** Canonical `partner_id` decoded from the JWT (raw); resolved via the [partnerId] getter. */
+    _resolvedPartnerId;
+    /**
+     * Partner identifier the capture screen stamps into the Smile EXIF tag — the tag's HMAC/AES
+     * keys derive from it and the backend validates the tag against the request's partner_id.
+     *
+     * Sourced from the JWT `partner_id` claim (server-canonical form, e.g. `"002"`) so the stamped
+     * value matches what the backend keys on; falls back to the partner-supplied config value when
+     * the claim is absent/blank. Empty = skip tagging.
+     */
+    get partnerId() {
+        const jwtPartnerId = this._resolvedPartnerId;
+        if (jwtPartnerId && jwtPartnerId.length > 0)
+            return jwtPartnerId;
+        return this._configuration.network?.config?.partnerConfig?.partnerId ?? "";
+    }
     /** Stable per-flow session id, stamped into every analytics event's `session_id`. */
     _sessionId;
     /** Submission attempts so far — stamped into `job_submitted` as `attempt`. */
@@ -65,7 +92,9 @@ export class FlowNavigationManager {
         this._metadataProvider =
             options.metadataProvider ?? new UseSmileIDMetadataFactory();
         this._sessionId = this._metadataProvider.sessionId;
-        this.resolvedSdkConfig = FlowNavigationManager._decodeSdkConfig(options.configuration);
+        const decodedToken = FlowNavigationManager._decodeToken(options.configuration);
+        this.resolvedSdkConfig = decodedToken?.sdkConfig;
+        this._resolvedPartnerId = decodedToken?.partnerId;
         // Seed the path with the first screen so currentScreen/renderer have a
         // deterministic start. Empty path → host renders the "no screens"
         // sentinel (validation rejects empty screens at build time anyway).
@@ -100,6 +129,22 @@ export class FlowNavigationManager {
         }
         return undefined;
     }
+    /**
+     * Resolved document capture-frame aspect ratio (width / height), shared by
+     * capture, preview, and processing. Precedence: type `knownAspectRatio` →
+     * partner `knownIdAspectRatio` → orientation default.
+     */
+    get documentFrameAspectRatio() {
+        for (const step of this._steps) {
+            if (step.kind === "capture" &&
+                step.config.captureType === CaptureType.document) {
+                const documentConfig = step.config.documentConfig;
+                return (documentConfig?.resolvedAspectRatio ??
+                    defaultFrameAspectRatio(documentConfig?.documentType?.orientation ?? "Landscape"));
+            }
+        }
+        return undefined;
+    }
     // --- navigation path --------------------------------------------------
     /** Read-only navigation stack; top is the active screen. */
     get navigationPath() {
@@ -152,6 +197,20 @@ export class FlowNavigationManager {
             if (next?.kind === "preview")
                 return this._steps[currentIdx + 2];
         }
+        // At the document capture step with the front captured, the back still
+        // pending, and no document preview to drive the per-side loop, re-enter the
+        // capture step for the back side so captureBothSides is honoured even when
+        // the flow omits the document preview { } step. When a preview does follow,
+        // the per-side loop above handles the back instead.
+        if (current.kind === "capture" &&
+            current.config.captureType === CaptureType.document &&
+            this.documentCapturesBack() &&
+            this._captured.frontDocumentPath !== undefined &&
+            this._captured.backDocumentPath === undefined &&
+            !this._documentBackSkipped &&
+            !this.documentPreviewFollowsCapture()) {
+            return current;
+        }
         return this._steps[currentIdx + 1];
     }
     /**
@@ -345,6 +404,28 @@ export class FlowNavigationManager {
             return;
         this._documentImageOrigins.set(side, origin);
     }
+    /** Records selfie capture telemetry (duration + retries) at capture completion. */
+    recordSelfieCaptureTelemetry(telemetry) {
+        if (this._disposed)
+            return;
+        this._selfieCaptureTelemetry = telemetry;
+        this._captureCameraName(telemetry);
+    }
+    /** Records per-side document capture telemetry at each side's completion. */
+    recordDocumentCaptureTelemetry(side, telemetry) {
+        if (this._disposed)
+            return;
+        this._documentCaptureTelemetry.set(side, telemetry);
+        this._captureCameraName(telemetry);
+    }
+    _captureCameraName(telemetry) {
+        if (telemetry.cameraName)
+            this._cameraName = telemetry.cameraName;
+        if (telemetry.devicePositions.length > 0) {
+            this._devicePositions = telemetry.devicePositions;
+            this._deviceMovementDetected = telemetry.deviceMovementDetected;
+        }
+    }
     /** Per-side document origin wire entries (front then back; omitted when unset). */
     _documentImageOriginEntries() {
         const entries = [];
@@ -358,6 +439,50 @@ export class FlowNavigationManager {
         }
         return entries;
     }
+    /**
+     * Capture telemetry + image-property wire entries. Durations and retries keep
+     * a meaningful 0 (capture ran) and are omitted only when that capture type
+     * never ran. Color depth / pixel config are emitted for each present capture;
+     * document sizes when measured.
+     */
+    _captureTelemetryEntries() {
+        const entries = [];
+        const push = (name, value) => entries.push({ name, value });
+        const selfie = this._selfieCaptureTelemetry;
+        if (selfie) {
+            // Duration + retries keep a meaningful 0 (capture ran); telemetry is absent only when the
+            // capture type never ran.
+            push("selfie_capture_duration_ms", String(selfie.durationMs));
+            push("selfie_capture_retries", String(selfie.retries));
+        }
+        if (this._captured.selfiePath !== undefined) {
+            push("selfie_image_color_depth", String(CAPTURE_IMAGE_COLOR_DEPTH));
+            push("selfie_image_pixel_config", CAPTURE_IMAGE_PIXEL_CONFIG);
+        }
+        if (this._cameraName) {
+            push("camera_name", this._cameraName);
+        }
+        if (this._devicePositions.length > 0) {
+            push("device_positions", JSON.stringify(this._devicePositions));
+            if (this._deviceMovementDetected !== null) {
+                push("device_movement_detected", String(this._deviceMovementDetected));
+            }
+        }
+        const sideKey = (side) => side === DocumentSide.Back ? "back" : "front";
+        for (const side of [DocumentSide.Front, DocumentSide.Back]) {
+            const key = sideKey(side);
+            const telemetry = this._documentCaptureTelemetry.get(side);
+            if (telemetry) {
+                push(`document_${key}_capture_duration_ms`, String(telemetry.durationMs));
+                push(`document_${key}_capture_retries`, String(telemetry.retries));
+                push(`document_${key}_image_color_depth`, String(CAPTURE_IMAGE_COLOR_DEPTH));
+                push(`document_${key}_image_pixel_config`, CAPTURE_IMAGE_PIXEL_CONFIG);
+            }
+        }
+        // Per-image original + final compressed sizes are stamped in the repository around the
+        // compression pass (it owns both the before and after byte counts), not here.
+        return entries;
+    }
     _precedingStepIsDocumentCapture(index) {
         const preceding = this._steps[index - 1];
         return (preceding?.kind === "capture" &&
@@ -468,10 +593,16 @@ export class FlowNavigationManager {
         // make() so a mid-flow rotation is captured. resolvedSdkConfig drives
         // sdk_config_source + image_width/height provenance.
         const baseMetadata = this._metadataProvider.make(this.resolvedSdkConfig);
-        const originEntries = this._documentImageOriginEntries();
-        const metadata = originEntries.length > 0
-            ? baseMetadata.withAdditionalEntries(originEntries)
-            : baseMetadata;
+        // Append the per-side document origins plus the partner's builder setup and
+        // the active detection models, all as flat wire entries.
+        // configurationMetadataEntries always contributes the builder + model config objects, so
+        // there is always at least one extra entry to append.
+        const extraEntries = [
+            ...this._documentImageOriginEntries(),
+            ...this._captureTelemetryEntries(),
+            ...configurationMetadataEntries(config),
+        ];
+        const metadata = baseMetadata.withAdditionalEntries(extraEntries);
         switch (jobType) {
             // enableEnhancedLiveness is a screen-level capture flag, not a
             // distinct job type — enrollment still hits /v3/registration.
@@ -740,16 +871,16 @@ export class FlowNavigationManager {
         return profileNumSamples - 1;
     }
     /**
-     * Decode the `sdk_config` JWT claim. `undefined` for offline mode,
-     * no token, or no valid claim — SDK defaults apply in those cases.
+     * Decode the partner JWT into its claims (`sdk_config`, `partner_id`). `undefined` for offline
+     * mode, no token, or an unparseable token — SDK defaults apply in those cases.
      */
-    static _decodeSdkConfig(configuration) {
+    static _decodeToken(configuration) {
         if (configuration.config?.allowOfflineMode)
             return undefined;
         const token = configuration.network?.config?.token;
         if (!token || token.length === 0)
             return undefined;
-        return decodeSmileIDToken(token)?.sdkConfig;
+        return decodeSmileIDToken(token);
     }
     _notify() {
         for (const listener of this._listeners) {