@nodaro/sdk 2.28.0 → 2.31.0

package/dist/chunk-3QFTP5P5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/audio.ts"],"names":[],"mappings":";AA+CO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQpB,SAAS,KAAA,EAAoI;AAC3I,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,wBAAwB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC/F;AAAA;AAAA,EAGA,QAAQ,KAAA,EAAyD;AAC/D,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,uBAAuB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC9F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,QAAQ,KAAA,EAQuB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,gBAAgB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACvF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,IAAI,KAAA,EAY2B;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,iBAAiB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACxF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,KAAA,EAOkB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,qBAAqB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC5F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,KAAA,EAMoB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,mBAAmB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC1F;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,QAAQ,KAAA,EAA+G;AACrH,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,qBAAqB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC5F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,WAAW,KAAA,EAOoB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,kBAAkB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACzF;AACF","file":"chunk-3QFTP5P5.js","sourcesContent":["import type { AudioFxPreset } from \"@nodaro/shared/media\"\nimport type { TranscribeProvider } from \"@nodaro/shared/models\"\nimport type { Transcript } from \"@nodaro/shared/edl\"\nexport type { TranscribeProvider } from \"@nodaro/shared/models\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * One word of a {@link AudioResource.transcribe} result — caption-shaped, in\n * MILLISECONDS, and structurally the `captions[]` entry `media.addCaptions()`\n * takes, so a word list can be passed straight through. `speaker` is present\n * only on a diarized `elevenlabs-stt` run.\n */\nexport interface TranscribeWord {\n  text: string\n  startMs: number\n  endMs: number\n  timestampMs?: number | null\n  confidence?: number | null\n  speaker?: string\n}\n\n/**\n * A completed transcribe job's `output_data` (read it off `jobs.get(jobId)`).\n *\n * Mind the units: `words` and `json.words` are in MILLISECONDS, while the\n * top-level `segments` are in SECONDS (the raw per-utterance ranges) — present\n * only on the legacy lanes; `elevenlabs-stt` returns none, so read `words`.\n */\nexport interface TranscribeJobOutput {\n  /** The full transcript as one string. */\n  text: string\n  /** Detected (or requested) language code. */\n  language?: string\n  /** Per-word timings, ms — present on the word-level lanes. */\n  words?: TranscribeWord[]\n  /** The normalized {@link Transcript} (ms), the shape `edit.*` consumes. */\n  json?: Transcript\n  /** Per-utterance ranges in SECONDS — not ms, unlike everything above. */\n  segments?: Array<{ start: number; end: number; text: string }>\n}\n\n/**\n * Audio primitives — the building blocks Voice Changer Pro composes internally\n * (separation, isolation, effect, mix, level) plus speech-to-text, exposed\n * standalone so a consumer can run any single step or assemble its own\n * pipeline. Each returns a job id to poll (`jobs.get(jobId)`).\n */\nexport class AudioResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Separate an audio track into stems (`POST /v1/audio-separation`, Demucs).\n   * `mode` `\"vocal_instrumental\"` (default) splits voice from music/SFX;\n   * `\"stems\"` returns the full drums/bass/other/… breakdown. `quality`\n   * `auto` (default) / `fast` / `best`.\n   */\n  separate(input: { audioUrl: string; mode?: \"vocal_instrumental\" | \"stems\"; quality?: \"auto\" | \"fast\" | \"best\" }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/audio-separation\", { body: input })\n  }\n\n  /** Isolate the primary voice and strip background noise (`POST /v1/audio-isolation`, ElevenLabs). */\n  isolate(input: { audioUrl: string }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/audio-isolation\", { body: input })\n  }\n\n  /**\n   * Apply a reverb / echo / telephone / megaphone effect to an audio track\n   * (`POST /v1/audio-fx`) — the same presets VCP's `voiceFx` uses, standalone.\n   * `mix` (0–100) is the reverb wet/dry; `delayMs` + `decay` drive `echo`/`custom`;\n   * `eqLow`/`eqHigh` (dB) shape telephone/megaphone.\n   */\n  applyFx(input: {\n    audioUrl: string\n    preset?: AudioFxPreset\n    mix?: number\n    delayMs?: number\n    decay?: number\n    eqLow?: number\n    eqHigh?: number\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/audio-fx\", { body: input })\n  }\n\n  /**\n   * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`\n   * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set\n   * per-track level. `duck` puts a music bed under speech: every track EXCEPT\n   * `duck.under` (the 0-based index of the voice track) dips while that track\n   * is loud and rises back in its pauses (sidechain compression). `amount`\n   * (0–100, default 75) is how hard; `thresholdDb` (-60–0, default -30),\n   * `ratio` (1–20, overrides `amount`), `attackMs` (1–2000, default 20) and\n   * `releaseMs` (10–9000, default 500) are optional fine controls. A ducked mix\n   * sums its tracks rather than averaging them, so the voice keeps its level;\n   * the price is the same with or without a duck. `endAt` (`\"longest\"`, the\n   * default, or `\"voice\"`) says where the mix ends: `\"voice\"` ends it when the\n   * voice (the `duck.under` track) ends (needs `duck`). A video URL is a track\n   * too: its audio is mixed, and a video with no sound is a silent track.\n   */\n  mix(input: {\n    audioUrls: string[]\n    trackVolumes?: number[]\n    duck?: {\n      under: number\n      amount?: number\n      thresholdDb?: number\n      ratio?: number\n      attackMs?: number\n      releaseMs?: number\n    }\n    endAt?: \"longest\" | \"voice\"\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/mix-audio\", { body: input })\n  }\n\n  /**\n   * Adjust an audio (or a video's audio) level (`POST /v1/adjust-volume`):\n   * `volume` % (default 100), `normalize` to loudnorm, and `fadeIn`/`fadeOut`\n   * seconds. Provide `audioUrl` or `videoUrl`.\n   */\n  adjustVolume(input: {\n    audioUrl?: string\n    videoUrl?: string\n    volume?: number\n    normalize?: boolean\n    fadeIn?: number\n    fadeOut?: number\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/adjust-volume\", { body: input })\n  }\n\n  /**\n   * Shift pitch and/or change tempo with Rubber Band (`POST /v1/pitch-tempo`):\n   * `semitones` −12…+12 (default 0), `tempo` 0.5…2 with the pitch kept\n   * (default 1; fixed at 1 for a video), `preserveFormants` (default true).\n   * Provide exactly one of `audioUrl` or `videoUrl` — a video keeps its picture.\n   * Input up to 30 minutes, priced per started minute.\n   */\n  pitchTempo(input: {\n    audioUrl?: string\n    videoUrl?: string\n    semitones?: number\n    tempo?: number\n    preserveFormants?: boolean\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/pitch-tempo\", { body: input })\n  }\n\n  /**\n   * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each\n   * segment is a `url` with an optional `[startTime, endTime]` sub-range.\n   */\n  combine(input: { segments: Array<{ url: string; startTime?: number; endTime?: number }> }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/combine-audio\", { body: input })\n  }\n\n  /**\n   * Transcribe an audio (or video) track to text (`POST /v1/transcribe`).\n   *\n   * Three engines are accepted. `elevenlabs-stt` (Scribe) is always word-level,\n   * flag or not, and is the only lane that honours `diarize` (who spoke) and\n   * `tagAudioEvents` (laughter, applause, …); `incredibly-fast-whisper` returns\n   * word timings when you ask for them. `whisper` returns NO word timings at\n   * all — named explicitly or reached by OMITTING `provider`, which still falls\n   * back to it — so asking it for them (`wordTimestamps: true`) is rejected with\n   * a `400 validation_error` at ingress, before any credit is spent. A kinetic\n   * caption render therefore has to name one of the other two.\n   *\n   * Poll `jobs.get(jobId)`; the finished job's `output_data` is a\n   * {@link TranscribeJobOutput}: `text` (the whole transcript), `words`\n   * (caption-shaped, in MILLISECONDS), `json` (the normalized\n   * {@link Transcript}, also ms) — and a top-level `segments` array that is in\n   * SECONDS, not ms.\n   *\n   * `words` is the caption source for a kinetic burn-in: hand it to\n   * `media.addCaptions()` as `captions` with `autoTranscribe: false` and the\n   * render uses those exact words (correct the `text` of an entry in between\n   * and the fix is what burns in).\n   */\n  transcribe(input: {\n    audioUrl: string\n    provider?: TranscribeProvider\n    language?: string\n    diarize?: boolean\n    tagAudioEvents?: boolean\n    wordTimestamps?: boolean\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/transcribe\", { body: input })\n  }\n}\n"]}

