@devultur/convex 1.4.1 → 1.4.3

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-B7HNa7Va.d.ts}

@@ -1,4 +1,4 @@
-import { M as MediaRecord } from './types-LrusGVDf.js';
+import { M as MediaRecord } from './types-DZxN6Eij.js';
 
 /** What an attachment is, for its icon and type label. */
 type AttachmentKind = "image" | "video" | "pdf" | "audio" | "text" | "file";
@@ -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-B7HNa7Va.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-B7HNa7Va.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 { M as MediaRecord } from './types-DZxN6Eij.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;
@@ -46,8 +25,12 @@ type TokenStatus = "idle" | "loading" | "ready" | "error";
 
 /** Transform/delivery options for media URLs (without `token`, which the context injects). */
 type MediaRenderOptions = Omit<MediaUrlOptions, "token">;
+/**
+ * The viewer token action: the component's `issueViewerToken` (as `defineDevulturFunctions` or `exposeApi` export it,
+ * where `sessionSecret` is optional) or an app's own, which may require it. The providers always send it.
+ */
 type ViewerTokenAction = FunctionReference<"action", "public", {
-    sessionSecret: string;
+    sessionSecret?: string;
 }>;
 interface MediaSession {
     token: string | null;
@@ -311,32 +294,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
@@ -489,12 +446,13 @@ type MediaPickerProps = CommonProps & (SingleValueProps | MultipleValueProps);
  * @example
  * <MediaPicker accept={["image/*"]} value={cover} onChange={setCover} />
  */
-declare function MediaPicker(props: MediaPickerProps): React.JSX.Element;
-declare namespace MediaPicker {
-    var Upload: typeof MediaPickerUpload;
-    var Library: typeof MediaPickerLibrary;
-    var Selection: typeof MediaPickerSelection;
-}
+declare function MediaPickerRoot(props: MediaPickerProps): React.JSX.Element;
+declare const MediaPicker: typeof MediaPickerRoot & {
+    displayName: string;
+    Upload: typeof MediaPickerUpload;
+    Library: typeof MediaPickerLibrary;
+    Selection: typeof MediaPickerSelection;
+};
 
 /** A file's name and type, or a record's filename and content type. */
 interface Candidate {
@@ -547,13 +505,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 +829,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`}`,
@@ -778,7 +793,7 @@ function mergePreviewLabels(...sources) {
 
 // src/pdf-context.tsx
 import { jsx as jsx5 } from "react/jsx-runtime";
-var PdfPreviewContext = React7.createContext({});
+var PdfPreviewContext = /* @__PURE__ */ React7.createContext({});
 function PdfPreviewProvider({
   pdfjs,
   workerSrc,
@@ -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))
         ] })
       ]
     }
@@ -1511,7 +1526,7 @@ function recordMatchesAccept(record, accept) {
 
 // src/media-picker-context.ts
 import React15 from "react";
-var MediaPickerContext = React15.createContext(null);
+var MediaPickerContext = /* @__PURE__ */ React15.createContext(null);
 function useMediaPicker() {
   const picker = React15.use(MediaPickerContext);
   if (!picker) throw new Error("useMediaPicker must be used within <MediaPicker>");
@@ -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 });
@@ -1952,7 +1969,7 @@ function emit(props, next) {
   props.onChange(next[0] ?? null);
 }
 var isSame = (a, b) => a.id === b.id;
-function MediaPicker(props) {
+function MediaPickerRoot(props) {
   const isMultiple = props.multiple ?? false;
   const labels = React21.useMemo(() => mergeMediaPickerLabels(props.labels), [props.labels]);
   const accept = uploadAcceptOf(props.accept, props.type);
@@ -2072,15 +2089,18 @@ function MediaPicker(props) {
     /* @__PURE__ */ jsx15("div", { role: "status", "aria-live": "polite", style: VISUALLY_HIDDEN, children: announcement })
   ] }) });
 }
-MediaPicker.Upload = MediaPickerUpload;
-MediaPicker.Library = MediaPickerLibrary;
-MediaPicker.Selection = MediaPickerSelection;
+var MediaPicker = /* @__PURE__ */ Object.assign(MediaPickerRoot, {
+  displayName: "MediaPicker",
+  Upload: MediaPickerUpload,
+  Library: MediaPickerLibrary,
+  Selection: MediaPickerSelection
+});
 
 // src/react.tsx
 import { jsx as jsx16 } from "react/jsx-runtime";
-var DevulturContext = React22.createContext(null);
-var DevulturApiContext = React22.createContext(null);
-var ProgressContext = React22.createContext(null);
+var DevulturContext = /* @__PURE__ */ React22.createContext(null);
+var DevulturApiContext = /* @__PURE__ */ React22.createContext(null);
+var ProgressContext = /* @__PURE__ */ React22.createContext(null);
 function DevulturProvider({ api, baseUrl, tokenArgs, issueViewerToken, children }) {
   const session = useMediaSession({ issueViewerToken: issueViewerToken ?? api.issueViewerToken, tokenArgs, baseUrl });
   const createUploadUrlAction = useAction2(api.createUploadUrl);