@scenar/cli 0.1.18 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scenar/cli",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "Scenar CLI — validate scenarios, generate narration, and render videos.",
   "license": "Apache-2.0",
   "type": "module",
@@ -27,9 +27,9 @@
   "main": "./src/index.js",
   "types": "./src/index.d.ts",
   "dependencies": {
-    "@scenar/core": "0.1.18",
-    "@scenar/preview": "0.1.18",
-    "@scenar/sdk": "0.1.18",
+    "@scenar/core": "0.1.19",
+    "@scenar/preview": "0.1.19",
+    "@scenar/sdk": "0.1.19",
     "commander": "^13.0.0",
     "yaml": "^2.7.0"
   },

package/src/__tests__/edge-tts-provider.test.ts

@@ -2,16 +2,16 @@ import { describe, it, expect, vi, beforeEach } from "vitest";
 
 vi.mock("edge-tts-universal", () => {
   const mockSynthesize = vi.fn();
-  const MockEdgeTTS = vi.fn().mockImplementation(() => ({
+  const MockIsomorphicEdgeTTS = vi.fn().mockImplementation(() => ({
     synthesize: mockSynthesize,
   }));
-  return { EdgeTTS: MockEdgeTTS, __mockSynthesize: mockSynthesize };
+  return { IsomorphicEdgeTTS: MockIsomorphicEdgeTTS, __mockSynthesize: mockSynthesize };
 });
 
-import { EdgeTTS } from "edge-tts-universal";
+import { IsomorphicEdgeTTS } from "edge-tts-universal";
 
 // Access the inner mock so tests can configure per-call responses.
-const MockEdgeTTS = vi.mocked(EdgeTTS);
+const MockIsomorphicEdgeTTS = vi.mocked(IsomorphicEdgeTTS);
 const mockSynthesize = (
   await import("edge-tts-universal") as { __mockSynthesize: ReturnType<typeof vi.fn> }
 ).__mockSynthesize;
@@ -33,7 +33,7 @@ describe("Edge TTS provider", () => {
     const provider = createEdgeTtsProvider();
     const result = await provider.synthesize("Hello world", { voice: "en-US-JennyNeural" });
 
-    expect(MockEdgeTTS).toHaveBeenCalledWith("Hello world", "en-US-JennyNeural");
+    expect(MockIsomorphicEdgeTTS).toHaveBeenCalledWith("Hello world", "en-US-JennyNeural");
     expect(result.audio).toBeInstanceOf(Buffer);
     expect(result.durationMs).toBe(2500);
   });
@@ -48,7 +48,7 @@ describe("Edge TTS provider", () => {
     const provider = createEdgeTtsProvider();
     await provider.synthesize("Test", {});
 
-    expect(MockEdgeTTS).toHaveBeenCalledWith("Test", "en-US-AndrewMultilingualNeural");
+    expect(MockIsomorphicEdgeTTS).toHaveBeenCalledWith("Test", "en-US-AndrewMultilingualNeural");
   });
 
   it("computes duration from the last subtitle entry", async () => {

package/src/tts/edge-tts.d.ts

@@ -11,6 +11,14 @@ export declare function isEdgeTtsAvailable(): Promise<boolean>;
  * `edge-tts-universal` is an **optional peer dependency** (AGPL-3.0 licensed).
  * Users must install it explicitly: `pnpm add edge-tts-universal`.
  *
+ * Uses `IsomorphicEdgeTTS` instead of `EdgeTTS` because the latter
+ * delegates to `Communicate` whose WebSocket handler calls
+ * `message.subarray()` assuming a Node.js `Buffer`. On Node v23+ the
+ * `ws` library may deliver typed arrays or other non-Buffer objects,
+ * causing `TypeError: message.subarray is not a function`.
+ * `IsomorphicEdgeTTS` → `IsomorphicCommunicate` normalises all
+ * incoming data types before processing.
+ *
  * Duration is extracted from word-boundary subtitle metadata returned by
  * the service. Falls back to a bitrate-based estimate when metadata is
  * unavailable — same approach proven in Stigmer's narration pipeline.

package/src/tts/edge-tts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edge-tts.d.ts","sourceRoot":"","sources":["../../../src/tts/edge-tts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,YAAY,CAAC;AAUrE;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO3D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAsCnD"}
+{"version":3,"file":"edge-tts.d.ts","sourceRoot":"","sources":["../../../src/tts/edge-tts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,YAAY,CAAC;AAUrE;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO3D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAsCnD"}

package/src/tts/edge-tts.js

@@ -24,6 +24,14 @@ export async function isEdgeTtsAvailable() {
  * `edge-tts-universal` is an **optional peer dependency** (AGPL-3.0 licensed).
  * Users must install it explicitly: `pnpm add edge-tts-universal`.
  *
+ * Uses `IsomorphicEdgeTTS` instead of `EdgeTTS` because the latter
+ * delegates to `Communicate` whose WebSocket handler calls
+ * `message.subarray()` assuming a Node.js `Buffer`. On Node v23+ the
+ * `ws` library may deliver typed arrays or other non-Buffer objects,
+ * causing `TypeError: message.subarray is not a function`.
+ * `IsomorphicEdgeTTS` → `IsomorphicCommunicate` normalises all
+ * incoming data types before processing.
+ *
  * Duration is extracted from word-boundary subtitle metadata returned by
  * the service. Falls back to a bitrate-based estimate when metadata is
  * unavailable — same approach proven in Stigmer's narration pipeline.
@@ -33,10 +41,10 @@ export function createEdgeTtsProvider() {
         name: "edge-tts",
         async synthesize(text, options) {
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            let EdgeTTS;
+            let IsomorphicEdgeTTS;
             try {
                 const mod = await import("edge-tts-universal");
-                EdgeTTS = mod.EdgeTTS;
+                IsomorphicEdgeTTS = mod.IsomorphicEdgeTTS;
             }
             catch {
                 throw new Error("edge-tts-universal is not installed. Install it with:\n\n" +
@@ -44,7 +52,7 @@ export function createEdgeTtsProvider() {
                     "Or use a different TTS provider: --tts echogarden, --tts openai");
             }
             const voice = options.voice ?? DEFAULT_VOICE;
-            const tts = new EdgeTTS(text, voice);
+            const tts = new IsomorphicEdgeTTS(text, voice);
             const result = await tts.synthesize();
             const audioBuffer = Buffer.from(await result.audio.arrayBuffer());
             let durationMs = 0;

package/src/tts/edge-tts.js.map

@@ -1 +1 @@
-{"version":3,"file":"edge-tts.js","sourceRoot":"","sources":["../../../src/tts/edge-tts.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,gCAAgC,CAAC;AAEvD;;;GAGG;AACH,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,UAAU;QAEhB,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAmB;YAChD,8DAA8D;YAC9D,IAAI,OAAY,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;gBAC/C,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,2DAA2D;oBACzD,mCAAmC;oBACnC,iEAAiE,CACpE,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;YAC7C,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;YAEtC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAElE,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACzD,kDAAkD;gBAClD,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,UAAU,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/C,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC;YAC3E,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"edge-tts.js","sourceRoot":"","sources":["../../../src/tts/edge-tts.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,gCAAgC,CAAC;AAEvD;;;GAGG;AACH,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,IAAI,EAAE,UAAU;QAEhB,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAmB;YAChD,8DAA8D;YAC9D,IAAI,iBAAsB,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;gBAC/C,iBAAiB,GAAG,GAAG,CAAC,iBAAiB,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,KAAK,CACb,2DAA2D;oBACzD,mCAAmC;oBACnC,iEAAiE,CACpE,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;YAC7C,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;YAEtC,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YAElE,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBACzD,kDAAkD;gBAClD,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC;YACjE,CAAC;YAED,IAAI,UAAU,KAAK,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/C,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC;YAC3E,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/src/tts/edge-tts.ts

@@ -28,6 +28,14 @@ export async function isEdgeTtsAvailable(): Promise<boolean> {
  * `edge-tts-universal` is an **optional peer dependency** (AGPL-3.0 licensed).
  * Users must install it explicitly: `pnpm add edge-tts-universal`.
  *
+ * Uses `IsomorphicEdgeTTS` instead of `EdgeTTS` because the latter
+ * delegates to `Communicate` whose WebSocket handler calls
+ * `message.subarray()` assuming a Node.js `Buffer`. On Node v23+ the
+ * `ws` library may deliver typed arrays or other non-Buffer objects,
+ * causing `TypeError: message.subarray is not a function`.
+ * `IsomorphicEdgeTTS` → `IsomorphicCommunicate` normalises all
+ * incoming data types before processing.
+ *
  * Duration is extracted from word-boundary subtitle metadata returned by
  * the service. Falls back to a bitrate-based estimate when metadata is
  * unavailable — same approach proven in Stigmer's narration pipeline.
@@ -38,10 +46,10 @@ export function createEdgeTtsProvider(): TtsProvider {
 
     async synthesize(text: string, options: TtsOptions): Promise<TtsResult> {
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
-      let EdgeTTS: any;
+      let IsomorphicEdgeTTS: any;
       try {
         const mod = await import("edge-tts-universal");
-        EdgeTTS = mod.EdgeTTS;
+        IsomorphicEdgeTTS = mod.IsomorphicEdgeTTS;
       } catch {
         throw new Error(
           "edge-tts-universal is not installed. Install it with:\n\n" +
@@ -51,7 +59,7 @@ export function createEdgeTtsProvider(): TtsProvider {
       }
 
       const voice = options.voice ?? DEFAULT_VOICE;
-      const tts = new EdgeTTS(text, voice);
+      const tts = new IsomorphicEdgeTTS(text, voice);
       const result = await tts.synthesize();
 
       const audioBuffer = Buffer.from(await result.audio.arrayBuffer());