@smileid/usesmileid 12.0.1 → 12.1.0

package/dist/core/exception/invalid_screen_order_exception.js

@@ -1,22 +1 @@
-import { IssueSeverity } from "./issue_severity";
-import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
-import { UseSmileIDErrorCode } from "./use_smile_id_error_code";
-/**
- * The `screens { }` block declares screens in an order the SDK cannot
- * orchestrate. Severity defaults to `warning` for soft recommendations;
- * callers pass `error` for hard ordering violations that block the
- * build.
- */
-export class InvalidScreenOrderException extends UseSmileIDBuilderException {
-    errorCode = UseSmileIDErrorCode.Builder.InvalidScreenOrder;
-    constructor(args) {
-        super({
-            message: `Invalid screen order: ${args.description}`,
-            severity: args.severity ?? IssueSeverity.warning,
-            suggestedFix: args.suggestedFix ??
-                "Recommended screen order: consent (first, if present) → instructions → capture → preview → processing (last, if present)",
-            errorDetails: { description: args.description },
-        });
-    }
-}
-//# sourceMappingURL=invalid_screen_order_exception.js.map
+"use strict";import{IssueSeverity as r}from"./issue_severity";import{UseSmileIDBuilderException as i}from"./use_smile_id_builder_exception";import{UseSmileIDErrorCode as s}from"./use_smile_id_error_code";export class InvalidScreenOrderException extends i{errorCode=s.Builder.InvalidScreenOrder;constructor(e){super({message:`Invalid screen order: ${e.description}`,severity:e.severity??r.warning,suggestedFix:e.suggestedFix??"Recommended screen order: consent (first, if present) \u2192 instructions \u2192 capture \u2192 preview \u2192 processing (last, if present)",errorDetails:{description:e.description}})}}

package/dist/core/exception/invalid_selfie_capture_config_exception.d.ts

@@ -11,4 +11,3 @@ export declare class InvalidSelfieCaptureConfigException extends UseSmileIDBuild
         reason?: string;
     });
 }
-//# sourceMappingURL=invalid_selfie_capture_config_exception.d.ts.map

package/dist/core/exception/invalid_selfie_capture_config_exception.js

@@ -1,20 +1 @@
-import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
-import { UseSmileIDErrorCode } from "./use_smile_id_error_code";
-/**
- * `captureType` is `selfie` but the `selfie { }` configuration block
- * is missing or otherwise incomplete. The optional `reason` is
- * appended to the message when supplied so the partner sees the
- * specific field that is off.
- */
-export class InvalidSelfieCaptureConfigException extends UseSmileIDBuilderException {
-    errorCode = UseSmileIDErrorCode.Builder.InvalidSelfieCaptureConfig;
-    constructor(args = {}) {
-        const reasonSuffix = args.reason ? `: ${args.reason}` : "";
-        super({
-            message: `Selfie capture type selected but selfie { } configuration is missing${reasonSuffix}`,
-            suggestedFix: "Add the selfie { } block inside capture { } when captureType is selfie",
-            errorDetails: args.reason ? { reason: args.reason } : undefined,
-        });
-    }
-}
-//# sourceMappingURL=invalid_selfie_capture_config_exception.js.map
+"use strict";import{UseSmileIDBuilderException as r}from"./use_smile_id_builder_exception";import{UseSmileIDErrorCode as o}from"./use_smile_id_error_code";export class InvalidSelfieCaptureConfigException extends r{errorCode=o.Builder.InvalidSelfieCaptureConfig;constructor(e={}){const i=e.reason?`: ${e.reason}`:"";super({message:`Selfie capture type selected but selfie { } configuration is missing${i}`,suggestedFix:"Add the selfie { } block inside capture { } when captureType is selfie",errorDetails:e.reason?{reason:e.reason}:void 0})}}

package/dist/core/exception/issue_severity.d.ts

@@ -11,4 +11,3 @@ export declare const IssueSeverity: {
     readonly warning: "warning";
 };
 export type IssueSeverity = (typeof IssueSeverity)[keyof typeof IssueSeverity];
-//# sourceMappingURL=issue_severity.d.ts.map

package/dist/core/exception/issue_severity.js

@@ -1,13 +1 @@
-/**
- * Severity tier carried by every `UseSmileIDException`.
- *
- * - `error` — blocks the operation. `b.build()` throws on the first
- *   one; the validator returns it in `state.issues`.
- * - `warning` — advisory only. The build proceeds; tooling may
- *   surface the issue.
- */
-export const IssueSeverity = {
-    error: "error",
-    warning: "warning",
-};
-//# sourceMappingURL=issue_severity.js.map
+"use strict";export const IssueSeverity={error:"error",warning:"warning"};

package/dist/core/exception/job_validation_exceptions.d.ts

@@ -9,4 +9,3 @@ export { MissingJobTypeException } from "./missing_job_type_exception";
 export { MissingRequiredFieldException } from "./missing_required_field_exception";
 export { InvalidJobTypeScreenConfigException } from "./invalid_job_type_screen_config_exception";
 export { InvalidFieldValueException } from "./invalid_field_value_exception";
-//# sourceMappingURL=job_validation_exceptions.d.ts.map

package/dist/core/exception/job_validation_exceptions.js

