@nodaro/sdk 2.29.0 → 2.31.0

package/dist/chunk-SLPD47SR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-SLPD47SR.js"}

package/dist/chunk-SS3B6PHT.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+// src/resources/llm.ts
+var LlmResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Synchronous forced-schema completion (`POST /v1/llm/structured`). A call
+   * can run several minutes — longer than the client's default 60 s
+   * `timeoutMs`; construct the client with a larger `timeoutMs` for this
+   * call, or use {@link LlmResource.structuredJob}.
+   */
+  structured(input) {
+    return this.client.request("POST", "/v1/llm/structured", { body: input });
+  }
+  /**
+   * The same call as a job (`POST /v1/llm/structured/jobs`): answers `{ jobId }`
+   * at once. Poll `jobs.getStatus(jobId)` — `output_data` is an
+   * {@link LlmStructuredJobOutput}; `error_message` says why a run failed.
+   * `jobs.list({ type: "llm-structured", origin })` finds every run later.
+   * Throws `NotFoundError` on a platform that predates the route. An instance
+   * that proxies its LLM calls to nodaro.ai answers `503 provider_unavailable`
+   * permanently — the SDK surfaces that as a generic `NodaroError` with the
+   * same code; treat it as unavailable here, not as transient.
+   */
+  structuredJob(input) {
+    return this.client.request("POST", "/v1/llm/structured/jobs", { body: input });
+  }
+};
+
+exports.LlmResource = LlmResource;
+//# sourceMappingURL=chunk-SS3B6PHT.cjs.map
+//# sourceMappingURL=chunk-SS3B6PHT.cjs.map

package/dist/chunk-SS3B6PHT.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/llm.ts"],"names":[],"mappings":";;;AAoEO,IAAM,cAAN,MAAkB;AAAA,EACvB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQpB,WAAwB,KAAA,EAA4D;AAClF,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAgC,MAAA,EAAQ,sBAAsB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAClG;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,cAAc,KAAA,EAA0D;AACtE,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,2BAA2B,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAClG;AACF","file":"chunk-SS3B6PHT.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Structured LLM output — `POST /v1/llm/structured` and its asynchronous\n * twin. The platform supplies the model lane, forced JSON-Schema output with\n * validation and error-fed retries, the job row and the credit lifecycle; the\n * caller supplies its own system prompt and schema (an app-owned vocabulary\n * the platform cannot know — Nodaro Studio's production plan is the first).\n */\nexport interface LlmStructuredInput {\n  /** The system prompt (≤ 100,000 chars). */\n  system: string\n  /** The user turn (1–100,000 chars). */\n  input: string\n  /** A JSON Schema OBJECT (`type: \"object\"`, ≤ 64 KB, ≤ 20 levels) in the\n   *  keyword subset the server converts — see the API guide. */\n  jsonSchema: Record<string, unknown>\n  /** Names the forced-output tool the provider sees (≤ 64 chars). */\n  schemaName?: string\n  llmModel?: string\n  reasoningEffort?: string\n  /** Invalid answers fed back with their error before the call fails (0–3, default 2). */\n  maxRetries?: number\n  /** Your app's slug — attribution only; `jobs.list({ origin })` finds the rows. */\n  origin?: string\n  advancedMode?: boolean\n  temperature?: number\n  maxTokens?: number\n}\n\nexport interface LlmStructuredResult<T = unknown> {\n  jobId: string\n  output: T\n  usage: { inputTokens: number; outputTokens: number }\n}\n\nexport interface LlmStructuredJobInput extends LlmStructuredInput {\n  /** Display label stored on the job (≤ 120 chars) — a run list's row title. */\n  label?: string\n  /** Draft FROM this video: the platform analyzes it first (`POST\n   *  /v1/video-analysis`, a separate job you own) and appends the analysis\n   *  to `input` before the LLM call. */\n  videoUrl?: string\n  /** Analysis options, handed to the analysis route unchanged (its tiers). */\n  videoAnalysis?: { llmModel?: string; selectionMode?: \"choose\" | \"combine\" }\n  /** Draft from THIS finished `video-analysis` job of yours instead of\n   *  analyzing `videoUrl` again: no second analysis, no second analysis\n   *  charge — a retry after a failed draft, another model, different\n   *  notes. `videoUrl` may still ride beside it as the record of the source.\n   *  422 when the job is not yours, does not exist, or is not a finished,\n   *  readable video analysis (`analysis_not_found` / `not_analysis` /\n   *  `analysis_failed` / `analysis_not_ready` / `invalid_analysis` — never a\n   *  404, which means the route itself is absent). Not combinable with\n   *  `videoAnalysis`. */\n  analysisJobId?: string\n}\n\n/** `output_data` of an `llm-structured` job as it progresses: `stage` while\n *  running (`analyzing` only for movie runs), then the result. */\nexport interface LlmStructuredJobOutput<T = unknown> {\n  stage?: \"analyzing\" | \"drafting\"\n  output?: T\n  inputTokens?: number\n  outputTokens?: number\n  analysisJobId?: string\n  analysisCredits?: number\n}\n\nexport class LlmResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Synchronous forced-schema completion (`POST /v1/llm/structured`). A call\n   * can run several minutes — longer than the client's default 60 s\n   * `timeoutMs`; construct the client with a larger `timeoutMs` for this\n   * call, or use {@link LlmResource.structuredJob}.\n   */\n  structured<T = unknown>(input: LlmStructuredInput): Promise<LlmStructuredResult<T>> {\n    return this.client.request<LlmStructuredResult<T>>(\"POST\", \"/v1/llm/structured\", { body: input })\n  }\n\n  /**\n   * The same call as a job (`POST /v1/llm/structured/jobs`): answers `{ jobId }`\n   * at once. Poll `jobs.getStatus(jobId)` — `output_data` is an\n   * {@link LlmStructuredJobOutput}; `error_message` says why a run failed.\n   * `jobs.list({ type: \"llm-structured\", origin })` finds every run later.\n   * Throws `NotFoundError` on a platform that predates the route. An instance\n   * that proxies its LLM calls to nodaro.ai answers `503 provider_unavailable`\n   * permanently — the SDK surfaces that as a generic `NodaroError` with the\n   * same code; treat it as unavailable here, not as transient.\n   */\n  structuredJob(input: LlmStructuredJobInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/llm/structured/jobs\", { body: input })\n  }\n}\n"]}

package/dist/chunk-SUCHGNYT.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-SUCHGNYT.js.map
+//# sourceMappingURL=chunk-SUCHGNYT.js.map

package/dist/chunk-SUCHGNYT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-SUCHGNYT.js"}

package/dist/chunk-SYVNY3AH.cjs

@@ -0,0 +1,44 @@
+'use strict';
+
+// 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)}`);
+  }
+};
+
+exports.SavedPostsResource = SavedPostsResource;
+//# sourceMappingURL=chunk-SYVNY3AH.cjs.map
+//# sourceMappingURL=chunk-SYVNY3AH.cjs.map

