@nodaro/sdk 2.25.0 → 2.27.0

package/dist/index.js

@@ -1,7 +1,16 @@
-import { SCENE3D_V2_LIMITS, resolveEditPlanSources, describeAudioSyncOffsetIssue, transcriptSpeakerLabels, remapTranscriptThroughEdl, WORKSPACE_HEADER } from '@nodaro/shared';
-export { CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, OUTPUT_BEARING_NODE_STATUSES, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, RECAST_SEGMENT_PACKS, SURROUND_DIRECTIONS, USAGE_GROUP_BYS, WORKSPACE_HEADER, nodeStateMayCarryOutput, unwrapEditPlanOutput } from '@nodaro/shared';
-import { buildPersonHints } from '@nodaro/prompts';
-export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, buildPersonHints } from '@nodaro/prompts';
+export { OUTPUT_BEARING_NODE_STATUSES, nodeStateMayCarryOutput } from '@nodaro/shared/workflow';
+import { nodeRunRoute, NODE_TYPES_WITHOUT_RUN_ROUTE, NODE_RUN_ROUTES } from '@nodaro/shared/nodes';
+export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY } from '@nodaro/shared/nodes';
+import { SOCIAL_POST_NODE_PLATFORM } from '@nodaro/shared/social';
+import { SCENE3D_V2_LIMITS } from '@nodaro/shared/scene3d';
+import { buildPersonHints } from '@nodaro/prompts/person';
+export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, buildPersonHints } from '@nodaro/prompts/person';
+export { CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, SURROUND_DIRECTIONS } from '@nodaro/shared/entities';
+import { resolveEditPlanSources, describeAudioSyncOffsetIssue, transcriptSpeakerLabels, remapTranscriptThroughEdl } from '@nodaro/shared/edl';
+export { unwrapEditPlanOutput } from '@nodaro/shared/edl';
+import { WORKSPACE_HEADER } from '@nodaro/shared/organizations';
+export { USAGE_GROUP_BYS, WORKSPACE_HEADER } from '@nodaro/shared/organizations';
+export { RECAST_SEGMENT_PACKS } from '@nodaro/shared/apps';
 
 // src/binary-response.ts
 async function readBinaryResponse(response, maxBytes) {
@@ -112,6 +121,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,12 +206,15 @@ 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);
   }
   if (status === 403) throw new ForbiddenError(message);
-  if (status === 404) throw new NotFoundError(message);
+  if (status === 404) throw new NotFoundError(body.error?.message ?? (typeof body.message === "string" ? body.message : void 0));
   if (status === 429) throw new RateLimitedError(message);
   if (status === 402) {
     throw new InsufficientCreditsError(message, body.error?.required, body.error?.available);
@@ -539,8 +564,6 @@ var ExecutionsResource = class {
     );
   }
 };
