@nodaro/sdk 2.32.0 → 2.33.0

package/dist/entries/client.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkS7JQKNVT_cjs = require('../chunk-S7JQKNVT.cjs');
+var chunkGKQSA24K_cjs = require('../chunk-GKQSA24K.cjs');
 require('../chunk-3B47IHB3.cjs');
 require('../chunk-VGWOIWRQ.cjs');
 require('../chunk-LKH5M44B.cjs');
@@ -39,11 +39,11 @@ require('../chunk-43FVH6LJ.cjs');
 require('../chunk-YFS2LMG4.cjs');
 require('../chunk-NLQQHJ25.cjs');
 require('../chunk-KNMW722T.cjs');
-var chunkFB3S2FON_cjs = require('../chunk-FB3S2FON.cjs');
+var chunk56NJIP7P_cjs = require('../chunk-56NJIP7P.cjs');
 require('../chunk-HGCVWOGK.cjs');
 require('../chunk-GB724HW2.cjs');
 require('../chunk-A3S55XGF.cjs');
-require('../chunk-WUIEZ6Z4.cjs');
+require('../chunk-RHJRLXKY.cjs');
 require('../chunk-N6GLZOE4.cjs');
 require('../chunk-DKEYSJCE.cjs');
 require('../chunk-GA4LZZKQ.cjs');
@@ -56,23 +56,23 @@ require('../chunk-WK4VXPPZ.cjs');
 
 Object.defineProperty(exports, "NodaroClient", {
   enumerable: true,
-  get: function () { return chunkS7JQKNVT_cjs.NodaroClient; }
+  get: function () { return chunkGKQSA24K_cjs.NodaroClient; }
 });
 Object.defineProperty(exports, "createClient", {
   enumerable: true,
-  get: function () { return chunkS7JQKNVT_cjs.createClient; }
+  get: function () { return chunkGKQSA24K_cjs.createClient; }
 });
 Object.defineProperty(exports, "CallbackAuth", {
   enumerable: true,
-  get: function () { return chunkFB3S2FON_cjs.CallbackAuth; }
+  get: function () { return chunk56NJIP7P_cjs.CallbackAuth; }
 });
 Object.defineProperty(exports, "StaticTokenAuth", {
   enumerable: true,
-  get: function () { return chunkFB3S2FON_cjs.StaticTokenAuth; }
+  get: function () { return chunk56NJIP7P_cjs.StaticTokenAuth; }
 });
 Object.defineProperty(exports, "supabaseAuth", {
   enumerable: true,
-  get: function () { return chunkFB3S2FON_cjs.supabaseAuth; }
+  get: function () { return chunk56NJIP7P_cjs.supabaseAuth; }
 });
 //# sourceMappingURL=client.cjs.map
 //# sourceMappingURL=client.cjs.map

package/dist/entries/client.js

@@ -1,4 +1,4 @@
-export { NodaroClient, createClient } from '../chunk-PHEA6FVQ.js';
+export { NodaroClient, createClient } from '../chunk-JSCC2N7N.js';
 import '../chunk-YN6CBIIB.js';
 import '../chunk-ZXJQSFIA.js';
 import '../chunk-Z5GLY4R3.js';
@@ -37,11 +37,11 @@ import '../chunk-SFB4YLCS.js';
 import '../chunk-BU5A6K4C.js';
 import '../chunk-I6CXC345.js';
 import '../chunk-JMOKD6ZP.js';
-export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-GWCOKNST.js';
+export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-Y5CYFNNW.js';
 import '../chunk-CK3AMMSC.js';
 import '../chunk-4CXB7RA6.js';
 import '../chunk-65E3JBFZ.js';
-import '../chunk-I4A5VJRL.js';
+import '../chunk-5A7J24LN.js';
 import '../chunk-JGS6YBDW.js';
 import '../chunk-53SXNN3A.js';
 import '../chunk-3QFTP5P5.js';

package/dist/entries/core.cjs

@@ -1,26 +1,26 @@
 'use strict';
 
 require('../chunk-X7XP5WBP.cjs');
