@smileid/usesmileid 12.0.0-beta01

package/dist/presentation/flow/dsl/use_smile_id_builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_builder.d.ts","sourceRoot":"","sources":["../../../../src/presentation/flow/dsl/use_smile_id_builder.tsx"],"names":[],"mappings":"AAKA,OAAO,EACL,qBAAqB,EAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;CACtD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,sBAAsB,+BAwCpE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,GAClD,eAAe,CAIjB;AAED,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,49 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { FlowInvalidDispatcher, FlowSuccessRenderer, } from "../use_smile_id_flow";
+import { UseSmileIDFlowBuilder, } from "./use_smile_id_flow_builder";
+export function UseSmileIDBuilder({ builder }) {
+    // Builder closure intentionally runs once per mount — flow
+    // configuration is captured at first render and not meant to
+    // mutate after.
+    //
+    // `onResult` and `enableDebugMode` are snapshotted off the partial
+    // builder state into `invalidMeta` so the invalid-branch dispatcher
+    // can route the failure through the partner callback and decide
+    // whether to render the debug screen. Neither piece is recoverable
+    // from a malformed configuration alone, but they're not part of
+    // the partner-visible `FlowBuildResult` shape — that matches the
+    // single-field invalid case the other 3 SDKs ship.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    const { result, invalidMeta } = useMemo(() => {
+        const flowBuilder = new UseSmileIDFlowBuilder();
+        builder(flowBuilder);
+        const built = flowBuilder.build();
+        return {
+            result: built,
+            invalidMeta: {
+                onResult: flowBuilder.onResult,
+                enableDebugMode: flowBuilder._config?.build().enableDebugMode === true,
+            },
+        };
+    }, []);
+    if (result.kind === "invalid") {
+        return (_jsx(FlowInvalidDispatcher, { result: result, onResult: invalidMeta.onResult, enableDebugMode: invalidMeta.enableDebugMode }));
+    }
+    return _jsx(FlowSuccessRenderer, { configuration: result.configuration });
+}
+/**
+ * Function form of the builder, retained for tests and any partner
+ * code that wants to inspect the [FlowBuildResult] before rendering
+ * (for example, a custom failure UI). Most partners should use the
+ * `<UseSmileIDBuilder>` component instead.
+ *
+ * @internal
+ */
+export function useSmileIDBuilder(configure) {
+    const builder = new UseSmileIDFlowBuilder();
+    configure(builder);
+    return builder.build();
+}
+export { UseSmileIDFlowBuilder, } from "./use_smile_id_flow_builder";
+//# sourceMappingURL=use_smile_id_builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_builder.js","sourceRoot":"","sources":["../../../../src/presentation/flow/dsl/use_smile_id_builder.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC;AAgDrC,MAAM,UAAU,iBAAiB,CAAC,EAAE,OAAO,EAA0B;IACnE,2DAA2D;IAC3D,6DAA6D;IAC7D,gBAAgB;IAChB,EAAE;IACF,mEAAmE;IACnE,oEAAoE;IACpE,gEAAgE;IAChE,mEAAmE;IACnE,gEAAgE;IAChE,iEAAiE;IACjE,mDAAmD;IACnD,uDAAuD;IACvD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QAC3C,MAAM,WAAW,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAChD,OAAO,CAAC,WAAW,CAAC,CAAC;QACrB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO;YACL,MAAM,EAAE,KAAK;YACb,WAAW,EAAE;gBACX,QAAQ,EAAE,WAAW,CAAC,QAAQ;gBAC9B,eAAe,EAEX,WAGD,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,eAAe,KAAK,IAAI;aAC9C;SACF,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CACL,KAAC,qBAAqB,IACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAC9B,eAAe,EAAE,WAAW,CAAC,eAAe,GAC5C,CACH,CAAC;IACJ,CAAC;IACD,OAAO,KAAC,mBAAmB,IAAC,aAAa,EAAE,MAAM,CAAC,aAAa,GAAI,CAAC;AACtE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,SAAmD;IAEnD,MAAM,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAC5C,SAAS,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,OAAO,CAAC,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,OAAO,EACL,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC"}

package/dist/presentation/flow/dsl/use_smile_id_flow_builder.d.ts

@@ -0,0 +1,241 @@
+import type { ConfigOptions } from "../../../core/models/config";
+import type { ThemeConfiguration } from "./builder/theme_builder";
+import type { NetworkConfig } from "../../../core/models/network_config";
+import type { MLConfig } from "../../../core/models/ml_config";
+import type { ConsentInformation, EnhancedKYCParams, BiometricKYCParams, DocumentVerificationParams, EnhancedDocumentVerificationParams, UserDetails } from "../../../core/models/params";
+import type { UseSmileIDAnalyticsEvent } from "../analytics/use_smile_id_analytics_event";
+import type { JobSubmissionResponse } from "../../../data/model/job_submission_response";
+import type { UseSmileIDResult } from "../../../core/models/result";
+import type { ScreensConfig } from "./builder/screens_builder";
+import { UseSmileIDConfigBuilder } from "./builder/config_builder";
+import { ThemeConfigBuilder } from "./builder/theme_builder";
+import { UseSmileIDNetworkBuilder } from "../../../data/dsl/use_smile_id_network_builder";
+import { UseSmileIDMLBuilder } from "./builder/ml_builder";
+import { ScreensBuilder } from "./builder/screens_builder";
+import type { UseSmileIDLocalizations } from "../../../l10n/use_smile_id_localizations";
+import { ValidationState } from "../validation/validation_state";
+import type { FlowBuildResult } from "./flow_build_result";
+/**
+ * Top-level DSL builder.
+ *
+ * Closure-based block methods (`config`, `theme`, `network`, `ml`,
+ * `screens`) configure each section; mutable top-level properties
+ * (`consentInformation`, `enhancedKYCParams`, `biometricKYCParams`,
+ * `onResult`, `onAnalyticsEvent`) are assigned directly. The server
+ * issues `userId` / `jobId` and returns them in the submission
+ * response — partners receive them via `onResult`.
+ */
+export declare class UseSmileIDFlowBuilder {
+    /**
+     * Optional. Pre-supplied consent — if set, the consent screen is
+     * skipped.
+     */
+    consentInformation?: ConsentInformation;
+    /** Optional. Required only for `JobType.enhancedKyc`. */
+    enhancedKYCParams?: EnhancedKYCParams;
+    /** Optional. Required only for `JobType.biometricKyc`. */
+    biometricKYCParams?: BiometricKYCParams;
+    /** Optional. Required only for `JobType.documentVerification`. */
+    documentVerificationParams?: DocumentVerificationParams;
+    /** Optional. Required only for `JobType.enhancedDocumentVerification`. */
+    enhancedDocumentVerificationParams?: EnhancedDocumentVerificationParams;
+    /**
+     * Required for any job that submits the `user_details` multipart
+     * part — `JobType.enhancedKyc`, `JobType.biometricKyc`,
+     * `JobType.smartSelfieEnrollment`, `JobType.smartSelfieAuthentication`
+     * (plus the two Enhanced selfie aliases). The same shape is sent on
+     * the wire as a JSON multipart part with snake_case keys.
+     *
+     * Previously carried inside `enhancedKYCParams` / `biometricKYCParams`
+     * — consolidated here so the smartSelfie* endpoints can carry it too
+     * (their v3 wire format also requires `user_details`).
+     */
+    userDetails?: UserDetails;
+    /**
+     * Required for `JobType.smartSelfieAuthentication` (and its enhanced
+     * alias). The v3 `/v3/authentication` endpoint requires the partner to
+     * pass the `user_id` returned from a prior enrollment so the server
+     * can match the authentication attempt to the existing enrollment.
+     * Sent on the wire as a `user_id` multipart text form field.
+     */
+    userId?: string;
+    /**
+     * Optional. Locale-resolved string overrides. The flow component
+     * wraps its tree with `<UseSmileIDLocalizationsProvider>` when this
+     * is set so all SDK screens read from it. Partners use any i18n
+     * stack to pick the right map and pass it here.
+     *
+     * If unset, screens render the canonical English defaults bundled
+     * with `strings_en.ts`.
+     */
+    localizations?: UseSmileIDLocalizations;
+    /**
+     * 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.
+     */
+    onResult: (result: UseSmileIDResult<JobSubmissionResponse>) => void;
+    /**
+     * Optional. Notified for each analytics event during the flow.
+     * Stub note: orchestrator does not yet emit events — see
+     * `docs/Architecture.md § Rollout`.
+     */
+    onAnalyticsEvent?: (event: UseSmileIDAnalyticsEvent) => void;
+    private _config?;
+    private _theme?;
+    private _network?;
+    private _ml?;
+    private _screens?;
+    /**
+     * `b.config((c) => { c.enableCrashReporting = false; })`
+     *
+     * 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.
+     */
+    config(block: (c: UseSmileIDConfigBuilder) => void): void;
+    /**
+     * `b.theme((t) => { t.primaryColor = '#1A73E8'; t.buttonShape = 12; })`
+     *
+     * Each call replaces the prior theme builder — partners typically
+     * configure the theme in one place, and accumulating across helpers
+     * tends to surface as a fight over which call wrote `primaryColor`
+     * last. Replace semantics make the precedence local and obvious.
+     */
+    theme(block: (t: ThemeConfigBuilder) => void): void;
+    /**
+     * `b.network((n) => { n.config((c) => { c.partnerConfig((p) => { p.partnerId = ...; }); }); })`
+     *
+     * Each call replaces the prior network builder. Network config
+     * carries credentials and a job type, so partial composition across
+     * helpers is more likely to mask configuration errors than to help.
+     */
+    network(block: (n: UseSmileIDNetworkBuilder) => void): void;
+    /**
+     * `b.ml((m) => { m.analyzers((a) => { a.forCaptureType(CaptureType.selfie, (face) => face.add(useSmileIDVisionFace)); }); })`
+     */
+    ml(block: (m: UseSmileIDMLBuilder) => void): void;
+    /**
+     * `b.screens((screens) => { screens.instructions(); screens.capture((c) => { c.captureType = CaptureType.selfie; }); })`
+     *
+     * Each screen-builder call appends a step to the orchestrator's
+     * flow list in declaration order.
+     */
+    screens(block: (s: ScreensBuilder) => void): void;
+    /**
+     * 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.
+     *
+     * The full rule set (screen ordering, dependency rules, KYC and
+     * consent payload validation, etc.) runs inside `build()` and is
+     * reflected in the [FlowBuildResult] surface; partners that want
+     * the full picture during configuration should call
+     * `useSmileIDBuilder(...)` and pattern-match on the returned
+     * `result.kind`.
+     */
+    validate(): ValidationState;
+    /**
+     * 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`.
+     */
+    validateConsent(consent: ConsentInformation): ValidationState;
+    /**
+     * 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`.
+     */
+    validateEnhancedKYCParams(params: EnhancedKYCParams): ValidationState;
+    /**
+     * Validate a `BiometricKYCParams` payload in isolation. Same
+     * semantics as `validateEnhancedKYCParams` — same field rules,
+     * different param shape.
+     */
+    validateBiometricKYCParams(params: BiometricKYCParams): ValidationState;
+    /** Validate a `DocumentVerificationParams` payload in isolation. */
+    validateDocumentVerificationParams(params: DocumentVerificationParams): ValidationState;
+    /** Validate an `EnhancedDocumentVerificationParams` payload in isolation. */
+    validateEnhancedDocumentVerificationParams(params: EnhancedDocumentVerificationParams): ValidationState;
+    /**
+     * 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.
+     */
+    validateUserDetails(userDetails: UserDetails): ValidationState;
+    /**
+     * Snapshot the current builder state and report the validation
+     * outcome as a [FlowBuildResult]. Returns `{kind: 'success', ...}`
+     * when every rule passed, or `{kind: 'invalid', ...}` carrying the
+     * issues, the partner's `onResult` callback, and the resolved
+     * `enableDebugMode` flag so the wrapper can route the failure
+     * through `onResult.failure` and decide whether to render the
+     * debug screen.
+     *
+     * Internal — partners use `<UseSmileIDBuilder>`, which calls this
+     * method and dispatches on `kind` (success → render flow, invalid →
+     * fire `onResult.failure(BuilderValidationException)` and optionally
+     * render the debug screen).
+     *
+     * Validation rules (see `validate()` for non-throwing access from
+     * inside a builder closure):
+     *   1. The screens list must not be empty.
+     *   2. Screen ordering: consent must be first if present; processing
+     *      must be last if present; instructions must come before any
+     *      capture; every preview must be preceded by a capture.
+     *   3. Duplicate screen types are rejected (capture is exempt — a
+     *      flow may have both selfie and document capture).
+     *   4. ML configuration is required when any capture screen is
+     *      present.
+     *   5. Network configuration is required when a processing screen
+     *      is present.
+     *   6. The configured `jobType` may not be `unknown` once a
+     *      processing screen is wired.
+     *   7. Pre-supplied `consentInformation` and an in-flow consent
+     *      screen are mutually exclusive — exactly one source.
+     *   8. When set, `consentInformation` must have `granted: true`,
+     *      non-blank `grantedAt`, `noticeLanguage`, and
+     *      `noticePrivacyPolicyUrl`, and `grantedAt` must not parse to
+     *      a future timestamp.
+     *   9. When set, `EnhancedKYCParams` and `BiometricKYCParams` must
+     *      have non-blank `idType`, `idNumber`, `country`, and a
+     *      `userDetails` whose `givenNames` and `lastName` are non-blank
+     *      and whose `email` or `phoneNumber` (at least one) is set.
+     *
+     * @internal
+     */
+    build(): FlowBuildResult;
+}
+/**
+ * Frozen snapshot produced by `UseSmileIDFlowBuilder.build()`.
+ *
+ * `screens` is non-optional because `build()` rejects an empty
+ * screens block. `onResult` is non-optional because the builder
+ * defaults it to a no-op.
+ */
+export type FlowConfigurationSnapshot = {
+    readonly consentInformation?: ConsentInformation;
+    readonly enhancedKYCParams?: EnhancedKYCParams;
+    readonly biometricKYCParams?: BiometricKYCParams;
+    readonly documentVerificationParams?: DocumentVerificationParams;
+    readonly enhancedDocumentVerificationParams?: EnhancedDocumentVerificationParams;
+    readonly userDetails?: UserDetails;
+    readonly userId?: string;
+    readonly config?: ConfigOptions;
+    readonly theme?: ThemeConfiguration;
+    readonly network?: NetworkConfig;
+    readonly ml?: MLConfig;
+    readonly screens: ScreensConfig;
+    readonly localizations?: UseSmileIDLocalizations;
+    readonly onResult: (result: UseSmileIDResult<JobSubmissionResponse>) => void;
+    readonly onAnalyticsEvent?: (event: UseSmileIDAnalyticsEvent) => void;
+};
+//# sourceMappingURL=use_smile_id_flow_builder.d.ts.map

