@nodaro/sdk 2.16.0 → 2.18.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { SCENE3D_V2_LIMITS, 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, SURROUND_DIRECTIONS, USAGE_GROUP_BYS, WORKSPACE_HEADER, nodeStateMayCarryOutput, unwrapEditPlanOutput } from '@nodaro/shared';
+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';
 
@@ -577,7 +577,7 @@ var NodesResource = class {
    *
    * @param type        Node type slug, applied to every entry.
    * @param paramsList  One request body per candidate.
-   * @param opts        Shared `signal` / `onProgress` / `pollMs` / `maxMs`.
+   * @param opts        Shared `signal` / `cancelOnAbort` / `onProgress` / `pollMs` / `maxMs`.
    */
   async runMany(type, paramsList, opts = {}) {
     if (opts.signal?.aborted) throw new JobAbortedError();
@@ -591,11 +591,23 @@ var NodesResource = class {
       })
     );
   }
+  /** {@link pollUntilSettled}, plus what an abort does to the job: it keeps
+   *  running unless `cancelOnAbort` asks to cancel it too, and the rejection
+   *  always names it (an abort landing mid-sleep carries no id of its own). */
+  async pollJob(jobId, label, opts) {
+    try {
+      return await this.pollUntilSettled(jobId, label, opts);
+    } catch (err) {
+      if (!(err instanceof JobAbortedError)) throw err;
+      if (opts.cancelOnAbort) await this.client.jobs.cancel(jobId).catch(() => void 0);
+      throw err.jobId ? err : new JobAbortedError(err.message, jobId);
+    }
+  }
   /** Poll an already-kicked job id until it stops moving; resolve output_data
    *  or throw. Two non-terminal statuses end the loop: an abort, and
    *  `pending_review` (a job policy held the output for a human — see
    *  {@link JobHeldError}). */
-  async pollJob(jobId, label, opts) {
+  async pollUntilSettled(jobId, label, opts) {
     const pollMs = opts.pollMs ?? DEFAULT_POLL_MS;
     const maxMs = opts.maxMs ?? DEFAULT_MAX_MS;
     const deadline = Date.now() + maxMs;
@@ -1672,7 +1684,7 @@ var PipelinesResource = class {
    * self-advances to completion; poll {@link get} for status and
    * {@link getTimeline} for the assembled output. In manual/guided mode, drive
    * it with {@link pendingApprovals} + {@link approveStage} /
-   * {@link approveSubGate}.
+   * {@link approveSubGate} / {@link acceptMatchCutBreak}.
    *
    * Requires `pipelines:execute` scope. Returns the new pipeline id.
    */
@@ -1740,8 +1752,10 @@ var PipelinesResource = class {
     );
   }
   /**
-   * Approve a Stage-7 sub-gate (`dialogue_recheck` / `silent_cut`) so the
-   * orchestrator resumes from the next sub-step. Requires `pipelines:approve`.
+   * Approve a Stage 7 (`animate_audio_edit`) sub-gate — `silent_cut_preview`
+   * or `dialogue_recheck` — so the orchestrator resumes from the next
+   * sub-step. Stage 6's `match_cut_break_pending` is not approved here: accept
+   * each break with {@link acceptMatchCutBreak}. Requires `pipelines:approve`.
    */
   approveSubGate(id, gate) {
     return this.client.request(
@@ -1750,6 +1764,20 @@ var PipelinesResource = class {
       { body: {} }
     );
   }
+  /**
+   * Accept one match-cut break Stage 6 (`scene_images`) flagged. While any
+   * break is pending, the stage pauses at the `match_cut_break_pending`
+   * sub-gate, and its output lists the pending shot ids; accepting the last
+   * one resumes the stage. `sceneId` is the scene entity that holds the shot.
+   * Requires `pipelines:approve`.
+   */
+  acceptMatchCutBreak(id, sceneId, shotId) {
+    return this.client.request(
+      "POST",
+      `/v1/pipelines/${encodeURIComponent(id)}/entities/${encodeURIComponent(sceneId)}/helpers/accept_match_cut_break`,
+      { body: { shotId } }
+    );
+  }
   /**
    * Read a single stage's `status`, `output`, and `critic_feedback`. Useful for
    * inspecting the script/plan before approving. Requires `pipelines:read`.
@@ -2588,6 +2616,139 @@ var PresetsResource = class {
   }
 };
 
+// src/resources/saved-posts.ts
+var SavedPostsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** `GET /v1/saved-posts` → your saves, newest first. Page with `nextCursor`. */
+  list(params = {}) {
+    return this.client.request("GET", "/v1/saved-posts", {
+      query: {
+        platform: params.platform,
+        tag: params.tag,
+        q: params.q,
+        cursor: params.cursor,
+        limit: params.limit
+      }
+    });
+  }
+  /**
+   * `POST /v1/saved-posts` → save a post. Saving a post that is already saved
+   * updates its note and tags (when given) and returns the existing save.
+   */
+  save(input) {
+    return this.client.request("POST", "/v1/saved-posts", { body: input });
+  }
+  /** `POST /v1/saved-posts/lookup` → which of these post ids (`SocialPost.id`) you saved. */
+  lookup(postIds) {
+    return this.client.request("POST", "/v1/saved-posts/lookup", { body: { postIds } });
+  }
+  /** `PATCH /v1/saved-posts/:id` → change a save's note or tags. */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/saved-posts/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** `DELETE /v1/saved-posts/:id` → remove a save and its copied still. */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/saved-posts/${encodeURIComponent(id)}`);
+  }
+};
+
+// src/resources/competitors.ts
+var CompetitorsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** `GET /v1/competitors` → every tracked brand. */
+  async list() {
+    const res = await this.client.request("GET", "/v1/competitors");
+    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)}`);
+  }
+  /** `POST /v1/competitors` → track a brand. Accounts take handles or links. */
+  create(input) {
+    return this.client.request("POST", "/v1/competitors", { body: input });
+  }
+  /**
+   * `PATCH /v1/competitors/:id` → change its accounts, platforms, name or schedule.
+   * `accounts` replaces the whole set: pass every account to keep. Send
+   * `schedule` only to change it (it restarts the brand's schedule). While a
+   * scan of the brand runs, a change to its name, accounts, platforms or
+   * `isOwn` is refused with `409 scan_running`.
+   */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/competitors/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** `DELETE /v1/competitors/:id` → stop tracking it (its scans go too). */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/competitors/${encodeURIComponent(id)}`);
+  }
+  /** `GET /v1/competitors/cards` → every action card, most urgent first, with the posts they rest on. */
+  cards() {
+    return this.client.request("GET", "/v1/competitors/cards");
+  }
+  /**
+   * `GET /v1/competitors/:id/lessons` → what works for a brand: per platform,
+   * what its best posts share, measured on its own posts across every stored
+   * scan, with the posts each lesson rests on (free). "What works for you" on
+   * the brand marked as yours.
+   */
+  lessons(id) {
+    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}/lessons`);
+  }
+  /**
+   * `GET /v1/competitors/actions` → the cards you marked "I did this", newest
+   * first, each with how it went (`outcome`), and your track record per
+   * family of advice (free). Each scan of your own brand judges the post that
+   * came of a card once it is a few days old; the first verdict stays.
+   */
+  tried() {
+    return this.client.request("GET", "/v1/competitors/actions");
+  }
+  /**
+   * `POST /v1/competitors/actions` → "I did this" on a card on your wall (its
+   * `id` from `cards()`), optionally with the link to your post that came of
+   * it. Only cards whose advice ends in a post of yours can be marked
+   * (`400 not_measurable`). Marking a marked card returns its mark
+   * (`created: false`).
+   */
+  markDone(cardId, options = {}) {
+    return this.client.request("POST", "/v1/competitors/actions", { body: { cardId, ...options.postUrl ? { postUrl: options.postUrl } : {} } });
+  }
+  /**
+   * `PATCH /v1/competitors/actions/:id` → link the post that came of a marked
+   * card (the post's full link; a short link is refused with `400
+   * short_link`), or `null` to remove the link. Another post is judged afresh.
+   */
+  linkPost(markId, postUrl) {
+    return this.client.request("PATCH", `/v1/competitors/actions/${encodeURIComponent(markId)}`, { body: { postUrl } });
+  }
+  /** `PATCH /v1/competitors/actions/:id` with `seen: true` → you have seen its verdict (the app stops announcing it). */
+  markSeen(markId) {
+    return this.client.request("PATCH", `/v1/competitors/actions/${encodeURIComponent(markId)}`, { body: { seen: true } });
+  }
+  /** `DELETE /v1/competitors/actions/:id` → undo "I did this" (its verdict leaves your track record). */
+  async unmark(markId) {
+    await this.client.request("DELETE", `/v1/competitors/actions/${encodeURIComponent(markId)}`);
+  }
+  /** `POST /v1/competitor-discover` → a brand's accounts found from its website (free; guesses are marked). */
+  discover(website) {
+    return this.client.request("POST", "/v1/competitor-discover", { body: { website } });
+  }
+  /**
+   * `POST /v1/competitor-scan` → scan a brand now. Answers with a job id;
+   * poll `client.jobs.getStatus(jobId)`, then read `get(id)` or `cards()`.
+   */
+  scan(id) {
+    return this.client.request("POST", "/v1/competitor-scan", { body: { competitorId: id } });
+  }
+};
+
 // src/resources/picker-catalogs.ts
 var PickerCatalogsResource = class {
   constructor(client) {
@@ -2624,7 +2785,8 @@ var CatalogsResource = class {
   }
   client;
   /** Every catalog, projected & pack-composed (honors the deployment's
-   *  registered vendored packs). Cached publicly 5 min. */
+   *  registered vendored packs). Cached publicly 5 min. `data` is absent
+   *  when the deployment registered no packs (`curated: false`). */
   list(opts = {}) {
     const qs = opts.detail ? `?detail=${opts.detail}` : "";
     return this.client.request("GET", `/v1/catalogs${qs}`);
@@ -3615,12 +3777,21 @@ var EditResource = class {
    * on nodaro.ai it runs directly.
    */
   editPlan(input) {
+    const planned = resolveEditPlanSources(input.sources, {
+      offsets: input.offsets,
+      transcriptSourceId: input.transcriptSourceId
+    });
+    if (!planned.ok) {
+      const message = planned.issues.map((issue) => 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;
     return this.client.request("POST", "/v1/edit-plan", {
       body: {
         mode: input.mode,
         planTier: input.planTier,
-        transcript: input.transcript,
-        sources: input.sources,
+        transcript,
+        sources: planned.sources,
         ...input.silence !== void 0 ? { silence: input.silence } : {},
         ...input.instructions !== void 0 ? { instructions: input.instructions } : {},
         ...input.styleGuide !== void 0 ? { styleGuide: input.styleGuide } : {},
@@ -3632,6 +3803,37 @@ var EditResource = class {
       }
     });
   }
+  /**
+   * Camera Switch (podcast B5): choose which camera shows each cut of `edl`
+   * by who is speaking — the sound never changes. Cloud edition; a flat
+   * price. The finished job's `output_data.json` is the switched EDL (feed it
+   * to {@link applyEdl}) and `output_data.transcript` the transcript with
+   * `speakerNames` applied. A transcript with no speaker labels rejects with
+   * a {@link NodaroError} (`code: "no_speakers"`) before any request or charge.
+   */
+  cameraSwitch(input) {
+    if (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",
+        422
+      ));
+    }
+    return this.client.request("POST", "/v1/camera-switch", {
+      body: {
+        edl: input.edl,
+        transcript: input.transcript,
+        ...input.speakerMap !== void 0 ? { speakerMap: input.speakerMap } : {},
+        ...input.speakerNames !== void 0 ? { speakerNames: input.speakerNames } : {},
+        ...input.minShotMs !== void 0 ? { minShotMs: input.minShotMs } : {},
+        ...input.leadMs !== void 0 ? { leadMs: input.leadMs } : {},
+        ...input.maxShotMs !== void 0 ? { maxShotMs: input.maxShotMs } : {},
+        ...input.wideEvery !== void 0 ? { wideEvery: input.wideEvery } : {},
+        ...input.layoutHints !== void 0 ? { layoutHints: input.layoutHints } : {},
+        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
+      }
+    });
+  }
   /**
    * Remap a transcript through an EDL — a PURE client-side transform (NO
    * request). Returns a new transcript whose word (and segment) timings are on
@@ -3643,7 +3845,7 @@ var EditResource = class {
     return remapTranscriptThroughEdl(edl, transcript);
   }
 };
-var SDK_VERSION = "2.16.0" ;
+var SDK_VERSION = "2.18.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -3689,6 +3891,8 @@ var NodaroClient = class _NodaroClient {
   uploads;
   library;
   presets;
+  savedPosts;
+  competitors;
   pickerCatalogs;
   catalogs;
   models;
@@ -3737,6 +3941,8 @@ var NodaroClient = class _NodaroClient {
     this.uploads = new UploadsResource(this);
     this.library = new LibraryResource(this);
     this.presets = new PresetsResource(this);
+    this.savedPosts = new SavedPostsResource(this);
+    this.competitors = new CompetitorsResource(this);
     this.pickerCatalogs = new PickerCatalogsResource(this);
     this.catalogs = new CatalogsResource(this);
     this.models = new ModelsResource(this);
@@ -3906,6 +4112,6 @@ function supabaseAuth(supabase) {
   };
 }
 
-export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CommunityResource, 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, 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, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map