@nitida/sdk 0.27.0 → 0.27.1

package/src/index.ts

@@ -227,6 +227,7 @@ export type {
 export {
   accessMessage,
   assertPublic,
+  assertSha,
   bestTextContrast,
   computeVariantDimensions,
   configureSlotResolver,
@@ -1018,6 +1019,22 @@ const DEFAULT_UPLOAD_PRESETS: RequestablePreset[] = ["original"];
 export type UploadResult = {
   assetId: string;
   sha256: string;
+  /**
+   * The SAME 16-hex prefix an `AssetDTO` carries, so the result of an upload can
+   * be handed straight to any URL builder.
+   *
+   * ⭐ It exists because it did not, and that cost a real 404. A Haiku agent
+   * evaluating the SDK on 2026-08-23 did the most natural thing there is —
+   * `transform(await upload(file), { width: 1280 })` — and got
+   * `https://8ok.uk/t/width=1280/undefined.webp`. The builders read `sha`; this
+   * type only had `sha256`. TypeScript caught it; running through `bun`, or in
+   * plain JS, nothing did.
+   *
+   * The guard (`assertSha`) is the backstop. This field is the actual fix: the
+   * obvious call is now the correct one, which is worth more than a good error
+   * message about the wrong one.
+   */
+  sha: string;
   cdnUrl: string;
 };
 
@@ -1563,6 +1580,7 @@ export class NitidaClient {
       return {
         assetId: existing.id,
         sha256: sha,
+        sha: sha.slice(0, 16),
         cdnUrl: this.urlFor(existing, this.bestPresetForAsset(existing, mime)),
       };
     }
@@ -1588,6 +1606,7 @@ export class NitidaClient {
       return {
         assetId: presign.asset.id,
         sha256: sha,
+        sha: sha.slice(0, 16),
         cdnUrl: this.urlFor(presign.asset, this.defaultPresetForMime(mime)),
       };
     }
@@ -1638,6 +1657,7 @@ export class NitidaClient {
     return {
       assetId,
       sha256: sha,
+      sha: sha.slice(0, 16),
       cdnUrl: this.urlFor(final, this.bestPresetForAsset(final, mime)),
     };
   }

package/src/server/index.ts

@@ -96,6 +96,7 @@ export {
   type AssetVariant,
   accessMessage,
   assertPublic,
+  assertSha,
   bestTextContrast,
   type ComposeMarketingComposition,
   type ComposeMarketingOptions,

package/src/web/index.ts

@@ -113,6 +113,7 @@ export {
   type AssetVariant,
   accessMessage,
   assertPublic,
+  assertSha,
   bestTextContrast,
   type ComposeMarketingComposition,
   type ComposeMarketingOptions,