@@ -1,12 +1 @@
-/**
- * Re-export barrel for job / network / ML-block validation
- * exceptions. Each concrete class lives in its own file; this module
- * keeps the legacy import path stable.
- */
-export { MissingMLConfigurationBlockException } from "./missing_ml_configuration_block_exception";
-export { MissingNetworkConfigurationBlockException } from "./missing_network_configuration_block_exception";
-export { MissingJobTypeException } from "./missing_job_type_exception";
-export { MissingRequiredFieldException } from "./missing_required_field_exception";
-export { InvalidJobTypeScreenConfigException } from "./invalid_job_type_screen_config_exception";
-export { InvalidFieldValueException } from "./invalid_field_value_exception";
-//# sourceMappingURL=job_validation_exceptions.js.map
+"use strict";export{MissingMLConfigurationBlockException}from"./missing_ml_configuration_block_exception";export{MissingNetworkConfigurationBlockException}from"./missing_network_configuration_block_exception";export{MissingJobTypeException}from"./missing_job_type_exception";export{MissingRequiredFieldException}from"./missing_required_field_exception";export{InvalidJobTypeScreenConfigException}from"./invalid_job_type_screen_config_exception";export{InvalidFieldValueException}from"./invalid_field_value_exception";

package/dist/core/exception/liveness_frame_count_exception.d.ts

@@ -12,4 +12,3 @@ export declare class LivenessFrameCountException extends UseSmileIDValidationExc
         actual: number;
     });
 }
-//# sourceMappingURL=liveness_frame_count_exception.d.ts.map

package/dist/core/exception/liveness_frame_count_exception.js

@@ -1,19 +1 @@
-import { UseSmileIDValidationException } from "./use_smile_id_validation_exception";
-import { UseSmileIDErrorCode } from "./use_smile_id_error_code";
-/**
- * A submission carried the wrong number of liveness frames. The capture
- * pipeline must produce exactly [expected] frames; [actual] is what was
- * collected. Surfaced before the request goes on the wire so a malformed
- * frame set never reaches the server.
- */
-export class LivenessFrameCountException extends UseSmileIDValidationException {
-    errorCode = UseSmileIDErrorCode.Validation.ConstraintViolation;
-    constructor(args) {
-        super({
-            message: `Expected exactly ${args.expected} liveness images, got ${args.actual}`,
-            suggestedFix: "Recapture the selfie so the pipeline collects the full liveness frame set.",
-            errorDetails: { expected: args.expected, actual: args.actual },
-        });
-    }
-}
-//# sourceMappingURL=liveness_frame_count_exception.js.map
+"use strict";import{UseSmileIDValidationException as t}from"./use_smile_id_validation_exception";import{UseSmileIDErrorCode as o}from"./use_smile_id_error_code";export class LivenessFrameCountException extends t{errorCode=o.Validation.ConstraintViolation;constructor(e){super({message:`Expected exactly ${e.expected} liveness images, got ${e.actual}`,suggestedFix:"Recapture the selfie so the pipeline collects the full liveness frame set.",errorDetails:{expected:e.expected,actual:e.actual}})}}

package/dist/core/exception/missing_capture_for_preview_exception.d.ts

@@ -11,4 +11,3 @@ export declare class MissingCaptureForPreviewException extends UseSmileIDBuilder
         previewIndex?: number;
     });
 }
-//# sourceMappingURL=missing_capture_for_preview_exception.d.ts.map

package/dist/core/exception/missing_capture_for_preview_exception.js

@@ -1,22 +1 @@
-import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
-import { UseSmileIDErrorCode } from "./use_smile_id_error_code";
-/**
- * A `preview { }` screen appeared without a preceding `capture { }`
- * screen — the preview surface has nothing to render. The
- * `previewIndex` is preserved when known so partner UIs can highlight
- * the offending screen.
- */
-export class MissingCaptureForPreviewException extends UseSmileIDBuilderException {
-    errorCode = UseSmileIDErrorCode.Builder.MissingCaptureForPreview;
-    constructor(args = {}) {
-        const hasIndex = args.previewIndex !== undefined;
-        super({
-            message: hasIndex
-                ? `Preview screen at index ${args.previewIndex} has no preceding Capture screen`
-                : "Flow contains a Preview screen without a preceding Capture screen",
-            suggestedFix: "Add a capture screen before the preview screen in the screens { } block",
-            errorDetails: hasIndex ? { previewIndex: args.previewIndex } : undefined,
-        });
-    }
-}
-//# sourceMappingURL=missing_capture_for_preview_exception.js.map
+"use strict";import{UseSmileIDBuilderException as i}from"./use_smile_id_builder_exception";import{UseSmileIDErrorCode as n}from"./use_smile_id_error_code";export class MissingCaptureForPreviewException extends i{errorCode=n.Builder.MissingCaptureForPreview;constructor(e={}){const r=e.previewIndex!==void 0;super({message:r?`Preview screen at index ${e.previewIndex} has no preceding Capture screen`:"Flow contains a Preview screen without a preceding Capture screen",suggestedFix:"Add a capture screen before the preview screen in the screens { } block",errorDetails:r?{previewIndex:e.previewIndex}:void 0})}}

package/dist/core/exception/missing_job_type_exception.d.ts

@@ -1,11 +1,8 @@
 import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
 /**
- * The `network { config { } }` block is present but `jobType` was
- * never set — the orchestrator can't pick a submission path without
- * it.
+ * `jobType` was never set, or was set to a value that is not one of the SDK's job types.
  */
 export declare class MissingJobTypeException extends UseSmileIDBuilderException {
     readonly errorCode: "BUILDER_MISSING_JOB_TYPE";
     constructor();
 }
