@stapel/forms-react 0.1.0

package/dist/i18n/generated/errors.gen.d.ts

@@ -0,0 +1,485 @@
+/**
+ * Remediation vocabulary (frontend-core-architecture §2.5). Declared by the
+ * backend on the error registry and consumed verbatim from its `errors.json`
+ * artifact. A host maps it to UX — retryable → "try again"; `wait_and_retry` →
+ * timer from `params.retry_after_minutes`; `verify` → the step-up seam;
+ * `fix_input` → highlight the offending field.
+ */
+export type Remediation = "retry" | "wait_and_retry" | "reauthenticate" | "verify" | "fix_input" | "contact_support" | "bug";
+export interface FormsErrorSpec {
+    /** HTTP status the backend raises this key with. */
+    readonly status: number;
+    /** `{param}` interpolation slots present in the message. */
+    readonly params: readonly string[];
+    /** Remediation hint declared by the backend (see {@link Remediation}). */
+    readonly remediation: Remediation;
+    /** English fallback (source: stapel-auth errors.json). */
+    readonly en: string;
+}
+/**
+ * The FORMS_ERRORS map — every `error.*` key stapel-auth can raise, keyed by its
+ * canonical code. The single source of truth behind the en fallback bundle, the
+ * remediation lookup, and the manifest `errors` block.
+ */
+export declare const FORMS_ERRORS: {
+    readonly "error.400.bad_request": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "Bad request";
+    };
+    readonly "error.400.captcha_invalid": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Captcha verification failed. Please try again.";
+    };
+    readonly "error.400.captcha_required": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Captcha token is required.";
+    };
+    readonly "error.400.description_too_long": {
+        readonly status: 400;
+        readonly params: readonly ["max_length"];
+        readonly remediation: "fix_input";
+        readonly en: "Description must be at most {max_length} characters";
+    };
+    readonly "error.400.description_too_short": {
+        readonly status: 400;
+        readonly params: readonly ["min_length"];
+        readonly remediation: "fix_input";
+        readonly en: "Description must be at least {min_length} characters";
+    };
+    readonly "error.400.expected_list": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "Expected a list of items";
+    };
+    readonly "error.400.feature_above_maximum": {
+        readonly status: 400;
+        readonly params: readonly ["feature"];
+        readonly remediation: "fix_input";
+        readonly en: "Value is above maximum for {feature}";
+    };
+    readonly "error.400.feature_below_minimum": {
+        readonly status: 400;
+        readonly params: readonly ["feature"];
+        readonly remediation: "fix_input";
+        readonly en: "Value is below minimum for {feature}";
+    };
+    readonly "error.400.feature_invalid_config": {
+        readonly status: 400;
+        readonly params: readonly ["feature"];
+        readonly remediation: "fix_input";
+        readonly en: "Invalid config for {feature}";
+    };
+    readonly "error.400.feature_invalid_format": {
+        readonly status: 400;
+        readonly params: readonly ["feature"];
+        readonly remediation: "fix_input";
+        readonly en: "Invalid format for {feature}";
+    };
+    readonly "error.400.feature_invalid_type": {
+        readonly status: 400;
+        readonly params: readonly ["feature"];
+        readonly remediation: "fix_input";
+        readonly en: "Invalid type for {feature}";
+    };
+    readonly "error.400.feature_mandatory_missing": {
+        readonly status: 400;
+        readonly params: readonly ["feature"];
+        readonly remediation: "fix_input";
+        readonly en: "Mandatory feature {feature} is required";
+    };
+    readonly "error.400.feature_not_allowed": {
+        readonly status: 400;
+        readonly params: readonly ["feature"];
+        readonly remediation: "fix_input";
+        readonly en: "Feature {feature} is not allowed here";
+    };
+    readonly "error.400.feature_not_in_options": {
+        readonly status: 400;
+        readonly params: readonly ["feature"];
+        readonly remediation: "fix_input";
+        readonly en: "Value is not in allowed options for {feature}";
+    };
+    readonly "error.400.feature_unknown": {
+        readonly status: 400;
+        readonly params: readonly ["feature"];
+        readonly remediation: "fix_input";
+        readonly en: "Unknown feature {feature}";
+    };
+    readonly "error.400.feature_unknown_type": {
+        readonly status: 400;
+        readonly params: readonly ["feature"];
+        readonly remediation: "fix_input";
+        readonly en: "Unknown feature type for {feature}";
+    };
+    readonly "error.400.field.blank": {
+        readonly status: 400;
+        readonly params: readonly ["field"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} may not be blank";
+    };
+    readonly "error.400.field.does_not_exist": {
+        readonly status: 400;
+        readonly params: readonly ["field"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} does not exist";
+    };
+    readonly "error.400.field.invalid": {
+        readonly status: 400;
+        readonly params: readonly ["field"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} is invalid";
+    };
+    readonly "error.400.field.invalid_choice": {
+        readonly status: 400;
+        readonly params: readonly ["field"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} is not a valid choice";
+    };
+    readonly "error.400.field.max_length": {
+        readonly status: 400;
+        readonly params: readonly ["field", "max_length"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} must be at most {max_length} characters";
+    };
+    readonly "error.400.field.max_value": {
+        readonly status: 400;
+        readonly params: readonly ["field", "max_value"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} must be at most {max_value}";
+    };
+    readonly "error.400.field.min_length": {
+        readonly status: 400;
+        readonly params: readonly ["field", "min_length"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} must be at least {min_length} characters";
+    };
+    readonly "error.400.field.min_value": {
+        readonly status: 400;
+        readonly params: readonly ["field", "min_value"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} must be at least {min_value}";
+    };
+    readonly "error.400.field.null": {
+        readonly status: 400;
+        readonly params: readonly ["field"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} may not be null";
+    };
+    readonly "error.400.field.required": {
+        readonly status: 400;
+        readonly params: readonly ["field"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} is required";
+    };
+    readonly "error.400.field.unique": {
+        readonly status: 400;
+        readonly params: readonly ["field"];
+        readonly remediation: "fix_input";
+        readonly en: "{field} must be unique";
+    };
+    readonly "error.400.forms_answers_not_object": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "Answers must be an object keyed by field slug";
+    };
+    readonly "error.400.forms_duplicate_slug": {
+        readonly status: 400;
+        readonly params: readonly ["slug"];
+        readonly remediation: "fix_input";
+        readonly en: "Field slug {slug} appears more than once";
+    };
+    readonly "error.400.forms_empty_schema": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "A form must have at least one field to publish";
+    };
+    readonly "error.400.forms_invalid_retention": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "The retention override may only shorten the module retention period";
+    };
+    readonly "error.400.forms_invalid_schema": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "The form schema is not valid";
+    };
+    readonly "error.400.forms_invalid_state": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "Unknown form state";
+    };
+    readonly "error.400.forms_kind_not_allowed": {
+        readonly status: 400;
+        readonly params: readonly ["kind"];
+        readonly remediation: "fix_input";
+        readonly en: "Field kind {kind} may not be used in a form";
+    };
+    readonly "error.400.forms_no_draft": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "There is no draft to publish";
+    };
+    readonly "error.400.forms_no_recipients": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "No notification recipient is configured for this form";
+    };
+    readonly "error.400.forms_not_published": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "The form has no published version yet";
+    };
+    readonly "error.400.forms_too_many_fields": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "The form has more fields than the limit allows";
+    };
+    readonly "error.400.forms_too_many_open": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "contact_support";
+        readonly en: "This workspace already has the maximum number of open forms";
+    };
+    readonly "error.400.forms_unknown_field": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "The submission answers a field the form does not have";
+    };
+    readonly "error.400.invalid_ad_id": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "Invalid advertisement ID";
+    };
+    readonly "error.400.validation_error": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "Validation error";
+    };
+    readonly "error.400.verification_failed": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "verify";
+        readonly en: "Verification failed";
+    };
+    readonly "error.400.verification_invalid_factor": {
+        readonly status: 400;
+        readonly params: readonly [];
+        readonly remediation: "verify";
+        readonly en: "This verification factor is not available";
+    };
+    readonly "error.401.unauthorized": {
+        readonly status: 401;
+        readonly params: readonly [];
+        readonly remediation: "reauthenticate";
+        readonly en: "Authentication required";
+    };
+    readonly "error.402.payment_required": {
+        readonly status: 402;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Payment required";
+    };
+    readonly "error.403.forbidden": {
+        readonly status: 403;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "You do not have permission to perform this action";
+    };
+    readonly "error.403.forms_forbidden": {
+        readonly status: 403;
+        readonly params: readonly [];
+        readonly remediation: "contact_support";
+        readonly en: "You do not have access to this form";
+    };
+    readonly "error.403.network_blocked": {
+        readonly status: 403;
+        readonly params: readonly [];
+        readonly remediation: "contact_support";
+        readonly en: "Requests from this network are not allowed";
+    };
+    readonly "error.403.verification_enrollment_required": {
+        readonly status: 403;
+        readonly params: readonly [];
+        readonly remediation: "verify";
+        readonly en: "Verification factor enrollment required";
+    };
+    readonly "error.403.verification_required": {
+        readonly status: 403;
+        readonly params: readonly [];
+        readonly remediation: "verify";
+        readonly en: "Additional verification required";
+    };
+    readonly "error.404.ad_not_found": {
+        readonly status: 404;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Listing not found";
+    };
+    readonly "error.404.forms_not_found": {
+        readonly status: 404;
+        readonly params: readonly [];
+        readonly remediation: "verify";
+        readonly en: "Form not found";
+    };
+    readonly "error.404.forms_submission_not_found": {
+        readonly status: 404;
+        readonly params: readonly [];
+        readonly remediation: "verify";
+        readonly en: "Submission not found";
+    };
+    readonly "error.404.not_found": {
+        readonly status: 404;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Requested resource not found";
+    };
+    readonly "error.404.verification_challenge_not_found": {
+        readonly status: 404;
+        readonly params: readonly [];
+        readonly remediation: "verify";
+        readonly en: "Verification challenge not found or expired";
+    };
+    readonly "error.405.method_not_allowed": {
+        readonly status: 405;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Method not allowed";
+    };
+    readonly "error.406.not_acceptable": {
+        readonly status: 406;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Not acceptable";
+    };
+    readonly "error.408.request_timeout": {
+        readonly status: 408;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Request timeout";
+    };
+    readonly "error.409.conflict": {
+        readonly status: 409;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "Resource already exists";
+    };
+    readonly "error.409.forms_submission_cap": {
+        readonly status: 409;
+        readonly params: readonly [];
+        readonly remediation: "contact_support";
+        readonly en: "This form has reached its submission limit";
+    };
+    readonly "error.409.forms_version_superseded": {
+        readonly status: 409;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "The form changed while you were filling it in";
+    };
+    readonly "error.410.forms_closed": {
+        readonly status: 410;
+        readonly params: readonly [];
+        readonly remediation: "contact_support";
+        readonly en: "This form is closed";
+    };
+    readonly "error.410.gone": {
+        readonly status: 410;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Resource has been permanently removed";
+    };
+    readonly "error.413.forms_body_too_large": {
+        readonly status: 413;
+        readonly params: readonly [];
+        readonly remediation: "fix_input";
+        readonly en: "The submission exceeds the size limit";
+    };
+    readonly "error.413.payload_too_large": {
+        readonly status: 413;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Request body is too large";
+    };
+    readonly "error.415.unsupported_media_type": {
+        readonly status: 415;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Unsupported media type";
+    };
+    readonly "error.422.unprocessable_entity": {
+        readonly status: 422;
+        readonly params: readonly [];
+        readonly remediation: "wait_and_retry";
+        readonly en: "Unprocessable entity";
+    };
+    readonly "error.423.locked": {
+        readonly status: 423;
+        readonly params: readonly [];
+        readonly remediation: "wait_and_retry";
+        readonly en: "Resource is locked";
+    };
+    readonly "error.423.verification_locked": {
+        readonly status: 423;
+        readonly params: readonly [];
+        readonly remediation: "wait_and_retry";
+        readonly en: "Too many failed attempts — verification locked";
+    };
+    readonly "error.429.rate_limit": {
+        readonly status: 429;
+        readonly params: readonly ["retry_after_minutes"];
+        readonly remediation: "wait_and_retry";
+        readonly en: "Too many attempts. Try again in {retry_after_minutes} minutes.";
+    };
+    readonly "error.429.too_many_requests": {
+        readonly status: 429;
+        readonly params: readonly [];
+        readonly remediation: "wait_and_retry";
+        readonly en: "Too many requests. Please try again later.";
+    };
+    readonly "error.500.internal": {
+        readonly status: 500;
+        readonly params: readonly [];
+        readonly remediation: "contact_support";
+        readonly en: "Something went wrong";
+    };
+    readonly "error.503.forms_workspaces_unavailable": {
+        readonly status: 503;
+        readonly params: readonly [];
+        readonly remediation: "wait_and_retry";
+        readonly en: "Workspace membership service is unavailable";
+    };
+    readonly "error.503.mandate_unavailable": {
+        readonly status: 503;
+        readonly params: readonly [];
+        readonly remediation: "retry";
+        readonly en: "Cannot verify workspace mandate right now";
+    };
+};
+export type FormsErrorCode = keyof typeof FORMS_ERRORS;
+/** Every backend error code this module can surface, sorted. */
+export declare const FORMS_ERROR_CODES: readonly FormsErrorCode[];
+/**
+ * English fallback bundle — one string per backend key, so a `StapelApiError.code`
+ * never renders as a raw key. Merged UNDER the hand-polished UI copy in
+ * {@link authI18nBundleEn} (polish wins; this guarantees coverage).
+ */
+export declare const formsErrorBundleEn: Record<FormsErrorCode, string>;
+//# sourceMappingURL=errors.gen.d.ts.map

package/dist/i18n/generated/errors.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.gen.d.ts","sourceRoot":"","sources":["../../../src/i18n/generated/errors.gen.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,gBAAgB,GAChB,gBAAgB,GAChB,QAAQ,GACR,WAAW,GACX,iBAAiB,GACjB,KAAK,CAAC;AAEV,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Ef,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,YAAY,CAAC;AAEvD,gEAAgE;AAChE,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EA4EtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CA4E7D,CAAC"}