package/dist/chunk-SYVNY3AH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/saved-posts.ts"],"names":[],"mappings":";;;AAkBO,IAAM,qBAAN,MAAyB;AAAA,EAC9B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,CAAK,MAAA,GAA+B,EAAC,EAAkC;AACrE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA8B,KAAA,EAAO,iBAAA,EAAmB;AAAA,MACzE,KAAA,EAAO;AAAA,QACL,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,KAAK,MAAA,CAAO,GAAA;AAAA,QACZ,GAAG,MAAA,CAAO,CAAA;AAAA,QACV,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,OAAO,MAAA,CAAO;AAAA;AAChB,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KAAK,KAAA,EAA0C;AAC7C,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAmB,MAAA,EAAQ,mBAAmB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAClF;AAAA;AAAA,EAGA,OAAO,OAAA,EAA6D;AAClE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,wBAAA,EAA0B,EAAE,IAAA,EAAM,EAAE,OAAA,EAAQ,EAAG,CAAA;AAAA,EAC5G;AAAA;AAAA,EAGA,MAAA,CAAO,IAAY,KAAA,EAAiD;AAClE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAmB,OAAA,EAAS,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,EAC7G;AAAA;AAAA,EAGA,MAAM,OAAO,EAAA,EAA2B;AACtC,IAAA,MAAM,IAAA,CAAK,OAAO,OAAA,CAA2B,QAAA,EAAU,mBAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACpG;AACF","file":"chunk-SYVNY3AH.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type {\n  ListSavedPostsParams,\n  ListSavedPostsResult,\n  SavePostInput,\n  SavedPost,\n  SavedPostsLookupResult,\n  UpdateSavedPostInput,\n} from \"@nodaro/shared/social\"\n\n/**\n * Saved posts — the inspiration wall.\n *\n * Save a post you found (a Social Search result, `nodes.run(\"social-search\")`)\n * with a note and tags, list and filter your saves, and change or remove them.\n * A save keeps a snapshot of the post and a copy of its still in your storage.\n * OAuth app tokens need `assets:read` for reads and `assets:write` for writes.\n */\nexport class SavedPostsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** `GET /v1/saved-posts` → your saves, newest first. Page with `nextCursor`. */\n  list(params: ListSavedPostsParams = {}): Promise<ListSavedPostsResult> {\n    return this.client.request<ListSavedPostsResult>(\"GET\", \"/v1/saved-posts\", {\n      query: {\n        platform: params.platform,\n        tag: params.tag,\n        q: params.q,\n        cursor: params.cursor,\n        limit: params.limit,\n      },\n    })\n  }\n\n  /**\n   * `POST /v1/saved-posts` → save a post. Saving a post that is already saved\n   * updates its note and tags (when given) and returns the existing save.\n   */\n  save(input: SavePostInput): Promise<SavedPost> {\n    return this.client.request<SavedPost>(\"POST\", \"/v1/saved-posts\", { body: input })\n  }\n\n  /** `POST /v1/saved-posts/lookup` → which of these post ids (`SocialPost.id`) you saved. */\n  lookup(postIds: readonly string[]): Promise<SavedPostsLookupResult> {\n    return this.client.request<SavedPostsLookupResult>(\"POST\", \"/v1/saved-posts/lookup\", { body: { postIds } })\n  }\n\n  /** `PATCH /v1/saved-posts/:id` → change a save's note or tags. */\n  update(id: string, input: UpdateSavedPostInput): Promise<SavedPost> {\n    return this.client.request<SavedPost>(\"PATCH\", `/v1/saved-posts/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /** `DELETE /v1/saved-posts/:id` → remove a save and its copied still. */\n  async delete(id: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/saved-posts/${encodeURIComponent(id)}`)\n  }\n}\n"]}

package/dist/chunk-T3SYREY4.js

@@ -0,0 +1,29 @@
+// src/resources/uploads.ts
+var UploadsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Upload one file (`POST /v1/upload`, multipart — the file rides the `file`
+   * field). The SDK's `request` detects the `FormData` body and lets the
+   * runtime set the multipart boundary. Returns the persisted asset's public
+   * URL + storage metadata (unwraps the `{ data }` envelope). Throws
+   * `StorageExceededError` (413) over the storage cap and the SDK's other typed
+   * errors on the usual statuses.
+   */
+  async upload(file) {
+    const form = new FormData();
+    form.append("file", file);
+    const res = await this.client.request(
+      "POST",
+      "/v1/upload",
+      { body: form }
+    );
+    return res.data;
+  }
+};
+
+export { UploadsResource };
+//# sourceMappingURL=chunk-T3SYREY4.js.map
+//# sourceMappingURL=chunk-T3SYREY4.js.map

package/dist/chunk-T3SYREY4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/uploads.ts"],"names":[],"mappings":";AA4BO,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUpB,MAAM,OAAO,IAAA,EAAmC;AAC9C,IAAA,MAAM,IAAA,GAAO,IAAI,QAAA,EAAS;AAC1B,IAAA,IAAA,CAAK,MAAA,CAAO,QAAQ,IAAI,CAAA;AACxB,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MAC5B,MAAA;AAAA,MACA,YAAA;AAAA,MACA,EAAE,MAAM,IAAA;AAAK,KACf;AACA,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AACF","file":"chunk-T3SYREY4.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Result of a successful `POST /v1/upload`. Mirrors the route's `data` envelope\n * (`backend/src/routes/upload.ts`), the source of truth — keep in sync if that\n * response changes. The route also returns loosely-typed extracted `metadata`;\n * it is omitted here until a consumer needs a typed shape (add it shaped to\n * that need rather than inventing `Record<string, unknown>` surface now).\n */\nexport interface UploadResult {\n  /** Public R2 URL of the stored asset (always present on success). */\n  readonly url: string\n  /** Storage row id; `null` when no asset row was written (e.g. unauthenticated). */\n  readonly assetId: string | null\n  /** Generated thumbnail URL (images/video); `null` for audio or on failure. */\n  readonly thumbnailUrl: string | null\n  /** Server-classified asset category (e.g. \"image\" | \"video\" | \"audio\"). */\n  readonly category: string\n  /** Display filename (server override or the original). */\n  readonly filename: string\n  /** Final MIME type after server normalization. */\n  readonly mimeType: string\n  /** Stored byte size. */\n  readonly sizeBytes: number\n  /** R2 object key. */\n  readonly r2Key: string\n}\n\nexport class UploadsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Upload one file (`POST /v1/upload`, multipart — the file rides the `file`\n   * field). The SDK's `request` detects the `FormData` body and lets the\n   * runtime set the multipart boundary. Returns the persisted asset's public\n   * URL + storage metadata (unwraps the `{ data }` envelope). Throws\n   * `StorageExceededError` (413) over the storage cap and the SDK's other typed\n   * errors on the usual statuses.\n   */\n  async upload(file: File): Promise<UploadResult> {\n    const form = new FormData()\n    form.append(\"file\", file)\n    const res = await this.client.request<{ data: UploadResult }>(\n      \"POST\",\n      \"/v1/upload\",\n      { body: form },\n    )\n    return res.data\n  }\n}\n"]}

package/dist/chunk-T7N7DFQJ.js