package/dist/presentation/flow/dsl/use_smile_id_flow_builder.d.ts.map

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

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

@@ -0,0 +1,308 @@
+import { UseSmileIDConfigBuilder } from "./builder/config_builder";
+import { ThemeConfigBuilder } from "./builder/theme_builder";
+import { UseSmileIDNetworkBuilder } from "../../../data/dsl/use_smile_id_network_builder";
+import { UseSmileIDMLBuilder } from "./builder/ml_builder";
+import { ScreensBuilder } from "./builder/screens_builder";
+import { firstErrorIssue, runBiometricKYCParamsValidation, runBuilderValidation, runConsentValidation, runDocumentVerificationParamsValidation, runEnhancedDocumentVerificationParamsValidation, runEnhancedKYCParamsValidation, runFlowValidation, runUserDetailsValidation, } from "../validation/flow_validator";
+import { ValidationState } from "../validation/validation_state";
+/**
+ * Top-level DSL builder.
+ *
+ * Closure-based block methods (`config`, `theme`, `network`, `ml`,
+ * `screens`) configure each section; mutable top-level properties
+ * (`consentInformation`, `enhancedKYCParams`, `biometricKYCParams`,
+ * `onResult`, `onAnalyticsEvent`) are assigned directly. The server
+ * issues `userId` / `jobId` and returns them in the submission
+ * response — partners receive them via `onResult`.
+ */
+export class UseSmileIDFlowBuilder {
+    /**
+     * Optional. Pre-supplied consent — if set, the consent screen is
+     * skipped.
+     */
+    consentInformation;
+    /** Optional. Required only for `JobType.enhancedKyc`. */
+    enhancedKYCParams;
+    /** Optional. Required only for `JobType.biometricKyc`. */
+    biometricKYCParams;
+    /** Optional. Required only for `JobType.documentVerification`. */
+    documentVerificationParams;
+    /** Optional. Required only for `JobType.enhancedDocumentVerification`. */
+    enhancedDocumentVerificationParams;
+    /**
+     * Required for any job that submits the `user_details` multipart
+     * part — `JobType.enhancedKyc`, `JobType.biometricKyc`,
+     * `JobType.smartSelfieEnrollment`, `JobType.smartSelfieAuthentication`
+     * (plus the two Enhanced selfie aliases). The same shape is sent on
+     * the wire as a JSON multipart part with snake_case keys.
+     *
+     * Previously carried inside `enhancedKYCParams` / `biometricKYCParams`
+     * — consolidated here so the smartSelfie* endpoints can carry it too
+     * (their v3 wire format also requires `user_details`).
+     */
+    userDetails;
+    /**
+     * Required for `JobType.smartSelfieAuthentication` (and its enhanced
+     * alias). The v3 `/v3/authentication` endpoint requires the partner to
+     * pass the `user_id` returned from a prior enrollment so the server
+     * can match the authentication attempt to the existing enrollment.
+     * Sent on the wire as a `user_id` multipart text form field.
+     */
+    userId;
+    /**
+     * Optional. Locale-resolved string overrides. The flow component
+     * wraps its tree with `<UseSmileIDLocalizationsProvider>` when this
+     * is set so all SDK screens read from it. Partners use any i18n
+     * stack to pick the right map and pass it here.
+     *
+     * If unset, screens render the canonical English defaults bundled
+     * with `strings_en.ts`.
+     */
+    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.
+     */
+    onResult = () => { };
+    /**
+     * Optional. Notified for each analytics event during the flow.
+     * Stub note: orchestrator does not yet emit events — see
+     * `docs/Architecture.md § Rollout`.
+     */
+    onAnalyticsEvent;
+    // --- Internal block builders ---------------------------------------------
+    _config;
+    _theme;
+    _network;
+    _ml;
+    _screens;
+    /**
+     * `b.config((c) => { c.enableCrashReporting = false; })`
+     *
+     * 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.
+     */
+    config(block) {
+        if (!this._config)
+            this._config = new UseSmileIDConfigBuilder();
+        block(this._config);
+    }
+    /**
+     * `b.theme((t) => { t.primaryColor = '#1A73E8'; t.buttonShape = 12; })`
+     *
+     * Each call replaces the prior theme builder — partners typically
+     * configure the theme in one place, and accumulating across helpers
+     * tends to surface as a fight over which call wrote `primaryColor`
+     * last. Replace semantics make the precedence local and obvious.
+     */
+    theme(block) {
+        this._theme = new ThemeConfigBuilder();
+        block(this._theme);
+    }
+    /**
+     * `b.network((n) => { n.config((c) => { c.partnerConfig((p) => { p.partnerId = ...; }); }); })`
+     *
+     * Each call replaces the prior network builder. Network config
+     * carries credentials and a job type, so partial composition across
+     * helpers is more likely to mask configuration errors than to help.
+     */
+    network(block) {
+        this._network = new UseSmileIDNetworkBuilder();
+        block(this._network);
+    }
+    /**
+     * `b.ml((m) => { m.analyzers((a) => { a.forCaptureType(CaptureType.selfie, (face) => face.add(useSmileIDVisionFace)); }); })`
+     */
+    ml(block) {
+        if (!this._ml)
+            this._ml = new UseSmileIDMLBuilder();
+        block(this._ml);
+    }
+    /**
+     * `b.screens((screens) => { screens.instructions(); screens.capture((c) => { c.captureType = CaptureType.selfie; }); })`
+     *
+     * Each screen-builder call appends a step to the orchestrator's
+     * flow list in declaration order.
+     */
+    screens(block) {
+        if (!this._screens)
+            this._screens = new ScreensBuilder();
+        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.
+     *
+     * The full rule set (screen ordering, dependency rules, KYC and
+     * consent payload validation, etc.) runs inside `build()` and is
+     * reflected in the [FlowBuildResult] surface; partners that want
+     * the full picture during configuration should call
+     * `useSmileIDBuilder(...)` and pattern-match on the returned
+     * `result.kind`.
+     */
+    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`.
+     */
+    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`.
+     */
+    validateEnhancedKYCParams(params) {
+        return ValidationState.invalid(runEnhancedKYCParamsValidation(params));
+    }
+    /**
+     * Validate a `BiometricKYCParams` payload in isolation. Same
+     * semantics as `validateEnhancedKYCParams` — same field rules,
+     * different param shape.
+     */
+    validateBiometricKYCParams(params) {
+        return ValidationState.invalid(runBiometricKYCParamsValidation(params));
+    }
+    /** Validate a `DocumentVerificationParams` payload in isolation. */
+    validateDocumentVerificationParams(params) {
+        return ValidationState.invalid(runDocumentVerificationParamsValidation(params));
+    }
+    /** Validate an `EnhancedDocumentVerificationParams` payload in isolation. */
+    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.
+     */
+    validateUserDetails(userDetails) {
+        return ValidationState.invalid(runUserDetailsValidation(userDetails));
+    }
+    /**
+     * Snapshot the current builder state and report the validation
+     * outcome as a [FlowBuildResult]. Returns `{kind: 'success', ...}`
+     * when every rule passed, or `{kind: 'invalid', ...}` carrying the
+     * issues, the partner's `onResult` callback, and the resolved
+     * `enableDebugMode` flag so the wrapper can route the failure
+     * through `onResult.failure` and decide whether to render the
+     * debug screen.
+     *
+     * Internal — partners use `<UseSmileIDBuilder>`, which calls this
+     * method and dispatches on `kind` (success → render flow, invalid →
+     * fire `onResult.failure(BuilderValidationException)` and optionally
+     * render the debug screen).
+     *
+     * Validation rules (see `validate()` for non-throwing access from
+     * inside a builder closure):
+     *   1. The screens list must not be empty.
+     *   2. Screen ordering: consent must be first if present; processing
+     *      must be last if present; instructions must come before any
+     *      capture; every preview must be preceded by a capture.
+     *   3. Duplicate screen types are rejected (capture is exempt — a
+     *      flow may have both selfie and document capture).
+     *   4. ML configuration is required when any capture screen is
+     *      present.
+     *   5. Network configuration is required when a processing screen
+     *      is present.
+     *   6. The configured `jobType` may not be `unknown` once a
+     *      processing screen is wired.
+     *   7. Pre-supplied `consentInformation` and an in-flow consent
+     *      screen are mutually exclusive — exactly one source.
+     *   8. When set, `consentInformation` must have `granted: true`,
+     *      non-blank `grantedAt`, `noticeLanguage`, and
+     *      `noticePrivacyPolicyUrl`, and `grantedAt` must not parse to
+     *      a future timestamp.
+     *   9. When set, `EnhancedKYCParams` and `BiometricKYCParams` must
+     *      have non-blank `idType`, `idNumber`, `country`, and a
+     *      `userDetails` whose `givenNames` and `lastName` are non-blank
+     *      and whose `email` or `phoneNumber` (at least one) is set.
+     *
+     * @internal
+     */
+    build() {
+        const screens = this._screens?.build();
+        const network = this._network?.build();
+        const mlConfig = this._ml?.build();
+        const issues = runFlowValidation({
+            steps: screens?.steps ?? [],
+            network,
+            ml: mlConfig,
+            consentInformation: this.consentInformation,
+            enhancedKYCParams: this.enhancedKYCParams,
+            biometricKYCParams: this.biometricKYCParams,
+            documentVerificationParams: this.documentVerificationParams,
+            enhancedDocumentVerificationParams: this.enhancedDocumentVerificationParams,
+            userDetails: this.userDetails,
+        });
+        const state = ValidationState.invalid(issues);
+        const blocking = firstErrorIssue(state);
+        if (blocking) {
+            // `state.valid` is `false` here: `blocking` is non-null only when
+            // the validator surfaced an error-severity issue, which forces
+            // `state` into the invalid branch.
+            const invalid = state;
+            return {
+                kind: "invalid",
+                validation: invalid,
+            };
+        }
+        // The validator's "screens not empty" rule is the only source of
+        // truth that guarantees `screens` is non-undefined here. Keep the
+        // invariant local rather than hiding it behind a `!` assertion so
+        // a future refactor that loosens the rule fails loudly with a
+        // descriptive error instead of silently returning a malformed
+        // snapshot.
+        if (!screens) {
+            throw new Error("UseSmileIDFlowBuilder: internal invariant violated — screens missing after validation passed.");
+        }
+        const configuration = Object.freeze({
+            ...(this.consentInformation
+                ? { consentInformation: this.consentInformation }
+                : {}),
+            ...(this.enhancedKYCParams
+                ? { enhancedKYCParams: this.enhancedKYCParams }
+                : {}),
+            ...(this.biometricKYCParams
+                ? { biometricKYCParams: this.biometricKYCParams }
+                : {}),
+            ...(this.documentVerificationParams
+                ? { documentVerificationParams: this.documentVerificationParams }
+                : {}),
+            ...(this.enhancedDocumentVerificationParams
+                ? {
+                    enhancedDocumentVerificationParams: this.enhancedDocumentVerificationParams,
+                }
+                : {}),
+            ...(this.userDetails ? { userDetails: this.userDetails } : {}),
+            ...(this.userId ? { userId: this.userId } : {}),
+            ...(this._config ? { config: this._config.build() } : {}),
+            ...(this._theme ? { theme: this._theme.build() } : {}),
+            ...(network ? { network } : {}),
+            ...(mlConfig ? { ml: mlConfig } : {}),
+            screens,
+            ...(this.localizations ? { localizations: this.localizations } : {}),
+            onResult: this.onResult,
+            ...(this.onAnalyticsEvent
+                ? { onAnalyticsEvent: this.onAnalyticsEvent }
+                : {}),
+        });
+        return { kind: "success", configuration };
+    }
+}
+//# sourceMappingURL=use_smile_id_flow_builder.js.map

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

@@ -0,0 +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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"}

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

@@ -0,0 +1,17 @@
+import { type ReactNode } from "react";
+import type { FlowNavigationManager } from "./flow_navigation_manager";
+export type FlowNavigationProviderProps = {
+    readonly manager: FlowNavigationManager;
+    readonly children: ReactNode;
+};
+export declare function FlowNavigationProvider({ manager, children, }: FlowNavigationProviderProps): import("react").JSX.Element;
+/**
+ * Read the active `FlowNavigationManager` from context. Throws if
+ * called outside a `<FlowNavigationProvider>` — concrete scenario
+ * this catches: a partner mounts a SDK screen directly (e.g.
+ * `<UseSmileIDConsentScreen>`) without `<UseSmileIDBuilder>` wrapping
+ * it. The throw makes the misuse loud at first render rather than
+ * silently no-op-ing on `navigateToNext()` / `navigateBack()` calls.
+ */
+export declare function useFlowNavigation(): FlowNavigationManager;
+//# sourceMappingURL=flow_navigation_context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow_navigation_context.d.ts","sourceRoot":"","sources":["../../../src/presentation/flow/flow_navigation_context.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAcvE,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,EACrC,OAAO,EACP,QAAQ,GACT,EAAE,2BAA2B,+BAM7B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,qBAAqB,CAUzD"}