@smileid/usesmileid 12.0.0-beta01

package/dist/presentation/flow/validation/job_type_validator.js

@@ -0,0 +1,420 @@
+import { JobType } from "../../../core/models/job_type";
+import { CaptureType } from "../dsl/builder/screens_builder";
+import { InvalidJobTypeScreenConfigException } from "../../../core/exception/job_validation_exceptions";
+import { DuplicateScreenTypeException, InvalidScreenOrderException, MissingCaptureForPreviewException, } from "../../../core/exception/screen_config_validation_exceptions";
+import { IssueSeverity } from "../../../core/exception/issue_severity";
+/**
+ * Stable display label for a `JobType` enum value, matching the
+ * canonical name carried in the `Invalid configuration for {name}:`
+ * message string. The DSL-facing `JobType` keys are camelCase; this map
+ * supplies the PascalCase label used in partner-visible copy.
+ */
+const JOB_TYPE_NAMES = new Map([
+    [JobType.biometricKyc, "BiometricKyc"],
+    [JobType.smartSelfieAuthentication, "SmartSelfieAuthentication"],
+    [JobType.smartSelfieEnrollment, "SmartSelfieEnrollment"],
+    [JobType.enhancedKyc, "EnhancedKyc"],
+    [JobType.documentVerification, "DocumentVerification"],
+    [JobType.bvn, "BVN"],
+    [JobType.enhancedDocumentVerification, "EnhancedDocumentVerification"],
+    [JobType.unknown, "Unknown"],
+]);
+/**
+ * Resolve the partner-visible label for a `JobType` value.
+ */
+function jobTypeName(jobType) {
+    return JOB_TYPE_NAMES.get(jobType) ?? "Unknown";
+}
+/**
+ * Consent rule: exactly one form of consent is required — either a
+ * Consent screen or pre-supplied `consentInformation`, never both and
+ * never neither.
+ */
+function appendConsentRule(jobType, input, issues) {
+    const hasConsentScreen = input.steps.some((s) => s.kind === "consent");
+    const hasConsentInformation = input.consentInformation !== undefined;
+    if (!hasConsentScreen && !hasConsentInformation) {
+        issues.push(InvalidJobTypeScreenConfigException.forJob({
+            jobType,
+            reason: "must include either a Consent screen or a pre-supplied consentInformation",
+            suggestedFix: "Add a consent { } screen to your flow, or supply consentInformation via the builder",
+        }));
+    }
+    else if (hasConsentScreen && hasConsentInformation) {
+        issues.push(InvalidJobTypeScreenConfigException.forJob({
+            jobType,
+            reason: "must not include both a Consent screen and a pre-supplied consentInformation — use one or the other",
+            suggestedFix: "Remove the consent { } screen if supplying consentInformation, or clear consentInformation if using the consent screen",
+        }));
+    }
+}
+/**
+ * Reject more than one screen of any non-Capture, non-Preview type.
+ * Capture screens may repeat (selfie + document) and Preview screens are
+ * governed by the per-job preview rule instead, so both are excluded.
+ */
+function appendDuplicateScreenRule(steps, issues) {
+    const indicesByKind = new Map();
+    steps.forEach((step, index) => {
+        if (step.kind === "capture" || step.kind === "preview")
+            return;
+        const list = indicesByKind.get(step.kind) ?? [];
+        list.push(index);
+        indicesByKind.set(step.kind, list);
+    });
+    for (const [kind, indices] of indicesByKind) {
+        if (indices.length > 1) {
+            issues.push(new DuplicateScreenTypeException({ screenType: kind, indices }));
+        }
+    }
+}
+/**
+ * Enforce consent-first, processing-last, and instructions-before-capture
+ * ordering. Preview ordering is handled by `appendPreviewRule`.
+ */
+function appendScreenOrderRule(steps, issues) {
+    const consentIndex = steps.findIndex((s) => s.kind === "consent");
+    if (consentIndex > 0) {
+        issues.push(new InvalidScreenOrderException({
+            description: "Consent screen must be the first screen in the flow",
+            severity: IssueSeverity.error,
+        }));
+    }
+    const processingIndex = steps.findIndex((s) => s.kind === "processing");
+    if (processingIndex !== -1 && processingIndex !== steps.length - 1) {
+        issues.push(new InvalidScreenOrderException({
+            description: "Processing screen must be the last screen in the flow",
+            severity: IssueSeverity.error,
+        }));
+    }
+    let hasCaptureBeforeThisPoint = false;
+    steps.forEach((step, index) => {
+        if (step.kind === "capture") {
+            hasCaptureBeforeThisPoint = true;
+        }
+        else if (step.kind === "instructions" && hasCaptureBeforeThisPoint) {
+            issues.push(new InvalidScreenOrderException({
+                description: `Instructions screen at index ${index} must appear before the Capture screen`,
+                severity: IssueSeverity.error,
+            }));
+        }
+    });
+}
+/**
+ * Preview rule for flows that allow at most `maxPreviews` preview
+ * screens, each of which must follow a Capture screen. A preview with
+ * no preceding capture emits `MissingCaptureForPreviewException`; an
+ * extra preview beyond `maxPreviews` emits `InvalidScreenOrderException`.
+ */
+function appendPreviewRule(steps, maxPreviews, issues) {
+    let hasCaptureBeforeThisPoint = false;
+    let previewCount = 0;
+    steps.forEach((step, index) => {
+        if (step.kind === "capture") {
+            hasCaptureBeforeThisPoint = true;
+        }
+        else if (step.kind === "preview") {
+            previewCount += 1;
+            if (!hasCaptureBeforeThisPoint) {
+                issues.push(new MissingCaptureForPreviewException({ previewIndex: index }));
+            }
+            else if (previewCount > maxPreviews) {
+                issues.push(new InvalidScreenOrderException({
+                    description: `Preview screen at index ${index} exceeds the maximum of ${maxPreviews} preview screen(s) allowed for this flow`,
+                    severity: IssueSeverity.error,
+                }));
+            }
+        }
+    });
+}
+/**
+ * Processing screen is required for every job type. The companion
+ * `network { }` block requirement is surfaced by `FlowValidator`
+ * (job-agnostic) to keep a single emission point.
+ */
+function appendProcessingRule(jobType, input, issues) {
+    const hasProcessingScreen = input.steps.some((s) => s.kind === "processing");
+    if (!hasProcessingScreen) {
+        issues.push(InvalidJobTypeScreenConfigException.forJob({
+            jobType,
+            reason: "must include a Processing screen",
+            suggestedFix: "Add a processing { } screen as the last screen in the flow",
+        }));
+    }
+}
+/**
+ * Enforce exactly one selfie Capture screen.
+ */
+function appendSelfieCaptureRule(jobType, input, issues) {
+    const selfieCaptures = input.steps.filter((s) => s.kind === "capture" && s.config.captureType === CaptureType.selfie);
+    if (selfieCaptures.length === 0) {
+        issues.push(InvalidJobTypeScreenConfigException.forJob({
+            jobType,
+            reason: "must include exactly one Capture screen with captureType = SELFIE",
+            suggestedFix: "Add a capture { captureType = CaptureType.SELFIE } screen to your flow",
+        }));
+    }
+    else if (selfieCaptures.length > 1) {
+        issues.push(InvalidJobTypeScreenConfigException.forJob({
+            jobType,
+            reason: `must include exactly one Capture screen with captureType = SELFIE, but found ${selfieCaptures.length}`,
+            suggestedFix: "Remove the extra selfie capture screens — only one is allowed",
+        }));
+    }
+}
+/**
+ * Validate the selfie ML analyzer dependency. A Capture screen requires
+ * an `ml { }` block, and that block must register analyzers for
+ * `CaptureType.SELFIE`. The missing-block warning is owned by
+ * `FlowValidator`; this rule emits only the error-severity
+ * `InvalidJobTypeScreenConfigException`.
+ */
+function appendSelfieMlRule(jobType, input, missingMlSuggestedFix, issues) {
+    if (!input.ml) {
+        issues.push(InvalidJobTypeScreenConfigException.forJob({
+            jobType,
+            reason: "ml { } block is required and must register analyzers for CaptureType.SELFIE",
+            suggestedFix: missingMlSuggestedFix,
+        }));
+    }
+    else if (!input.ml.analyzers.selfie) {
+        issues.push(InvalidJobTypeScreenConfigException.forJob({
+            jobType,
+            reason: "ml { } block must register analyzers for CaptureType.SELFIE",
+            suggestedFix: "Add forCaptureType(CaptureType.SELFIE) { } inside the ml { } block",
+        }));
+    }
+}
+/**
+ * Validates selfie-only flows: BiometricKyc, SmartSelfieAuthentication,
+ * SmartSelfieEnrollment.
+ *
+ * Allows at most one Preview screen, which must follow a Capture screen.
+ */
+export class SelfieJobTypeValidator {
+    jobType;
+    constructor(jobType) {
+        this.jobType = jobType;
+    }
+    validate(input, issues) {
+        appendDuplicateScreenRule(input.steps, issues);
+        appendScreenOrderRule(input.steps, issues);
+        appendPreviewRule(input.steps, 1, issues);
+        appendConsentRule(this.jobType, input, issues);
+        appendSelfieCaptureRule(this.jobType, input, issues);
+        const hasDocumentCapture = input.steps.some((s) => s.kind === "capture" && s.config.captureType === CaptureType.document);
+        if (hasDocumentCapture) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: "must not include a Document capture screen",
+                suggestedFix: `Remove the Document capture screen — ${jobTypeName(this.jobType)} requires selfie capture only`,
+            }));
+        }
+        appendProcessingRule(this.jobType, input, issues);
+        appendSelfieMlRule(this.jobType, input, "Add the ml { } block with forCaptureType(CaptureType.SELFIE) { } inside", issues);
+        if (input.ml?.analyzers.document) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: "ml { } block must not register analyzers for CaptureType.DOCUMENT",
+                suggestedFix: `Remove forCaptureType(CaptureType.DOCUMENT) { } from the ml { } block — ${jobTypeName(this.jobType)} does not use document capture`,
+            }));
+        }
+        if (this.jobType === JobType.biometricKyc &&
+            input.biometricKYCParams === undefined) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: "biometricKYCParams is required for BiometricKyc jobs",
+                suggestedFix: "Set builder.biometricKYCParams with the identity fields before building",
+            }));
+        }
+        if (input.userDetails === undefined) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: `userDetails is required for ${jobTypeName(this.jobType)} jobs`,
+                suggestedFix: "Set builder.userDetails with the end user PII before building",
+            }));
+        }
+    }
+}
+/**
+ * Validates document flows: DocumentVerification,
+ * EnhancedDocumentVerification.
+ *
+ * Allows up to two Preview screens (a selfie-step preview and a
+ * document-step preview); each must follow a Capture screen. The
+ * document analyzer is optional — the native pipeline falls back to a
+ * noop document detector — but a selfie analyzer is required for the
+ * biometric match against the document portrait.
+ */
+export class DocumentJobTypeValidator {
+    jobType;
+    constructor(jobType) {
+        this.jobType = jobType;
+    }
+    validate(input, issues) {
+        appendDuplicateScreenRule(input.steps, issues);
+        appendScreenOrderRule(input.steps, issues);
+        appendPreviewRule(input.steps, 2, issues);
+        appendConsentRule(this.jobType, input, issues);
+        appendSelfieCaptureRule(this.jobType, input, issues);
+        const documentCaptures = input.steps.filter((s) => s.kind === "capture" && s.config.captureType === CaptureType.document);
+        if (documentCaptures.length === 0) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: "must include exactly one Capture screen with captureType = DOCUMENT",
+                suggestedFix: "Add a capture { captureType = CaptureType.DOCUMENT } screen to your flow",
+            }));
+        }
+        else if (documentCaptures.length > 1) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: `must include exactly one Capture screen with captureType = DOCUMENT, but found ${documentCaptures.length}`,
+                suggestedFix: "Remove the extra document capture screens — only one is allowed",
+            }));
+        }
+        appendProcessingRule(this.jobType, input, issues);
+        // CaptureType.DOCUMENT uses a noop document detector by default — no
+        // explicit registration required.
+        appendSelfieMlRule(this.jobType, input, "Add the ml { } block with forCaptureType(CaptureType.SELFIE) { } inside — document capture uses NoopDocumentDetectorAnalyzer by default", issues);
+        this.appendParamsRule(input, issues);
+        if (input.userDetails === undefined) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: `userDetails is required for ${jobTypeName(this.jobType)} jobs`,
+                suggestedFix: "Set builder.userDetails with the end user PII before building",
+            }));
+        }
+    }
+    /**
+     * Require the params object for each document job. Per-field blank
+     * checks live in the standalone validators in `flow_validator.ts`.
+     */
+    appendParamsRule(input, issues) {
+        if (this.jobType === JobType.documentVerification &&
+            input.documentVerificationParams === undefined) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: "documentVerificationParams is required for DocumentVerification jobs",
+                suggestedFix: "Set builder.documentVerificationParams with the country (and optional idType) before building",
+            }));
+        }
+        if (this.jobType === JobType.enhancedDocumentVerification &&
+            input.enhancedDocumentVerificationParams === undefined) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: "enhancedDocumentVerificationParams is required for EnhancedDocumentVerification jobs",
+                suggestedFix: "Set builder.enhancedDocumentVerificationParams with the country and idType before building",
+            }));
+        }
+    }
+}
+/**
+ * Validates non-capture flows: EnhancedKyc, BVN.
+ *
+ * No capture happens, so no Preview screen is permitted. The flow must
+ * consist of consent (in-flow or pre-supplied) followed by processing.
+ * Enhanced KYC additionally requires `enhancedKYCParams` and
+ * `userDetails`.
+ */
+export class NonCaptureJobTypeValidator {
+    jobType;
+    constructor(jobType) {
+        this.jobType = jobType;
+    }
+    validate(input, issues) {
+        appendDuplicateScreenRule(input.steps, issues);
+        appendScreenOrderRule(input.steps, issues);
+        appendPreviewRule(input.steps, 0, issues);
+        appendConsentRule(this.jobType, input, issues);
+        appendProcessingRule(this.jobType, input, issues);
+        const disallowedScreens = input.steps.filter((s) => s.kind !== "consent" && s.kind !== "processing");
+        if (disallowedScreens.length > 0) {
+            const types = [...new Set(disallowedScreens.map((s) => s.kind))].join(", ");
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: `must only contain consent and processing screens, but found: ${types}`,
+                suggestedFix: "Remove all screens except consent { } and processing { } from your flow",
+            }));
+        }
+        if (this.jobType === JobType.enhancedKyc &&
+            input.enhancedKYCParams === undefined) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: "enhancedKYCParams is required for EnhancedKyc jobs",
+                suggestedFix: "Set builder.enhancedKYCParams with the identity fields before building",
+            }));
+        }
+        if (this.jobType === JobType.enhancedKyc &&
+            input.userDetails === undefined) {
+            issues.push(InvalidJobTypeScreenConfigException.forJob({
+                jobType: this.jobType,
+                reason: "userDetails is required for EnhancedKyc jobs",
+                suggestedFix: "Set builder.userDetails with the end user PII before building",
+            }));
+        }
+    }
+}
+/**
+ * Generic structural validator used when no concrete `JobType` is
+ * resolved yet (e.g. a UI-only flow without a `network { }` block). It
+ * applies only the job-agnostic structural rules so partners still get
+ * screen-order / duplicate / preview feedback while prototyping. A
+ * single Preview following a Capture is permitted by default.
+ */
+export class DefaultStructuralValidator {
+    validate(input, issues) {
+        appendDuplicateScreenRule(input.steps, issues);
+        appendScreenOrderRule(input.steps, issues);
+        appendPreviewRule(input.steps, 1, issues);
+    }
+}
+/**
+ * Registry mapping each `JobType` to its validator instance. Adding a new job
+ * type is a one-line registry change here; the validator runs the union of
+ * the per-type rules (consent + selfie / document / etc.) declared above.
+ */
+export const jobTypeValidators = new Map([
+    [JobType.biometricKyc, new SelfieJobTypeValidator(JobType.biometricKyc)],
+    [
+        JobType.smartSelfieAuthentication,
+        new SelfieJobTypeValidator(JobType.smartSelfieAuthentication),
+    ],
+    [
+        JobType.smartSelfieEnrollment,
+        new SelfieJobTypeValidator(JobType.smartSelfieEnrollment),
+    ],
+    [
+        JobType.documentVerification,
+        new DocumentJobTypeValidator(JobType.documentVerification),
+    ],
+    [
+        JobType.enhancedDocumentVerification,
+        new DocumentJobTypeValidator(JobType.enhancedDocumentVerification),
+    ],
+    [JobType.enhancedKyc, new NonCaptureJobTypeValidator(JobType.enhancedKyc)],
+    [JobType.bvn, new NonCaptureJobTypeValidator(JobType.bvn)],
+]);
+const defaultStructuralValidator = new DefaultStructuralValidator();
+/**
+ * Resolve the validator for the configured job type, falling back to the
+ * generic structural validator when the job type is unknown or
+ * unregistered. Always returns a validator so the generic structural
+ * rules run regardless of dispatch.
+ */
+export function resolveJobTypeValidator(jobType) {
+    if (jobType === undefined || jobType === JobType.unknown) {
+        return defaultStructuralValidator;
+    }
+    return jobTypeValidators.get(jobType) ?? defaultStructuralValidator;
+}
+/**
+ * Run the job-type-specific rules against the flow and append any issues
+ * found. Called by `FlowValidator` after its generic builder pass. The
+ * matching validator is resolved from the configured `jobType`, with the
+ * generic structural validator as the fallback for unknown job types.
+ */
+export function collectJobTypeIssues(input, issues) {
+    const jobType = input.network?.config?.jobType;
+    resolveJobTypeValidator(jobType).validate(input, issues);
+}
+//# sourceMappingURL=job_type_validator.js.map