-//# sourceMappingURL=missing_job_type_exception.d.ts.map

package/dist/core/exception/missing_job_type_exception.js

@@ -1,17 +1 @@
-import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
-import { UseSmileIDErrorCode } from "./use_smile_id_error_code";
-/**
- * The `network { config { } }` block is present but `jobType` was
- * never set — the orchestrator can't pick a submission path without
- * it.
- */
-export class MissingJobTypeException extends UseSmileIDBuilderException {
-    errorCode = UseSmileIDErrorCode.Builder.MissingJobType;
-    constructor() {
-        super({
-            message: "jobType is not set — it must be configured explicitly in the network { config { } } block",
-            suggestedFix: "Set config.jobType in the network { config { } } block, e.g. config.jobType = JobType.DocumentVerification",
-        });
-    }
-}
-//# sourceMappingURL=missing_job_type_exception.js.map
+"use strict";import{UseSmileIDBuilderException as e}from"./use_smile_id_builder_exception";import{UseSmileIDErrorCode as o}from"./use_smile_id_error_code";export class MissingJobTypeException extends e{errorCode=o.Builder.MissingJobType;constructor(){super({message:"jobType is not set to one of the SDK's job types \u2014 it must be configured explicitly in the network { config { } } block",suggestedFix:"Set config.jobType in the network { config { } } block, e.g. config.jobType = JobType.DocumentVerification"})}}

package/dist/core/exception/missing_ml_configuration_block_exception.d.ts

@@ -8,4 +8,3 @@ export declare class MissingMLConfigurationBlockException extends UseSmileIDBuil
     readonly errorCode: "BUILDER_MISSING_ML_CONFIG";
     constructor();
 }
-//# sourceMappingURL=missing_ml_configuration_block_exception.d.ts.map

package/dist/core/exception/missing_ml_configuration_block_exception.js

@@ -1,19 +1 @@
-import { IssueSeverity } from "./issue_severity";
-import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
-import { UseSmileIDErrorCode } from "./use_smile_id_error_code";
-/**
- * The flow declares a Capture screen but no `ml { }` block.
- * Severity is `warning` — the flow still builds; ML features just
- * won't run at runtime.
- */
-export class MissingMLConfigurationBlockException extends UseSmileIDBuilderException {
-    errorCode = UseSmileIDErrorCode.Builder.MissingMLConfiguration;
-    constructor() {
-        super({
-            message: "Flow contains a Capture screen but the ml { } block is missing",
-            severity: IssueSeverity.warning,
-            suggestedFix: "Add the ml { } block to your UseSmileID builder configuration",
-        });
-    }
-}
-//# sourceMappingURL=missing_ml_configuration_block_exception.js.map
+"use strict";import{IssueSeverity as e}from"./issue_severity";import{UseSmileIDBuilderException as i}from"./use_smile_id_builder_exception";import{UseSmileIDErrorCode as o}from"./use_smile_id_error_code";export class MissingMLConfigurationBlockException extends i{errorCode=o.Builder.MissingMLConfiguration;constructor(){super({message:"Flow contains a Capture screen but the ml { } block is missing",severity:e.warning,suggestedFix:"Add the ml { } block to your UseSmileID builder configuration"})}}

package/dist/core/exception/missing_network_configuration_block_exception.d.ts

@@ -8,4 +8,3 @@ export declare class MissingNetworkConfigurationBlockException extends UseSmileI
     readonly errorCode: "BUILDER_MISSING_NETWORK_CONFIG";
     constructor();
 }
-//# sourceMappingURL=missing_network_configuration_block_exception.d.ts.map

package/dist/core/exception/missing_network_configuration_block_exception.js

@@ -1,19 +1 @@
-import { IssueSeverity } from "./issue_severity";
-import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
-import { UseSmileIDErrorCode } from "./use_smile_id_error_code";
-/**
- * The flow declares a Processing screen but no `network { }` block.
- * Severity is `warning` — the flow still builds; network submission
- * just won't run at runtime.
- */
-export class MissingNetworkConfigurationBlockException extends UseSmileIDBuilderException {
-    errorCode = UseSmileIDErrorCode.Builder.MissingNetworkConfiguration;
-    constructor() {
-        super({
-            message: "Flow contains a Processing screen but the network { } block is missing",
-            severity: IssueSeverity.warning,
-            suggestedFix: "Add the network { } block to your UseSmileID builder configuration",
-        });
-    }
-}
-//# sourceMappingURL=missing_network_configuration_block_exception.js.map
+"use strict";import{IssueSeverity as e}from"./issue_severity";import{UseSmileIDBuilderException as o}from"./use_smile_id_builder_exception";import{UseSmileIDErrorCode as r}from"./use_smile_id_error_code";export class MissingNetworkConfigurationBlockException extends o{errorCode=r.Builder.MissingNetworkConfiguration;constructor(){super({message:"Flow contains a Processing screen but the network { } block is missing",severity:e.warning,suggestedFix:"Add the network { } block to your UseSmileID builder configuration"})}}

package/dist/core/exception/missing_partner_config_exception.d.ts

