@nitida/sdk 0.30.2 → 0.31.1

package/README.md

@@ -544,7 +544,7 @@ Two delivery paths, **by design**:
 
 | Kind | Builder | URL shape | Tenant in path? |
 |---|---|---|---|
-| Variant / preset | `urlFor`, `srcSetFor`, upload `cdnUrl` | `<cdn>/<tenantId b36>/v/<sha>-<preset>.<ext>` | **Yes** — `/4/v/<sha>-lg.webp` |
+| Variant / preset | `urlFor`, `srcSetFor`, upload `cdnUrl` | `<cdn>/<tenantId b36>/v/<sha>-<preset>.<ext>` | **Yes** — `/4/v/<sha>-l.webp` |
 | On-the-fly transform | `transform`, `transformSrcSet` | `<cdn>/t/<dsl>/<sha>.<ext>` | **No** — `/t/width=1280,.../<sha>.webp` |
 
 The transform service is content-addressed by `sha` and resizes from the source on demand,
@@ -661,7 +661,13 @@ with `aq.assets.regenerate()` (no re-upload required).
 // Default: only the original variant lands on the CDN.
 const { assetId, cdnUrl } = await aq.upload(logoFile);
 // asset.presets === "o"
-// cdnUrl = https://8ok.uk/<sha>-o.svg
+// cdnUrl = https://8ok.uk/<tid b36>/v/<sha>-o.svg   ← the tenant segment is not optional
+
+// Processing is asynchronous. `upload()` returns as soon as the bytes are
+// accepted; the variants are not on the CDN yet. Wait for them:
+const ready = await aq.assets.waitReady(assetId, 90_000); // MILLISECONDS
+// ready.presets is the compact string ("o", "lmoqs", …), ALPHABETICALLY
+// sorted — not in the order you asked for.
 ```
 
 **Responsive ladder (the old default — now explicit):**
@@ -1307,12 +1313,25 @@ server-side pipeline (a platform-wide addition, not a per-tenant one).
 
 ### CDN URL format
 
-`<cdnBase>/<sha16>-<presetCode>.<ext>`
+`<cdnBase>/<tenantId base36>/v/<sha16>-<presetCode>.<ext>`
+
+Example: `https://8ok.uk/f/v/c482458e824c730e-q.webp` — the `thumb` preset of
+sha `c482458e…` as WebP, for **tenant 15** (`15` in base36 is `f`).
+
+⚠️ **The tenant segment is not optional, and it is base36.** `/15/…` 404s;
+so does a bare `/<sha16>-q.webp` with no tenant at all. Nothing serves that
+shape — it is not a legacy path, it is a 404. Call `setTenantId(id)` once at
+boot (or construct a `NitidaClient` with `tenantId`, which does it for you);
+without it the builders **throw** rather than hand you a URL that cannot work.
+
+Within one tenant the path is content-addressed: the same source bytes always
+produce the same URL, and that URL never invalidates.
 
-Example: `https://8ok.uk/c482458e824c730e-q.webp` (the `thumb` preset of
-sha `c482458e…` rendered as WebP). The path is content-addressed, so the
-same source bytes produce the same URL regardless of which tenant uploaded
-them — and the same URL never invalidates.
+> Before `@nitida/asset-client@0.20.0` this section documented the bare
+> `<cdnBase>/<sha16>-<preset>.<ext>` form, with an example that 404s, and said
+> the URL was the same "regardless of which tenant uploaded them". That stopped
+> being true at the tenant-prefix cutover. If you copied a URL from an older
+> README, add the `<tid b36>/v/` segment.
 
 ## Auth
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nitida/sdk",
-  "version": "0.30.2",
+  "version": "0.31.1",
   "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.19.1",
+    "@nitida/asset-client": "^0.20.1",
     "@nitida/asset-compressor-web": "^0.6.1",
     "@nitida/asset-compressor-native": "^0.2.1"
   },

package/skills/nitida-sdk/SKILL.md

@@ -60,7 +60,7 @@ import { setCdnBase, setTenantId } from "@nitida/asset-client";
 const TENANT_ID = Number(process.env.NEXT_PUBLIC_NITIDA_TENANT_ID) || /* your id */ 0;
 
 setCdnBase("https://8ok.uk"); // OPTIONAL — this is already the default; set it only if you were given another host
-setTenantId(TENANT_ID);       // REQUIRED for video URLs (base36 variant prefix) — see §3
+setTenantId(TENANT_ID);       // REQUIRED for EVERY variant URL — images too (base36 prefix), see §3
 ```
 
 `NEXT_PUBLIC_*` so the tenant id reaches the client bundle (hero/about videos render client-side). The runtime read-only consumer needs only these public vars — the `amk_rt_*` runtime key is for **uploads** (server-only), not for building URLs.
@@ -100,7 +100,9 @@ Output URL shape: `https://8ok.uk/t/format=webp,width=640/<sha16>.webp`.
 different bytes from the same photo.
 
 ```ts
-// ⚠️ `setCdnBase` is NOT re-exported by `@nitida/sdk` (but `setTenantId` is).
+// ✅ Both `setCdnBase` and `setTenantId` ARE re-exported by `@nitida/sdk`
+// and `@nitida/sdk/server` (measured 2026-08-24 on 0.31.0). An older note here
+// said `setCdnBase` was not — it is.
 import { setCdnBase, type TransformWidth } from "@nitida/asset-client";
 import { getTransformSrcSet, getTransformUrl } from "@nitida/sdk";
 
@@ -517,7 +519,7 @@ That replaces the older hand-run provisioning scripts and SQL that used to live
 | Poster | `getAssetUrl({sha}, 'poster')` | `/<tid b36>/v/<sha>-p.webp` |
 | Sha from URL | `extractAssetSha(url)` | — |
 
-Variant preset short codes: `thumb=q, sm=s, md=m, lg=l, xl=x, original=o, poster=p, video=v`. Exts: images `webp`, video `mp4`.
+Variant preset short codes — **all of them**: `thumb=q, sm=s, md=m, lg=l, xl=x, original=o, poster=p, video=v, aiproxy=a, hls=h, mp3=mp3`. ⚠️ `mp3` is the one irregular case: three characters, not one. Exts: images `webp`, video `mp4`.
 
 
 ## Private assets — `visibility`