@stapel/chat-react 0.1.0

package/src/headless/StartDirectChat.tsx

@@ -0,0 +1,75 @@
+import { useCallback } from "react";
+import type { ReactNode } from "react";
+import { actionAvailable, actionBlocked, firstBlock } from "@stapel/core";
+import type { ActionAvailability } from "@stapel/core";
+import type { Conversation } from "../api/types.js";
+import { useStartDirectChat } from "../model/mutations.js";
+import { CHAT_I18N_KEYS } from "../i18n/keys.js";
+
+/** Render-prop bag for {@link StartDirectChat}. */
+export interface StartDirectChatBag {
+  /** Blocked reasons: no seller on the listing, or the viewer IS the seller. */
+  readonly availability: ActionAvailability;
+  readonly isStarting: boolean;
+  /** The thread, once opened. */
+  readonly conversation: Conversation | undefined;
+  readonly error: unknown;
+  start(): void;
+}
+
+/**
+ * "Message the seller" — the buyer's entry into chat, headless.
+ *
+ * One press, one durable outcome: the direct thread with that person, created
+ * if it does not exist and returned if it does. The idempotency is the
+ * module's own (`direct_key` over the participant pair, under a unique
+ * constraint), so a double click, two tabs, or a second listing by the same
+ * seller all land in the same conversation rather than fanning out into
+ * near-duplicate threads.
+ *
+ * WHAT THIS BUTTON CANNOT DO, AND WHY IT SAYS SO HERE. It cannot open a
+ * thread ABOUT a listing. The thread is keyed by the pair of people, and
+ * `CreateConversationRequest.scope_key` — which looks like the place to put a
+ * listing id — is ignored by the server (`api/extensions.ts`). A host that
+ * wants the listing named does it in the first message, via
+ * `<MessageComposer>`'s initial value.
+ */
+export function StartDirectChat(props: {
+  /** The other person. `null`/`undefined` blocks the control with a reason. */
+  sellerId: string | null | undefined;
+  /** The viewer, when known — writing to yourself is blocked with a reason. */
+  viewerId?: string | null;
+  /** Navigate to the thread. Called once, with the opened conversation. */
+  onOpened?: (conversation: Conversation) => void;
+  children: (bag: StartDirectChatBag) => ReactNode;
+}): ReactNode {
+  const start = useStartDirectChat();
+  const { sellerId, viewerId, onOpened } = props;
+
+  const availability: ActionAvailability = firstBlock(
+    sellerId === null || sellerId === undefined || sellerId.length === 0
+      ? actionBlocked(CHAT_I18N_KEYS.startBlockedUnknownSeller)
+      : actionAvailable(),
+    viewerId != null && viewerId === sellerId
+      ? actionBlocked(CHAT_I18N_KEYS.startBlockedSelf)
+      : actionAvailable()
+  );
+
+  const { mutate, isPending, data, error } = start;
+  const doStart = useCallback((): void => {
+    if (!availability.available || isPending) return;
+    if (sellerId === null || sellerId === undefined) return;
+    mutate(
+      { userId: sellerId },
+      { onSuccess: (conversation) => onOpened?.(conversation) }
+    );
+  }, [availability.available, isPending, mutate, sellerId, onOpened]);
+
+  return props.children({
+    availability,
+    isStarting: isPending,
+    conversation: data,
+    error,
+    start: doStart,
+  });
+}

package/src/i18n/errorsMap.ts

@@ -0,0 +1,31 @@
+/**
+ * The pair's error map (frontend-standard §4 checklist #7, frontend-core §2.5):
+ * the generated `code → { status, params, remediation, en }` catalog plus a
+ * tiny `explain()` lookup. Backs the manifest `errors` block and gives hosts a
+ * mechanical UX branch beside `t(code, params)`. The map itself is generated
+ * from the backend registry (`pnpm gen:errors`); this file only adds the
+ * lookup helper and re-exports the public surface.
+ */
+import { CHAT_ERRORS } from "./generated/errors.gen.js";
+import type { Remediation } from "./generated/errors.gen.js";
+
+export {
+  CHAT_ERRORS,
+  CHAT_ERROR_CODES,
+  chatErrorBundleEn,
+} from "./generated/errors.gen.js";
+export type {
+  ChatErrorCode,
+  ChatErrorSpec,
+  Remediation,
+} from "./generated/errors.gen.js";
+
+/**
+ * Resolve a backend error code to its remediation hint, or `undefined` for a
+ * code this module doesn't know (e.g. a cross-cutting `stapel.http.*`
+ * fallback). Zero guessing at runtime — a static lookup over the generated map.
+ */
+export function explainChatError(code: string): Remediation | undefined {
+  return (CHAT_ERRORS as Record<string, { remediation: Remediation }>)[code]
+    ?.remediation;
+}

package/src/i18n/es.ts