package/dist/presentation/flow/validation/job_type_validator.js.map

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

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

@@ -0,0 +1,59 @@
+import { IssueSeverity } from "../../../core/exception/issue_severity";
+import type { UseSmileIDValidationException } from "../../../core/exception/use_smile_id_validation_exception";
+export { IssueSeverity };
+/**
+ * Validation state types.
+ *
+ * The shape is a discriminated union: narrow on `valid` to access
+ * `issues`. Compile-time exhaustiveness via `switch (state.valid)`.
+ */
+/**
+ * One validation finding. Each issue is a typed exception subclass —
+ * partners can `instanceof EmptyScreensBlockException` /
+ * `instanceof InvalidScreenOrderException` etc. to narrow on the
+ * specific rule, or pivot on `errorCode` for an exhaustive switch.
+ *
+ * Type alias rather than a separate plain-object record so the
+ * validator output and the thrown exception are the same value —
+ * partner tooling that forwards issues across platforms reads the
+ * same fields everywhere.
+ */
+export type ValidationIssue = UseSmileIDValidationException;
+/**
+ * Result of running the flow validator.
+ *
+ * - `valid: true` — every rule passed (no errors and no warnings).
+ * - `valid: false` — at least one error issue. `issues` is non-empty
+ *   and may contain a mix of `error` and `warning` entries.
+ */
+export type ValidationState = {
+    readonly valid: true;
+} | ValidationStateInvalid;
+/**
+ * The invalid branch of [ValidationState] — carries one or more typed
+ * validation issues. `FlowBuildResult.invalid` payloads,
+ * `BuilderValidationException.validationState`, and the `b.validate()`
+ * invalid result all use this exact shape.
+ */
+export type ValidationStateInvalid = {
+    readonly valid: false;
+    readonly issues: readonly ValidationIssue[];
+};
+/**
+ * Construct a `ValidationState`.
+ *
+ * `ValidationState.valid` returns the canonical "no issues" sentinel
+ * (frozen) — partners can compare via `state.valid === true` without
+ * worrying about reference identity.
+ *
+ * `ValidationState.invalid(issues)` returns a frozen invalid state.
+ * If `issues` is empty, returns the valid sentinel — `validate()`
+ * implementations don't need to special-case the empty path.
+ */
+export declare const ValidationState: {
+    readonly valid: {
+        readonly valid: true;
+    };
+    readonly invalid: (issues: readonly ValidationIssue[]) => ValidationState;
+};
+//# sourceMappingURL=validation_state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation_state.d.ts","sourceRoot":"","sources":["../../../../src/presentation/flow/validation/validation_state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AACvE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,2DAA2D,CAAC;AAE/G,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;;;GAKG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,eAAe,GAAG,6BAA6B,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG,sBAAsB,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C,CAAC;AAIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe;;wBA1BoB,IAAI;;+BA4BlC,SAAS,eAAe,EAAE,KAAG,eAAe;CAIpD,CAAC"}