@@ -14,5 +14,8 @@ export declare class MissingPartnerConfigException extends UseSmileIDBuilderExce
     static missingPartnerId(): MissingPartnerConfigException;
     /** The auth `token` was missing or blank. */
     static missingAuthToken(): MissingPartnerConfigException;
+    /** The `partnerId` contains a control character (usually a pasted newline). */
+    static controlCharacterPartnerId(): MissingPartnerConfigException;
+    /** The auth `token` contains a control character (usually a pasted newline). */
+    static controlCharacterAuthToken(): MissingPartnerConfigException;
 }
-//# sourceMappingURL=missing_partner_config_exception.d.ts.map

package/dist/core/exception/missing_partner_config_exception.js

@@ -1,35 +1 @@
-import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
-import { UseSmileIDErrorCode } from "./use_smile_id_error_code";
-/**
- * A `network { }` block was provided but a required partner-configuration
- * field (`partnerId` or the auth `token`) was missing or blank.
- *
- * Thrown when the networking client is constructed so an unauthenticated
- * request can never reach the wire (empty credentials are rejected at
- * client construction).
- */
-export class MissingPartnerConfigException extends UseSmileIDBuilderException {
-    errorCode = UseSmileIDErrorCode.Builder.InvalidConfiguration;
-    constructor(args) {
-        super({
-            message: args.message,
-            suggestedFix: `Configure the missing field '${args.fieldName}' in the network config block.`,
-            errorDetails: { fieldName: args.fieldName },
-        });
-    }
-    /** The `partnerId` was missing or blank. */
-    static missingPartnerId() {
-        return new MissingPartnerConfigException({
-            message: "Partner ID is required but was not configured",
-            fieldName: "partnerId",
-        });
-    }
-    /** The auth `token` was missing or blank. */
-    static missingAuthToken() {
-        return new MissingPartnerConfigException({
-            message: "Auth token is required but was not configured",
-            fieldName: "authToken",
-        });
-    }
-}
-//# sourceMappingURL=missing_partner_config_exception.js.map
+"use strict";import{UseSmileIDBuilderException as r}from"./use_smile_id_builder_exception";import{UseSmileIDErrorCode as t}from"./use_smile_id_error_code";export class MissingPartnerConfigException extends r{errorCode=t.Builder.InvalidConfiguration;constructor(e){super({message:e.message,suggestedFix:`Configure the missing field '${e.fieldName}' in the network config block.`,errorDetails:{fieldName:e.fieldName}})}static missingPartnerId(){return new MissingPartnerConfigException({message:"Partner ID is required but was not configured",fieldName:"partnerId"})}static missingAuthToken(){return new MissingPartnerConfigException({message:"Auth token is required but was not configured",fieldName:"authToken"})}static controlCharacterPartnerId(){return new MissingPartnerConfigException({message:"Partner ID must not contain control characters",fieldName:"partnerId"})}static controlCharacterAuthToken(){return new MissingPartnerConfigException({message:"Auth token must not contain control characters",fieldName:"authToken"})}}

package/dist/core/exception/missing_required_field_exception.d.ts

@@ -10,4 +10,3 @@ export declare class MissingRequiredFieldException extends UseSmileIDBuilderExce
         fieldName: string;
     });
 }
-//# sourceMappingURL=missing_required_field_exception.d.ts.map

package/dist/core/exception/missing_required_field_exception.js

@@ -1,18 +1 @@
-import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
-import { UseSmileIDErrorCode } from "./use_smile_id_error_code";
-/**
- * A required scalar field on a configuration object was not provided.
- * The `fieldName` identifies the offending property so partner
- * tooling can surface it directly in the UI.
- */
-export class MissingRequiredFieldException extends UseSmileIDBuilderException {
-    errorCode = UseSmileIDErrorCode.Builder.MissingRequiredField;
-    constructor(args) {
-        super({
-            message: `Required field '${args.fieldName}' is missing`,
-            suggestedFix: "Provide a value for the required field.",
-            errorDetails: { fieldName: args.fieldName },
-        });
-    }
-}
-//# sourceMappingURL=missing_required_field_exception.js.map
+"use strict";import{UseSmileIDBuilderException as i}from"./use_smile_id_builder_exception";import{UseSmileIDErrorCode as r}from"./use_smile_id_error_code";export class MissingRequiredFieldException extends i{errorCode=r.Builder.MissingRequiredField;constructor(e){super({message:`Required field '${e.fieldName}' is missing`,suggestedFix:"Provide a value for the required field.",errorDetails:{fieldName:e.fieldName}})}}

package/dist/core/exception/screen_config_validation_exceptions.d.ts

@@ -8,4 +8,3 @@ export { EmptyScreensBlockException } from "./empty_screens_block_exception";
 export { InvalidScreenOrderException } from "./invalid_screen_order_exception";
 export { MissingCaptureForPreviewException } from "./missing_capture_for_preview_exception";
 export { DuplicateScreenTypeException } from "./duplicate_screen_type_exception";
-//# sourceMappingURL=screen_config_validation_exceptions.d.ts.map

package/dist/core/exception/screen_config_validation_exceptions.js

@@ -1,11 +1 @@
-/**
- * Re-export barrel for screen-configuration validation exceptions.
- * Each concrete class lives in its own file so partner tooling can
- * deep-import the exact rule it cares about without dragging the
- * sibling rules into the bundle.
- */
-export { EmptyScreensBlockException } from "./empty_screens_block_exception";
-export { InvalidScreenOrderException } from "./invalid_screen_order_exception";
-export { MissingCaptureForPreviewException } from "./missing_capture_for_preview_exception";
-export { DuplicateScreenTypeException } from "./duplicate_screen_type_exception";
-//# sourceMappingURL=screen_config_validation_exceptions.js.map
+"use strict";export{EmptyScreensBlockException}from"./empty_screens_block_exception";export{InvalidScreenOrderException}from"./invalid_screen_order_exception";export{MissingCaptureForPreviewException}from"./missing_capture_for_preview_exception";export{DuplicateScreenTypeException}from"./duplicate_screen_type_exception";

package/dist/core/exception/unused_job_params_exception.d.ts

@@ -0,0 +1,16 @@
+import { JobType } from "../../core/models/job_type";
+import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
+/** Every params payload the builder accepts, paired with the single job type that reads it. */
+export declare const JOB_PARAMS_OWNERS: ReadonlyArray<{
+    readonly fieldName: string;
+    readonly owner: JobType;
+}>;
+/** A params payload is set for a job type that never reads it — inert, so it only warns. */
+export declare class UnusedJobParamsException extends UseSmileIDBuilderException {
+    readonly errorCode: "BUILDER_UNUSED_JOB_PARAMS";
+    readonly fieldName: string;
+    constructor(args: {
+        jobType: JobType;
+        fieldName: string;
+    });
+}

package/dist/core/exception/unused_job_params_exception.js

@@ -0,0 +1 @@
+"use strict";import{JobType as o}from"../../core/models/job_type";import{jobTypeName as n}from"./invalid_job_type_screen_config_exception";import{IssueSeverity as t}from"./issue_severity";import{UseSmileIDBuilderException as a}from"./use_smile_id_builder_exception";import{UseSmileIDErrorCode as d}from"./use_smile_id_error_code";export const JOB_PARAMS_OWNERS=[{fieldName:"enhancedKYCParams",owner:o.enhancedKyc},{fieldName:"biometricKYCParams",owner:o.biometricKyc},{fieldName:"documentVerificationParams",owner:o.documentVerification},{fieldName:"enhancedDocumentVerificationParams",owner:o.enhancedDocumentVerification}];function s(i){return JOB_PARAMS_OWNERS.find(e=>e.fieldName===i)?.owner}export class UnusedJobParamsException extends a{errorCode=d.Builder.UnusedJobParams;fieldName;constructor(e){const r=s(e.fieldName),m=r===void 0?`Remove builder.${e.fieldName} \u2014 the configured job type does not read it`:`Remove builder.${e.fieldName} \u2014 it belongs to ${n(r)} jobs`;super({message:`${e.fieldName} is set but ${n(e.jobType)} jobs never read it`,severity:t.warning,suggestedFix:m}),this.fieldName=e.fieldName}}

package/dist/core/exception/use_smile_id_attestation_exception.d.ts

@@ -9,4 +9,3 @@ import { UseSmileIDException } from "./use_smile_id_exception";
  */
 export declare abstract class UseSmileIDAttestationException extends UseSmileIDException {
 }
-//# sourceMappingURL=use_smile_id_attestation_exception.d.ts.map

package/dist/core/exception/use_smile_id_attestation_exception.js

@@ -1,12 +1 @@
-import { UseSmileIDException } from "./use_smile_id_exception";
-/**
- * Category base for device-attestation failures (warmup, init,
- * request). Concrete subclasses ship when the attestation surface
- * lands — see [docs/Architecture.md § Rollout].
- *
- * Partners can `instanceof UseSmileIDAttestationException` to catch
- * every attestation-category failure with one check.
- */
-export class UseSmileIDAttestationException extends UseSmileIDException {
-}
-//# sourceMappingURL=use_smile_id_attestation_exception.js.map
+"use strict";import{UseSmileIDException as e}from"./use_smile_id_exception";export class UseSmileIDAttestationException extends e{}

package/dist/core/exception/use_smile_id_builder_exception.d.ts

@@ -16,4 +16,3 @@ import { UseSmileIDValidationException } from "./use_smile_id_validation_excepti
  */
 export declare abstract class UseSmileIDBuilderException extends UseSmileIDValidationException {
 }
-//# sourceMappingURL=use_smile_id_builder_exception.d.ts.map

package/dist/core/exception/use_smile_id_builder_exception.js

@@ -1,19 +1 @@
-import { UseSmileIDValidationException } from "./use_smile_id_validation_exception";
-/**
- * Category base for builder / configuration validation failures.
- *
- * Builder exceptions are emitted by `b.validate()` and thrown by
- * `b.build()` when the configuration violates an invariant. Concrete
- * subclasses live in:
- *
- *   - `screen_config_validation_exceptions.ts`
- *   - `consent_validation_exceptions.ts`
- *   - `job_validation_exceptions.ts`
- *
- * The class is a thin marker — partners doing
- * `instanceof UseSmileIDBuilderException` catch every builder
- * failure with one check.
- */
-export class UseSmileIDBuilderException extends UseSmileIDValidationException {
-}
-//# sourceMappingURL=use_smile_id_builder_exception.js.map
+"use strict";import{UseSmileIDValidationException as e}from"./use_smile_id_validation_exception";export class UseSmileIDBuilderException extends e{}

package/dist/core/exception/use_smile_id_camera_exception.d.ts

