@smileid/usesmileid 12.0.0-beta01

package/dist/core/exception/missing_ml_configuration_block_exception.js

@@ -0,0 +1,19 @@
+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

package/dist/core/exception/missing_ml_configuration_block_exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing_ml_configuration_block_exception.js","sourceRoot":"","sources":["../../../src/core/exception/missing_ml_configuration_block_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;GAIG;AACH,MAAM,OAAO,oCAAqC,SAAQ,0BAA0B;IACzE,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,sBAAsB,CAAC;IAExE;QACE,KAAK,CAAC;YACJ,OAAO,EAAE,gEAAgE;YACzE,QAAQ,EAAE,aAAa,CAAC,OAAO;YAC/B,YAAY,EACV,+DAA+D;SAClE,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
+/**
+ * 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 declare class MissingNetworkConfigurationBlockException extends UseSmileIDBuilderException {
+    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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing_network_configuration_block_exception.d.ts","sourceRoot":"","sources":["../../../src/core/exception/missing_network_configuration_block_exception.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAG9E;;;;GAIG;AACH,qBAAa,yCAA0C,SAAQ,0BAA0B;IACvF,QAAQ,CAAC,SAAS,mCAA2D;;CAW9E"}

package/dist/core/exception/missing_network_configuration_block_exception.js

@@ -0,0 +1,19 @@
+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

package/dist/core/exception/missing_network_configuration_block_exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing_network_configuration_block_exception.js","sourceRoot":"","sources":["../../../src/core/exception/missing_network_configuration_block_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;GAIG;AACH,MAAM,OAAO,yCAA0C,SAAQ,0BAA0B;IAC9E,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,2BAA2B,CAAC;IAE7E;QACE,KAAK,CAAC;YACJ,OAAO,EACL,wEAAwE;YAC1E,QAAQ,EAAE,aAAa,CAAC,OAAO;YAC/B,YAAY,EACV,oEAAoE;SACvE,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,18 @@
+import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
+/**
+ * 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 declare class MissingPartnerConfigException extends UseSmileIDBuilderException {
+    readonly errorCode: "BUILDER_INVALID_CONFIG";
+    private constructor();
+    /** The `partnerId` was missing or blank. */
+    static missingPartnerId(): MissingPartnerConfigException;
+    /** The auth `token` was missing or blank. */
+    static missingAuthToken(): MissingPartnerConfigException;
+}
+//# sourceMappingURL=missing_partner_config_exception.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"missing_partner_config_exception.d.ts","sourceRoot":"","sources":["../../../src/core/exception/missing_partner_config_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAG9E;;;;;;;GAOG;AACH,qBAAa,6BAA8B,SAAQ,0BAA0B;IAC3E,QAAQ,CAAC,SAAS,2BAAoD;IAEtE,OAAO;IAQP,4CAA4C;IAC5C,MAAM,CAAC,gBAAgB,IAAI,6BAA6B;IAOxD,6CAA6C;IAC7C,MAAM,CAAC,gBAAgB,IAAI,6BAA6B;CAMzD"}

package/dist/core/exception/missing_partner_config_exception.js

@@ -0,0 +1,35 @@
+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

