@devultur/convex 1.4.0 → 1.4.2

package/README.md

@@ -654,7 +654,12 @@ any other error, so your app keeps its own fallback. A code it doesn't know gets
 `devulturErrorLabels` is the English map, typed `Record<DevulturErrorCode, string | ((details) => string)>`:
 `DevulturErrorCode` is the union of every stable code (`DEVULTUR_ERROR_CODES` lists them), and a function label reads
 the error's details, such as `file_too_large`'s `limit`. `@devultur/convex/locales/es` exports the Spanish map under
-the same name:
+the same name.
+
+`@devultur/convex/locales/es` addresses the reader with «tú» ("Vuelve a intentarlo"). For «usted» ("Vuelva a
+intentarlo", "No tiene permiso…"), import the same names from `@devultur/convex/locales/es-formal`: it exports exactly
+what `locales/es` does (error, attachment, preview, library and picker labels), and differs only in the strings that
+address the reader.
 
 ```tsx
 import { describeDevulturError } from "@devultur/convex";

package/dist/chunk-JZYKPLI4.js

@@ -0,0 +1,185 @@
+import {
+  formatDuration,
+  formatFileSize
+} from "./chunk-QBHIZBOQ.js";
+import {
+  describeDevulturError,
+  formatBytes,
+  formatDate,
+  labelText
+} from "./chunk-YYOZ3PDH.js";
+
+// src/locales/es.ts
+var LOCALE = "es";
+var devulturErrorLabels = {
+  file_too_large: (details) => {
+    const limit = typeof details.limit === "number" ? formatBytes(details.limit, LOCALE) : null;
+    return limit ? `El archivo supera el tama\xF1o m\xE1ximo (${limit}).` : "El archivo supera el tama\xF1o m\xE1ximo.";
+  },
+  content_type_not_allowed: "Este tipo de archivo no est\xE1 permitido.",
+  content_type_mismatch: "El contenido del archivo no coincide con su tipo.",
+  content_unverified: "No se pudo verificar la subida. Vuelve a intentarlo.",
+  unsupported_content_type: "Este tipo de archivo no es compatible.",
+  media_type_mismatch: "El tipo de archivo no coincide con el tipo de contenido esperado.",
+  already_exists: "Ya existe un archivo con este nombre.",
+  write_conflict: "El archivo cambi\xF3 mientras se guardaba. Vuelve a intentarlo.",
+  upload_not_found: "No se encontr\xF3 la subida o ya venci\xF3. Vuelve a empezarla.",
+  invalid_upload_key: "Esta subida no es v\xE1lida.",
+  invalid_path: "La ruta del archivo no es v\xE1lida.",
+  path_required: "Esta subida necesita una ruta de archivo.",
+  invalid_expires_in: "El tiempo de vencimiento no es v\xE1lido.",
+  invalid_file_expires_in: "El tiempo de vencimiento del archivo no es v\xE1lido.",
+  invalid_cache_control: "La configuraci\xF3n de cach\xE9 no es v\xE1lida.",
+  invalid_limits: "Los l\xEDmites de la subida no son v\xE1lidos.",
+  invalid_prefix: "La carpeta no es v\xE1lida.",
+  invalid_visibility: "La visibilidad debe ser p\xFAblica o privada.",
+  invalid_cursor: "La p\xE1gina de resultados no es v\xE1lida. Vuelve a cargar la lista.",
+  invalid_sha256: "La suma de verificaci\xF3n del archivo no es v\xE1lida.",
+  sha256_mismatch: "El archivo se da\xF1\xF3 durante la subida. Vuelve a intentarlo.",
+  max_files_reached: "Alcanzaste el n\xFAmero m\xE1ximo de archivos para esta subida.",
+  invalid_multipart: "La solicitud de subida no es v\xE1lida.",
+  invalid_size: "El tama\xF1o del archivo no es v\xE1lido.",
+  invalid_part: "Una parte de la subida no es v\xE1lida. Vuelve a intentarlo.",
+  invalid_parts: "La subida est\xE1 incompleta. Vuelve a intentarlo.",
+  part_size_mismatch: "Una parte de la subida tiene un tama\xF1o incorrecto. Vuelve a intentarlo.",
+  part_sha256_required: "A una parte de la subida le falta la suma de verificaci\xF3n.",
+  invalid_media_metadata: (details) => {
+    if (details.field === "title") return "El t\xEDtulo no puede tener m\xE1s de 200 caracteres.";
+    if (details.field === "alt") return "El texto alternativo no puede tener m\xE1s de 1000 caracteres.";
+    if (details.field === "tags") return "Usa como m\xE1ximo 20 etiquetas, de hasta 50 caracteres cada una.";
+    return "Los datos del archivo no son v\xE1lidos.";
+  },
+  expired: "Este archivo ya venci\xF3.",
+  invalid_key: "La referencia del archivo no es v\xE1lida.",
+  invalid_max_uses: "El n\xFAmero de usos no es v\xE1lido.",
+  link_exists: "Este enlace de descarga ya existe.",
+  link_not_found: "Este enlace de descarga no existe.",
+  link_expired: "Este enlace de descarga ya venci\xF3.",
+  link_used: "Este enlace de descarga ya se us\xF3.",
+  not_configured: "Esta funci\xF3n no est\xE1 configurada.",
+  retention_active: (details) => {
+    if (details.hold === true) return "Este archivo tiene una retenci\xF3n legal y no se puede modificar ni eliminar.";
+    const until = formatDate(details.until, LOCALE);
+    return until ? `Este archivo est\xE1 protegido hasta el ${until} y no se puede modificar ni eliminar antes de esa fecha.` : "Este archivo est\xE1 protegido y no se puede modificar ni eliminar.";
+  },
+  lock_conflict: "La protecci\xF3n del archivo cambi\xF3 mientras tanto. Vuelve a intentarlo.",
+  compliance_extend_only: "La protecci\xF3n de este archivo solo se puede extender.",
+  lock_privilege_required: "No tienes permiso para acortar ni quitar la protecci\xF3n de este archivo.",
+  lock_record_unreadable: "No se pudo leer la protecci\xF3n del archivo.",
+  lock_below_minimum: "Esta subida requiere una protecci\xF3n m\xE1s estricta.",
+  invalid_lock: "La configuraci\xF3n de protecci\xF3n no es v\xE1lida.",
+  invalid_hold: "La configuraci\xF3n de retenci\xF3n legal no es v\xE1lida.",
+  reserved_key: "Este nombre de archivo est\xE1 reservado.",
+  keys_bucket_missing: "En este momento no se pueden guardar archivos de forma segura.",
+  encryption_key_missing: "Este archivo ya no se puede leer. Vuelve a subirlo.",
+  unauthorized: "No tienes autorizaci\xF3n para hacer esto.",
+  session_mismatch: "Tu sesi\xF3n cambi\xF3. Vuelve a cargar la p\xE1gina.",
+  token_rejected: "Se deneg\xF3 el acceso.",
+  reserved_user_id: "Este identificador de usuario est\xE1 reservado.",
+  invalid_scopes: "Los permisos solicitados no son v\xE1lidos.",
+  user_mismatch: "Solo puedes ver y cambiar tu propio progreso.",
+  transcode_not_configured: "El procesamiento de video no est\xE1 configurado.",
+  transcode_runner_unavailable: "El procesamiento de video est\xE1 ocupado en este momento. Vuelve a intentarlo m\xE1s tarde.",
+  transcode_launch_failed: "No se pudo procesar el video.",
+  original_not_retained: "El video original ya no est\xE1 disponible, as\xED que no se puede volver a procesar. Vuelve a subirlo.",
+  locale_not_allowed: "Los subt\xEDtulos no est\xE1n disponibles en este idioma.",
+  captions_provider_rate_limited: "El servicio de subt\xEDtulos est\xE1 ocupado en este momento. Vuelve a intentarlo m\xE1s tarde.",
+  captions_provider_error: "No se pudieron generar los subt\xEDtulos.",
+  captions_failed: "No se pudieron generar los subt\xEDtulos.",
+  webhook_secret_missing: "El procesamiento de video no est\xE1 configurado.",
+  worker_auth_secret_missing: "El servicio de medios no est\xE1 configurado.",
+  worker_error: "El servicio de medios no pudo completar la solicitud.",
+  http_error: "No se pudo cargar el archivo.",
+  too_large: "El archivo es demasiado grande para la vista previa.",
+  unsupported_type: "Este tipo de archivo no tiene vista previa.",
+  type_mismatch: "El contenido del archivo no coincide con su tipo.",
+  token_unavailable: "No se pudo autorizar el acceso a este archivo. Vuelve a intentarlo.",
+  page_cap: (details) => {
+    const { shown, total } = details;
+    if (typeof shown !== "number" || typeof total !== "number") return "Solo se muestran las primeras p\xE1ginas.";
+    return `Solo se muestran las primeras ${shown.toLocaleString(LOCALE)} de ${total.toLocaleString(LOCALE)} p\xE1ginas.`;
+  },
+  render_failed: "No se pudo mostrar el archivo.",
+  capability_unavailable: "Esta aplicaci\xF3n no puede hacer eso aqu\xED."
+};
+var previewLabels = {
+  document: (title, pageCount) => `${title}, ${pagesText(pageCount)}`,
+  page: (page, pageCount) => `P\xE1gina ${page} de ${pageCount}`,
+  loading: "Cargando\u2026",
+  pageCap: (shown, total) => `Se muestran las primeras ${shown} de ${total} p\xE1ginas.`,
+  error: (code) => code === "page_cap" ? "Descarga el archivo para ver todas las p\xE1ginas." : labelText(devulturErrorLabels[code]),
+  thumbnail: (title) => title,
+  untitledPdf: "PDF",
+  untitledMedia: "Vista previa",
+  download: "Descargar"
+};
+function pagesText(pageCount) {
+  return pageCount === 1 ? "1 p\xE1gina" : `${pageCount.toLocaleString(LOCALE)} p\xE1ginas`;
+}
+var KIND_TEXT = {
+  image: "Imagen",
+  video: "Video",
+  pdf: "PDF",
+  audio: "Audio",
+  text: "Texto",
+  file: "Archivo"
+};
+var attachmentLabels = {
+  locale: LOCALE,
+  size: formatFileSize,
+  pages: pagesText,
+  duration: formatDuration,
+  kind: (kind) => KIND_TEXT[kind],
+  download: "Descargar",
+  open: "Abrir vista previa",
+  untitled: "Archivo sin t\xEDtulo"
+};
+var mediaLibraryLabels = {
+  search: "Buscar archivos",
+  searchPlaceholder: "Busca por t\xEDtulo o nombre de archivo",
+  typeFilter: "Tipo",
+  allTypes: "Todos los tipos",
+  types: { image: "Im\xE1genes", video: "Videos", file: "Archivos" },
+  results: "Archivos",
+  loading: "Cargando archivos\u2026",
+  empty: "Todav\xEDa no hay archivos.",
+  noResults: (search) => `Nada coincide con \xAB${search}\xBB.`,
+  loadMore: "Cargar m\xE1s",
+  loadingMore: "Cargando\u2026",
+  error: (error) => describeDevulturError(error, devulturErrorLabels) ?? "No se pudieron cargar los archivos.",
+  retry: "Reintentar",
+  size: (bytes) => formatFileSize(bytes, LOCALE)
+};
+var mediaPickerLabels = {
+  upload: (multiple) => multiple ? "Subir archivos" : "Subir un archivo",
+  dropHint: (multiple) => multiple ? "o suelta los archivos aqu\xED" : "o suelta un archivo aqu\xED",
+  uploads: "Subidas",
+  progress: (filename) => `Subiendo ${filename}`,
+  percent: (percent) => `${percent} %`,
+  uploading: (filename) => `Subiendo ${filename}.`,
+  uploaded: (filename) => `${filename} se subi\xF3 y qued\xF3 seleccionado.`,
+  cancel: "Cancelar",
+  cancelUpload: (filename) => `Cancelar la subida de ${filename}`,
+  cancelled: (filename) => `Se cancel\xF3 la subida de ${filename}.`,
+  notAccepted: (filename) => `${filename} no es un tipo de archivo que se pueda elegir aqu\xED.`,
+  uploadError: (error) => describeDevulturError(error, devulturErrorLabels) ?? "La subida fall\xF3. Vuelve a intentarlo.",
+  retry: "Reintentar",
+  dismiss: "Descartar",
+  selection: "Archivos seleccionados",
+  empty: "No hay nada seleccionado.",
+  remove: "Quitar",
+  removeItem: (name) => `Quitar ${name}`,
+  clear: "Limpiar",
+  replace: "Reemplazar",
+  selected: (name) => `${name} seleccionado.`,
+  removed: (name) => `${name} se quit\xF3.`,
+  cleared: "Se limpi\xF3 la selecci\xF3n."
+};
+
+export {
+  devulturErrorLabels,
+  previewLabels,
+  attachmentLabels,
+  mediaLibraryLabels,
+  mediaPickerLabels
+};

package/dist/{chunk-EX3W77VY.js → chunk-YYOZ3PDH.js}

@@ -81,6 +81,8 @@ var DEVULTUR_ERROR_CODES = [
   "unsupported_type",
   "type_mismatch",
   "token_unavailable",
+  "page_cap",
+  "render_failed",
   // `DevulturCapabilityError` (an action the provider wasn't given)
   "capability_unavailable"
 ];
@@ -104,6 +106,9 @@ function devulturErrorOf(error) {
 }
 
 // src/error-labels.ts
+function labelText(label, details = {}) {
+  return typeof label === "function" ? label(details) : label;
+}
 function formatBytes(bytes, locale) {
   const isMegabytes = bytes >= 1e6;
   const amount = isMegabytes ? bytes / 1e6 : bytes / 1e3;
@@ -202,6 +207,12 @@ var devulturErrorLabels = {
   unsupported_type: "This file type can't be previewed.",
   type_mismatch: "The file's content doesn't match its type.",
   token_unavailable: "Access to this file couldn't be granted. Try again.",
+  page_cap: (details) => {
+    const { shown, total } = details;
+    if (typeof shown !== "number" || typeof total !== "number") return "Only the first pages are shown.";
+    return `Only the first ${shown.toLocaleString("en")} of ${total.toLocaleString("en")} pages are shown.`;
+  },
+  render_failed: "The file couldn't be displayed.",
   capability_unavailable: "This app can't do that here."
 };
 function asRecord(value) {
@@ -211,7 +222,9 @@ function codedErrorOf(error) {
   if (!(error instanceof Error)) return null;
   const { code, status, details, limit } = error;
   const statusField = typeof status === "number" ? { status } : {};
-  if (error.name === "MediaFetchError" && typeof code === "string") return { code, details: statusField };
+  if (error.name === "MediaFetchError" && typeof code === "string") {
+    return { code, details: { ...asRecord(details), ...statusField } };
+  }
   if (error.name === "DevulturCapabilityError") return { code: "capability_unavailable", details: {} };
   if (error.name !== "DevulturApiError") return null;
   const limitField = typeof limit === "number" ? { limit } : {};
@@ -229,8 +242,7 @@ function describeDevulturError(error, labels) {
   const descriptor = descriptorOf(error);
   if (!descriptor) return null;
   const code = isDevulturErrorCode(descriptor.code) ? descriptor.code : "worker_error";
-  const label = labels?.[code] ?? devulturErrorLabels[code];
-  return typeof label === "function" ? label(descriptor.details) : label;
+  return labelText(labels?.[code] ?? devulturErrorLabels[code], descriptor.details);
 }
 
 export {
@@ -238,6 +250,7 @@ export {
   isDevulturErrorCode,
   isDevulturError,
   devulturErrorOf,
+  labelText,
   formatBytes,
   formatDate,
   devulturErrorLabels,

package/dist/{error-labels-BfqcFh2R.d.ts → error-labels-D0Vbp-qA.d.ts}

@@ -1,4 +1,4 @@
-declare const DEVULTUR_ERROR_CODES: readonly ["file_too_large", "content_type_not_allowed", "content_type_mismatch", "content_unverified", "unsupported_content_type", "media_type_mismatch", "already_exists", "write_conflict", "upload_not_found", "invalid_upload_key", "invalid_path", "path_required", "invalid_expires_in", "invalid_file_expires_in", "invalid_cache_control", "invalid_limits", "invalid_prefix", "invalid_visibility", "invalid_cursor", "invalid_sha256", "sha256_mismatch", "max_files_reached", "invalid_multipart", "invalid_size", "invalid_part", "invalid_parts", "part_size_mismatch", "part_sha256_required", "invalid_media_metadata", "expired", "invalid_key", "invalid_max_uses", "link_exists", "link_not_found", "link_expired", "link_used", "not_configured", "retention_active", "lock_conflict", "compliance_extend_only", "lock_privilege_required", "lock_record_unreadable", "lock_below_minimum", "invalid_lock", "invalid_hold", "reserved_key", "keys_bucket_missing", "encryption_key_missing", "unauthorized", "session_mismatch", "token_rejected", "reserved_user_id", "invalid_scopes", "user_mismatch", "transcode_not_configured", "transcode_runner_unavailable", "transcode_launch_failed", "original_not_retained", "locale_not_allowed", "captions_provider_rate_limited", "captions_provider_error", "captions_failed", "webhook_secret_missing", "worker_auth_secret_missing", "worker_error", "http_error", "too_large", "unsupported_type", "type_mismatch", "token_unavailable", "capability_unavailable"];
+declare const DEVULTUR_ERROR_CODES: readonly ["file_too_large", "content_type_not_allowed", "content_type_mismatch", "content_unverified", "unsupported_content_type", "media_type_mismatch", "already_exists", "write_conflict", "upload_not_found", "invalid_upload_key", "invalid_path", "path_required", "invalid_expires_in", "invalid_file_expires_in", "invalid_cache_control", "invalid_limits", "invalid_prefix", "invalid_visibility", "invalid_cursor", "invalid_sha256", "sha256_mismatch", "max_files_reached", "invalid_multipart", "invalid_size", "invalid_part", "invalid_parts", "part_size_mismatch", "part_sha256_required", "invalid_media_metadata", "expired", "invalid_key", "invalid_max_uses", "link_exists", "link_not_found", "link_expired", "link_used", "not_configured", "retention_active", "lock_conflict", "compliance_extend_only", "lock_privilege_required", "lock_record_unreadable", "lock_below_minimum", "invalid_lock", "invalid_hold", "reserved_key", "keys_bucket_missing", "encryption_key_missing", "unauthorized", "session_mismatch", "token_rejected", "reserved_user_id", "invalid_scopes", "user_mismatch", "transcode_not_configured", "transcode_runner_unavailable", "transcode_launch_failed", "original_not_retained", "locale_not_allowed", "captions_provider_rate_limited", "captions_provider_error", "captions_failed", "webhook_secret_missing", "worker_auth_secret_missing", "worker_error", "http_error", "too_large", "unsupported_type", "type_mismatch", "token_unavailable", "page_cap", "render_failed", "capability_unavailable"];
 /** A stable error code: match on it, not on `message`. */
 type DevulturErrorCode = (typeof DEVULTUR_ERROR_CODES)[number];
 declare function isDevulturErrorCode(code: unknown): code is DevulturErrorCode;

package/dist/index.d.ts

@@ -4,7 +4,7 @@ import { FunctionReference, FunctionVisibility, DefaultFunctionArgs, GenericQuer
 import { PropertyValidators, Value, ConvexError } from 'convex/values';
 import { D as DevulturComponentConfig, M as MediaRecord } from './types-LrusGVDf.js';
 export { P as ProgressRecord } from './types-LrusGVDf.js';
-export { a as DEVULTUR_ERROR_CODES, b as DevulturErrorCode, c as DevulturErrorDetails, d as DevulturErrorLabel, D as DevulturErrorLabels, e as describeDevulturError, f as devulturErrorLabels, i as isDevulturErrorCode } from './error-labels-BfqcFh2R.js';
+export { a as DEVULTUR_ERROR_CODES, b as DevulturErrorCode, c as DevulturErrorDetails, d as DevulturErrorLabel, D as DevulturErrorLabels, e as describeDevulturError, f as devulturErrorLabels, i as isDevulturErrorCode } from './error-labels-D0Vbp-qA.js';
 export { dv } from './validators.js';
 
 /**

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   devulturErrorOf,
   isDevulturError,
   isDevulturErrorCode
-} from "./chunk-EX3W77VY.js";
+} from "./chunk-YYOZ3PDH.js";
 
 // src/index.ts
 import {

package/dist/locales/es-formal.d.ts

@@ -0,0 +1,12 @@
+import { A as AttachmentLabels, M as MediaLibraryLabels, a as MediaPickerLabels, P as PreviewLabels } from '../preview-labels-B-2mra1h.js';
+import { D as DevulturErrorLabels } from '../error-labels-D0Vbp-qA.js';
+import '../types-LrusGVDf.js';
+import '@devultur/core';
+
+declare const devulturErrorLabels: DevulturErrorLabels;
+declare const attachmentLabels: AttachmentLabels;
+declare const previewLabels: PreviewLabels;
+declare const mediaLibraryLabels: MediaLibraryLabels;
+declare const mediaPickerLabels: MediaPickerLabels;
+
+export { attachmentLabels, devulturErrorLabels, mediaLibraryLabels, mediaPickerLabels, previewLabels };

package/dist/locales/es-formal.js

@@ -0,0 +1,64 @@
+import {
+  attachmentLabels,
+  devulturErrorLabels,
+  mediaLibraryLabels,
+  mediaPickerLabels,
+  previewLabels
+} from "../chunk-JZYKPLI4.js";
+import "../chunk-QBHIZBOQ.js";
+import {
+  describeDevulturError,
+  labelText
+} from "../chunk-YYOZ3PDH.js";
+
+// src/locales/es-formal.ts
+var TRY_AGAIN = "Vuelva a intentarlo.";
+var TRY_AGAIN_LATER = "Vuelva a intentarlo m\xE1s tarde.";
+var devulturErrorLabels2 = {
+  ...devulturErrorLabels,
+  content_unverified: `No se pudo verificar la subida. ${TRY_AGAIN}`,
+  write_conflict: `El archivo cambi\xF3 mientras se guardaba. ${TRY_AGAIN}`,
+  upload_not_found: "No se encontr\xF3 la subida o ya venci\xF3. Vuelva a empezarla.",
+  invalid_cursor: "La p\xE1gina de resultados no es v\xE1lida. Vuelva a cargar la lista.",
+  sha256_mismatch: `El archivo se da\xF1\xF3 durante la subida. ${TRY_AGAIN}`,
+  max_files_reached: "Alcanz\xF3 el n\xFAmero m\xE1ximo de archivos para esta subida.",
+  invalid_part: `Una parte de la subida no es v\xE1lida. ${TRY_AGAIN}`,
+  invalid_parts: `La subida est\xE1 incompleta. ${TRY_AGAIN}`,
+  part_size_mismatch: `Una parte de la subida tiene un tama\xF1o incorrecto. ${TRY_AGAIN}`,
+  invalid_media_metadata: (details) => {
+    if (details.field === "tags") return "Use como m\xE1ximo 20 etiquetas, de hasta 50 caracteres cada una.";
+    return labelText(devulturErrorLabels.invalid_media_metadata, details);
+  },
+  lock_conflict: `La protecci\xF3n del archivo cambi\xF3 mientras tanto. ${TRY_AGAIN}`,
+  lock_privilege_required: "No tiene permiso para acortar ni quitar la protecci\xF3n de este archivo.",
+  encryption_key_missing: "Este archivo ya no se puede leer. Vuelva a subirlo.",
+  unauthorized: "No tiene autorizaci\xF3n para hacer esto.",
+  session_mismatch: "Su sesi\xF3n cambi\xF3. Vuelva a cargar la p\xE1gina.",
+  user_mismatch: "Solo puede ver y cambiar su propio progreso.",
+  transcode_runner_unavailable: `El procesamiento de video est\xE1 ocupado en este momento. ${TRY_AGAIN_LATER}`,
+  original_not_retained: "El video original ya no est\xE1 disponible, as\xED que no se puede volver a procesar. Vuelva a subirlo.",
+  captions_provider_rate_limited: `El servicio de subt\xEDtulos est\xE1 ocupado en este momento. ${TRY_AGAIN_LATER}`,
+  token_unavailable: `No se pudo autorizar el acceso a este archivo. ${TRY_AGAIN}`
+};
+var attachmentLabels2 = attachmentLabels;
+var previewLabels2 = {
+  ...previewLabels,
+  error: (code) => code === "page_cap" ? "Descargue el archivo para ver todas las p\xE1ginas." : labelText(devulturErrorLabels2[code])
+};
+var mediaLibraryLabels2 = {
+  ...mediaLibraryLabels,
+  searchPlaceholder: "Busque por t\xEDtulo o nombre de archivo",
+  error: (error) => describeDevulturError(error, devulturErrorLabels2) ?? "No se pudieron cargar los archivos."
+};
+var mediaPickerLabels2 = {
+  ...mediaPickerLabels,
+  dropHint: (multiple) => multiple ? "o suelte los archivos aqu\xED" : "o suelte un archivo aqu\xED",
+  uploadError: (error) => describeDevulturError(error, devulturErrorLabels2) ?? `La subida fall\xF3. ${TRY_AGAIN}`
+};
+export {
+  attachmentLabels2 as attachmentLabels,
+  devulturErrorLabels2 as devulturErrorLabels,
+  mediaLibraryLabels2 as mediaLibraryLabels,
+  mediaPickerLabels2 as mediaPickerLabels,
+  previewLabels2 as previewLabels
+};

package/dist/locales/es.d.ts

@@ -1,11 +1,12 @@
-import { A as AttachmentLabels, M as MediaLibraryLabels, a as MediaPickerLabels } from '../media-picker-labels-CiVcNUZo.js';
-import { D as DevulturErrorLabels } from '../error-labels-BfqcFh2R.js';
+import { A as AttachmentLabels, M as MediaLibraryLabels, a as MediaPickerLabels, P as PreviewLabels } from '../preview-labels-B-2mra1h.js';
+import { D as DevulturErrorLabels } from '../error-labels-D0Vbp-qA.js';
 import '../types-LrusGVDf.js';
 import '@devultur/core';
 
 declare const devulturErrorLabels: DevulturErrorLabels;
+declare const previewLabels: PreviewLabels;
 declare const attachmentLabels: AttachmentLabels;
 declare const mediaLibraryLabels: MediaLibraryLabels;
 declare const mediaPickerLabels: MediaPickerLabels;
 
-export { attachmentLabels, devulturErrorLabels, mediaLibraryLabels, mediaPickerLabels };
+export { attachmentLabels, devulturErrorLabels, mediaLibraryLabels, mediaPickerLabels, previewLabels };

package/dist/locales/es.js

@@ -1,162 +1,16 @@
 import {
-  formatDuration,
-  formatFileSize
-} from "../chunk-QBHIZBOQ.js";
-import {
-  describeDevulturError,
-  formatBytes,
-  formatDate
-} from "../chunk-EX3W77VY.js";
-
-// src/locales/es.ts
-var LOCALE = "es";
-var devulturErrorLabels = {
-  file_too_large: (details) => {
-    const limit = typeof details.limit === "number" ? formatBytes(details.limit, LOCALE) : null;
-    return limit ? `El archivo supera el tama\xF1o m\xE1ximo (${limit}).` : "El archivo supera el tama\xF1o m\xE1ximo.";
-  },
-  content_type_not_allowed: "Este tipo de archivo no est\xE1 permitido.",
-  content_type_mismatch: "El contenido del archivo no coincide con su tipo.",
-  content_unverified: "No se pudo verificar la subida. Vuelve a intentarlo.",
-  unsupported_content_type: "Este tipo de archivo no es compatible.",
-  media_type_mismatch: "El tipo de archivo no coincide con el tipo de contenido esperado.",
-  already_exists: "Ya existe un archivo con este nombre.",
-  write_conflict: "El archivo cambi\xF3 mientras se guardaba. Vuelve a intentarlo.",
-  upload_not_found: "No se encontr\xF3 la subida o ya venci\xF3. Vuelve a empezarla.",
-  invalid_upload_key: "Esta subida no es v\xE1lida.",
-  invalid_path: "La ruta del archivo no es v\xE1lida.",
-  path_required: "Esta subida necesita una ruta de archivo.",
-  invalid_expires_in: "El tiempo de vencimiento no es v\xE1lido.",
-  invalid_file_expires_in: "El tiempo de vencimiento del archivo no es v\xE1lido.",
-  invalid_cache_control: "La configuraci\xF3n de cach\xE9 no es v\xE1lida.",
-  invalid_limits: "Los l\xEDmites de la subida no son v\xE1lidos.",
-  invalid_prefix: "La carpeta no es v\xE1lida.",
-  invalid_visibility: "La visibilidad debe ser p\xFAblica o privada.",
-  invalid_cursor: "La p\xE1gina de resultados no es v\xE1lida. Vuelve a cargar la lista.",
-  invalid_sha256: "La suma de verificaci\xF3n del archivo no es v\xE1lida.",
-  sha256_mismatch: "El archivo se da\xF1\xF3 durante la subida. Vuelve a intentarlo.",
-  max_files_reached: "Alcanzaste el n\xFAmero m\xE1ximo de archivos para esta subida.",
-  invalid_multipart: "La solicitud de subida no es v\xE1lida.",
-  invalid_size: "El tama\xF1o del archivo no es v\xE1lido.",
-  invalid_part: "Una parte de la subida no es v\xE1lida. Vuelve a intentarlo.",
-  invalid_parts: "La subida est\xE1 incompleta. Vuelve a intentarlo.",
-  part_size_mismatch: "Una parte de la subida tiene un tama\xF1o incorrecto. Vuelve a intentarlo.",
-  part_sha256_required: "A una parte de la subida le falta la suma de verificaci\xF3n.",
-  invalid_media_metadata: (details) => {
-    if (details.field === "title") return "El t\xEDtulo no puede tener m\xE1s de 200 caracteres.";
-    if (details.field === "alt") return "El texto alternativo no puede tener m\xE1s de 1000 caracteres.";
-    if (details.field === "tags") return "Usa como m\xE1ximo 20 etiquetas, de hasta 50 caracteres cada una.";
-    return "Los datos del archivo no son v\xE1lidos.";
-  },
-  expired: "Este archivo ya venci\xF3.",
-  invalid_key: "La referencia del archivo no es v\xE1lida.",
-  invalid_max_uses: "El n\xFAmero de usos no es v\xE1lido.",
-  link_exists: "Este enlace de descarga ya existe.",
-  link_not_found: "Este enlace de descarga no existe.",
-  link_expired: "Este enlace de descarga ya venci\xF3.",
-  link_used: "Este enlace de descarga ya se us\xF3.",
-  not_configured: "Esta funci\xF3n no est\xE1 configurada.",
-  retention_active: (details) => {
-    if (details.hold === true) return "Este archivo tiene una retenci\xF3n legal y no se puede modificar ni eliminar.";
-    const until = formatDate(details.until, LOCALE);
-    return until ? `Este archivo est\xE1 protegido hasta el ${until} y no se puede modificar ni eliminar antes de esa fecha.` : "Este archivo est\xE1 protegido y no se puede modificar ni eliminar.";
-  },
-  lock_conflict: "La protecci\xF3n del archivo cambi\xF3 mientras tanto. Vuelve a intentarlo.",
-  compliance_extend_only: "La protecci\xF3n de este archivo solo se puede extender.",
-  lock_privilege_required: "No tienes permiso para acortar ni quitar la protecci\xF3n de este archivo.",
-  lock_record_unreadable: "No se pudo leer la protecci\xF3n del archivo.",
-  lock_below_minimum: "Esta subida requiere una protecci\xF3n m\xE1s estricta.",
-  invalid_lock: "La configuraci\xF3n de protecci\xF3n no es v\xE1lida.",
-  invalid_hold: "La configuraci\xF3n de retenci\xF3n legal no es v\xE1lida.",
-  reserved_key: "Este nombre de archivo est\xE1 reservado.",
-  keys_bucket_missing: "En este momento no se pueden guardar archivos de forma segura.",
-  encryption_key_missing: "Este archivo ya no se puede leer. Vuelve a subirlo.",
-  unauthorized: "No tienes autorizaci\xF3n para hacer esto.",
-  session_mismatch: "Tu sesi\xF3n cambi\xF3. Vuelve a cargar la p\xE1gina.",
-  token_rejected: "Se deneg\xF3 el acceso.",
-  reserved_user_id: "Este identificador de usuario est\xE1 reservado.",
-  invalid_scopes: "Los permisos solicitados no son v\xE1lidos.",
-  user_mismatch: "Solo puedes ver y cambiar tu propio progreso.",
-  transcode_not_configured: "El procesamiento de video no est\xE1 configurado.",
-  transcode_runner_unavailable: "El procesamiento de video est\xE1 ocupado en este momento. Vuelve a intentarlo m\xE1s tarde.",
-  transcode_launch_failed: "No se pudo procesar el video.",
-  original_not_retained: "El video original ya no est\xE1 disponible, as\xED que no se puede volver a procesar. Vuelve a subirlo.",
-  locale_not_allowed: "Los subt\xEDtulos no est\xE1n disponibles en este idioma.",
-  captions_provider_rate_limited: "El servicio de subt\xEDtulos est\xE1 ocupado en este momento. Vuelve a intentarlo m\xE1s tarde.",
-  captions_provider_error: "No se pudieron generar los subt\xEDtulos.",
-  captions_failed: "No se pudieron generar los subt\xEDtulos.",
-  webhook_secret_missing: "El procesamiento de video no est\xE1 configurado.",
-  worker_auth_secret_missing: "El servicio de medios no est\xE1 configurado.",
-  worker_error: "El servicio de medios no pudo completar la solicitud.",
-  http_error: "No se pudo cargar el archivo.",
-  too_large: "El archivo es demasiado grande para la vista previa.",
-  unsupported_type: "Este tipo de archivo no tiene vista previa.",
-  type_mismatch: "El contenido del archivo no coincide con su tipo.",
-  token_unavailable: "No se pudo autorizar el acceso a este archivo. Vuelve a intentarlo.",
-  capability_unavailable: "Esta aplicaci\xF3n no puede hacer eso aqu\xED."
-};
-var KIND_TEXT = {
-  image: "Imagen",
-  video: "Video",
-  pdf: "PDF",
-  audio: "Audio",
-  text: "Texto",
-  file: "Archivo"
-};
-var attachmentLabels = {
-  locale: LOCALE,
-  size: formatFileSize,
-  pages: (pageCount) => pageCount === 1 ? "1 p\xE1gina" : `${pageCount.toLocaleString(LOCALE)} p\xE1ginas`,
-  duration: formatDuration,
-  kind: (kind) => KIND_TEXT[kind],
-  download: "Descargar",
-  open: "Abrir vista previa",
-  untitled: "Archivo sin t\xEDtulo"
-};
-var mediaLibraryLabels = {
-  search: "Buscar archivos",
-  searchPlaceholder: "Busca por t\xEDtulo o nombre de archivo",
-  typeFilter: "Tipo",
-  allTypes: "Todos los tipos",
-  types: { image: "Im\xE1genes", video: "Videos", file: "Archivos" },
-  results: "Archivos",
-  loading: "Cargando archivos\u2026",
-  empty: "Todav\xEDa no hay archivos.",
-  noResults: (search) => `Nada coincide con \xAB${search}\xBB.`,
-  loadMore: "Cargar m\xE1s",
-  loadingMore: "Cargando\u2026",
-  error: (error) => describeDevulturError(error, devulturErrorLabels) ?? "No se pudieron cargar los archivos.",
-  retry: "Reintentar",
-  size: (bytes) => formatFileSize(bytes, LOCALE)
-};
-var mediaPickerLabels = {
-  upload: (multiple) => multiple ? "Subir archivos" : "Subir un archivo",
-  dropHint: (multiple) => multiple ? "o suelta los archivos aqu\xED" : "o suelta un archivo aqu\xED",
-  uploads: "Subidas",
-  progress: (filename) => `Subiendo ${filename}`,
-  percent: (percent) => `${percent} %`,
-  uploading: (filename) => `Subiendo ${filename}.`,
-  uploaded: (filename) => `${filename} se subi\xF3 y qued\xF3 seleccionado.`,
-  cancel: "Cancelar",
-  cancelUpload: (filename) => `Cancelar la subida de ${filename}`,
-  cancelled: (filename) => `Se cancel\xF3 la subida de ${filename}.`,
-  notAccepted: (filename) => `${filename} no es un tipo de archivo que se pueda elegir aqu\xED.`,
-  uploadError: (error) => describeDevulturError(error, devulturErrorLabels) ?? "La subida fall\xF3. Vuelve a intentarlo.",
-  retry: "Reintentar",
-  dismiss: "Descartar",
-  selection: "Archivos seleccionados",
-  empty: "No hay nada seleccionado.",
-  remove: "Quitar",
-  removeItem: (name) => `Quitar ${name}`,
-  clear: "Limpiar",
-  replace: "Reemplazar",
-  selected: (name) => `${name} seleccionado.`,
-  removed: (name) => `${name} se quit\xF3.`,
-  cleared: "Se limpi\xF3 la selecci\xF3n."
-};
+  attachmentLabels,
+  devulturErrorLabels,
+  mediaLibraryLabels,
+  mediaPickerLabels,
+  previewLabels
+} from "../chunk-JZYKPLI4.js";
+import "../chunk-QBHIZBOQ.js";
+import "../chunk-YYOZ3PDH.js";
 export {
   attachmentLabels,
   devulturErrorLabels,
   mediaLibraryLabels,
-  mediaPickerLabels
+  mediaPickerLabels,
+  previewLabels
 };

package/dist/{media-picker-labels-CiVcNUZo.d.ts → preview-labels-B-2mra1h.d.ts}

@@ -111,4 +111,61 @@ interface MediaPickerLabels {
 }
 declare const defaultMediaPickerLabels: MediaPickerLabels;
 
-export { type AttachmentLabels as A, type MediaLibraryLabels as M, type MediaPickerLabels as a, type AttachmentKind as b, defaultMediaLibraryLabels as c, defaultAttachmentLabels as d, defaultMediaPickerLabels as e, formatDuration as f, formatFileSize as g };
+/** Why a media couldn't be fetched or shown. Stable: match on it, not on `message`. */
+type MediaFetchErrorCode = 
+/** The delivery answered with a non-2xx status (`status` has it), or never answered (a network failure: no `status`). */
+"http_error"
+/** `Content-Length`, or the streamed body, exceeds `maxBytes`. */
+ | "too_large"
+/** The expected content type isn't one that can be previewed inline. */
+ | "unsupported_type"
+/** The response's `Content-Type` doesn't agree with the expected one. */
+ | "type_mismatch"
+/** No viewer token for private media: its issuance failed (`useDevultur().tokenError` has why) or was refused. */
+ | "token_unavailable"
+/** The delivery refused the token for this browser session, also after a re-issue (video playback). */
+ | "session_mismatch"
+/** A PDF has more pages than `maxPages`: only the first ones are shown (`details: { shown, total }`). */
+ | "page_cap"
+/** The bytes arrived but couldn't be shown: pdf.js can't open the PDF, or the video can't be played. */
+ | "render_failed";
+/** `ErrorOptions` plus the code's `details`. */
+interface MediaFetchErrorOptions extends ErrorOptions {
+    details?: Readonly<Record<string, unknown>>;
+}
+declare class MediaFetchError extends Error {
+    readonly code: MediaFetchErrorCode;
+    /** HTTP status, for `http_error` when the delivery answered. */
+    readonly status?: number;
+    /** The code's extra fields, e.g. `page_cap`'s `{ shown, total }`. */
+    readonly details?: Readonly<Record<string, unknown>>;
+    constructor(code: MediaFetchErrorCode, message: string, status?: number, options?: MediaFetchErrorOptions);
+}
+
+/**
+ * Every string `<Preview>`, `<PdfThumbnail>` and their PDF pages show or announce. Pass any subset as `labels` on a
+ * component or on `PdfPreviewProvider`; the component's wins over the provider's, which wins over the English defaults.
+ */
+interface PreviewLabels {
+    /** Accessible name of a pdf.js document: its title and page count. */
+    document: (title: string, pageCount: number) => string;
+    /** Accessible name of one pdf.js page. */
+    page: (page: number, pageCount: number) => string;
+    /** Announced (visually hidden) while a preview loads, when no `loading` is passed. */
+    loading: string;
+    /** Note after the last rendered page when a PDF has more than `maxPages`; `fallback` follows it. */
+    pageCap: (shown: number, total: number) => string;
+    /** `title` of the default fallback's download link, for why it's shown (see `<Preview>`'s `fallback`). */
+    error: (code: MediaFetchErrorCode) => string;
+    /** Accessible name of a `<PdfThumbnail>`, from its title. */
+    thumbnail: (title: string) => string;
+    /** Name of a PDF (pdf.js document, `<iframe>` title, thumbnail) with no `title` and no filename. */
+    untitledPdf: string;
+    /** Name of an image or audio preview with no `title` and no filename. */
+    untitledMedia: string;
+    /** Text of the default fallback's download link when the media has no filename. */
+    download: string;
+}
+declare const defaultPreviewLabels: PreviewLabels;
+
+export { type AttachmentLabels as A, type MediaLibraryLabels as M, type PreviewLabels as P, type MediaPickerLabels as a, MediaFetchError as b, type AttachmentKind as c, type MediaFetchErrorCode as d, defaultAttachmentLabels as e, defaultMediaLibraryLabels as f, defaultMediaPickerLabels as g, defaultPreviewLabels as h, formatDuration as i, formatFileSize as j };

package/dist/react.d.ts

@@ -3,34 +3,13 @@ import { DevulturMedia, MediaUrlOptions, Visibility, ProcessingPhase, FailureRea
 import { BakeOutputFormat, MediaUploadState, MediaUploadError, UploadProgress } from '@devultur/react';
 export { MediaUploadError, MediaUploadState, UploadProgress } from '@devultur/react';
 import { FunctionReference } from 'convex/server';
+import { A as AttachmentLabels, M as MediaLibraryLabels, P as PreviewLabels, a as MediaPickerLabels, b as MediaFetchError } from './preview-labels-B-2mra1h.js';
+export { c as AttachmentKind, d as MediaFetchErrorCode, e as defaultAttachmentLabels, f as defaultMediaLibraryLabels, g as defaultMediaPickerLabels, h as defaultPreviewLabels, i as formatDuration, j as formatFileSize } from './preview-labels-B-2mra1h.js';
 import { Value } from 'convex/values';
-import { A as AttachmentLabels, M as MediaLibraryLabels, a as MediaPickerLabels } from './media-picker-labels-CiVcNUZo.js';
-export { b as AttachmentKind, d as defaultAttachmentLabels, c as defaultMediaLibraryLabels, e as defaultMediaPickerLabels, f as formatDuration, g as formatFileSize } from './media-picker-labels-CiVcNUZo.js';
 import { M as MediaRecord } from './types-LrusGVDf.js';
 import { P as PdfjsLoader } from './pdf-render-BwJGagvz.js';
 export { a as PdfjsModule } from './pdf-render-BwJGagvz.js';
 
-/** Why a media fetch was refused. Stable: match on it, not on `message`. */
-type MediaFetchErrorCode = 
-/** The delivery answered with a non-2xx status (`status` has it). */
-"http_error"
-/** `Content-Length`, or the streamed body, exceeds `maxBytes`. */
- | "too_large"
-/** The expected content type isn't one that can be previewed inline. */
- | "unsupported_type"
-/** The response's `Content-Type` doesn't agree with the expected one. */
- | "type_mismatch"
-/** No viewer token for private media: its issuance failed (`useDevultur().tokenError` has why) or was refused. */
- | "token_unavailable"
-/** The delivery refused the token for this browser session, also after a re-issue (video playback). */
- | "session_mismatch";
-declare class MediaFetchError extends Error {
-    readonly code: MediaFetchErrorCode;
-    /** HTTP status, for `http_error`. */
-    readonly status?: number;
-    constructor(code: MediaFetchErrorCode, message: string, status?: number, options?: ErrorOptions);
-}
-
 /** What a viewer token action returns: the token with its lifetime, or the bare token (default lifetime). */
 type ViewerTokenResult = {
     token: string;
@@ -311,32 +290,6 @@ interface MediaObjectUrl {
  */
 declare function useMediaObjectUrl(media: DevulturMedia | null | undefined, options?: UseMediaObjectUrlOptions): MediaObjectUrl;
 
-/**
- * Every string `<Preview>`, `<PdfThumbnail>` and their PDF pages show or announce. Pass any subset as `labels` on a
- * component or on `PdfPreviewProvider`; the component's wins over the provider's, which wins over the English defaults.
- */
-interface PreviewLabels {
-    /** Accessible name of a pdf.js document: its title and page count. */
-    document: (title: string, pageCount: number) => string;
-    /** Accessible name of one pdf.js page. */
-    page: (page: number, pageCount: number) => string;
-    /** Announced (visually hidden) while a preview loads, when no `loading` is passed. */
-    loading: string;
-    /** Note after the last rendered page when a PDF has more than `maxPages`; `fallback` follows it. */
-    pageCap: (shown: number, total: number) => string;
-    /** `title` of the default fallback's download link when a fetch was refused or the type can't be previewed. */
-    error: (code: MediaFetchErrorCode) => string;
-    /** Accessible name of a `<PdfThumbnail>`, from its title. */
-    thumbnail: (title: string) => string;
-    /** Name of a PDF (pdf.js document, `<iframe>` title, thumbnail) with no `title` and no filename. */
-    untitledPdf: string;
-    /** Name of an image or audio preview with no `title` and no filename. */
-    untitledMedia: string;
-    /** Text of the default fallback's download link when the media has no filename. */
-    download: string;
-}
-declare const defaultPreviewLabels: PreviewLabels;
-
 interface PdfPreviewConfig {
     /**
      * Imports pdf.js. Without it, PDFs render in an `<iframe>` (the browser's own viewer) and `<PdfThumbnail>` renders
@@ -547,13 +500,15 @@ interface PreviewProps {
     /** Size cap for text previews. Default 1 MiB. */
     maxTextBytes?: number;
     /**
-     * Shown for types that don't preview inline and when the fetch fails. Default: a `<DownloadLink>`.
-     * As a function it receives why: a `MediaFetchError` when the fetch was refused (`http_error`, `too_large`,
-     * `type_mismatch`), the viewer token couldn't be issued (`token_unavailable`, nothing fetched), a video's session
-     * was refused (`session_mismatch`) or the type doesn't preview inline (`unsupported_type`), `null` otherwise
-     * (a network failure, a PDF pdf.js can't open, or the link after the `maxPages` note).
+     * Shown for types that don't preview inline, when the fetch or render fails, and after the `maxPages` note.
+     * Default: a `<DownloadLink>`. As a function it receives why, always a `MediaFetchError` (never `null`: it's only
+     * called with a cause): `http_error` when the delivery refused the fetch (`status`) or never answered (a network
+     * failure, no `status`), `too_large`, `type_mismatch`, `token_unavailable` (no viewer token, nothing fetched),
+     * `session_mismatch` (a video's session was refused), `unsupported_type` (the type doesn't preview inline, nothing
+     * fetched), `render_failed` (pdf.js can't open the PDF, or the video can't be played) or `page_cap` (the link after
+     * the `maxPages` note, with `details: { shown, total }`).
      */
-    fallback?: React.ReactNode | ((error: MediaFetchError | null) => React.ReactNode);
+    fallback?: React.ReactNode | ((error: MediaFetchError) => React.ReactNode);
     /** Shown while a file loads. Default: `labels.loading`, visually hidden, in a `role="status"`. `null` → nothing. */
     loading?: React.ReactNode;
     /** Accessible name of the preview (`alt`, `title`, `aria-label`). Default: the filename (text: none). */
@@ -869,4 +824,4 @@ interface UseMediaUploadReturn {
  */
 declare function useMediaUpload(options?: UseMediaUploadOptions): UseMediaUploadReturn;
 
-export { AttachmentCard, type AttachmentCardProps, AttachmentLabels, type CaptionTrack, CropUpload, type CropUploadLabels, type CropUploadProps, type CropUploadRenderProps, type DevulturApi, type DevulturCapability, DevulturCapabilityError, DevulturProvider, DevulturViewerProvider, DocumentLink, type DocumentLinkProps, DownloadLink, Image, type ImageProps, MediaFetchError, type MediaFetchErrorCode, MediaLibrary, type MediaLibraryItemState, MediaLibraryLabels, type MediaLibraryPart, type MediaLibraryProps, type MediaLibraryState, type MediaLibraryStatus, type MediaObjectUrl, MediaPicker, MediaPickerLabels, type MediaPickerLibraryProps, type MediaPickerProps, type MediaPickerSelectionProps, type MediaPickerState, type MediaPickerUpload$1 as MediaPickerUpload, type MediaPickerUploadProps, type MediaPickerUploads, type PdfPreviewConfig, PdfPreviewProvider, PdfThumbnail, type PdfThumbnailProps, PdfjsLoader, Preview, type PreviewKind, type PreviewLabels, type PreviewProps, type TokenStatus, type UploadedMedia, type UseMediaLibraryOptions, type UseMediaObjectUrlOptions, type UseMediaUploadOptions, type UseMediaUploadReturn, type VideoProps, type VideoState, type ViewerTokenArgs, type ViewerTokenResult, defaultPreviewLabels, matchesAccept, useDevultur, useDevulturApi, useDevulturMedia, useDevulturProgress, useMediaLibrary, useMediaObjectUrl, useMediaPicker, useMediaUpload, useMediaUrl, useVideoProps, useVideoState };
+export { AttachmentCard, type AttachmentCardProps, AttachmentLabels, type CaptionTrack, CropUpload, type CropUploadLabels, type CropUploadProps, type CropUploadRenderProps, type DevulturApi, type DevulturCapability, DevulturCapabilityError, DevulturProvider, DevulturViewerProvider, DocumentLink, type DocumentLinkProps, DownloadLink, Image, type ImageProps, MediaFetchError, MediaLibrary, type MediaLibraryItemState, MediaLibraryLabels, type MediaLibraryPart, type MediaLibraryProps, type MediaLibraryState, type MediaLibraryStatus, type MediaObjectUrl, MediaPicker, MediaPickerLabels, type MediaPickerLibraryProps, type MediaPickerProps, type MediaPickerSelectionProps, type MediaPickerState, type MediaPickerUpload$1 as MediaPickerUpload, type MediaPickerUploadProps, type MediaPickerUploads, type PdfPreviewConfig, PdfPreviewProvider, PdfThumbnail, type PdfThumbnailProps, PdfjsLoader, Preview, type PreviewKind, PreviewLabels, type PreviewProps, type TokenStatus, type UploadedMedia, type UseMediaLibraryOptions, type UseMediaObjectUrlOptions, type UseMediaUploadOptions, type UseMediaUploadReturn, type VideoProps, type VideoState, type ViewerTokenArgs, type ViewerTokenResult, matchesAccept, useDevultur, useDevulturApi, useDevulturMedia, useDevulturProgress, useMediaLibrary, useMediaObjectUrl, useMediaPicker, useMediaUpload, useMediaUrl, useVideoProps, useVideoState };

package/dist/react.js

@@ -23,7 +23,7 @@ import {
 } from "./chunk-QBHIZBOQ.js";
 import {
   describeDevulturError
-} from "./chunk-EX3W77VY.js";
+} from "./chunk-YYOZ3PDH.js";
 
 // src/react.tsx
 import React22 from "react";
@@ -71,15 +71,28 @@ async function isSessionMismatch(response) {
 // src/media-fetch.ts
 var MediaFetchError = class extends Error {
   code;
-  /** HTTP status, for `http_error`. */
+  /** HTTP status, for `http_error` when the delivery answered. */
   status;
+  /** The code's extra fields, e.g. `page_cap`'s `{ shown, total }`. */
+  details;
   constructor(code, message, status, options) {
     super(message, options);
     this.name = "MediaFetchError";
     this.code = code;
     this.status = status;
+    this.details = options?.details;
   }
 };
+function networkError(cause) {
+  return new MediaFetchError("http_error", "Media fetch failed: no response", void 0, { cause });
+}
+function pageCapError(shown, total) {
+  const message = `Showing the first ${shown} of ${total} pages`;
+  return new MediaFetchError("page_cap", message, void 0, { details: { shown, total } });
+}
+function renderFailedError(cause) {
+  return new MediaFetchError("render_failed", "The media couldn't be rendered", void 0, { cause });
+}
 function tokenUnavailableError(cause) {
   return new MediaFetchError("token_unavailable", "No viewer token: its issuance failed", void 0, { cause });
 }
@@ -753,7 +766,9 @@ var ERROR_TEXT = {
   unsupported_type: "This file type can't be previewed.",
   type_mismatch: "The file's content doesn't match its type.",
   token_unavailable: "Access to this file couldn't be granted. Try again.",
-  session_mismatch: "Your session changed. Reload the page."
+  session_mismatch: "Your session changed. Reload the page.",
+  page_cap: "Download the file to see every page.",
+  render_failed: "The file couldn't be displayed."
 };
 var defaultPreviewLabels = {
   document: (title, pageCount) => `${title}, ${pageCount === 1 ? "1 page" : `${pageCount} pages`}`,
@@ -961,7 +976,7 @@ function PdfCanvasDocument(props) {
   React9.useLayoutEffect(() => {
     if (document2) setWidth(containerRef.current?.clientWidth ?? 0);
   }, [document2]);
-  if (error) return /* @__PURE__ */ jsx6(Fragment2, { children: renderFallback(error) });
+  if (error) return /* @__PURE__ */ jsx6(Fragment2, { children: renderFallback(renderFailedError(error)) });
   if (!document2) return /* @__PURE__ */ jsx6(Fragment2, { children: loading });
   const shownPageCount = Math.min(document2.numPages, Math.max(1, maxPages));
   const isTruncated = shownPageCount < document2.numPages;
@@ -987,7 +1002,7 @@ function PdfCanvasDocument(props) {
         isTruncated && /* @__PURE__ */ jsxs3("p", { children: [
           labels.pageCap(shownPageCount, document2.numPages),
           " ",
-          renderFallback(null)
+          renderFallback(pageCapError(shownPageCount, document2.numPages))
         ] })
       ]
     }
@@ -1591,13 +1606,15 @@ import React17 from "react";
 import { VideoPlayer } from "@devultur/react";
 import { Fragment as Fragment6, jsx as jsx11 } from "react/jsx-runtime";
 var UNAUTHORIZED = 401;
+var HLS_NETWORK_FAILURE = /Load(Error|TimeOut)$/;
 function fetchErrorOf(error) {
   if (error.status === UNAUTHORIZED && error.code === "session_mismatch") {
     return new MediaFetchError("session_mismatch", "The delivery refused this session's token", UNAUTHORIZED);
   }
   if (error.status === UNAUTHORIZED) return tokenUnavailableError();
   if (error.status) return new MediaFetchError("http_error", `Video fetch failed: ${error.status}`, error.status);
-  return null;
+  if (HLS_NETWORK_FAILURE.test(error.details)) return networkError(error);
+  return renderFailedError(error);
 }
 function VideoPreview({ media, renderFallback, className }) {
   const { tokenStatus, tokenError, reissueToken } = useDevultur();
@@ -1633,7 +1650,7 @@ function Preview({ media, contentType, fallback, loading, labels, ...viewProps }
   const text = usePreviewLabels(labels);
   if (!media) return null;
   const renderFallback = (error) => {
-    const fetchError = error instanceof MediaFetchError ? error : null;
+    const fetchError = error instanceof MediaFetchError ? error : networkError(error);
     if (typeof fallback === "function") return fallback(fetchError);
     if (fallback !== void 0) return fallback;
     return /* @__PURE__ */ jsx12(DefaultFallback, { media, error: fetchError, labels: text });
@@ -1660,7 +1677,7 @@ function Preview({ media, contentType, fallback, loading, labels, ...viewProps }
 }
 var unsupportedType = (contentType) => new MediaFetchError("unsupported_type", `Can't preview ${contentType ?? "an unknown type"} inline`);
 function DefaultFallback({ media, error, labels }) {
-  return /* @__PURE__ */ jsx12(DownloadLink, { media, title: error ? labels.error(error.code) : void 0, children: media.filename ?? labels.download });
+  return /* @__PURE__ */ jsx12(DownloadLink, { media, title: labels.error(error.code), children: media.filename ?? labels.download });
 }
 function LoadingStatus({ text }) {
   return /* @__PURE__ */ jsx12("span", { role: "status", style: VISUALLY_HIDDEN, children: text });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devultur/convex",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Convex component for Devultur media: media records, uploads, transcodes, watch progress and React bindings",
   "keywords": [
     "convex",
@@ -49,6 +49,10 @@
     "./locales/es": {
       "import": "./dist/locales/es.js",
       "types": "./dist/locales/es.d.ts"
+    },
+    "./locales/es-formal": {
+      "import": "./dist/locales/es-formal.js",
+      "types": "./dist/locales/es-formal.d.ts"
     }
   },
   "bin": {
@@ -59,8 +63,8 @@
     "dist"
   ],
   "dependencies": {
-    "@devultur/core": "1.4.0",
-    "@devultur/react": "1.4.0"
+    "@devultur/core": "1.4.2",
+    "@devultur/react": "1.4.2"
   },
   "peerDependencies": {
     "convex": ">=1.25.0",
@@ -92,7 +96,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup src/index.ts src/validators.ts src/react.tsx src/pdfjs.ts src/locales/es.ts src/bin/init.ts --format esm --dts && tsc -p src/component/tsconfig.json",
+    "build": "tsup src/index.ts src/validators.ts src/react.tsx src/pdfjs.ts src/locales/es.ts src/locales/es-formal.ts src/bin/init.ts --format esm --dts && tsc -p src/component/tsconfig.json",
     "codegen": "node scripts/codegen.ts",
     "dev": "tsup src/index.ts src/react.tsx --format esm --dts --watch",
     "typecheck": "tsc --noEmit"