@@ -10,4 +10,3 @@ import { UseSmileIDException } from "./use_smile_id_exception";
  */
 export declare abstract class UseSmileIDCameraException extends UseSmileIDException {
 }
-//# sourceMappingURL=use_smile_id_camera_exception.d.ts.map

package/dist/core/exception/use_smile_id_camera_exception.js

@@ -1,13 +1 @@
-import { UseSmileIDException } from "./use_smile_id_exception";
-/**
- * Category base for camera / capture-surface failures (permission
- * denied, hardware unavailable, capture failed). Concrete subclasses
- * ship as the orchestrator wires the camera surface — see
- * [docs/Architecture.md § Rollout].
- *
- * Partners can `instanceof UseSmileIDCameraException` to catch every
- * camera-category failure with one check.
- */
-export class UseSmileIDCameraException extends UseSmileIDException {
-}
-//# sourceMappingURL=use_smile_id_camera_exception.js.map
+"use strict";import{UseSmileIDException as e}from"./use_smile_id_exception";export class UseSmileIDCameraException extends e{}

package/dist/core/exception/use_smile_id_camera_surface_exception.d.ts

@@ -0,0 +1,15 @@
+import { UseSmileIDCameraException } from "./use_smile_id_camera_exception";
+import type { UseSmileIDErrorCode } from "./use_smile_id_error_code";
+/**
+ * Terminal camera-surface failure raised from a kamera error event; the orchestrator routes it to the
+ * flow's `failed` result. `errorDetails.kameraCode` preserves the raw kamera code for triage.
+ */
+export declare class UseSmileIDCameraSurfaceException extends UseSmileIDCameraException {
+    readonly errorCode: UseSmileIDErrorCode;
+    constructor(args: {
+        errorCode: UseSmileIDErrorCode;
+        message: string;
+        suggestedFix: string;
+        errorDetails?: Readonly<Record<string, unknown>> | undefined;
+    });
+}

package/dist/core/exception/use_smile_id_camera_surface_exception.js

@@ -0,0 +1 @@
+"use strict";import{UseSmileIDCameraException as r}from"./use_smile_id_camera_exception";export class UseSmileIDCameraSurfaceException extends r{errorCode;constructor(e){super({message:e.message,suggestedFix:e.suggestedFix,errorDetails:e.errorDetails}),this.errorCode=e.errorCode}}

package/dist/core/exception/use_smile_id_error_code.d.ts

