@smileid/usesmileid 12.0.0-beta01

package/dist/presentation/flow/use_smile_id_flow.js

@@ -0,0 +1,264 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useReducer, useRef } from "react";
+import { Text, useColorScheme, View } from "react-native";
+import { FlowNavigationManager, } from "./flow_navigation_manager";
+import { FlowNavigationProvider } from "./flow_navigation_context";
+import { ScreenRenderer } from "./graph/screen_renderer";
+import { defaultDarkTheme, defaultLightTheme } from "../theme/theme";
+import { UseSmileIDThemeProvider } from "../theme/theme_context";
+import { useUseSmileIDFonts } from "../theme/use_use_smile_id_fonts";
+import { UseSmileIDCrashReporting } from "@smileid/usesmileid_bridge";
+import { generateSessionId } from "../../metadata/use_smile_id_metadata_factory";
+import { UseSmileIDLocalizationsProvider } from "../../l10n/use_smile_id_localizations_provider";
+import { UseSmileIDLocalizations } from "../../l10n/use_smile_id_localizations";
+import { cancelled, failure, success, } from "../../core/models/result";
+import { ValidationErrorScreen } from "./screen/validation_error_screen";
+import { BuilderValidationException } from "../../core/exception/builder_validation_exception";
+import { makeNetworkingFactory } from "../../data/factory/networking_factory";
+import { UseSmileIDRepositoryImpl } from "../../data/repository/use_smile_id_repository_impl";
+import { RetryStrategy, } from "../../core/models/network_config";
+/**
+ * Default retry policy when partner omits `b.network((n) => n.retry(...))`.
+ * Matches the `RetryConfigBuilder` defaults so behaviour stays consistent
+ * whether the partner constructs `network.retry` explicitly or not.
+ */
+const DEFAULT_RETRY = Object.freeze({
+    maxAttempts: 3,
+    strategy: RetryStrategy.exponential,
+    initialDelay: 1,
+    multiplier: 2,
+    maxDelay: 32,
+    jitter: 0.2,
+    fixedDelay: 1,
+});
+/**
+ * Routes the validation failure through the partner's `onResult`
+ * after first paint. When `enableDebugMode` is set on the builder,
+ * additionally renders [ValidationErrorScreen] with every failed
+ * rule so the partner has a complete picture during development.
+ * Production renders nothing — `onResult.failure` is the only
+ * surface partners see.
+ *
+ * `onResult` and `enableDebugMode` are passed in as separate props
+ * (sourced from the builder reference by `<UseSmileIDBuilder>`) rather
+ * than embedded on the `result`.
+ *
+ * @internal Used by `<UseSmileIDBuilder>`.
+ */
+export function FlowInvalidDispatcher({ result, onResult, enableDebugMode, }) {
+    const onResultRef = useRef(onResult);
+    onResultRef.current = onResult;
+    const validationRef = useRef(result.validation);
+    validationRef.current = result.validation;
+    useEffect(() => {
+        // Wrap the typed validation state in a BuilderValidationException
+        // so partner code receiving the failure via onResult.failure can
+        // inspect every rule that failed via `error.validationState.issues`,
+        // not only the first. The exception itself extends Error, so
+        // `instanceof Error` checks keep working.
+        const error = new BuilderValidationException(validationRef.current);
+        try {
+            onResultRef.current(failure(error));
+        }
+        catch (handlerError) {
+            UseSmileIDCrashReporting.captureException(handlerError);
+        }
+    }, []);
+    if (enableDebugMode) {
+        return _jsx(ValidationErrorScreen, { validationState: result.validation });
+    }
+    return null;
+}
+/**
+ * Walks the partner through the configured screen list, dispatches
+ * frames to the chosen analyzer, submits the resulting artifacts, and
+ * notifies the partner via `configuration.onResult`.
+ *
+ * **What's wired today:**
+ *   - `FlowNavigationManager` cursor — `navigateToNext()` /
+ *     `navigateBack()` advance the screen index and subscribers re-render.
+ *   - Crash reporting lifecycle — `enable()` on mount when
+ *     `configuration.config.enableCrashReporting !== false`, `disable()`
+ *     on unmount.
+ *   - Localizations resolution — explicit override → device-locale
+ *     auto-resolve → English defaults.
+ *   - Exit handling — converts `FlowExitReason` to `UseSmileIDResult`
+ *     and calls `configuration.onResult` (wrapped in try/catch routing
+ *     partner-handler exceptions through crash reporting).
+ *
+ * **Still stub:** the screen visuals themselves (see `screens/*.tsx`)
+ * and the analyzer-dispatch + job-submission pipeline. Cursor moves
+ * end-to-end today; analyzer wire-up is the next milestone.
+ *
+ * @internal Used by `<UseSmileIDBuilder>`.
+ */
+export function FlowSuccessRenderer({ configuration, }) {
+    // System color-scheme picks the variant. The partner-supplied theme
+    // bundle carries both light and dark resolved tokens; SDK defaults
+    // are used when the partner skips `b.theme((t) => …)`.
+    const systemScheme = useColorScheme();
+    const isDark = systemScheme === "dark";
+    const theme = configuration.theme
+        ? isDark
+            ? configuration.theme.dark
+            : configuration.theme.light
+        : isDark
+            ? defaultDarkTheme
+            : defaultLightTheme;
+    // Registers the bundled DM Sans faces (no-op after the first flow).
+    // Rendering does not wait on this — text re-renders into DM Sans the
+    // moment registration completes.
+    useUseSmileIDFonts();
+    const enableCrashReporting = configuration.config?.enableCrashReporting !== false;
+    // Per-flow session id used as the Sentry user-id so every event
+    // captured during this verification flow correlates under one issue
+    // thread. Generated once per mount; survives re-renders via `useRef`
+    // — useMemo would re-run if React decided to swap the inner element
+    // identity, but the id must outlive any render churn.
+    const flowSessionIdRef = useRef(null);
+    if (flowSessionIdRef.current === null) {
+        flowSessionIdRef.current = generateSessionId();
+    }
+    useEffect(() => {
+        if (enableCrashReporting) {
+            UseSmileIDCrashReporting.enable();
+            UseSmileIDCrashReporting.setUserId(flowSessionIdRef.current);
+            UseSmileIDCrashReporting.captureBreadcrumb({
+                category: "flow.navigation",
+                message: "flow mounted",
+            });
+        }
+        return () => {
+            UseSmileIDCrashReporting.disable();
+        };
+    }, [enableCrashReporting]);
+    // `onResult` lives in a ref so the manager's `onExit` closure
+    // captures the latest partner callback without recreating the
+    // manager on every parent render.
+    const onResultRef = useRef(configuration.onResult);
+    onResultRef.current = configuration.onResult;
+    // Force-update reducer drives re-renders when the manager's cursor
+    // or captured artifacts change. Cheaper than mirroring state into
+    // React state — the manager is the single source of truth.
+    const [, forceUpdate] = useReducer((x) => x + 1, 0);
+    // Repository is built once per `network` config — partner-supplied
+    // `partnerConfig` is required (the auth interceptor stamps the
+    // partner-supplied `token` and `partnerId` onto every request).
+    // When omitted, the
+    // manager surfaces a `failure` state from `_assembleJob` rather
+    // than crashing on construction; this lets capture-only / UI-only
+    // smoke harnesses mount `<UseSmileIDBuilder>` without network.
+    // Repository + the per-flow metadata provider are built together
+    // from a single `makeNetworkingFactory` call so they share one
+    // metadata factory (stable `session_id` across every submission).
+    // The provider is handed to the manager, which stamps a fresh
+    // snapshot onto each assembled `JobRequest`; the repository's API
+    // layer then serializes `request.metadata` as the `metadata`
+    // multipart part.
+    const submission = useMemo(() => {
+        const network = configuration.network;
+        if (!network?.config?.partnerConfig)
+            return undefined;
+        const { api, metadata } = makeNetworkingFactory(network);
+        const retry = network.retry ?? DEFAULT_RETRY;
+        return {
+            repository: new UseSmileIDRepositoryImpl(api, retry),
+            metadataProvider: metadata,
+        };
+    }, [configuration.network]);
+    const manager = useMemo(() => {
+        const handleExit = (reason) => {
+            const onResult = onResultRef.current;
+            try {
+                if (reason.kind === "completed") {
+                    // `reason.job` carries the full `JobSubmissionResponse` from
+                    // the successful submission. When the flow completes without
+                    // a successful submission (e.g. no processing screen wired),
+                    // string fields are empty.
+                    onResult(success(reason.job));
+                }
+                else if (reason.kind === "cancelled") {
+                    // User deliberately exited (e.g. back out of the first screen).
+                    // A distinct cancelled result — not a failure.
+                    onResult(cancelled());
+                }
+                else {
+                    onResult(failure(reason.error));
+                }
+            }
+            catch (handlerError) {
+                // Concrete scenario: partner's `onResult` throws (e.g. their
+                // navigation stack is in an invalid state). Don't let that
+                // crash the SDK — capture and continue.
+                UseSmileIDCrashReporting.captureException(handlerError);
+            }
+        };
+        return new FlowNavigationManager({
+            configuration,
+            onExit: handleExit,
+            // Conditional spread — `exactOptionalPropertyTypes: true` rejects
+            // an explicit `undefined` for the optional `repository` /
+            // `metadataProvider` fields. Both come from the same memoized
+            // `submission` object so the metadata factory backing requests
+            // is the same one the API serializes.
+            ...(submission
+                ? {
+                    repository: submission.repository,
+                    metadataProvider: submission.metadataProvider,
+                }
+                : {}),
+        });
+        // Manager is intentionally instantiated once per `configuration` /
+        // `submission` reference. Partners should memoize `configuration` via
+        // `useMemo<FlowConfiguration>(...)`; if they swap to a new flow they
+        // should remount `<UseSmileIDBuilder>`.
+    }, [configuration, submission]);
+    useEffect(() => {
+        const unsubscribe = manager.subscribe(forceUpdate);
+        return () => {
+            unsubscribe();
+            manager.dispose();
+        };
+    }, [manager]);
+    // Resolve localizations:
+    //   1. Explicit `configuration.localizations` (partner-set on the
+    //      builder) — wins over everything.
+    //   2. Auto-resolved from the registry via the device locale
+    //      (`UseSmileIDLocalizations.forActiveLocale()`) when partners
+    //      registered locales with `UseSmileIDLocalizations.register(...)`.
+    //   3. English defaults — no provider mounted, screens read from
+    //      the context's default English-only instance.
+    const resolved = useMemo(() => {
+        if (configuration.localizations)
+            return configuration.localizations;
+        if (UseSmileIDLocalizations.hasRegisteredLocales()) {
+            return UseSmileIDLocalizations.forActiveLocale();
+        }
+        return null;
+    }, [configuration.localizations]);
+    const step = manager.currentScreen;
+    // Empty-screens sentinel: a partner who forgot to call
+    // `b.screens(...)` would otherwise see a blank screen with no clue
+    // why. Render an explicit hint instead.
+    const inner = step ? (_jsx(FlowNavigationProvider, { manager: manager, children: _jsx(ScreenRenderer, { step: step }, `${manager.currentDepth}:${step.kind}`) })) : (_jsxs(View, { style: {
+            flex: 1,
+            alignItems: "center",
+            justifyContent: "center",
+            backgroundColor: theme.colors.background,
+            padding: theme.spacing.large,
+        }, children: [_jsx(Text, { style: {
+                    ...theme.typography.pageHeading,
+                    color: theme.colors.titleText,
+                }, children: "UseSmileID" }), _jsx(Text, { style: { ...theme.typography.body, color: theme.colors.cardText }, children: "No screens configured — call `b.screens((screens) => screens.instructions(); ...)`" })] }));
+    // Theme provider always mounts so deep partner widgets can read
+    // via `useUseSmileIDTheme()` without having to wrap manually.
+    // Localizations provider only mounts when registered locales
+    // resolve — the context default (English) covers the no-provider
+    // path without an extra wrapper.
+    const themed = (_jsx(UseSmileIDThemeProvider, { value: theme, children: inner }));
+    if (resolved) {
+        return (_jsx(UseSmileIDLocalizationsProvider, { value: resolved, children: themed }));
+    }
+    return themed;
+}
+//# sourceMappingURL=use_smile_id_flow.js.map

