@wopr-network/platform-core 1.7.0 → 1.8.0

package/dist/monetization/adapters/embeddings-factory.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Embeddings adapter factory — instantiates all available embeddings adapters
+ * from environment config and returns them ready to register.
+ *
+ * Only adapters with valid config are created. The factory never touches
+ * the database — it returns plain ProviderAdapter instances that the caller
+ * registers with an ArbitrageRouter or AdapterSocket.
+ *
+ * Priority order (cheapest first, when all adapters available):
+ *   self-hosted-embeddings (GPU, cheapest — not yet implemented)
+ *   → OpenRouter ($0.02/1M tokens via text-embedding-3-small)
+ */
+import { type OpenRouterAdapterConfig } from "./openrouter.js";
+import type { ProviderAdapter } from "./types.js";
+/** Top-level factory config. Only providers with an API key are instantiated. */
+export interface EmbeddingsFactoryConfig {
+    /** OpenRouter API key. Omit or empty string to skip. */
+    openrouterApiKey?: string;
+    /** Per-adapter config overrides */
+    openrouter?: Omit<Partial<OpenRouterAdapterConfig>, "apiKey">;
+}
+/** Result of the factory — adapters + metadata for observability. */
+export interface EmbeddingsFactoryResult {
+    /** All instantiated adapters, ordered by cost priority (cheapest first). */
+    adapters: ProviderAdapter[];
+    /** Map of adapter name → ProviderAdapter for direct registration. */
+    adapterMap: Map<string, ProviderAdapter>;
+    /** Names of providers that were skipped (missing config). */
+    skipped: string[];
+}
+/**
+ * Create embeddings adapters from the provided config.
+ *
+ * Returns only adapters whose API key is present and non-empty.
+ * Order matches arbitrage priority: cheapest first.
+ */
+export declare function createEmbeddingsAdapters(config: EmbeddingsFactoryConfig): EmbeddingsFactoryResult;
+/**
+ * Create embeddings adapters from environment variables.
+ *
+ * Reads API keys from:
+ *   - OPENROUTER_API_KEY
+ *
+ * Accepts optional per-adapter overrides.
+ */
+export declare function createEmbeddingsAdaptersFromEnv(overrides?: Omit<EmbeddingsFactoryConfig, "openrouterApiKey">): EmbeddingsFactoryResult;

package/dist/monetization/adapters/embeddings-factory.js

@@ -0,0 +1,50 @@
+/**
+ * Embeddings adapter factory — instantiates all available embeddings adapters
+ * from environment config and returns them ready to register.
+ *
+ * Only adapters with valid config are created. The factory never touches
+ * the database — it returns plain ProviderAdapter instances that the caller
+ * registers with an ArbitrageRouter or AdapterSocket.
+ *
+ * Priority order (cheapest first, when all adapters available):
+ *   self-hosted-embeddings (GPU, cheapest — not yet implemented)
+ *   → OpenRouter ($0.02/1M tokens via text-embedding-3-small)
+ */
+import { createOpenRouterAdapter } from "./openrouter.js";
+/**
+ * Create embeddings adapters from the provided config.
+ *
+ * Returns only adapters whose API key is present and non-empty.
+ * Order matches arbitrage priority: cheapest first.
+ */
+export function createEmbeddingsAdapters(config) {
+    const adapters = [];
+    const skipped = [];
+    // OpenRouter — $0.02/1M tokens (text-embedding-3-small via OpenAI)
+    if (config.openrouterApiKey) {
+        adapters.push(createOpenRouterAdapter({ ...config.openrouter, apiKey: config.openrouterApiKey }));
+    }
+    else {
+        skipped.push("openrouter");
+    }
+    // Future: self-hosted-embeddings will go BEFORE openrouter (GPU tier, cheapest)
+    const adapterMap = new Map();
+    for (const adapter of adapters) {
+        adapterMap.set(adapter.name, adapter);
+    }
+    return { adapters, adapterMap, skipped };
+}
+/**
+ * Create embeddings adapters from environment variables.
+ *
+ * Reads API keys from:
+ *   - OPENROUTER_API_KEY
+ *
+ * Accepts optional per-adapter overrides.
+ */
+export function createEmbeddingsAdaptersFromEnv(overrides) {
+    return createEmbeddingsAdapters({
+        openrouterApiKey: process.env.OPENROUTER_API_KEY,
+        ...overrides,
+    });
+}

package/dist/monetization/adapters/embeddings-factory.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/monetization/adapters/embeddings-factory.test.js