@@ -0,0 +1,198 @@
+// src/resources/voices.ts
+var VoicesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * List the premade ElevenLabs voices (`GET /v1/voices`). Falls back to a
+   * curated set server-side when no ElevenLabs API key is configured.
+   */
+  async list() {
+    const res = await this.client.request("GET", "/v1/voices");
+    return res.voices;
+  }
+  /**
+   * Search the shared/community Voice Library (`GET /v1/voices/library`). All
+   * params are optional and forwarded as a querystring; `undefined` / `null` /
+   * empty-string values are omitted so the server defaults apply. `hasMore`
+   * drives "load more" pagination.
+   */
+  searchLibrary(params = {}) {
+    const query = {};
+    for (const [k, v] of Object.entries(params)) {
+      if (v !== void 0 && v !== null && v !== "") query[k] = v;
+    }
+    return this.client.request("GET", "/v1/voices/library", { query });
+  }
+  /**
+   * List the signed-in user's voice clones (`GET /v1/voice-clones`). The route
+   * wraps the rows in `{ voiceClones }`; we unwrap to the bare array.
+   */
+  async listClones() {
+    const res = await this.client.request("GET", "/v1/voice-clones");
+    return res.voiceClones;
+  }
+  /**
+   * @deprecated Voice cloning is no longer offered on Nodaro (retired
+   * 2026-09-15). The route answers `410 voice_cloning_retired` and this call
+   * rejects with that error. Clones created before the retirement are still
+   * listed by {@link VoicesResource.listClones} and still work as voice ids.
+   * For a new custom voice use {@link VoicesResource.design}.
+   */
+  createClone(input) {
+    return this.client.request("POST", "/v1/voice-clones/from-url", { body: input });
+  }
+  /** Delete one of the user's voice clones (`DELETE /v1/voice-clones/:id`). */
+  async deleteClone(id) {
+    await this.client.request("DELETE", `/v1/voice-clones/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Replace the voice in a recording — or in a whole talking video — with a
+   * different voice (`POST /v1/voice-changer`). Pass `audioUrl` to revoice
+   * audio→audio, or `videoUrl` to revoice an entire clip (the server demuxes
+   * the audio, runs speech-to-speech, and remuxes onto the original video,
+   * returning the video plus the new audio track). Exactly one of `audioUrl` /
+   * `videoUrl` is required; when both are sent, video wins. `removeBackgroundNoise`
+   * off keeps the music/SFX bed under the new voice; on yields a clean voice-only
+   * result. Costs credits and runs async — poll `jobs.get(jobId)` for the result
+   * (`output_data.videoUrl` + `output_data.audioUrl` in video mode).
+   */
+  change(input) {
+    return this.client.request("POST", "/v1/voice-changer", { body: input });
+  }
+  /**
+   * Recast each detected speaker in a multi-speaker recording to a different
+   * voice (`POST /v1/voice-changer-pro`). `orderedVoices` maps speaker positions to
+   * voices in detection order — speaker 0 → `orderedVoices[0]`, speaker 1 →
+   * `orderedVoices[1]`, etc. Speakers beyond the end of `orderedVoices` keep
+   * their original voice. Each entry is EITHER a bare voice id (premade name or
+   * ElevenLabs UUID) OR a {@link VoiceChangerProVoice} object carrying per-voice
+   * ElevenLabs speech-to-speech settings (stability / similarityBoost / style /
+   * useSpeakerBoost / `seed`) plus a loudness `volumeMode` (and a manual
+   * `volume`) — OR `null`, meaning keep this speaker's original voice (requires
+   * a platform running cloud-plugins with keep-slot support). At least one
+   * entry must be non-null. A per-voice `seed` makes that speaker's recast
+   * reproducible.
+   *
+   * Pass `audioUrl` for audio-only recast or `videoUrl` to recast the audio
+   * track of a video clip (the server demuxes, recasts, and remuxes).
+   *
+   * Voice and music are ALWAYS separated first — before recasting, the source
+   * is split into an isolated vocal stem and a music/SFX stem.
+   * `preserveBackground` (default `true`) only controls whether that
+   * music/instrumental stem is mixed back under the new voices; set it `false`
+   * for a clean voice-only result. `separationQuality` selects the quality of
+   * the voice/music separation: `"fast"` (default, quicker — preserves more of
+   * the voice) or `"best"` (finer voice/music separation).
+   * `removeBackgroundNoise` additionally denoises the result.
+   * `musicVolumeMode` sets the level of that preserved background (only relevant
+   * when `preserveBackground` is on): `"match"` (default) keeps the original
+   * level, `"normalize"` loudnorms it, `"manual"` uses `musicVolume`%.
+   * `voiceFx` applies a reverb/echo to the COMBINED recast voices BEFORE the
+   * background is mixed back in (effect sits on the voices, not the music bed).
+   *
+   * Cloud-only — costs credits and runs async; poll `jobs.get(jobId)` for the
+   * result (`output_data.videoUrl` + `output_data.audioUrl` in video mode).
+   */
+  recast(input) {
+    return this.client.request("POST", "/v1/voice-changer-pro", { body: input });
+  }
+  /**
+   * Detect the speakers in a clip WITHOUT recasting yet
+   * (`POST /v1/voice-changer-pro/analyze`) — the first step of the interactive
+   * flow. Separates voice from music once and diarizes the vocals, returning the
+   * speaker list so a user (or agent) can choose a voice per speaker before
+   * committing to a paid recast. Poll `jobs.get(jobId)`: the completed job's
+   * `output_data` carries the separated stem urls + the detected `speakers`
+   * (each with `id`, time `segments`, `firstStartSec`, `wordCount`, `snippet`)
+   * and the detected language — reshape it into a {@link VcpAnalysis} and pass it
+   * as `recast({ ..., analysis })` to skip re-detection. With `suggestTitle`,
+   * `output_data.suggestedTitle` also carries an LLM-proposed title.
+   *
+   * Cloud-only; costs credits and runs async.
+   */
+  analyze(input) {
+    return this.client.request("POST", "/v1/voice-changer-pro/analyze", { body: input });
+  }
+  /**
+   * Render a final video from a mixed set of stems
+   * (`POST /v1/voice-changer-pro/export`) — the last step of the interactive
+   * flow. After `recast({ output: "stems" })` hands back the dry per-track stems
+   * and the user has set levels / mutes / an effect in your editor, pass those
+   * `tracks` (plus the source `videoUrl`) here to mix and remux into the finished
+   * video. The video is stream-copied (never re-encoded), so the export is
+   * bit-identical to your preview. At least one track must be un-muted (all-muted
+   * is a 400); `voiceFx` is applied to the voice tracks at render time.
+   *
+   * Cloud-only; costs credits and runs async — poll `jobs.get(jobId)` for the
+   * result (`output_data.videoUrl`).
+   */
+  exportMix(input) {
+    return this.client.request("POST", "/v1/voice-changer-pro/export", { body: input });
+  }
+  /**
+   * Design a brand-new synthetic voice from a text description
+   * (`POST /v1/voice-design`) — ElevenLabs text-to-voice. `text` (100–1000 chars)
+   * is a preview line spoken in the designed voice; `voiceDescription` describes
+   * the voice to create. Costs credits and runs async — poll `jobs.get(jobId)`
+   * for the preview + the reusable voice id.
+   */
+  design(input) {
+    return this.client.request("POST", "/v1/voice-design", { body: input });
+  }
+  /**
+   * Generate speech in a voice described in natural language, without cloning
+   * (`POST /v1/voice-remix`). `text` (1–5000 chars) is spoken in a voice matching
+   * `voiceDescription`. Costs credits and runs async — poll `jobs.get(jobId)`.
+   */
+  remix(input) {
+    return this.client.request("POST", "/v1/voice-remix", { body: input });
+  }
+  /**
+   * Dub an audio clip into another language while preserving each speaker's voice
+   * (`POST /v1/dubbing`). `targetLanguage` is an ISO code (e.g. `"es"`, `"fr"`);
+   * `sourceLanguage` is auto-detected when omitted. Costs credits and runs async
+   * — poll `jobs.get(jobId)`.
+   */
+  dub(input) {
+    return this.client.request("POST", "/v1/dubbing", { body: input });
+  }
+  /**
+   * Voice a multi-speaker script as ONE audio file
+   * (`POST /v1/text-to-dialogue`) on ElevenLabs Dialogue v3 — the default — or
+   * Dialogue v4 (`provider: "elevenlabs-dialogue-v4"`). Each `dialogue` line is
+   * `{ text, voice }` in speaking order — `voice` is a premade voice name or an
+   * ElevenLabs voice UUID (cloned/library voices work too; mixed casts are
+   * fine). At most 5,000 characters total across lines on Dialogue v3 and
+   * 10,000 on Dialogue v4 (≤2,000 recommended for best quality) and 10 unique
+   * voices. Line text may
+   * carry `[audio tags]` like `[laughs]`. Costs credits and runs async — poll
+   * `jobs.get(jobId)` for `output_data.audioUrl` and — on every dialogue model,
+   * since both return timings at no extra credits — `output_data.transcript`, a
+   * `Transcript` (`@nodaro/shared`): `words[]` with `startMs` / `endMs` /
+   * `speaker` and one `segments[]` entry per line, `speaker` being the line's
+   * `voice` as you sent it. Pass `transcript.words` to
+   * `addCaptions({ captions, autoTranscribe: false })` to caption the dialogue
+   * without a second transcription.
+   */
+  textToDialogue(input) {
+    return this.client.request("POST", "/v1/text-to-dialogue", { body: input });
+  }
+  /**
+   * @deprecated Voice cloning is no longer offered on Nodaro (retired
+   * 2026-09-15). The route answers `410 voice_cloning_retired` and this call
+   * rejects with that error. See {@link VoicesResource.createClone}.
+   */
+  createCloneFromFile(input) {
+    const form = new FormData();
+    form.append("name", input.name);
+    const blob = input.file instanceof Blob ? input.file : new Blob([input.file], { type: input.contentType ?? "audio/mpeg" });
+    form.append("file", blob, input.filename ?? "sample");
+    return this.client.request("POST", "/v1/voice-clones", { body: form });
+  }
+};
+
+export { VoicesResource };
+//# sourceMappingURL=chunk-T7N7DFQJ.js.map
+//# sourceMappingURL=chunk-T7N7DFQJ.js.map

package/dist/chunk-T7N7DFQJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/voices.ts"],"names":[],"mappings":"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","file":"chunk-T7N7DFQJ.js","sourcesContent":["import type { Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse } from \"@nodaro/shared/pipeline\"\nimport type { AudioFxPreset } from \"@nodaro/shared/media\"\nimport type { DialogueProvider } from \"@nodaro/shared/models\"\nexport type { Voice, SharedVoice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse } from \"@nodaro/shared/pipeline\"\nexport type { AudioFxPreset } from \"@nodaro/shared/media\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Re-export the shared voice types so SDK consumers don't have to add\n * `@nodaro/shared` as a second dependency just to type a `Voice` row, a\n * `VoiceClone`, or a `searchLibrary` call. Single source of truth lives in\n * `@nodaro/shared`.\n */\n/** Audio-FX preset union (reverb spaces / telephone / megaphone / echo / custom) — used by {@link VoiceChangerProInput.voiceFx}. */\n\n/**\n * Read access to ElevenLabs voices: the premade catalog plus the shared\n * community Voice Library (both public GETs, no body), and the signed-in\n * user's own pre-retirement voice clones (list / delete).\n */\nexport class VoicesResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * List the premade ElevenLabs voices (`GET /v1/voices`). Falls back to a\n   * curated set server-side when no ElevenLabs API key is configured.\n   */\n  async list(): Promise<Voice[]> {\n    const res = await this.client.request<{ voices: Voice[] }>(\"GET\", \"/v1/voices\")\n    return res.voices\n  }\n\n  /**\n   * Search the shared/community Voice Library (`GET /v1/voices/library`). All\n   * params are optional and forwarded as a querystring; `undefined` / `null` /\n   * empty-string values are omitted so the server defaults apply. `hasMore`\n   * drives \"load more\" pagination.\n   */\n  searchLibrary(params: VoiceLibraryParams = {}): Promise<VoiceLibraryResponse> {\n    const query: Record<string, string | number | boolean | undefined> = {}\n    for (const [k, v] of Object.entries(params)) {\n      if (v !== undefined && v !== null && v !== \"\") query[k] = v as string | number | boolean\n    }\n    return this.client.request(\"GET\", \"/v1/voices/library\", { query })\n  }\n\n  /**\n   * List the signed-in user's voice clones (`GET /v1/voice-clones`). The route\n   * wraps the rows in `{ voiceClones }`; we unwrap to the bare array.\n   */\n  async listClones(): Promise<VoiceClone[]> {\n    const res = await this.client.request<{ voiceClones: VoiceClone[] }>(\"GET\", \"/v1/voice-clones\")\n    return res.voiceClones\n  }\n\n  /**\n   * @deprecated Voice cloning is no longer offered on Nodaro (retired\n   * 2026-09-15). The route answers `410 voice_cloning_retired` and this call\n   * rejects with that error. Clones created before the retirement are still\n   * listed by {@link VoicesResource.listClones} and still work as voice ids.\n   * For a new custom voice use {@link VoicesResource.design}.\n   */\n  createClone(input: { name: string; audioUrl: string }): Promise<VoiceClone> {\n    return this.client.request<VoiceClone>(\"POST\", \"/v1/voice-clones/from-url\", { body: input })\n  }\n\n  /** Delete one of the user's voice clones (`DELETE /v1/voice-clones/:id`). */\n  async deleteClone(id: string): Promise<void> {\n    await this.client.request<void>(\"DELETE\", `/v1/voice-clones/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Replace the voice in a recording — or in a whole talking video — with a\n   * different voice (`POST /v1/voice-changer`). Pass `audioUrl` to revoice\n   * audio→audio, or `videoUrl` to revoice an entire clip (the server demuxes\n   * the audio, runs speech-to-speech, and remuxes onto the original video,\n   * returning the video plus the new audio track). Exactly one of `audioUrl` /\n   * `videoUrl` is required; when both are sent, video wins. `removeBackgroundNoise`\n   * off keeps the music/SFX bed under the new voice; on yields a clean voice-only\n   * result. Costs credits and runs async — poll `jobs.get(jobId)` for the result\n   * (`output_data.videoUrl` + `output_data.audioUrl` in video mode).\n   */\n  change(input: {\n    voiceId: string\n    audioUrl?: string\n    videoUrl?: string\n    /** Speech-to-speech model id. Defaults to the server-configured default when omitted. */\n    model?: string\n    stability?: number\n    similarityBoost?: number\n    /** Style exaggeration (0–1). Default 0; >0 amplifies delivery at the cost of latency/stability. */\n    style?: number\n    /** ElevenLabs speaker boost — sharpens fidelity to the target speaker (small latency cost). */\n    useSpeakerBoost?: boolean\n    /** Deterministic speech-to-speech seed (integer 0–4294967295) for reproducible output. Omit for random. */\n    seed?: number\n    removeBackgroundNoise?: boolean\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/voice-changer\", { body: input })\n  }\n\n  /**\n   * Recast each detected speaker in a multi-speaker recording to a different\n   * voice (`POST /v1/voice-changer-pro`). `orderedVoices` maps speaker positions to\n   * voices in detection order — speaker 0 → `orderedVoices[0]`, speaker 1 →\n   * `orderedVoices[1]`, etc. Speakers beyond the end of `orderedVoices` keep\n   * their original voice. Each entry is EITHER a bare voice id (premade name or\n   * ElevenLabs UUID) OR a {@link VoiceChangerProVoice} object carrying per-voice\n   * ElevenLabs speech-to-speech settings (stability / similarityBoost / style /\n   * useSpeakerBoost / `seed`) plus a loudness `volumeMode` (and a manual\n   * `volume`) — OR `null`, meaning keep this speaker's original voice (requires\n   * a platform running cloud-plugins with keep-slot support). At least one\n   * entry must be non-null. A per-voice `seed` makes that speaker's recast\n   * reproducible.\n   *\n   * Pass `audioUrl` for audio-only recast or `videoUrl` to recast the audio\n   * track of a video clip (the server demuxes, recasts, and remuxes).\n   *\n   * Voice and music are ALWAYS separated first — before recasting, the source\n   * is split into an isolated vocal stem and a music/SFX stem.\n   * `preserveBackground` (default `true`) only controls whether that\n   * music/instrumental stem is mixed back under the new voices; set it `false`\n   * for a clean voice-only result. `separationQuality` selects the quality of\n   * the voice/music separation: `\"fast\"` (default, quicker — preserves more of\n   * the voice) or `\"best\"` (finer voice/music separation).\n   * `removeBackgroundNoise` additionally denoises the result.\n   * `musicVolumeMode` sets the level of that preserved background (only relevant\n   * when `preserveBackground` is on): `\"match\"` (default) keeps the original\n   * level, `\"normalize\"` loudnorms it, `\"manual\"` uses `musicVolume`%.\n   * `voiceFx` applies a reverb/echo to the COMBINED recast voices BEFORE the\n   * background is mixed back in (effect sits on the voices, not the music bed).\n   *\n   * Cloud-only — costs credits and runs async; poll `jobs.get(jobId)` for the\n   * result (`output_data.videoUrl` + `output_data.audioUrl` in video mode).\n   */\n  recast(input: VoiceChangerProInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/voice-changer-pro\", { body: input })\n  }\n\n  /**\n   * Detect the speakers in a clip WITHOUT recasting yet\n   * (`POST /v1/voice-changer-pro/analyze`) — the first step of the interactive\n   * flow. Separates voice from music once and diarizes the vocals, returning the\n   * speaker list so a user (or agent) can choose a voice per speaker before\n   * committing to a paid recast. Poll `jobs.get(jobId)`: the completed job's\n   * `output_data` carries the separated stem urls + the detected `speakers`\n   * (each with `id`, time `segments`, `firstStartSec`, `wordCount`, `snippet`)\n   * and the detected language — reshape it into a {@link VcpAnalysis} and pass it\n   * as `recast({ ..., analysis })` to skip re-detection. With `suggestTitle`,\n   * `output_data.suggestedTitle` also carries an LLM-proposed title.\n   *\n   * Cloud-only; costs credits and runs async.\n   */\n  analyze(input: VcpAnalyzeInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/voice-changer-pro/analyze\", { body: input })\n  }\n\n  /**\n   * Render a final video from a mixed set of stems\n   * (`POST /v1/voice-changer-pro/export`) — the last step of the interactive\n   * flow. After `recast({ output: \"stems\" })` hands back the dry per-track stems\n   * and the user has set levels / mutes / an effect in your editor, pass those\n   * `tracks` (plus the source `videoUrl`) here to mix and remux into the finished\n   * video. The video is stream-copied (never re-encoded), so the export is\n   * bit-identical to your preview. At least one track must be un-muted (all-muted\n   * is a 400); `voiceFx` is applied to the voice tracks at render time.\n   *\n   * Cloud-only; costs credits and runs async — poll `jobs.get(jobId)` for the\n   * result (`output_data.videoUrl`).\n   */\n  exportMix(input: VcpExportInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/voice-changer-pro/export\", { body: input })\n  }\n\n  /**\n   * Design a brand-new synthetic voice from a text description\n   * (`POST /v1/voice-design`) — ElevenLabs text-to-voice. `text` (100–1000 chars)\n   * is a preview line spoken in the designed voice; `voiceDescription` describes\n   * the voice to create. Costs credits and runs async — poll `jobs.get(jobId)`\n   * for the preview + the reusable voice id.\n   */\n  design(input: VoiceDesignInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/voice-design\", { body: input })\n  }\n\n  /**\n   * Generate speech in a voice described in natural language, without cloning\n   * (`POST /v1/voice-remix`). `text` (1–5000 chars) is spoken in a voice matching\n   * `voiceDescription`. Costs credits and runs async — poll `jobs.get(jobId)`.\n   */\n  remix(input: VoiceRemixInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/voice-remix\", { body: input })\n  }\n\n  /**\n   * Dub an audio clip into another language while preserving each speaker's voice\n   * (`POST /v1/dubbing`). `targetLanguage` is an ISO code (e.g. `\"es\"`, `\"fr\"`);\n   * `sourceLanguage` is auto-detected when omitted. Costs credits and runs async\n   * — poll `jobs.get(jobId)`.\n   */\n  dub(input: DubbingInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/dubbing\", { body: input })\n  }\n\n  /**\n   * Voice a multi-speaker script as ONE audio file\n   * (`POST /v1/text-to-dialogue`) on ElevenLabs Dialogue v3 — the default — or\n   * Dialogue v4 (`provider: \"elevenlabs-dialogue-v4\"`). Each `dialogue` line is\n   * `{ text, voice }` in speaking order — `voice` is a premade voice name or an\n   * ElevenLabs voice UUID (cloned/library voices work too; mixed casts are\n   * fine). At most 5,000 characters total across lines on Dialogue v3 and\n   * 10,000 on Dialogue v4 (≤2,000 recommended for best quality) and 10 unique\n   * voices. Line text may\n   * carry `[audio tags]` like `[laughs]`. Costs credits and runs async — poll\n   * `jobs.get(jobId)` for `output_data.audioUrl` and — on every dialogue model,\n   * since both return timings at no extra credits — `output_data.transcript`, a\n   * `Transcript` (`@nodaro/shared`): `words[]` with `startMs` / `endMs` /\n   * `speaker` and one `segments[]` entry per line, `speaker` being the line's\n   * `voice` as you sent it. Pass `transcript.words` to\n   * `addCaptions({ captions, autoTranscribe: false })` to caption the dialogue\n   * without a second transcription.\n   */\n  textToDialogue(input: {\n    dialogue: Array<{ text: string; voice: string }>\n    /** Dialogue model: `\"elevenlabs-dialogue\"` (v3, the default) or `\"elevenlabs-dialogue-v4\"`. */\n    provider?: DialogueProvider\n    /** v3: exactly 0, 0.5 or 1 (0 = most variable, 1 = most stable). v4: any value 0–1. */\n    stability?: number\n    /** v4 only (v3 ignores it): how closely each line keeps its voice's character, 0–1. */\n    similarityBoost?: number\n    /** ISO 639-1 language hint (e.g. \"en\"); auto-detected when omitted. */\n    languageCode?: string\n    /** Deterministic sampling seed (integer 0–4294967295). Omit for random. */\n    seed?: number\n    /** Spell out numbers/dates/abbreviations: \"auto\" (default) | \"on\" | \"off\". */\n    applyTextNormalization?: \"auto\" | \"on\" | \"off\"\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/text-to-dialogue\", { body: input })\n  }\n\n  /**\n   * @deprecated Voice cloning is no longer offered on Nodaro (retired\n   * 2026-09-15). The route answers `410 voice_cloning_retired` and this call\n   * rejects with that error. See {@link VoicesResource.createClone}.\n   */\n  createCloneFromFile(input: {\n    name: string\n    file: Blob | Uint8Array | ArrayBuffer\n    /** File name for the upload part (default `sample`). */\n    filename?: string\n    /** MIME type when `file` is a raw buffer (default `audio/mpeg`). */\n    contentType?: string\n  }): Promise<VoiceClone> {\n    const form = new FormData()\n    // Append the name field BEFORE the file so the route sees it in `fields`\n    // (fastify-multipart's `req.file()` exposes fields parsed up to the file).\n    form.append(\"name\", input.name)\n    const blob =\n      input.file instanceof Blob\n        ? input.file\n        : new Blob([input.file as BlobPart], { type: input.contentType ?? \"audio/mpeg\" })\n    form.append(\"file\", blob, input.filename ?? \"sample\")\n    return this.client.request<VoiceClone>(\"POST\", \"/v1/voice-clones\", { body: form })\n  }\n}\n\n/**\n * One entry in {@link VoiceChangerProInput.orderedVoices}. Either a bare voice id\n * (premade name like `\"Rachel\"` or an ElevenLabs UUID for a custom clone), or\n * an object pinning per-voice speech-to-speech settings and the recast's\n * loudness behaviour for that speaker.\n */\nexport type VoiceChangerProVoice =\n  | string\n  | {\n      /** Target voice — premade name (`\"Rachel\"`, `\"Aria\"`, …) or an ElevenLabs UUID for a custom clone. */\n      voiceId: string\n      /**\n       * Which lane converts this speaker. `\"sts\"` (default) is the classic\n       * speech-to-speech recast; `\"v3\"` and `\"v4\"` are RE-SPEAK — the\n       * performance is REGENERATED from the transcript (supports `[audio\n       * tags]`; original delivery is replaced, and lips won't match on video).\n       * A Re-speak speaker needs transcript text: pass an `analysis` whose\n       * `segments[].text` carries it (analyze now emits this), or omit\n       * `analysis` and the engine re-speaks from its own transcription. For\n       * `\"v3\"` (eleven_v3), `stability` accepts exactly 0 / 0.5 / 1, and\n       * `similarityBoost` / `style` / `useSpeakerBoost` are ignored. For\n       * `\"v4\"` (eleven_v4), `stability` takes any value 0–1 and\n       * `similarityBoost` is honoured (`style` / `useSpeakerBoost` ignored);\n       * each line is generated with its neighbouring lines as context for\n       * smoother joins. Both Re-speak engines are priced the same, per started\n       * 1,000 characters.\n       */\n      engine?: \"sts\" | \"v3\" | \"v4\"\n      /** ElevenLabs stability (0–1). Higher = steadier, lower = more expressive. */\n      stability?: number\n      /** ElevenLabs similarity boost (0–1) — how closely the output hugs the target voice's timbre. */\n      similarityBoost?: number\n      /** Style exaggeration (0–1). Default 0; >0 amplifies delivery at the cost of latency / stability. */\n      style?: number\n      /** ElevenLabs speaker boost — sharpens fidelity to the target speaker. */\n      useSpeakerBoost?: boolean\n      /**\n       * Deterministic speech-to-speech seed (integer 0–4294967295) for\n       * reproducible per-voice output — the same source + settings + seed\n       * recast this speaker identically across runs. Omit for a random seed.\n       */\n      seed?: number\n      /**\n       * Loudness handling for this recast voice. `\"match\"` (default) matches the\n       * original speaker's loudness; `\"normalize\"` applies loudness\n       * normalization; `\"manual\"` uses `volume` as a percentage.\n       */\n      volumeMode?: \"match\" | \"normalize\" | \"manual\"\n      /** Manual output volume as a percentage (0–200). Consulted only when `volumeMode === \"manual\"`. */\n      volume?: number\n    }\n\n/** Input for {@link VoicesResource.recast}. */\nexport interface VoiceChangerProInput {\n  /** URL of an audio file to recast (audio → audio). Exactly one of `audioUrl` / `videoUrl` is required. */\n  audioUrl?: string\n  /** URL of a video file to recast (the audio track is recast and remuxed). Exactly one of `audioUrl` / `videoUrl` is required. */\n  videoUrl?: string\n  /**\n   * Voices in speaker-detection order. Speaker N is mapped to `orderedVoices[N]`;\n   * speakers beyond the array keep their original voice. Each entry is a bare\n   * voice id OR a {@link VoiceChangerProVoice} object with per-voice settings —\n   * OR `null`, meaning keep this speaker's original voice (requires a platform\n   * running cloud-plugins with keep-slot support). At least one entry must be\n   * non-null.\n   */\n  orderedVoices: Array<VoiceChangerProVoice | null>\n  /** Model to use for speech-to-speech. Defaults to the server-configured default when omitted. */\n  model?: string\n  /**\n   * Mix the separated music / SFX stem back under the recast voices. Default\n   * `true`. The voice is ALWAYS split out before recasting regardless of this\n   * flag — `false` simply drops the music for a clean voice-only result.\n   */\n  preserveBackground?: boolean\n  /**\n   * Quality of the voice/music separation. `\"fast\"` (default, quicker —\n   * preserves more of the voice) or `\"best\"` (finer voice/music separation).\n   */\n  separationQuality?: \"fast\" | \"best\"\n  /** Strip background noise for a clean voice-only result. */\n  removeBackgroundNoise?: boolean\n  /**\n   * Level of the preserved background music / SFX stem in the final mix. Only\n   * relevant when `preserveBackground` is on (otherwise there is no background to\n   * level). `\"match\"` (default) leaves the separated instrumental at its original\n   * level; `\"normalize\"` applies loudness normalization; `\"manual\"` sets its\n   * level to `musicVolume`%.\n   */\n  musicVolumeMode?: \"match\" | \"normalize\" | \"manual\"\n  /** Background music level as a percentage (0–200). Consulted only when `musicVolumeMode === \"manual\"`. */\n  musicVolume?: number\n  /**\n   * Node-level reverb/echo applied to the COMBINED recast voices **before** the\n   * background is mixed back in (so the effect sits on the voices only, not the\n   * music/SFX bed). Reverb presets (`room`, `hall`, `church`, …) use\n   * `wetDryMix`; the `echo` / `custom` presets use `delayMs` + `decay`. Omit for\n   * no effect.\n   */\n  voiceFx?: {\n    /** Effect preset — reverb space, `telephone`, `megaphone`, `echo`, or `custom`. */\n    preset: AudioFxPreset\n    /** Reverb wet/dry mix as a percentage (0–100). Higher = wetter (more reverb). */\n    wetDryMix?: number\n    /** Echo delay in milliseconds (20–2000). Used by the `echo` / `custom` presets. */\n    delayMs?: number\n    /** Echo decay / feedback (0–1). Higher = more repeats. Used by the `echo` / `custom` presets. */\n    decay?: number\n  }\n  /**\n   * Output mode. `\"video\"` (default) mixes the recast voices with the preserved\n   * background and returns a finished merged video. `\"stems\"` returns the dry,\n   * unleveled per-track stems instead (rendering nothing) so you can drive an\n   * INTERACTIVE mix — adjust levels/mutes/effect in your own UI, then render the\n   * final video with {@link VoicesResource.exportMix}. This is how an app builds\n   * a full editor around VCP rather than a one-shot recast.\n   */\n  output?: \"video\" | \"stems\"\n  /**\n   * A prior {@link VoicesResource.analyze} result. Pass it to SKIP re-detection:\n   * the recast reuses the already-separated stems and speaker segments instead of\n   * running separation + diarization again. This is the fast-path for the\n   * detect → pick voices → recast interactive flow (analyze once, recast N times\n   * as the user tweaks voice assignments). Omit to auto-detect from the source.\n   */\n  analysis?: VcpAnalysis\n}\n\n/** One detected speaker in a {@link VcpAnalysis} (from `analyze`). */\nexport interface VcpAnalysisSpeaker {\n  /** Stable speaker id (first-appearance order). */\n  id: string\n  /** The speaker's spoken time ranges (seconds). `text` is what was said in\n   *  the range — the paid input for a Re-speak speaker (`engine: \"v3\"` or\n   *  `\"v4\"`; editable before conversion); the STS lane ignores it. */\n  segments: Array<{ start: number; end: number; text?: string }>\n  /** When the speaker first speaks (seconds). */\n  firstStartSec?: number\n  /** Rough word count across the clip — a proxy for how much this speaker says. */\n  wordCount?: number\n  /** The first few transcribed words, to help a user tell speakers apart. */\n  snippet?: string\n}\n\n/**\n * The result of {@link VoicesResource.analyze}, reshaped to pass back into\n * {@link VoiceChangerProInput.analysis}. Read a completed analyze job's\n * `output_data` into this shape (it carries the separated stem urls + the\n * detected speakers) and thread it into `recast` to skip re-detection.\n */\nexport interface VcpAnalysis {\n  /** URL of the isolated vocal stem. */\n  vocalsUrl: string\n  /** URL of the separated music/SFX stem (absent when the source had none). */\n  backgroundUrl?: string\n  /** The detected speakers, in first-appearance order. */\n  speakers: VcpAnalysisSpeaker[]\n  /** Scribe's detected language code, round-tripped so the recast auto-selects the STS model. */\n  languageCode?: string\n  /** Confidence (0–1) of {@link VcpAnalysis.languageCode}. */\n  languageProbability?: number\n}\n\n/** Input for {@link VoicesResource.analyze}. */\nexport interface VcpAnalyzeInput {\n  /** URL of an audio file to analyze. Exactly one of `audioUrl` / `videoUrl` is required. */\n  audioUrl?: string\n  /** URL of a video file to analyze (its audio track is used). Exactly one of `audioUrl` / `videoUrl` is required. */\n  videoUrl?: string\n  /** Quality of the voice/music separation run before diarization: `\"fast\"` (default) or `\"best\"`. */\n  separationQuality?: \"fast\" | \"best\"\n  /** Also suggest a conversion title from the transcript (returned on the job's `output_data.suggestedTitle`). */\n  suggestTitle?: boolean\n}\n\n/** One track in a {@link VcpExportInput} mix. */\nexport interface VcpExportTrack {\n  /** URL of the stem for this lane (a recast voice stem or the background stem). */\n  url: string\n  /** Fader position as a percentage: 0 = silent, 100 = unity, 200 = +6dB. */\n  gain: number\n  /** Whether this lane is muted in the mix. */\n  muted: boolean\n  /**\n   * Which bucket the track is in, and so whether `voiceFx` lands on it. Defaults\n   * to `\"voice\"`. Set `\"background\"` for the music/SFX lane (the effect never\n   * touches it).\n   */\n  kind?: \"voice\" | \"background\"\n}\n\n/** Input for {@link VoicesResource.exportMix}. */\nexport interface VcpExportInput {\n  /** The source video to remux the mixed audio onto (stream-copied — never re-encoded). */\n  videoUrl: string\n  /** The mix: one entry per lane. At least one must be un-muted (all-muted is a 400). Max 16 tracks. */\n  tracks: VcpExportTrack[]\n  /**\n   * A reverb/echo applied to the VOICE tracks only (not `\"background\"` lanes)\n   * at render time — so iterating the effect in your editor is free until you\n   * export. Same shape as {@link VoiceChangerProInput.voiceFx}.\n   */\n  voiceFx?: VoiceChangerProInput[\"voiceFx\"]\n}\n\n/** Input for {@link VoicesResource.design}. */\nexport interface VoiceDesignInput {\n  /** A preview line (100–1000 chars) spoken in the designed voice. */\n  text: string\n  /** Natural-language description of the voice to create. */\n  voiceDescription: string\n  /** Voice-design model id. Defaults to the server-configured default. */\n  model?: string\n  /** Output loudness (-1..1). */\n  loudness?: number\n  /** How strongly the description steers the design (0–100). */\n  guidanceScale?: number\n  /** Deterministic seed for a reproducible design. */\n  seed?: number\n  /** Design quality knob (provider-specific). */\n  quality?: number\n  /** Enhance the generated voice. */\n  shouldEnhance?: boolean\n  /** Optional extra prompt context (≤8000 chars). */\n  userPrompt?: string\n}\n\n/** Input for {@link VoicesResource.remix}. */\nexport interface VoiceRemixInput {\n  /** The text (1–5000 chars) to speak in the described voice. */\n  text: string\n  /** Natural-language description of the voice to speak in. */\n  voiceDescription: string\n  /** Optional extra prompt context (≤8000 chars). */\n  userPrompt?: string\n}\n\n/** Input for {@link VoicesResource.dub}. Provide exactly ONE source:\n *  `audioUrl` (dubbed audio out), `videoUrl` (the dubbed VIDEO out, plus the\n *  dubbed audio track as `output_data.audioUrl`), or `sourceUrl` (a public\n *  YouTube/TikTok/direct link ElevenLabs fetches itself). Priced per minute\n *  of the dubbed span; the span is capped at 30 minutes — use\n *  `startTime`/`endTime` to dub part of a longer source. */\nexport interface DubbingInput {\n  /** URL of the audio to dub (audio mode). */\n  audioUrl?: string\n  /** URL of the video to dub — the result is the dubbed VIDEO (+ audio track). */\n  videoUrl?: string\n  /** Public page/media URL (YouTube, TikTok, or a direct link) — ElevenLabs fetches it directly. */\n  sourceUrl?: string\n  /** Target language ISO code (2–10 chars), e.g. `\"es\"`, `\"pt-BR\"`. */\n  targetLanguage: string\n  /** Source language ISO code; auto-detected when omitted. */\n  sourceLanguage?: string\n  /** Expected number of speakers (1–20; 0 = auto-detect) — improves separation when known. */\n  numSpeakers?: number\n  /** Keep the original voices instead of cloning them into the target language. */\n  disableVoiceCloning?: boolean\n  /** Drop the background/music bed from the dubbed output. */\n  dropBackgroundAudio?: boolean\n  /** Dub only this window of the source (seconds). */\n  startTime?: number\n  endTime?: number\n  /** Keep the source resolution on video dubs (slower render). */\n  highestResolution?: boolean\n  useProfanityFilter?: boolean\n  /** Experimental: steer dubbed voices toward an accent. */\n  targetAccent?: string\n  /** Apply ElevenLabs' own watermark to video dubs. */\n  watermark?: boolean\n}\n"]}

package/dist/chunk-TRCENAIY.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chunk-TRCENAIY.cjs.map
+//# sourceMappingURL=chunk-TRCENAIY.cjs.map

package/dist/chunk-TRCENAIY.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-TRCENAIY.cjs"}

package/dist/chunk-TVENC6PH.js

@@ -0,0 +1,186 @@
+export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, SURROUND_DIRECTIONS } from '@nodaro/shared/entities';
+
+// src/resources/locations.ts
+var LocationsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * List the caller's locations. By default returns active locations only;
+   * pass `archived: true` to fetch soft-deleted rows for an "archive" view,
+   * and `q` to keep the ones whose name or description contains it.
+   */
+  list(params = {}) {
+    const query = {};
+    if (params.archived) query.archived = "true";
+    if (params.q) query.q = params.q;
+    if (params.limit !== void 0) query.limit = String(params.limit);
+    if (params.cursor) query.cursor = params.cursor;
+    return this.client.request("GET", "/v1/locations", { query });
+  }
+  /**
+   * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted
+   * rows so callers can drive a UI "Archived" tab without re-encoding the
+   * query param. Mirrors `ObjectsResource.listArchived`.
+   *
+   * `archived` is omitted from the param type — it's always set to `true` here.
+   */
+  listArchived(params = {}) {
+    return this.list({ ...params, archived: true });
+  }
+  /**
+   * Fetch a single location including in-flight asset job state. Soft-deleted
+   * (archived) rows are returned by id intentionally so canvas nodes that
+   * hold a stale `locationDbId` keep loading.
+   */
+  async get(id) {
+    const res = await this.client.request(
+      "GET",
+      `/v1/locations/${encodeURIComponent(id)}`
+    );
+    return { ...res, canonicalDescription: res.canonicalDescription || null };
+  }
+  /**
+   * Create a new location. `name` + `nodeId` are required — the route 400s
+   * otherwise. Returns the new row's id.
+   *
+   * Note: the underlying route is the same `POST /v1/locations` upsert that
+   * powers `update()`. This convenience wrapper enforces the INSERT-required
+   * fields at the type level and never sends an `id`.
+   */
+  create(data) {
+    return this.client.request("POST", "/v1/locations", { body: data });
+  }
+  /**
+   * Update a location. Only the fields you pass are written — undefined keys
+   * are NOT touched on the row. Worker-owned asset buckets are intentionally
+   * not exposed on this surface (see `UpdateLocationInput` for the rationale).
+   *
+   * Optimistic-concurrency: pass `expectedUpdatedAt` to require the row's
+   * `updated_at` still matches; on mismatch the route returns 409
+   * `concurrent_modification`. The SDK surfaces that as a generic
+   * `NodaroError` with the same code.
+   */
+  update(id, data) {
+    return this.client.request("POST", "/v1/locations", {
+      body: { id, ...data }
+    });
+  }
+  /**
+   * Soft-delete (archive) a location. The row is hidden from `list()` by
+   * default but still loadable via `get(id)` so canvas nodes pointing at it
+   * keep working. Restore with `restore(id)`.
+   */
+  delete(id) {
+    return this.client.request("DELETE", `/v1/locations/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Un-archive a location. If the original name now collides (case-
+   * insensitive) with an active row, the server auto-suffixes "(restored)"
+   * and returns the effective name.
+   */
+  restore(id) {
+    return this.client.request("POST", `/v1/locations/${encodeURIComponent(id)}/restore`);
+  }
+  /**
+   * Fire `POST /v1/generate-location` to produce one or more candidate main
+   * images. With `count > 1`, all jobs are reserved up-front before any
+   * is enqueued — mid-batch failures roll back atomically.
+   *
+   * When `attachToLocationId` is set AND `count === 1`, the worker writes
+   * the result directly to the row's `source_image_url`; otherwise you must
+   * call `approveMainImage()` after picking a candidate.
+   */
+  async generate(data) {
+    const res = await this.client.request(
+      "POST",
+      "/v1/generate-location",
+      { body: data }
+    );
+    const jobIds = res.jobIds ?? (res.jobId ? [res.jobId] : []);
+    return res.jobId ? { jobIds, jobId: res.jobId } : { jobIds };
+  }
+  /**
+   * Fire `POST /v1/generate-location-asset` to produce a single variant.
+   * When the studio path is set (`attachToLocationId` + `attachToColumn` +
+   * `attachName`), the worker appends `{ name: attachName, url: <result> }`
+   * to the named JSONB array column on completion.
+   */
+  generateAsset(data) {
+    return this.client.request("POST", "/v1/generate-location-asset", { body: data });
+  }
+  /**
+   * Fire `POST /v1/generate-surround-continuation` to produce one seamless 360°
+   * ring view as an i2i continuation of `referenceImageUrl`. The platform builds
+   * the half-carry composite, paints the missing half, and color-harmonizes it
+   * to the carried half (no tonal seam; carried half stays pixel-exact). When the
+   * studio path is set, the worker appends the result to the location's bucket.
+   */
+  generateSurroundContinuation(data) {
+    return this.client.request("POST", "/v1/generate-surround-continuation", { body: data });
+  }
+  /**
+   * Fire `POST /v1/generate-location-motion` to animate the location's
+   * establishing shot into an atmospheric motion clip. Image-to-video, single
+   * clip per call; the attach column is hardcoded to `atmosphere_motions`
+   * server-side (locations have a single motion bucket so the caller doesn't
+   * supply `attachToColumn`). When the studio path is set
+   * (`attachToLocationId` + `attachName`), the worker appends
+   * `{ name: attachName, url: <result> }` to the row's `atmosphere_motions`
+   * column on completion.
+   */
+  generateMotion(data) {
+    return this.client.request("POST", "/v1/generate-location-motion", { body: data });
+  }
+  /**
+   * Atomically remove ONE asset take (every entry matching `url`) from a
+   * worker-owned bucket column — `POST /v1/locations/:id/remove-asset`. The
+   * worker-owned buckets are deliberately not writable through `update()`
+   * (a stale snapshot would race concurrent worker appends), so deleting a
+   * take — e.g. a 360° surround view being regenerated — goes through this
+   * single-statement server-side filter instead. 404s (`NotFoundError`) when
+   * the url isn't in that bucket or the location isn't yours.
+   */
+  removeAsset(id, data) {
+    return this.client.request(
+      "POST",
+      `/v1/locations/${encodeURIComponent(id)}/remove-asset`,
+      { body: data }
+    );
+  }
+  /**
+   * Approve a completed `generate-location` job as the location's main image.
+   * Sets `source_image_url` and fires the LLM caption (Claude Sonnet vision)
+   * inline. Returns the new main-image URL plus the caption.
+   *
+   * Caption-failure semantics: the route still sends `""` on LLM sub-failure,
+   * but the SDK normalizes `""` → `null` here so `canonicalDescription` carries
+   * the same `string | null` semantics as characters. The main image is still
+   * set; call `recaption()` to retry.
+   */
+  async approveMainImage(id, candidateJobId) {
+    const res = await this.client.request(
+      "POST",
+      `/v1/locations/${encodeURIComponent(id)}/approve-main-image`,
+      { body: { candidateJobId } }
+    );
+    return { sourceImageUrl: res.sourceImageUrl, canonicalDescription: res.canonicalDescription || null };
+  }
+  /**
+   * Re-fire the LLM caption against the location's current main image. 502s
+   * on LLM failure (unlike `approveMainImage` which preserves the side-effect
+   * and returns ""); returns 400 `no_source_image` if no main image is set
+   * yet.
+   */
+  recaption(id) {
+    return this.client.request(
+      "POST",
+      `/v1/locations/${encodeURIComponent(id)}/llm-caption`
+    );
+  }
+};
+
+export { LocationsResource };
+//# sourceMappingURL=chunk-TVENC6PH.js.map
+//# sourceMappingURL=chunk-TVENC6PH.js.map