@nodaro/sdk 2.19.0 → 2.21.0

package/README.md

@@ -76,7 +76,7 @@ Core pattern (all generation is async; runAndWait submits + polls + resolves):
     auth: new StaticTokenAuth(process.env.NODARO_ACCESS_TOKEN!),
   })
   const img = await client.nodes.runAndWait("generate-image", {
-    prompt: "…", provider: "nano-banana-2",          // fast + cheap, great default
+    prompt: "…", provider: "nano-banana-2-1",        // fast + cheap, great default
   })
   const vid = await client.nodes.runAndWait("generate-video", {
     prompt: "…", imageUrl: img.imageUrl,
@@ -137,7 +137,7 @@ A proven first build (text in → video out). Paste after the primer:
 
 ```text
 Build a small web app — "animated postcard":
-  1. A prompt box. On submit: generate-image (nano-banana-2) with the prompt.
+  1. A prompt box. On submit: generate-image (nano-banana-2-1) with the prompt.
   2. Show the image IMMEDIATELY when it resolves.
   3. Then generate-video (seedance-2-fast, duration 4) with that image as
      imageUrl and prompt "subtle cinematic motion".

package/dist/index.cjs

@@ -300,6 +300,34 @@ var WorkflowsResource = class {
       { body: params }
     );
   }
+  /**
+   * Render final (`renderFinal` on `POST /v1/workflows/:id/run`): run the
+   * render at Final for this run only, and every node after it, continuing the
+   * execution that stopped at its preview. The server derives the nodes and
+   * the override — send nothing else. Quote it first with
+   * {@link estimateRenderFinal}. Refused with `render_final_node_not_found`,
+   * `render_final_not_a_render`, or a continuation code (see `run`); a run
+   * its payer cannot cover throws `InsufficientCreditsError` (with `required`
+   * and, when it is yours to see, `available`) before any execution exists.
+   */
+  renderFinal(id, params) {
+    return this.client.request("POST", `/v1/workflows/${encodeURIComponent(id)}/run`, {
+      body: {
+        renderFinal: { renderNodeId: params.renderNodeId },
+        continueFromExecutionId: params.continueFromExecutionId
+      }
+    });
+  }
+  /**
+   * Quote a Render final (`POST /v1/workflows/:id/render-final/estimate`): the
+   * nodes it will run, the override it runs with and its estimated credits.
+   * Nothing is created or charged.
+   */
+  estimateRenderFinal(id, params) {
+    return this.client.request("POST", `/v1/workflows/${encodeURIComponent(id)}/render-final/estimate`, {
+      body: { renderNodeId: params.renderNodeId, continueFromExecutionId: params.continueFromExecutionId }
+    });
+  }
   /**
    * Export a workflow as a portable JSON bundle.
    * Pass `opts.assets = true` to include character/object/location entity data.
@@ -2078,13 +2106,21 @@ var VoicesResource = class {
   }
   /**
    * Voice a multi-speaker script as ONE audio file
-   * (`POST /v1/text-to-dialogue`, ElevenLabs Dialogue v3). Each `dialogue`
-   * line is `{ text, voice }` in speaking order — `voice` is a premade voice
-   * name or an ElevenLabs voice UUID (cloned/library voices work too; mixed
-   * casts are fine). At most 5,000 characters total across lines (≤2,000
-   * recommended for best quality) and 10 unique voices. Line text may carry
-   * `[audio tags]` like `[laughs]`. Costs credits and runs async — poll
-   * `jobs.get(jobId)` for `output_data.audioUrl`.
+   * (`POST /v1/text-to-dialogue`) on ElevenLabs Dialogue v3 — the default — or
+   * Dialogue v4 (`provider: "elevenlabs-dialogue-v4"`). Each `dialogue` line is
+   * `{ text, voice }` in speaking order — `voice` is a premade voice name or an
+   * ElevenLabs voice UUID (cloned/library voices work too; mixed casts are
+   * fine). At most 5,000 characters total across lines on Dialogue v3 and
+   * 10,000 on Dialogue v4 (≤2,000 recommended for best quality) and 10 unique
+   * voices. Line text may
+   * carry `[audio tags]` like `[laughs]`. Costs credits and runs async — poll
+   * `jobs.get(jobId)` for `output_data.audioUrl` and — on every dialogue model,
+   * since both return timings at no extra credits — `output_data.transcript`, a
+   * `Transcript` (`@nodaro/shared`): `words[]` with `startMs` / `endMs` /
+   * `speaker` and one `segments[]` entry per line, `speaker` being the line's
+   * `voice` as you sent it. Pass `transcript.words` to
+   * `addCaptions({ captions, autoTranscribe: false })` to caption the dialogue
+   * without a second transcription.
    */
   textToDialogue(input) {
     return this.client.request("POST", "/v1/text-to-dialogue", { body: input });
@@ -2440,7 +2476,14 @@ var AudioResource = class {
   /**
    * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`
    * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set
-   * per-track level.
+   * per-track level. `duck` puts a music bed under speech: every track EXCEPT
+   * `duck.under` (the 0-based index of the voice track) dips while that track
+   * is loud and rises back in its pauses (sidechain compression). `amount`
+   * (0–100, default 75) is how hard; `thresholdDb` (-60–0, default -30),
+   * `ratio` (1–20, overrides `amount`), `attackMs` (1–2000, default 20) and
+   * `releaseMs` (10–9000, default 500) are optional fine controls. A ducked mix
+   * sums its tracks rather than averaging them, so the voice keeps its level;
+   * the price is the same with or without a duck.
    */
   mix(input) {
     return this.client.request("POST", "/v1/mix-audio", { body: input });
@@ -2655,6 +2698,66 @@ var SavedPostsResource = class {
   }
 };
 
+// src/resources/collections.ts
+var CollectionsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** `GET /v1/collections` → your collections with their record counts, whether the server has collections at all, and your caps. */
+  list() {
+    return this.client.request("GET", "/v1/collections");
+  }
+  /** `GET /v1/collections/:id` → one collection. */
+  get(id) {
+    return this.client.request("GET", `/v1/collections/${encodeURIComponent(id)}`);
+  }
+  /** `POST /v1/collections` → a new collection (`409 name_taken` when you have one by that name, `403 collection_limit_reached` at your cap). */
+  create(input) {
+    return this.client.request("POST", "/v1/collections", { body: input });
+  }
+  /** `PATCH /v1/collections/:id` → rename or re-describe a collection. */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/collections/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** `DELETE /v1/collections/:id` → remove a collection and every record in it. */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/collections/${encodeURIComponent(id)}`);
+  }
+  /** `GET /v1/collections/:id/records` → the records, newest first. Narrow with `q` (words) and `since` (ISO); page with `cursor` / `limit` (1-100, default 50). */
+  records(id, params = {}) {
+    return this.client.request("GET", `/v1/collections/${encodeURIComponent(id)}/records`, {
+      query: { q: params.q, since: params.since, cursor: params.cursor, limit: params.limit }
+    });
+  }
+  /**
+   * `POST /v1/collections/:id/records` → save one record. Give the fields, or
+   * `item` (any JSON — a feed post, a search result) and let the server map it;
+   * explicit fields win. `outcome` is `inserted`, `duplicate` (the same link or
+   * dedupe key is already there — the existing record comes back) or `replayed`
+   * (a write with the same `idempotencyKey` already happened).
+   */
+  addRecord(id, input, opts = {}) {
+    return this.client.request("POST", `/v1/collections/${encodeURIComponent(id)}/records`, {
+      body: input,
+      ...opts.idempotencyKey ? { headers: { "Idempotency-Key": opts.idempotencyKey } } : {}
+    });
+  }
+  /** `DELETE /v1/collections/:id/records/:recordId` → remove one record. */
+  async deleteRecord(id, recordId) {
+    await this.client.request(
+      "DELETE",
+      `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}`
+    );
+  }
+  /** `GET /v1/collections/:id/export` → the whole collection as CSV (default) or JSON text, newest first; `since` and `q` narrow it. */
+  export(id, params = {}) {
+    return this.client.requestText("GET", `/v1/collections/${encodeURIComponent(id)}/export`, {
+      query: { format: params.format, since: params.since, q: params.q }
+    });
+  }
+};
+
 // src/resources/competitors.ts
 var CompetitorsResource = class {
   constructor(client) {
@@ -2663,12 +2766,37 @@ var CompetitorsResource = class {
   client;
   /** `GET /v1/competitors` → every tracked brand. */
   async list() {
-    const res = await this.client.request("GET", "/v1/competitors");
-    return res.data;
+    const res = await this.listWithPlan();
+    return [...res.data];
   }
-  /** `GET /v1/competitors/:id` → one brand with its latest scan (posts and cards) and its scan history. */
-  get(id) {
-    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}`);
+  /** `GET /v1/competitors` → every tracked brand, with how many months of scans your plan keeps. */
+  listWithPlan() {
+    return this.client.request("GET", "/v1/competitors");
+  }
+  /**
+   * `GET /v1/competitors/:id` → one brand with its latest scan (posts and
+   * cards) and its scan history; with `scan`, the brand as of that scan.
+   */
+  get(id, options = {}) {
+    const query = options.scan ? `?scan=${encodeURIComponent(options.scan)}` : "";
+    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}${query}`);
+  }
+  /** `GET /v1/competitors/:id/history` → the brand's scans oldest first, per platform what each found and read (free). */
+  history(id) {
+    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}/history`);
+  }
+  /**
+   * `GET /v1/competitors/:id/compare` → the brand over a period, and over a
+   * second one to compare with (free). A post belongs to a period by its
+   * publish date; a period is at most a year.
+   */
+  compare(id, input) {
+    const params = new URLSearchParams({ from: input.from, to: input.to });
+    if (input.vsFrom !== void 0 && input.vsTo !== void 0) {
+      params.set("vsFrom", input.vsFrom);
+      params.set("vsTo", input.vsTo);
+    }
+    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}/compare?${params.toString()}`);
   }
   /** `POST /v1/competitors` → track a brand. Accounts take handles or links. */
   create(input) {
@@ -3761,6 +3889,8 @@ var EditResource = class {
         ...input.output !== void 0 ? { output: input.output } : {},
         ...input.quality !== void 0 ? { quality: input.quality } : {},
         ...input.crossfadeMs !== void 0 ? { crossfadeMs: input.crossfadeMs } : {},
+        ...input.clipKey !== void 0 ? { clipKey: input.clipKey } : {},
+        ...input.planBasis !== void 0 ? { planBasis: input.planBasis } : {},
         ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
       }
     });
@@ -3769,8 +3899,8 @@ var EditResource = class {
    * Plan a transcript-driven cut (`POST /v1/edit-plan`). Reads a timed
    * transcript (plus optional silence ranges) and the media sources, and plans
    * the edit. The finished job's `output_data` holds the plan: an `Edl`
-   * (`"tighten"`), an {@link EdlClipSet} (`"clips"`), or a {@link ChapterSet}
-   * (`"chapters"`) — normalize it with {@link unwrapEditPlanOutput}.
+   * (`"tighten"` or `"trailer"`), an {@link EdlClipSet} (`"clips"`), or a
+   * {@link ChapterSet} (`"chapters"`) — normalize it with {@link unwrapEditPlanOutput}.
    *
    * On a self-hosted install the request relays to nodaro.ai and needs the
    * install connected (a 503 `code: "nodaro_connection_required"` otherwise);
@@ -3845,7 +3975,7 @@ var EditResource = class {
     return shared.remapTranscriptThroughEdl(edl, transcript);
   }
 };
-var SDK_VERSION = "2.19.0" ;
+var SDK_VERSION = "2.21.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -3892,6 +4022,7 @@ var NodaroClient = class _NodaroClient {
   library;
   presets;
   savedPosts;
+  collections;
   competitors;
   pickerCatalogs;
   catalogs;
@@ -3942,6 +4073,7 @@ var NodaroClient = class _NodaroClient {
     this.library = new LibraryResource(this);
     this.presets = new PresetsResource(this);
     this.savedPosts = new SavedPostsResource(this);
+    this.collections = new CollectionsResource(this);
     this.competitors = new CompetitorsResource(this);
     this.pickerCatalogs = new PickerCatalogsResource(this);
     this.catalogs = new CatalogsResource(this);
@@ -4218,6 +4350,7 @@ exports.CREATURE_ASSET_TYPES = CREATURE_ASSET_TYPES;
 exports.CallbackAuth = CallbackAuth;
 exports.CatalogsResource = CatalogsResource;
 exports.CharactersResource = CharactersResource;
+exports.CollectionsResource = CollectionsResource;
 exports.CommunityResource = CommunityResource;
 exports.CompetitorsResource = CompetitorsResource;
 exports.CopilotResource = CopilotResource;