@@ -0,0 +1,105 @@
+import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
+import { createEmbeddingsAdapters, createEmbeddingsAdaptersFromEnv } from "./embeddings-factory.js";
+import * as openrouterModule from "./openrouter.js";
+describe("createEmbeddingsAdapters", () => {
+    it("creates adapter when API key provided", () => {
+        const result = createEmbeddingsAdapters({
+            openrouterApiKey: "sk-or",
+        });
+        expect(result.adapters).toHaveLength(1);
+        expect(result.adapterMap.size).toBe(1);
+        expect(result.skipped).toHaveLength(0);
+    });
+    it("adapter is openrouter", () => {
+        const result = createEmbeddingsAdapters({
+            openrouterApiKey: "sk-or",
+        });
+        expect(result.adapters[0].name).toBe("openrouter");
+    });
+    it("skips openrouter when no API key", () => {
+        const result = createEmbeddingsAdapters({});
+        expect(result.adapters).toHaveLength(0);
+        expect(result.skipped).toEqual(["openrouter"]);
+    });
+    it("skips adapter with empty string key", () => {
+        const result = createEmbeddingsAdapters({
+            openrouterApiKey: "",
+        });
+        expect(result.adapters).toHaveLength(0);
+        expect(result.skipped).toContain("openrouter");
+    });
+    it("adapter supports embeddings capability", () => {
+        const result = createEmbeddingsAdapters({
+            openrouterApiKey: "sk-or",
+        });
+        expect(result.adapters[0].capabilities).toContain("embeddings");
+    });
+    it("adapter implements embed", () => {
+        const result = createEmbeddingsAdapters({
+            openrouterApiKey: "sk-or",
+        });
+        expect(typeof result.adapters[0].embed).toBe("function");
+    });
+    it("adapterMap keys match adapter names", () => {
+        const result = createEmbeddingsAdapters({
+            openrouterApiKey: "sk-or",
+        });
+        for (const [key, adapter] of result.adapterMap) {
+            expect(key).toBe(adapter.name);
+        }
+    });
+    it("passes per-adapter config overrides to adapter constructor", () => {
+        const spy = vi.spyOn(openrouterModule, "createOpenRouterAdapter");
+        createEmbeddingsAdapters({
+            openrouterApiKey: "sk-or",
+            openrouter: { marginMultiplier: 1.5 },
+        });
+        expect(spy).toHaveBeenCalledWith(expect.objectContaining({
+            apiKey: "sk-or",
+            marginMultiplier: 1.5,
+        }));
+        spy.mockRestore();
+    });
+    it("apiKey cannot be overridden via openrouter config", () => {
+        // Ensure apiKey always comes from openrouterApiKey, not from spread
+        const result = createEmbeddingsAdapters({
+            openrouterApiKey: "sk-real",
+            openrouter: { apiKey: "sk-evil" },
+        });
+        expect(result.adapters).toHaveLength(1);
+        expect(result.adapters[0].name).toBe("openrouter");
+    });
+});
+describe("createEmbeddingsAdaptersFromEnv", () => {
+    beforeEach(() => {
+        vi.unstubAllEnvs();
+    });
+    afterAll(() => {
+        vi.unstubAllEnvs();
+    });
+    it("reads key from environment variable", () => {
+        vi.stubEnv("OPENROUTER_API_KEY", "env-or");
+        const result = createEmbeddingsAdaptersFromEnv();
+        expect(result.adapters).toHaveLength(1);
+        expect(result.adapters[0].name).toBe("openrouter");
+        expect(result.skipped).toHaveLength(0);
+    });
+    it("returns empty when no env var set", () => {
+        vi.stubEnv("OPENROUTER_API_KEY", "");
+        const result = createEmbeddingsAdaptersFromEnv();
+        expect(result.adapters).toHaveLength(0);
+        expect(result.skipped).toEqual(["openrouter"]);
+    });
+    it("passes per-adapter overrides alongside env key to adapter constructor", () => {
+        vi.stubEnv("OPENROUTER_API_KEY", "env-or");
+        const spy = vi.spyOn(openrouterModule, "createOpenRouterAdapter");
+        createEmbeddingsAdaptersFromEnv({
+            openrouter: { marginMultiplier: 1.2 },
+        });
+        expect(spy).toHaveBeenCalledWith(expect.objectContaining({
+            apiKey: "env-or",
+            marginMultiplier: 1.2,
+        }));
+        spy.mockRestore();
+    });
+});

package/dist/monetization/adapters/rate-table.js

@@ -73,9 +73,21 @@ export const RATE_TABLE = [
         margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
         effectivePrice: 0.00009321, // = costPerUnit * margin ($93.21 per 1M seconds ≈ $5.59 per 1M minutes)
     },
+    // Embeddings
+    // NOTE: No self-hosted embeddings adapter yet — only premium (openrouter) available.
+    // When self-hosted-embeddings lands, add a standard tier entry here.
+    {
+        capability: "embeddings",
+        tier: "premium",
+        provider: "openrouter",
+        costPerUnit: 0.00000002, // $0.02 per 1M tokens (text-embedding-3-small via OpenRouter)
+        billingUnit: "per-token",
+        margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
+        effectivePrice: 0.000000026, // = costPerUnit * margin ($0.026 per 1M tokens)
+    },
     // Future self-hosted adapters will add more entries here:
     // - transcription: self-hosted-whisper (standard) — when GPU adapter exists
-    // - embeddings: self-hosted-embeddings (standard) vs openrouter (premium)
+    // - embeddings: self-hosted-embeddings (standard) — when GPU adapter exists
     // - image-generation: self-hosted-sdxl (standard) vs replicate (premium)
 ];
 /**

package/dist/monetization/index.d.ts

@@ -20,6 +20,7 @@ export { type ChatterboxTTSAdapterConfig, createChatterboxTTSAdapter } from "./a
 export { createDeepgramAdapter, type DeepgramAdapterConfig } from "./adapters/deepgram.js";
 export { createDeepSeekAdapter, type DeepSeekAdapterConfig } from "./adapters/deepseek.js";
 export { createElevenLabsAdapter, type ElevenLabsAdapterConfig } from "./adapters/elevenlabs.js";
+export { createEmbeddingsAdapters, createEmbeddingsAdaptersFromEnv, type EmbeddingsFactoryConfig, type EmbeddingsFactoryResult, } from "./adapters/embeddings-factory.js";
 export { createGeminiAdapter, type GeminiAdapterConfig } from "./adapters/gemini.js";
 export { createKimiAdapter, type KimiAdapterConfig } from "./adapters/kimi.js";
 export { getMargin, loadMarginConfig, type MarginConfig, type MarginRule, withMarginConfig, } from "./adapters/margin-config.js";

package/dist/monetization/index.js

@@ -21,6 +21,8 @@ export { createChatterboxTTSAdapter } from "./adapters/chatterbox-tts.js";
 export { createDeepgramAdapter } from "./adapters/deepgram.js";
 export { createDeepSeekAdapter } from "./adapters/deepseek.js";
 export { createElevenLabsAdapter } from "./adapters/elevenlabs.js";
+// Embeddings adapter factory (WOP-2190)
+export { createEmbeddingsAdapters, createEmbeddingsAdaptersFromEnv, } from "./adapters/embeddings-factory.js";
 export { createGeminiAdapter } from "./adapters/gemini.js";
 export { createKimiAdapter } from "./adapters/kimi.js";
 // Margin config (WOP-364)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wopr-network/platform-core",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/monetization/adapters/embeddings-factory.test.ts

@@ -0,0 +1,141 @@
+import { afterAll, beforeEach, describe, expect, it, vi } from "vitest";
+import { createEmbeddingsAdapters, createEmbeddingsAdaptersFromEnv } from "./embeddings-factory.js";
+import * as openrouterModule from "./openrouter.js";
+
+describe("createEmbeddingsAdapters", () => {
+  it("creates adapter when API key provided", () => {
+    const result = createEmbeddingsAdapters({
+      openrouterApiKey: "sk-or",
+    });
+
+    expect(result.adapters).toHaveLength(1);
+    expect(result.adapterMap.size).toBe(1);
+    expect(result.skipped).toHaveLength(0);
+  });
+
+  it("adapter is openrouter", () => {
+    const result = createEmbeddingsAdapters({
+      openrouterApiKey: "sk-or",
+    });
+
+    expect(result.adapters[0].name).toBe("openrouter");
+  });
+
+  it("skips openrouter when no API key", () => {
+    const result = createEmbeddingsAdapters({});
+
+    expect(result.adapters).toHaveLength(0);
+    expect(result.skipped).toEqual(["openrouter"]);
+  });
+
+  it("skips adapter with empty string key", () => {
+    const result = createEmbeddingsAdapters({
+      openrouterApiKey: "",
+    });
+
+    expect(result.adapters).toHaveLength(0);
+    expect(result.skipped).toContain("openrouter");
+  });
+
+  it("adapter supports embeddings capability", () => {
+    const result = createEmbeddingsAdapters({
+      openrouterApiKey: "sk-or",
+    });
+
+    expect(result.adapters[0].capabilities).toContain("embeddings");
+  });
+
+  it("adapter implements embed", () => {
+    const result = createEmbeddingsAdapters({
+      openrouterApiKey: "sk-or",
+    });
+
+    expect(typeof result.adapters[0].embed).toBe("function");
+  });
+
+  it("adapterMap keys match adapter names", () => {
+    const result = createEmbeddingsAdapters({
+      openrouterApiKey: "sk-or",
+    });
+
+    for (const [key, adapter] of result.adapterMap) {
+      expect(key).toBe(adapter.name);
+    }
+  });
+
+  it("passes per-adapter config overrides to adapter constructor", () => {
+    const spy = vi.spyOn(openrouterModule, "createOpenRouterAdapter");
+
+    createEmbeddingsAdapters({
+      openrouterApiKey: "sk-or",
+      openrouter: { marginMultiplier: 1.5 },
+    });
+
+    expect(spy).toHaveBeenCalledWith(
+      expect.objectContaining({
+        apiKey: "sk-or",
+        marginMultiplier: 1.5,
+      }),
+    );
+
+    spy.mockRestore();
+  });
+
+  it("apiKey cannot be overridden via openrouter config", () => {
+    // Ensure apiKey always comes from openrouterApiKey, not from spread
+    const result = createEmbeddingsAdapters({
+      openrouterApiKey: "sk-real",
+      openrouter: { apiKey: "sk-evil" } as never,
+    });
+
+    expect(result.adapters).toHaveLength(1);
+    expect(result.adapters[0].name).toBe("openrouter");
+  });
+});
+
+describe("createEmbeddingsAdaptersFromEnv", () => {
+  beforeEach(() => {
+    vi.unstubAllEnvs();
+  });
+
+  afterAll(() => {
+    vi.unstubAllEnvs();
+  });
+
+  it("reads key from environment variable", () => {
+    vi.stubEnv("OPENROUTER_API_KEY", "env-or");
+
+    const result = createEmbeddingsAdaptersFromEnv();
+
+    expect(result.adapters).toHaveLength(1);
+    expect(result.adapters[0].name).toBe("openrouter");
+    expect(result.skipped).toHaveLength(0);
+  });
+
+  it("returns empty when no env var set", () => {
+    vi.stubEnv("OPENROUTER_API_KEY", "");
+
+    const result = createEmbeddingsAdaptersFromEnv();
+
+    expect(result.adapters).toHaveLength(0);
+    expect(result.skipped).toEqual(["openrouter"]);
+  });
+
+  it("passes per-adapter overrides alongside env key to adapter constructor", () => {
+    vi.stubEnv("OPENROUTER_API_KEY", "env-or");
+    const spy = vi.spyOn(openrouterModule, "createOpenRouterAdapter");
+
+    createEmbeddingsAdaptersFromEnv({
+      openrouter: { marginMultiplier: 1.2 },
+    });
+
+    expect(spy).toHaveBeenCalledWith(
+      expect.objectContaining({
+        apiKey: "env-or",
+        marginMultiplier: 1.2,
+      }),
+    );
+
+    spy.mockRestore();
+  });
+});

package/src/monetization/adapters/embeddings-factory.ts

@@ -0,0 +1,77 @@
+/**
+ * Embeddings adapter factory — instantiates all available embeddings adapters
+ * from environment config and returns them ready to register.
+ *
+ * Only adapters with valid config are created. The factory never touches
+ * the database — it returns plain ProviderAdapter instances that the caller
+ * registers with an ArbitrageRouter or AdapterSocket.
+ *
+ * Priority order (cheapest first, when all adapters available):
+ *   self-hosted-embeddings (GPU, cheapest — not yet implemented)
+ *   → OpenRouter ($0.02/1M tokens via text-embedding-3-small)
+ */
+
+import { createOpenRouterAdapter, type OpenRouterAdapterConfig } from "./openrouter.js";
+import type { ProviderAdapter } from "./types.js";
+
+/** Top-level factory config. Only providers with an API key are instantiated. */
+export interface EmbeddingsFactoryConfig {
+  /** OpenRouter API key. Omit or empty string to skip. */
+  openrouterApiKey?: string;
+  /** Per-adapter config overrides */
+  openrouter?: Omit<Partial<OpenRouterAdapterConfig>, "apiKey">;
+}
+
+/** Result of the factory — adapters + metadata for observability. */
+export interface EmbeddingsFactoryResult {
+  /** All instantiated adapters, ordered by cost priority (cheapest first). */
+  adapters: ProviderAdapter[];
+  /** Map of adapter name → ProviderAdapter for direct registration. */
+  adapterMap: Map<string, ProviderAdapter>;
+  /** Names of providers that were skipped (missing config). */
+  skipped: string[];
+}
+
+/**
+ * Create embeddings adapters from the provided config.
+ *
+ * Returns only adapters whose API key is present and non-empty.
+ * Order matches arbitrage priority: cheapest first.
+ */
+export function createEmbeddingsAdapters(config: EmbeddingsFactoryConfig): EmbeddingsFactoryResult {
+  const adapters: ProviderAdapter[] = [];
+  const skipped: string[] = [];
+
+  // OpenRouter — $0.02/1M tokens (text-embedding-3-small via OpenAI)
+  if (config.openrouterApiKey) {
+    adapters.push(createOpenRouterAdapter({ ...config.openrouter, apiKey: config.openrouterApiKey }));
+  } else {
+    skipped.push("openrouter");
+  }
+
+  // Future: self-hosted-embeddings will go BEFORE openrouter (GPU tier, cheapest)
+
+  const adapterMap = new Map<string, ProviderAdapter>();
+  for (const adapter of adapters) {
+    adapterMap.set(adapter.name, adapter);
+  }
+
+  return { adapters, adapterMap, skipped };
+}
+
+/**
+ * Create embeddings adapters from environment variables.
+ *
+ * Reads API keys from:
+ *   - OPENROUTER_API_KEY
+ *
+ * Accepts optional per-adapter overrides.
+ */
+export function createEmbeddingsAdaptersFromEnv(
+  overrides?: Omit<EmbeddingsFactoryConfig, "openrouterApiKey">,
+): EmbeddingsFactoryResult {
+  return createEmbeddingsAdapters({
+    openrouterApiKey: process.env.OPENROUTER_API_KEY,
+    ...overrides,
+  });
+}