@@ -34,6 +34,7 @@ export declare const UseSmileIDErrorCode: {
         readonly ConfigurationBlockFailed: "BUILDER_CONFIG_BLOCK_FAILED";
         readonly InvalidConsentInformation: "BUILDER_INVALID_CONSENT_INFORMATION";
         readonly InvalidJobTypeScreenConfig: "BUILDER_INVALID_JOB_TYPE_SCREEN_CONFIG";
+        readonly UnusedJobParams: "BUILDER_UNUSED_JOB_PARAMS";
     };
     /** Camera / capture surface. */
     readonly Camera: {
@@ -41,6 +42,7 @@ export declare const UseSmileIDErrorCode: {
         readonly PermissionDenied: "CAMERA_PERMISSION_DENIED";
         readonly CaptureFailed: "CAMERA_CAPTURE_FAILED";
         readonly UseCaseNotSupported: "CAMERA_USE_CASE_NOT_SUPPORTED";
+        readonly VideoCaptureDisabled: "CAMERA_VIDEO_DISABLED";
         readonly Unknown: "CAMERA_UNKNOWN_ERROR";
     };
     /** Network / submission. */
@@ -75,5 +77,10 @@ type UseSmileIDErrorCodeNamespace = typeof UseSmileIDErrorCode;
  * and TypeScript narrows exhaustively.
  */
 export type UseSmileIDErrorCode = UseSmileIDErrorCodeNamespace["Builder"][keyof UseSmileIDErrorCodeNamespace["Builder"]] | UseSmileIDErrorCodeNamespace["Camera"][keyof UseSmileIDErrorCodeNamespace["Camera"]] | UseSmileIDErrorCodeNamespace["Network"][keyof UseSmileIDErrorCodeNamespace["Network"]] | UseSmileIDErrorCodeNamespace["Validation"][keyof UseSmileIDErrorCodeNamespace["Validation"]] | UseSmileIDErrorCodeNamespace["General"][keyof UseSmileIDErrorCodeNamespace["General"]];
+/** Union of the `NETWORK_*` codes only. */
+export type UseSmileIDNetworkErrorCode = UseSmileIDErrorCodeNamespace["Network"][keyof UseSmileIDErrorCodeNamespace["Network"]];
+/** Whether retrying `code` can plausibly succeed — a property of the code itself, so it covers camera failures too. */
+export declare function isRetryableErrorCode(code: UseSmileIDErrorCode): boolean;
+/** Whether `code` belongs to the `NETWORK_*` category. */
+export declare function isNetworkErrorCode(code: UseSmileIDErrorCode): code is UseSmileIDNetworkErrorCode;
 export {};
-//# sourceMappingURL=use_smile_id_error_code.d.ts.map

package/dist/core/exception/use_smile_id_error_code.js

@@ -1,71 +1 @@
-/**
- * Stable error codes for typed exception narrowing.
- *
- * Codes are UPPER_SNAKE_CASE strings prefixed by category
- * (`BUILDER_*`, `CAMERA_*`, `NETWORK_*`, `VALIDATION_*`,
- * `GENERAL_*`). The literal string values are part
- * of the wire-format contract — partners pivot on the literal value
- * when forwarding to telemetry, and partner code that switches on
- * `errorCode` is exhaustive at compile time via TypeScript's
- * literal-type narrowing.
- *
- * Adding a new code rotates the partner-visible code set; never rename
- * or remove an entry once shipped.
- */
-export const UseSmileIDErrorCode = {
-    /** Builder / configuration validation. */
-    Builder: {
-        ValidationError: "BUILDER_VALIDATION_ERROR",
-        InvalidConfiguration: "BUILDER_INVALID_CONFIG",
-        MissingRequiredField: "BUILDER_MISSING_FIELD",
-        InvalidConsentConfig: "BUILDER_INVALID_CONSENT_CONFIG",
-        MissingCaptureType: "BUILDER_MISSING_CAPTURE_TYPE",
-        EmptyScreensBlock: "BUILDER_EMPTY_SCREENS",
-        MissingScreenConfiguration: "BUILDER_MISSING_SCREEN_CONFIG",
-        DuplicateScreenType: "BUILDER_DUPLICATE_SCREEN",
-        InvalidSelfieCaptureConfig: "BUILDER_INVALID_SELFIE_CONFIG",
-        AgentModeWithEnhancedLiveness: "BUILDER_AGENT_MODE_WITH_ENHANCED_LIVENESS",
-        InvalidDocumentCaptureConfig: "BUILDER_INVALID_DOCUMENT_CONFIG",
-        MissingMLConfiguration: "BUILDER_MISSING_ML_CONFIG",
-        MissingNetworkConfiguration: "BUILDER_MISSING_NETWORK_CONFIG",
-        MissingJobType: "BUILDER_MISSING_JOB_TYPE",
-        MissingCaptureForPreview: "BUILDER_MISSING_CAPTURE_FOR_PREVIEW",
-        InvalidScreenOrder: "BUILDER_INVALID_SCREEN_ORDER",
-        ConfigurationBlockFailed: "BUILDER_CONFIG_BLOCK_FAILED",
-        InvalidConsentInformation: "BUILDER_INVALID_CONSENT_INFORMATION",
-        InvalidJobTypeScreenConfig: "BUILDER_INVALID_JOB_TYPE_SCREEN_CONFIG",
-    },
-    /** Camera / capture surface. */
-    Camera: {
-        InitializationFailed: "CAMERA_INIT_FAILED",
-        PermissionDenied: "CAMERA_PERMISSION_DENIED",
-        CaptureFailed: "CAMERA_CAPTURE_FAILED",
-        UseCaseNotSupported: "CAMERA_USE_CASE_NOT_SUPPORTED",
-        Unknown: "CAMERA_UNKNOWN_ERROR",
-    },
-    /** Network / submission. */
-    Network: {
-        ConnectionFailed: "NETWORK_CONNECTION_FAILED",
-        Timeout: "NETWORK_TIMEOUT",
-        RequestFailed: "NETWORK_REQUEST_FAILED",
-        ResponseParseError: "NETWORK_PARSE_ERROR",
-        Unauthorized: "NETWORK_UNAUTHORIZED",
-        Forbidden: "NETWORK_FORBIDDEN",
-        NotFound: "NETWORK_NOT_FOUND",
-        RateLimit: "NETWORK_RATE_LIMIT",
-        ServerError: "NETWORK_SERVER_ERROR",
-    },
-    /** Generic input / state validation. */
-    Validation: {
-        InvalidInput: "VALIDATION_INVALID_INPUT",
-        InvalidState: "VALIDATION_INVALID_STATE",
-        ConstraintViolation: "VALIDATION_CONSTRAINT_VIOLATION",
-    },
-    /** Catch-all for failures that don't fit a category. */
-    General: {
-        Unknown: "GENERAL_UNKNOWN_ERROR",
-        InvalidState: "GENERAL_INVALID_STATE",
-        OperationFailed: "GENERAL_OPERATION_FAILED",
-    },
-};
-//# sourceMappingURL=use_smile_id_error_code.js.map
+"use strict";export const UseSmileIDErrorCode={Builder:{ValidationError:"BUILDER_VALIDATION_ERROR",InvalidConfiguration:"BUILDER_INVALID_CONFIG",MissingRequiredField:"BUILDER_MISSING_FIELD",InvalidConsentConfig:"BUILDER_INVALID_CONSENT_CONFIG",MissingCaptureType:"BUILDER_MISSING_CAPTURE_TYPE",EmptyScreensBlock:"BUILDER_EMPTY_SCREENS",MissingScreenConfiguration:"BUILDER_MISSING_SCREEN_CONFIG",DuplicateScreenType:"BUILDER_DUPLICATE_SCREEN",InvalidSelfieCaptureConfig:"BUILDER_INVALID_SELFIE_CONFIG",AgentModeWithEnhancedLiveness:"BUILDER_AGENT_MODE_WITH_ENHANCED_LIVENESS",InvalidDocumentCaptureConfig:"BUILDER_INVALID_DOCUMENT_CONFIG",MissingMLConfiguration:"BUILDER_MISSING_ML_CONFIG",MissingNetworkConfiguration:"BUILDER_MISSING_NETWORK_CONFIG",MissingJobType:"BUILDER_MISSING_JOB_TYPE",MissingCaptureForPreview:"BUILDER_MISSING_CAPTURE_FOR_PREVIEW",InvalidScreenOrder:"BUILDER_INVALID_SCREEN_ORDER",ConfigurationBlockFailed:"BUILDER_CONFIG_BLOCK_FAILED",InvalidConsentInformation:"BUILDER_INVALID_CONSENT_INFORMATION",InvalidJobTypeScreenConfig:"BUILDER_INVALID_JOB_TYPE_SCREEN_CONFIG",UnusedJobParams:"BUILDER_UNUSED_JOB_PARAMS"},Camera:{InitializationFailed:"CAMERA_INIT_FAILED",PermissionDenied:"CAMERA_PERMISSION_DENIED",CaptureFailed:"CAMERA_CAPTURE_FAILED",UseCaseNotSupported:"CAMERA_USE_CASE_NOT_SUPPORTED",VideoCaptureDisabled:"CAMERA_VIDEO_DISABLED",Unknown:"CAMERA_UNKNOWN_ERROR"},Network:{ConnectionFailed:"NETWORK_CONNECTION_FAILED",Timeout:"NETWORK_TIMEOUT",RequestFailed:"NETWORK_REQUEST_FAILED",ResponseParseError:"NETWORK_PARSE_ERROR",Unauthorized:"NETWORK_UNAUTHORIZED",Forbidden:"NETWORK_FORBIDDEN",NotFound:"NETWORK_NOT_FOUND",RateLimit:"NETWORK_RATE_LIMIT",ServerError:"NETWORK_SERVER_ERROR"},Validation:{InvalidInput:"VALIDATION_INVALID_INPUT",InvalidState:"VALIDATION_INVALID_STATE",ConstraintViolation:"VALIDATION_CONSTRAINT_VIOLATION"},General:{Unknown:"GENERAL_UNKNOWN_ERROR",InvalidState:"GENERAL_INVALID_STATE",OperationFailed:"GENERAL_OPERATION_FAILED"}};const I=new Set([UseSmileIDErrorCode.Camera.CaptureFailed,UseSmileIDErrorCode.Network.ConnectionFailed,UseSmileIDErrorCode.Network.Timeout,UseSmileIDErrorCode.Network.RequestFailed,UseSmileIDErrorCode.Network.RateLimit,UseSmileIDErrorCode.Network.ServerError]),e=new Set(Object.values(UseSmileIDErrorCode.Network));export function isRetryableErrorCode(E){return I.has(E)}export function isNetworkErrorCode(E){return e.has(E)}

package/dist/core/exception/use_smile_id_exception.d.ts

@@ -24,4 +24,3 @@ export declare abstract class UseSmileIDException extends Error {
         cause?: unknown;
     });
 }
