@elevenlabs/elevenlabs-js 2.20.0 → 2.20.1

package/Client.js

@@ -77,8 +77,8 @@ class ElevenLabsClient {
                 "xi-api-key": _options === null || _options === void 0 ? void 0 : _options.apiKey,
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@elevenlabs/elevenlabs-js",
-                "X-Fern-SDK-Version": "v2.20.0",
-                "User-Agent": "@elevenlabs/elevenlabs-js/v2.20.0",
+                "X-Fern-SDK-Version": "v2.20.1",
+                "User-Agent": "@elevenlabs/elevenlabs-js/v2.20.1",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/Client.js

@@ -77,8 +77,8 @@ class ElevenLabsClient {
                 "xi-api-key": _options === null || _options === void 0 ? void 0 : _options.apiKey,
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@elevenlabs/elevenlabs-js",
-                "X-Fern-SDK-Version": "v2.20.0",
-                "User-Agent": "@elevenlabs/elevenlabs-js/v2.20.0",
+                "X-Fern-SDK-Version": "v2.20.1",
+                "User-Agent": "@elevenlabs/elevenlabs-js/v2.20.1",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "v2.20.0";
+export declare const SDK_VERSION = "v2.20.1";

package/dist/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "v2.20.0";
+exports.SDK_VERSION = "v2.20.1";

package/dist/wrapper/ElevenLabsClient.js

@@ -57,7 +57,7 @@ class ElevenLabsClient extends Client_1.ElevenLabsClient {
         }
         return this._customWebhooks;
     }
-    // @ts-expect-error - Intentionally overriding parent getter with custom Music wrapper
+    // @ts-expect-error - Intentionally overriding with wrapper Music that has enhanced composeDetailed
     get music() {
         if (!this._customMusic) {
             this._customMusic = new music_1.Music(this._options);

package/dist/wrapper/music.d.ts

@@ -1,6 +1,7 @@
 import { Music as GeneratedMusic } from "../api/resources/music/client/Client";
 import type * as ElevenLabs from "../api";
 import type { CompositionPlan } from "../api/resources/music/resources/compositionPlan/client/Client";
+import * as core from "../core";
 export declare namespace Music {
     interface Options extends GeneratedMusic.Options {
     }
@@ -22,14 +23,84 @@ export interface MultipartResponse {
     audio: Buffer;
     filename: string;
 }
-export declare class Music extends GeneratedMusic {
+export declare class Music {
+    private _client;
     constructor(options?: Music.Options);
+    /**
+     * Get the composition plan client
+     */
+    get compositionPlan(): CompositionPlan;
+    /**
+     * Compose a song from a prompt or a composition plan.
+     * @throws {@link ElevenLabs.UnprocessableEntityError}
+     */
+    compose(request?: ElevenLabs.BodyComposeMusicV1MusicPost, requestOptions?: Music.RequestOptions): core.HttpResponsePromise<ReadableStream<Uint8Array>>;
     /**
      * Compose a song from a prompt or a composition plan with detailed response parsing.
-     * This method calls the original composeDetailed and then parses the stream response.
+     *
+     * Unlike the standard `compose()` method which returns a raw audio stream, this method
+     * automatically parses the multipart response to extract both the audio file and rich
+     * metadata about the generated composition.
+     *
+     * @param request - The music composition request containing either:
+     *   - `prompt`: A text description of the desired music (e.g., "upbeat electronic dance music")
+     *   - `compositionPlan`: A detailed composition plan object created via `compositionPlan.create()`
+     *   - `musicLengthMs`: Optional duration in milliseconds (10000-300000ms)
+     *
+     * @param requestOptions - Optional request configuration (e.g., timeout, signal, headers)
+     *
+     * @returns A promise that resolves to a `MultipartResponse` containing:
+     *   - `json.compositionPlan`: The detailed composition plan structure including sections,
+     *     styles, and lyrics
+     *   - `json.songMetadata`: Metadata about the generated song (title, description, genres,
+     *     languages, explicit content flag)
+     *   - `audio`: Buffer containing the complete audio file (MP3 format)
+     *   - `filename`: Suggested filename for the audio file
+     *
+     * @throws {@link ElevenLabs.UnprocessableEntityError} If the request parameters are invalid
+     *   or the music generation fails
+     *
+     * @example
+     * ```typescript
+     * const client = new ElevenLabs({ apiKey: "your-api-key" });
+     *
+     * // Generate music from a text prompt
+     * const response = await client.music.composeDetailed({
+     *   prompt: "Epic orchestral music with dramatic strings and powerful brass",
+     *   musicLengthMs: 60000 // 60 seconds
+     * });
+     *
+     * console.log("Title:", response.json.songMetadata.title);
+     * console.log("Genres:", response.json.songMetadata.genres);
+     *
+     * // Save the audio to a file
+     * fs.writeFileSync(response.filename, response.audio);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Generate music from a composition plan
+     * const plan = await client.music.compositionPlan.create({
+     *   prompt: "A progressive rock song about space exploration"
+     * });
+     *
+     * const response = await client.music.composeDetailed({
+     *   compositionPlan: plan.compositionPlan
+     * });
+     *
+     * // Access detailed section information
+     * for (const section of response.json.compositionPlan.sections) {
+     *   console.log(`${section.sectionName}: ${section.durationMs}ms`);
+     * }
+     * ```
+     */
+    composeDetailed(request?: ElevenLabs.BodyComposeMusicWithADetailedResponseV1MusicDetailedPost, requestOptions?: Music.RequestOptions): core.HttpResponsePromise<MultipartResponse>;
+    private _composeDetailed;
+    /**
+     * Stream a composed song from a prompt or a composition plan.
      * @throws {@link ElevenLabs.UnprocessableEntityError}
      */
-    composeDetailed(request?: ElevenLabs.BodyComposeMusicWithADetailedResponseV1MusicDetailedPost, requestOptions?: Music.RequestOptions): Promise<MultipartResponse>;
+    stream(request?: ElevenLabs.BodyStreamComposedMusicV1MusicStreamPost, requestOptions?: Music.RequestOptions): core.HttpResponsePromise<ReadableStream<Uint8Array>>;
     /**
      * Reads a ReadableStream containing multipart data and parses it into JSON and audio parts
      * @param stream - ReadableStream from ElevenLabs music API response

package/dist/wrapper/music.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -11,28 +44,108 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Music = void 0;
 const Client_1 = require("../api/resources/music/client/Client");
-class Music extends Client_1.Music {
+const core = __importStar(require("../core"));
+class Music {
     constructor(options = {}) {
-        super(options);
+        this._client = new Client_1.Music(options);
     }
     /**
-     * Compose a song from a prompt or a composition plan with detailed response parsing.
-     * This method calls the original composeDetailed and then parses the stream response.
+     * Get the composition plan client
+     */
+    get compositionPlan() {
+        return this._client.compositionPlan;
+    }
+    /**
+     * Compose a song from a prompt or a composition plan.
      * @throws {@link ElevenLabs.UnprocessableEntityError}
      */
-    // @ts-expect-error - Intentionally overriding parent method with different return type
-    composeDetailed() {
-        const _super = Object.create(null, {
-            composeDetailed: { get: () => super.composeDetailed }
-        });
+    compose(request = {}, requestOptions) {
+        return this._client.compose(request, requestOptions);
+    }
+    /**
+     * Compose a song from a prompt or a composition plan with detailed response parsing.
+     *
+     * Unlike the standard `compose()` method which returns a raw audio stream, this method
+     * automatically parses the multipart response to extract both the audio file and rich
+     * metadata about the generated composition.
+     *
+     * @param request - The music composition request containing either:
+     *   - `prompt`: A text description of the desired music (e.g., "upbeat electronic dance music")
+     *   - `compositionPlan`: A detailed composition plan object created via `compositionPlan.create()`
+     *   - `musicLengthMs`: Optional duration in milliseconds (10000-300000ms)
+     *
+     * @param requestOptions - Optional request configuration (e.g., timeout, signal, headers)
+     *
+     * @returns A promise that resolves to a `MultipartResponse` containing:
+     *   - `json.compositionPlan`: The detailed composition plan structure including sections,
+     *     styles, and lyrics
+     *   - `json.songMetadata`: Metadata about the generated song (title, description, genres,
+     *     languages, explicit content flag)
+     *   - `audio`: Buffer containing the complete audio file (MP3 format)
+     *   - `filename`: Suggested filename for the audio file
+     *
+     * @throws {@link ElevenLabs.UnprocessableEntityError} If the request parameters are invalid
+     *   or the music generation fails
+     *
+     * @example
+     * ```typescript
+     * const client = new ElevenLabs({ apiKey: "your-api-key" });
+     *
+     * // Generate music from a text prompt
+     * const response = await client.music.composeDetailed({
+     *   prompt: "Epic orchestral music with dramatic strings and powerful brass",
+     *   musicLengthMs: 60000 // 60 seconds
+     * });
+     *
+     * console.log("Title:", response.json.songMetadata.title);
+     * console.log("Genres:", response.json.songMetadata.genres);
+     *
+     * // Save the audio to a file
+     * fs.writeFileSync(response.filename, response.audio);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Generate music from a composition plan
+     * const plan = await client.music.compositionPlan.create({
+     *   prompt: "A progressive rock song about space exploration"
+     * });
+     *
+     * const response = await client.music.composeDetailed({
+     *   compositionPlan: plan.compositionPlan
+     * });
+     *
+     * // Access detailed section information
+     * for (const section of response.json.compositionPlan.sections) {
+     *   console.log(`${section.sectionName}: ${section.durationMs}ms`);
+     * }
+     * ```
+     */
+    composeDetailed(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this._composeDetailed(request, requestOptions));
+    }
+    _composeDetailed() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
-            // Call the parent method to get the stream
-            const response = yield _super.composeDetailed.call(this, request, requestOptions);
-            // Parse the stream using your existing parsing method
-            const parsedResponse = yield this.parseMultipart(response);
-            return parsedResponse;
+            // Call the base client method to get the stream with raw response
+            try {
+                const { data: stream, rawResponse } = yield this._client.composeDetailed(request, requestOptions).withRawResponse();
+                // Parse the stream using the existing parsing method
+                const parsedResponse = yield this.parseMultipart(stream);
+                return { data: parsedResponse, rawResponse };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`Failed to parse detailed composition response: ${message}`);
+            }
         });
     }
+    /**
+     * Stream a composed song from a prompt or a composition plan.
+     * @throws {@link ElevenLabs.UnprocessableEntityError}
+     */
+    stream(request = {}, requestOptions) {
+        return this._client.stream(request, requestOptions);
+    }
     /**
      * Reads a ReadableStream containing multipart data and parses it into JSON and audio parts
      * @param stream - ReadableStream from ElevenLabs music API response

package/dist/wrapper/realtime/connection.js

@@ -98,7 +98,6 @@ class RealtimeConnection {
                     break;
                 case "final_transcript_with_timestamps":
                     this.eventEmitter.emit(RealtimeEvents.FINAL_TRANSCRIPT_WITH_TIMESTAMPS, data);
-                    this.close();
                     break;
             }
         });

package/dist/wrapper/realtime/scribe.d.ts

@@ -44,6 +44,11 @@ interface BaseOptions {
      * Must be a valid model ID.
      */
     modelId: string;
+    /**
+     * An ISO-639-1 or ISO-639-3 language_code corresponding to the language of the audio file.
+     * Can sometimes improve transcription performance if known beforehand.
+     */
+    languageCode?: string;
 }
 export interface AudioOptions extends BaseOptions {
     audioFormat: AudioFormat;

package/dist/wrapper/realtime/scribe.js

@@ -133,6 +133,9 @@ class ScribeRealtime {
                 }
                 params.append("min_silence_duration_ms", options.minSilenceDurationMs.toString());
             }
+            if (options.languageCode !== undefined) {
+                params.append("language_code", options.languageCode);
+            }
             const queryString = params.toString();
             return queryString ? `${baseUri}?${queryString}` : baseUri;
         });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@elevenlabs/elevenlabs-js",
-    "version": "v2.20.0",
+    "version": "v2.20.1",
     "private": false,
     "repository": "github:elevenlabs/elevenlabs-js",
     "license": "MIT",
@@ -15,24 +15,25 @@
         "test:wire": "jest --selectProjects wire"
     },
     "dependencies": {
+        "command-exists": "^1.2.9",
         "node-fetch": "^2.7.0",
-        "command-exists": "^1.2.9"
+        "ws": "^8.18.3"
     },
     "devDependencies": {
-        "@types/node-fetch": "^2.6.12",
-        "webpack": "^5.97.1",
-        "ts-loader": "^9.5.1",
-        "jest": "^29.7.0",
         "@jest/globals": "^29.7.0",
+        "@types/command-exists": "^1.2.3",
         "@types/jest": "^29.5.5",
-        "ts-jest": "^29.1.1",
+        "@types/node": "^18.19.70",
+        "@types/node-fetch": "^2.6.12",
+        "@types/ws": "^8.18.1",
+        "jest": "^29.7.0",
         "jest-environment-jsdom": "^29.7.0",
         "msw": "2.11.2",
-        "@types/node": "^18.19.70",
         "prettier": "^3.4.2",
+        "ts-jest": "^29.1.1",
+        "ts-loader": "^9.5.1",
         "typescript": "~5.7.2",
-        "@types/command-exists": "^1.2.3",
-        "@types/ws": "^8.18.1"
+        "webpack": "^5.97.1"
     },
     "browser": {
         "fs": false,

package/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "v2.20.0";
+export declare const SDK_VERSION = "v2.20.1";

package/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "v2.20.0";
+exports.SDK_VERSION = "v2.20.1";

package/wrapper/ElevenLabsClient.js

@@ -57,7 +57,7 @@ class ElevenLabsClient extends Client_1.ElevenLabsClient {
         }
         return this._customWebhooks;
     }
-    // @ts-expect-error - Intentionally overriding parent getter with custom Music wrapper
+    // @ts-expect-error - Intentionally overriding with wrapper Music that has enhanced composeDetailed
     get music() {
         if (!this._customMusic) {
             this._customMusic = new music_1.Music(this._options);

package/wrapper/music.d.ts

@@ -1,6 +1,7 @@
 import { Music as GeneratedMusic } from "../api/resources/music/client/Client";
 import type * as ElevenLabs from "../api";
 import type { CompositionPlan } from "../api/resources/music/resources/compositionPlan/client/Client";
+import * as core from "../core";
 export declare namespace Music {
     interface Options extends GeneratedMusic.Options {
     }
@@ -22,14 +23,84 @@ export interface MultipartResponse {
     audio: Buffer;
     filename: string;
 }
-export declare class Music extends GeneratedMusic {
+export declare class Music {
+    private _client;
     constructor(options?: Music.Options);
+    /**
+     * Get the composition plan client
+     */
+    get compositionPlan(): CompositionPlan;
+    /**
+     * Compose a song from a prompt or a composition plan.
+     * @throws {@link ElevenLabs.UnprocessableEntityError}
+     */
+    compose(request?: ElevenLabs.BodyComposeMusicV1MusicPost, requestOptions?: Music.RequestOptions): core.HttpResponsePromise<ReadableStream<Uint8Array>>;
     /**
      * Compose a song from a prompt or a composition plan with detailed response parsing.
-     * This method calls the original composeDetailed and then parses the stream response.
+     *
+     * Unlike the standard `compose()` method which returns a raw audio stream, this method
+     * automatically parses the multipart response to extract both the audio file and rich
+     * metadata about the generated composition.
+     *
+     * @param request - The music composition request containing either:
+     *   - `prompt`: A text description of the desired music (e.g., "upbeat electronic dance music")
+     *   - `compositionPlan`: A detailed composition plan object created via `compositionPlan.create()`
+     *   - `musicLengthMs`: Optional duration in milliseconds (10000-300000ms)
+     *
+     * @param requestOptions - Optional request configuration (e.g., timeout, signal, headers)
+     *
+     * @returns A promise that resolves to a `MultipartResponse` containing:
+     *   - `json.compositionPlan`: The detailed composition plan structure including sections,
+     *     styles, and lyrics
+     *   - `json.songMetadata`: Metadata about the generated song (title, description, genres,
+     *     languages, explicit content flag)
+     *   - `audio`: Buffer containing the complete audio file (MP3 format)
+     *   - `filename`: Suggested filename for the audio file
+     *
+     * @throws {@link ElevenLabs.UnprocessableEntityError} If the request parameters are invalid
+     *   or the music generation fails
+     *
+     * @example
+     * ```typescript
+     * const client = new ElevenLabs({ apiKey: "your-api-key" });
+     *
+     * // Generate music from a text prompt
+     * const response = await client.music.composeDetailed({
+     *   prompt: "Epic orchestral music with dramatic strings and powerful brass",
+     *   musicLengthMs: 60000 // 60 seconds
+     * });
+     *
+     * console.log("Title:", response.json.songMetadata.title);
+     * console.log("Genres:", response.json.songMetadata.genres);
+     *
+     * // Save the audio to a file
+     * fs.writeFileSync(response.filename, response.audio);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Generate music from a composition plan
+     * const plan = await client.music.compositionPlan.create({
+     *   prompt: "A progressive rock song about space exploration"
+     * });
+     *
+     * const response = await client.music.composeDetailed({
+     *   compositionPlan: plan.compositionPlan
+     * });
+     *
+     * // Access detailed section information
+     * for (const section of response.json.compositionPlan.sections) {
+     *   console.log(`${section.sectionName}: ${section.durationMs}ms`);
+     * }
+     * ```
+     */
+    composeDetailed(request?: ElevenLabs.BodyComposeMusicWithADetailedResponseV1MusicDetailedPost, requestOptions?: Music.RequestOptions): core.HttpResponsePromise<MultipartResponse>;
+    private _composeDetailed;
+    /**
+     * Stream a composed song from a prompt or a composition plan.
      * @throws {@link ElevenLabs.UnprocessableEntityError}
      */
-    composeDetailed(request?: ElevenLabs.BodyComposeMusicWithADetailedResponseV1MusicDetailedPost, requestOptions?: Music.RequestOptions): Promise<MultipartResponse>;
+    stream(request?: ElevenLabs.BodyStreamComposedMusicV1MusicStreamPost, requestOptions?: Music.RequestOptions): core.HttpResponsePromise<ReadableStream<Uint8Array>>;
     /**
      * Reads a ReadableStream containing multipart data and parses it into JSON and audio parts
      * @param stream - ReadableStream from ElevenLabs music API response

package/wrapper/music.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
@@ -11,28 +44,108 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Music = void 0;
 const Client_1 = require("../api/resources/music/client/Client");
-class Music extends Client_1.Music {
+const core = __importStar(require("../core"));
+class Music {
     constructor(options = {}) {
-        super(options);
+        this._client = new Client_1.Music(options);
     }
     /**
-     * Compose a song from a prompt or a composition plan with detailed response parsing.
-     * This method calls the original composeDetailed and then parses the stream response.
+     * Get the composition plan client
+     */
+    get compositionPlan() {
+        return this._client.compositionPlan;
+    }
+    /**
+     * Compose a song from a prompt or a composition plan.
      * @throws {@link ElevenLabs.UnprocessableEntityError}
      */
-    // @ts-expect-error - Intentionally overriding parent method with different return type
-    composeDetailed() {
-        const _super = Object.create(null, {
-            composeDetailed: { get: () => super.composeDetailed }
-        });
+    compose(request = {}, requestOptions) {
+        return this._client.compose(request, requestOptions);
+    }
+    /**
+     * Compose a song from a prompt or a composition plan with detailed response parsing.
+     *
+     * Unlike the standard `compose()` method which returns a raw audio stream, this method
+     * automatically parses the multipart response to extract both the audio file and rich
+     * metadata about the generated composition.
+     *
+     * @param request - The music composition request containing either:
+     *   - `prompt`: A text description of the desired music (e.g., "upbeat electronic dance music")
+     *   - `compositionPlan`: A detailed composition plan object created via `compositionPlan.create()`
+     *   - `musicLengthMs`: Optional duration in milliseconds (10000-300000ms)
+     *
+     * @param requestOptions - Optional request configuration (e.g., timeout, signal, headers)
+     *
+     * @returns A promise that resolves to a `MultipartResponse` containing:
+     *   - `json.compositionPlan`: The detailed composition plan structure including sections,
+     *     styles, and lyrics
+     *   - `json.songMetadata`: Metadata about the generated song (title, description, genres,
+     *     languages, explicit content flag)
+     *   - `audio`: Buffer containing the complete audio file (MP3 format)
+     *   - `filename`: Suggested filename for the audio file
+     *
+     * @throws {@link ElevenLabs.UnprocessableEntityError} If the request parameters are invalid
+     *   or the music generation fails
+     *
+     * @example
+     * ```typescript
+     * const client = new ElevenLabs({ apiKey: "your-api-key" });
+     *
+     * // Generate music from a text prompt
+     * const response = await client.music.composeDetailed({
+     *   prompt: "Epic orchestral music with dramatic strings and powerful brass",
+     *   musicLengthMs: 60000 // 60 seconds
+     * });
+     *
+     * console.log("Title:", response.json.songMetadata.title);
+     * console.log("Genres:", response.json.songMetadata.genres);
+     *
+     * // Save the audio to a file
+     * fs.writeFileSync(response.filename, response.audio);
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Generate music from a composition plan
+     * const plan = await client.music.compositionPlan.create({
+     *   prompt: "A progressive rock song about space exploration"
+     * });
+     *
+     * const response = await client.music.composeDetailed({
+     *   compositionPlan: plan.compositionPlan
+     * });
+     *
+     * // Access detailed section information
+     * for (const section of response.json.compositionPlan.sections) {
+     *   console.log(`${section.sectionName}: ${section.durationMs}ms`);
+     * }
+     * ```
+     */
+    composeDetailed(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this._composeDetailed(request, requestOptions));
+    }
+    _composeDetailed() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
-            // Call the parent method to get the stream
-            const response = yield _super.composeDetailed.call(this, request, requestOptions);
-            // Parse the stream using your existing parsing method
-            const parsedResponse = yield this.parseMultipart(response);
-            return parsedResponse;
+            // Call the base client method to get the stream with raw response
+            try {
+                const { data: stream, rawResponse } = yield this._client.composeDetailed(request, requestOptions).withRawResponse();
+                // Parse the stream using the existing parsing method
+                const parsedResponse = yield this.parseMultipart(stream);
+                return { data: parsedResponse, rawResponse };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`Failed to parse detailed composition response: ${message}`);
+            }
         });
     }
+    /**
+     * Stream a composed song from a prompt or a composition plan.
+     * @throws {@link ElevenLabs.UnprocessableEntityError}
+     */
+    stream(request = {}, requestOptions) {
+        return this._client.stream(request, requestOptions);
+    }
     /**
      * Reads a ReadableStream containing multipart data and parses it into JSON and audio parts
      * @param stream - ReadableStream from ElevenLabs music API response

package/wrapper/realtime/connection.js

@@ -98,7 +98,6 @@ class RealtimeConnection {
                     break;
                 case "final_transcript_with_timestamps":
                     this.eventEmitter.emit(RealtimeEvents.FINAL_TRANSCRIPT_WITH_TIMESTAMPS, data);
-                    this.close();
                     break;
             }
         });

package/wrapper/realtime/scribe.d.ts

@@ -44,6 +44,11 @@ interface BaseOptions {
      * Must be a valid model ID.
      */
     modelId: string;
+    /**
+     * An ISO-639-1 or ISO-639-3 language_code corresponding to the language of the audio file.
+     * Can sometimes improve transcription performance if known beforehand.
+     */
+    languageCode?: string;
 }
 export interface AudioOptions extends BaseOptions {
     audioFormat: AudioFormat;

package/wrapper/realtime/scribe.js

@@ -133,6 +133,9 @@ class ScribeRealtime {
                 }
                 params.append("min_silence_duration_ms", options.minSilenceDurationMs.toString());
             }
+            if (options.languageCode !== undefined) {
+                params.append("language_code", options.languageCode);
+            }
             const queryString = params.toString();
             return queryString ? `${baseUri}?${queryString}` : baseUri;
         });