package/dist/chunk-43FVH6LJ.cjs

@@ -0,0 +1,123 @@
+'use strict';
+
+// src/resources/community.ts
+var CommunityResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * `GET /v1/community/browse` → a page of public listings plus a `nextCursor`.
+   * Pass the returned `nextCursor` back as `cursor` to fetch the next page.
+   */
+  browse(params = {}) {
+    const qs = new URLSearchParams();
+    if (params.entityType) qs.set("entityType", params.entityType);
+    if (params.q) qs.set("q", params.q);
+    if (params.category) qs.set("category", params.category);
+    if (params.sort) qs.set("sort", params.sort);
+    if (params.cursor) qs.set("cursor", params.cursor);
+    if (params.limit !== void 0) qs.set("limit", String(params.limit));
+    const query = qs.toString();
+    return this.client.request(
+      "GET",
+      `/v1/community/browse${query ? `?${query}` : ""}`
+    );
+  }
+  /** `GET /v1/community/detail/:slug` → a single listing by its slug. */
+  get(slug) {
+    return this.client.request(
+      "GET",
+      `/v1/community/detail/${encodeURIComponent(slug)}`
+    );
+  }
+  /**
+   * `GET /v1/community/detail/:slug/full` → the full read-only detail (card
+   * identity + the stored public snapshot). Like {@link get}, but includes the
+   * snapshot asset/voice/text blob needed to render the full cross-user view.
+   */
+  getFull(slug) {
+    return this.client.request(
+      "GET",
+      `/v1/community/detail/${encodeURIComponent(slug)}/full`
+    );
+  }
+  /** `GET /v1/community/favorites` → the listings you've favorited. */
+  favorites() {
+    return this.client.request("GET", "/v1/community/favorites");
+  }
+  /**
+   * `POST /v1/community/listings/:id/clone` → copy a listing into your library.
+   * Returns the new asset's `entityType` and `id`. Requires the `assets:write`
+   * scope when called with an OAuth app token.
+   */
+  clone(id, entityType) {
+    return this.client.request(
+      "POST",
+      `/v1/community/listings/${encodeURIComponent(id)}/clone`,
+      { body: { entityType } }
+    );
+  }
+  /**
+   * `POST /v1/community/listings/:id/favorite` → toggle a favorite. Returns the
+   * resulting `favorited` state (`true` after adding, `false` after removing).
+   */
+  favorite(id) {
+    return this.client.request(
+      "POST",
+      `/v1/community/listings/${encodeURIComponent(id)}/favorite`
+    );
+  }
+  /**
+   * `POST /v1/community/listings/:id/report` → flag a listing for moderation.
+   * `reason` must be one of {@link CommunityReportReason}.
+   */
+  report(id, reason) {
+    return this.client.request(
+      "POST",
+      `/v1/community/listings/${encodeURIComponent(id)}/report`,
+      { body: { reason } }
+    );
+  }
+  /**
+   * `POST /v1/admin/community/:entityType/:id/publish` → share one of YOUR
+   * entities to the community, returning the new listing's `slug` + `id`.
+   *
+   * **Requires an admin token** (the route is `requireAdmin`) AND the caller
+   * must own the source entity. Personal/OAuth tokens without admin role get a
+   * 401. For `character` listings, `params.likenessAttestation` must be `true`.
+   */
+  publish(entityType, entityId, params) {
+    return this.client.request(
+      "POST",
+      `/v1/admin/community/${encodeURIComponent(entityType)}/${encodeURIComponent(entityId)}/publish`,
+      { body: params }
+    );
+  }
+  /**
+   * `DELETE /v1/admin/community/listings/:id` → unshare (deactivate) a listing
+   * you published. **Requires an admin token** (the route is `requireAdmin`).
+   */
+  unpublish(listingId) {
+    return this.client.request(
+      "DELETE",
+      `/v1/admin/community/listings/${encodeURIComponent(listingId)}`
+    );
+  }
+  /**
+   * `GET /v1/admin/community/by-source/:entityType/:sourceId` → look up YOUR
+   * existing listing (if any) for a source entity. Returns `{ data: null }`
+   * when the entity hasn't been shared. **Requires an admin token** (the route
+   * is `requireAdmin`); only returns listings created by the caller.
+   */
+  sharedListing(entityType, sourceId) {
+    return this.client.request(
+      "GET",
+      `/v1/admin/community/by-source/${encodeURIComponent(entityType)}/${encodeURIComponent(sourceId)}`
+    );
+  }
+};
+
+exports.CommunityResource = CommunityResource;
+//# sourceMappingURL=chunk-43FVH6LJ.cjs.map
+//# sourceMappingURL=chunk-43FVH6LJ.cjs.map

package/dist/chunk-43FVH6LJ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/community.ts"],"names":[],"mappings":"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","file":"chunk-43FVH6LJ.cjs","sourcesContent":["import type { CommunityEntityType, CommunitySort, CommunityReportReason, CommunityCard, CommunityFullDetail, BrowseCommunityParams, BrowseCommunityResult, CloneListingResult, FavoriteListingResult, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing } from \"@nodaro/shared/apps\"\nexport type { CommunityEntityType, CommunitySort, CommunityReportReason, CommunityCard, CommunityFullDetail, BrowseCommunityParams, BrowseCommunityResult, CloneListingResult, FavoriteListingResult, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing } from \"@nodaro/shared/apps\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * The community-listing types are the single source of truth in\n * `@nodaro/shared` (re-used by the backend, frontend, and CLI). Re-export them\n * here so SDK consumers don't have to add `@nodaro/shared` as a second\n * dependency just to typecheck `browse`/`clone`/`favorite`/`report`.\n */\n\n/**\n * Community — browse, favorite, clone, and report shared characters,\n * locations, and objects.\n *\n * Publishing is intentionally NOT exposed here: it is admin-only via the\n * editor, and the publish route rejects personal access tokens (which is what\n * the SDK uses).\n */\nexport class CommunityResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * `GET /v1/community/browse` → a page of public listings plus a `nextCursor`.\n   * Pass the returned `nextCursor` back as `cursor` to fetch the next page.\n   */\n  browse(params: BrowseCommunityParams = {}): Promise<BrowseCommunityResult> {\n    const qs = new URLSearchParams()\n    if (params.entityType) qs.set(\"entityType\", params.entityType)\n    if (params.q) qs.set(\"q\", params.q)\n    if (params.category) qs.set(\"category\", params.category)\n    if (params.sort) qs.set(\"sort\", params.sort)\n    if (params.cursor) qs.set(\"cursor\", params.cursor)\n    if (params.limit !== undefined) qs.set(\"limit\", String(params.limit))\n    const query = qs.toString()\n    return this.client.request(\n      \"GET\",\n      `/v1/community/browse${query ? `?${query}` : \"\"}`,\n    )\n  }\n\n  /** `GET /v1/community/detail/:slug` → a single listing by its slug. */\n  get(slug: string): Promise<{ data: CommunityCard }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/community/detail/${encodeURIComponent(slug)}`,\n    )\n  }\n\n  /**\n   * `GET /v1/community/detail/:slug/full` → the full read-only detail (card\n   * identity + the stored public snapshot). Like {@link get}, but includes the\n   * snapshot asset/voice/text blob needed to render the full cross-user view.\n   */\n  getFull(slug: string): Promise<{ data: CommunityFullDetail }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/community/detail/${encodeURIComponent(slug)}/full`,\n    )\n  }\n\n  /** `GET /v1/community/favorites` → the listings you've favorited. */\n  favorites(): Promise<{ data: CommunityCard[] }> {\n    return this.client.request(\"GET\", \"/v1/community/favorites\")\n  }\n\n  /**\n   * `POST /v1/community/listings/:id/clone` → copy a listing into your library.\n   * Returns the new asset's `entityType` and `id`. Requires the `assets:write`\n   * scope when called with an OAuth app token.\n   */\n  clone(id: string, entityType: CommunityEntityType): Promise<CloneListingResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/community/listings/${encodeURIComponent(id)}/clone`,\n      { body: { entityType } },\n    )\n  }\n\n  /**\n   * `POST /v1/community/listings/:id/favorite` → toggle a favorite. Returns the\n   * resulting `favorited` state (`true` after adding, `false` after removing).\n   */\n  favorite(id: string): Promise<FavoriteListingResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/community/listings/${encodeURIComponent(id)}/favorite`,\n    )\n  }\n\n  /**\n   * `POST /v1/community/listings/:id/report` → flag a listing for moderation.\n   * `reason` must be one of {@link CommunityReportReason}.\n   */\n  report(id: string, reason: CommunityReportReason): Promise<ReportListingResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/community/listings/${encodeURIComponent(id)}/report`,\n      { body: { reason } },\n    )\n  }\n\n  /**\n   * `POST /v1/admin/community/:entityType/:id/publish` → share one of YOUR\n   * entities to the community, returning the new listing's `slug` + `id`.\n   *\n   * **Requires an admin token** (the route is `requireAdmin`) AND the caller\n   * must own the source entity. Personal/OAuth tokens without admin role get a\n   * 401. For `character` listings, `params.likenessAttestation` must be `true`.\n   */\n  publish(\n    entityType: CommunityEntityType,\n    entityId: string,\n    params: PublishListingParams,\n  ): Promise<PublishListingResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/admin/community/${encodeURIComponent(entityType)}/${encodeURIComponent(entityId)}/publish`,\n      { body: params },\n    )\n  }\n\n  /**\n   * `DELETE /v1/admin/community/listings/:id` → unshare (deactivate) a listing\n   * you published. **Requires an admin token** (the route is `requireAdmin`).\n   */\n  unpublish(listingId: string): Promise<{ ok: boolean }> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/admin/community/listings/${encodeURIComponent(listingId)}`,\n    )\n  }\n\n  /**\n   * `GET /v1/admin/community/by-source/:entityType/:sourceId` → look up YOUR\n   * existing listing (if any) for a source entity. Returns `{ data: null }`\n   * when the entity hasn't been shared. **Requires an admin token** (the route\n   * is `requireAdmin`); only returns listings created by the caller.\n   */\n  sharedListing(\n    entityType: CommunityEntityType,\n    sourceId: string,\n  ): Promise<{ data: SharedListing | null }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/admin/community/by-source/${encodeURIComponent(entityType)}/${encodeURIComponent(sourceId)}`,\n    )\n  }\n}\n"]}

package/dist/chunk-43NO4SGC.cjs

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

package/dist/chunk-43NO4SGC.cjs.map

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

package/dist/chunk-45CK55BH.cjs

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

package/dist/chunk-45CK55BH.cjs.map

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

package/dist/chunk-4NLVBYMW.js

@@ -0,0 +1,280 @@
+import { readSseStream } from './chunk-JMOKD6ZP.js';
+
+// src/resources/media.ts
+var MediaResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Download a social video (YouTube / TikTok / Instagram / X / Facebook) into
+   * your storage (`POST /v1/download-video`). `maxHeight` caps the resolution
+   * (default "best"); `sectionStartSec` + `sectionEndSec` (both-or-neither) fetch
+   * ONLY that time range instead of the whole video. A download that arrives
+   * with no audio stream FAILS by default (it is usually a degraded source
+   * response, and is retried through other routes first); pass
+   * `requireAudio: false` to accept a clip that really has no sound. Returns a
+   * `downloadId`; progress streams from
+   * `GET /v1/download-video/progress/:downloadId` (server-sent events) and the
+   * finished file lands in your library.
+   */
+  downloadVideo(input) {
+    return this.client.request("POST", "/v1/download-video", { body: input });
+  }
+  /**
+   * Stream the live progress of a {@link MediaResource.downloadVideo} import
+   * (`GET /v1/download-video/progress/:downloadId`, server-sent events) as an
+   * async iterable. Yields a {@link DownloadVideoProgress} roughly every 500ms
+   * until the download reaches `completed` (its event carries the stored
+   * `videoUrl`) or `failed` (its event carries `error`), then ends. The progress
+   * state expires server-side shortly after the download starts existing, so
+   * start iterating promptly after `downloadVideo` returns.
+   *
+   * No request timeout is applied (a large import legitimately takes minutes) —
+   * pass an `AbortSignal` to cancel from the caller.
+   */
+  async *downloadVideoProgress(downloadId, opts = {}) {
+    const url = `${this.client.baseUrl}/v1/download-video/progress/${encodeURIComponent(downloadId)}`;
+    const token = await this.client.auth.getToken();
+    const res = await this.client.fetch(url, {
+      headers: token ? { Authorization: `Bearer ${token}` } : {},
+      signal: opts.signal
+    });
+    yield* readSseStream(res, { label: "progress stream" });
+  }
+  /**
+   * Copy an external media URL into your Nodaro storage (`POST /v1/save-to-storage`)
+   * — a server-side fetch, so nothing round-trips through the client. Poll
+   * `jobs.get(jobId)`.
+   */
+  saveToStorage(input) {
+    return this.client.request("POST", "/v1/save-to-storage", { body: input });
+  }
+  /**
+   * Composite 2–30 images into ONE large 2K/4K collage (`POST /v1/image-collage`).
+   * `layout` `"smart"` (default — justified rows at each image's exact aspect
+   * ratio, no cropping; the output height floats) or `"grid"` (uniform,
+   * letterboxed cells). `imageSizes` is index-aligned with `imageUrls` and
+   * gives per-image RELATIVE size hints for the smart layout: `0` auto
+   * ("don't care", default), `1` big (~2× linear vs medium), `2` medium,
+   * `3` small (~½ linear). All-equal hints change nothing; grid ignores them.
+   * For storyboards, set `numbered` to stamp a 1-based sequence badge at each
+   * image's corner (top-left by default; `badgePosition: "top-right"` moves it;
+   * in `imageUrls` order) and pass `imageLabels`
+   * (index-aligned with `imageUrls`; `null`/`""`/omitted = no caption for that
+   * image) to caption images after the number, e.g. `3 · Close-up`. Badges are
+   * an overlay only — they never change the layout, the output size or the
+   * credit cost. Poll `jobs.get(jobId)` for the finished image.
+   */
+  imageCollage(input) {
+    return this.client.request("POST", "/v1/image-collage", { body: input });
+  }
+  /**
+   * Place 1–12 layers — pictures, real text, QR codes, shapes — on a base image,
+   * pixel-exactly (`POST /v1/image-overlay`) — local, deterministic, no AI.
+   * Every layer position/size is a PERCENT of the base image: `anchor` (nine
+   * positions, default `"center"`), `x`/`y` (offset from the anchor in % of
+   * the base width/height; negative on a right/bottom anchor moves inward),
+   * `width` (% of the base width, default 25 — height follows the layer's
+   * aspect unless `height` is set). Plus `opacity` (0..1), `rotation`
+   * (degrees), `blend` (`"over"` | `"multiply"` | `"screen"`), `fit`,
+   * `shadow` and `roundedCorners`. The output keeps the base's pixel size
+   * unless `canvas` is set. Flat credit cost. Poll `jobs.get(jobId)` for the
+   * finished image.
+   */
+  imageOverlay(input) {
+    return this.client.request("POST", "/v1/image-overlay", { body: input });
+  }
+  /**
+   * Ask a vision model WHERE one overlay layer should sit on a base image
+   * (`POST /v1/image-overlay/suggest-placement`) — it reads the picture and
+   * keeps the element off the faces, the subject and the busiest texture.
+   * The answer comes back in {@link MediaResource.imageOverlay}'s own percent
+   * units — `anchor`, `x`/`y` offsets, `width` — so it drops straight onto a
+   * layer (`const { reason, ...box } = placement`), plus a one-sentence
+   * `reason` you can show a user. Nothing is composited here: apply the
+   * placement yourself.
+   *
+   * `layerAspect` is the element's width / height (1 = square, the default) so
+   * the proposed box stays in proportion; `intent` says what the element is
+   * ("a logo", "a price badge"); `safeArea` is the always-visible region as
+   * fractions of the canvas (a platform preset's safe area), which the
+   * placement is kept inside. Unlike the other media calls this one answers
+   * synchronously — there is nothing to poll; `jobId` is the billing record
+   * (one image-to-text call).
+   */
+  suggestOverlayPlacement(input) {
+    return this.client.request(
+      "POST",
+      "/v1/image-overlay/suggest-placement",
+      { body: input }
+    );
+  }
+  /**
+   * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever
+   * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or
+   * `keepFirst`/`keepLastSeconds`. Poll `jobs.get(jobId)`.
+   */
+  trimVideo(input) {
+    return this.client.request("POST", "/v1/trim-video", { body: input });
+  }
+  /**
+   * Burn captions into a video (`POST /v1/add-captions`). Give the words as
+   * `text`, word-timed `captions[]`, or let it transcribe (`autoTranscribe`,
+   * the default when neither is set).
+   *
+   * `style: "subtitle"` renders statically (FFmpeg) UNLESS it carries a styling
+   * lever, in which case it — like the KINETIC styles (`word-highlight` /
+   * `karaoke` / `tiktok-words` / `word-pop` / `bouncy`) — renders via Remotion.
+   * `look` picks a preset — `outline` (Montserrat 900, UPPERCASE, black outline,
+   * yellow spoken word — the TikTok/Reels read) or `clean`; an UNSET look renders
+   * as `outline`. The explicit STYLING levers (`fontFamily`, `fontWeight`,
+   * `strokeColor`/`strokeWidth`, `uppercase`, `positionY`, `maxWordsPerLine`)
+   * override individual fields of it and now apply to `subtitle` too. Only
+   * `highlightColor` (the spoken-word cursor) and `animate` stay kinetic-only
+   * and are REJECTED on `subtitle`.
+   *
+   * `animate` (default true) freezes the per-word MOTION on the kinetic styles
+   * when set to false — the grouping, line-holding and spoken-word highlight
+   * stay; only the movement stops.
+   *
+   * `maxWordsPerLine` (1-20) caps how many words a line — or a `tiktok-words`
+   * page — may hold, on top of the width budget / sentence ends / pauses that
+   * already close one; it is inert on `word-pop`, which is always one word.
+   * Like every lever here it exists top-level AND per segment, and a segment
+   * that does not name its own inherits the top-level value.
+   *
+   * `segments[]` applies DIFFERENT treatments to non-overlapping time ranges in
+   * one call (e.g. a large top intro, then a small bottom body); a segment that
+   * names its own `look` starts fresh from that preset and does not inherit the
+   * top-level explicit levers. Poll `jobs.get(jobId)`.
+   *
+   * `word-highlight` shows ONE held line at a time and a word's
+   * `startMs`/`endMs` is its SPOKEN window (what times the highlight, not how
+   * long the text is on screen) — so `captions[]` can be handed over verbatim
+   * from an `audio.transcribe()` job's `output_data.words`, with
+   * `autoTranscribe: false`.
+   */
+  addCaptions(input) {
+    const { autoTranscribe, transcribeProvider, ...rest } = input;
+    const body = {
+      ...rest,
+      ...autoTranscribe !== void 0 ? { auto_transcribe: autoTranscribe } : {},
+      ...transcribeProvider !== void 0 ? { transcribe_provider: transcribeProvider } : {}
+    };
+    return this.client.request("POST", "/v1/add-captions", { body });
+  }
+  /**
+   * Trim (and extract) audio from a video or audio source
+   * (`POST /v1/trim-audio`) to `[startTime, endTime]` seconds, in `audioFormat`
+   * (`mp3` default / `wav` / `aac`). Poll `jobs.get(jobId)`.
+   */
+  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,
+   * zero credits. The output duration IS the audio's duration; there is no
+   * duration field. Optional `motion` animates the still (zoom / pan /
+   * ken-burns) at `intensity` 1–10. `fit: "contain"` letterboxes with
+   * `padColor` instead of cropping. Poll `jobs.get(jobId)`.
+   */
+  stillToVideo(input) {
+    return this.client.request("POST", "/v1/still-to-video", { body: input });
+  }
+  /**
+   * Turn 2–100 images + one optional audio track into an MP4 slideshow
+   * (`POST /v1/slideshow`) — locally rendered (FFmpeg), zero credits. With
+   * audio, the output duration IS the audio's duration (equal split unless
+   * `imageDurations` pins rows — null entries = auto; mismatched pinned sums
+   * scale proportionally and the factor is disclosed in the job output).
+   * Without audio: N × `perImageDuration`, silent output. Transitions
+   * consume the outgoing slide, so totals stay exact. For a single image use
+   * `stillToVideo`. Poll `jobs.get(jobId)`.
+   */
+  slideshow(input) {
+    return this.client.request("POST", "/v1/slideshow", { body: input });
+  }
+  /**
+   * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —
+   * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept
+   * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`
+   * in seconds (no `end` = to the end of the video) and a placement: a
+   * `preset` (`"card"`, `"corner-badge"` with a `corner`, `"full-frame"`) or
+   * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary
+   * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field
+   * overrides the preset, and a layer with neither is a corner badge
+   * (bottom-right, or the `corner` it names). `outputAspect` renders onto a
+   * 16:9 / 9:16 / 1:1 / 4:5 canvas
+   * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll
+   * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,
+   * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the
+   * video's end, an animated image's first frame, re-encoded audio).
+   */
+  videoOverlay(input) {
+    return this.client.request("POST", "/v1/video-overlay", { body: input });
+  }
+  /**
+   * Track a subject described in plain text through a video and get a
+   * black-and-white MASK VIDEO back (`POST /v1/video-mask`, SAM 3.1 by default,
+   * or `provider: "sam-3"` at half the price) — white = the subject. Clips up
+   * to 5 minutes at 30 fps (a faster clip counts
+   * proportionally longer), priced by the clip's length. Poll
+   * `jobs.get(jobId)`: the output carries `videoUrl` (the mask), `width`,
+   * `height`, `frames` and `coverage` (the fraction of pixels selected). Feed
+   * the mask to {@link MediaResource.maskComposite}.
+   */
+  videoMask(input) {
+    return this.client.request("POST", "/v1/video-mask", { body: input });
+  }
+  /**
+   * Place a foreground video over a background video through a mask video
+   * (`POST /v1/mask-composite`; white = foreground) — local FFmpeg, no AI.
+   * The result follows the foreground's size, frame rate and length; the
+   * background is fitted (`backgroundFit`, default cover) and loops when
+   * shorter; the mask holds its last frame when shorter. Optional
+   * `invertMask`, `feather` (0–20 px), `grow` (−10–10 px) and `audioSource`
+   * (foreground / background / mix / none). Priced per started 5 seconds of
+   * the result (foreground up to 300 s). Poll `jobs.get(jobId)` for `videoUrl`.
+   */
+  maskComposite(input) {
+    return this.client.request("POST", "/v1/mask-composite", { body: input });
+  }
+  /**
+   * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
+   * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
+   * job. Use it to decide whether to trim before importing.
+   */
+  videoMetadata(input) {
+    return this.client.request("POST", "/v1/video-metadata", { body: input });
+  }
+  /**
+   * Cut or crop a stored file (`POST /v1/media/process`) — synchronous and
+   * free, the source-preparation sibling of the priced `trimVideo` node.
+   * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes
+   * the source object afterwards when it is yours and nothing else references
+   * it ("the cut replaces the original"). Answers the stored file.
+   */
+  process(input) {
+    return this.client.request("POST", "/v1/media/process", { body: input });
+  }
+};
+
+export { MediaResource };
+//# sourceMappingURL=chunk-4NLVBYMW.js.map
+//# sourceMappingURL=chunk-4NLVBYMW.js.map

package/dist/chunk-4NLVBYMW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/media.ts"],"names":[],"mappings":"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","file":"chunk-4NLVBYMW.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport { readSseStream } from \"../sse.js\"\nimport type { OverlayAnchor, VideoMaskRequest, MaskCompositeRequest } from \"@nodaro/shared/media\"\nimport type { CaptionStyle, CaptionLookId, SupportedFontName } from \"@nodaro/shared/captions\"\nimport type { TranscribeLane } from \"@nodaro/shared/models\"\nimport type { VideoOverlayRequest } from \"@nodaro/shared/video\"\n\n/** One word-timed caption entry (one per WORD for the kinetic styles). */\nexport interface CaptionEntry {\n  text: string\n  startMs: number\n  endMs: number\n  timestampMs?: number | null\n  confidence?: number | null\n}\n\n/** Look + motion levers — see {@link MediaResource.addCaptions}. `look` is a\n *  named preset the explicit levers override; an unset look renders as `outline`\n *  (the default). The STYLING levers (`look`, `fontFamily`, `fontWeight`,\n *  `strokeColor`/`strokeWidth`, `uppercase`, `positionY`, `maxWordsPerLine`) now\n *  apply to the static `subtitle` style too — a subtitle carrying any of them\n *  renders via Remotion. Only `highlightColor` (no spoken-word cursor to colour)\n *  and `animate` (no motion to freeze) stay kinetic-only and are rejected (400)\n *  on `subtitle`. */\nexport interface CaptionLookInput {\n  look?: CaptionLookId\n  fontFamily?: SupportedFontName\n  fontWeight?: number\n  strokeColor?: string\n  strokeWidth?: number\n  highlightColor?: string\n  uppercase?: boolean\n  positionY?: number\n  /** Cap on how many words one caption LINE (or `tiktok-words` page) may hold,\n   *  1-20, on TOP of the frame-width budget, sentence ends and pauses that\n   *  already close a line — 1-2 gives the punchy CapCut read, unset fits the\n   *  width. Applies to `word-highlight` / `karaoke` / `bouncy` / `tiktok-words`\n   *  and to a Remotion-rendered `subtitle`; inert on `word-pop` (always one\n   *  word). */\n  maxWordsPerLine?: number\n  /** Kinetic styles only. `false` freezes the per-word MOTION — the grouping,\n   *  line-holding and spoken-word highlight stay, only the movement stops;\n   *  default `true`. Rejected (400) on the static `subtitle` style. */\n  animate?: boolean\n}\n\n/** One caption SEGMENT: a time range with optional style/look overrides and its\n *  own words (`text`/`captions`, else the shared transcript filtered to range).\n *  A segmented render is entirely Remotion, so any `style` is valid here. */\nexport interface CaptionSegmentInput extends CaptionLookInput {\n  startMs: number\n  endMs: number\n  style?: CaptionStyle\n  position?: \"bottom\" | \"top\" | \"center\"\n  fontSize?: number\n  color?: string\n  backgroundColor?: string\n  text?: string\n  captions?: CaptionEntry[]\n}\n\n/** {@link MediaResource.addCaptions} input. */\nexport interface AddCaptionsInput extends CaptionLookInput {\n  videoUrl: string\n  text?: string\n  captions?: CaptionEntry[]\n  /** Transcribe the video's audio when no text/captions are given (default true). */\n  autoTranscribe?: boolean\n  transcribeProvider?: TranscribeLane\n  style?: CaptionStyle\n  position?: \"bottom\" | \"top\" | \"center\"\n  fontSize?: number\n  color?: string\n  backgroundColor?: string\n  /** Apply different treatments to time ranges in one call (non-overlapping). */\n  segments?: CaptionSegmentInput[]\n}\n\n/**\n * Media ingestion + trimming — the source-preparation steps a Voice Changer Pro\n * flow (or any pipeline) needs before it has a clip to work on: pull a social\n * video into storage, copy a remote URL into storage, trim a video/audio to a\n * range, and probe a video's metadata. Each generation-style op returns a job id\n * to poll (`jobs.get(jobId)`); `videoMetadata` is a direct read.\n */\n/**\n * Where one overlay layer should go, in {@link MediaResource.imageOverlay}'s\n * percent units — the answer from {@link MediaResource.suggestOverlayPlacement}.\n */\nexport interface OverlayPlacement {\n  /** The point on the base image the layer attaches to. */\n  anchor: OverlayAnchor\n  /** Offset from the anchor in % of the base width (negative on a right anchor = inward). */\n  x: number\n  /** Offset from the anchor in % of the base height (negative on a bottom anchor = inward). */\n  y: number\n  /** The layer's width in % of the base width. */\n  width: number\n  /** One sentence, plain language, on why this spot. */\n  reason: string\n}\n\nexport class MediaResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Download a social video (YouTube / TikTok / Instagram / X / Facebook) into\n   * your storage (`POST /v1/download-video`). `maxHeight` caps the resolution\n   * (default \"best\"); `sectionStartSec` + `sectionEndSec` (both-or-neither) fetch\n   * ONLY that time range instead of the whole video. A download that arrives\n   * with no audio stream FAILS by default (it is usually a degraded source\n   * response, and is retried through other routes first); pass\n   * `requireAudio: false` to accept a clip that really has no sound. Returns a\n   * `downloadId`; progress streams from\n   * `GET /v1/download-video/progress/:downloadId` (server-sent events) and the\n   * finished file lands in your library.\n   */\n  downloadVideo(input: {\n    url: string\n    maxHeight?: number\n    sectionStartSec?: number\n    sectionEndSec?: number\n    requireAudio?: boolean\n  }): Promise<{ downloadId: string }> {\n    return this.client.request<{ downloadId: string }>(\"POST\", \"/v1/download-video\", { body: input })\n  }\n\n  /**\n   * Stream the live progress of a {@link MediaResource.downloadVideo} import\n   * (`GET /v1/download-video/progress/:downloadId`, server-sent events) as an\n   * async iterable. Yields a {@link DownloadVideoProgress} roughly every 500ms\n   * until the download reaches `completed` (its event carries the stored\n   * `videoUrl`) or `failed` (its event carries `error`), then ends. The progress\n   * state expires server-side shortly after the download starts existing, so\n   * start iterating promptly after `downloadVideo` returns.\n   *\n   * No request timeout is applied (a large import legitimately takes minutes) —\n   * pass an `AbortSignal` to cancel from the caller.\n   */\n  async *downloadVideoProgress(\n    downloadId: string,\n    opts: { signal?: AbortSignal } = {},\n  ): AsyncGenerator<DownloadVideoProgress, void, undefined> {\n    const url = `${this.client.baseUrl}/v1/download-video/progress/${encodeURIComponent(downloadId)}`\n    const token = await this.client.auth.getToken()\n    const res = await this.client.fetch(url, {\n      headers: token ? { Authorization: `Bearer ${token}` } : {},\n      signal: opts.signal,\n    })\n    // The shared reader owns the non-OK throw, the empty-body guard, the frame\n    // parse and the cancel-on-early-exit — this route emits the same\n    // `data: <json>` frames every other stream here does.\n    yield* readSseStream<DownloadVideoProgress>(res, { label: \"progress stream\" })\n  }\n\n  /**\n   * Copy an external media URL into your Nodaro storage (`POST /v1/save-to-storage`)\n   * — a server-side fetch, so nothing round-trips through the client. Poll\n   * `jobs.get(jobId)`.\n   */\n  saveToStorage(input: { mediaUrl: string; filename?: string; mediaType?: \"image\" | \"video\" | \"audio\" }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/save-to-storage\", { body: input })\n  }\n\n  /**\n   * Composite 2–30 images into ONE large 2K/4K collage (`POST /v1/image-collage`).\n   * `layout` `\"smart\"` (default — justified rows at each image's exact aspect\n   * ratio, no cropping; the output height floats) or `\"grid\"` (uniform,\n   * letterboxed cells). `imageSizes` is index-aligned with `imageUrls` and\n   * gives per-image RELATIVE size hints for the smart layout: `0` auto\n   * (\"don't care\", default), `1` big (~2× linear vs medium), `2` medium,\n   * `3` small (~½ linear). All-equal hints change nothing; grid ignores them.\n   * For storyboards, set `numbered` to stamp a 1-based sequence badge at each\n   * image's corner (top-left by default; `badgePosition: \"top-right\"` moves it;\n   * in `imageUrls` order) and pass `imageLabels`\n   * (index-aligned with `imageUrls`; `null`/`\"\"`/omitted = no caption for that\n   * image) to caption images after the number, e.g. `3 · Close-up`. Badges are\n   * an overlay only — they never change the layout, the output size or the\n   * credit cost. Poll `jobs.get(jobId)` for the finished image.\n   */\n  imageCollage(input: {\n    imageUrls: string[]\n    imageSizes?: Array<0 | 1 | 2 | 3>\n    numbered?: boolean\n    imageLabels?: Array<string | null>\n    /** Corner the badges sit in — `\"top-left\"` (default, storyboard convention) or `\"top-right\"`. */\n    badgePosition?: \"top-left\" | \"top-right\"\n    layout?: \"smart\" | \"grid\"\n    resolution?: \"2K\" | \"4K\"\n    aspectRatio?: string\n    gap?: number\n    backgroundColor?: string\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/image-collage\", { body: input })\n  }\n\n  /**\n   * Place 1–12 layers — pictures, real text, QR codes, shapes — on a base image,\n   * pixel-exactly (`POST /v1/image-overlay`) — local, deterministic, no AI.\n   * Every layer position/size is a PERCENT of the base image: `anchor` (nine\n   * positions, default `\"center\"`), `x`/`y` (offset from the anchor in % of\n   * the base width/height; negative on a right/bottom anchor moves inward),\n   * `width` (% of the base width, default 25 — height follows the layer's\n   * aspect unless `height` is set). Plus `opacity` (0..1), `rotation`\n   * (degrees), `blend` (`\"over\"` | `\"multiply\"` | `\"screen\"`), `fit`,\n   * `shadow` and `roundedCorners`. The output keeps the base's pixel size\n   * unless `canvas` is set. Flat credit cost. Poll `jobs.get(jobId)` for the\n   * finished image.\n   */\n  imageOverlay(input: {\n    imageUrl: string\n    layers: Array<{\n      imageUrl: string\n      anchor?: OverlayAnchor\n      x?: number\n      y?: number\n      width?: number\n      height?: number\n      opacity?: number\n      rotation?: number\n      blend?: \"over\" | \"multiply\" | \"screen\"\n      fit?: \"contain\" | \"cover\" | \"stretch\"\n      shadow?: { blur: number; offsetX: number; offsetY: number; color: string; opacity: number }\n      roundedCorners?: number\n      zIndex?: number\n      /** \"image\" (default, needs imageUrl) | \"text\" | \"qr\" | \"shape\" — see @nodaro/shared image-overlay-layers. */\n      kind?: \"image\" | \"text\" | \"qr\" | \"shape\"\n      text?: Record<string, unknown>\n      qr?: Record<string, unknown>\n      shape?: Record<string, unknown>\n      effects?: Record<string, unknown>\n    }>\n    canvas?: { width: number; height: number; backgroundColor?: string }\n    baseFit?: \"contain\" | \"cover\"\n    outputFormat?: \"png\" | \"jpg\" | \"webp\"\n    /** Extra platform renders (see OVERLAY_PLATFORMS in @nodaro/shared); returned as output `variants[]`. */\n    variants?: string[]\n    /** The mask the job also emits as output `maskUrl` (white = may change). Default \"around\". */\n    maskMode?: \"none\" | \"layers\" | \"around\" | \"outside\"\n    maskSpread?: number\n    /** Fills every QR layer whose `qr.fromInput` is true — the node's QR link handle. */\n    qrText?: string\n  }): Promise<{ jobId: string }> {\n    // The finished job's output: { imageUrl, width, height, maskUrl?, variants?: [{ id, label, width, height, url }] }.\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/image-overlay\", { body: input })\n  }\n\n  /**\n   * Ask a vision model WHERE one overlay layer should sit on a base image\n   * (`POST /v1/image-overlay/suggest-placement`) — it reads the picture and\n   * keeps the element off the faces, the subject and the busiest texture.\n   * The answer comes back in {@link MediaResource.imageOverlay}'s own percent\n   * units — `anchor`, `x`/`y` offsets, `width` — so it drops straight onto a\n   * layer (`const { reason, ...box } = placement`), plus a one-sentence\n   * `reason` you can show a user. Nothing is composited here: apply the\n   * placement yourself.\n   *\n   * `layerAspect` is the element's width / height (1 = square, the default) so\n   * the proposed box stays in proportion; `intent` says what the element is\n   * (\"a logo\", \"a price badge\"); `safeArea` is the always-visible region as\n   * fractions of the canvas (a platform preset's safe area), which the\n   * placement is kept inside. Unlike the other media calls this one answers\n   * synchronously — there is nothing to poll; `jobId` is the billing record\n   * (one image-to-text call).\n   */\n  suggestOverlayPlacement(input: {\n    imageUrl: string\n    layerAspect?: number\n    intent?: string\n    safeArea?: { x: number; y: number; w: number; h: number }\n    llmModel?: string\n  }): Promise<{ jobId: string; placement: OverlayPlacement }> {\n    return this.client.request<{ jobId: string; placement: OverlayPlacement }>(\n      \"POST\",\n      \"/v1/image-overlay/suggest-placement\",\n      { body: input },\n    )\n  }\n\n  /**\n   * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever\n   * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or\n   * `keepFirst`/`keepLastSeconds`. Poll `jobs.get(jobId)`.\n   */\n  trimVideo(input: {\n    videoUrl: string\n    startTime?: number\n    endTime?: number\n    trimStartFrames?: number\n    trimEndFrames?: number\n    trimStartSeconds?: number\n    trimEndSeconds?: number\n    keepFirstSeconds?: number\n    keepLastSeconds?: number\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/trim-video\", { body: input })\n  }\n\n  /**\n   * Burn captions into a video (`POST /v1/add-captions`). Give the words as\n   * `text`, word-timed `captions[]`, or let it transcribe (`autoTranscribe`,\n   * the default when neither is set).\n   *\n   * `style: \"subtitle\"` renders statically (FFmpeg) UNLESS it carries a styling\n   * lever, in which case it — like the KINETIC styles (`word-highlight` /\n   * `karaoke` / `tiktok-words` / `word-pop` / `bouncy`) — renders via Remotion.\n   * `look` picks a preset — `outline` (Montserrat 900, UPPERCASE, black outline,\n   * yellow spoken word — the TikTok/Reels read) or `clean`; an UNSET look renders\n   * as `outline`. The explicit STYLING levers (`fontFamily`, `fontWeight`,\n   * `strokeColor`/`strokeWidth`, `uppercase`, `positionY`, `maxWordsPerLine`)\n   * override individual fields of it and now apply to `subtitle` too. Only\n   * `highlightColor` (the spoken-word cursor) and `animate` stay kinetic-only\n   * and are REJECTED on `subtitle`.\n   *\n   * `animate` (default true) freezes the per-word MOTION on the kinetic styles\n   * when set to false — the grouping, line-holding and spoken-word highlight\n   * stay; only the movement stops.\n   *\n   * `maxWordsPerLine` (1-20) caps how many words a line — or a `tiktok-words`\n   * page — may hold, on top of the width budget / sentence ends / pauses that\n   * already close one; it is inert on `word-pop`, which is always one word.\n   * Like every lever here it exists top-level AND per segment, and a segment\n   * that does not name its own inherits the top-level value.\n   *\n   * `segments[]` applies DIFFERENT treatments to non-overlapping time ranges in\n   * one call (e.g. a large top intro, then a small bottom body); a segment that\n   * names its own `look` starts fresh from that preset and does not inherit the\n   * top-level explicit levers. Poll `jobs.get(jobId)`.\n   *\n   * `word-highlight` shows ONE held line at a time and a word's\n   * `startMs`/`endMs` is its SPOKEN window (what times the highlight, not how\n   * long the text is on screen) — so `captions[]` can be handed over verbatim\n   * from an `audio.transcribe()` job's `output_data.words`, with\n   * `autoTranscribe: false`.\n   */\n  addCaptions(input: AddCaptionsInput): Promise<{ jobId: string }> {\n    const { autoTranscribe, transcribeProvider, ...rest } = input\n    // The route body is camelCase except these two flags (worker snake_case);\n    // omit each when unset so an absent flag stays absent on the wire.\n    const body: Record<string, unknown> = {\n      ...rest,\n      ...(autoTranscribe !== undefined ? { auto_transcribe: autoTranscribe } : {}),\n      ...(transcribeProvider !== undefined ? { transcribe_provider: transcribeProvider } : {}),\n    }\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/add-captions\", { body })\n  }\n\n  /**\n   * Trim (and extract) audio from a video or audio source\n   * (`POST /v1/trim-audio`) to `[startTime, endTime]` seconds, in `audioFormat`\n   * (`mp3` default / `wav` / `aac`). Poll `jobs.get(jobId)`.\n   */\n  trimAudio(input: {\n    videoUrl?: string\n    audioUrl?: string\n    audioFormat?: \"mp3\" | \"wav\" | \"aac\"\n    startTime?: number\n    endTime?: number\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/trim-audio\", { body: input })\n  }\n\n  /**\n   * Cut a video and/or an audio file into consecutive parts\n   * (`POST /v1/split-media`). Every part is at most `chunkDuration` seconds and\n   * at least `minPartDuration` (default 4, never above `chunkDuration`) — a\n   * short leftover is evened out with the parts before it. Video is cut on\n   * whole frames with each part's sound matching its picture; audio parts are\n   * sample-exact, in `audioFormat` (`mp3` default / `wav` / `aac`). With both\n   * sources each is split on its own. At most 200 parts per input. Poll\n   * `jobs.get(jobId)`; the parts are on the completed job's `output_data` —\n   * see {@link SplitMediaOutput}.\n   */\n  splitMedia(input: SplitMediaInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/split-media\", { body: input })\n  }\n\n  /**\n   * Turn one still image + one audio track into an MP4\n   * (`POST /v1/still-to-video`) — locally rendered (FFmpeg), no AI model,\n   * zero credits. The output duration IS the audio's duration; there is no\n   * duration field. Optional `motion` animates the still (zoom / pan /\n   * ken-burns) at `intensity` 1–10. `fit: \"contain\"` letterboxes with\n   * `padColor` instead of cropping. Poll `jobs.get(jobId)`.\n   */\n  stillToVideo(input: {\n    imageUrl: string\n    audioUrl: string\n    motion?: \"none\" | \"zoom-in\" | \"zoom-out\" | \"pan-left\" | \"pan-right\" | \"ken-burns\"\n    intensity?: number\n    resolution?: \"720p\" | \"1080p\" | \"4K\"\n    aspectRatio?: \"16:9\" | \"9:16\" | \"1:1\" | \"4:3\"\n    fps?: 24 | 30\n    fit?: \"cover\" | \"contain\"\n    padColor?: string\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/still-to-video\", { body: input })\n  }\n\n  /**\n   * Turn 2–100 images + one optional audio track into an MP4 slideshow\n   * (`POST /v1/slideshow`) — locally rendered (FFmpeg), zero credits. With\n   * audio, the output duration IS the audio's duration (equal split unless\n   * `imageDurations` pins rows — null entries = auto; mismatched pinned sums\n   * scale proportionally and the factor is disclosed in the job output).\n   * Without audio: N × `perImageDuration`, silent output. Transitions\n   * consume the outgoing slide, so totals stay exact. For a single image use\n   * `stillToVideo`. Poll `jobs.get(jobId)`.\n   */\n  slideshow(input: {\n    imageUrls: string[]\n    audioUrl?: string\n    imageDurations?: Array<number | null>\n    perImageDuration?: number\n    transition?: string\n    transitionDuration?: number\n    motion?: \"none\" | \"zoom-in\" | \"zoom-out\" | \"ken-burns\" | \"alternate\"\n    intensity?: number\n    resolution?: \"720p\" | \"1080p\" | \"4K\"\n    aspectRatio?: \"16:9\" | \"9:16\" | \"1:1\" | \"4:3\"\n    fps?: 24 | 30\n    fit?: \"cover\" | \"contain\"\n    padColor?: string\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/slideshow\", { body: input })\n  }\n\n  /**\n   * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —\n   * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept\n   * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`\n   * in seconds (no `end` = to the end of the video) and a placement: a\n   * `preset` (`\"card\"`, `\"corner-badge\"` with a `corner`, `\"full-frame\"`) or\n   * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary\n   * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field\n   * overrides the preset, and a layer with neither is a corner badge\n   * (bottom-right, or the `corner` it names). `outputAspect` renders onto a\n   * 16:9 / 9:16 / 1:1 / 4:5 canvas\n   * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll\n   * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,\n   * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the\n   * video's end, an animated image's first frame, re-encoded audio).\n   */\n  videoOverlay(input: VideoOverlayRequest): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/video-overlay\", { body: input })\n  }\n\n  /**\n   * Track a subject described in plain text through a video and get a\n   * black-and-white MASK VIDEO back (`POST /v1/video-mask`, SAM 3.1 by default,\n   * or `provider: \"sam-3\"` at half the price) — white = the subject. Clips up\n   * to 5 minutes at 30 fps (a faster clip counts\n   * proportionally longer), priced by the clip's length. Poll\n   * `jobs.get(jobId)`: the output carries `videoUrl` (the mask), `width`,\n   * `height`, `frames` and `coverage` (the fraction of pixels selected). Feed\n   * the mask to {@link MediaResource.maskComposite}.\n   */\n  videoMask(input: VideoMaskRequest): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/video-mask\", { body: input })\n  }\n\n  /**\n   * Place a foreground video over a background video through a mask video\n   * (`POST /v1/mask-composite`; white = foreground) — local FFmpeg, no AI.\n   * The result follows the foreground's size, frame rate and length; the\n   * background is fitted (`backgroundFit`, default cover) and loops when\n   * shorter; the mask holds its last frame when shorter. Optional\n   * `invertMask`, `feather` (0–20 px), `grow` (−10–10 px) and `audioSource`\n   * (foreground / background / mix / none). Priced per started 5 seconds of\n   * the result (foreground up to 300 s). Poll `jobs.get(jobId)` for `videoUrl`.\n   */\n  maskComposite(input: MaskCompositeRequest): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/mask-composite\", { body: input })\n  }\n\n  /**\n   * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,\n   * dimensions, title, live status — WITHOUT downloading it. A direct read, not a\n   * job. Use it to decide whether to trim before importing.\n   */\n  videoMetadata(input: { url: string }): Promise<VideoMetadata> {\n    return this.client.request<VideoMetadata>(\"POST\", \"/v1/video-metadata\", { body: input })\n  }\n\n  /**\n   * Cut or crop a stored file (`POST /v1/media/process`) — synchronous and\n   * free, the source-preparation sibling of the priced `trimVideo` node.\n   * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes\n   * the source object afterwards when it is yours and nothing else references\n   * it (\"the cut replaces the original\"). Answers the stored file.\n   */\n  process(input: MediaProcessInput): Promise<{ data: MediaProcessResult }> {\n    return this.client.request<{ data: MediaProcessResult }>(\"POST\", \"/v1/media/process\", { body: input })\n  }\n}\n\n/**\n * One event from {@link MediaResource.downloadVideoProgress}. The stream ends\n * after a `completed` event (which carries the stored `videoUrl` + an optional\n * `thumbnailUrl`) or a `failed` event (which carries `error`).\n */\nexport interface DownloadVideoProgress {\n  phase: \"downloading\" | \"processing\" | \"uploading\" | \"completed\" | \"failed\"\n  /** Download percent (0–100). Section fetches report jumpy percents — display, don't sum. */\n  percent: number\n  /** The imported video's storage URL — set on the `completed` event. */\n  videoUrl?: string\n  /** Thumbnail storage URL — set on the `completed` event when one was captured. */\n  thumbnailUrl?: string\n  /** What went wrong — set on the `failed` event. */\n  error?: string\n}\n\n/** Result of {@link MediaResource.videoMetadata}. Fields are best-effort — a probe may omit some. */\nexport interface VideoMetadata {\n  durationSec?: number | null\n  width?: number | null\n  height?: number | null\n  title?: string | null\n  isLive?: boolean\n  [key: string]: unknown\n}\n\n/** Body of {@link MediaResource.splitMedia} (`POST /v1/split-media`). At least one of `videoUrl` / `audioUrl`. */\nexport interface SplitMediaInput {\n  /** Video to split. */\n  videoUrl?: string\n  /** Audio file to split (split on its own when a video is given too). */\n  audioUrl?: string\n  /** The longest a part may be, in seconds (at least 1). Every part is at most this long. */\n  chunkDuration: number\n  /** The shortest a part may be, in seconds (0 or more, default 4). Must not exceed `chunkDuration` (400 otherwise). */\n  minPartDuration?: number\n  /** Format of the audio parts. Default `mp3`. */\n  audioFormat?: \"mp3\" | \"wav\" | \"aac\"\n}\n\n/** A completed split-media job's `output_data`. */\nexport interface SplitMediaOutput {\n  /** The video parts, in order (when a video was split). */\n  videoUrls?: string[]\n  /** The audio parts, in order (when an audio file was split). */\n  audioUrls?: string[]\n  /** The number of parts — the larger of the two lists. */\n  chunkCount: number\n  /** Each part's exact length in seconds: the video parts' when a video was split, else the audio parts'. */\n  partDurationsSec?: number[]\n  /** The audio parts' lengths, only when BOTH a video and an audio file were split. */\n  audioPartDurationsSec?: number[]\n}\n\nexport interface MediaProcessInput {\n  sourceUrl: string\n  type: \"video\" | \"audio\"\n  trim?: { startTime: number; endTime: number }\n  crop?: { x: number; y: number; width: number; height: number }\n  format?: \"mp4\" | \"webm\" | \"mp3\" | \"wav\" | \"m4a\" | \"aac\"\n  deleteSource?: boolean\n}\n\nexport interface MediaProcessResult {\n  url: string\n  thumbnailUrl: string | null\n  assetId: string | null\n  sizeBytes: number\n  mimeType: string\n  metadata: Record<string, unknown>\n}\n"]}