package/dist/presentation/flow/validation/validation_state.js

@@ -0,0 +1,23 @@
+import { IssueSeverity } from "../../../core/exception/issue_severity";
+export { IssueSeverity };
+const VALID_STATE = Object.freeze({ valid: true });
+/**
+ * Construct a `ValidationState`.
+ *
+ * `ValidationState.valid` returns the canonical "no issues" sentinel
+ * (frozen) — partners can compare via `state.valid === true` without
+ * worrying about reference identity.
+ *
+ * `ValidationState.invalid(issues)` returns a frozen invalid state.
+ * If `issues` is empty, returns the valid sentinel — `validate()`
+ * implementations don't need to special-case the empty path.
+ */
+export const ValidationState = {
+    valid: VALID_STATE,
+    invalid(issues) {
+        if (issues.length === 0)
+            return VALID_STATE;
+        return Object.freeze({ valid: false, issues: Object.freeze([...issues]) });
+    },
+};
+//# sourceMappingURL=validation_state.js.map

package/dist/presentation/flow/validation/validation_state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation_state.js","sourceRoot":"","sources":["../../../../src/presentation/flow/validation/validation_state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAGvE,OAAO,EAAE,aAAa,EAAE,CAAC;AA0CzB,MAAM,WAAW,GAAoB,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,KAAK,EAAE,WAAW;IAClB,OAAO,CAAC,MAAkC;QACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,WAAW,CAAC;QAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;CACO,CAAC"}