-var chunkFB3S2FON_cjs = require('../chunk-FB3S2FON.cjs');
+var chunk56NJIP7P_cjs = require('../chunk-56NJIP7P.cjs');
 require('../chunk-N6GLZOE4.cjs');
 
 
 
 Object.defineProperty(exports, "CallbackAuth", {
   enumerable: true,
-  get: function () { return chunkFB3S2FON_cjs.CallbackAuth; }
+  get: function () { return chunk56NJIP7P_cjs.CallbackAuth; }
 });
 Object.defineProperty(exports, "NodaroClientCore", {
   enumerable: true,
-  get: function () { return chunkFB3S2FON_cjs.NodaroClientCore; }
+  get: function () { return chunk56NJIP7P_cjs.NodaroClientCore; }
 });
 Object.defineProperty(exports, "StaticTokenAuth", {
   enumerable: true,
-  get: function () { return chunkFB3S2FON_cjs.StaticTokenAuth; }
+  get: function () { return chunk56NJIP7P_cjs.StaticTokenAuth; }
 });
 Object.defineProperty(exports, "supabaseAuth", {
   enumerable: true,
-  get: function () { return chunkFB3S2FON_cjs.supabaseAuth; }
+  get: function () { return chunk56NJIP7P_cjs.supabaseAuth; }
 });
 //# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/entries/core.js

@@ -1,5 +1,5 @@
 import '../chunk-AUDHV3OE.js';
-export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-GWCOKNST.js';
+export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-Y5CYFNNW.js';
 import '../chunk-JGS6YBDW.js';
 //# sourceMappingURL=core.js.map
 //# sourceMappingURL=core.js.map

package/dist/entries/edit.cjs

@@ -1,34 +1,34 @@
 'use strict';
 
-var chunkRAZN6C5R_cjs = require('../chunk-RAZN6C5R.cjs');
-var chunkWUIEZ6Z4_cjs = require('../chunk-WUIEZ6Z4.cjs');
+var chunk6T54F65Q_cjs = require('../chunk-6T54F65Q.cjs');
+var chunkRHJRLXKY_cjs = require('../chunk-RHJRLXKY.cjs');
 require('../chunk-N6GLZOE4.cjs');
 
 
 
 Object.defineProperty(exports, "unwrapEditPlanOutput", {
   enumerable: true,
-  get: function () { return chunkRAZN6C5R_cjs.unwrapEditPlanOutput; }
+  get: function () { return chunk6T54F65Q_cjs.unwrapEditPlanOutput; }
 });
 Object.defineProperty(exports, "CLIP_PACK_MAX_TARGET_SEC", {
   enumerable: true,
-  get: function () { return chunkWUIEZ6Z4_cjs.CLIP_PACK_MAX_TARGET_SEC; }
+  get: function () { return chunkRHJRLXKY_cjs.CLIP_PACK_MAX_TARGET_SEC; }
 });
 Object.defineProperty(exports, "CLIP_PACK_MIN_TARGET_SEC", {
   enumerable: true,
-  get: function () { return chunkWUIEZ6Z4_cjs.CLIP_PACK_MIN_TARGET_SEC; }
+  get: function () { return chunkRHJRLXKY_cjs.CLIP_PACK_MIN_TARGET_SEC; }
 });
 Object.defineProperty(exports, "EditResource", {
   enumerable: true,
-  get: function () { return chunkWUIEZ6Z4_cjs.EditResource; }
+  get: function () { return chunkRHJRLXKY_cjs.EditResource; }
 });
 Object.defineProperty(exports, "TRAILER_FORMATS", {
   enumerable: true,
-  get: function () { return chunkWUIEZ6Z4_cjs.TRAILER_FORMATS; }
+  get: function () { return chunkRHJRLXKY_cjs.TRAILER_FORMATS; }
 });
 Object.defineProperty(exports, "USE_CASE_NODE_TYPES", {
   enumerable: true,
-  get: function () { return chunkWUIEZ6Z4_cjs.USE_CASE_NODE_TYPES; }
+  get: function () { return chunkRHJRLXKY_cjs.USE_CASE_NODE_TYPES; }
 });
 //# sourceMappingURL=edit.cjs.map
 //# sourceMappingURL=edit.cjs.map

