@smileid/usesmileid 12.0.0-beta01

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

@@ -0,0 +1,286 @@
+import { CaptureType } from "../../../core/models/ml_config";
+import { JobType } from "../../../core/models/job_type";
+import { IssueSeverity } from "../../../core/exception/issue_severity";
+import { InvalidConsentConfigException, InvalidConsentInformationException, } from "../../../core/exception/consent_validation_exceptions";
+import { InvalidFieldValueException, MissingJobTypeException, MissingMLConfigurationBlockException, MissingNetworkConfigurationBlockException, } from "../../../core/exception/job_validation_exceptions";
+import { InvalidDocumentCaptureConfigException, InvalidMissingCaptureTypeException, } from "../../../core/exception/capture_validation_exceptions";
+import { EmptyScreensBlockException } from "../../../core/exception/screen_config_validation_exceptions";
+import { collectJobTypeIssues } from "./job_type_validator";
+/**
+ * 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 function runBuilderValidation(steps) {
+    const issues = [];
+    if (steps.length === 0) {
+        issues.push(new EmptyScreensBlockException());
+    }
+    return issues;
+}
+/**
+ * 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 function runFlowValidation(input) {
+    const issues = [];
+    if (input.steps.length === 0) {
+        issues.push(new EmptyScreensBlockException());
+        // Without screens, every other rule is vacuous — short-circuit
+        // to avoid producing follow-on noise.
+        return issues;
+    }
+    // Capture screens must declare a captureType. Partners set this inside
+    // the configure block; if they forget, surface the typed exception so
+    // it routes through `onResult.failure` like every other validation issue.
+    for (const step of input.steps) {
+        if (step.kind === "capture") {
+            if (step.config.captureType === undefined) {
+                issues.push(new InvalidMissingCaptureTypeException());
+            }
+            // Document captures carry required config: surface at most one issue per
+            // step (missing block > missing type > bad aspect ratio).
+            if (step.config.captureType === CaptureType.document) {
+                const documentConfig = step.config.documentConfig;
+                if (documentConfig === undefined) {
+                    issues.push(new InvalidDocumentCaptureConfigException({
+                        reason: "document is required when mode is Document",
+                    }));
+                }
+                else if (documentConfig.documentType === undefined) {
+                    issues.push(new InvalidDocumentCaptureConfigException({
+                        reason: "documentType is required for document capture",
+                    }));
+                }
+                else if (documentConfig.knownIdAspectRatio !== undefined &&
+                    documentConfig.knownIdAspectRatio <= 0) {
+                    issues.push(new InvalidDocumentCaptureConfigException({
+                        reason: "knownIdAspectRatio must be > 0 if provided",
+                    }));
+                }
+            }
+        }
+    }
+    const hasCaptureScreen = input.steps.some((s) => s.kind === "capture");
+    const hasProcessingScreen = input.steps.some((s) => s.kind === "processing");
+    if (hasCaptureScreen && !input.ml) {
+        issues.push(new MissingMLConfigurationBlockException());
+    }
+    if (hasProcessingScreen && !input.network) {
+        issues.push(new MissingNetworkConfigurationBlockException());
+    }
+    // A processing screen always requires a resolved jobType. Fail the
+    // build (ERROR) whenever it's missing — whether or not a network
+    // block was provided. The missing-network WARNING above still fires
+    // alongside this when the block is absent.
+    if (hasProcessingScreen) {
+        const jobType = input.network?.config?.jobType;
+        if (jobType === undefined || jobType === JobType.unknown) {
+            issues.push(new MissingJobTypeException());
+        }
+    }
+    // Consent screen config validation — partnerName must be non-empty
+    // when a consent screen is in the flow. The consent screen's
+    // attribution line renders blank without it, which partners
+    // typically don't notice until QA.
+    const consentStep = input.steps.find((s) => s.kind === "consent");
+    if (consentStep &&
+        (!consentStep.config.partnerName || !consentStep.config.partnerName.trim())) {
+        issues.push(new InvalidConsentConfigException({
+            reason: "partnerName cannot be empty",
+        }));
+    }
+    if (consentStep && consentStep.config.partnerIcon === undefined) {
+        issues.push(new InvalidConsentConfigException({
+            reason: "partnerIcon is required for the consent screen",
+        }));
+    }
+    if (consentStep &&
+        (consentStep.config.partnerPrivacyPolicyUrl === undefined ||
+            !consentStep.config.partnerPrivacyPolicyUrl.trim())) {
+        issues.push(new InvalidConsentConfigException({
+            reason: "partnerPrivacyPolicyUrl is required for the consent screen",
+        }));
+    }
+    const hasConsentScreen = consentStep !== undefined;
+    if (hasConsentScreen && input.consentInformation !== undefined) {
+        issues.push(new InvalidConsentConfigException({
+            reason: "Exactly one form of consent is required — remove the consent { } screen if using consentInformation, or clear consentInformation if using the consent screen",
+        }));
+    }
+    if (input.consentInformation) {
+        issues.push(...runConsentValidation(input.consentInformation));
+    }
+    if (input.enhancedKYCParams) {
+        issues.push(...runEnhancedKYCParamsValidation(input.enhancedKYCParams));
+    }
+    if (input.biometricKYCParams) {
+        issues.push(...runBiometricKYCParamsValidation(input.biometricKYCParams));
+    }
+    if (input.documentVerificationParams) {
+        issues.push(...runDocumentVerificationParamsValidation(input.documentVerificationParams));
+    }
+    if (input.enhancedDocumentVerificationParams) {
+        issues.push(...runEnhancedDocumentVerificationParamsValidation(input.enhancedDocumentVerificationParams));
+    }
+    if (input.userDetails) {
+        issues.push(...runUserDetailsValidation(input.userDetails));
+    }
+    // Every flow-composition rule (screen ordering, duplicate screens,
+    // preview placement, analyzer dependencies, per-job field
+    // requirements) lives in job_type_validator.ts. FlowValidator owns
+    // only the builder / job-agnostic concerns above and delegates the
+    // per-jobType pass here. The dispatch resolves a validator from the
+    // configured jobType, falling back to a generic structural validator
+    // when the jobType is unknown so prototyping flows still get
+    // ordering / duplicate / preview feedback.
+    collectJobTypeIssues(input, issues);
+    return issues;
+}
+/**
+ * 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 function runEnhancedKYCParamsValidation(params) {
+    return runKYCParamsValidation(params);
+}
+/**
+ * Validate a `BiometricKYCParams` payload in isolation. Used by
+ * `b.validateBiometricKYCParams(params)`.
+ */
+export function runBiometricKYCParamsValidation(params) {
+    return runKYCParamsValidation(params);
+}
+/**
+ * Validate a `DocumentVerificationParams` payload in isolation. `country`
+ * must be non-blank; `idType` is optional, but a present-but-blank value
+ * is rejected.
+ */
+export function runDocumentVerificationParamsValidation(params) {
+    const issues = [];
+    if (!params.country || !params.country.trim()) {
+        issues.push(new InvalidFieldValueException({
+            fieldName: "country",
+            reason: "must not be blank",
+        }));
+    }
+    if (params.idType !== undefined && !params.idType.trim()) {
+        issues.push(new InvalidFieldValueException({
+            fieldName: "idType",
+            reason: "must not be blank",
+        }));
+    }
+    return issues;
+}
+/**
+ * Validate an `EnhancedDocumentVerificationParams` payload in isolation.
+ * Both `country` and `idType` are required and must be non-blank.
+ */
+export function runEnhancedDocumentVerificationParamsValidation(params) {
+    const issues = [];
+    for (const field of ["country", "idType"]) {
+        const value = params[field];
+        if (!value || !value.trim()) {
+            issues.push(new InvalidFieldValueException({
+                fieldName: field,
+                reason: "must not be blank",
+            }));
+        }
+    }
+    return issues;
+}
+/**
+ * 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 function runConsentValidation(consent) {
+    const issues = [];
+    if (!consent.granted) {
+        issues.push(new InvalidConsentInformationException({
+            detail: "granted must be true",
+        }));
+    }
+    for (const field of [
+        "grantedAt",
+        "noticeLanguage",
+        "noticePrivacyPolicyUrl",
+    ]) {
+        if (!consent[field] || !consent[field].trim()) {
+            issues.push(new InvalidConsentInformationException({
+                detail: `${field} must not be blank`,
+            }));
+        }
+    }
+    return issues;
+}
+function runKYCParamsValidation(params) {
+    const issues = [];
+    // Top-level required fields on the params object.
+    for (const field of ["idType", "idNumber", "country"]) {
+        const value = params[field];
+        if (!value || !value.trim()) {
+            issues.push(new InvalidFieldValueException({
+                fieldName: field,
+                reason: "must not be blank",
+            }));
+        }
+    }
+    return issues;
+}
+/**
+ * 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 function runUserDetailsValidation(userDetails) {
+    const issues = [];
+    for (const field of ["givenNames", "lastName"]) {
+        const value = userDetails[field];
+        if (!value || !value.trim()) {
+            issues.push(new InvalidFieldValueException({
+                fieldName: `userDetails.${field}`,
+                reason: "must not be blank",
+            }));
+        }
+    }
+    // At-least-one-of contact rule: email and phoneNumber are each
+    // optional, but the partner must supply one of them.
+    const hasEmail = !!userDetails.email && userDetails.email.trim().length > 0;
+    const hasPhone = !!userDetails.phoneNumber && userDetails.phoneNumber.trim().length > 0;
+    if (!hasEmail && !hasPhone) {
+        issues.push(new InvalidFieldValueException({
+            fieldName: "userDetails",
+            reason: "at least one of email or phoneNumber must be non blank",
+        }));
+    }
+    return issues;
+}
+/**
+ * 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 function firstErrorIssue(state) {
+    if (state.valid)
+        return undefined;
+    return state.issues.find((i) => i.severity === IssueSeverity.error);
+}
+//# sourceMappingURL=flow_validator.js.map

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

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

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

@@ -0,0 +1,124 @@
+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 { JobType } from "../../../core/models/job_type";
+import type { ScreenSpec } from "../dsl/builder/screens_builder";
+import type { ValidationIssue } from "./validation_state";
+/**
+ * Job-type-specific flow validation rules.
+ *
+ * Every rule that decides whether a flow's screen composition is valid
+ * for the configured job lives in this module — duplicate screen types,
+ * screen ordering, preview placement, ML analyzer dependencies, consent
+ * presence, capture counts, processing, and per-job field requirements.
+ * `FlowValidator` only owns the builder / job-agnostic concerns (empty
+ * screens, per-screen config, ML / Network block presence, missing job
+ * type) before dispatching to the matching validator.
+ *
+ * Adding a new job type requires only a new entry in
+ * `FlowValidator`'s `jobTypeValidators` registry — `FlowValidator`
+ * itself never changes.
+ *
+ * Each rule appends typed `InvalidJobTypeScreenConfigException` /
+ * `DuplicateScreenTypeException` / `InvalidScreenOrderException` /
+ * `MissingCaptureForPreviewException` instances so partner tooling can
+ * pivot on `errorCode` or regex-match on the message text.
+ */
+/**
+ * A `JobTypeValidator` runs every composition rule for one job type and
+ * appends any findings to `issues`. Implemented as a class per job-type
+ * family so the registry can map a `JobType` to a single instance.
+ */
+export interface JobTypeValidator {
+    validate(input: JobTypeValidatorInput, issues: ValidationIssue[]): void;
+}
+/**
+ * Inputs the job-type rules read. A subset of the `FlowValidator`
+ * input — only the fields the per-`JobType` rules actually consume.
+ */
+export type JobTypeValidatorInput = {
+    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;
+};
+/**
+ * Validates selfie-only flows: BiometricKyc, SmartSelfieAuthentication,
+ * SmartSelfieEnrollment.
+ *
+ * Allows at most one Preview screen, which must follow a Capture screen.
+ */
+export declare class SelfieJobTypeValidator implements JobTypeValidator {
+    private readonly jobType;
+    constructor(jobType: JobType);
+    validate(input: JobTypeValidatorInput, issues: ValidationIssue[]): void;
+}
+/**
+ * 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 declare class DocumentJobTypeValidator implements JobTypeValidator {
+    private readonly jobType;
+    constructor(jobType: JobType);
+    validate(input: JobTypeValidatorInput, issues: ValidationIssue[]): void;
+    /**
+     * Require the params object for each document job. Per-field blank
+     * checks live in the standalone validators in `flow_validator.ts`.
+     */
+    private appendParamsRule;
+}
+/**
+ * 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 declare class NonCaptureJobTypeValidator implements JobTypeValidator {
+    private readonly jobType;
+    constructor(jobType: JobType);
+    validate(input: JobTypeValidatorInput, issues: ValidationIssue[]): void;
+}
+/**
+ * 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 declare class DefaultStructuralValidator implements JobTypeValidator {
+    validate(input: JobTypeValidatorInput, issues: ValidationIssue[]): void;
+}
+/**
+ * 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 declare const jobTypeValidators: ReadonlyMap<JobType, JobTypeValidator>;
+/**
+ * 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 declare function resolveJobTypeValidator(jobType: JobType | undefined): JobTypeValidator;
+/**
+ * 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 declare function collectJobTypeIssues(input: JobTypeValidatorInput, issues: ValidationIssue[]): void;
+//# sourceMappingURL=job_type_validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"job_type_validator.d.ts","sourceRoot":"","sources":["../../../../src/presentation/flow/validation/job_type_validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/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;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AASjE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,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;AA2PF;;;;;GAKG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI;CAkExE;AAED;;;;;;;;;GASG;AACH,qBAAa,wBAAyB,YAAW,gBAAgB;IACnD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI;IA0DvE;;;OAGG;IACH,OAAO,CAAC,gBAAgB;CAiCzB;AAED;;;;;;;GAOG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI;CAqDxE;AAED;;;;;;GAMG;AACH,qBAAa,0BAA2B,YAAW,gBAAgB;IACjE,QAAQ,CAAC,KAAK,EAAE,qBAAqB,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI;CAKxE;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAqBjE,CAAC;AAIL;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,GAAG,SAAS,GAC3B,gBAAgB,CAKlB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,eAAe,EAAE,GACxB,IAAI,CAGN"}