@nitida/sdk 0.24.0 → 0.25.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ResolveSlotOptions, SlotResolution, SlotDTO, VariantPreset, AssetDTO, AssetVariant, TransformOptions, SignedTransformOptions } from '@nitida/asset-client';
-export { AssetDTO, AssetVariant, ResolveSlotOptions, SignedTransformOptions, SlotDTO, SlotResolution, TransformEffect, TransformFit, TransformFormat, TransformGravity, TransformOptions, VariantPreset, computeVariantDimensions, extractAssetSha, getAssetDimensions, getAssetSrcSet, getAssetUrl, getHlsStreamingUrl, getSignedTransformUrl, getTenantId, getTransformSrcSet, getTransformUrl, getVideoTransformUrl, hasPreset, serializeTransform, setTenantId, signTransformUrl } from '@nitida/asset-client';
+export { AssetDTO, AssetPalette, AssetVariant, HlsRung, PRESET_EXT, PRESET_LONG, PRESET_MAX_DIM, PRESET_SHORT, PaletteSwatch, ResolveSlotOptions, SignedTransformOptions, SlotDTO, SlotResolution, TRANSFORM_WIDTHS, TransformEffect, TransformFit, TransformFormat, TransformGravity, TransformOptions, TransformWidth, VariantPreset, bestTextContrast, computeVariantDimensions, configureSlotResolver, contrastRatio, extractAssetSha, getAmbientGradient, getAssetDimensions, getAssetSrcSet, getAssetUrl, getCdnBase, getHlsLadder, getHlsStreamingUrl, getPaletteBlurBackground, getPaletteCssVars, getSignedTransformUrl, getTenantId, getTextColorForBackground, getTransformSrcSet, getTransformUrl, getVideoTransformUrl, hasPreset, hlsLadderAlignment, invalidateSlotCache, iteratePaletteSwatches, pickAmbientBackground, relativeLuminance, resolveSlot, resolveSlots, serializeTransform, setCdnBase, setTenantId, signTransformUrl } from '@nitida/asset-client';
 
 /**
  * @nitida/sdk — universal client for the aquienpz multi-tenant asset
@@ -7,8 +7,8 @@ export { AssetDTO, AssetVariant, ResolveSlotOptions, SignedTransformOptions, Slo
  *
  * One ergonomic facade over the underlying packages
  * (`@nitida/asset-client` URL builders + `@aquienpz/asset-uploader-web`
- * + the slot resolver). Auth is a Better Auth API key (`amk_rt_*`)
- * issued by aquienpz `bootstrap-project.ts`; tenant scope comes from
+ * + the slot resolver). Auth is a bearer API key (`amk_rt_*`), issued
+ * per tenant when the tenant is created; tenant scope comes from
  * the key's metadata (`X-Tenant-Code` is log-only).
  *
  * Usage:
@@ -17,8 +17,8 @@ export { AssetDTO, AssetVariant, ResolveSlotOptions, SignedTransformOptions, Slo
  *
  *   const aq = new NitidaClient({
  *     endpoint: "https://api.nitida.gofuture.space",
- *     apiKey:   process.env.ASSET_MANAGER_RUNTIME_KEY!,
- *     tenantCode: "realtyone-cr",
+ *     apiKey:   process.env.AQUIENPZ_API_KEY!,   // amk_rt_* — server-only
+ *     tenantCode: "acme-co",
  *     cdnBase: "https://8ok.uk",  // optional override
  *     tenantId: 4,                 // required for tenant-prefixed URLs
  *   });
@@ -52,7 +52,7 @@ export { AssetDTO, AssetVariant, ResolveSlotOptions, SignedTransformOptions, Slo
  */
 type NitidaClientOptions = {
     /**
-     * Base URL of the aquienpz asset-manager (Cloud Run service URL).
+     * Base URL of the nitida API (e.g. `https://api.nitida.gofuture.space`).
      *
      * May be relative (e.g. `/api/am`) ONLY in browser contexts where the
      * SDK resolves it against `window.location.origin`. Node/Bun consumers
@@ -60,7 +60,7 @@ type NitidaClientOptions = {
      */
     endpoint: string;
     /**
-     * Better Auth API key with the `amk_rt_*` prefix.
+     * Bearer API key with the `amk_rt_*` prefix.
      *
      * **Server-only.** Omit when constructing from `@nitida/sdk/web` —
      * your BFF / route handler injects the bearer header in proxy mode.
@@ -85,8 +85,8 @@ type NitidaClientOptions = {
      * Tenant's HMAC signing key for transform URLs (Phase 3). Required
      * only when calling `aq.transform(asset, opts, { sign: true })`.
      *
-     * Generated server-side per tenant (see `infra/sql/tenants_signed_transforms.sql`);
-     * fetch via `GET /admin/tenants/:id` with an admin key. **Keep it
+     * 32 random bytes, generated server-side on tenant creation; fetch
+     * via `GET /admin/tenants/:id` with an admin key. **Keep it
      * server-side only** — do not ship in `NEXT_PUBLIC_*` env vars. Sign
      * URLs from a BFF route handler, or pre-sign at build time.
      */
@@ -150,8 +150,8 @@ declare class SlotsApi {
 /**
  * Returned by `aq.assets.regenerate(...)`. The shape varies by kind —
  * images return immediately with the merged variant list; videos
- * return a dispatch handle (the actual transcode runs in a Cloud Run
- * Job and finishes async).
+ * return a dispatch handle (the actual transcode runs in a background
+ * job and finishes async).
  */
 type RegenerateResult = {
     ok: true;
@@ -182,7 +182,7 @@ type RegenerateResult = {
 /**
  * Wire shape returned by `POST /assets/upload-url`. Either the server
  * resolves the upload synchronously via dedup (`deduped: true` + existing
- * asset DTO) or it returns a presigned R2 PUT URL plus a `process` payload
+ * asset DTO) or it returns a presigned storage PUT URL plus a `process` payload
  * the caller must POST to `/assets/process` after the PUT lands.
  */
 type UploadUrlResult = {
@@ -208,13 +208,13 @@ type UploadVideoOptions = {
     /**
      * `false` → skip the auto-dispatched HLS adaptive ladder (240p–2160p). Use
      * for download-only assets served as a progressive `-v.mp4` and never
-     * streamed (e.g. share-video reels) — it avoids a second Cloud Run Job no
+     * streamed (e.g. share-video reels) — it avoids a second background job no
      * one watches. Default/absent → the ladder is generated as before.
      */
     hls?: boolean;
     /**
      * `true` → when the uploaded MP4 is ALREADY web-safe (H.264 + yuv420p),
-     * re-mux the `video` variant with `-c copy` instead of re-encoding. Use for
+     * re-mux the `video` variant instead of re-encoding it. Use for
      * delivery-ready uploads (the bytes are already H.264 High / yuv420p /
      * +faststart / capped bitrate) to skip a wasteful re-encode + generational
      * quality loss. Falls back to a full re-encode automatically when the source
@@ -224,7 +224,7 @@ type UploadVideoOptions = {
 };
 /** Input shape accepted by `aq.assets.presignUploadUrl(...)`. */
 type PresignUploadUrlOptions = {
-    /** Full sha256 (64 hex) of the bytes that will be PUT to R2. */
+    /** Full sha256 (64 hex) of the bytes that will be PUT to storage. */
     sha256: string;
     /** MIME type of the bytes (e.g. `image/jpeg`, `video/mp4`). */
     mime: string;
@@ -239,8 +239,8 @@ type PresignUploadUrlOptions = {
     presets?: VariantPreset[];
     /**
      * Pre-compression size of the source (useful when the browser ran
-     * compressorjs / heic2any before computing `bytes`). Surfaces in admin
-     * dashboards under `assets.client_original_bytes`.
+     * compressorjs / heic2any before computing `bytes`). Recorded
+     * server-side, so the savings show up in the admin usage dashboards.
      */
     clientOriginalBytes?: number;
     /** VIDEO-only delivery knobs forwarded into `/assets/process`. See {@link UploadVideoOptions}. */
@@ -318,8 +318,8 @@ declare class AssetsApi {
      *   const v = await aq.assets.variants(logoId);
      *   v.map((x) => x.preset);  // → ("thumb" | "sm" | … | "original")[]
      *
-     * ⚠️ Returns `[]` — not an error — against an `asset-manager` older than the
-     * 2026-08-17 deploy, which never sent the field (doc 240 §4.3). An empty
+     * ⚠️ Returns `[]` — not an error — against a server older than the
+     * 2026-08-17 release, which never sent the field at all. An empty
      * array is therefore "no variants OR old server". For a plain existence
      * check prefer `hasPreset(dto, preset)` on `dto.presets`, which every server
      * version sends; use this when you need the URLs and sizes.
@@ -342,12 +342,13 @@ declare class AssetsApi {
      * Passing no presets re-runs the FULL default pipeline for that
      * asset's kind (thumb+sm+md+lg for images, poster+video for video).
      *
-     * If the asset was uploaded original-only and the cleanup job has
-     * already reaped `raw/`, the route falls back to reading the source
-     * bytes from `variants/o.<ext>` — no need to re-upload.
+     * If the asset was uploaded original-only and the ~24 h grace window
+     * on the uploaded bytes has already closed, the route falls back to
+     * reading the source bytes from the permanent `original` variant —
+     * no need to re-upload.
      *
      * Video presets are filtered to `["poster","video","aiproxy"]` and
-     * dispatched to the Cloud Run Job (the call returns immediately
+     * dispatched to a background job (the call returns immediately
      * with a dispatch handle; poll `aq.assets.get(id).status` for
      * completion).
      */
@@ -360,13 +361,13 @@ declare class AssetsApi {
         metadata: Record<string, unknown>;
     }>;
     /**
-     * Request a presigned R2 PUT URL for direct browser-side uploads.
+     * Request a presigned storage PUT URL for direct browser-side uploads.
      *
      * Mirrors the first half of `aq.upload()` — the caller (typically a
      * BFF / share-link dropzone) computes sha256 in the browser, then
-     * uploads bytes straight to R2 with the returned `upload.url`, then
-     * POSTs `process.body` to `/assets/process` (see {@link processAndWait})
-     * once R2 has the bytes.
+     * uploads bytes straight to object storage with the returned `upload.url`,
+     * then POSTs `process.body` to `/assets/process` (see {@link processAndWait})
+     * once storage has the bytes.
      *
      * If the sha is already known to the tenant the server short-circuits
      * with `{ deduped: true, asset }` — no PUT needed.
@@ -378,16 +379,16 @@ declare class AssetsApi {
      * if (presign.deduped) return presign.asset;      // those bytes already exist; none fly
      *
      * // BROWSER: PUT straight to presign.upload.url — the bytes never touch your server.
-     * // ⚠️ R2 answers that preflight ITSELF, so your origin must be in the BUCKET's CORS policy.
-     * //    Symptom when it is not: "PUT failed: network error" with every earlier step green —
-     * //    and it cannot be fixed in this SDK, in your app, or in `storefront_origins`.
+     * // ⚠️ The STORAGE BUCKET answers that preflight itself, so your origin must be in its CORS
+     * //    policy. Symptom when it is not: "PUT failed: network error" with every earlier step
+     * //    green — and it cannot be fixed in this SDK, in your app, or by the API's allowed origins.
      *
      * // SERVER again, forwarding presign.process.body VERBATIM:
      * const asset = await aq.assets.processAndWait(presign.process.body, { timeoutMs: 300_000 });
      * ```
      *
      * Works for images AND video. A video answers immediately with
-     * `{ assetId, status: "processing" }` while a Cloud Run Job transcodes, so
+     * `{ assetId, status: "processing" }` while a background job transcodes, so
      * give `processAndWait` a bigger `timeoutMs` (a transcode + HLS ladder runs
      * 1–2 min; 300_000 is a sane floor).
      */
@@ -397,7 +398,7 @@ declare class AssetsApi {
      * {@link presignUploadUrl} call, then poll until the asset transitions
      * to `ready` or `failed`. Throws on `failed` or timeout.
      *
-     * Use this when bytes were uploaded directly from the browser to R2 —
+     * Use this when bytes were uploaded directly from the browser to storage —
      * `aq.upload()` already does presign + PUT + process + wait in one
      * step when the server holds the bytes.
      */
@@ -420,7 +421,7 @@ declare class AssetsApi {
      * {@link waitReady} (typical timeout: 10 min for multi-segment kits).
      *
      * Tenant scope is inherited from the SDK client; `tenantCode` is added
-     * to the request body so the Cloud Run Job can resolve it without
+     * to the request body so the background job can resolve it without
      * re-reading the header.
      */
     composeMarketing(opts: ComposeMarketingOptions): Promise<ComposeMarketingResult>;
@@ -451,7 +452,7 @@ type UploadOptions = {
      * MIME type of the bytes. **Only needed for a `Uint8Array` input** — a `File`/`Blob`
      * already carries its `.type`. Raw bytes have no inherent MIME, so without this (and
      * without an extension on `fileName` to infer from) they upload as
-     * `application/octet-stream`, which the asset-manager classifies as `kind:"other"` —
+     * `application/octet-stream`, which the server classifies as `kind:"other"` —
      * meaning NO image/video variants are generated and `regenerate()` is unsupported.
      * Resolution order for the effective MIME: `Blob.type` → `contentType` →
      * inferred from `fileName`'s extension → `application/octet-stream`.
@@ -509,8 +510,8 @@ type UploadOptions = {
     /**
      * Max time to wait for the asset to transition to `ready` (or `failed`)
      * after dispatch. Default `5 * 60_000` (5 min). Bump higher for large
-     * videos / HLS transcodes — aquienpz processing time scales with input
-     * size and per-instance CPU.
+     * videos / HLS transcodes — processing time scales with input size,
+     * and with how much other work the platform is doing at that moment.
      *
      * Throws `Error("waitReady timeout for <id>")` if the deadline passes
      * without the asset transitioning. The asset row stays in aquienpz
@@ -567,8 +568,35 @@ type UsageWindow = {
     admins: number;
     upscales: number;
     processes: number;
-    bytesIn: number;
+    /**
+     * Minutes of video actually TRANSCODED in the window — source minutes ×
+     * encode passes, so a 7-rung HLS ladder over a 2-minute clip books 14.
+     *
+     * A re-encode of a video already ingested counts AGAIN. That is the point:
+     * an asset count cannot report it, because re-encoding an asset that already
+     * exists creates no new asset.
+     *
+     * A stream copy (`video: { passthrough: true }`, or an idempotent cache skip)
+     * books nothing, so a tenant that ran no encoder reads `0` — and that `0` is real.
+     */
+    videoMinutes: number;
+    /** Encode passes behind `videoMinutes`. 0 when nothing was encoded. */
+    videoEncodes: number;
 };
+/**
+ * ⚠️ REMOVED 2026-08-17: `bytesIn` on `UsageWindow`/`UsageDailyPoint` and
+ * `bytesTotal` on `UsagePerKey`.
+ *
+ * All three were structurally zero: the field behind them was never populated,
+ * on any row. They could not be instrumented in place either — uploads go to
+ * object storage through presigned URLs, so the payload never passes through
+ * the API, and the only figure measurable there is a JSON envelope of a few
+ * hundred bytes.
+ *
+ * A field that always reads `0` is worse than an absent field, because absent
+ * is honest — a `0` next to a real `storage.totalBytes` reads as a measurement.
+ * The byte number that IS true is still served: `storage.totalBytes`.
+ */
 type UsageDailyPoint = {
     date: string;
     reads: number;
@@ -576,15 +604,16 @@ type UsageDailyPoint = {
     lists: number;
     deletes: number;
     processes: number;
-    bytesIn: number;
     bytesStored: number;
+    /** See `UsageWindow.videoMinutes`. Minutes transcoded on this day. */
+    videoMinutes: number;
+    videoEncodes: number;
 };
 type UsagePerKey = {
     apiKeyId: string;
     prefix: string | null;
     name: string | null;
     opsTotal: number;
-    bytesTotal: number;
     lastSeen: string;
 };
 declare class UsageApi {
@@ -644,7 +673,7 @@ declare class NitidaClient {
      * Returns the canonical `lg` variant URL when called with empty options,
      * so callers can swap `urlFor()` for `transform()` without thinking.
      *
-     * URLs with the same params in different order produce the same R2
+     * URLs with the same params in different order produce the same
      * cache entry (the server canonicalizes both sides). Safe to use as
      * stable cache keys.
      *
@@ -675,12 +704,12 @@ declare class NitidaClient {
      * Build an on-the-fly VIDEO transform URL — Phase 4.
      *
      * Same DSL shape as `transform()` but the URL has a `.mp4` (default)
-     * or `.webm` extension and the server routes the request to a Cloud
-     * Run Job for ffmpeg encoding (vs the inline sharp pipeline for
+     * or `.webm` extension and the server routes the request to a
+     * background job for video encoding (vs the inline pipeline for
      * images).
      *
      * On the first request the route returns **202 Accepted** with
-     * `Retry-After: 10` while the Job runs (typically 5-30 s for a
+     * `Retry-After: 10` while the encode runs (typically 5-30 s for a
      * short clip). The response body includes `outputUrl` which is the
      * eventual CDN URL — poll the same transform URL after the
      * retry-after window to get a 302 redirect to it.
@@ -716,7 +745,7 @@ declare class NitidaClient {
      *   />
      *
      * On the first request the server returns **202 Accepted** while a
-     * Cloud Run Job builds the multi-rung ladder (typically 1-3 min for
+     * background job builds the multi-rung ladder (typically 1-3 min for
      * a 90 s source — five rungs of 240p/360p/480p/720p/1080p @ AAC).
      * Subsequent requests hit the cache → **302** to the master.m3u8.
      *
@@ -735,13 +764,13 @@ declare class NitidaClient {
      * but isn't always available depending on the runtime).
      */
     /**
-     * Upload bytes end to end: optional client compression → sha256 → presign → **direct-to-R2 PUT**
+     * Upload bytes end to end: optional client compression → sha256 → presign → **direct-to-storage PUT**
      * → `/assets/process` → wait until the asset is ready.
      *
      * ⚠️ `presets` decides what exists FOREVER. Omit it and only `original` is written; ask for
      * `["thumb"]` and the bytes you just uploaded are **not retrievable**. A variant not requested in
-     * this first ingest cannot be added later once the cleanup job reaps `raw/` — measured once as
-     * "97 files archived successfully, zero recoverable".
+     * this first ingest cannot be added later once the ~24 h grace window on the uploaded bytes
+     * closes — measured once as "97 files archived successfully, zero recoverable".
      *
      * @example Deliver an image on a site (the responsive ladder)
      * ```ts
@@ -772,11 +801,11 @@ declare class NitidaClient {
      * @example Video — and what does NOT work there
      * ```ts
      * // `original` is accepted and then silently DROPPED: /assets/process filters video presets to
-     * // {poster, video, aiproxy, probe} before dispatching the transcode Job.
+     * // {poster, video, aiproxy, probe} before dispatching the background transcode.
      * await aq.upload(clip, { fileName: "tour.mp4", presets: ["poster", "video"] });
      *
-     * // Omit `aiproxy`/`probe` unless the asset really goes to a vision model — they cost Job time
-     * // and permanent R2 objects that nothing else reads.
+     * // Omit `aiproxy`/`probe` unless the asset really goes to a vision model — they cost encode
+     * // time and permanent stored objects that nothing else reads.
      * ```
      */
     upload(input: File | Blob | Uint8Array, opts?: UploadOptions): Promise<UploadResult>;

package/dist/index.js

@@ -16,21 +16,43 @@ import {
   setTenantId
 } from "@nitida/asset-client";
 import {
+  bestTextContrast,
   computeVariantDimensions,
+  configureSlotResolver as configureSlotResolver2,
+  contrastRatio,
   extractAssetSha,
+  getAmbientGradient,
   getAssetDimensions,
   getAssetSrcSet as getAssetSrcSet2,
   getAssetUrl as getAssetUrl2,
+  getCdnBase,
+  getHlsLadder,
   getHlsStreamingUrl as getHlsStreamingUrl2,
+  getPaletteBlurBackground,
+  getPaletteCssVars,
   getSignedTransformUrl as getSignedTransformUrl2,
   getTenantId,
+  getTextColorForBackground,
   getTransformSrcSet as getTransformSrcSet2,
   getTransformUrl as getTransformUrl2,
   getVideoTransformUrl as getVideoTransformUrl2,
   hasPreset as hasPreset2,
+  hlsLadderAlignment,
+  invalidateSlotCache as invalidateSlotCache2,
+  iteratePaletteSwatches,
+  PRESET_EXT,
+  PRESET_LONG,
+  PRESET_MAX_DIM,
+  PRESET_SHORT,
+  pickAmbientBackground,
+  relativeLuminance,
+  resolveSlot as resolveSlot2,
+  resolveSlots as resolveSlots2,
   serializeTransform,
+  setCdnBase as setCdnBase2,
   setTenantId as setTenantId2,
-  signTransformUrl
+  signTransformUrl,
+  TRANSFORM_WIDTHS
 } from "@nitida/asset-client";
 function endpointUrl(opts, path, searchParams) {
   const endpoint = opts.endpoint.replace(/\/+$/, "");
@@ -223,8 +245,8 @@ var AssetsApi = class {
    *   const v = await aq.assets.variants(logoId);
    *   v.map((x) => x.preset);  // → ("thumb" | "sm" | … | "original")[]
    *
-   * ⚠️ Returns `[]` — not an error — against an `asset-manager` older than the
-   * 2026-08-17 deploy, which never sent the field (doc 240 §4.3). An empty
+   * ⚠️ Returns `[]` — not an error — against a server older than the
+   * 2026-08-17 release, which never sent the field at all. An empty
    * array is therefore "no variants OR old server". For a plain existence
    * check prefer `hasPreset(dto, preset)` on `dto.presets`, which every server
    * version sends; use this when you need the URLs and sizes.
@@ -250,12 +272,13 @@ var AssetsApi = class {
    * Passing no presets re-runs the FULL default pipeline for that
    * asset's kind (thumb+sm+md+lg for images, poster+video for video).
    *
-   * If the asset was uploaded original-only and the cleanup job has
-   * already reaped `raw/`, the route falls back to reading the source
-   * bytes from `variants/o.<ext>` — no need to re-upload.
+   * If the asset was uploaded original-only and the ~24 h grace window
+   * on the uploaded bytes has already closed, the route falls back to
+   * reading the source bytes from the permanent `original` variant —
+   * no need to re-upload.
    *
    * Video presets are filtered to `["poster","video","aiproxy"]` and
-   * dispatched to the Cloud Run Job (the call returns immediately
+   * dispatched to a background job (the call returns immediately
    * with a dispatch handle; poll `aq.assets.get(id).status` for
    * completion).
    */
@@ -283,13 +306,13 @@ var AssetsApi = class {
     return await r.json();
   }
   /**
-   * Request a presigned R2 PUT URL for direct browser-side uploads.
+   * Request a presigned storage PUT URL for direct browser-side uploads.
    *
    * Mirrors the first half of `aq.upload()` — the caller (typically a
    * BFF / share-link dropzone) computes sha256 in the browser, then
-   * uploads bytes straight to R2 with the returned `upload.url`, then
-   * POSTs `process.body` to `/assets/process` (see {@link processAndWait})
-   * once R2 has the bytes.
+   * uploads bytes straight to object storage with the returned `upload.url`,
+   * then POSTs `process.body` to `/assets/process` (see {@link processAndWait})
+   * once storage has the bytes.
    *
    * If the sha is already known to the tenant the server short-circuits
    * with `{ deduped: true, asset }` — no PUT needed.
@@ -301,16 +324,16 @@ var AssetsApi = class {
    * if (presign.deduped) return presign.asset;      // those bytes already exist; none fly
    *
    * // BROWSER: PUT straight to presign.upload.url — the bytes never touch your server.
-   * // ⚠️ R2 answers that preflight ITSELF, so your origin must be in the BUCKET's CORS policy.
-   * //    Symptom when it is not: "PUT failed: network error" with every earlier step green —
-   * //    and it cannot be fixed in this SDK, in your app, or in `storefront_origins`.
+   * // ⚠️ The STORAGE BUCKET answers that preflight itself, so your origin must be in its CORS
+   * //    policy. Symptom when it is not: "PUT failed: network error" with every earlier step
+   * //    green — and it cannot be fixed in this SDK, in your app, or by the API's allowed origins.
    *
    * // SERVER again, forwarding presign.process.body VERBATIM:
    * const asset = await aq.assets.processAndWait(presign.process.body, { timeoutMs: 300_000 });
    * ```
    *
    * Works for images AND video. A video answers immediately with
-   * `{ assetId, status: "processing" }` while a Cloud Run Job transcodes, so
+   * `{ assetId, status: "processing" }` while a background job transcodes, so
    * give `processAndWait` a bigger `timeoutMs` (a transcode + HLS ladder runs
    * 1–2 min; 300_000 is a sane floor).
    */
@@ -338,7 +361,7 @@ var AssetsApi = class {
    * {@link presignUploadUrl} call, then poll until the asset transitions
    * to `ready` or `failed`. Throws on `failed` or timeout.
    *
-   * Use this when bytes were uploaded directly from the browser to R2 —
+   * Use this when bytes were uploaded directly from the browser to storage —
    * `aq.upload()` already does presign + PUT + process + wait in one
    * step when the server holds the bytes.
    */
@@ -387,7 +410,7 @@ var AssetsApi = class {
    * {@link waitReady} (typical timeout: 10 min for multi-segment kits).
    *
    * Tenant scope is inherited from the SDK client; `tenantCode` is added
-   * to the request body so the Cloud Run Job can resolve it without
+   * to the request body so the background job can resolve it without
    * re-reading the header.
    */
   async composeMarketing(opts) {
@@ -553,12 +576,12 @@ var NitidaClient = class {
    * Build an on-the-fly VIDEO transform URL — Phase 4.
    *
    * Same DSL shape as `transform()` but the URL has a `.mp4` (default)
-   * or `.webm` extension and the server routes the request to a Cloud
-   * Run Job for ffmpeg encoding (vs the inline sharp pipeline for
+   * or `.webm` extension and the server routes the request to a
+   * background job for video encoding (vs the inline pipeline for
    * images).
    *
    * On the first request the route returns **202 Accepted** with
-   * `Retry-After: 10` while the Job runs (typically 5-30 s for a
+   * `Retry-After: 10` while the encode runs (typically 5-30 s for a
    * short clip). The response body includes `outputUrl` which is the
    * eventual CDN URL — poll the same transform URL after the
    * retry-after window to get a 302 redirect to it.
@@ -596,7 +619,7 @@ var NitidaClient = class {
    *   />
    *
    * On the first request the server returns **202 Accepted** while a
-   * Cloud Run Job builds the multi-rung ladder (typically 1-3 min for
+   * background job builds the multi-rung ladder (typically 1-3 min for
    * a 90 s source — five rungs of 240p/360p/480p/720p/1080p @ AAC).
    * Subsequent requests hit the cache → **302** to the master.m3u8.
    *
@@ -617,13 +640,13 @@ var NitidaClient = class {
    * but isn't always available depending on the runtime).
    */
   /**
-   * Upload bytes end to end: optional client compression → sha256 → presign → **direct-to-R2 PUT**
+   * Upload bytes end to end: optional client compression → sha256 → presign → **direct-to-storage PUT**
    * → `/assets/process` → wait until the asset is ready.
    *
    * ⚠️ `presets` decides what exists FOREVER. Omit it and only `original` is written; ask for
    * `["thumb"]` and the bytes you just uploaded are **not retrievable**. A variant not requested in
-   * this first ingest cannot be added later once the cleanup job reaps `raw/` — measured once as
-   * "97 files archived successfully, zero recoverable".
+   * this first ingest cannot be added later once the ~24 h grace window on the uploaded bytes
+   * closes — measured once as "97 files archived successfully, zero recoverable".
    *
    * @example Deliver an image on a site (the responsive ladder)
    * ```ts
@@ -654,11 +677,11 @@ var NitidaClient = class {
    * @example Video — and what does NOT work there
    * ```ts
    * // `original` is accepted and then silently DROPPED: /assets/process filters video presets to
-   * // {poster, video, aiproxy, probe} before dispatching the transcode Job.
+   * // {poster, video, aiproxy, probe} before dispatching the background transcode.
    * await aq.upload(clip, { fileName: "tour.mp4", presets: ["poster", "video"] });
    *
-   * // Omit `aiproxy`/`probe` unless the asset really goes to a vision model — they cost Job time
-   * // and permanent R2 objects that nothing else reads.
+   * // Omit `aiproxy`/`probe` unless the asset really goes to a vision model — they cost encode
+   * // time and permanent stored objects that nothing else reads.
    * ```
    */
   async upload(input, opts = {}) {
@@ -731,7 +754,7 @@ var NitidaClient = class {
       body: new Blob([bytes], { type: mime })
     });
     if (!putR.ok)
-      throw new Error(`R2 PUT ${putR.status}: ${await putR.text()}`);
+      throw new Error(`Storage PUT ${putR.status}: ${await putR.text()}`);
     const procR = await fetch(endpointHref(this.opts, presign.process.url), {
       method: "POST",
       headers: {
@@ -788,20 +811,42 @@ var NitidaClient = class {
 };
 export {
   NitidaClient,
+  PRESET_EXT,
+  PRESET_LONG,
+  PRESET_MAX_DIM,
+  PRESET_SHORT,
+  TRANSFORM_WIDTHS,
+  bestTextContrast,
   computeVariantDimensions,
+  configureSlotResolver2 as configureSlotResolver,
+  contrastRatio,
   extractAssetSha,
+  getAmbientGradient,
   getAssetDimensions,
   getAssetSrcSet2 as getAssetSrcSet,
   getAssetUrl2 as getAssetUrl,
+  getCdnBase,
+  getHlsLadder,
   getHlsStreamingUrl2 as getHlsStreamingUrl,
+  getPaletteBlurBackground,
+  getPaletteCssVars,
   getSignedTransformUrl2 as getSignedTransformUrl,
   getTenantId,
+  getTextColorForBackground,
   getTransformSrcSet2 as getTransformSrcSet,
   getTransformUrl2 as getTransformUrl,
   getVideoTransformUrl2 as getVideoTransformUrl,
   hasPreset2 as hasPreset,
+  hlsLadderAlignment,
+  invalidateSlotCache2 as invalidateSlotCache,
+  iteratePaletteSwatches,
   mimeFromFileName,
+  pickAmbientBackground,
+  relativeLuminance,
+  resolveSlot2 as resolveSlot,
+  resolveSlots2 as resolveSlots,
   serializeTransform,
+  setCdnBase2 as setCdnBase,
   setTenantId2 as setTenantId,
   signTransformUrl
 };