@stapel/cdn-react 0.1.0

package/src/i18n/es.ts

@@ -0,0 +1,81 @@
+import type { I18nDictionary, I18nEngine } from "@stapel/core";
+import { cdnErrorBundleEs } from "./generated/errors.es.gen.js";
+
+export { cdnErrorBundleEs } from "./generated/errors.es.gen.js";
+
+/**
+ * Spanish bundle for cdn-react — the `@stapel/cdn-react/i18n/es` subpath.
+ * Same two sources as `./ru`: the generated bundle carries the cross-cutting
+ * keys stapel-core localizes, and the 11 keys stapel-cdn owns are authored
+ * here until upstream ships `translations/errors.es.json`.
+ *
+ * The UI copy is translated too, not only the errors. An upload control is
+ * where a seller spends the most attention while listing something, and a
+ * picker that speaks Spanish while its progress line speaks English is the
+ * half-translated surface a person notices first.
+ */
+export const cdnI18nBundleEs: I18nDictionary = {
+  ...cdnErrorBundleEs,
+
+  // Backend error codes stapel-cdn owns — authored here.
+  "error.400.file_hash_required": "Falta el parámetro file_hash",
+  "error.400.file_type_not_allowed": "No se permite este tipo de archivo",
+  "error.400.invalid_format": "Formato de archivo no admitido",
+  "error.400.invalid_hash": "Hash de archivo no válido",
+  "error.400.invalid_image_type": "Tipo de imagen desconocido",
+  "error.400.missing_fields": "Faltan campos obligatorios",
+  "error.400.no_file": "No se ha elegido ningún archivo",
+  "error.403.storage_quota_exceeded": "Se ha superado la cuota de almacenamiento",
+  "error.404.no_images": "No se han encontrado imágenes procesadas",
+  "error.413.file_too_large": "El archivo es demasiado grande",
+  "error.503.image_decoder_unavailable":
+    "Este servidor no puede procesar imágenes {extension} ahora mismo",
+
+  // UI copy.
+  "cdn.error.unknown": "Algo ha fallado en esta subida",
+
+  "cdn.pick.image": "Elegir una imagen",
+  "cdn.pick.images": "Añadir fotos",
+  "cdn.pick.replace": "Reemplazar",
+  "cdn.pick.hint": "{formats} · hasta {maxMb} MB",
+  "cdn.pick.drop_hint": "Arrastra archivos aquí o haz clic para elegirlos",
+
+  "cdn.phase.hashing": "Leyendo el archivo…",
+  "cdn.phase.checking": "Comprobando si ya lo tenemos…",
+  "cdn.phase.uploading": "Subiendo…",
+  "cdn.phase.processing": "Preparando las vistas previas…",
+  "cdn.phase.done": "Listo",
+  "cdn.phase.canceled": "Cancelado",
+  "cdn.phase.failed": "Ha fallado",
+  "cdn.phase.queued": "Esperando su turno",
+
+  "cdn.outcome.deduped": "Ya estaba subido: no se ha enviado nada de nuevo",
+  "cdn.outcome.variants_pending":
+    "Las vistas previas se están generando; la foto ya está guardada",
+  "cdn.outcome.dedup_skipped.no_crypto":
+    "Esta página no puede calcular el hash, así que se ha omitido la comprobación de duplicados",
+  "cdn.outcome.dedup_skipped.unauthorized":
+    "La comprobación de duplicados necesita una sesión iniciada; la subida ha continuado",
+  "cdn.outcome.dedup_skipped.check_failed":
+    "La comprobación de duplicados no ha respondido; la subida ha continuado",
+
+  "cdn.item.cancel": "Cancelar",
+  "cdn.item.retry": "Reintentar",
+  "cdn.item.remove": "Quitar",
+  "cdn.item.move_earlier": "Mover antes",
+  "cdn.item.move_later": "Mover después",
+  "cdn.item.cover": "Foto principal",
+  "cdn.item.alt": "Foto subida",
+
+  "cdn.gallery.count": "{used} de {max} fotos",
+  "cdn.gallery.empty": "Todavía no hay fotos",
+
+  "cdn.upload.blocked.full": "Esta galería admite como máximo {max} fotos",
+  "cdn.upload.blocked.pending": "Espera a que terminen las subidas",
+  "cdn.upload.blocked.failed": "Quita o reintenta las fotos que han fallado",
+};
+
+/** Register the Spanish bundle into a core i18n engine. */
+export function registerCdnI18nEs(engine: I18nEngine, locale = "es"): void {
+  engine.registerBundle(locale, cdnI18nBundleEs);
+}

package/src/i18n/generated/errors.es.gen.ts

@@ -0,0 +1,64 @@
+// AUTO-GENERATED by scripts/gen-errors.mjs — do not edit by hand.
+// Source: stapel-auth canonical errors.json (backend codegen artifact).
+// Regenerate: pnpm gen:errors   ·   Drift gate: pnpm gen:errors:check
+// Locale source: backend translations/errors.es.json (locale catalog
+// beside the canonical errors.json — i18n-shipping.md §1).
+import type { CdnErrorCode } from "./errors.gen.js";
+
+/**
+ * `es` texts for the backend error codes this catalog carries.
+ *
+ * PARTIAL, and deliberately typed to say so: 11 key(s) owned by
+ * stapel_cdn are absent, because that owner ships no locale catalog
+ * (ERRORS_LOCALE_EXEMPT_OWNERS). English for them still comes from the registry
+ * artifact via the en bundle; the pair layers its own authored `es`
+ * strings over this one until upstream ships translations. `Partial` is what
+ * makes the gap visible to TypeScript instead of a silent English fallback.
+ *
+ * Import from the pair's `./i18n/es` subpath, NOT the main entry, so
+ * the locale stays out of hosts that don't ship it.
+ */
+export const cdnErrorBundleEs: Partial<Record<CdnErrorCode, string>> = {
+  "error.400.bad_request": "Solicitud incorrecta",
+  "error.400.captcha_invalid": "La verificación del captcha ha fallado. Inténtalo de nuevo.",
+  "error.400.captcha_required": "Se requiere el token del captcha.",
+  "error.400.expected_list": "Se esperaba una lista de elementos",
+  "error.400.field.blank": "{field} no puede estar vacío",
+  "error.400.field.does_not_exist": "{field} no existe",
+  "error.400.field.invalid": "{field} no es válido",
+  "error.400.field.invalid_choice": "{field} no es una opción válida",
+  "error.400.field.max_length": "{field} debe tener como máximo {max_length} caracteres",
+  "error.400.field.max_value": "{field} debe ser como máximo {max_value}",
+  "error.400.field.min_length": "{field} debe tener al menos {min_length} caracteres",
+  "error.400.field.min_value": "{field} debe ser como mínimo {min_value}",
+  "error.400.field.null": "{field} no puede ser nulo",
+  "error.400.field.required": "{field} es obligatorio",
+  "error.400.field.unique": "{field} debe ser único",
+  "error.400.invalid_ad_id": "ID de anuncio no válido",
+  "error.400.validation_error": "Error de validación",
+  "error.400.verification_failed": "La verificación ha fallado",
+  "error.400.verification_invalid_factor": "Este factor de verificación no está disponible",
+  "error.401.unauthorized": "Se requiere autenticación",
+  "error.402.payment_required": "Se requiere pago",
+  "error.403.forbidden": "No tienes permiso para realizar esta acción",
+  "error.403.network_blocked": "No se permiten solicitudes desde esta red.",
+  "error.403.verification_enrollment_required": "Es necesario registrar un factor de verificación.",
+  "error.403.verification_required": "Se requiere verificación adicional",
+  "error.404.ad_not_found": "Anuncio no encontrado",
+  "error.404.not_found": "Recurso solicitado no encontrado",
+  "error.404.verification_challenge_not_found": "Desafío de verificación no encontrado o caducado",
+  "error.405.method_not_allowed": "Método no permitido",
+  "error.406.not_acceptable": "No aceptable",
+  "error.408.request_timeout": "Tiempo de espera de la solicitud agotado",
+  "error.409.conflict": "El recurso ya existe",
+  "error.410.gone": "El recurso se ha eliminado permanentemente",
+  "error.413.payload_too_large": "El cuerpo de la solicitud es demasiado grande",
+  "error.415.unsupported_media_type": "Tipo de contenido no compatible",
+  "error.422.unprocessable_entity": "Entidad no procesable",
+  "error.423.locked": "El recurso está bloqueado",
+  "error.423.verification_locked": "Demasiados intentos fallidos — verificación bloqueada",
+  "error.429.rate_limit": "Demasiados intentos. Inténtalo de nuevo en {retry_after_minutes} minutos.",
+  "error.429.too_many_requests": "Demasiadas solicitudes. Inténtalo de nuevo más tarde.",
+  "error.500.internal": "Algo salió mal",
+  "error.503.mandate_unavailable": "No se puede verificar el mandato del espacio de trabajo",
+};

package/src/i18n/generated/errors.gen.ts

@@ -0,0 +1,211 @@
+// AUTO-GENERATED by scripts/gen-errors.mjs — do not edit by hand.
+// Source: stapel-auth canonical errors.json (backend codegen artifact).
+// Regenerate: pnpm gen:errors   ·   Drift gate: pnpm gen:errors:check
+
+/**
+ * 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 CdnErrorSpec {
+  /** 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 CDN_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 const CDN_ERRORS = {
+  "error.400.bad_request": { status: 400, params: [], remediation: "fix_input", en: "Bad request" },
+  "error.400.captcha_invalid": { status: 400, params: [], remediation: "retry", en: "Captcha verification failed. Please try again." },
+  "error.400.captcha_required": { status: 400, params: [], remediation: "retry", en: "Captcha token is required." },
+  "error.400.expected_list": { status: 400, params: [], remediation: "fix_input", en: "Expected a list of items" },
+  "error.400.field.blank": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} may not be blank" },
+  "error.400.field.does_not_exist": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} does not exist" },
+  "error.400.field.invalid": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} is invalid" },
+  "error.400.field.invalid_choice": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} is not a valid choice" },
+  "error.400.field.max_length": { status: 400, params: ["field","max_length"], remediation: "fix_input", en: "{field} must be at most {max_length} characters" },
+  "error.400.field.max_value": { status: 400, params: ["field","max_value"], remediation: "fix_input", en: "{field} must be at most {max_value}" },
+  "error.400.field.min_length": { status: 400, params: ["field","min_length"], remediation: "fix_input", en: "{field} must be at least {min_length} characters" },
+  "error.400.field.min_value": { status: 400, params: ["field","min_value"], remediation: "fix_input", en: "{field} must be at least {min_value}" },
+  "error.400.field.null": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} may not be null" },
+  "error.400.field.required": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} is required" },
+  "error.400.field.unique": { status: 400, params: ["field"], remediation: "fix_input", en: "{field} must be unique" },
+  "error.400.file_hash_required": { status: 400, params: [], remediation: "fix_input", en: "file_hash parameter is required" },
+  "error.400.file_type_not_allowed": { status: 400, params: [], remediation: "fix_input", en: "File type not allowed" },
+  "error.400.invalid_ad_id": { status: 400, params: [], remediation: "fix_input", en: "Invalid advertisement ID" },
+  "error.400.invalid_format": { status: 400, params: [], remediation: "fix_input", en: "Unsupported file format" },
+  "error.400.invalid_hash": { status: 400, params: [], remediation: "fix_input", en: "Invalid file hash" },
+  "error.400.invalid_image_type": { status: 400, params: [], remediation: "fix_input", en: "Invalid image type" },
+  "error.400.missing_fields": { status: 400, params: [], remediation: "fix_input", en: "Required fields are missing" },
+  "error.400.no_file": { status: 400, params: [], remediation: "fix_input", en: "No file provided" },
+  "error.400.validation_error": { status: 400, params: [], remediation: "fix_input", en: "Validation error" },
+  "error.400.verification_failed": { status: 400, params: [], remediation: "verify", en: "Verification failed" },
+  "error.400.verification_invalid_factor": { status: 400, params: [], remediation: "verify", en: "This verification factor is not available" },
+  "error.401.unauthorized": { status: 401, params: [], remediation: "reauthenticate", en: "Authentication required" },
+  "error.402.payment_required": { status: 402, params: [], remediation: "retry", en: "Payment required" },
+  "error.403.forbidden": { status: 403, params: [], remediation: "retry", en: "You do not have permission to perform this action" },
+  "error.403.network_blocked": { status: 403, params: [], remediation: "contact_support", en: "Requests from this network are not allowed" },
+  "error.403.storage_quota_exceeded": { status: 403, params: [], remediation: "retry", en: "Storage quota exceeded" },
+  "error.403.verification_enrollment_required": { status: 403, params: [], remediation: "verify", en: "Verification factor enrollment required" },
+  "error.403.verification_required": { status: 403, params: [], remediation: "verify", en: "Additional verification required" },
+  "error.404.ad_not_found": { status: 404, params: [], remediation: "retry", en: "Listing not found" },
+  "error.404.no_images": { status: 404, params: [], remediation: "fix_input", en: "No processed images found" },
+  "error.404.not_found": { status: 404, params: [], remediation: "retry", en: "Requested resource not found" },
+  "error.404.verification_challenge_not_found": { status: 404, params: [], remediation: "verify", en: "Verification challenge not found or expired" },
+  "error.405.method_not_allowed": { status: 405, params: [], remediation: "retry", en: "Method not allowed" },
+  "error.406.not_acceptable": { status: 406, params: [], remediation: "retry", en: "Not acceptable" },
+  "error.408.request_timeout": { status: 408, params: [], remediation: "retry", en: "Request timeout" },
+  "error.409.conflict": { status: 409, params: [], remediation: "fix_input", en: "Resource already exists" },
+  "error.410.gone": { status: 410, params: [], remediation: "retry", en: "Resource has been permanently removed" },
+  "error.413.file_too_large": { status: 413, params: [], remediation: "retry", en: "File is too large" },
+  "error.413.payload_too_large": { status: 413, params: [], remediation: "retry", en: "Request body is too large" },
+  "error.415.unsupported_media_type": { status: 415, params: [], remediation: "retry", en: "Unsupported media type" },
+  "error.422.unprocessable_entity": { status: 422, params: [], remediation: "wait_and_retry", en: "Unprocessable entity" },
+  "error.423.locked": { status: 423, params: [], remediation: "wait_and_retry", en: "Resource is locked" },
+  "error.423.verification_locked": { status: 423, params: [], remediation: "wait_and_retry", en: "Too many failed attempts — verification locked" },
+  "error.429.rate_limit": { status: 429, params: ["retry_after_minutes"], remediation: "wait_and_retry", en: "Too many attempts. Try again in {retry_after_minutes} minutes." },
+  "error.429.too_many_requests": { status: 429, params: [], remediation: "wait_and_retry", en: "Too many requests. Please try again later." },
+  "error.500.internal": { status: 500, params: [], remediation: "contact_support", en: "Something went wrong" },
+  "error.503.image_decoder_unavailable": { status: 503, params: ["extension"], remediation: "contact_support", en: "This server cannot process {extension} images right now" },
+  "error.503.mandate_unavailable": { status: 503, params: [], remediation: "retry", en: "Cannot verify workspace mandate right now" },
+} as const;
+
+export type CdnErrorCode = keyof typeof CDN_ERRORS;
+
+/** Every backend error code this module can surface, sorted. */
+export const CDN_ERROR_CODES: readonly CdnErrorCode[] = [
+  "error.400.bad_request",
+  "error.400.captcha_invalid",
+  "error.400.captcha_required",
+  "error.400.expected_list",
+  "error.400.field.blank",
+  "error.400.field.does_not_exist",
+  "error.400.field.invalid",
+  "error.400.field.invalid_choice",
+  "error.400.field.max_length",
+  "error.400.field.max_value",
+  "error.400.field.min_length",
+  "error.400.field.min_value",
+  "error.400.field.null",
+  "error.400.field.required",
+  "error.400.field.unique",
+  "error.400.file_hash_required",
+  "error.400.file_type_not_allowed",
+  "error.400.invalid_ad_id",
+  "error.400.invalid_format",
+  "error.400.invalid_hash",
+  "error.400.invalid_image_type",
+  "error.400.missing_fields",
+  "error.400.no_file",
+  "error.400.validation_error",
+  "error.400.verification_failed",
+  "error.400.verification_invalid_factor",
+  "error.401.unauthorized",
+  "error.402.payment_required",
+  "error.403.forbidden",
+  "error.403.network_blocked",
+  "error.403.storage_quota_exceeded",
+  "error.403.verification_enrollment_required",
+  "error.403.verification_required",
+  "error.404.ad_not_found",
+  "error.404.no_images",
+  "error.404.not_found",
+  "error.404.verification_challenge_not_found",
+  "error.405.method_not_allowed",
+  "error.406.not_acceptable",
+  "error.408.request_timeout",
+  "error.409.conflict",
+  "error.410.gone",
+  "error.413.file_too_large",
+  "error.413.payload_too_large",
+  "error.415.unsupported_media_type",
+  "error.422.unprocessable_entity",
+  "error.423.locked",
+  "error.423.verification_locked",
+  "error.429.rate_limit",
+  "error.429.too_many_requests",
+  "error.500.internal",
+  "error.503.image_decoder_unavailable",
+  "error.503.mandate_unavailable",
+];
+
+/**
+ * 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 const cdnErrorBundleEn: Record<CdnErrorCode, string> = {
+  "error.400.bad_request": "Bad request",
+  "error.400.captcha_invalid": "Captcha verification failed. Please try again.",
+  "error.400.captcha_required": "Captcha token is required.",
+  "error.400.expected_list": "Expected a list of items",
+  "error.400.field.blank": "{field} may not be blank",
+  "error.400.field.does_not_exist": "{field} does not exist",
+  "error.400.field.invalid": "{field} is invalid",
+  "error.400.field.invalid_choice": "{field} is not a valid choice",
+  "error.400.field.max_length": "{field} must be at most {max_length} characters",
+  "error.400.field.max_value": "{field} must be at most {max_value}",
+  "error.400.field.min_length": "{field} must be at least {min_length} characters",
+  "error.400.field.min_value": "{field} must be at least {min_value}",
+  "error.400.field.null": "{field} may not be null",
+  "error.400.field.required": "{field} is required",
+  "error.400.field.unique": "{field} must be unique",
+  "error.400.file_hash_required": "file_hash parameter is required",
+  "error.400.file_type_not_allowed": "File type not allowed",
+  "error.400.invalid_ad_id": "Invalid advertisement ID",
+  "error.400.invalid_format": "Unsupported file format",
+  "error.400.invalid_hash": "Invalid file hash",
+  "error.400.invalid_image_type": "Invalid image type",
+  "error.400.missing_fields": "Required fields are missing",
+  "error.400.no_file": "No file provided",
+  "error.400.validation_error": "Validation error",
+  "error.400.verification_failed": "Verification failed",
+  "error.400.verification_invalid_factor": "This verification factor is not available",
+  "error.401.unauthorized": "Authentication required",
+  "error.402.payment_required": "Payment required",
+  "error.403.forbidden": "You do not have permission to perform this action",
+  "error.403.network_blocked": "Requests from this network are not allowed",
+  "error.403.storage_quota_exceeded": "Storage quota exceeded",
+  "error.403.verification_enrollment_required": "Verification factor enrollment required",
+  "error.403.verification_required": "Additional verification required",
+  "error.404.ad_not_found": "Listing not found",
+  "error.404.no_images": "No processed images found",
+  "error.404.not_found": "Requested resource not found",
+  "error.404.verification_challenge_not_found": "Verification challenge not found or expired",
+  "error.405.method_not_allowed": "Method not allowed",
+  "error.406.not_acceptable": "Not acceptable",
+  "error.408.request_timeout": "Request timeout",
+  "error.409.conflict": "Resource already exists",
+  "error.410.gone": "Resource has been permanently removed",
+  "error.413.file_too_large": "File is too large",
+  "error.413.payload_too_large": "Request body is too large",
+  "error.415.unsupported_media_type": "Unsupported media type",
+  "error.422.unprocessable_entity": "Unprocessable entity",
+  "error.423.locked": "Resource is locked",
+  "error.423.verification_locked": "Too many failed attempts — verification locked",
+  "error.429.rate_limit": "Too many attempts. Try again in {retry_after_minutes} minutes.",
+  "error.429.too_many_requests": "Too many requests. Please try again later.",
+  "error.500.internal": "Something went wrong",
+  "error.503.image_decoder_unavailable": "This server cannot process {extension} images right now",
+  "error.503.mandate_unavailable": "Cannot verify workspace mandate right now",
+};