-//# sourceMappingURL=use_smile_id_exception.d.ts.map

package/dist/core/exception/use_smile_id_exception.js

@@ -1,39 +1 @@
-import { IssueSeverity } from "./issue_severity";
-/**
- * Root exception type for the SDK.
- *
- * Concrete subclasses fix the `errorCode` (and may carry rule- or
- * category-specific structured data via `errorDetails`). Partner
- * tooling pivots on `errorCode` / `severity` to triage failures.
- */
-export class UseSmileIDException extends Error {
-    /** Whether the exception blocks the current operation. */
-    severity;
-    /** Concrete remediation hint — usually quotes the offending property. */
-    suggestedFix;
-    /** Optional structured payload (e.g. `{ index, field }`). */
-    errorDetails;
-    constructor(args) {
-        super(args.message);
-        this.name = new.target.name;
-        this.severity = args.severity ?? IssueSeverity.error;
-        this.suggestedFix = args.suggestedFix;
-        this.errorDetails = args.errorDetails;
-        if (args.cause !== undefined) {
-            // `cause` is part of ES2022 `Error`. Define it
-            // non-enumerably so bundlers targeting older engines don't
-            // leak it into `JSON.stringify(error)` payloads on partner
-            // telemetry pipelines.
-            Object.defineProperty(this, "cause", {
-                value: args.cause,
-                writable: true,
-                configurable: true,
-                enumerable: false,
-            });
-        }
-        // Restore prototype — required when transpiling to ES5 so
-        // `instanceof` works across exception subclasses.
-        Object.setPrototypeOf(this, new.target.prototype);
-    }
-}
-//# sourceMappingURL=use_smile_id_exception.js.map
+"use strict";import{IssueSeverity as t}from"./issue_severity";export class UseSmileIDException extends Error{severity;suggestedFix;errorDetails;constructor(e){super(e.message),this.name=new.target.name,this.severity=e.severity??t.error,this.suggestedFix=e.suggestedFix,this.errorDetails=e.errorDetails,e.cause!==void 0&&Object.defineProperty(this,"cause",{value:e.cause,writable:!0,configurable:!0,enumerable:!1}),Object.setPrototypeOf(this,new.target.prototype)}}

package/dist/core/exception/use_smile_id_general_exception.d.ts

@@ -10,4 +10,3 @@ import { UseSmileIDException } from "./use_smile_id_exception";
  */
 export declare abstract class UseSmileIDGeneralException extends UseSmileIDException {
 }
-//# sourceMappingURL=use_smile_id_general_exception.d.ts.map