package/dist/presentation/screen/helpers/capture_screen_helpers.d.ts

@@ -0,0 +1,29 @@
+import type { UseSmileIDOverlayState as OverlayState } from "../../state/use_smile_id_overlay_state";
+import type { UseSmileIDLocalizations } from "../../../l10n/use_smile_id_localizations";
+import type { SiKey } from "../../../l10n/strings_en";
+/**
+ * Pure-logic feedback helpers. Feedback travels as a stable `si_*` key
+ * so the coaching animation and copy resolution key off one value.
+ */
+/**
+ * Feedback key for a selfie overlay state with explicit guidance.
+ * Lifecycle states return `null` (copy resolved by `mapCaptureUiState`).
+ */
+export declare function selfieFeedbackKeyFor(state: OverlayState): SiKey | null;
+/** Document counterpart of {@link selfieFeedbackKeyFor}. */
+export declare function documentFeedbackKeyFor(state: OverlayState): SiKey | null;
+/** Resolve a stable feedback key to the active locale's copy. */
+export declare function resolveFeedbackCopy(key: SiKey, loc: UseSmileIDLocalizations): string;
+/**
+ * Overlay-state-only copy resolution for callers without a scan state;
+ * `mapCaptureUiState` is the richer path that also handles Enhanced
+ * Smart Selfie copy.
+ */
+export declare function resolveCaptureFeedback(state: OverlayState, loc: UseSmileIDLocalizations): string;
+/**
+ * Whether the start-capture button is enabled. "Start" begins the
+ * analyzer pipeline (not a snapshot), so it's enabled exactly during
+ * the pre-flight `INSTRUCTION` state — before the pipeline has started.
+ */
+export declare function isStartCaptureEnabled(state: OverlayState): boolean;
+//# sourceMappingURL=capture_screen_helpers.d.ts.map

package/dist/presentation/screen/helpers/capture_screen_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture_screen_helpers.d.ts","sourceRoot":"","sources":["../../../../src/presentation/screen/helpers/capture_screen_helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,IAAI,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACrG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACxF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,GAAG,IAAI,CA6BtE;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,GAAG,IAAI,CAaxE;AAmDD,iEAAiE;AACjE,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,KAAK,EACV,GAAG,EAAE,uBAAuB,GAC3B,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,uBAAuB,GAC3B,MAAM,CAcR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAElE"}