@nitida/sdk 0.32.0 → 0.32.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitida/sdk",
-  "version": "0.32.0",
+  "version": "0.32.2",
   "description": "nitida — the media SDK: browser and mobile upload with resume, client-side compression, on-the-fly transforms behind a CDN, video transcode, HLS ladders and AI proxies. Multi-tenant.",
   "private": false,
   "publishConfig": {
@@ -73,7 +73,7 @@
   },
   "peerDependencies": {
     "react": ">=18",
-    "@nitida/asset-client": "^0.20.2",
+    "@nitida/asset-client": "^0.20.3",
     "@nitida/asset-compressor-web": "^0.6.1",
     "@nitida/asset-compressor-native": "^0.2.1"
   },

package/src/index.ts

@@ -1166,6 +1166,45 @@ export type UploadResult = {
    * privado, servida sin una queja, que después da 404.
    */
   visibility: "public" | "private";
+  /**
+   * La cadena compacta de variantes que EXISTEN (`"lmoqs"`, `"o"`, …).
+   *
+   * ⭐⭐ EL QUINTO DEFECTO DE LA MISMA FAMILIA
+   *
+   * `getAssetUrl` **cambia de estrategia según este campo**. Con él, un preset
+   * de imagen ausente cae a `/t/…width=N/` y el borde lo genera al vuelo:
+   * **200**. Sin él, el builder no sabe qué existe, asume que todo existe, y
+   * devuelve la clave de variante — que da **404 en silencio**.
+   *
+   * Medido 2026-08-25 sobre un asset con `presets: "lmoqs"`:
+   *
+   *     sin `presets`  →  /f/v/<sha>-x.webp                   404
+   *     con `presets`  →  /t/format=webp,width=3840/<sha>.webp 200
+   *
+   * `UploadResult` no lo llevaba, así que `getAssetUrl(up, "xl")` —el patrón
+   * que enseña toda la doc— caía del lado malo.
+   *
+   * ⚠️ Es el mismo error que `sha`, `mime` y `oext`, por cuarta vez: **un tipo
+   * de retorno que omite lo que la próxima llamada necesita convierte la
+   * llamada obvia en un 404 silencioso.** Y el guarda que escribí para esto
+   * fijaba los tres *hints* de `original`; `presets` no es un hint, es lo que
+   * gobierna el fallback, así que quedaba afuera de lo que el guarda miraba.
+   */
+  presets: string;
+  /**
+   * La lista de variantes tal como el servidor las guardó.
+   *
+   * ⭐ **La SEXTA instancia del mismo defecto, y la primera que encontró un
+   * guarda en vez de un usuario.**
+   *
+   * Para `original`, `getAssetUrl` prefiere la URL almacenada sobre cualquier
+   * derivación — porque ESA es la clave real, y derivarla del mime es una
+   * suposición que ya falló dos veces (`-o.bin`, `-o.jpeg`). Sin este campo, el
+   * resultado de `upload()` obligaba a suponer.
+   *
+   * Sale gratis: `upload()` ya espera el DTO, que la trae.
+   */
+  variants: AssetVariant[];
 };
 
 async function computeSha256(
@@ -1718,6 +1757,8 @@ export class NitidaClient {
         // DTO does carry `sha` today — but relying on that is how the other
         // branch broke, and the value we hashed ourselves is authoritative.
         visibility: existing.visibility ?? "public",
+        presets: existing.presets ?? "",
+        variants: existing.variants ?? [],
         cdnUrl: this.publicUrlOrNull(
           { ...existing, sha: sha.slice(0, 16) },
           this.bestPresetForAsset(existing, mime),
@@ -1810,6 +1851,8 @@ export class NitidaClient {
         // `defaultPresetForMime`, which is a guess made before anything exists.
         // Guessing was safe only while this branch never ran.
         visibility: settled.visibility ?? "public",
+        presets: settled.presets ?? "",
+        variants: settled.variants ?? [],
         cdnUrl: this.publicUrlOrNull(
           { ...settled, sha: short },
           this.bestPresetForAsset(settled, mime),
@@ -1867,6 +1910,8 @@ export class NitidaClient {
       mime: final.mime ?? mime,
       oext: final.oext ?? null,
       visibility: final.visibility ?? "public",
+      presets: final.presets ?? "",
+      variants: final.variants ?? [],
       cdnUrl: this.publicUrlOrNull(final, this.bestPresetForAsset(final, mime)),
     };
   }