package/dist/presentation/flow/use_smile_id_flow.js.map

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

package/dist/presentation/flow/validation/flow_validator.d.ts

@@ -0,0 +1,107 @@
+import type { MLConfig } from "../../../core/models/ml_config";
+import type { NetworkConfig } from "../../../core/models/network_config";
+import type { BiometricKYCParams, ConsentInformation, DocumentVerificationParams, EnhancedDocumentVerificationParams, EnhancedKYCParams, UserDetails } from "../../../core/models/params";
+import type { ScreenSpec } from "../dsl/builder/screens_builder";
+import { ValidationState, type ValidationIssue } from "./validation_state";
+/**
+ * Pure flow validator — returns typed `UseSmileIDValidationException`
+ * instances. The same instances are exposed via `b.validate()` and
+ * thrown by `b.build()` (after picking the first `error`-severity
+ * issue), so partner regex-matchers and `instanceof` checks see the
+ * same object whether they're inspecting validate-state or catching
+ * a thrown error.
+ *
+ * `runFlowValidation` owns only the builder / job-agnostic concerns:
+ * empty screens, per-screen capture / consent config, ML / Network
+ * block presence, missing job type, the standalone param validators,
+ * and the consent-mutex check. Every flow-composition rule — screen
+ * ordering, duplicate screen types, preview placement, analyzer
+ * dependencies, and per-job field requirements — is owned by the
+ * per-`JobType` validators in `job_type_validator.ts`, dispatched via
+ * `collectJobTypeIssues`.
+ *
+ * Rule order, message wording, severity, and `errorCode` values are
+ * the contract surface partners see. Don't reword existing rules
+ * without a coordinated change — partner tooling regex-matches on
+ * the message text and pivots on the `errorCode`.
+ */
+type FlowValidatorInput = {
+    readonly steps: readonly ScreenSpec[];
+    readonly network?: NetworkConfig | undefined;
+    readonly ml?: MLConfig | undefined;
+    readonly consentInformation?: ConsentInformation | undefined;
+    readonly enhancedKYCParams?: EnhancedKYCParams | undefined;
+    readonly biometricKYCParams?: BiometricKYCParams | undefined;
+    readonly documentVerificationParams?: DocumentVerificationParams | undefined;
+    readonly enhancedDocumentVerificationParams?: EnhancedDocumentVerificationParams | undefined;
+    readonly userDetails?: UserDetails | undefined;
+};
+/**
+ * Quick triage of the in-progress builder state. Today the only rule
+ * surfaced is the empty-screens-block error — `b.screens(...)` must
+ * register at least one screen before the builder can produce a flow.
+ * `b.validate()` calls this; the full rule set runs inside `build()`.
+ */
+export declare function runBuilderValidation(steps: readonly ScreenSpec[]): ValidationIssue[];
+/**
+ * Run every flow-level validation rule and return the collected
+ * issues. Empty array means valid.
+ *
+ * Rule order is deterministic so callers diffing two outputs see
+ * stable output. `build()` returns `{kind: 'invalid'}` carrying these
+ * issues when any are `error`-severity.
+ */
+export declare function runFlowValidation(input: FlowValidatorInput): ValidationIssue[];
+/**
+ * Validate an `EnhancedKYCParams` payload in isolation. Used by
+ * `b.validateEnhancedKYCParams(params)` so partners can pre-flight a
+ * payload before assigning it to the builder.
+ */
+export declare function runEnhancedKYCParamsValidation(params: EnhancedKYCParams): ValidationIssue[];
+/**
+ * Validate a `BiometricKYCParams` payload in isolation. Used by
+ * `b.validateBiometricKYCParams(params)`.
+ */
+export declare function runBiometricKYCParamsValidation(params: BiometricKYCParams): ValidationIssue[];
+/**
+ * Validate a `DocumentVerificationParams` payload in isolation. `country`
+ * must be non-blank; `idType` is optional, but a present-but-blank value
+ * is rejected.
+ */
+export declare function runDocumentVerificationParamsValidation(params: DocumentVerificationParams): ValidationIssue[];
+/**
+ * Validate an `EnhancedDocumentVerificationParams` payload in isolation.
+ * Both `country` and `idType` are required and must be non-blank.
+ */
+export declare function runEnhancedDocumentVerificationParamsValidation(params: EnhancedDocumentVerificationParams): ValidationIssue[];
+/**
+ * Validate a `ConsentInformation` payload in isolation. Used by
+ * `b.validateConsent(consent)` so partners can pre-flight a payload
+ * pulled from their own storage before assigning it to the builder.
+ */
+export declare function runConsentValidation(consent: ConsentInformation): ValidationIssue[];
+/**
+ * Validate a top-level `UserDetails` payload. Required fields use the
+ * dotted path (`userDetails.givenNames`) so partner regex-matchers
+ * keep working unchanged after the consolidation away from nesting
+ * `userDetails` inside the KYC param shapes.
+ *
+ * Exposed via `b.validateUserDetails(payload)` so partners can
+ * pre-flight a payload before assigning to `b.userDetails`, mirroring
+ * the existing `b.validateConsent` / `b.validateEnhancedKYCParams`
+ * pattern.
+ */
+export declare function runUserDetailsValidation(userDetails: UserDetails): ValidationIssue[];
+/**
+ * Find the first `error`-severity issue in a state. Returns
+ * `undefined` for a valid state, or for a state whose only issues
+ * are `warning`-severity (which never block `build()`).
+ *
+ * `build()` calls this to convert validator output into a thrown
+ * `Error` (the issue itself, since every issue is also an exception
+ * class). Partner regex on the message keeps working across the
+ * refactor.
+ */
+export declare function firstErrorIssue(state: ValidationState): ValidationIssue | undefined;
+export {};
+//# sourceMappingURL=flow_validator.d.ts.map