package/dist/core/exception/missing_partner_config_exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing_partner_config_exception.js","sourceRoot":"","sources":["../../../src/core/exception/missing_partner_config_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,OAAO,6BAA8B,SAAQ,0BAA0B;IAClE,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,oBAAoB,CAAC;IAEtE,YAAoB,IAA4C;QAC9D,KAAK,CAAC;YACJ,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,gCAAgC,IAAI,CAAC,SAAS,gCAAgC;YAC5F,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,4CAA4C;IAC5C,MAAM,CAAC,gBAAgB;QACrB,OAAO,IAAI,6BAA6B,CAAC;YACvC,OAAO,EAAE,+CAA+C;YACxD,SAAS,EAAE,WAAW;SACvB,CAAC,CAAC;IACL,CAAC;IAED,6CAA6C;IAC7C,MAAM,CAAC,gBAAgB;QACrB,OAAO,IAAI,6BAA6B,CAAC;YACvC,OAAO,EAAE,+CAA+C;YACxD,SAAS,EAAE,WAAW;SACvB,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+import { UseSmileIDBuilderException } from "./use_smile_id_builder_exception";
+/**
+ * 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 declare class MissingRequiredFieldException extends UseSmileIDBuilderException {
+    readonly errorCode: "BUILDER_MISSING_FIELD";
+    constructor(args: {
+        fieldName: string;
+    });
+}
+//# sourceMappingURL=missing_required_field_exception.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"missing_required_field_exception.d.ts","sourceRoot":"","sources":["../../../src/core/exception/missing_required_field_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAG9E;;;;GAIG;AACH,qBAAa,6BAA8B,SAAQ,0BAA0B;IAC3E,QAAQ,CAAC,SAAS,0BAAoD;gBAE1D,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE;CAOxC"}

package/dist/core/exception/missing_required_field_exception.js

@@ -0,0 +1,18 @@
+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

package/dist/core/exception/missing_required_field_exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing_required_field_exception.js","sourceRoot":"","sources":["../../../src/core/exception/missing_required_field_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE;;;;GAIG;AACH,MAAM,OAAO,6BAA8B,SAAQ,0BAA0B;IAClE,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,oBAAoB,CAAC;IAEtE,YAAY,IAA2B;QACrC,KAAK,CAAC;YACJ,OAAO,EAAE,mBAAmB,IAAI,CAAC,SAAS,cAAc;YACxD,YAAY,EAAE,yCAAyC;YACvD,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+/**
+ * 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.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"screen_config_validation_exceptions.d.ts","sourceRoot":"","sources":["../../../src/core/exception/screen_config_validation_exceptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,iCAAiC,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/core/exception/screen_config_validation_exceptions.js

@@ -0,0 +1,11 @@
+/**
+ * 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

package/dist/core/exception/screen_config_validation_exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen_config_validation_exceptions.js","sourceRoot":"","sources":["../../../src/core/exception/screen_config_validation_exceptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,iCAAiC,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAC"}

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

@@ -0,0 +1,12 @@
+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 declare abstract class UseSmileIDAttestationException extends UseSmileIDException {
+}
+//# sourceMappingURL=use_smile_id_attestation_exception.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_attestation_exception.d.ts","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_attestation_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;GAOG;AACH,8BAAsB,8BAA+B,SAAQ,mBAAmB;CAAG"}

package/dist/core/exception/use_smile_id_attestation_exception.js

@@ -0,0 +1,12 @@
+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

package/dist/core/exception/use_smile_id_attestation_exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_attestation_exception.js","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_attestation_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;GAOG;AACH,MAAM,OAAgB,8BAA+B,SAAQ,mBAAmB;CAAG"}

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

@@ -0,0 +1,19 @@
+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 declare abstract class UseSmileIDBuilderException extends UseSmileIDValidationException {
+}
+//# sourceMappingURL=use_smile_id_builder_exception.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_builder_exception.d.ts","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_builder_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEpF;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,0BAA2B,SAAQ,6BAA6B;CAAG"}

package/dist/core/exception/use_smile_id_builder_exception.js

@@ -0,0 +1,19 @@
+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

package/dist/core/exception/use_smile_id_builder_exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_builder_exception.js","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_builder_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEpF;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAgB,0BAA2B,SAAQ,6BAA6B;CAAG"}

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

@@ -0,0 +1,13 @@
+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 declare abstract class UseSmileIDCameraException extends UseSmileIDException {
+}
+//# sourceMappingURL=use_smile_id_camera_exception.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_camera_exception.d.ts","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_camera_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;GAQG;AACH,8BAAsB,yBAA0B,SAAQ,mBAAmB;CAAG"}

package/dist/core/exception/use_smile_id_camera_exception.js

@@ -0,0 +1,13 @@
+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

package/dist/core/exception/use_smile_id_camera_exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_camera_exception.js","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_camera_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,OAAgB,yBAA0B,SAAQ,mBAAmB;CAAG"}

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

@@ -0,0 +1,78 @@
+/**
+ * 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 declare const UseSmileIDErrorCode: {
+    /** Builder / configuration validation. */
+    readonly Builder: {
+        readonly ValidationError: "BUILDER_VALIDATION_ERROR";
+        readonly InvalidConfiguration: "BUILDER_INVALID_CONFIG";
+        readonly MissingRequiredField: "BUILDER_MISSING_FIELD";
+        readonly InvalidConsentConfig: "BUILDER_INVALID_CONSENT_CONFIG";
+        readonly MissingCaptureType: "BUILDER_MISSING_CAPTURE_TYPE";
+        readonly EmptyScreensBlock: "BUILDER_EMPTY_SCREENS";
+        readonly MissingScreenConfiguration: "BUILDER_MISSING_SCREEN_CONFIG";
+        readonly DuplicateScreenType: "BUILDER_DUPLICATE_SCREEN";
+        readonly InvalidSelfieCaptureConfig: "BUILDER_INVALID_SELFIE_CONFIG";
+        readonly InvalidDocumentCaptureConfig: "BUILDER_INVALID_DOCUMENT_CONFIG";
+        readonly MissingMLConfiguration: "BUILDER_MISSING_ML_CONFIG";
+        readonly MissingNetworkConfiguration: "BUILDER_MISSING_NETWORK_CONFIG";
+        readonly MissingJobType: "BUILDER_MISSING_JOB_TYPE";
+        readonly MissingCaptureForPreview: "BUILDER_MISSING_CAPTURE_FOR_PREVIEW";
+        readonly InvalidScreenOrder: "BUILDER_INVALID_SCREEN_ORDER";
+        readonly ConfigurationBlockFailed: "BUILDER_CONFIG_BLOCK_FAILED";
+        readonly InvalidConsentInformation: "BUILDER_INVALID_CONSENT_INFORMATION";
+        readonly InvalidJobTypeScreenConfig: "BUILDER_INVALID_JOB_TYPE_SCREEN_CONFIG";
+    };
+    /** Camera / capture surface. */
+    readonly Camera: {
+        readonly InitializationFailed: "CAMERA_INIT_FAILED";
+        readonly PermissionDenied: "CAMERA_PERMISSION_DENIED";
+        readonly CaptureFailed: "CAMERA_CAPTURE_FAILED";
+        readonly UseCaseNotSupported: "CAMERA_USE_CASE_NOT_SUPPORTED";
+        readonly Unknown: "CAMERA_UNKNOWN_ERROR";
+    };
+    /** Network / submission. */
+    readonly Network: {
+        readonly ConnectionFailed: "NETWORK_CONNECTION_FAILED";
+        readonly Timeout: "NETWORK_TIMEOUT";
+        readonly RequestFailed: "NETWORK_REQUEST_FAILED";
+        readonly ResponseParseError: "NETWORK_PARSE_ERROR";
+        readonly Unauthorized: "NETWORK_UNAUTHORIZED";
+        readonly Forbidden: "NETWORK_FORBIDDEN";
+        readonly NotFound: "NETWORK_NOT_FOUND";
+        readonly RateLimit: "NETWORK_RATE_LIMIT";
+        readonly ServerError: "NETWORK_SERVER_ERROR";
+    };
+    /** Generic input / state validation. */
+    readonly Validation: {
+        readonly InvalidInput: "VALIDATION_INVALID_INPUT";
+        readonly InvalidState: "VALIDATION_INVALID_STATE";
+        readonly ConstraintViolation: "VALIDATION_CONSTRAINT_VIOLATION";
+    };
+    /** Catch-all for failures that don't fit a category. */
+    readonly General: {
+        readonly Unknown: "GENERAL_UNKNOWN_ERROR";
+        readonly InvalidState: "GENERAL_INVALID_STATE";
+        readonly OperationFailed: "GENERAL_OPERATION_FAILED";
+    };
+};
+type UseSmileIDErrorCodeNamespace = typeof UseSmileIDErrorCode;
+/**
+ * Union of every error-code literal. Partners can write
+ * `switch (e.errorCode) { case UseSmileIDErrorCode.Builder.EmptyScreensBlock: ... }`
+ * 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"]];
+export {};
+//# sourceMappingURL=use_smile_id_error_code.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_error_code.d.ts","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_error_code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB;IAC9B,0CAA0C;;;;;;;;;;;;;;;;;;;;;IAqB1C,gCAAgC;;;;;;;;IAQhC,4BAA4B;;;;;;;;;;;;IAY5B,wCAAwC;;;;;;IAMxC,wDAAwD;;;;;;CAMhD,CAAC;AAEX,KAAK,4BAA4B,GAAG,OAAO,mBAAmB,CAAC;AAE/D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,4BAA4B,CAAC,SAAS,CAAC,CAAC,MAAM,4BAA4B,CAAC,SAAS,CAAC,CAAC,GACtF,4BAA4B,CAAC,QAAQ,CAAC,CAAC,MAAM,4BAA4B,CAAC,QAAQ,CAAC,CAAC,GACpF,4BAA4B,CAAC,SAAS,CAAC,CAAC,MAAM,4BAA4B,CAAC,SAAS,CAAC,CAAC,GACtF,4BAA4B,CAAC,YAAY,CAAC,CAAC,MAAM,4BAA4B,CAAC,YAAY,CAAC,CAAC,GAC5F,4BAA4B,CAAC,SAAS,CAAC,CAAC,MAAM,4BAA4B,CAAC,SAAS,CAAC,CAAC,CAAC"}

package/dist/core/exception/use_smile_id_error_code.js

@@ -0,0 +1,70 @@
+/**
+ * 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",
+        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

package/dist/core/exception/use_smile_id_error_code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_error_code.js","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_error_code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,0CAA0C;IAC1C,OAAO,EAAE;QACP,eAAe,EAAE,0BAA0B;QAC3C,oBAAoB,EAAE,wBAAwB;QAC9C,oBAAoB,EAAE,uBAAuB;QAC7C,oBAAoB,EAAE,gCAAgC;QACtD,kBAAkB,EAAE,8BAA8B;QAClD,iBAAiB,EAAE,uBAAuB;QAC1C,0BAA0B,EAAE,+BAA+B;QAC3D,mBAAmB,EAAE,0BAA0B;QAC/C,0BAA0B,EAAE,+BAA+B;QAC3D,4BAA4B,EAAE,iCAAiC;QAC/D,sBAAsB,EAAE,2BAA2B;QACnD,2BAA2B,EAAE,gCAAgC;QAC7D,cAAc,EAAE,0BAA0B;QAC1C,wBAAwB,EAAE,qCAAqC;QAC/D,kBAAkB,EAAE,8BAA8B;QAClD,wBAAwB,EAAE,6BAA6B;QACvD,yBAAyB,EAAE,qCAAqC;QAChE,0BAA0B,EAAE,wCAAwC;KACrE;IACD,gCAAgC;IAChC,MAAM,EAAE;QACN,oBAAoB,EAAE,oBAAoB;QAC1C,gBAAgB,EAAE,0BAA0B;QAC5C,aAAa,EAAE,uBAAuB;QACtC,mBAAmB,EAAE,+BAA+B;QACpD,OAAO,EAAE,sBAAsB;KAChC;IACD,4BAA4B;IAC5B,OAAO,EAAE;QACP,gBAAgB,EAAE,2BAA2B;QAC7C,OAAO,EAAE,iBAAiB;QAC1B,aAAa,EAAE,wBAAwB;QACvC,kBAAkB,EAAE,qBAAqB;QACzC,YAAY,EAAE,sBAAsB;QACpC,SAAS,EAAE,mBAAmB;QAC9B,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE,oBAAoB;QAC/B,WAAW,EAAE,sBAAsB;KACpC;IACD,wCAAwC;IACxC,UAAU,EAAE;QACV,YAAY,EAAE,0BAA0B;QACxC,YAAY,EAAE,0BAA0B;QACxC,mBAAmB,EAAE,iCAAiC;KACvD;IACD,wDAAwD;IACxD,OAAO,EAAE;QACP,OAAO,EAAE,uBAAuB;QAChC,YAAY,EAAE,uBAAuB;QACrC,eAAe,EAAE,0BAA0B;KAC5C;CACO,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { UseSmileIDErrorCode } from "./use_smile_id_error_code";
+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 declare abstract class UseSmileIDException extends Error {
+    /** Stable category-prefixed code — see `UseSmileIDErrorCode`. */
+    abstract readonly errorCode: UseSmileIDErrorCode;
+    /** Whether the exception blocks the current operation. */
+    readonly severity: IssueSeverity;
+    /** Concrete remediation hint — usually quotes the offending property. */
+    readonly suggestedFix: string;
+    /** Optional structured payload (e.g. `{ index, field }`). */
+    readonly errorDetails?: Readonly<Record<string, unknown>> | undefined;
+    protected constructor(args: {
+        message: string;
+        suggestedFix: string;
+        severity?: IssueSeverity | undefined;
+        errorDetails?: Readonly<Record<string, unknown>> | undefined;
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=use_smile_id_exception.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_exception.d.ts","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_exception.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;GAMG;AACH,8BAAsB,mBAAoB,SAAQ,KAAK;IACrD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IAEjD,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAEtE,SAAS,aAAa,IAAI,EAAE;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;QACrC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;QAC7D,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB;CAsBF"}

package/dist/core/exception/use_smile_id_exception.js

@@ -0,0 +1,39 @@
+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

package/dist/core/exception/use_smile_id_exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_exception.js","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_exception.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,OAAgB,mBAAoB,SAAQ,KAAK;IAIrD,0DAA0D;IACjD,QAAQ,CAAgB;IAEjC,yEAAyE;IAChE,YAAY,CAAS;IAE9B,6DAA6D;IACpD,YAAY,CAAiD;IAEtE,YAAsB,IAMrB;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,aAAa,CAAC,KAAK,CAAC;QACrD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC7B,+CAA+C;YAC/C,2DAA2D;YAC3D,2DAA2D;YAC3D,uBAAuB;YACvB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE;gBACnC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,KAAK;aAClB,CAAC,CAAC;QACL,CAAC;QACD,0DAA0D;QAC1D,kDAAkD;QAClD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF"}

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

@@ -0,0 +1,13 @@
+import { UseSmileIDException } from "./use_smile_id_exception";
+/**
+ * Catch-all category base for failures that don't fit the more
+ * specific buckets (Builder, Camera, Network, Attestation,
+ * Validation). Concrete subclasses ship as needed — see
+ * [docs/Architecture.md § Rollout].
+ *
+ * Partners can `instanceof UseSmileIDGeneralException` to catch
+ * every general-category failure with one check.
+ */
+export declare abstract class UseSmileIDGeneralException extends UseSmileIDException {
+}
+//# sourceMappingURL=use_smile_id_general_exception.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_general_exception.d.ts","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_general_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;GAQG;AACH,8BAAsB,0BAA2B,SAAQ,mBAAmB;CAAG"}

package/dist/core/exception/use_smile_id_general_exception.js

@@ -0,0 +1,13 @@
+import { UseSmileIDException } from "./use_smile_id_exception";
+/**
+ * Catch-all category base for failures that don't fit the more
+ * specific buckets (Builder, Camera, Network, Attestation,
+ * Validation). Concrete subclasses ship as needed — see
+ * [docs/Architecture.md § Rollout].
+ *
+ * Partners can `instanceof UseSmileIDGeneralException` to catch
+ * every general-category failure with one check.
+ */
+export class UseSmileIDGeneralException extends UseSmileIDException {
+}
+//# sourceMappingURL=use_smile_id_general_exception.js.map

package/dist/core/exception/use_smile_id_general_exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use_smile_id_general_exception.js","sourceRoot":"","sources":["../../../src/core/exception/use_smile_id_general_exception.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,OAAgB,0BAA2B,SAAQ,mBAAmB;CAAG"}