@nitida/asset-client 0.20.2 → 0.20.4

package/dist/index.d.cts

@@ -876,7 +876,20 @@ type OriginalHints = {
  * const url = hasPreset(asset, "thumb") ? getAssetUrl(asset, "thumb") : null;
  * ```
  */
-declare function getAssetUrl(asset: Pick<AssetDTO, "sha"> & OriginalHints & VisibilityHint, preset: VariantPreset): string;
+declare function getAssetUrl(
+/**
+ * ⭐ `presets` ESTÁ EN EL TIPO PORQUE LA FUNCIÓN LO LEE.
+ *
+ * `transformFallbackFor` decide con este campo si devolver la clave de
+ * variante o caer a `/t/…width=N/`. Sin él en la firma, el tipo PROHIBÍA el
+ * campo que la implementación consulta: pasarlo era un error de compilación,
+ * y no pasarlo daba `…-x.webp` → 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
+ */
+asset: Pick<AssetDTO, "sha"> & OriginalHints & VisibilityHint & Partial<Pick<AssetDTO, "presets">>, preset: VariantPreset): string;
 /**
  * The signed URL for one preset of a PRIVATE asset — what every refusal above
  * points at.
@@ -946,7 +959,9 @@ declare function getPrivateTransformUrl(asset: Pick<AssetDTO, "sha">, opts: Sign
  * hasPreset({ presets: "pv" }, "aiproxy");   // → false  — video without the AI proxy
  * ```
  */
-declare function hasPreset(asset: Pick<AssetDTO, "presets">, preset: VariantPreset): boolean;
+declare function hasPreset(asset: {
+    presets?: string | null;
+}, preset: VariantPreset): boolean;
 declare function getAssetSrcSet(asset: Pick<AssetDTO, "sha" | "presets"> & VisibilityHint): string;
 /**
  * Compute the dimensions a variant would have given the source asset's

package/dist/index.d.ts

@@ -876,7 +876,20 @@ type OriginalHints = {
  * const url = hasPreset(asset, "thumb") ? getAssetUrl(asset, "thumb") : null;
  * ```
  */
-declare function getAssetUrl(asset: Pick<AssetDTO, "sha"> & OriginalHints & VisibilityHint, preset: VariantPreset): string;
+declare function getAssetUrl(
+/**
+ * ⭐ `presets` ESTÁ EN EL TIPO PORQUE LA FUNCIÓN LO LEE.
+ *
+ * `transformFallbackFor` decide con este campo si devolver la clave de
+ * variante o caer a `/t/…width=N/`. Sin él en la firma, el tipo PROHIBÍA el
+ * campo que la implementación consulta: pasarlo era un error de compilación,
+ * y no pasarlo daba `…-x.webp` → 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
+ */
+asset: Pick<AssetDTO, "sha"> & OriginalHints & VisibilityHint & Partial<Pick<AssetDTO, "presets">>, preset: VariantPreset): string;
 /**
  * The signed URL for one preset of a PRIVATE asset — what every refusal above
  * points at.
@@ -946,7 +959,9 @@ declare function getPrivateTransformUrl(asset: Pick<AssetDTO, "sha">, opts: Sign
  * hasPreset({ presets: "pv" }, "aiproxy");   // → false  — video without the AI proxy
  * ```
  */
-declare function hasPreset(asset: Pick<AssetDTO, "presets">, preset: VariantPreset): boolean;
+declare function hasPreset(asset: {
+    presets?: string | null;
+}, preset: VariantPreset): boolean;
 declare function getAssetSrcSet(asset: Pick<AssetDTO, "sha" | "presets"> & VisibilityHint): string;
 /**
  * Compute the dimensions a variant would have given the source asset's

package/dist/index.js

@@ -643,11 +643,12 @@ async function getPrivateTransformUrl(asset, opts, signingKey, signOpts) {
   );
 }
 function hasPreset(asset, preset) {
-  if (preset === "mp3") return asset.presets.includes("mp3");
-  return stripMultiCharTokens(asset.presets).includes(PRESET_SHORT[preset]);
+  const presets = asset.presets ?? "";
+  if (preset === "mp3") return presets.includes("mp3");
+  return stripMultiCharTokens(presets).includes(PRESET_SHORT[preset]);
 }
 function stripMultiCharTokens(presets) {
-  return presets.replace(/transform-[0-9a-f]*/g, "").replace(/upscale_[a-z0-9_]*/g, "").replace(/mp3/g, "").replace(/u[2-8]|t[1248ghij]/g, "").replace(/pr/g, "");
+  return (presets ?? "").replace(/transform-[0-9a-f]*/g, "").replace(/upscale_[a-z0-9_]*/g, "").replace(/mp3/g, "").replace(/u[2-8]|t[1248ghij]/g, "").replace(/pr/g, "");
 }
 var IMAGE_PRESETS = ["thumb", "sm", "md", "lg", "xl"];
 function getAssetSrcSet(asset) {