contentoh-components-library 21.6.50 → 21.6.52

package/src/global-files/digital-assets/assetTypes.js

@@ -1,419 +0,0 @@
-/**
- * Catálogo de activos digitales.
- *
- * Este archivo es la ÚNICA fuente de verdad de qué se puede subir a la bandeja
- * y con qué límites. Ajustar un tipo o un tope es cambiar un dato aquí, no
- * tocar lógica repartida por la pantalla.
- *
- * Un activo NO es un "tipo de toma". Las imágenes de producto se validan contra
- * `image_manager` (orden, obligatoriedad, cupo por cadena); los activos no
- * entran a ese cruce y por eso tienen su propio catálogo.
- *
- * DOS COSAS QUE PARECEN DETALLE Y NO LO SON:
- *
- * 1. El tipo se decide por EXTENSIÓN, no por mime. El navegador no sabe qué es
- *    un .psd, un .ai o un .indd: reporta `application/octet-stream`, cadena
- *    vacía, o —peor— `application/pdf` para un .ai. Validar por mime dejaría
- *    fuera justo los formatos editables que se pidieron.
- * 2. Por lo mismo, el `accept` del dropzone se arma con extensiones además de
- *    mimes. Si solo llevara mimes, react-dropzone descartaría esos archivos
- *    antes de que nuestra validación llegue a verlos, y el usuario no vería
- *    ningún mensaje: simplemente no pasaría nada al soltarlos.
- */
-
-const KB = 1024;
-const MB = 1024 * KB;
-
-/**
- * Cómo se pinta un archivo en pantalla. No es lo mismo que el tipo de activo:
- * un 360 puede ser mp4 (se reproduce) o gif (se muestra), así que la forma de
- * previsualizar se resuelve por el archivo real, no por su categoría.
- */
-export const ASSET_PREVIEW = {
-  VIDEO: "video",
-  IMAGE: "image",
-  ICON: "icon",
-};
-
-/**
- * PROVISIONAL: cantidad máxima de activos por producto. Es el único dato que
- * el manager no respondió. Subido de 10 a 20 porque la lista de tipos creció
- * (documentos y editables, no solo multimedia).
- */
-export const MAX_ASSETS_PER_PRODUCT = 20;
-
-/**
- * Duración válida de un video.
- *
- * Hoy la ficha valida `duracion <= 10 || duracion >= 600` mientras el mensaje al
- * usuario dice "entre 15 segundos y 10 minutos". Los dos no pueden ser ciertos.
- * Se conserva el rango que el código valida de verdad, y el mensaje se genera
- * desde estos mismos números para que no se vuelvan a desincronizar.
- */
-export const VIDEO_DURATION_SECONDS = {
-  min: 10,
-  max: 600,
-};
-
-export const ASSET_TYPES = {
-  360: {
-    id: "360",
-    label: "360",
-    description: "Giro del producto, en mp4 o gif animado",
-    mimes: ["video/mp4", "image/gif"],
-    extensions: ["mp4", "gif"],
-    maxBytes: 200 * MB,
-    validatesDuration: true,
-  },
-  video: {
-    id: "video",
-    label: "Video",
-    description: "Video de producto o promocional",
-    mimes: ["video/mp4", "video/quicktime", "video/webm"],
-    extensions: ["mp4", "mov", "webm"],
-    maxBytes: 200 * MB,
-    validatesDuration: true,
-  },
-  gif: {
-    id: "gif",
-    label: "GIF",
-    description: "Animación corta",
-    mimes: ["image/gif"],
-    extensions: ["gif"],
-    maxBytes: 20 * MB,
-    validatesDuration: false,
-  },
-  documento: {
-    id: "documento",
-    label: "Documento",
-    description: "Manual, ficha técnica, certificado",
-    mimes: [
-      "application/pdf",
-      "application/msword",
-      "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
-    ],
-    extensions: ["pdf", "doc", "docx"],
-    maxBytes: 50 * MB,
-    validatesDuration: false,
-  },
-  hoja_calculo: {
-    id: "hoja_calculo",
-    label: "Hoja de cálculo",
-    description: "Listas de medidas, tablas de tallas, matrices",
-    mimes: [
-      "application/vnd.ms-excel",
-      "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-      "text/csv",
-    ],
-    extensions: ["xlsx", "xls", "csv"],
-    maxBytes: 20 * MB,
-    validatesDuration: false,
-  },
-  /*
-    Archivos de diseño editables. Es la categoría con más riesgo: un .psd con
-    capas o un .aep pasan sin esfuerzo de 1 GB, y ninguno se puede previsualizar
-    en el navegador —se muestran con icono y nombre—. El tope de aquí abajo es
-    una propuesta, no un dato confirmado.
-  */
-  editable: {
-    id: "editable",
-    label: "Editable",
-    description: "Archivo de diseño con capas (Photoshop, Illustrator, InDesign…)",
-    mimes: [],
-    extensions: [
-      "psd", "psb", // Photoshop
-      "ai", "eps", // Illustrator
-      "indd", "idml", // InDesign
-      "aep", // After Effects
-      "prproj", // Premiere
-      "sketch", "fig", "xd", // Sketch, Figma, Adobe XD
-      "afphoto", "afdesign", // Affinity
-      "svg",
-    ],
-    maxBytes: 500 * MB,
-    validatesDuration: false,
-  },
-  comprimido: {
-    id: "comprimido",
-    label: "Comprimido",
-    description: "Paquete de varios archivos en un solo zip",
-    mimes: ["application/zip", "application/x-rar-compressed", "application/x-7z-compressed"],
-    extensions: ["zip", "rar", "7z"],
-    maxBytes: 500 * MB,
-    validatesDuration: false,
-  },
-  otro: {
-    id: "otro",
-    label: "Otro",
-    description: "Formato no reconocido",
-    mimes: [],
-    extensions: [],
-    maxBytes: 50 * MB,
-    validatesDuration: false,
-  },
-};
-
-/** Orden en que se muestran en el selector de tipo. */
-export const ASSET_TYPE_ORDER = [
-  "360",
-  "video",
-  "gif",
-  "documento",
-  "hoja_calculo",
-  "editable",
-  "comprimido",
-  "otro",
-];
-
-/** Opciones listas para el componente `Select` (espera `{ value, name }`). */
-export const assetTypeOptions = () =>
-  ASSET_TYPE_ORDER.map((id) => ({
-    value: id,
-    name: ASSET_TYPES[id].label,
-  }));
-
-/** Extensiones que el navegador pinta como imagen. */
-export const IMAGE_EXTENSIONS = [
-  "jpg",
-  "jpeg",
-  "png",
-  "webp",
-  "gif",
-  "bmp",
-  "avif",
-  "svg",
-  "tiff",
-];
-
-/**
- * Formatos de video que un navegador REPRODUCE de verdad.
- *
- * No es lo mismo que "es un video". Un .mov se sube bien y S3 lo sirve como
- * video/quicktime, pero Chrome y Firefox no lo reproducen: una grabación de
- * pantalla de macOS viene en HEVC o ProRes, que no saben decodificar. Tratarlo
- * como reproducible pinta un recuadro negro sin explicación; mostrarlo como
- * archivo dice la verdad y deja claro lo que sí se puede hacer: descargarlo.
- */
-export const PLAYABLE_VIDEO_EXTENSIONS = ["mp4", "webm", "ogv", "ogg"];
-
-/**
- * Cómo pintar un archivo: manda la extensión y el mime queda de respaldo.
- *
- * La extensión manda porque el mime miente en las dos direcciones: un .psd
- * llega sin él, y un .mov llega con uno que empieza por `video/` aunque el
- * navegador no sepa reproducirlo.
- *
- * NUNCA por la URL. `ProductImage` lo hacía con `/\.mp4$/` y por eso fallaba:
- * la URL guardada apunta al redimensionador de CloudFront y no conserva la
- * extensión del archivo, así que un video jamás daba positivo.
- */
-export const resolvePreviewKind = ({ mime, ext, name } = {}) => {
-  const extension = (ext || getExtension(name) || "").toLowerCase();
-
-  if (extension) {
-    if (PLAYABLE_VIDEO_EXTENSIONS.includes(extension)) return ASSET_PREVIEW.VIDEO;
-    if (IMAGE_EXTENSIONS.includes(extension)) return ASSET_PREVIEW.IMAGE;
-    return ASSET_PREVIEW.ICON;
-  }
-
-  if (mime === "video/mp4" || mime === "video/webm") return ASSET_PREVIEW.VIDEO;
-  if (mime?.startsWith("image/")) return ASSET_PREVIEW.IMAGE;
-  return ASSET_PREVIEW.ICON;
-};
-
-export const getAssetType = (assetTypeId) =>
-  ASSET_TYPES[assetTypeId] ?? ASSET_TYPES.otro;
-
-export const getExtension = (fileName = "") => {
-  const parts = String(fileName).split(".");
-  return parts.length > 1 ? parts.pop().toLowerCase() : "";
-};
-
-/*
-  Qué tipo reclama cada extensión, resuelto una sola vez.
-
-  El orden de `ASSET_TYPE_ORDER` decide los empates: `mp4` y `gif` aparecen
-  también en "360", pero gana el tipo genérico porque es el caso común y el
-  usuario puede reetiquetarlo en la tarjeta. Mirando el archivo no hay forma de
-  saber si un giro es un giro.
-*/
-const EXTENSION_INDEX = ASSET_TYPE_ORDER.reduce((index, id) => {
-  ASSET_TYPES[id].extensions.forEach((ext) => {
-    if (id !== "360" && !index[ext]) index[ext] = id;
-  });
-  return index;
-}, {});
-
-/**
- * Tipo de activo sugerido para un archivo recién elegido.
- *
- * Manda la extensión. El mime solo se consulta como respaldo para los formatos
- * multimedia, que son los únicos que el navegador reconoce con certeza: para un
- * .psd o un .ai reporta `application/octet-stream` o nada, y para un .ai a veces
- * `application/pdf`, que lo clasificaría como documento.
- */
-export const suggestAssetType = ({ mime, name } = {}) => {
-  const ext = getExtension(name);
-  if (EXTENSION_INDEX[ext]) return EXTENSION_INDEX[ext];
-
-  if (mime?.startsWith("video/")) return "video";
-  if (mime === "image/gif") return "gif";
-  if (mime === "application/pdf") return "documento";
-
-  return "otro";
-};
-
-/** Todos los mimes aceptados, sin repetir. */
-export const acceptedMimes = () => [
-  ...new Set(ASSET_TYPE_ORDER.flatMap((id) => ASSET_TYPES[id].mimes)),
-];
-
-/** Todas las extensiones aceptadas, sin repetir y con punto. */
-export const acceptedExtensions = () => [
-  ...new Set(ASSET_TYPE_ORDER.flatMap((id) => ASSET_TYPES[id].extensions)),
-].map((ext) => `.${ext}`);
-
-/**
- * Valor de `accept` para react-dropzone (v12: una cadena separada por comas).
- *
- * Lleva mimes Y extensiones. Con solo mimes, react-dropzone descartaría un
- * .psd o un .indd antes de que nuestra validación llegue a verlos —el navegador
- * no les asigna mime— y al soltarlos no pasaría absolutamente nada: ni el
- * archivo, ni un mensaje de por qué.
- */
-export const buildDropzoneAccept = () => [...acceptedMimes(), ...acceptedExtensions()].join(", ");
-
-/** Lista legible de formatos, para mensajes y para la ayuda de la bandeja. */
-export const acceptedFormatsLabel = () => acceptedExtensions()
-  .map((ext) => ext.replace(".", "").toUpperCase())
-  .join(", ");
-
-const GB = 1024 * MB;
-
-export const formatBytes = (bytes) => {
-  const value = Number(bytes);
-  if (!Number.isFinite(value) || value <= 0) return "-";
-  if (value < KB) return `${value} B`;
-  if (value < MB) return `${Math.round(value / KB)} KB`;
-  // Los editables llegan a varios cientos de MB; sin este escalón un archivo de
-  // 1.2 GB se anunciaba como "1228.8 MB".
-  if (value < GB) return `${(value / MB).toFixed(1)} MB`;
-  return `${(value / GB).toFixed(2)} GB`;
-};
-
-/** Duración compacta para la tarjeta del activo: "1:05". */
-export const formatDuration = (seconds) => {
-  const value = Number(seconds);
-  if (!Number.isFinite(value) || value <= 0) return "-";
-  const mins = Math.floor(value / 60);
-  const secs = Math.round(value % 60);
-  return `${mins}:${String(secs).padStart(2, "0")}`;
-};
-
-/** Duración en prosa para los mensajes de error: "10 segundos", "10 minutos". */
-export const humanizeDuration = (seconds) => {
-  const value = Number(seconds);
-  if (!Number.isFinite(value) || value <= 0) return "-";
-  if (value < 60) return `${Math.round(value)} segundos`;
-  const mins = value / 60;
-  const label = Number.isInteger(mins) ? mins : mins.toFixed(1);
-  return `${label} ${mins === 1 ? "minuto" : "minutos"}`;
-};
-
-/**
- * Valida un archivo ANTES de tocar la red: tipo permitido, peso y cupo.
- *
- * Se separa de la subida a propósito. Da igual que el archivo termine yendo por
- * URL prefirmada o por el `putObject` de hoy: esto no cambia, y es lo que evita
- * que el navegador empiece a leer 200 MB que de todos modos se van a rechazar.
- *
- * @returns {{ valid: boolean, code?: string, message?: string }}
- */
-export const validateAssetFile = (file, { currentCount = 0 } = {}) => {
-  if (!file) {
-    return {
-      valid: false,
-      code: "NO_FILE",
-      message: "No se recibió ningún archivo.",
-    };
-  }
-
-  if (currentCount >= MAX_ASSETS_PER_PRODUCT) {
-    return {
-      valid: false,
-      code: "MAX_ASSETS",
-      message: `Solo puedes almacenar ${MAX_ASSETS_PER_PRODUCT} activos digitales por producto.`,
-    };
-  }
-
-  const assetTypeId = suggestAssetType({ mime: file.type, name: file.name });
-  const assetType = getAssetType(assetTypeId);
-
-  if (assetTypeId === "otro") {
-    return {
-      valid: false,
-      code: "UNSUPPORTED_TYPE",
-      message: `"${file.name}" no es un formato permitido. Se aceptan: ${acceptedFormatsLabel()}.`,
-    };
-  }
-
-  if (file.size > assetType.maxBytes) {
-    return {
-      valid: false,
-      code: "MAX_SIZE",
-      message: `"${file.name}" pesa ${formatBytes(
-        file.size
-      )} y el máximo para ${assetType.label} es ${formatBytes(
-        assetType.maxBytes
-      )}.`,
-    };
-  }
-
-  return { valid: true, assetType: assetTypeId, warning: warnAssetFile(file, assetTypeId) };
-};
-
-/**
- * Aviso para un archivo que SÍ se acepta pero que el usuario no va a poder ver.
- *
- * El caso que sorprende es el video: alguien sube una grabación de pantalla de
- * macOS —un .mov— esperando reproducirla, y el navegador no la decodifica. El
- * archivo sirve igual para entregarlo al retailer, así que no se rechaza; pero
- * enterarse al soltarlo es mucho mejor que enterarse al intentar verlo.
- *
- * No se avisa de un .psd o un .indd: nadie espera previsualizar un archivo de
- * diseño, y un aviso por cada uno sería ruido.
- */
-export const warnAssetFile = (file, assetTypeId) => {
-  if (assetTypeId !== "video" && assetTypeId !== "360") return null;
-
-  const ext = getExtension(file?.name);
-  if (PLAYABLE_VIDEO_EXTENSIONS.includes(ext)) return null;
-
-  return `"${file?.name}" se guardará y se podrá descargar, pero el navegador no puede reproducir los .${ext}. Conviértelo a MP4 si necesitas verlo aquí.`;
-};
-
-/**
- * Valida la duración de un video. Va aparte de `validateAssetFile` porque
- * obtenerla es asíncrono (hay que cargar el archivo en un <video>) y no se
- * quiere pagar ese costo en archivos que ya fueron rechazados por peso.
- */
-export const validateAssetDuration = (seconds, assetTypeId) => {
-  const assetType = getAssetType(assetTypeId);
-  if (!assetType.validatesDuration) return { valid: true };
-
-  const value = Number(seconds);
-  if (!Number.isFinite(value)) return { valid: true };
-
-  const { min, max } = VIDEO_DURATION_SECONDS;
-  if (value < min || value > max) {
-    return {
-      valid: false,
-      code: "DURATION",
-      message: `Los videos deben durar entre ${humanizeDuration(
-        min
-      )} y ${humanizeDuration(max)}.`,
-    };
-  }
-
-  return { valid: true };
-};

