sonilo 0.4.0 → 0.5.1

package/dist/index.d.cts

@@ -239,6 +239,41 @@ interface VideoToVideoSfxParams {
     prompt?: string;
     segments?: SfxSegment[];
 }
+/** Params for `videoToSound` and `videoToVideoSound`. Both endpoints take the
+ * identical form, so they share one params type. */
+interface VideoToSoundParams {
+    video?: VideoInput;
+    videoUrl?: string;
+    /** Style hint for the generated music bed. */
+    musicPrompt?: string;
+    /** Description of the sound effects layered over the music. */
+    sfxPrompt?: string;
+    /** Per-segment SFX descriptions; must start at 0 and be contiguous. */
+    segments?: SfxSegment[];
+    /** Keep the source speech in the result. */
+    preserveSpeech?: boolean;
+    /** Duck the generated music under the source speech. Default-ON
+     * server-side: leave unset to keep it on, pass `false` to opt out. */
+    ducking?: boolean;
+}
+/** Result of a `videoToSound` / `videoToVideoSound` task (`tasks.get`) or its
+ * final state (`generate`).
+ *
+ * The combined music+SFX result is `output_url` — a bare presigned URL rather
+ * than a media object, since these endpoints render one artifact whose kind is
+ * announced by `output_type` ("audio" for video-to-sound, "video" for
+ * video-to-video-sound). `music`, `music_processed` and `sfx` are the
+ * individual stems; pass any of them, or `output_url` itself, to `download()`. */
+interface SoundResult extends BaseTaskResult {
+    output_url?: string;
+    output_type?: "audio" | "video";
+    output_bytes?: number;
+    music?: SfxMedia;
+    /** Present only when `preserveSpeech`/`ducking` altered the music bed. */
+    music_processed?: SfxMedia;
+    sfx?: SfxMedia;
+    duration_seconds?: number;
+}
 
 declare class Account {
     private readonly client;
@@ -332,6 +367,24 @@ declare class VideoToVideoSfx {
     generate(params: VideoToVideoSfxParams, opts?: WaitOptions): Promise<VideoResult>;
 }
 
+/** Generate a combined music + sound-effects track for a video and get back
+ * the mixed audio. Async only. */
+declare class VideoToSound {
+    private readonly client;
+    constructor(client: SoniloClient);
+    submit(params: VideoToSoundParams): Promise<SfxTask>;
+    generate(params: VideoToSoundParams, opts?: WaitOptions): Promise<SoundResult>;
+}
+
+/** Generate a combined music + sound-effects track for a video and get back a
+ * re-hosted video with that track muxed in. Async only. */
+declare class VideoToVideoSound {
+    private readonly client;
+    constructor(client: SoniloClient);
+    submit(params: VideoToSoundParams): Promise<SfxTask>;
+    generate(params: VideoToSoundParams, opts?: WaitOptions): Promise<SoundResult>;
+}
+
 interface SoniloClientOptions {
     /** Defaults to the SONILO_API_KEY environment variable (Node.js only). */
     apiKey?: string;
@@ -341,6 +394,14 @@ interface SoniloClientOptions {
     fetch?: typeof globalThis.fetch;
     /** Milliseconds before an in-flight request is aborted. Default 600000. */
     timeout?: number;
+    /**
+     * Identifies a wrapper built on this SDK (the CLI, the video kit) in the
+     * `X-Sonilo-Client` header. Leave unset for direct SDK use — without an
+     * override a wrapper's traffic is indistinguishable from the SDK's own.
+     */
+    clientName?: string;
+    /** Version reported alongside `clientName`. Defaults to the SDK's version. */
+    clientVersion?: string;
 }
 /** Milliseconds before an in-flight request is aborted, unless overridden. */
 declare const DEFAULT_TIMEOUT_MS = 600000;
@@ -349,6 +410,8 @@ declare class SoniloClient {
     private readonly apiKey;
     private readonly fetchFn;
     private readonly timeout;
+    private readonly clientName;
+    private readonly clientVersion;
     readonly account: Account;
     readonly tasks: Tasks;
     readonly textToMusic: TextToMusic;
@@ -357,6 +420,8 @@ declare class SoniloClient {
     readonly videoToSfx: VideoToSfx;
     readonly videoToVideoMusic: VideoToVideoMusic;
     readonly videoToVideoSfx: VideoToVideoSfx;
+    readonly videoToSound: VideoToSound;
+    readonly videoToVideoSound: VideoToVideoSound;
     constructor(options?: SoniloClientOptions);
     /**
      * Perform an authenticated request; throws a typed error on non-2xx.
@@ -422,9 +487,14 @@ declare class TaskTimeoutError extends SoniloError {
 declare class RequestTimeoutError extends SoniloError {
 }
 
-/** Fetch a result media file. The URL is presigned — no API key is sent. */
-declare function download(media: SfxMedia | undefined, fetchFn?: typeof globalThis.fetch, timeout?: number): Promise<Uint8Array>;
+/** Fetch a result media file. The URL is presigned — no API key is sent.
+ *
+ * Accepts either a media object (`result.audio`, `result.music`, …) or a bare
+ * URL string, which is what the combined video-to-sound endpoints return as
+ * `output_url`. */
+declare function download(media: SfxMedia | string | undefined, fetchFn?: typeof globalThis.fetch, timeout?: number): Promise<Uint8Array>;
 
-declare const VERSION = "0.4.0";
+/** The SDK's own version. Generated by scripts/sync-versions.mjs — do not edit. */
+declare const VERSION = "0.5.1";
 
-export { APIError, type AccountServices, type AudioChunkEvent, AuthenticationError, BadRequestError, type BaseTaskResult, type CompleteEvent, type CostEvent, type CostInfo, DEFAULT_TIMEOUT_MS, type DailyUsage, type ErrorEvent, GenerationError, type MusicMediaEntry, type MusicMuxEntry, type MusicTaskResult, type MusicTitle, PaymentRequiredError, RateLimitError, RequestTimeoutError, type Segment, type SegmentLabel, type SfxAudioFormat, type SfxError, type SfxMedia, type SfxResult, type SfxSegment, type SfxTask, SoniloClient, type SoniloClientOptions, SoniloError, type StreamEvent, TaskFailedError, TaskTimeoutError, type TextToMusicParams, type TextToSfxParams, type TitleEvent, type Track, type UnknownEvent, type UsageResponse, type UsageSummary, VERSION, type VideoInput, type VideoResult, type VideoToMusicParams, type VideoToSfxParams, type VideoToVideoMusicParams, type VideoToVideoSfxParams, type WaitOptions, download, isAudioChunkEvent, isErrorEvent };
+export { APIError, type AccountServices, type AudioChunkEvent, AuthenticationError, BadRequestError, type BaseTaskResult, type CompleteEvent, type CostEvent, type CostInfo, DEFAULT_TIMEOUT_MS, type DailyUsage, type ErrorEvent, GenerationError, type MusicMediaEntry, type MusicMuxEntry, type MusicTaskResult, type MusicTitle, PaymentRequiredError, RateLimitError, RequestTimeoutError, type Segment, type SegmentLabel, type SfxAudioFormat, type SfxError, type SfxMedia, type SfxResult, type SfxSegment, type SfxTask, SoniloClient, type SoniloClientOptions, SoniloError, type SoundResult, type StreamEvent, TaskFailedError, TaskTimeoutError, type TextToMusicParams, type TextToSfxParams, type TitleEvent, type Track, type UnknownEvent, type UsageResponse, type UsageSummary, VERSION, type VideoInput, type VideoResult, type VideoToMusicParams, type VideoToSfxParams, type VideoToSoundParams, type VideoToVideoMusicParams, type VideoToVideoSfxParams, type WaitOptions, download, isAudioChunkEvent, isErrorEvent };

package/dist/index.d.ts

@@ -239,6 +239,41 @@ interface VideoToVideoSfxParams {
     prompt?: string;
     segments?: SfxSegment[];
 }
+/** Params for `videoToSound` and `videoToVideoSound`. Both endpoints take the
+ * identical form, so they share one params type. */
+interface VideoToSoundParams {
+    video?: VideoInput;
+    videoUrl?: string;
+    /** Style hint for the generated music bed. */
+    musicPrompt?: string;
+    /** Description of the sound effects layered over the music. */
+    sfxPrompt?: string;
+    /** Per-segment SFX descriptions; must start at 0 and be contiguous. */
+    segments?: SfxSegment[];
+    /** Keep the source speech in the result. */
+    preserveSpeech?: boolean;
+    /** Duck the generated music under the source speech. Default-ON
+     * server-side: leave unset to keep it on, pass `false` to opt out. */
+    ducking?: boolean;
+}
+/** Result of a `videoToSound` / `videoToVideoSound` task (`tasks.get`) or its
+ * final state (`generate`).
+ *
+ * The combined music+SFX result is `output_url` — a bare presigned URL rather
+ * than a media object, since these endpoints render one artifact whose kind is
+ * announced by `output_type` ("audio" for video-to-sound, "video" for
+ * video-to-video-sound). `music`, `music_processed` and `sfx` are the
+ * individual stems; pass any of them, or `output_url` itself, to `download()`. */
+interface SoundResult extends BaseTaskResult {
+    output_url?: string;
+    output_type?: "audio" | "video";
+    output_bytes?: number;
+    music?: SfxMedia;
+    /** Present only when `preserveSpeech`/`ducking` altered the music bed. */
+    music_processed?: SfxMedia;
+    sfx?: SfxMedia;
+    duration_seconds?: number;
+}
 
 declare class Account {
     private readonly client;
@@ -332,6 +367,24 @@ declare class VideoToVideoSfx {
     generate(params: VideoToVideoSfxParams, opts?: WaitOptions): Promise<VideoResult>;
 }
 
+/** Generate a combined music + sound-effects track for a video and get back
+ * the mixed audio. Async only. */
+declare class VideoToSound {
+    private readonly client;
+    constructor(client: SoniloClient);
+    submit(params: VideoToSoundParams): Promise<SfxTask>;
+    generate(params: VideoToSoundParams, opts?: WaitOptions): Promise<SoundResult>;
+}
+
+/** Generate a combined music + sound-effects track for a video and get back a
+ * re-hosted video with that track muxed in. Async only. */
+declare class VideoToVideoSound {
+    private readonly client;
+    constructor(client: SoniloClient);
+    submit(params: VideoToSoundParams): Promise<SfxTask>;
+    generate(params: VideoToSoundParams, opts?: WaitOptions): Promise<SoundResult>;
+}
+
 interface SoniloClientOptions {
     /** Defaults to the SONILO_API_KEY environment variable (Node.js only). */
     apiKey?: string;
@@ -341,6 +394,14 @@ interface SoniloClientOptions {
     fetch?: typeof globalThis.fetch;
     /** Milliseconds before an in-flight request is aborted. Default 600000. */
     timeout?: number;
+    /**
+     * Identifies a wrapper built on this SDK (the CLI, the video kit) in the
+     * `X-Sonilo-Client` header. Leave unset for direct SDK use — without an
+     * override a wrapper's traffic is indistinguishable from the SDK's own.
+     */
+    clientName?: string;
+    /** Version reported alongside `clientName`. Defaults to the SDK's version. */
+    clientVersion?: string;
 }
 /** Milliseconds before an in-flight request is aborted, unless overridden. */
 declare const DEFAULT_TIMEOUT_MS = 600000;
@@ -349,6 +410,8 @@ declare class SoniloClient {
     private readonly apiKey;
     private readonly fetchFn;
     private readonly timeout;
+    private readonly clientName;
+    private readonly clientVersion;
     readonly account: Account;
     readonly tasks: Tasks;
     readonly textToMusic: TextToMusic;
@@ -357,6 +420,8 @@ declare class SoniloClient {
     readonly videoToSfx: VideoToSfx;
     readonly videoToVideoMusic: VideoToVideoMusic;
     readonly videoToVideoSfx: VideoToVideoSfx;
+    readonly videoToSound: VideoToSound;
+    readonly videoToVideoSound: VideoToVideoSound;
     constructor(options?: SoniloClientOptions);
     /**
      * Perform an authenticated request; throws a typed error on non-2xx.
@@ -422,9 +487,14 @@ declare class TaskTimeoutError extends SoniloError {
 declare class RequestTimeoutError extends SoniloError {
 }
 
-/** Fetch a result media file. The URL is presigned — no API key is sent. */
-declare function download(media: SfxMedia | undefined, fetchFn?: typeof globalThis.fetch, timeout?: number): Promise<Uint8Array>;
+/** Fetch a result media file. The URL is presigned — no API key is sent.
+ *
+ * Accepts either a media object (`result.audio`, `result.music`, …) or a bare
+ * URL string, which is what the combined video-to-sound endpoints return as
+ * `output_url`. */
+declare function download(media: SfxMedia | string | undefined, fetchFn?: typeof globalThis.fetch, timeout?: number): Promise<Uint8Array>;
 
-declare const VERSION = "0.4.0";
+/** The SDK's own version. Generated by scripts/sync-versions.mjs — do not edit. */
+declare const VERSION = "0.5.1";
 
-export { APIError, type AccountServices, type AudioChunkEvent, AuthenticationError, BadRequestError, type BaseTaskResult, type CompleteEvent, type CostEvent, type CostInfo, DEFAULT_TIMEOUT_MS, type DailyUsage, type ErrorEvent, GenerationError, type MusicMediaEntry, type MusicMuxEntry, type MusicTaskResult, type MusicTitle, PaymentRequiredError, RateLimitError, RequestTimeoutError, type Segment, type SegmentLabel, type SfxAudioFormat, type SfxError, type SfxMedia, type SfxResult, type SfxSegment, type SfxTask, SoniloClient, type SoniloClientOptions, SoniloError, type StreamEvent, TaskFailedError, TaskTimeoutError, type TextToMusicParams, type TextToSfxParams, type TitleEvent, type Track, type UnknownEvent, type UsageResponse, type UsageSummary, VERSION, type VideoInput, type VideoResult, type VideoToMusicParams, type VideoToSfxParams, type VideoToVideoMusicParams, type VideoToVideoSfxParams, type WaitOptions, download, isAudioChunkEvent, isErrorEvent };
+export { APIError, type AccountServices, type AudioChunkEvent, AuthenticationError, BadRequestError, type BaseTaskResult, type CompleteEvent, type CostEvent, type CostInfo, DEFAULT_TIMEOUT_MS, type DailyUsage, type ErrorEvent, GenerationError, type MusicMediaEntry, type MusicMuxEntry, type MusicTaskResult, type MusicTitle, PaymentRequiredError, RateLimitError, RequestTimeoutError, type Segment, type SegmentLabel, type SfxAudioFormat, type SfxError, type SfxMedia, type SfxResult, type SfxSegment, type SfxTask, SoniloClient, type SoniloClientOptions, SoniloError, type SoundResult, type StreamEvent, TaskFailedError, TaskTimeoutError, type TextToMusicParams, type TextToSfxParams, type TitleEvent, type Track, type UnknownEvent, type UsageResponse, type UsageSummary, VERSION, type VideoInput, type VideoResult, type VideoToMusicParams, type VideoToSfxParams, type VideoToSoundParams, type VideoToVideoMusicParams, type VideoToVideoSfxParams, type WaitOptions, download, isAudioChunkEvent, isErrorEvent };

package/dist/index.js

@@ -564,11 +564,72 @@ var VideoToVideoSfx = class {
   }
 };
 
+// src/resources/soundForm.ts
+async function buildSoundForm(params) {
+  if (params.video === void 0 === (params.videoUrl === void 0)) {
+    throw new SoniloError("Provide exactly one of video or videoUrl");
+  }
+  const form = new FormData();
+  if (params.video !== void 0) {
+    const { blob, filename } = await toUploadBlob(params.video);
+    form.set("video", blob, filename);
+  } else {
+    form.set("video_url", params.videoUrl);
+  }
+  if (params.musicPrompt !== void 0) form.set("music_prompt", params.musicPrompt);
+  if (params.sfxPrompt !== void 0) form.set("sfx_prompt", params.sfxPrompt);
+  if (params.segments !== void 0) {
+    form.set("segments", JSON.stringify(params.segments));
+  }
+  if (params.preserveSpeech !== void 0) {
+    form.set("preserve_speech", String(params.preserveSpeech));
+  }
+  if (params.ducking !== void 0) form.set("ducking", String(params.ducking));
+  return form;
+}
+
+// src/resources/videoToSound.ts
+var VideoToSound = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async submit(params) {
+    const res = await this.client.request("/v1/video-to-sound", {
+      method: "POST",
+      body: await buildSoundForm(params)
+    });
+    return await res.json();
+  }
+  async generate(params, opts) {
+    const task = await this.submit(params);
+    return this.client.tasks.wait(task.task_id, opts);
+  }
+};
+
+// src/resources/videoToVideoSound.ts
+var VideoToVideoSound = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async submit(params) {
+    const res = await this.client.request("/v1/video-to-video-sound", {
+      method: "POST",
+      body: await buildSoundForm(params)
+    });
+    return await res.json();
+  }
+  async generate(params, opts) {
+    const task = await this.submit(params);
+    return this.client.tasks.wait(task.task_id, opts);
+  }
+};
+
 // src/version.ts
-var VERSION = "0.4.0";
+var VERSION = "0.5.1";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.sonilo.com";
+var DEFAULT_CLIENT_NAME = "sdk-js";
 var DEFAULT_TIMEOUT_MS = 6e5;
 var SoniloClient = class {
   constructor(options = {}) {
@@ -583,6 +644,8 @@ var SoniloClient = class {
     this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
     this.fetchFn = (options.fetch ?? globalThis.fetch).bind(globalThis);
     this.timeout = options.timeout ?? DEFAULT_TIMEOUT_MS;
+    this.clientName = options.clientName ?? DEFAULT_CLIENT_NAME;
+    this.clientVersion = options.clientVersion ?? VERSION;
     this.account = new Account(this);
     this.tasks = new Tasks(this);
     this.textToMusic = new TextToMusic(this);
@@ -591,6 +654,8 @@ var SoniloClient = class {
     this.videoToSfx = new VideoToSfx(this);
     this.videoToVideoMusic = new VideoToVideoMusic(this);
     this.videoToVideoSfx = new VideoToVideoSfx(this);
+    this.videoToSound = new VideoToSound(this);
+    this.videoToVideoSound = new VideoToVideoSound(this);
   }
   /**
    * Perform an authenticated request; throws a typed error on non-2xx.
@@ -603,8 +668,8 @@ var SoniloClient = class {
   async request(path, init = {}, opts = {}) {
     const headers = new Headers(init.headers);
     headers.set("Authorization", `Bearer ${this.apiKey}`);
-    headers.set("X-Sonilo-Client", "sdk-js");
-    headers.set("X-Sonilo-Client-Version", VERSION);
+    headers.set("X-Sonilo-Client", this.clientName);
+    headers.set("X-Sonilo-Client-Version", this.clientVersion);
     const timeout = opts.timeout === void 0 ? this.timeout : opts.timeout;
     const ownsSignal = init.signal == null && timeout !== null;
     const signal = init.signal ?? (timeout === null ? void 0 : AbortSignal.timeout(timeout));
@@ -623,15 +688,16 @@ var SoniloClient = class {
 
 // src/download.ts
 async function download(media, fetchFn = globalThis.fetch, timeout = DEFAULT_TIMEOUT_MS) {
-  if (!media?.url) {
+  const url = typeof media === "string" ? media : media?.url;
+  if (!url) {
     throw new SoniloError("No media to download");
   }
   let res;
   try {
-    res = await fetchFn(media.url, { signal: AbortSignal.timeout(timeout) });
+    res = await fetchFn(url, { signal: AbortSignal.timeout(timeout) });
   } catch (err) {
     if (isTimeoutSignalError(err)) {
-      throw new RequestTimeoutError(`Download of ${media.url} timed out after ${timeout}ms`);
+      throw new RequestTimeoutError(`Download of ${url} timed out after ${timeout}ms`);
     }
     throw err;
   }