package/dist/presentation/flow/validation/flow_validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow_validator.d.ts","sourceRoot":"","sources":["../../../../src/presentation/flow/validation/flow_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,EAC1B,kCAAkC,EAClC,iBAAiB,EACjB,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAmBjE,OAAO,EAAE,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG3E;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,KAAK,kBAAkB,GAAG;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,EAAE,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,0BAA0B,CAAC,EAAE,0BAA0B,GAAG,SAAS,CAAC;IAC7E,QAAQ,CAAC,kCAAkC,CAAC,EACxC,kCAAkC,GAClC,SAAS,CAAC;IACd,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAChD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,UAAU,EAAE,GAC3B,eAAe,EAAE,CAMnB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,GACxB,eAAe,EAAE,CAwJnB;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,iBAAiB,GACxB,eAAe,EAAE,CAEnB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,kBAAkB,GACzB,eAAe,EAAE,CAEnB;AAED;;;;GAIG;AACH,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,0BAA0B,GACjC,eAAe,EAAE,CAmBnB;AAED;;;GAGG;AACH,wBAAgB,+CAA+C,CAC7D,MAAM,EAAE,kCAAkC,GACzC,eAAe,EAAE,CAcnB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,kBAAkB,GAC1B,eAAe,EAAE,CAuBnB;AAuBD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,WAAW,GACvB,eAAe,EAAE,CA2BnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,eAAe,GACrB,eAAe,GAAG,SAAS,CAG7B"}