@nitida/sdk 0.24.0 → 0.25.0

package/AGENTS.md

@@ -3,7 +3,7 @@
 **Read `skills/nitida-sdk/SKILL.md` in this package first.** It is the canonical guide and it
 ships inside the tarball, so it is already on disk in `node_modules/@nitida/sdk/skills/`. It
 carries the things that cost real incidents to learn — the base36 tenant prefix, the width ladder,
-the `original`-preset trap, the R2 CORS boundary — not just the API shape.
+the `original`-preset trap, the object-storage CORS boundary — not just the API shape.
 
 **Then read `src/`.** This package publishes its TypeScript sources (`files: ["dist/**", "src/**"]`),
 so the source *is* the reference: every public method carries TSDoc, and the ones worth copying
@@ -13,12 +13,12 @@ recalling an API from training data — this SDK moves.
 ## The five-minute version
 
 ```ts
-import { AquienpzClient } from "@nitida/sdk/server";   // uploads: server-only, holds the amk_rt_* key
+import { NitidaClient } from "@nitida/sdk/server";   // uploads: server-only, holds the amk_rt_* key
 import { getTransformUrl, setCdnBase, setTenantId } from "@nitida/asset-client"; // URLs: anywhere
 ```
 
 - **Uploading** → `aq.upload(file, { fileName, contentType, presets })`. One call does compress →
-  sha256 → presign → direct-to-R2 PUT → `/assets/process` → wait-until-ready.
+  sha256 → presign → direct-to-storage PUT → `/assets/process` → wait-until-ready.
 - **Image URLs** → `getTransformUrl({ sha }, { format: "webp", width })`. The width MUST be on
   `TRANSFORM_WIDTHS` or the edge answers **400**.
 - **Video URLs** → `getAssetUrl({ sha }, "video")` after `setTenantId(id)`. The path segment is
@@ -30,14 +30,15 @@ import { getTransformUrl, setCdnBase, setTenantId } from "@nitida/asset-client";
    `["thumb"]` and the bytes you PUT are *not* retrievable. A variant not requested at the FIRST
    ingest cannot be added later once the cleanup job reaps `raw/`.
 2. **The `amk_rt_*` key is server-only.** The browser talks to *your* route; your server talks to
-   aquienpz. A runtime key in a client bundle is a write key to a paid platform.
-3. **The PUT goes browser → R2 directly, so R2 answers the CORS preflight.** An origin missing from
-   the bucket policy cannot be fixed in this SDK, in your app, or in `storefront_origins`. Symptom:
-   `R2 PUT failed: network error` with every earlier step green.
+   the platform. A runtime key in a client bundle is a write key to a paid platform.
+3. **The PUT goes browser → object storage directly, so the STORAGE BUCKET answers the CORS
+   preflight.** An origin missing from the bucket policy cannot be fixed in this SDK, in your app,
+   or by the API's allowed-origins setting — ask us to add it. Symptom: the direct PUT fails with a
+   bare network error while every earlier step is green.
 4. **Video is not image.** `/assets/process` filters video presets to
    `{poster, video, aiproxy, probe}` — `original` is silently dropped — and a video finalizes
-   ASYNCHRONOUSLY: the call answers `{ assetId, status: "processing" }` and a Cloud Run Job flips it
-   to `ready` 1–2 min later, so `processAndWait` needs a `timeoutMs` of at least `300_000`.
+   ASYNCHRONOUSLY: the call answers `{ assetId, status: "processing" }` and a background job flips
+   it to `ready` 1–2 min later, so `processAndWait` needs a `timeoutMs` of at least `300_000`.
 
 ## Related packages