package/src/global-files/digital-assets/assets.actions.js

@@ -1,50 +0,0 @@
-/**
- * Vocabulario compartido del estado de activos digitales.
- *
- * Vive aquí, y no dentro del reducer, para que nadie dependa de nadie en la
- * dirección equivocada: el reducer de la ficha (`context/reducers/assets.js`)
- * y el hook de la bandeja (`useDigitalAssets`) importan ambos estas constantes,
- * y ninguno de los dos importa al otro. Es lo que permite probar el reducer
- * suelto en Storybook sin arrastrar la pantalla completa.
- */
-
-export const ASSET_ACTIONS = {
-  /** Reemplaza toda la lista con lo que devolvió el backend. Limpia el rastreo. */
-  SET_ASSETS_VALUES: "SET_ASSETS_VALUES",
-  /** Agrega activos recién soltados y ya validados. */
-  ADD_ASSETS: "ADD_ASSETS",
-  /**
-   * Cambio hecho por el usuario (reetiquetar el tipo, renombrar). Si el activo
-   * ya existe en el backend, queda marcado para enviarse al guardar.
-   */
-  UPDATE_ASSET: "UPDATE_ASSET",
-  /**
-   * Cambio de ciclo de vida de la subida: progreso, estado, error, o la clave
-   * de S3 que devuelve el backend. NO marca nada para guardar —el progreso de
-   * una barra no es una edición del usuario— y por eso está separado de
-   * `UPDATE_ASSET` en vez de ser una bandera.
-   */
-  PATCH_ASSET: "PATCH_ASSET",
-  /** Quita un activo de la lista. Si ya existía en el backend, lo anota para borrarlo. */
-  REMOVE_ASSET: "REMOVE_ASSET",
-  SET_SELECTED_ASSETS: "SET_SELECTED_ASSETS",
-  TOGGLE_CHECK_ALL_ASSETS: "TOGGLE_CHECK_ALL_ASSETS",
-  /** Tras un guardado exitoso: olvida qué cambió y qué se borró. */
-  CLEAR_ASSETS_TRACKING: "CLEAR_ASSETS_TRACKING",
-};
-
-export const assetsInitialState = {
-  /** Lista completa, en el modelo de interfaz de `assets.adapter`. */
-  assets_values: [],
-  /**
-   * Claves de los activos YA GUARDADOS que el usuario modificó. Se guardan
-   * claves y no copias del objeto: una copia se queda vieja en cuanto el
-   * usuario vuelve a tocar el activo, y al guardar se enviaría el valor
-   * anterior. Con la clave, el objeto se lee siempre de `assets_values`.
-   */
-  updated_assets: [],
-  /** Ids del backend pendientes de borrar. */
-  deleted_assets: [],
-  selected_assets: [],
-  all_assets_checked: false,
-};

