@nodaro/sdk 2.22.0 → 2.24.0

package/dist/index.cjs

@@ -1027,10 +1027,14 @@ var CharactersResource = class {
   /**
    * Fetch a single character including in-flight portrait / asset job state.
    * Soft-deleted (archived) rows are returned by id intentionally so canvas
-   * nodes that hold a stale `characterDbId` keep loading.
+   * nodes that hold a stale `characterDbId` keep loading. Pass
+   * `{ candidates: "all" }` to also get the current portrait's own take in
+   * `previousCandidates` (flagged `isPortrait: true`).
    */
-  get(id) {
-    return this.client.request("GET", `/v1/characters/${encodeURIComponent(id)}`);
+  get(id, options = {}) {
+    const query = {};
+    if (options.candidates) query.candidates = options.candidates;
+    return this.client.request("GET", `/v1/characters/${encodeURIComponent(id)}`, { query });
   }
   /**
    * Create or update a character. Omit `id` to create; supply it to update
@@ -1101,8 +1105,8 @@ var CharactersResource = class {
    * is enqueued — mid-batch failures roll back atomically.
    *
    * When `attachToCharacterId` is set, the worker writes the result directly
-   * to the row's `source_image_url`; otherwise you must call
-   * `approvePortrait()` after picking a candidate.
+   * to the row's `source_image_url` (unless `attachPortrait: false`);
+   * otherwise you must call `approvePortrait()` after picking a candidate.
    */
   generate(input) {
     return this.client.request("POST", "/v1/generate-character", { body: input });
@@ -2425,6 +2429,32 @@ var MediaResource = class {
   videoOverlay(input) {
     return this.client.request("POST", "/v1/video-overlay", { body: input });
   }
+  /**
+   * Track a subject described in plain text through a video and get a
+   * black-and-white MASK VIDEO back (`POST /v1/video-mask`, SAM 3.1 by default,
+   * or `provider: "sam-3"` at half the price) — white = the subject. Clips up
+   * to 5 minutes at 30 fps (a faster clip counts
+   * proportionally longer), priced by the clip's length. Poll
+   * `jobs.get(jobId)`: the output carries `videoUrl` (the mask), `width`,
+   * `height`, `frames` and `coverage` (the fraction of pixels selected). Feed
+   * the mask to {@link MediaResource.maskComposite}.
+   */
+  videoMask(input) {
+    return this.client.request("POST", "/v1/video-mask", { body: input });
+  }
+  /**
+   * Place a foreground video over a background video through a mask video
+   * (`POST /v1/mask-composite`; white = foreground) — local FFmpeg, no AI.
+   * The result follows the foreground's size, frame rate and length; the
+   * background is fitted (`backgroundFit`, default cover) and loops when
+   * shorter; the mask holds its last frame when shorter. Optional
+   * `invertMask`, `feather` (0–20 px), `grow` (−10–10 px) and `audioSource`
+   * (foreground / background / mix / none). Priced per started 5 seconds of
+   * the result (foreground up to 300 s). Poll `jobs.get(jobId)` for `videoUrl`.
+   */
+  maskComposite(input) {
+    return this.client.request("POST", "/v1/mask-composite", { body: input });
+  }
   /**
    * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
    * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
@@ -2496,6 +2526,16 @@ var AudioResource = class {
   adjustVolume(input) {
     return this.client.request("POST", "/v1/adjust-volume", { body: input });
   }
+  /**
+   * Shift pitch and/or change tempo with Rubber Band (`POST /v1/pitch-tempo`):
+   * `semitones` −12…+12 (default 0), `tempo` 0.5…2 with the pitch kept
+   * (default 1; fixed at 1 for a video), `preserveFormants` (default true).
+   * Provide exactly one of `audioUrl` or `videoUrl` — a video keeps its picture.
+   * Input up to 30 minutes, priced per started minute.
+   */
+  pitchTempo(input) {
+    return this.client.request("POST", "/v1/pitch-tempo", { body: input });
+  }
   /**
    * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each
    * segment is a `url` with an optional `[startTime, endTime]` sub-range.
@@ -4014,7 +4054,7 @@ var EditResource = class {
     return shared.remapTranscriptThroughEdl(edl, transcript);
   }
 };
-var SDK_VERSION = "2.22.0" ;
+var SDK_VERSION = "2.24.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {