@nodaro/sdk 1.4.0 → 1.6.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { GenericNode, GenericEdge, WorkflowExport, ConnectedReference, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, SubGateName, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing } from '@nodaro/shared';
-export { BrowseCommunityParams, BrowseCommunityResult, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, CharacterAspectRatio, CloneListingResult, CommunityCard, CommunityEntityType, CommunityReportReason, CommunitySort, ConnectedReference, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, EntityStyle, FavoriteListingResult, GenericEdge, GenericNode, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, PipelineStageName, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject } from '@nodaro/shared';
+export { AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, CharacterAspectRatio, CloneListingResult, CommunityCard, CommunityEntityType, CommunityReportReason, CommunitySort, ConnectedReference, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, EntityStyle, FavoriteListingResult, GenericEdge, GenericNode, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, PipelineStageName, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject } from '@nodaro/shared';
 import { PersonValue, WizardNodeContext, WizardQuestion, WizardSelection, RecommendedModel, FactoryPreset } from '@nodaro/prompts';
 export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PersonValue, RecommendedModel, WizardNodeContext, WizardOption, WizardQuestion, WizardSelection, buildPersonHints } from '@nodaro/prompts';
 
@@ -3387,10 +3387,16 @@ declare class VoicesResource {
         voiceId: string;
         audioUrl?: string;
         videoUrl?: string;
+        /** Speech-to-speech model id. Defaults to the server-configured default when omitted. */
+        model?: string;
         stability?: number;
         similarityBoost?: number;
         /** Style exaggeration (0–1). Default 0; >0 amplifies delivery at the cost of latency/stability. */
         style?: number;
+        /** ElevenLabs speaker boost — sharpens fidelity to the target speaker (small latency cost). */
+        useSpeakerBoost?: boolean;
+        /** Deterministic speech-to-speech seed (integer 0–4294967295) for reproducible output. Omit for random. */
+        seed?: number;
         removeBackgroundNoise?: boolean;
     }): Promise<{
         jobId: string;
@@ -3465,6 +3471,49 @@ declare class VoicesResource {
     exportMix(input: VcpExportInput): Promise<{
         jobId: string;
     }>;
+    /**
+     * 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: VoiceDesignInput): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * 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: VoiceRemixInput): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * 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: DubbingInput): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Clone a voice from an audio FILE you hold in memory
+     * (`POST /v1/voice-clones`, multipart) — the counterpart to
+     * {@link VoicesResource.createClone}, which clones from an already-uploaded
+     * URL. Pass the raw audio `file` (a `Blob`/`File` in the browser, or a
+     * `Uint8Array`/`Buffer` in Node) plus a `name`. Costs credits. Returns the new
+     * {@link VoiceClone} (`elevenlabsVoiceId` is the id to recast/synthesize with).
+     */
+    createCloneFromFile(input: {
+        name: string;
+        file: Blob | Uint8Array | ArrayBuffer;
+        /** File name for the upload part (default `sample`). */
+        filename?: string;
+        /** MIME type when `file` is a raw buffer (default `audio/mpeg`). */
+        contentType?: string;
+    }): Promise<VoiceClone>;
 }
 /**
  * One entry in {@link VoiceChangerProInput.orderedVoices}. Either a bare voice id
@@ -3646,6 +3695,257 @@ interface VcpExportInput {
      */
     voiceFx?: VoiceChangerProInput["voiceFx"];
 }
+/** Input for {@link VoicesResource.design}. */
+interface VoiceDesignInput {
+    /** A preview line (100–1000 chars) spoken in the designed voice. */
+    text: string;
+    /** Natural-language description of the voice to create. */
+    voiceDescription: string;
+    /** Voice-design model id. Defaults to the server-configured default. */
+    model?: string;
+    /** Output loudness (-1..1). */
+    loudness?: number;
+    /** How strongly the description steers the design (0–100). */
+    guidanceScale?: number;
+    /** Deterministic seed for a reproducible design. */
+    seed?: number;
+    /** Design quality knob (provider-specific). */
+    quality?: number;
+    /** Enhance the generated voice. */
+    shouldEnhance?: boolean;
+    /** Optional extra prompt context (≤8000 chars). */
+    userPrompt?: string;
+}
+/** Input for {@link VoicesResource.remix}. */
+interface VoiceRemixInput {
+    /** The text (1–5000 chars) to speak in the described voice. */
+    text: string;
+    /** Natural-language description of the voice to speak in. */
+    voiceDescription: string;
+    /** Optional extra prompt context (≤8000 chars). */
+    userPrompt?: string;
+}
+/** Input for {@link VoicesResource.dub}. */
+interface DubbingInput {
+    /** URL of the audio to dub. */
+    audioUrl: string;
+    /** Target language ISO code (2–10 chars), e.g. `"es"`, `"pt-BR"`. */
+    targetLanguage: string;
+    /** Source language ISO code; auto-detected when omitted. */
+    sourceLanguage?: string;
+    /** Expected number of speakers (1–20) — improves separation when known. */
+    numSpeakers?: number;
+    /** Keep the original voices instead of cloning them into the target language. */
+    disableVoiceCloning?: boolean;
+    /** Drop the background/music bed from the dubbed output. */
+    dropBackgroundAudio?: boolean;
+}
+
+/**
+ * Media ingestion + trimming — the source-preparation steps a Voice Changer Pro
+ * flow (or any pipeline) needs before it has a clip to work on: pull a social
+ * video into storage, copy a remote URL into storage, trim a video/audio to a
+ * range, and probe a video's metadata. Each generation-style op returns a job id
+ * to poll (`jobs.get(jobId)`); `videoMetadata` is a direct read.
+ */
+declare class MediaResource {
+    private client;
+    constructor(client: NodaroClient);
+    /**
+     * 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. 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: {
+        url: string;
+        maxHeight?: number;
+        sectionStartSec?: number;
+        sectionEndSec?: number;
+    }): Promise<{
+        downloadId: string;
+    }>;
+    /**
+     * 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.
+     */
+    downloadVideoProgress(downloadId: string, opts?: {
+        signal?: AbortSignal;
+    }): AsyncGenerator<DownloadVideoProgress, void, undefined>;
+    /**
+     * 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: {
+        mediaUrl: string;
+        filename?: string;
+        mediaType?: "image" | "video" | "audio";
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * 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: {
+        videoUrl: string;
+        startTime?: number;
+        endTime?: number;
+        trimStartFrames?: number;
+        trimEndFrames?: number;
+        trimStartSeconds?: number;
+        trimEndSeconds?: number;
+        keepFirstSeconds?: number;
+        keepLastSeconds?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * 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: {
+        videoUrl?: string;
+        audioUrl?: string;
+        audioFormat?: "mp3" | "wav" | "aac";
+        startTime?: number;
+        endTime?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * 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: {
+        url: string;
+    }): Promise<VideoMetadata>;
+}
+/**
+ * One event from {@link MediaResource.downloadVideoProgress}. The stream ends
+ * after a `completed` event (which carries the stored `videoUrl` + an optional
+ * `thumbnailUrl`) or a `failed` event (which carries `error`).
+ */
+interface DownloadVideoProgress {
+    phase: "downloading" | "processing" | "uploading" | "completed" | "failed";
+    /** Download percent (0–100). Section fetches report jumpy percents — display, don't sum. */
+    percent: number;
+    /** The imported video's storage URL — set on the `completed` event. */
+    videoUrl?: string;
+    /** Thumbnail storage URL — set on the `completed` event when one was captured. */
+    thumbnailUrl?: string;
+    /** What went wrong — set on the `failed` event. */
+    error?: string;
+}
+/** Result of {@link MediaResource.videoMetadata}. Fields are best-effort — a probe may omit some. */
+interface VideoMetadata {
+    durationSec?: number | null;
+    width?: number | null;
+    height?: number | null;
+    title?: string | null;
+    isLive?: boolean;
+    [key: string]: unknown;
+}
+
+/**
+ * Audio primitives — the building blocks Voice Changer Pro composes internally
+ * (separation, isolation, effect, mix, level), exposed standalone so a consumer
+ * can run any single step or assemble its own pipeline. Each returns a job id to
+ * poll (`jobs.get(jobId)`).
+ */
+declare class AudioResource {
+    private client;
+    constructor(client: NodaroClient);
+    /**
+     * Separate an audio track into stems (`POST /v1/audio-separation`, Demucs).
+     * `mode` `"vocal_instrumental"` (default) splits voice from music/SFX;
+     * `"stems"` returns the full drums/bass/other/… breakdown. `quality`
+     * `auto` (default) / `fast` / `best`.
+     */
+    separate(input: {
+        audioUrl: string;
+        mode?: "vocal_instrumental" | "stems";
+        quality?: "auto" | "fast" | "best";
+    }): Promise<{
+        jobId: string;
+    }>;
+    /** Isolate the primary voice and strip background noise (`POST /v1/audio-isolation`, ElevenLabs). */
+    isolate(input: {
+        audioUrl: string;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Apply a reverb / echo / telephone / megaphone effect to an audio track
+     * (`POST /v1/audio-fx`) — the same presets VCP's `voiceFx` uses, standalone.
+     * `mix` (0–100) is the reverb wet/dry; `delayMs` + `decay` drive `echo`/`custom`;
+     * `eqLow`/`eqHigh` (dB) shape telephone/megaphone.
+     */
+    applyFx(input: {
+        audioUrl: string;
+        preset?: AudioFxPreset;
+        mix?: number;
+        delayMs?: number;
+        decay?: number;
+        eqLow?: number;
+        eqHigh?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`
+     * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set
+     * per-track level.
+     */
+    mix(input: {
+        audioUrls: string[];
+        trackVolumes?: number[];
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Adjust an audio (or a video's audio) level (`POST /v1/adjust-volume`):
+     * `volume` % (default 100), `normalize` to loudnorm, and `fadeIn`/`fadeOut`
+     * seconds. Provide `audioUrl` or `videoUrl`.
+     */
+    adjustVolume(input: {
+        audioUrl?: string;
+        videoUrl?: string;
+        volume?: number;
+        normalize?: boolean;
+        fadeIn?: number;
+        fadeOut?: number;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each
+     * segment is a `url` with an optional `[startTime, endTime]` sub-range.
+     */
+    combine(input: {
+        segments: Array<{
+            url: string;
+            startTime?: number;
+            endTime?: number;
+        }>;
+    }): Promise<{
+        jobId: string;
+    }>;
+}
 
 /**
  * Authenticated user's credit balance — the shape of `GET /v1/user/credits`'s
@@ -4082,6 +4382,8 @@ declare class NodaroClient {
     readonly reduce: ReduceResource;
     readonly promptHelper: PromptHelperResource;
     readonly voices: VoicesResource;
+    readonly media: MediaResource;
+    readonly audio: AudioResource;
     readonly credits: CreditsResource;
     readonly uploads: UploadsResource;
     readonly library: LibraryResource;
@@ -4176,4 +4478,4 @@ interface ApiErrorBody {
 }
 declare function throwFromResponse(status: number, body: ApiErrorBody): never;
 
-export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, CommunityResource, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateProjectInput, type CreateWorkflowInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DuplicateCharacterInput, type EnhanceInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type Job, JobAbortedError, JobFailedError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type ModelCostsResult, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, StaticTokenAuth, StorageExceededError, type StructuredReferenceParams, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VoiceChangerProInput, type VoiceChangerProVoice, VoicesResource, type Workflow, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
+export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, CommunityResource, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateProjectInput, type CreateWorkflowInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EnhanceInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type Job, JobAbortedError, JobFailedError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, MediaResource, type ModelCostsResult, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, StaticTokenAuth, StorageExceededError, type StructuredReferenceParams, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoMetadata, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };

package/dist/index.js

@@ -1583,6 +1583,209 @@ var VoicesResource = class {
   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 });
+  }
+  /**
+   * Clone a voice from an audio FILE you hold in memory
+   * (`POST /v1/voice-clones`, multipart) — the counterpart to
+   * {@link VoicesResource.createClone}, which clones from an already-uploaded
+   * URL. Pass the raw audio `file` (a `Blob`/`File` in the browser, or a
+   * `Uint8Array`/`Buffer` in Node) plus a `name`. Costs credits. Returns the new
+   * {@link VoiceClone} (`elevenlabsVoiceId` is the id to recast/synthesize with).
+   */
+  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 });
+  }
+};
+
+// 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. 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
+    });
+    if (!res.ok) {
+      let errBody = {};
+      try {
+        errBody = await res.json();
+      } catch {
+      }
+      throwFromResponse(res.status, errBody);
+    }
+    if (!res.body) {
+      throw new NodaroError("progress stream has no response body", "empty_stream", res.status);
+    }
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = "";
+    try {
+      for (; ; ) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        let sep;
+        while ((sep = buffer.indexOf("\n\n")) >= 0) {
+          const frame = buffer.slice(0, sep);
+          buffer = buffer.slice(sep + 2);
+          for (const line of frame.split("\n")) {
+            if (!line.startsWith("data:")) continue;
+            try {
+              yield JSON.parse(line.slice(5).trim());
+            } catch {
+            }
+          }
+        }
+      }
+    } finally {
+      reader.releaseLock();
+      await res.body.cancel().catch(() => {
+      });
+    }
+  }
+  /**
+   * 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 });
+  }
+  /**
+   * 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 });
+  }
+  /**
+   * 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 });
+  }
+  /**
+   * 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 });
+  }
+};
+
+// src/resources/audio.ts
+var AudioResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Separate an audio track into stems (`POST /v1/audio-separation`, Demucs).
+   * `mode` `"vocal_instrumental"` (default) splits voice from music/SFX;
+   * `"stems"` returns the full drums/bass/other/… breakdown. `quality`
+   * `auto` (default) / `fast` / `best`.
+   */
+  separate(input) {
+    return this.client.request("POST", "/v1/audio-separation", { body: input });
+  }
+  /** Isolate the primary voice and strip background noise (`POST /v1/audio-isolation`, ElevenLabs). */
+  isolate(input) {
+    return this.client.request("POST", "/v1/audio-isolation", { body: input });
+  }
+  /**
+   * Apply a reverb / echo / telephone / megaphone effect to an audio track
+   * (`POST /v1/audio-fx`) — the same presets VCP's `voiceFx` uses, standalone.
+   * `mix` (0–100) is the reverb wet/dry; `delayMs` + `decay` drive `echo`/`custom`;
+   * `eqLow`/`eqHigh` (dB) shape telephone/megaphone.
+   */
+  applyFx(input) {
+    return this.client.request("POST", "/v1/audio-fx", { body: input });
+  }
+  /**
+   * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`
+   * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set
+   * per-track level.
+   */
+  mix(input) {
+    return this.client.request("POST", "/v1/mix-audio", { body: input });
+  }
+  /**
+   * Adjust an audio (or a video's audio) level (`POST /v1/adjust-volume`):
+   * `volume` % (default 100), `normalize` to loudnorm, and `fadeIn`/`fadeOut`
+   * seconds. Provide `audioUrl` or `videoUrl`.
+   */
+  adjustVolume(input) {
+    return this.client.request("POST", "/v1/adjust-volume", { body: input });
+  }
+  /**
+   * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each
+   * segment is a `url` with an optional `[startTime, endTime]` sub-range.
+   */
+  combine(input) {
+    return this.client.request("POST", "/v1/combine-audio", { body: input });
+  }
 };
 
 // src/resources/credits.ts
@@ -1885,6 +2088,8 @@ var NodaroClient = class {
   reduce;
   promptHelper;
   voices;
+  media;
+  audio;
   credits;
   uploads;
   library;
@@ -1912,6 +2117,8 @@ var NodaroClient = class {
     this.reduce = new ReduceResource(this);
     this.promptHelper = new PromptHelperResource(this);
     this.voices = new VoicesResource(this);
+    this.media = new MediaResource(this);
+    this.audio = new AudioResource(this);
     this.credits = new CreditsResource(this);
     this.uploads = new UploadsResource(this);
     this.library = new LibraryResource(this);
@@ -2009,6 +2216,6 @@ function supabaseAuth(supabase) {
   };
 }
 
-export { AppsResource, CREATURE_ASSET_TYPES, CallbackAuth, CharactersResource, CommunityResource, CreaturesResource, CreditsResource, DeveloperAppsResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobFailedError, JobTimeoutError, JobsResource, LibraryResource, LocationsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, ReduceResource, StaticTokenAuth, StorageExceededError, UnauthorizedError, UploadsResource, VoicesResource, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
+export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CharactersResource, CommunityResource, CreaturesResource, CreditsResource, DeveloperAppsResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobFailedError, JobTimeoutError, JobsResource, LibraryResource, LocationsResource, MediaResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, ReduceResource, StaticTokenAuth, StorageExceededError, UnauthorizedError, UploadsResource, VoicesResource, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map