@nodaro/sdk 2.6.0 → 2.8.0

package/dist/index.cjs

@@ -2173,6 +2173,31 @@ var MediaResource = class {
   imageOverlay(input) {
     return this.client.request("POST", "/v1/image-overlay", { body: input });
   }
+  /**
+   * Ask a vision model WHERE one overlay layer should sit on a base image
+   * (`POST /v1/image-overlay/suggest-placement`) — it reads the picture and
+   * keeps the element off the faces, the subject and the busiest texture.
+   * The answer comes back in {@link MediaResource.imageOverlay}'s own percent
+   * units — `anchor`, `x`/`y` offsets, `width` — so it drops straight onto a
+   * layer (`const { reason, ...box } = placement`), plus a one-sentence
+   * `reason` you can show a user. Nothing is composited here: apply the
+   * placement yourself.
+   *
+   * `layerAspect` is the element's width / height (1 = square, the default) so
+   * the proposed box stays in proportion; `intent` says what the element is
+   * ("a logo", "a price badge"); `safeArea` is the always-visible region as
+   * fractions of the canvas (a platform preset's safe area), which the
+   * placement is kept inside. Unlike the other media calls this one answers
+   * synchronously — there is nothing to poll; `jobId` is the billing record
+   * (one image-to-text call).
+   */
+  suggestOverlayPlacement(input) {
+    return this.client.request(
+      "POST",
+      "/v1/image-overlay/suggest-placement",
+      { body: input }
+    );
+  }
   /**
    * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever
    * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or
@@ -3372,7 +3397,7 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
-var SDK_VERSION = "2.6.0" ;
+var SDK_VERSION = "2.8.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {