@nitida/sdk 0.29.0 → 0.30.0

package/src/index.ts

@@ -1109,6 +1109,32 @@ export type UploadResult = {
    * message about the wrong one.
    */
   sha: string;
+  /**
+   * The MIME the upload was stored under.
+   *
+   * ⭐ It exists because it did not, and that cost the THIRD 404 of this exact
+   * family. Found 2026-08-23 by an agent running the getting-started doc
+   * verbatim: `getAssetUrl(up, "original")` built `<sha>-o.bin` and 404'd,
+   * while the object served fine at `-o.jpg`.
+   *
+   * `original` is the one preset whose extension is not fixed — it is the
+   * bytes you uploaded, so the extension comes from the MIME (`ORIGINAL_EXT_BY_MIME`),
+   * and `PRESET_EXT.original` is only the `"bin"` fallback for when nothing
+   * says otherwise. `UploadResult` said nothing, so every caller handing an
+   * upload result straight to a URL builder got the fallback.
+   *
+   * The pattern is now three for three — `sha256` vs `sha`, and this:
+   * **a result type that omits what the next call needs turns the obvious
+   * call into a silent 404.** The fix is never a better error message.
+   */
+  mime: string;
+  /**
+   * The extension the server actually stored the original under, when it said
+   * so. Authoritative — it beats any client-side MIME table, because the
+   * server keys the object off the uploaded filename for the cases no table
+   * can close (`.mpga`, `.docx`, `.m4a` all arrive as octet-stream).
+   */
+  oext?: string | null;
   cdnUrl: string;
 };
 
@@ -1656,6 +1682,8 @@ export class NitidaClient {
         assetId: existing.id,
         sha256: sha,
         sha: sha.slice(0, 16),
+        mime: existing.mime ?? mime,
+        oext: existing.oext ?? null,
         cdnUrl: this.urlFor(existing, this.bestPresetForAsset(existing, mime)),
       };
     }
@@ -1682,6 +1710,8 @@ export class NitidaClient {
         assetId: presign.asset.id,
         sha256: sha,
         sha: sha.slice(0, 16),
+        mime: presign.asset.mime ?? mime,
+        oext: presign.asset.oext ?? null,
         cdnUrl: this.urlFor(presign.asset, this.defaultPresetForMime(mime)),
       };
     }
@@ -1733,6 +1763,8 @@ export class NitidaClient {
       assetId,
       sha256: sha,
       sha: sha.slice(0, 16),
+      mime: final.mime ?? mime,
+      oext: final.oext ?? null,
       cdnUrl: this.urlFor(final, this.bestPresetForAsset(final, mime)),
     };
   }