@nodaro/sdk 2.26.0 → 2.27.0

package/dist/index.cjs

@@ -1,7 +1,14 @@
 'use strict';
 
-var shared = require('@nodaro/shared');
-var prompts = require('@nodaro/prompts');
+var workflow = require('@nodaro/shared/workflow');
+var nodes = require('@nodaro/shared/nodes');
+var social = require('@nodaro/shared/social');
+var scene3d = require('@nodaro/shared/scene3d');
+var person = require('@nodaro/prompts/person');
+var entities = require('@nodaro/shared/entities');
+var edl = require('@nodaro/shared/edl');
+var organizations = require('@nodaro/shared/organizations');
+var apps = require('@nodaro/shared/apps');
 
 // src/binary-response.ts
 async function readBinaryResponse(response, maxBytes) {
@@ -112,6 +119,19 @@ var StudioOpError = class extends NodaroError {
   }
   opIndex;
 };
+var CONTINUATION_REFUSAL_CODES = /* @__PURE__ */ new Set([
+  "already_running",
+  "continuation_superseded",
+  "render_final_already_rendered"
+]);
+var ContinuationRefusedError = class extends NodaroError {
+  constructor(message, code, jobId) {
+    super(message, code, 409);
+    this.jobId = jobId;
+    this.name = "ContinuationRefusedError";
+  }
+  jobId;
+};
 var JobBlockedError = class extends NodaroError {
   constructor(message = "Blocked by this deployment's content policy") {
     super(message, "job_blocked", 422);
@@ -184,6 +204,9 @@ function throwFromResponse(status, body) {
   if (status >= 400 && status < 500 && typeof body.error?.opIndex === "number") {
     throw new StudioOpError(message, code, status, body.error.opIndex);
   }
+  if (status === 409 && CONTINUATION_REFUSAL_CODES.has(code) && typeof body.jobId === "string") {
+    throw new ContinuationRefusedError(message, code, body.jobId);
+  }
   if (status === 422 && code === "job_blocked") throw new JobBlockedError(message);
   if (status === 403 && code === "insufficient_scope") {
     throw new ForbiddenError(message, body.error?.missingScope);
@@ -581,11 +604,11 @@ var NodesResource = class {
     return this.client.request("GET", `/v1/nodes/${encodeURIComponent(type)}`);
   }
   run(type, params = {}, options = {}) {
-    const route = type === "render-video" && typeof params.planType === "string" ? "/v1/render-video/plan" : shared.nodeRunRoute(type);
-    if (!route) return Promise.reject(notRunnable(type, shared.NODE_TYPES_WITHOUT_RUN_ROUTE[type]));
-    const platform = shared.SOCIAL_POST_NODE_PLATFORM[type];
+    const route = type === "render-video" && typeof params.planType === "string" ? "/v1/render-video/plan" : nodes.nodeRunRoute(type);
+    if (!route) return Promise.reject(notRunnable(type, nodes.NODE_TYPES_WITHOUT_RUN_ROUTE[type]));
+    const platform = social.SOCIAL_POST_NODE_PLATFORM[type];
     const body = platform && params.platform === void 0 ? { ...params, platform } : params;
-    const conventional = !Object.prototype.hasOwnProperty.call(shared.NODE_RUN_ROUTES, type);
+    const conventional = !Object.prototype.hasOwnProperty.call(nodes.NODE_RUN_ROUTES, type);
     return this.client.request("POST", route, {
       body,
       // Transport-level retry safety, opt-in per call. The platform reads the
@@ -711,7 +734,7 @@ var Scene3DResource = class {
     if (SCENE3D_DELIVERY_ASSET_USAGE[asset.kind] !== asset.usage) {
       throw new Error("This asset is not available through the delivery endpoint");
     }
-    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > shared.SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
+    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > scene3d.SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
       throw new Error("Invalid scene delivery asset byte length");
     }
     return this.client.requestBytes("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}/assets/${encodeURIComponent(asset.assetId)}`, {
@@ -751,7 +774,7 @@ var Scene3DResource = class {
     if (!["glb", "camera-track-json", "poster", "validation-report"].includes(asset.kind)) {
       throw new Error("This asset is not available through the playback endpoint");
     }
-    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > shared.SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
+    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > scene3d.SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
       throw new Error("Invalid scene asset byte length");
     }
     return this.client.requestBytes("GET", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/assets/${encodeURIComponent(asset.assetId)}`, {
@@ -763,7 +786,7 @@ var Scene3DResource = class {
   sourceBytes(revisionId, options) {
     return this.client.requestBytes("GET", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/source`, {
       signal: options?.signal,
-      maxBytes: shared.SCENE3D_V2_LIMITS.maxBlendSourceBytes
+      maxBytes: scene3d.SCENE3D_V2_LIMITS.maxBlendSourceBytes
     });
   }
   generate(params) {
@@ -1163,7 +1186,7 @@ var CharactersResource = class {
   }
 };
 function buildPersonSeedPrompt(value) {
-  return prompts.buildPersonHints(value).join(", ");
+  return person.buildPersonHints(value).join(", ");
 }
 var LocationsResource = class {
   constructor(client) {
@@ -2536,7 +2559,10 @@ var AudioResource = class {
    * `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.
+   * the price is the same with or without a duck. `endAt` (`"longest"`, the
+   * default, or `"voice"`) says where the mix ends: `"voice"` ends it when the
+   * voice (the `duck.under` track) ends (needs `duck`). A video URL is a track
+   * too: its audio is mixed, and a video with no sound is a silent track.
    */
   mix(input) {
     return this.client.request("POST", "/v1/mix-audio", { body: input });
@@ -2613,6 +2639,18 @@ var CreditsResource = class {
     );
     return res.data;
   }
+  /**
+   * `GET /v1/credits/transactions` → one page of the caller's credit
+   * transactions, newest first, with `nextCursor` for the next page (`null`
+   * at the end). Read `credits_charged` for what each run cost — it can be
+   * below the hold (`credits_reserved`) and is `null` while the hold is open.
+   * Cloud-only route: a self-hosted instance answers 404.
+   */
+  transactions(options = {}) {
+    return this.client.request("GET", "/v1/credits/transactions", {
+      query: { limit: options.limit, cursor: options.cursor }
+    });
+  }
   /**
    * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor
    * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers
@@ -3955,6 +3993,13 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
+function tightenBody(input) {
+  const { mediaUrl, ...rest } = input;
+  return { mediaUrls: [mediaUrl], ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== void 0)) };
+}
+function idempotencyHeaders(options) {
+  return options?.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {};
+}
 var EditResource = class {
   constructor(client) {
     this.client = client;
@@ -4014,6 +4059,42 @@ var EditResource = class {
       }
     });
   }
+  /**
+   * Tighten Episode (`POST /v1/tighten-episode`): tighten a podcast recording
+   * in one call — transcribe, cut the silences and filler, render, with
+   * optional captions, music and framing. Answers the run's job to poll; its
+   * `output_data` holds the episode. The run is priced as its steps at their own
+   * rates plus the listed per-run fee. Quote it first with
+   * {@link estimateTightenEpisode}.
+   */
+  tightenEpisode(input, options) {
+    return this.client.request("POST", "/v1/tighten-episode", { body: tightenBody(input), ...idempotencyHeaders(options) });
+  }
+  /**
+   * What a Tighten Episode run is estimated at (`POST /v1/tighten-episode/estimate`):
+   * its steps at their own rates plus its per-run fee. Nothing is created or
+   * charged. The estimate leans high: the render is priced at the recording's
+   * full length, while the charge follows the minutes actually rendered.
+   */
+  estimateTightenEpisode(input) {
+    return this.client.request("POST", "/v1/tighten-episode/estimate", { body: tightenBody(input) });
+  }
+  /**
+   * Continue a Tighten Episode run as a new job (`POST /v1/tighten-episode/continue`):
+   * `"from-failed"` keeps the steps that finished and runs the rest (the fee is
+   * held again; the failed run's was refunded); `"render-final"` renders the
+   * full-quality episode after a review-on preview, with the preview's
+   * settings and no fee. A refusal that names another job
+   * (`already_running`, `continuation_superseded`,
+   * `render_final_already_rendered`) throws a `ContinuationRefusedError`
+   * carrying that `jobId`.
+   */
+  continueUseCase(input, options) {
+    return this.client.request("POST", "/v1/tighten-episode/continue", {
+      body: { jobId: input.jobId, mode: input.mode, ...input.editedEdl !== void 0 ? { editedEdl: input.editedEdl } : {} },
+      ...idempotencyHeaders(options)
+    });
+  }
   /**
    * Plan a transcript-driven cut (`POST /v1/edit-plan`). Reads a timed
    * transcript (plus optional silence ranges) and the media sources, and plans
@@ -4026,12 +4107,12 @@ var EditResource = class {
    * on nodaro.ai it runs directly.
    */
   editPlan(input) {
-    const planned = shared.resolveEditPlanSources(input.sources, {
+    const planned = edl.resolveEditPlanSources(input.sources, {
       offsets: input.offsets,
       transcriptSourceId: input.transcriptSourceId
     });
     if (!planned.ok) {
-      const message = planned.issues.map((issue) => shared.describeAudioSyncOffsetIssue(issue)).join("; ");
+      const message = planned.issues.map((issue) => edl.describeAudioSyncOffsetIssue(issue)).join("; ");
       return Promise.reject(new NodaroError(`editPlan: ${message}`, "edit_plan_sources", 400));
     }
     const transcript = planned.transcriptSourceId ? { ...input.transcript, sourceId: planned.transcriptSourceId } : input.transcript;
@@ -4061,7 +4142,7 @@ var EditResource = class {
    * a {@link NodaroError} (`code: "no_speakers"`) before any request or charge.
    */
   cameraSwitch(input) {
-    if (shared.transcriptSpeakerLabels(input.transcript).length === 0) {
+    if (edl.transcriptSpeakerLabels(input.transcript).length === 0) {
       return Promise.reject(new NodaroError(
         "cameraSwitch: the transcript has no speaker labels \u2014 transcribe with speaker detection on",
         "no_speakers",
@@ -4090,11 +4171,11 @@ var EditResource = class {
    * clipping straddlers. Runs `@nodaro/shared`'s canonical
    * `remapTranscriptThroughEdl`, the same remap `applyEdl` performs server-side.
    */
-  remapTranscript(edl, transcript) {
-    return shared.remapTranscriptThroughEdl(edl, transcript);
+  remapTranscript(edl$1, transcript) {
+    return edl.remapTranscriptThroughEdl(edl$1, transcript);
   }
 };
-var SDK_VERSION = "2.26.0" ;
+var SDK_VERSION = "2.27.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -4245,7 +4326,7 @@ var NodaroClient = class _NodaroClient {
       ...this.sendClientHeader ? { [CLIENT_HEADER]: this.clientLabel } : {},
       // Before per-request headers: a resource that needs to reach outside
       // this client's workspace says so explicitly and wins.
-      ...this.workspaceId ? { [shared.WORKSPACE_HEADER]: this.workspaceId } : {},
+      ...this.workspaceId ? { [organizations.WORKSPACE_HEADER]: this.workspaceId } : {},
       ...options.headers ?? {}
     };
     if (token) headers["Authorization"] = `Bearer ${token}`;
@@ -4363,105 +4444,105 @@ function supabaseAuth(supabase) {
   };
 }
 
-Object.defineProperty(exports, "CHARACTER_ASPECT_DEFAULTS", {
+Object.defineProperty(exports, "OUTPUT_BEARING_NODE_STATUSES", {
   enumerable: true,
-  get: function () { return shared.CHARACTER_ASPECT_DEFAULTS; }
+  get: function () { return workflow.OUTPUT_BEARING_NODE_STATUSES; }
 });
-Object.defineProperty(exports, "CHARACTER_ASPECT_OPTIONS", {
+Object.defineProperty(exports, "nodeStateMayCarryOutput", {
   enumerable: true,
-  get: function () { return shared.CHARACTER_ASPECT_OPTIONS; }
+  get: function () { return workflow.nodeStateMayCarryOutput; }
 });
-Object.defineProperty(exports, "CHARACTER_STYLES", {
+Object.defineProperty(exports, "PROMPT_PREFIX_KEY", {
   enumerable: true,
-  get: function () { return shared.CHARACTER_STYLES; }
+  get: function () { return nodes.PROMPT_PREFIX_KEY; }
 });
-Object.defineProperty(exports, "CREATURE_ASPECT_DEFAULTS", {
+Object.defineProperty(exports, "PROMPT_SUFFIX_KEY", {
   enumerable: true,
-  get: function () { return shared.OBJECT_ASPECT_DEFAULTS; }
+  get: function () { return nodes.PROMPT_SUFFIX_KEY; }
 });
-Object.defineProperty(exports, "CREATURE_ASPECT_OPTIONS", {
+Object.defineProperty(exports, "PEOPLE", {
   enumerable: true,
-  get: function () { return shared.OBJECT_ASPECT_OPTIONS; }
+  get: function () { return person.PEOPLE; }
 });
-Object.defineProperty(exports, "CREATURE_ATTACH_COLUMNS", {
+Object.defineProperty(exports, "PERSON_DIMENSION_LABELS", {
   enumerable: true,
-  get: function () { return shared.CREATURE_ATTACH_COLUMNS; }
+  get: function () { return person.PERSON_DIMENSION_LABELS; }
 });
-Object.defineProperty(exports, "LOCATION_ASSET_TYPES", {
+Object.defineProperty(exports, "PERSON_DIMENSION_ORDER", {
   enumerable: true,
-  get: function () { return shared.LOCATION_ASSET_TYPES; }
+  get: function () { return person.PERSON_DIMENSION_ORDER; }
 });
-Object.defineProperty(exports, "LOCATION_ATTACH_COLUMNS", {
+Object.defineProperty(exports, "buildPersonHints", {
   enumerable: true,
-  get: function () { return shared.LOCATION_ATTACH_COLUMNS; }
+  get: function () { return person.buildPersonHints; }
 });
-Object.defineProperty(exports, "OBJECT_ASPECT_DEFAULTS", {
+Object.defineProperty(exports, "CHARACTER_ASPECT_DEFAULTS", {
   enumerable: true,
-  get: function () { return shared.OBJECT_ASPECT_DEFAULTS; }
+  get: function () { return entities.CHARACTER_ASPECT_DEFAULTS; }
 });
-Object.defineProperty(exports, "OBJECT_ASPECT_OPTIONS", {
+Object.defineProperty(exports, "CHARACTER_ASPECT_OPTIONS", {
   enumerable: true,
-  get: function () { return shared.OBJECT_ASPECT_OPTIONS; }
+  get: function () { return entities.CHARACTER_ASPECT_OPTIONS; }
 });
-Object.defineProperty(exports, "OBJECT_ASSET_TYPES", {
+Object.defineProperty(exports, "CHARACTER_STYLES", {
   enumerable: true,
-  get: function () { return shared.OBJECT_ASSET_TYPES; }
+  get: function () { return entities.CHARACTER_STYLES; }
 });
-Object.defineProperty(exports, "OBJECT_ATTACH_COLUMNS", {
+Object.defineProperty(exports, "CREATURE_ASPECT_DEFAULTS", {
   enumerable: true,
-  get: function () { return shared.OBJECT_ATTACH_COLUMNS; }
+  get: function () { return entities.OBJECT_ASPECT_DEFAULTS; }
 });
-Object.defineProperty(exports, "OUTPUT_BEARING_NODE_STATUSES", {
+Object.defineProperty(exports, "CREATURE_ASPECT_OPTIONS", {
   enumerable: true,
-  get: function () { return shared.OUTPUT_BEARING_NODE_STATUSES; }
+  get: function () { return entities.OBJECT_ASPECT_OPTIONS; }
 });
-Object.defineProperty(exports, "PROMPT_PREFIX_KEY", {
+Object.defineProperty(exports, "CREATURE_ATTACH_COLUMNS", {
   enumerable: true,
-  get: function () { return shared.PROMPT_PREFIX_KEY; }
+  get: function () { return entities.CREATURE_ATTACH_COLUMNS; }
 });
-Object.defineProperty(exports, "PROMPT_SUFFIX_KEY", {
+Object.defineProperty(exports, "LOCATION_ASSET_TYPES", {
   enumerable: true,
-  get: function () { return shared.PROMPT_SUFFIX_KEY; }
+  get: function () { return entities.LOCATION_ASSET_TYPES; }
 });
-Object.defineProperty(exports, "RECAST_SEGMENT_PACKS", {
+Object.defineProperty(exports, "LOCATION_ATTACH_COLUMNS", {
   enumerable: true,
-  get: function () { return shared.RECAST_SEGMENT_PACKS; }
+  get: function () { return entities.LOCATION_ATTACH_COLUMNS; }
 });
-Object.defineProperty(exports, "SURROUND_DIRECTIONS", {
+Object.defineProperty(exports, "OBJECT_ASPECT_DEFAULTS", {
   enumerable: true,
-  get: function () { return shared.SURROUND_DIRECTIONS; }
+  get: function () { return entities.OBJECT_ASPECT_DEFAULTS; }
 });
-Object.defineProperty(exports, "USAGE_GROUP_BYS", {
+Object.defineProperty(exports, "OBJECT_ASPECT_OPTIONS", {
   enumerable: true,
-  get: function () { return shared.USAGE_GROUP_BYS; }
+  get: function () { return entities.OBJECT_ASPECT_OPTIONS; }
 });
-Object.defineProperty(exports, "WORKSPACE_HEADER", {
+Object.defineProperty(exports, "OBJECT_ASSET_TYPES", {
   enumerable: true,
-  get: function () { return shared.WORKSPACE_HEADER; }
+  get: function () { return entities.OBJECT_ASSET_TYPES; }
 });
-Object.defineProperty(exports, "nodeStateMayCarryOutput", {
+Object.defineProperty(exports, "OBJECT_ATTACH_COLUMNS", {
   enumerable: true,
-  get: function () { return shared.nodeStateMayCarryOutput; }
+  get: function () { return entities.OBJECT_ATTACH_COLUMNS; }
 });
-Object.defineProperty(exports, "unwrapEditPlanOutput", {
+Object.defineProperty(exports, "SURROUND_DIRECTIONS", {
   enumerable: true,
-  get: function () { return shared.unwrapEditPlanOutput; }
+  get: function () { return entities.SURROUND_DIRECTIONS; }
 });
-Object.defineProperty(exports, "PEOPLE", {
+Object.defineProperty(exports, "unwrapEditPlanOutput", {
   enumerable: true,
-  get: function () { return prompts.PEOPLE; }
+  get: function () { return edl.unwrapEditPlanOutput; }
 });
-Object.defineProperty(exports, "PERSON_DIMENSION_LABELS", {
+Object.defineProperty(exports, "USAGE_GROUP_BYS", {
   enumerable: true,
-  get: function () { return prompts.PERSON_DIMENSION_LABELS; }
+  get: function () { return organizations.USAGE_GROUP_BYS; }
 });
-Object.defineProperty(exports, "PERSON_DIMENSION_ORDER", {
+Object.defineProperty(exports, "WORKSPACE_HEADER", {
   enumerable: true,
-  get: function () { return prompts.PERSON_DIMENSION_ORDER; }
+  get: function () { return organizations.WORKSPACE_HEADER; }
 });
-Object.defineProperty(exports, "buildPersonHints", {
+Object.defineProperty(exports, "RECAST_SEGMENT_PACKS", {
   enumerable: true,
-  get: function () { return prompts.buildPersonHints; }
+  get: function () { return apps.RECAST_SEGMENT_PACKS; }
 });
 exports.AppsResource = AppsResource;
 exports.AudioResource = AudioResource;
@@ -4472,6 +4553,7 @@ exports.CharactersResource = CharactersResource;
 exports.CollectionsResource = CollectionsResource;
 exports.CommunityResource = CommunityResource;
 exports.CompetitorsResource = CompetitorsResource;
+exports.ContinuationRefusedError = ContinuationRefusedError;
 exports.CopilotResource = CopilotResource;
 exports.CreaturesResource = CreaturesResource;
 exports.CreditsResource = CreditsResource;