@nitida/sdk 0.24.0 → 0.25.0

package/dist/web.d.ts

@@ -17,7 +17,7 @@ export { AssetDTO, AssetVariant, ResolveSlotOptions, SignedTransformOptions, Slo
  *     // Point at your BFF route — the SDK calls
  *     // `${endpoint}/assets/by-hash/...`, `${endpoint}/slots/...`, etc.
  *     endpoint:   "/api/am",          // relative ⇒ same-origin proxy
- *     tenantCode: "realtyone-cr",
+ *     tenantCode: "acme-co",
  *     tenantId:   1,
  *     // NO apiKey — the type strips it. Your BFF injects the bearer.
  *   });
@@ -32,7 +32,7 @@ export { AssetDTO, AssetVariant, ResolveSlotOptions, SignedTransformOptions, Slo
  *     return fetch(url, {
  *       headers: {
  *         Authorization: `Bearer ${process.env.AQUIENPZ_API_KEY!}`,
- *         "X-Tenant-Code": "realtyone-cr",
+ *         "X-Tenant-Code": "acme-co",
  *       },
  *     });
  *   }
@@ -66,7 +66,7 @@ export { AssetDTO, AssetVariant, ResolveSlotOptions, SignedTransformOptions, Slo
  *
  *   const aq = new NitidaClient({
  *     endpoint:   "/api/am",          // OK: relative → same-origin BFF
- *     tenantCode: "realtyone-cr",
+ *     tenantCode: "acme-co",
  *     tenantId:   1,
  *     // apiKey:  "amk_rt_...",       // ERROR: TS error: not assignable
  *   });
@@ -87,17 +87,16 @@ declare class NitidaClient extends NitidaClient$1 {
 type CompressStage = "convertingHeic" | "compressing" | "compressingKeepingDimensions";
 /**
  * Subset of compressorjs options exposed by the SDK. Matches the
- * webapp's `DEFAULT_COMPRESSION_OPTIONS` shape from the realtyone-cr
- * production back-office uploader.
+ * `DEFAULT_COMPRESSION_OPTIONS` shape below.
  */
 type CompressOptions = {
-    /** 0..1. Default 0.80 (`LISTING_STANDARD_IMAGE_QUALITY / 100`). */
+    /** 0..1. Default 0.80. */
     quality?: number;
-    /** Output format. Default `"image/webp"` (`DEFAULT_IMAGE_TARGET_FORMAT`). */
+    /** Output format. Default `"image/webp"`. */
     mimeType?: "image/jpeg" | "image/webp";
-    /** Max edge in pixels. Default 3840 (`LISTING_STANDARD_IMAGE_WIDTH`). */
+    /** Max edge in pixels. Default 3840. */
     maxWidth?: number;
-    /** Default 3840 (`LISTING_STANDARD_IMAGE_HEIGHT`). */
+    /** Max edge in pixels. Default 3840. */
     maxHeight?: number;
     /**
      * compressorjs `convertSize`: PNG > this byte count auto-converts to
@@ -117,9 +116,9 @@ type CompressOptions = {
     onProgress?: (stage: CompressStage) => void;
 };
 /**
- * Webapp-tuned defaults (LISTING_STANDARD_*). These intentionally differ
- * from `@nitida/asset-compressor-web`'s package-level defaults — the
- * SDK overrides at call time.
+ * Defaults tuned against a production photo-upload workload. These
+ * intentionally differ from `@nitida/asset-compressor-web`'s
+ * package-level defaults — the SDK overrides at call time.
  */
 declare const DEFAULT_COMPRESSION_OPTIONS: Required<Omit<CompressOptions, "keepOriginalDimensions" | "convertHeic" | "onProgress">>;
 type CompressResult = {

package/dist/web.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: {