@nitida/sdk 0.32.0 → 0.32.1

package/src/index.ts

@@ -1166,6 +1166,31 @@ 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;
 };
 
 async function computeSha256(
@@ -1718,6 +1743,7 @@ 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 ?? "",
         cdnUrl: this.publicUrlOrNull(
           { ...existing, sha: sha.slice(0, 16) },
           this.bestPresetForAsset(existing, mime),
@@ -1810,6 +1836,7 @@ 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 ?? "",
         cdnUrl: this.publicUrlOrNull(
           { ...settled, sha: short },
           this.bestPresetForAsset(settled, mime),
@@ -1867,6 +1894,7 @@ export class NitidaClient {
       mime: final.mime ?? mime,
       oext: final.oext ?? null,
       visibility: final.visibility ?? "public",
+      presets: final.presets ?? "",
       cdnUrl: this.publicUrlOrNull(final, this.bestPresetForAsset(final, mime)),
     };
   }