-
-// src/resources/nodes.ts
 var DEFAULT_POLL_MS = 2e3;
 var DEFAULT_MAX_MS = 15 * 60 * 1e3;
 var sleep = (ms, signal) => new Promise((resolve, reject) => {
@@ -558,6 +581,10 @@ var sleep = (ms, signal) => new Promise((resolve, reject) => {
   }
   signal?.addEventListener("abort", onAbort, { once: true });
 });
+function notRunnable(type, why) {
+  return new NodaroError(`Node type "${type}" has no route of its own to run it directly: ${why}.`, "node_not_runnable", 0);
+}
+var isRouteNotFound = (err) => err instanceof NotFoundError && /^Route\b.*\bnot found\b/i.test(err.message);
 function extractJobId(result, label) {
   if (result && typeof result === "object" && "jobId" in result) {
     const jobId = result.jobId;
@@ -579,13 +606,20 @@ var NodesResource = class {
     return this.client.request("GET", `/v1/nodes/${encodeURIComponent(type)}`);
   }
   run(type, params = {}, options = {}) {
-    const route = type === "generate-3d-scene" ? "/v1/3d-scene/generate" : type === "edit-3d-scene" ? "/v1/3d-scene/edit" : type === "render-video" && typeof params.planType === "string" ? "/v1/render-video/plan" : `/v1/${encodeURIComponent(type)}`;
+    const route = type === "render-video" && typeof params.planType === "string" ? "/v1/render-video/plan" : nodeRunRoute(type);
+    if (!route) return Promise.reject(notRunnable(type, NODE_TYPES_WITHOUT_RUN_ROUTE[type]));
+    const platform = SOCIAL_POST_NODE_PLATFORM[type];
+    const body = platform && params.platform === void 0 ? { ...params, platform } : params;
+    const conventional = !Object.prototype.hasOwnProperty.call(NODE_RUN_ROUTES, type);
     return this.client.request("POST", route, {
-      body: params,
+      body,
       // Transport-level retry safety, opt-in per call. The platform reads the
       // standard header, so a caller that reuses a key on a retry gets the
       // same run back instead of a second charge.
       ...options.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {}
+    }).catch((err) => {
+      if (conventional && isRouteNotFound(err)) throw notRunnable(type, "it runs only inside a workflow (client.workflows.run)");
+      throw err;
     });
   }
   async runAndWait(type, params = {}, opts = {}) {
@@ -2386,6 +2420,20 @@ var MediaResource = class {
   trimAudio(input) {
     return this.client.request("POST", "/v1/trim-audio", { body: input });
   }
+  /**
+   * Cut a video and/or an audio file into consecutive parts
+   * (`POST /v1/split-media`). Every part is at most `chunkDuration` seconds and
+   * at least `minPartDuration` (default 4, never above `chunkDuration`) — a
+   * short leftover is evened out with the parts before it. Video is cut on
+   * whole frames with each part's sound matching its picture; audio parts are
+   * sample-exact, in `audioFormat` (`mp3` default / `wav` / `aac`). With both
+   * sources each is split on its own. At most 200 parts per input. Poll
+   * `jobs.get(jobId)`; the parts are on the completed job's `output_data` —
+   * see {@link SplitMediaOutput}.
+   */
+  splitMedia(input) {
+    return this.client.request("POST", "/v1/split-media", { body: input });
+  }
   /**
    * Turn one still image + one audio track into an MP4
    * (`POST /v1/still-to-video`) — locally rendered (FFmpeg), no AI model,
@@ -2513,7 +2561,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 });
@@ -2590,6 +2641,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
@@ -2601,6 +2664,23 @@ var CreditsResource = class {
       body: { models: ids.slice(0, MODEL_COSTS_LIMIT) }
     });
   }
+  /**
+   * `POST /v1/credits/claim-signup-grant` → claims the account's free signup
+   * grant, once, with the browser signals of the page making the claim.
+   *
+   * Call it once per page load as soon as the session is known, and never
+   * wait on it for rendering: it is idempotent (a decided account answers
+   * with its state and `granted: false`), it costs the user nothing when it
+   * fails (the next load asks again), and the signals are what make the
+   * claim worth sending — collect them with `collectSignupKeys()` from
+   * `@nodaro/sdk/signup-signals` and pass whatever came back, `{}` included.
+   * Cloud-only route: a self-hosted instance answers 404.
+   */
+  claimSignupGrant(keys = {}) {
+    return this.client.request("POST", "/v1/credits/claim-signup-grant", {
+      body: keys
+    });
+  }
   // NOTE: no `estimate(...)` helper. The backend exposes
   // `POST /v1/credits/estimate-workflow` (body `{ nodes }` → `{ data: {
   // totalCredits, nodeCount } }`), but no consumer has a settled shape for it
@@ -3915,6 +3995,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;
@@ -3974,6 +4061,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
@@ -4054,7 +4177,7 @@ var EditResource = class {
     return remapTranscriptThroughEdl(edl, transcript);
   }
 };
-var SDK_VERSION = "2.25.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 {
@@ -4323,6 +4446,6 @@ function supabaseAuth(supabase) {
   };
 }
 
-export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CollectionsResource, CommunityResource, CompetitorsResource, CopilotResource, CreaturesResource, CreditsResource, DeveloperAppsResource, EditResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, JobsResource, LibraryResource, LlmResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, OrganizationsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, RecastResource, ReduceResource, SCENE3D_DELIVERY_ASSET_USAGE, SavedPostsResource, Scene3DResource, ShotsResource, StaticTokenAuth, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, StudioProductionsResource, StudioResource, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
+export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CollectionsResource, CommunityResource, CompetitorsResource, ContinuationRefusedError, CopilotResource, CreaturesResource, CreditsResource, DeveloperAppsResource, EditResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, JobsResource, LibraryResource, LlmResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, OrganizationsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, RecastResource, ReduceResource, SCENE3D_DELIVERY_ASSET_USAGE, SavedPostsResource, Scene3DResource, ShotsResource, StaticTokenAuth, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, StudioProductionsResource, StudioResource, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map