package/dist/entries/edit.d.cts

@@ -46,20 +46,51 @@ interface SpeakerMapInput {
 
 /**
  * The inputs of the podcast use-case runs on the `edit` resource (Tighten
- * Episode, Chapters, Trailer, Clip Pack) and the request body each one sends.
+ * Episode, Chapters, Trailer, Clip Pack, Speaker Layout) and the request body each one sends.
  * Split from `edit.ts`, which holds the methods, the type list and the
  * continue routes; every name here is re-exported from there.
  */
 
 /**
- * Input for {@link EditResource.tightenEpisode} and
- * {@link EditResource.estimateTightenEpisode}: one recording in, the tightened
- * episode out. Only `mediaUrl` is required; every other field left out takes
- * the node's default.
+ * The recordings of a use-case run: one (`mediaUrl`), or the recordings of one
+ * conversation (`mediaUrls`, in order — the cameras; one may be sound only),
+ * an optional Master audio and the Cameras settings. Pass `mediaUrl` or
+ * `mediaUrls`, not both.
+ *
+ * Several recordings or a Master audio need Speaker Map, which tells who is on
+ * which camera: where it is not available to you (not yet on nodaro.ai) the
+ * request is refused `403 node_not_available` — send one recording.
  */
-interface TightenEpisodeInput {
+interface UseCaseRecordingsInput {
     /** The recording — a video or audio URL, up to 3 hours. */
-    mediaUrl: string;
+    mediaUrl?: string;
+    /**
+     * Instead of `mediaUrl`: the recordings of one conversation, in order — up
+     * to six in all with the Master audio; without one, two or more cameras keep
+     * a place for the sound, so up to five. With two or more the run lines them
+     * up, works out who is on which camera and cuts to whoever is talking.
+     */
+    mediaUrls?: string[];
+    /** The mixer or recorder track: the episode's sound and the clock the recordings are lined up to. */
+    masterAudioUrl?: string;
+    /** With several recordings or a Master audio: the Cameras settings (ignored with one recording and no Master audio). */
+    cameras?: {
+        /** Which recording (1-based) is the wide shot, shown when a speaker has no camera of their own; `null` for none. */
+        wide?: number | null;
+        /** The recordings already share one clock: skip lining them up. */
+        synced?: boolean;
+        /** Who is on which camera: speaker number (`"1"` = the first voice heard) → recording number, 0 = the wide shot. Overrides the automatic map. */
+        speakerCameras?: Record<string, number>;
+    };
+}
+/**
+ * Input for {@link EditResource.tightenEpisode} and
+ * {@link EditResource.estimateTightenEpisode}: the recording (or the
+ * recordings of one conversation, see {@link UseCaseRecordingsInput}) in, the
+ * tightened episode out. Only the recording is required; every other field
+ * left out takes the node's default.
+ */
+interface TightenEpisodeInput extends UseCaseRecordingsInput {
     /** Optional music bed, ducked under the voice and ending with the episode. */
     musicUrl?: string;
     /** `"video"` or `"audio"`; an audio recording always makes an audio episode. */
@@ -73,6 +104,16 @@ interface TightenEpisodeInput {
         aspect: EdlTargetAspect;
         layout: "auto" | "single" | "side-by-side" | "stacked" | "grid" | "pip";
     } | null;
+    /**
+     * With a framing, how it follows the speakers: `"static"` (the default)
+     * splits the frame evenly by speaker; `"tracking"` follows faces with
+     * Speaker Frames (charged per started block of 1,000 sampled frames; a
+     * camera shared by several speakers keeps the even split until faces are
+     * named; refused 403 where Speaker Frames is not available to the caller);
+     * `"auto"` follows faces while Speaker Frames is available to the caller,
+     * else the even split. Ignored without a framing.
+     */
+    framingSource?: "auto" | "static" | "tracking";
     /** Captions on a video episode (on by default). */
     captions?: boolean;
     /** The captions' look. */
@@ -114,12 +155,13 @@ declare const TRAILER_FORMATS: readonly ["9:16", "1:1", "4:5", "16:9"];
 type TrailerFormat = (typeof TRAILER_FORMATS)[number];
 /**
  * Input for {@link EditResource.episodeTrailer} and
- * {@link EditResource.estimateEpisodeTrailer}: one video recording in, a
- * 20–40 s trailer out in each chosen format. Only `mediaUrl` is required.
+ * {@link EditResource.estimateEpisodeTrailer}: one video recording (or the
+ * recordings of one conversation, see {@link UseCaseRecordingsInput}) in, a
+ * 20–40 s trailer out in each chosen format. Only the recording is required.
  */
-interface EpisodeTrailerInput {
-    /** The recording — a video URL, up to 3 hours (an audio-only recording is refused). */
-    mediaUrl: string;
+interface EpisodeTrailerInput extends UseCaseRecordingsInput {
+    /** The recording — a video URL, up to 3 hours (a run with no picture is refused). Or `mediaUrls`. */
+    mediaUrl?: string;
     /** An optional intro card: a short video (15 s at most) played before the trailer. */
     introCardUrl?: string;
     /** The formats to deliver, padded, never cropped (default `["9:16", "1:1", "4:5"]`; an empty list is refused). */
@@ -143,13 +185,13 @@ declare const CLIP_PACK_MAX_TARGET_SEC = 180;
 type ClipPackEmphasis = SpeakerEmphasisStyle | `${Exclude<SpeakerEmphasisStyle, "none">}+${string}`;
 /**
  * Input for {@link EditResource.clipPack} and
- * {@link EditResource.estimateClipPack}: one recording in, a pack of short
- * clips out. Only `mediaUrl` is required; every other field left out takes
- * the node's default.
+ * {@link EditResource.estimateClipPack}: the recording (or the recordings of
+ * one conversation, see {@link UseCaseRecordingsInput} — each clip then cuts
+ * to whoever is talking) in, a pack of short clips out. An audio recording
+ * makes audio clips (no framing, no captions). Only the recording is
+ * required; every other field left out takes the node's default.
  */
-interface ClipPackInput {
-    /** The recording — a video or audio URL, up to 3 hours. An audio recording makes audio clips (no framing, no captions). */
-    mediaUrl: string;
+interface ClipPackInput extends UseCaseRecordingsInput {
     /** How many clips to find, 1–50 (default 8). The plan may find fewer. */
     count?: number;
     /** Each clip's target length in seconds, {@link CLIP_PACK_MIN_TARGET_SEC}–{@link CLIP_PACK_MAX_TARGET_SEC} (default 60). */
@@ -168,6 +210,15 @@ interface ClipPackInput {
         switchType?: SpeakerSwitchId;
         emphasisStyle?: ClipPackEmphasis;
     } | null;
+    /**
+     * With a framing, how it follows the speakers: `"static"` splits the frame
+     * evenly by speaker (what a request that leaves this out gets); `"tracking"`
+     * runs Speaker Frames once over the whole pack to follow faces (charged per
+     * started block of 1,000 sampled frames; refused 403 where Speaker Frames is
+     * not available to the caller); `"auto"` follows faces while Speaker Frames
+     * is available to the caller, else the even split. Ignored without a framing.
+     */
+    framingSource?: "auto" | "static" | "tracking";
     /** Caption each video clip (on by default). */
     captions?: boolean;
     /** The captions' look (default `"karaoke"`). */
@@ -185,6 +236,42 @@ interface ClipPackInput {
     /** A style guide for the planner (up to 4 000 characters). */
     styleGuide?: string;
 }
+/**
+ * Input for {@link EditResource.speakerLayout} and
+ * {@link EditResource.estimateSpeakerLayout}: one video recording (or the
+ * recordings of one conversation, see {@link UseCaseRecordingsInput}) in, the
+ * whole recording framed by speaker out — the same length, nothing cut. Only
+ * the recording is required; every other field left out takes the node's
+ * default.
+ */
+interface SpeakerLayoutInput extends UseCaseRecordingsInput {
+    /** The recording — a video URL, up to 3 hours (an audio-only recording is refused). Or `mediaUrls`. */
+    mediaUrl?: string;
+    /** The video's shape (default `"9:16"`). With one recording, a video already as narrow as the shape (or narrower) is refused `400 media_shape`. */
+    targetAspect?: EdlTargetAspect;
+    /** How the speakers are laid out (default `"stacked"`; one the shape does not draw is snapped to one it does). */
+    layout?: "auto" | "single" | "side-by-side" | "stacked" | "grid" | "pip";
+    /** The switch at each speaker change (default `"cut"`). */
+    switchType?: SpeakerSwitchId;
+    /** How the speaker talking is emphasised (default `"scale"`): `"none"`, or `"scale"`, `"border"` and `"dim"` joined with `"+"`. */
+    emphasisStyle?: ClipPackEmphasis;
+    /**
+     * How the speakers are followed: `"auto"` (the default) follows faces with
+     * Speaker Frames while it is available to the caller, else splits the frame
+     * evenly; `"static"` splits the frame evenly by speaker; `"tracking"`
+     * follows faces (charged per started block of 1,000 sampled frames;
+     * refused 403 where Speaker Frames is not available to the caller). Faces
+     * aren't named after a speaker yet, so a camera shared by several speakers
+     * keeps the even split.
+     */
+    framingSource?: "auto" | "static" | "tracking";
+    /**
+     * Stop at a quick preview for a person to review; render it at full
+     * quality with {@link EditResource.continueUseCase}
+     * (`mode: "render-final"`, no `editedEdl`: the layout has no cut to change).
+     */
+    reviewBeforeRender?: boolean;
+}
 
 /**
  * A silence-detect job's `output_data.json` — the value to pass as
@@ -437,7 +524,7 @@ interface CameraSwitchInput {
     workflowId?: string;
 }
 
-/** What a use-case run (`tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack`) and `continueUseCase` answer: the run's job to poll. */
+/** What a use-case run (`tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack`, `speakerLayout`) and `continueUseCase` answer: the run's job to poll. */
 interface UseCaseJobResult extends EditJobResult {
     /** The run's execution (absent on a deduplicated retry). */
     executionId?: string;
@@ -465,7 +552,7 @@ interface UseCaseEstimate {
 type TightenEpisodeEstimate = UseCaseEstimate;
 /** Input for {@link EditResource.continueUseCase}. */
 interface UseCaseContinueInput {
-    /** The run to continue: the job `tightenEpisode`, `episodeChapters`, `episodeTrailer` or `clipPack` (or an earlier continuation) answered. */
+    /** The run to continue: the job `tightenEpisode`, `episodeChapters`, `episodeTrailer`, `clipPack` or `speakerLayout` (or an earlier continuation) answered. */
     jobId: string;
     /**
      * `"from-failed"` re-runs what did not finish of a failed run;
@@ -474,7 +561,7 @@ interface UseCaseContinueInput {
      * a Clip Pack edit that drops every clip is refused `use_case_nothing_kept`).
      */
     mode: "from-failed" | "render-final";
-    /** Render final only: the reviewer's edit of the plan (an EDL). */
+    /** Render final only: the reviewer's edit of the plan (an EDL). A Speaker Layout run has no plan: an edit is refused `400 use_case_no_plan`. */
     editedEdl?: unknown;
     /**
      * The run's node type: its continuation goes to `POST /v1/<nodeType>/continue`.
@@ -485,7 +572,7 @@ interface UseCaseContinueInput {
      */
     nodeType?: UseCaseNodeType;
 }
-/** Per-call options for the use-case requests (Tighten Episode, Chapters, Trailer, Clip Pack, and their continuations). */
+/** Per-call options for the use-case requests (Tighten Episode, Chapters, Trailer, Clip Pack, Speaker Layout, and their continuations). */
 interface UseCaseRequestOptions {
     /**
      * Sent as the `Idempotency-Key` header. Reuse the same value when retrying
@@ -518,13 +605,15 @@ interface UseCaseRequestOptions {
  *   it in each chosen format in one call; the same connection applies.
  * - {@link clipPack} cuts a recording into a pack of short clips (framed and
  *   captioned by default) in one call; the same connection applies.
+ * - {@link speakerLayout} frames a whole recording by speaker (the same
+ *   length, nothing cut) in one call; the same connection applies.
  * - {@link remapTranscript} is a PURE local transform (no request) — the same
  *   remap `applyEdl` performs on its `transcript`, exposed for callers that hold
  *   an EDL and a transcript and only want the re-timed transcript.
  *
  * Every request method except the estimates ({@link estimateTightenEpisode},
  * {@link estimateEpisodeChapters}, {@link estimateEpisodeTrailer},
- * {@link estimateClipPack}: a quote, `{ data }`) returns
+ * {@link estimateClipPack}, {@link estimateSpeakerLayout}: a quote, `{ data }`) returns
  * {@link EditJobResult} (the use-case runs a {@link UseCaseJobResult}); poll the
  * `jobId` with `client.jobs.getStatus(jobId)`.
  */
@@ -648,6 +737,27 @@ declare class EditResource {
     estimateClipPack(input: ClipPackInput): Promise<{
         data: UseCaseEstimate;
     }>;
+    /**
+     * Speaker Layout (`POST /v1/speaker-layout`): frame a whole recording by
+     * speaker in one call — the same length, nothing cut. One recording: each
+     * speaker framed in turn; several recordings of one conversation: lined up,
+     * each speaker shown on their own camera. The finished job's
+     * `output_data.videoUrl` is the framed video, `output_data.json` the edit
+     * Speaker View drew. With `reviewBeforeRender` the run stops at a preview;
+     * {@link continueUseCase} (`mode: "render-final"`, no `editedEdl`) renders
+     * it at full quality. Priced as its steps at their own rates plus the listed
+     * per-run fee; quote it first with {@link estimateSpeakerLayout}.
+     */
+    speakerLayout(input: SpeakerLayoutInput, options?: UseCaseRequestOptions): Promise<UseCaseJobResult>;
+    /**
+     * What a Speaker Layout run is estimated at (`POST /v1/speaker-layout/estimate`):
+     * its steps at their own rates plus its per-run fee. Nothing is created or
+     * charged. A recording whose length cannot be read is estimated at the
+     * 180-minute ceiling.
+     */
+    estimateSpeakerLayout(input: SpeakerLayoutInput): Promise<{
+        data: UseCaseEstimate;
+    }>;
     /**
      * Continue a use-case run as a new job (`POST /v1/<type>/continue`, the
      * run's own type: `input.nodeType`, else the type the job records, read with
@@ -702,4 +812,4 @@ declare class EditResource {
     remapTranscript(edl: Edl, transcript: Transcript): Transcript;
 }
 
-export { type ApplyEdlInput, type AudioSyncInput, type AudioSyncOffset, type AudioSyncResult, type AudioSyncSource, CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, type CameraSwitchInput, type ClipPackEmphasis, type ClipPackInput, type EditJobResult, type EditPlanInput, type EditPlanSource, EditResource, type EpisodeChaptersInput, type EpisodeTrailerInput, type SilenceDetectInput, type SilenceRanges, type SpeakerMapInput, type SpeakerMapSource, TRAILER_FORMATS, type TightenEpisodeEstimate, type TightenEpisodeInput, type TightenEpisodeJobResult, type TrailerFormat, type UseCaseContinueInput, type UseCaseEstimate, type UseCaseJobResult, type UseCaseRequestOptions };
+export { type ApplyEdlInput, type AudioSyncInput, type AudioSyncOffset, type AudioSyncResult, type AudioSyncSource, CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, type CameraSwitchInput, type ClipPackEmphasis, type ClipPackInput, type EditJobResult, type EditPlanInput, type EditPlanSource, EditResource, type EpisodeChaptersInput, type EpisodeTrailerInput, type SilenceDetectInput, type SilenceRanges, type SpeakerLayoutInput, type SpeakerMapInput, type SpeakerMapSource, TRAILER_FORMATS, type TightenEpisodeEstimate, type TightenEpisodeInput, type TightenEpisodeJobResult, type TrailerFormat, type UseCaseContinueInput, type UseCaseEstimate, type UseCaseJobResult, type UseCaseRecordingsInput, type UseCaseRequestOptions };