@wopr-network/platform-core 1.6.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (26) hide show
  1. package/dist/monetization/adapters/embeddings-factory.d.ts +46 -0
  2. package/dist/monetization/adapters/embeddings-factory.js +50 -0
  3. package/dist/monetization/adapters/embeddings-factory.test.d.ts +1 -0
  4. package/dist/monetization/adapters/embeddings-factory.test.js +105 -0
  5. package/dist/monetization/adapters/rate-table.js +26 -2
  6. package/dist/monetization/adapters/rate-table.test.js +8 -1
  7. package/dist/monetization/adapters/transcription-factory.d.ts +48 -0
  8. package/dist/monetization/adapters/transcription-factory.js +52 -0
  9. package/dist/monetization/adapters/transcription-factory.test.d.ts +1 -0
  10. package/dist/monetization/adapters/transcription-factory.test.js +84 -0
  11. package/dist/monetization/adapters/tts-factory.d.ts +50 -0
  12. package/dist/monetization/adapters/tts-factory.js +62 -0
  13. package/dist/monetization/adapters/tts-factory.test.d.ts +1 -0
  14. package/dist/monetization/adapters/tts-factory.test.js +129 -0
  15. package/dist/monetization/index.d.ts +3 -0
  16. package/dist/monetization/index.js +6 -0
  17. package/package.json +1 -1
  18. package/src/monetization/adapters/embeddings-factory.test.ts +141 -0
  19. package/src/monetization/adapters/embeddings-factory.ts +77 -0
  20. package/src/monetization/adapters/rate-table.test.ts +9 -1
  21. package/src/monetization/adapters/rate-table.ts +28 -2
  22. package/src/monetization/adapters/transcription-factory.test.ts +110 -0
  23. package/src/monetization/adapters/transcription-factory.ts +79 -0
  24. package/src/monetization/adapters/tts-factory.test.ts +163 -0
  25. package/src/monetization/adapters/tts-factory.ts +93 -0
  26. package/src/monetization/index.ts +21 -0
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Embeddings adapter factory — instantiates all available embeddings adapters
3
+ * from environment config and returns them ready to register.
4
+ *
5
+ * Only adapters with valid config are created. The factory never touches
6
+ * the database — it returns plain ProviderAdapter instances that the caller
7
+ * registers with an ArbitrageRouter or AdapterSocket.
8
+ *
9
+ * Priority order (cheapest first, when all adapters available):
10
+ * self-hosted-embeddings (GPU, cheapest — not yet implemented)
11
+ * → OpenRouter ($0.02/1M tokens via text-embedding-3-small)
12
+ */
13
+ import { type OpenRouterAdapterConfig } from "./openrouter.js";
14
+ import type { ProviderAdapter } from "./types.js";
15
+ /** Top-level factory config. Only providers with an API key are instantiated. */
16
+ export interface EmbeddingsFactoryConfig {
17
+ /** OpenRouter API key. Omit or empty string to skip. */
18
+ openrouterApiKey?: string;
19
+ /** Per-adapter config overrides */
20
+ openrouter?: Omit<Partial<OpenRouterAdapterConfig>, "apiKey">;
21
+ }
22
+ /** Result of the factory — adapters + metadata for observability. */
23
+ export interface EmbeddingsFactoryResult {
24
+ /** All instantiated adapters, ordered by cost priority (cheapest first). */
25
+ adapters: ProviderAdapter[];
26
+ /** Map of adapter name → ProviderAdapter for direct registration. */
27
+ adapterMap: Map<string, ProviderAdapter>;
28
+ /** Names of providers that were skipped (missing config). */
29
+ skipped: string[];
30
+ }
31
+ /**
32
+ * Create embeddings adapters from the provided config.
33
+ *
34
+ * Returns only adapters whose API key is present and non-empty.
35
+ * Order matches arbitrage priority: cheapest first.
36
+ */
37
+ export declare function createEmbeddingsAdapters(config: EmbeddingsFactoryConfig): EmbeddingsFactoryResult;
38
+ /**
39
+ * Create embeddings adapters from environment variables.
40
+ *
41
+ * Reads API keys from:
42
+ * - OPENROUTER_API_KEY
43
+ *
44
+ * Accepts optional per-adapter overrides.
45
+ */
46
+ export declare function createEmbeddingsAdaptersFromEnv(overrides?: Omit<EmbeddingsFactoryConfig, "openrouterApiKey">): EmbeddingsFactoryResult;
@@ -0,0 +1,50 @@
1
+ /**
2
+ * Embeddings adapter factory — instantiates all available embeddings adapters
3
+ * from environment config and returns them ready to register.
4
+ *
5
+ * Only adapters with valid config are created. The factory never touches
6
+ * the database — it returns plain ProviderAdapter instances that the caller
7
+ * registers with an ArbitrageRouter or AdapterSocket.
8
+ *
9
+ * Priority order (cheapest first, when all adapters available):
10
+ * self-hosted-embeddings (GPU, cheapest — not yet implemented)
11
+ * → OpenRouter ($0.02/1M tokens via text-embedding-3-small)
12
+ */
13
+ import { createOpenRouterAdapter } from "./openrouter.js";
14
+ /**
15
+ * Create embeddings adapters from the provided config.
16
+ *
17
+ * Returns only adapters whose API key is present and non-empty.
18
+ * Order matches arbitrage priority: cheapest first.
19
+ */
20
+ export function createEmbeddingsAdapters(config) {
21
+ const adapters = [];
22
+ const skipped = [];
23
+ // OpenRouter — $0.02/1M tokens (text-embedding-3-small via OpenAI)
24
+ if (config.openrouterApiKey) {
25
+ adapters.push(createOpenRouterAdapter({ ...config.openrouter, apiKey: config.openrouterApiKey }));
26
+ }
27
+ else {
28
+ skipped.push("openrouter");
29
+ }
30
+ // Future: self-hosted-embeddings will go BEFORE openrouter (GPU tier, cheapest)
31
+ const adapterMap = new Map();
32
+ for (const adapter of adapters) {
33
+ adapterMap.set(adapter.name, adapter);
34
+ }
35
+ return { adapters, adapterMap, skipped };
36
+ }
37
+ /**
38
+ * Create embeddings adapters from environment variables.
39
+ *
40
+ * Reads API keys from:
41
+ * - OPENROUTER_API_KEY
42
+ *
43
+ * Accepts optional per-adapter overrides.
44
+ */
45
+ export function createEmbeddingsAdaptersFromEnv(overrides) {
46
+ return createEmbeddingsAdapters({
47
+ openrouterApiKey: process.env.OPENROUTER_API_KEY,
48
+ ...overrides,
49
+ });
50
+ }
@@ -0,0 +1,105 @@
1
+ import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
2
+ import { createEmbeddingsAdapters, createEmbeddingsAdaptersFromEnv } from "./embeddings-factory.js";
3
+ import * as openrouterModule from "./openrouter.js";
4
+ describe("createEmbeddingsAdapters", () => {
5
+ it("creates adapter when API key provided", () => {
6
+ const result = createEmbeddingsAdapters({
7
+ openrouterApiKey: "sk-or",
8
+ });
9
+ expect(result.adapters).toHaveLength(1);
10
+ expect(result.adapterMap.size).toBe(1);
11
+ expect(result.skipped).toHaveLength(0);
12
+ });
13
+ it("adapter is openrouter", () => {
14
+ const result = createEmbeddingsAdapters({
15
+ openrouterApiKey: "sk-or",
16
+ });
17
+ expect(result.adapters[0].name).toBe("openrouter");
18
+ });
19
+ it("skips openrouter when no API key", () => {
20
+ const result = createEmbeddingsAdapters({});
21
+ expect(result.adapters).toHaveLength(0);
22
+ expect(result.skipped).toEqual(["openrouter"]);
23
+ });
24
+ it("skips adapter with empty string key", () => {
25
+ const result = createEmbeddingsAdapters({
26
+ openrouterApiKey: "",
27
+ });
28
+ expect(result.adapters).toHaveLength(0);
29
+ expect(result.skipped).toContain("openrouter");
30
+ });
31
+ it("adapter supports embeddings capability", () => {
32
+ const result = createEmbeddingsAdapters({
33
+ openrouterApiKey: "sk-or",
34
+ });
35
+ expect(result.adapters[0].capabilities).toContain("embeddings");
36
+ });
37
+ it("adapter implements embed", () => {
38
+ const result = createEmbeddingsAdapters({
39
+ openrouterApiKey: "sk-or",
40
+ });
41
+ expect(typeof result.adapters[0].embed).toBe("function");
42
+ });
43
+ it("adapterMap keys match adapter names", () => {
44
+ const result = createEmbeddingsAdapters({
45
+ openrouterApiKey: "sk-or",
46
+ });
47
+ for (const [key, adapter] of result.adapterMap) {
48
+ expect(key).toBe(adapter.name);
49
+ }
50
+ });
51
+ it("passes per-adapter config overrides to adapter constructor", () => {
52
+ const spy = vi.spyOn(openrouterModule, "createOpenRouterAdapter");
53
+ createEmbeddingsAdapters({
54
+ openrouterApiKey: "sk-or",
55
+ openrouter: { marginMultiplier: 1.5 },
56
+ });
57
+ expect(spy).toHaveBeenCalledWith(expect.objectContaining({
58
+ apiKey: "sk-or",
59
+ marginMultiplier: 1.5,
60
+ }));
61
+ spy.mockRestore();
62
+ });
63
+ it("apiKey cannot be overridden via openrouter config", () => {
64
+ // Ensure apiKey always comes from openrouterApiKey, not from spread
65
+ const result = createEmbeddingsAdapters({
66
+ openrouterApiKey: "sk-real",
67
+ openrouter: { apiKey: "sk-evil" },
68
+ });
69
+ expect(result.adapters).toHaveLength(1);
70
+ expect(result.adapters[0].name).toBe("openrouter");
71
+ });
72
+ });
73
+ describe("createEmbeddingsAdaptersFromEnv", () => {
74
+ beforeEach(() => {
75
+ vi.unstubAllEnvs();
76
+ });
77
+ afterAll(() => {
78
+ vi.unstubAllEnvs();
79
+ });
80
+ it("reads key from environment variable", () => {
81
+ vi.stubEnv("OPENROUTER_API_KEY", "env-or");
82
+ const result = createEmbeddingsAdaptersFromEnv();
83
+ expect(result.adapters).toHaveLength(1);
84
+ expect(result.adapters[0].name).toBe("openrouter");
85
+ expect(result.skipped).toHaveLength(0);
86
+ });
87
+ it("returns empty when no env var set", () => {
88
+ vi.stubEnv("OPENROUTER_API_KEY", "");
89
+ const result = createEmbeddingsAdaptersFromEnv();
90
+ expect(result.adapters).toHaveLength(0);
91
+ expect(result.skipped).toEqual(["openrouter"]);
92
+ });
93
+ it("passes per-adapter overrides alongside env key to adapter constructor", () => {
94
+ vi.stubEnv("OPENROUTER_API_KEY", "env-or");
95
+ const spy = vi.spyOn(openrouterModule, "createOpenRouterAdapter");
96
+ createEmbeddingsAdaptersFromEnv({
97
+ openrouter: { marginMultiplier: 1.2 },
98
+ });
99
+ expect(spy).toHaveBeenCalledWith(expect.objectContaining({
100
+ apiKey: "env-or",
101
+ marginMultiplier: 1.2,
102
+ }));
103
+ spy.mockRestore();
104
+ });
105
+ });
@@ -61,9 +61,33 @@ export const RATE_TABLE = [
61
61
  margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
62
62
  effectivePrice: 0.0000013, // = costPerUnit * margin ($1.30 per 1M tokens)
63
63
  },
64
+ // Transcription - Speech-to-Text
65
+ // NOTE: No self-hosted whisper adapter yet — only premium (deepgram) available.
66
+ // When self-hosted-whisper lands, add a standard tier entry here.
67
+ {
68
+ capability: "transcription",
69
+ tier: "premium",
70
+ provider: "deepgram",
71
+ costPerUnit: 0.0000717, // $0.0043/min = $0.0000717/sec
72
+ billingUnit: "per-second",
73
+ margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
74
+ effectivePrice: 0.00009321, // = costPerUnit * margin ($93.21 per 1M seconds ≈ $5.59 per 1M minutes)
75
+ },
76
+ // Embeddings
77
+ // NOTE: No self-hosted embeddings adapter yet — only premium (openrouter) available.
78
+ // When self-hosted-embeddings lands, add a standard tier entry here.
79
+ {
80
+ capability: "embeddings",
81
+ tier: "premium",
82
+ provider: "openrouter",
83
+ costPerUnit: 0.00000002, // $0.02 per 1M tokens (text-embedding-3-small via OpenRouter)
84
+ billingUnit: "per-token",
85
+ margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
86
+ effectivePrice: 0.000000026, // = costPerUnit * margin ($0.026 per 1M tokens)
87
+ },
64
88
  // Future self-hosted adapters will add more entries here:
65
- // - transcription: self-hosted-whisper (standard) vs deepgram (premium)
66
- // - embeddings: self-hosted-embeddings (standard) vs openrouter (premium)
89
+ // - transcription: self-hosted-whisper (standard) when GPU adapter exists
90
+ // - embeddings: self-hosted-embeddings (standard) when GPU adapter exists
67
91
  // - image-generation: self-hosted-sdxl (standard) vs replicate (premium)
68
92
  ];
69
93
  /**
@@ -104,6 +104,12 @@ describe("getRatesForCapability", () => {
104
104
  expect(rates.map((r) => r.tier)).toContain("standard");
105
105
  expect(rates.map((r) => r.tier)).toContain("premium");
106
106
  });
107
+ it("returns premium-only for transcription (no standard tier yet)", () => {
108
+ const rates = getRatesForCapability("transcription");
109
+ expect(rates).toHaveLength(1);
110
+ expect(rates[0].tier).toBe("premium");
111
+ expect(rates[0].provider).toBe("deepgram");
112
+ });
107
113
  it("returns empty array for non-existent capability", () => {
108
114
  const rates = getRatesForCapability("image-generation");
109
115
  expect(rates).toHaveLength(0);
@@ -136,7 +142,8 @@ describe("calculateSavings", () => {
136
142
  expect(savings).toBeCloseTo(2.01, 2);
137
143
  });
138
144
  it("returns zero when capability has no standard tier", () => {
139
- const savings = calculateSavings("image-generation", 1000);
145
+ // Transcription only has premium (deepgram) — no self-hosted whisper yet
146
+ const savings = calculateSavings("transcription", 1000);
140
147
  expect(savings).toBe(0);
141
148
  });
142
149
  it("returns zero when capability has no premium tier", () => {
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Transcription adapter factory — instantiates all available STT adapters
3
+ * from environment config and returns them ready to register.
4
+ *
5
+ * Only adapters with valid config are created. The factory never touches
6
+ * the database — it returns plain ProviderAdapter instances that the caller
7
+ * registers with an ArbitrageRouter or AdapterSocket.
8
+ *
9
+ * Priority order (cheapest first, when all adapters available):
10
+ * self-hosted-whisper (GPU, cheapest) → Deepgram ($0.0043/min, third-party)
11
+ *
12
+ * NOTE: Self-hosted Whisper adapter doesn't exist yet. When it does, it
13
+ * will slot in as the GPU tier (cheapest) ahead of Deepgram.
14
+ */
15
+ import { type DeepgramAdapterConfig } from "./deepgram.js";
16
+ import type { ProviderAdapter } from "./types.js";
17
+ /** Top-level factory config. Only providers with an API key are instantiated. */
18
+ export interface TranscriptionFactoryConfig {
19
+ /** Deepgram API key. Omit or empty string to skip. */
20
+ deepgramApiKey?: string;
21
+ /** Per-adapter config overrides */
22
+ deepgram?: Omit<Partial<DeepgramAdapterConfig>, "apiKey">;
23
+ }
24
+ /** Result of the factory — adapters + metadata for observability. */
25
+ export interface TranscriptionFactoryResult {
26
+ /** All instantiated adapters, ordered by cost priority (cheapest first). */
27
+ adapters: ProviderAdapter[];
28
+ /** Map of adapter name → ProviderAdapter for direct registration. */
29
+ adapterMap: Map<string, ProviderAdapter>;
30
+ /** Names of providers that were skipped (no API key). */
31
+ skipped: string[];
32
+ }
33
+ /**
34
+ * Create transcription adapters from the provided config.
35
+ *
36
+ * Returns only adapters whose API key is present and non-empty.
37
+ * Order matches arbitrage priority: cheapest first.
38
+ */
39
+ export declare function createTranscriptionAdapters(config: TranscriptionFactoryConfig): TranscriptionFactoryResult;
40
+ /**
41
+ * Create transcription adapters from environment variables.
42
+ *
43
+ * Reads API keys from:
44
+ * - DEEPGRAM_API_KEY
45
+ *
46
+ * Accepts optional per-adapter overrides.
47
+ */
48
+ export declare function createTranscriptionAdaptersFromEnv(overrides?: Omit<TranscriptionFactoryConfig, "deepgramApiKey">): TranscriptionFactoryResult;
@@ -0,0 +1,52 @@
1
+ /**
2
+ * Transcription adapter factory — instantiates all available STT adapters
3
+ * from environment config and returns them ready to register.
4
+ *
5
+ * Only adapters with valid config are created. The factory never touches
6
+ * the database — it returns plain ProviderAdapter instances that the caller
7
+ * registers with an ArbitrageRouter or AdapterSocket.
8
+ *
9
+ * Priority order (cheapest first, when all adapters available):
10
+ * self-hosted-whisper (GPU, cheapest) → Deepgram ($0.0043/min, third-party)
11
+ *
12
+ * NOTE: Self-hosted Whisper adapter doesn't exist yet. When it does, it
13
+ * will slot in as the GPU tier (cheapest) ahead of Deepgram.
14
+ */
15
+ import { createDeepgramAdapter } from "./deepgram.js";
16
+ /**
17
+ * Create transcription adapters from the provided config.
18
+ *
19
+ * Returns only adapters whose API key is present and non-empty.
20
+ * Order matches arbitrage priority: cheapest first.
21
+ */
22
+ export function createTranscriptionAdapters(config) {
23
+ const adapters = [];
24
+ const skipped = [];
25
+ // Deepgram — $0.0043/min (Nova-2 wholesale)
26
+ if (config.deepgramApiKey) {
27
+ adapters.push(createDeepgramAdapter({ apiKey: config.deepgramApiKey, ...config.deepgram }));
28
+ }
29
+ else {
30
+ skipped.push("deepgram");
31
+ }
32
+ // Future: self-hosted-whisper will go BEFORE deepgram (GPU tier, cheapest)
33
+ const adapterMap = new Map();
34
+ for (const adapter of adapters) {
35
+ adapterMap.set(adapter.name, adapter);
36
+ }
37
+ return { adapters, adapterMap, skipped };
38
+ }
39
+ /**
40
+ * Create transcription adapters from environment variables.
41
+ *
42
+ * Reads API keys from:
43
+ * - DEEPGRAM_API_KEY
44
+ *
45
+ * Accepts optional per-adapter overrides.
46
+ */
47
+ export function createTranscriptionAdaptersFromEnv(overrides) {
48
+ return createTranscriptionAdapters({
49
+ deepgramApiKey: process.env.DEEPGRAM_API_KEY,
50
+ ...overrides,
51
+ });
52
+ }
@@ -0,0 +1,84 @@
1
+ import { afterAll, describe, expect, it, vi } from "vitest";
2
+ import { createTranscriptionAdapters, createTranscriptionAdaptersFromEnv } from "./transcription-factory.js";
3
+ describe("createTranscriptionAdapters", () => {
4
+ it("creates deepgram adapter when API key provided", () => {
5
+ const result = createTranscriptionAdapters({
6
+ deepgramApiKey: "sk-dg",
7
+ });
8
+ expect(result.adapters).toHaveLength(1);
9
+ expect(result.adapterMap.size).toBe(1);
10
+ expect(result.skipped).toHaveLength(0);
11
+ });
12
+ it("returns deepgram as only adapter", () => {
13
+ const result = createTranscriptionAdapters({
14
+ deepgramApiKey: "sk-dg",
15
+ });
16
+ expect(result.adapters[0].name).toBe("deepgram");
17
+ });
18
+ it("skips deepgram when no API key", () => {
19
+ const result = createTranscriptionAdapters({});
20
+ expect(result.adapters).toHaveLength(0);
21
+ expect(result.skipped).toEqual(["deepgram"]);
22
+ });
23
+ it("skips deepgram with empty string API key", () => {
24
+ const result = createTranscriptionAdapters({
25
+ deepgramApiKey: "",
26
+ });
27
+ expect(result.adapters).toHaveLength(0);
28
+ expect(result.skipped).toContain("deepgram");
29
+ });
30
+ it("adapter supports transcription capability", () => {
31
+ const result = createTranscriptionAdapters({
32
+ deepgramApiKey: "sk-dg",
33
+ });
34
+ expect(result.adapters[0].capabilities).toContain("transcription");
35
+ });
36
+ it("adapter implements transcribe", () => {
37
+ const result = createTranscriptionAdapters({
38
+ deepgramApiKey: "sk-dg",
39
+ });
40
+ expect(typeof result.adapters[0].transcribe).toBe("function");
41
+ });
42
+ it("adapterMap keys match adapter names", () => {
43
+ const result = createTranscriptionAdapters({
44
+ deepgramApiKey: "sk-dg",
45
+ });
46
+ for (const [key, adapter] of result.adapterMap) {
47
+ expect(key).toBe(adapter.name);
48
+ }
49
+ });
50
+ it("passes per-adapter config overrides", () => {
51
+ const result = createTranscriptionAdapters({
52
+ deepgramApiKey: "sk-dg",
53
+ deepgram: { costPerMinute: 0.005, defaultModel: "nova-2-general" },
54
+ });
55
+ expect(result.adapters).toHaveLength(1);
56
+ expect(result.adapters[0].name).toBe("deepgram");
57
+ });
58
+ });
59
+ describe("createTranscriptionAdaptersFromEnv", () => {
60
+ afterAll(() => {
61
+ vi.unstubAllEnvs();
62
+ });
63
+ it("reads API keys from environment variables", () => {
64
+ vi.stubEnv("DEEPGRAM_API_KEY", "env-dg");
65
+ const result = createTranscriptionAdaptersFromEnv();
66
+ expect(result.adapters).toHaveLength(1);
67
+ expect(result.adapters[0].name).toBe("deepgram");
68
+ expect(result.skipped).toHaveLength(0);
69
+ });
70
+ it("returns empty when no env vars set", () => {
71
+ vi.stubEnv("DEEPGRAM_API_KEY", "");
72
+ const result = createTranscriptionAdaptersFromEnv();
73
+ expect(result.adapters).toHaveLength(0);
74
+ expect(result.skipped).toHaveLength(1);
75
+ });
76
+ it("accepts per-adapter overrides alongside env keys", () => {
77
+ vi.stubEnv("DEEPGRAM_API_KEY", "env-dg");
78
+ const result = createTranscriptionAdaptersFromEnv({
79
+ deepgram: { marginMultiplier: 1.5 },
80
+ });
81
+ expect(result.adapters).toHaveLength(1);
82
+ expect(result.adapters[0].name).toBe("deepgram");
83
+ });
84
+ });
@@ -0,0 +1,50 @@
1
+ /**
2
+ * TTS adapter factory — instantiates all available TTS adapters from
3
+ * environment config and returns them ready to register.
4
+ *
5
+ * Only adapters with valid config are created. The factory never touches
6
+ * the database — it returns plain ProviderAdapter instances that the caller
7
+ * registers with an ArbitrageRouter or AdapterSocket.
8
+ *
9
+ * Priority order (cheapest first):
10
+ * GPU (chatterbox-tts, self-hosted) → ElevenLabs (third-party)
11
+ */
12
+ import { type ChatterboxTTSAdapterConfig } from "./chatterbox-tts.js";
13
+ import { type ElevenLabsAdapterConfig } from "./elevenlabs.js";
14
+ import type { ProviderAdapter } from "./types.js";
15
+ /** Top-level factory config. Chatterbox needs a base URL; ElevenLabs needs an API key. */
16
+ export interface TTSFactoryConfig {
17
+ /** Chatterbox GPU container base URL (e.g., "http://chatterbox:8000"). Omit to skip. */
18
+ chatterboxBaseUrl?: string;
19
+ /** ElevenLabs API key. Omit or empty string to skip. */
20
+ elevenlabsApiKey?: string;
21
+ /** Per-adapter config overrides */
22
+ chatterbox?: Omit<Partial<ChatterboxTTSAdapterConfig>, "baseUrl">;
23
+ elevenlabs?: Omit<Partial<ElevenLabsAdapterConfig>, "apiKey">;
24
+ }
25
+ /** Result of the factory — adapters + metadata for observability. */
26
+ export interface TTSFactoryResult {
27
+ /** All instantiated adapters, ordered by cost priority (cheapest first). */
28
+ adapters: ProviderAdapter[];
29
+ /** Map of adapter name → ProviderAdapter for direct registration. */
30
+ adapterMap: Map<string, ProviderAdapter>;
31
+ /** Names of providers that were skipped (missing config). */
32
+ skipped: string[];
33
+ }
34
+ /**
35
+ * Create TTS adapters from the provided config.
36
+ *
37
+ * Returns only adapters whose required config is present.
38
+ * Order matches arbitrage priority: GPU (cheapest) first.
39
+ */
40
+ export declare function createTTSAdapters(config: TTSFactoryConfig): TTSFactoryResult;
41
+ /**
42
+ * Create TTS adapters from environment variables.
43
+ *
44
+ * Reads config from:
45
+ * - CHATTERBOX_BASE_URL
46
+ * - ELEVENLABS_API_KEY
47
+ *
48
+ * Accepts optional per-adapter overrides.
49
+ */
50
+ export declare function createTTSAdaptersFromEnv(overrides?: Omit<TTSFactoryConfig, "chatterboxBaseUrl" | "elevenlabsApiKey">): TTSFactoryResult;
@@ -0,0 +1,62 @@
1
+ /**
2
+ * TTS adapter factory — instantiates all available TTS adapters from
3
+ * environment config and returns them ready to register.
4
+ *
5
+ * Only adapters with valid config are created. The factory never touches
6
+ * the database — it returns plain ProviderAdapter instances that the caller
7
+ * registers with an ArbitrageRouter or AdapterSocket.
8
+ *
9
+ * Priority order (cheapest first):
10
+ * GPU (chatterbox-tts, self-hosted) → ElevenLabs (third-party)
11
+ */
12
+ import { createChatterboxTTSAdapter } from "./chatterbox-tts.js";
13
+ import { createElevenLabsAdapter } from "./elevenlabs.js";
14
+ /**
15
+ * Create TTS adapters from the provided config.
16
+ *
17
+ * Returns only adapters whose required config is present.
18
+ * Order matches arbitrage priority: GPU (cheapest) first.
19
+ */
20
+ export function createTTSAdapters(config) {
21
+ const adapters = [];
22
+ const skipped = [];
23
+ // Chatterbox — self-hosted GPU, $2.00/1M chars wholesale, $2.40/1M effective (cheapest)
24
+ if (config.chatterboxBaseUrl) {
25
+ adapters.push(createChatterboxTTSAdapter({
26
+ baseUrl: config.chatterboxBaseUrl,
27
+ costPerUnit: 0.000002,
28
+ ...config.chatterbox,
29
+ }));
30
+ }
31
+ else {
32
+ skipped.push("chatterbox-tts");
33
+ }
34
+ // ElevenLabs — third-party, ~$15/1M chars (premium)
35
+ if (config.elevenlabsApiKey) {
36
+ adapters.push(createElevenLabsAdapter({ apiKey: config.elevenlabsApiKey, ...config.elevenlabs }));
37
+ }
38
+ else {
39
+ skipped.push("elevenlabs");
40
+ }
41
+ const adapterMap = new Map();
42
+ for (const adapter of adapters) {
43
+ adapterMap.set(adapter.name, adapter);
44
+ }
45
+ return { adapters, adapterMap, skipped };
46
+ }
47
+ /**
48
+ * Create TTS adapters from environment variables.
49
+ *
50
+ * Reads config from:
51
+ * - CHATTERBOX_BASE_URL
52
+ * - ELEVENLABS_API_KEY
53
+ *
54
+ * Accepts optional per-adapter overrides.
55
+ */
56
+ export function createTTSAdaptersFromEnv(overrides) {
57
+ return createTTSAdapters({
58
+ chatterboxBaseUrl: process.env.CHATTERBOX_BASE_URL,
59
+ elevenlabsApiKey: process.env.ELEVENLABS_API_KEY,
60
+ ...overrides,
61
+ });
62
+ }
@@ -0,0 +1 @@
1
+ export {};