@nodaro/sdk 2.25.0 → 2.26.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { SCENE3D_V2_LIMITS, resolveEditPlanSources, describeAudioSyncOffsetIssue, transcriptSpeakerLabels, remapTranscriptThroughEdl, WORKSPACE_HEADER } from '@nodaro/shared';
+import { nodeRunRoute, NODE_TYPES_WITHOUT_RUN_ROUTE, SOCIAL_POST_NODE_PLATFORM, NODE_RUN_ROUTES, 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';
@@ -189,7 +189,7 @@ function throwFromResponse(status, body) {
     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 +539,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 +556,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 +581,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 +2395,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,
@@ -2601,6 +2624,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
@@ -4054,7 +4094,7 @@ var EditResource = class {
     return remapTranscriptThroughEdl(edl, transcript);
   }
 };
-var SDK_VERSION = "2.25.0" ;
+var SDK_VERSION = "2.26.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {