@nebutra/tts 0.2.2 → 0.2.4

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @nebutra/tts
 
+## 0.2.4
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @nebutra/capability-kit@2.0.0
+  - @nebutra/provider-factory@2.0.0
+
 ## 0.2.2
 
 ### Patch Changes

package/package.json

@@ -1,23 +1,29 @@
 {
   "name": "@nebutra/tts",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Provider-agnostic text-to-speech / narration synthesis. Zero-config deterministic mock default; ElevenLabs/OpenAI/Volces adapters wired via the shared provider-factory pattern.",
   "private": false,
   "license": "MIT",
   "type": "module",
   "nebutra": {
+    "status": "wip",
+    "graph": "labs",
     "featureId": "tts",
     "category": "integrations",
     "summary": "Multi-tenant text-to-speech provider abstraction"
   },
-  "main": "./src/index.ts",
-  "types": "./src/index.ts",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
   },
   "dependencies": {
-    "@nebutra/capability-kit": "0.2.2",
-    "@nebutra/provider-factory": "0.2.2"
+    "@nebutra/capability-kit": "2.0.0",
+    "@nebutra/provider-factory": "2.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
@@ -37,6 +43,12 @@
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
   "scripts": {
     "build": "tsup",
     "test": "vitest run",

package/.turbo/turbo-build.log

@@ -1,17 +0,0 @@
-
-> @nebutra/tts@0.2.2 build /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/tts
-> tsup
-
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/tts/tsup.config.ts
-CLI Target: es2022
-CLI Cleaning output folder
-ESM Build start
-ESM dist/index.js     2.26 KB
-ESM dist/index.js.map 5.64 KB
-ESM ⚡️ Build success in 17ms
-DTS Build start
-DTS ⚡️ Build success in 2711ms
-DTS dist/index.d.ts 2.06 KB

package/.turbo/turbo-test.log

@@ -1,14 +0,0 @@
-
-> @nebutra/tts@0.2.1 test /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/tts
-> vitest run
-
-
- RUN  v4.1.4 /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/tts
-
- ✓ src/__tests__/tts.test.ts (9 tests) 5ms
-
- Test Files  1 passed (1)
-      Tests  9 passed (9)
-   Start at  09:38:37
-   Duration  463ms (transform 86ms, setup 0ms, import 110ms, tests 5ms, environment 0ms)
-

package/.turbo/turbo-typecheck.log

@@ -1,4 +0,0 @@
-
-> @nebutra/tts@0.2.2 typecheck /Users/tseka_luk/Documents/Nebutra-SaaS-Lab/Nebutra-Sailor/packages/integrations/tts
-> tsc --noEmit
-

package/src/__tests__/tts.test.ts

@@ -1,68 +0,0 @@
-import { afterEach, describe, expect, it } from "vitest";
-import { getTts, MockTtsProvider, resolveTtsProvider, TtsError } from "../index";
-
-const SAVED = { ...process.env };
-afterEach(() => {
-  process.env = { ...SAVED };
-});
-
-describe("MockTtsProvider", () => {
-  it("is deterministic: same text → same uri + duration", async () => {
-    const p = new MockTtsProvider();
-    const a = await p.synthesize({ text: "hello world", tenantId: "t1" });
-    const b = await p.synthesize({ text: "hello world", tenantId: "t1" });
-    expect(a).toEqual(b);
-    expect(a.uri.startsWith("data:audio/")).toBe(true);
-    expect(a.durationSec).toBeGreaterThan(0);
-  });
-
-  it("longer text → longer estimated duration", async () => {
-    const p = new MockTtsProvider();
-    const short = await p.synthesize({ text: "hi", tenantId: "t1" });
-    const long = await p.synthesize({ text: "hi ".repeat(200), tenantId: "t1" });
-    expect(long.durationSec).toBeGreaterThan(short.durationSec);
-  });
-
-  it("rejects empty text with a TtsError carrying a suggestion", async () => {
-    const p = new MockTtsProvider();
-    await expect(p.synthesize({ text: "   ", tenantId: "t1" })).rejects.toBeInstanceOf(TtsError);
-    try {
-      await p.synthesize({ text: "", tenantId: "t1" });
-    } catch (e) {
-      expect((e as TtsError).suggestion.length).toBeGreaterThan(0);
-      expect((e as TtsError).code).toBe("TTS_EMPTY_TEXT");
-    }
-  });
-
-  it("health() reports ok", async () => {
-    expect((await new MockTtsProvider().health()).ok).toBe(true);
-  });
-});
-
-describe("resolveTtsProvider", () => {
-  it("falls back to mock with no env", () => {
-    expect(resolveTtsProvider()).toBe("mock");
-  });
-  it("detects elevenlabs then openai by env", () => {
-    process.env.OPENAI_API_KEY = "x";
-    expect(resolveTtsProvider()).toBe("openai");
-    process.env.ELEVENLABS_API_KEY = "y";
-    expect(resolveTtsProvider()).toBe("elevenlabs");
-  });
-  it("explicit TTS_PROVIDER wins", () => {
-    process.env.ELEVENLABS_API_KEY = "y";
-    process.env.TTS_PROVIDER = "mock";
-    expect(resolveTtsProvider()).toBe("mock");
-  });
-});
-
-describe("getTts", () => {
-  it("zero-config returns a working mock provider", async () => {
-    const tts = await getTts();
-    const out = await tts.synthesize({ text: "narration line", tenantId: "org_1" });
-    expect(out.uri.startsWith("data:audio/")).toBe(true);
-  });
-  it("throws TtsError for an unimplemented real provider (stub, fail-loud)", async () => {
-    await expect(getTts({ provider: "elevenlabs" })).rejects.toBeInstanceOf(TtsError);
-  });
-});

package/src/index.ts

@@ -1,117 +0,0 @@
-/**
- * @nebutra/tts — provider-agnostic narration synthesis.
- *
- * The video-pipeline gap (the absorbed source had none). Mirrors Sailor's
- * established provider pattern: a deterministic zero-config mock is the
- * active default; real adapters (ElevenLabs/OpenAI/Volces) are selected via
- * the shared `@nebutra/provider-factory` and fail loud until landed (stub
- * lifecycle — activate when a real caller arrives). Multi-tenant by request
- * (`tenantId` is mandatory); persistence is the caller's (`@nebutra/uploads`).
- */
-
-import { CapabilityError } from "@nebutra/capability-kit";
-import { envPresent, resolveProviderType } from "@nebutra/provider-factory";
-
-export class TtsError extends CapabilityError {
-  constructor(message: string, init: { code: string; suggestion: string; cause?: unknown }) {
-    super(message, init, {
-      name: "TtsError",
-      emptySuggestionFallback:
-        "No suggestion was provided. This is a bug in @nebutra/tts — report it.",
-    });
-  }
-}
-
-export type TtsProviderType = "mock" | "elevenlabs" | "openai" | "volces";
-
-export interface SynthesizeRequest {
-  readonly text: string;
-  /** Owning tenant — mandatory; never inferred. */
-  readonly tenantId: string;
-  readonly voice?: string;
-}
-
-export interface SynthesizedAudio {
-  readonly uri: string;
-  readonly durationSec: number;
-  readonly provider: TtsProviderType;
-}
-
-export interface TtsProvider {
-  readonly name: TtsProviderType;
-  synthesize(req: SynthesizeRequest): Promise<SynthesizedAudio>;
-  health(): Promise<{ ok: boolean; detail: string }>;
-}
-
-function assertText(text: string): void {
-  if (!text || text.trim().length === 0) {
-    throw new TtsError("Cannot synthesize empty text.", {
-      code: "TTS_EMPTY_TEXT",
-      suggestion: "Pass a non-empty narration string.",
-    });
-  }
-}
-
-/** ~150 spoken words/min ≈ 2.5 words/s; deterministic estimate. */
-function estimateDurationSec(text: string): number {
-  const words = text.trim().split(/\s+/).length;
-  return Math.max(1, Math.round((words / 2.5) * 10) / 10);
-}
-
-/** Stable non-crypto hash for deterministic mock output. */
-function hash(s: string): string {
-  let h = 2166136261;
-  for (let i = 0; i < s.length; i++) {
-    h ^= s.charCodeAt(i);
-    h = Math.imul(h, 16777619);
-  }
-  return (h >>> 0).toString(36);
-}
-
-/** Zero-config deterministic default — real audio-free, but non-mock-typed. */
-export class MockTtsProvider implements TtsProvider {
-  readonly name = "mock" as const;
-
-  async synthesize(req: SynthesizeRequest): Promise<SynthesizedAudio> {
-    assertText(req.text);
-    const tag = hash(`${req.tenantId}:${req.voice ?? "default"}:${req.text}`);
-    return {
-      uri: `data:audio/x-nebutra-mock;base64,${Buffer.from(tag).toString("base64")}`,
-      durationSec: estimateDurationSec(req.text),
-      provider: "mock",
-    };
-  }
-
-  async health(): Promise<{ ok: boolean; detail: string }> {
-    return { ok: true, detail: "mock tts: deterministic, zero-config" };
-  }
-}
-
-export function resolveTtsProvider(explicit?: TtsProviderType): TtsProviderType {
-  return resolveProviderType<TtsProviderType>({
-    explicit,
-    envVarName: "TTS_PROVIDER",
-    detectors: [
-      { provider: "elevenlabs", when: envPresent("ELEVENLABS_API_KEY") },
-      { provider: "openai", when: envPresent("OPENAI_API_KEY") },
-      { provider: "volces", when: envPresent("VOLCES_TTS_TOKEN") },
-    ],
-    fallback: "mock",
-  });
-}
-
-export interface TtsConfig {
-  readonly provider?: TtsProviderType;
-}
-
-/** Resolve a TTS provider. Zero-config → mock; real adapters fail loud. */
-export async function getTts(config?: TtsConfig): Promise<TtsProvider> {
-  const type = resolveTtsProvider(config?.provider);
-  if (type === "mock") return new MockTtsProvider();
-  throw new TtsError(`The "${type}" TTS provider is not implemented yet.`, {
-    code: "TTS_PROVIDER_UNIMPLEMENTED",
-    suggestion:
-      `Implement the ${type} adapter (synthesize + health) and register it ` +
-      `here, or unset its env var to use the zero-config mock provider.`,
-  });
-}

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src",
-    "incremental": false
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "dist"]
-}

package/tsup.config.ts

@@ -1,10 +0,0 @@
-import { defineConfig } from "tsup";
-
-export default defineConfig({
-  entry: ["src/index.ts"],
-  format: ["esm"],
-  dts: true,
-  clean: true,
-  sourcemap: true,
-  target: "es2022",
-});