package/src/global-files/digital-assets/assets.adapter.js

@@ -1,229 +0,0 @@
-/**
- * Traducción entre el activo digital como lo guarda el backend y como lo usa la
- * interfaz.
- *
- * DOS DECISIONES DEL NEGOCIO QUE SE NOTAN EN ESTE MODELO:
- *
- * - **Los activos no tienen versión.** Un activo general es el mismo sin
- *   importar la versión del producto, así que no lleva `id_version` ni en el
- *   modelo ni en la clave de S3. Eso evita el problema que sí tienen las
- *   imágenes —copiar archivos al crear una versión— y hace que un video subido
- *   en la v2 se vea también al mirar la v1.
- * - **Por ahora todos son generales**, o sea `id_retailer = null`. La columna
- *   existe y este adaptador ya la respeta para cuando se pida acotar un activo
- *   a una cadena; hasta entonces nada la escribe.
- *
- * Es el único archivo que conoce los nombres de campo del backend. Mientras el
- * contrato siga sin cerrarse, todo lo demás —tarjetas, bandeja, validaciones—
- * se construye contra el modelo de esta capa; cuando el contrato quede fijo se
- * ajustan estas funciones y nada más.
- *
- * El contrato propuesto está en `rel_article_asset`: una tabla aparte de
- * `rel_article_image`, porque esa última guarda una sola fila por
- * (artículo, versión, tipo de toma) y pisaría un activo con el siguiente.
- */
-
-import { getAssetType, getExtension, suggestAssetType } from "./assetTypes";
-
-/**
- * Estado de un activo en pantalla. `pending`/`uploading`/`error` solo existen
- * en el navegador: un activo con id del backend siempre está `saved`.
- */
-export const ASSET_STATUS = {
-  PENDING: "pending",
-  UPLOADING: "uploading",
-  SAVED: "saved",
-  ERROR: "error",
-};
-
-const IMAGES_BUCKET = () => process.env.REACT_APP_IMAGES_BUCKET;
-
-/**
- * URL directa al objeto en S3.
- *
- * A propósito NO pasa por el redimensionador de CloudFront: ese servicio
- * reescribe la imagen con sharp y para un mp4, un gif animado o un pdf
- * devuelve basura. Es la misma URL que ya usa la descarga de imágenes.
- */
-export const buildAssetUrl = (key) => {
-  if (!key) return "";
-  if (/^https?:\/\//i.test(key)) return key;
-  return `https://${IMAGES_BUCKET()}.s3.amazonaws.com/${key}`;
-};
-
-/**
- * `Number(null)` y `Number("")` son 0, no NaN. Sin descartarlos antes, un
- * `id_retailer: null` —que significa "de todas las cadenas"— se convierte en el
- * retailer 0 y el activo deja de verse en ninguna; una duración nula se vuelve
- * un video de cero segundos.
- */
-const toNumberOrNull = (value) => {
-  if (value === null || value === undefined || value === "") return null;
-  const parsed = Number(value);
-  return Number.isFinite(parsed) ? parsed : null;
-};
-
-/**
- * Fila del backend -> modelo de interfaz.
- *
- * Acepta `url` ya resuelta si el backend la manda; si no, la arma desde la
- * clave de S3. Así el front funciona igual con cualquiera de las dos formas del
- * contrato y no hay que esperar a que se decida para seguir construyendo.
- */
-export const fromBackend = (row = {}) => {
-  const ext = row.ext || getExtension(row.name || row.src);
-  const assetType =
-    row.asset_type || suggestAssetType({ mime: row.mime, name: row.name });
-
-  return {
-    id: row.id ?? null,
-    tempId: null,
-    assetType,
-    name: row.name || "",
-    ext,
-    mime: row.mime || "",
-    sizeBytes: toNumberOrNull(row.size_bytes),
-    duration: toNumberOrNull(row.duration),
-    width: toNumberOrNull(row.width),
-    height: toNumberOrNull(row.height),
-    // Clave en S3. Se conserva porque es lo que el backend necesita de vuelta;
-    // la URL es derivada y no debe viajar en el payload.
-    src: row.src || "",
-    url: row.url || buildAssetUrl(row.src),
-    poster: row.poster ? buildAssetUrl(row.poster) : "",
-    // `id_retailer` nulo = activo general, que es lo único que se escribe hoy.
-    retailerId: toNumberOrNull(row.id_retailer),
-    createdAt: row.created_at || null,
-    file: null,
-    status: ASSET_STATUS.SAVED,
-    progress: 100,
-    error: null,
-  };
-};
-
-export const fromBackendList = (rows = []) =>
-  Array.isArray(rows) ? rows.map(fromBackend) : [];
-
-let tempCounter = 0;
-
-/**
- * Archivo recién elegido -> modelo de interfaz.
- *
- * El `File` nativo se guarda tal cual, sin leerlo a base64. Convertirlo cuesta
- * un tercio más de memoria y es lo que hoy vuelve imposible subir un video
- * largo o un manual grande; con el `File` intacto da igual si termina subiendo
- * por URL prefirmada o por el cliente de S3.
- *
- * El `tempId` permite seguirle la pista a un activo que todavía no tiene id del
- * backend: sin él no hay forma de actualizar su progreso ni de quitarlo de la
- * lista si falla.
- */
-export const fromFile = (file, { assetType, objectUrl } = {}) => {
-  tempCounter += 1;
-  const ext = getExtension(file?.name);
-
-  return {
-    id: null,
-    tempId: `tmp-${Date.now()}-${tempCounter}`,
-    assetType:
-      assetType || suggestAssetType({ mime: file?.type, name: file?.name }),
-    name: file?.name || "",
-    ext,
-    mime: file?.type || "",
-    sizeBytes: toNumberOrNull(file?.size),
-    duration: null,
-    width: null,
-    height: null,
-    src: "",
-    // `URL.createObjectURL` deja ver el archivo sin subirlo ni codificarlo.
-    // Quien lo crea es responsable de liberarlo con `revokeAssetUrl`.
-    url: objectUrl || "",
-    poster: "",
-    retailerId: null,
-    createdAt: null,
-    file,
-    status: ASSET_STATUS.PENDING,
-    progress: 0,
-    error: null,
-  };
-};
-
-/** Identificador estable de un activo, tenga o no id del backend. */
-export const assetKey = (asset = {}) =>
-  asset.id ?? asset.tempId ?? asset.src ?? asset.name;
-
-export const isPersisted = (asset = {}) =>
-  asset.id !== null && asset.id !== undefined;
-
-/**
- * Modelo de interfaz -> payload del backend.
- *
- * Nunca incluye `file` ni `url`: el archivo ya está en S3 cuando esto se envía
- * y la URL es derivada. Es la misma razón por la que el guardado de imágenes
- * borra `src`/`video_src` antes del PUT — el binario en el cuerpo devuelve 413.
- */
-export const toPayload = (asset = {}) => {
-  const payload = {
-    asset_type: asset.assetType,
-    name: asset.name,
-    ext: asset.ext,
-    mime: asset.mime,
-    size_bytes: asset.sizeBytes ?? null,
-    duration: asset.duration ?? null,
-    width: asset.width ?? null,
-    height: asset.height ?? null,
-    key: asset.src || null,
-  };
-
-  if (isPersisted(asset)) payload.id = asset.id;
-  if (asset.retailerId !== null && asset.retailerId !== undefined) {
-    payload.id_retailer = asset.retailerId;
-  }
-
-  return payload;
-};
-
-/**
- * Separa la lista en lo que el backend espera recibir: altas, cambios y bajas.
- * `deleted` son ids, no objetos, porque para borrar no hace falta nada más.
- */
-export const buildSavePayload = ({
-  assets = [],
-  updated = [],
-  deleted = [],
-} = {}) => ({
-  newAssets: assets.filter((asset) => !isPersisted(asset)).map(toPayload),
-  updateAssets: updated.filter(isPersisted).map(toPayload),
-  deleteAssets: deleted
-    .map((asset) => (typeof asset === "object" ? asset.id : asset))
-    .filter(Boolean),
-});
-
-/**
- * Qué activos ve la cadena activa: los generales (`retailerId` nulo) más los
- * suyos.
- *
- * Hoy todos son generales, así que en la práctica no filtra nada. Se deja
- * escrito y probado para el día que se pida acotar un activo a una cadena: ese
- * día basta con que el backend mande el `id_retailer`, sin tocar la pantalla.
- */
-export const filterByRetailer = (assets = [], retailerId) => {
-  if (!retailerId) return assets;
-  return assets.filter(
-    (asset) =>
-      asset.retailerId === null ||
-      asset.retailerId === undefined ||
-      Number(asset.retailerId) === Number(retailerId)
-  );
-};
-
-/** Libera el object URL de un activo local. Sin esto el archivo se queda en memoria. */
-export const revokeAssetUrl = (asset = {}) => {
-  if (asset.file && asset.url && asset.url.startsWith("blob:")) {
-    URL.revokeObjectURL(asset.url);
-  }
-};
-
-/** Etiqueta legible del tipo, para badges y tablas. */
-export const assetTypeLabel = (asset = {}) =>
-  getAssetType(asset.assetType).label;