@@ -0,0 +1,95 @@
+import type { I18nDictionary, I18nEngine } from "@stapel/core";
+import { chatI18nBundleEn } from "./keys.js";
+import { chatErrorBundleEs } from "./generated/errors.es.gen.js";
+
+export { chatErrorBundleEs } from "./generated/errors.es.gen.js";
+
+/**
+ * Spanish bundle for chat-react — the pair's `es` locale, shipped as the
+ * `@stapel/chat-react/i18n/es` subpath (i18n-shipping.md §2) so the locale is
+ * opt-in.
+ *
+ * Same two sources as the `ru` bundle: the generated `chatErrorBundleEs`
+ * carries the keys stapel-core owns; the 12 keys stapel-chat owns are authored
+ * here because the module ships no `translations/` directory (see `ru.ts` for
+ * the full note). Unlike notifications-react's es bundle, this one DOES carry
+ * hand-written UI copy — a marketplace's buyer-to-seller chat is the surface
+ * where a half-translated screen is most obvious.
+ */
+export const chatI18nBundleEs: I18nDictionary = {
+  // Backend error codes — generated es texts for every key core owns.
+  ...chatErrorBundleEs,
+
+  // Backend error codes stapel-chat owns — authored here (see the note above).
+  "error.400.chat_attachments_disabled":
+    "Los archivos adjuntos no están habilitados en esta instalación",
+  "error.400.chat_body_too_long": "El mensaje supera la longitud máxima permitida",
+  "error.400.chat_empty_message":
+    "Un mensaje debe llevar texto o al menos un archivo adjunto",
+  "error.400.chat_invalid_direct":
+    "Una conversación directa necesita exactamente un interlocutor",
+  "error.400.chat_invalid_kind": "Tipo de conversación desconocido",
+  "error.400.chat_invalid_reply":
+    "El mensaje al que respondes no pertenece a esta conversación",
+  "error.400.chat_kind_disabled":
+    "Este tipo de conversación no está habilitado en esta instalación",
+  "error.400.chat_not_support":
+    "Esta acción solo se aplica a conversaciones de soporte",
+  "error.403.chat_not_operator":
+    "Solo un operador de soporte puede realizar esta acción",
+  "error.403.chat_not_participant": "No participas en esta conversación",
+  "error.404.chat_conversation_not_found": "Conversación no encontrada",
+  "error.409.chat_already_assigned": "Esta conversación de soporte ya está asignada",
+
+  // chat-react UI (hand-written es mirror of the en copy in keys.ts)
+  "chat.error.unknown": "Algo ha salido mal. Inténtalo de nuevo.",
+
+  "chat.list.title": "Mensajes",
+  "chat.list.empty": "Todavía no hay conversaciones.",
+  "chat.list.loading": "Cargando conversaciones…",
+  "chat.list.load_more": "Cargar más",
+  "chat.list.end": "Esto es todo.",
+  "chat.list.retry": "Reintentar",
+  "chat.list.unread": "{count} sin leer",
+  "chat.list.open": "Abrir",
+
+  "chat.kind.direct": "Mensaje directo",
+  "chat.kind.group": "Grupo",
+  "chat.kind.support": "Soporte",
+
+  "chat.thread.loading": "Cargando mensajes…",
+  "chat.thread.empty": "Todavía no hay mensajes. Saluda.",
+  "chat.thread.retry": "Reintentar",
+  "chat.thread.load_older": "Ver mensajes anteriores",
+  "chat.thread.beginning": "Este es el principio de la conversación.",
+  "chat.thread.system": "Sistema",
+
+  "chat.composer.placeholder": "Escribe un mensaje…",
+  "chat.composer.send": "Enviar",
+  "chat.composer.sending": "Enviando…",
+  "chat.composer.blocked.empty": "Escribe algo primero.",
+  "chat.composer.blocked.too_long":
+    "Eso supera los {max} caracteres — acórtalo un poco.",
+
+  "chat.start.button": "Escribir al vendedor",
+  "chat.start.starting": "Abriendo…",
+  "chat.start.blocked.self": "Este anuncio es tuyo.",
+  "chat.start.blocked.unknown_seller": "Este anuncio no tiene vendedor a quien escribir.",
+
+  "chat.transport.live": "En directo",
+  "chat.transport.polling": "Actualizando cada pocos segundos",
+  "chat.transport.idle": "En pausa",
+
+  "chat.nav.conversations": "Mensajes",
+};
+
+/**
+ * Register the pair's `es` locale into a core i18n engine (call once at
+ * startup, after {@link registerChatI18n}). The en floor is registered UNDER
+ * the es texts inside the `es` locale, so any key the es bundle does not carry
+ * degrades to its English text rather than to a raw key.
+ */
+export function registerChatI18nEs(engine: I18nEngine): void {
+  engine.registerBundle("es", chatI18nBundleEn);
+  engine.registerBundle("es", chatI18nBundleEs);
+}

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 { ChatErrorCode } from "./errors.gen.js";
+
+/**
+ * `es` texts for the backend error codes this catalog carries.
+ *
+ * PARTIAL, and deliberately typed to say so: 12 key(s) owned by
+ * stapel_chat 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 chatErrorBundleEs: Partial<Record<ChatErrorCode, 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,214 @@
+// 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 ChatErrorSpec {
+  /** 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 CHAT_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 CHAT_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.chat_attachments_disabled": { status: 400, params: [], remediation: "fix_input", en: "Attachments are not enabled in this deployment" },
+  "error.400.chat_body_too_long": { status: 400, params: [], remediation: "fix_input", en: "Message body exceeds the maximum allowed length" },
+  "error.400.chat_empty_message": { status: 400, params: [], remediation: "fix_input", en: "A message must carry a body or at least one attachment" },
+  "error.400.chat_invalid_direct": { status: 400, params: [], remediation: "fix_input", en: "A direct conversation needs exactly one other participant" },
+  "error.400.chat_invalid_kind": { status: 400, params: [], remediation: "fix_input", en: "Unknown conversation kind" },
+  "error.400.chat_invalid_reply": { status: 400, params: [], remediation: "fix_input", en: "The replied-to message does not belong to this conversation" },
+  "error.400.chat_kind_disabled": { status: 400, params: [], remediation: "fix_input", en: "This conversation kind is not enabled in this deployment" },
+  "error.400.chat_not_support": { status: 400, params: [], remediation: "fix_input", en: "This operation applies only to support conversations" },
+  "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.invalid_ad_id": { status: 400, params: [], remediation: "fix_input", en: "Invalid advertisement ID" },
+  "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.chat_not_operator": { status: 403, params: [], remediation: "retry", en: "Only a support operator may perform this action" },
+  "error.403.chat_not_participant": { status: 403, params: [], remediation: "retry", en: "You are not a participant of this conversation" },
+  "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.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.chat_conversation_not_found": { status: 404, params: [], remediation: "retry", en: "Conversation not 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.chat_already_assigned": { status: 409, params: [], remediation: "fix_input", en: "This support conversation is already assigned" },
+  "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.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.mandate_unavailable": { status: 503, params: [], remediation: "retry", en: "Cannot verify workspace mandate right now" },
+} as const;
+
+export type ChatErrorCode = keyof typeof CHAT_ERRORS;
+
+/** Every backend error code this module can surface, sorted. */
+export const CHAT_ERROR_CODES: readonly ChatErrorCode[] = [
+  "error.400.bad_request",
+  "error.400.captcha_invalid",
+  "error.400.captcha_required",
+  "error.400.chat_attachments_disabled",
+  "error.400.chat_body_too_long",
+  "error.400.chat_empty_message",
+  "error.400.chat_invalid_direct",
+  "error.400.chat_invalid_kind",
+  "error.400.chat_invalid_reply",
+  "error.400.chat_kind_disabled",
+  "error.400.chat_not_support",
+  "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.invalid_ad_id",
+  "error.400.validation_error",
+  "error.400.verification_failed",
+  "error.400.verification_invalid_factor",
+  "error.401.unauthorized",
+  "error.402.payment_required",
+  "error.403.chat_not_operator",
+  "error.403.chat_not_participant",
+  "error.403.forbidden",
+  "error.403.network_blocked",
+  "error.403.verification_enrollment_required",
+  "error.403.verification_required",
+  "error.404.ad_not_found",
+  "error.404.chat_conversation_not_found",
+  "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.chat_already_assigned",
+  "error.409.conflict",
+  "error.410.gone",
+  "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.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 chatErrorBundleEn: Record<ChatErrorCode, 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.chat_attachments_disabled": "Attachments are not enabled in this deployment",
+  "error.400.chat_body_too_long": "Message body exceeds the maximum allowed length",
+  "error.400.chat_empty_message": "A message must carry a body or at least one attachment",
+  "error.400.chat_invalid_direct": "A direct conversation needs exactly one other participant",
+  "error.400.chat_invalid_kind": "Unknown conversation kind",
+  "error.400.chat_invalid_reply": "The replied-to message does not belong to this conversation",
+  "error.400.chat_kind_disabled": "This conversation kind is not enabled in this deployment",
+  "error.400.chat_not_support": "This operation applies only to support conversations",
+  "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.invalid_ad_id": "Invalid advertisement ID",
+  "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.chat_not_operator": "Only a support operator may perform this action",
+  "error.403.chat_not_participant": "You are not a participant of this conversation",
+  "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.verification_enrollment_required": "Verification factor enrollment required",
+  "error.403.verification_required": "Additional verification required",
+  "error.404.ad_not_found": "Listing not found",
+  "error.404.chat_conversation_not_found": "Conversation not 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.chat_already_assigned": "This support conversation is already assigned",
+  "error.409.conflict": "Resource already exists",
+  "error.410.gone": "Resource has been permanently removed",
+  "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.mandate_unavailable": "Cannot verify workspace mandate right now",
+};