package/src/monetization/adapters/rate-table.ts

@@ -96,9 +96,22 @@ export const RATE_TABLE: RateEntry[] = [
     effectivePrice: 0.00009321, // = costPerUnit * margin ($93.21 per 1M seconds ≈ $5.59 per 1M minutes)
   },
 
+  // Embeddings
+  // NOTE: No self-hosted embeddings adapter yet — only premium (openrouter) available.
+  // When self-hosted-embeddings lands, add a standard tier entry here.
+  {
+    capability: "embeddings",
+    tier: "premium",
+    provider: "openrouter",
+    costPerUnit: 0.00000002, // $0.02 per 1M tokens (text-embedding-3-small via OpenRouter)
+    billingUnit: "per-token",
+    margin: 1.3, // 30% — dashboard default; runtime uses getMargin()
+    effectivePrice: 0.000000026, // = costPerUnit * margin ($0.026 per 1M tokens)
+  },
+
   // Future self-hosted adapters will add more entries here:
   // - transcription: self-hosted-whisper (standard) — when GPU adapter exists
-  // - embeddings: self-hosted-embeddings (standard) vs openrouter (premium)
+  // - embeddings: self-hosted-embeddings (standard) — when GPU adapter exists
   // - image-generation: self-hosted-sdxl (standard) vs replicate (premium)
 ];
 

package/src/monetization/index.ts

@@ -34,6 +34,13 @@ export { type ChatterboxTTSAdapterConfig, createChatterboxTTSAdapter } from "./a
 export { createDeepgramAdapter, type DeepgramAdapterConfig } from "./adapters/deepgram.js";
 export { createDeepSeekAdapter, type DeepSeekAdapterConfig } from "./adapters/deepseek.js";
 export { createElevenLabsAdapter, type ElevenLabsAdapterConfig } from "./adapters/elevenlabs.js";
+// Embeddings adapter factory (WOP-2190)
+export {
+  createEmbeddingsAdapters,
+  createEmbeddingsAdaptersFromEnv,
+  type EmbeddingsFactoryConfig,
+  type EmbeddingsFactoryResult,
+} from "./adapters/embeddings-factory.js";
 export { createGeminiAdapter, type GeminiAdapterConfig } from "./adapters/gemini.js";
 export { createKimiAdapter, type KimiAdapterConfig } from "./adapters/kimi.js";
 // Margin config (WOP-364)