@adforge-adgeniq/providers 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,193 @@
+interface AvatarProvider {
+    generate(params: {
+        avatarId: string;
+        audioUrl?: string;
+        text?: string;
+        aspect: "9:16" | "16:9" | "1:1";
+    }): Promise<{
+        jobId: string;
+    }>;
+    getStatus(jobId: string): Promise<{
+        status: "running" | "succeeded" | "failed";
+        resultUrl?: string;
+        error?: string;
+    }>;
+}
+interface VoiceProvider {
+    synthesize(params: {
+        voiceId: string;
+        text: string;
+        language: string;
+    }): Promise<{
+        audioUrl: string;
+        durationMs: number;
+    }>;
+}
+interface CloneProvider {
+    createAvatar(params: {
+        videoUrl: string;
+        workspaceId: string;
+        name: string;
+    }): Promise<{
+        providerAvatarId: string;
+    }>;
+    createVoice(params: {
+        audioUrl: string;
+        workspaceId: string;
+        name: string;
+    }): Promise<{
+        providerVoiceId: string;
+    }>;
+}
+interface LLMProvider {
+    complete<T>(params: {
+        prompt: string;
+        schema?: unknown;
+        maxTokens?: number;
+    }): Promise<{
+        content: T;
+        tokensUsed: number;
+    }>;
+}
+declare class FalAvatarProvider implements AvatarProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    generate(params: {
+        avatarId: string;
+        audioUrl?: string;
+        text?: string;
+        aspect: "9:16" | "16:9" | "1:1";
+    }): Promise<{
+        jobId: string;
+    }>;
+    getStatus(jobId: string): Promise<{
+        status: "running" | "succeeded" | "failed";
+        resultUrl?: string;
+        error?: string;
+    }>;
+}
+declare class ElevenLabsVoiceProvider implements VoiceProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    synthesize(params: {
+        voiceId: string;
+        text: string;
+        language: string;
+    }): Promise<{
+        audioUrl: string;
+        durationMs: number;
+    }>;
+}
+declare class HeyGenAvatarProvider implements AvatarProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    generate(params: {
+        avatarId: string;
+        audioUrl?: string;
+        text?: string;
+        aspect: "9:16" | "16:9" | "1:1";
+    }): Promise<{
+        jobId: string;
+    }>;
+    getStatus(jobId: string): Promise<{
+        status: "running" | "succeeded" | "failed";
+        resultUrl?: string;
+        error?: string;
+    }>;
+}
+declare class HeyGenCloneProvider implements CloneProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    createAvatar(params: {
+        videoUrl: string;
+        workspaceId: string;
+        name: string;
+    }): Promise<{
+        providerAvatarId: string;
+    }>;
+    createVoice(params: {
+        audioUrl: string;
+        workspaceId: string;
+        name: string;
+    }): Promise<{
+        providerVoiceId: string;
+    }>;
+}
+declare class ElevenLabsCloneProvider implements CloneProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    createAvatar(): Promise<{
+        providerAvatarId: string;
+    }>;
+    createVoice(params: {
+        audioUrl: string;
+        workspaceId: string;
+        name: string;
+    }): Promise<{
+        providerVoiceId: string;
+    }>;
+}
+type AvatarProviderName = "fal" | "heygen" | "stub";
+type VoiceProviderName = "elevenlabs" | "stub";
+type CloneProviderName = "heygen" | "elevenlabs";
+interface ProviderKeys {
+    FAL_API_KEY?: string;
+    HEYGEN_API_KEY?: string;
+    ELEVENLABS_API_KEY?: string;
+}
+/** Get the configured avatar provider, falling back gracefully.
+ *  Pass `keys` to override environment variables (e.g. from DB-stored settings). */
+declare function getAvatarProvider(preferred?: AvatarProviderName, keys?: ProviderKeys): AvatarProvider;
+declare function getVoiceProvider(preferred?: VoiceProviderName, keys?: ProviderKeys): VoiceProvider;
+declare function getCloneProvider(preferred?: CloneProviderName, keys?: ProviderKeys): CloneProvider;
+declare class StubAvatarProvider implements AvatarProvider {
+    generate(): Promise<{
+        jobId: string;
+    }>;
+    getStatus(_jobId: string): Promise<{
+        status: "succeeded";
+        resultUrl: string;
+    }>;
+}
+declare class StubVoiceProvider implements VoiceProvider {
+    synthesize(_params: {
+        voiceId: string;
+        text: string;
+        language: string;
+    }): Promise<{
+        audioUrl: string;
+        durationMs: number;
+    }>;
+}
+interface ProviderHealth {
+    /** Which avatar provider will be selected at runtime */
+    avatarProvider: AvatarProviderName;
+    /** Which voice provider will be selected at runtime */
+    voiceProvider: VoiceProviderName;
+    /** True when at least one real (non-stub) avatar provider is available */
+    avatarReady: boolean;
+    /** True when at least one real (non-stub) voice provider is available */
+    voiceReady: boolean;
+    /** Presence status for each API key (value is never the actual key string) */
+    keys: {
+        FAL_API_KEY: boolean;
+        HEYGEN_API_KEY: boolean;
+        ELEVENLABS_API_KEY: boolean;
+    };
+}
+/**
+ * Returns which providers are configured based on environment variable presence
+ * (or an explicit `keys` override — pass resolved DB values from the async wrapper).
+ * Does NOT instantiate any provider — safe to call from server components or API routes.
+ */
+declare function getProviderHealth(keys?: ProviderKeys & {
+    ANTHROPIC_API_KEY?: string;
+}): ProviderHealth;
+declare function withRetry<T>(fn: () => Promise<T>, maxAttempts?: number, baseDelayMs?: number): Promise<T>;
+
+export { type AvatarProvider, type AvatarProviderName, type CloneProvider, type CloneProviderName, ElevenLabsCloneProvider, ElevenLabsVoiceProvider, FalAvatarProvider, HeyGenAvatarProvider, HeyGenCloneProvider, type LLMProvider, type ProviderHealth, type ProviderKeys, StubAvatarProvider, StubVoiceProvider, type VoiceProvider, type VoiceProviderName, getAvatarProvider, getCloneProvider, getProviderHealth, getVoiceProvider, withRetry };

package/dist/index.d.ts

@@ -0,0 +1,193 @@
+interface AvatarProvider {
+    generate(params: {
+        avatarId: string;
+        audioUrl?: string;
+        text?: string;
+        aspect: "9:16" | "16:9" | "1:1";
+    }): Promise<{
+        jobId: string;
+    }>;
+    getStatus(jobId: string): Promise<{
+        status: "running" | "succeeded" | "failed";
+        resultUrl?: string;
+        error?: string;
+    }>;
+}
+interface VoiceProvider {
+    synthesize(params: {
+        voiceId: string;
+        text: string;
+        language: string;
+    }): Promise<{
+        audioUrl: string;
+        durationMs: number;
+    }>;
+}
+interface CloneProvider {
+    createAvatar(params: {
+        videoUrl: string;
+        workspaceId: string;
+        name: string;
+    }): Promise<{
+        providerAvatarId: string;
+    }>;
+    createVoice(params: {
+        audioUrl: string;
+        workspaceId: string;
+        name: string;
+    }): Promise<{
+        providerVoiceId: string;
+    }>;
+}
+interface LLMProvider {
+    complete<T>(params: {
+        prompt: string;
+        schema?: unknown;
+        maxTokens?: number;
+    }): Promise<{
+        content: T;
+        tokensUsed: number;
+    }>;
+}
+declare class FalAvatarProvider implements AvatarProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    generate(params: {
+        avatarId: string;
+        audioUrl?: string;
+        text?: string;
+        aspect: "9:16" | "16:9" | "1:1";
+    }): Promise<{
+        jobId: string;
+    }>;
+    getStatus(jobId: string): Promise<{
+        status: "running" | "succeeded" | "failed";
+        resultUrl?: string;
+        error?: string;
+    }>;
+}
+declare class ElevenLabsVoiceProvider implements VoiceProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    synthesize(params: {
+        voiceId: string;
+        text: string;
+        language: string;
+    }): Promise<{
+        audioUrl: string;
+        durationMs: number;
+    }>;
+}
+declare class HeyGenAvatarProvider implements AvatarProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    generate(params: {
+        avatarId: string;
+        audioUrl?: string;
+        text?: string;
+        aspect: "9:16" | "16:9" | "1:1";
+    }): Promise<{
+        jobId: string;
+    }>;
+    getStatus(jobId: string): Promise<{
+        status: "running" | "succeeded" | "failed";
+        resultUrl?: string;
+        error?: string;
+    }>;
+}
+declare class HeyGenCloneProvider implements CloneProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    createAvatar(params: {
+        videoUrl: string;
+        workspaceId: string;
+        name: string;
+    }): Promise<{
+        providerAvatarId: string;
+    }>;
+    createVoice(params: {
+        audioUrl: string;
+        workspaceId: string;
+        name: string;
+    }): Promise<{
+        providerVoiceId: string;
+    }>;
+}
+declare class ElevenLabsCloneProvider implements CloneProvider {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey?: string);
+    createAvatar(): Promise<{
+        providerAvatarId: string;
+    }>;
+    createVoice(params: {
+        audioUrl: string;
+        workspaceId: string;
+        name: string;
+    }): Promise<{
+        providerVoiceId: string;
+    }>;
+}
+type AvatarProviderName = "fal" | "heygen" | "stub";
+type VoiceProviderName = "elevenlabs" | "stub";
+type CloneProviderName = "heygen" | "elevenlabs";
+interface ProviderKeys {
+    FAL_API_KEY?: string;
+    HEYGEN_API_KEY?: string;
+    ELEVENLABS_API_KEY?: string;
+}
+/** Get the configured avatar provider, falling back gracefully.
+ *  Pass `keys` to override environment variables (e.g. from DB-stored settings). */
+declare function getAvatarProvider(preferred?: AvatarProviderName, keys?: ProviderKeys): AvatarProvider;
+declare function getVoiceProvider(preferred?: VoiceProviderName, keys?: ProviderKeys): VoiceProvider;
+declare function getCloneProvider(preferred?: CloneProviderName, keys?: ProviderKeys): CloneProvider;
+declare class StubAvatarProvider implements AvatarProvider {
+    generate(): Promise<{
+        jobId: string;
+    }>;
+    getStatus(_jobId: string): Promise<{
+        status: "succeeded";
+        resultUrl: string;
+    }>;
+}
+declare class StubVoiceProvider implements VoiceProvider {
+    synthesize(_params: {
+        voiceId: string;
+        text: string;
+        language: string;
+    }): Promise<{
+        audioUrl: string;
+        durationMs: number;
+    }>;
+}
+interface ProviderHealth {
+    /** Which avatar provider will be selected at runtime */
+    avatarProvider: AvatarProviderName;
+    /** Which voice provider will be selected at runtime */
+    voiceProvider: VoiceProviderName;
+    /** True when at least one real (non-stub) avatar provider is available */
+    avatarReady: boolean;
+    /** True when at least one real (non-stub) voice provider is available */
+    voiceReady: boolean;
+    /** Presence status for each API key (value is never the actual key string) */
+    keys: {
+        FAL_API_KEY: boolean;
+        HEYGEN_API_KEY: boolean;
+        ELEVENLABS_API_KEY: boolean;
+    };
+}
+/**
+ * Returns which providers are configured based on environment variable presence
+ * (or an explicit `keys` override — pass resolved DB values from the async wrapper).
+ * Does NOT instantiate any provider — safe to call from server components or API routes.
+ */
+declare function getProviderHealth(keys?: ProviderKeys & {
+    ANTHROPIC_API_KEY?: string;
+}): ProviderHealth;
+declare function withRetry<T>(fn: () => Promise<T>, maxAttempts?: number, baseDelayMs?: number): Promise<T>;
+
+export { type AvatarProvider, type AvatarProviderName, type CloneProvider, type CloneProviderName, ElevenLabsCloneProvider, ElevenLabsVoiceProvider, FalAvatarProvider, HeyGenAvatarProvider, HeyGenCloneProvider, type LLMProvider, type ProviderHealth, type ProviderKeys, StubAvatarProvider, StubVoiceProvider, type VoiceProvider, type VoiceProviderName, getAvatarProvider, getCloneProvider, getProviderHealth, getVoiceProvider, withRetry };

package/dist/index.js

@@ -0,0 +1,304 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ElevenLabsCloneProvider: () => ElevenLabsCloneProvider,
+  ElevenLabsVoiceProvider: () => ElevenLabsVoiceProvider,
+  FalAvatarProvider: () => FalAvatarProvider,
+  HeyGenAvatarProvider: () => HeyGenAvatarProvider,
+  HeyGenCloneProvider: () => HeyGenCloneProvider,
+  StubAvatarProvider: () => StubAvatarProvider,
+  StubVoiceProvider: () => StubVoiceProvider,
+  getAvatarProvider: () => getAvatarProvider,
+  getCloneProvider: () => getCloneProvider,
+  getProviderHealth: () => getProviderHealth,
+  getVoiceProvider: () => getVoiceProvider,
+  withRetry: () => withRetry
+});
+module.exports = __toCommonJS(index_exports);
+var FalAvatarProvider = class {
+  apiKey;
+  baseUrl = "https://fal.run";
+  constructor(apiKey) {
+    const key = apiKey ?? process.env.FAL_API_KEY;
+    if (!key) throw new Error("FAL_API_KEY is not set");
+    this.apiKey = key;
+  }
+  async generate(params) {
+    const aspectMap = { "9:16": "portrait", "16:9": "landscape", "1:1": "square" };
+    const res = await fetch(`${this.baseUrl}/fal-ai/talking-head`, {
+      method: "POST",
+      headers: {
+        Authorization: `Key ${this.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        avatar_id: params.avatarId,
+        ...params.audioUrl ? { audio_url: params.audioUrl } : { text: params.text },
+        aspect_ratio: aspectMap[params.aspect]
+      }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!res.ok) throw new Error(`fal.ai generate failed: ${res.status} ${await res.text()}`);
+    const data = await res.json();
+    const jobId = data.request_id ?? data.id;
+    if (!jobId) throw new Error("fal.ai returned no job ID");
+    return { jobId };
+  }
+  async getStatus(jobId) {
+    const res = await fetch(`${this.baseUrl}/fal-ai/talking-head/requests/${jobId}/status`, {
+      headers: { Authorization: `Key ${this.apiKey}` },
+      signal: AbortSignal.timeout(15e3)
+    });
+    if (!res.ok) throw new Error(`fal.ai status check failed: ${res.status}`);
+    const data = await res.json();
+    if (data.status === "COMPLETED" || data.status === "succeeded") {
+      return { status: "succeeded", resultUrl: data.output?.video?.url };
+    }
+    if (data.status === "FAILED" || data.status === "failed") {
+      return { status: "failed", error: data.error ?? "Unknown fal.ai error" };
+    }
+    return { status: "running" };
+  }
+};
+var ElevenLabsVoiceProvider = class {
+  apiKey;
+  baseUrl = "https://api.elevenlabs.io/v1";
+  constructor(apiKey) {
+    const key = apiKey ?? process.env.ELEVENLABS_API_KEY;
+    if (!key) throw new Error("ELEVENLABS_API_KEY is not set");
+    this.apiKey = key;
+  }
+  async synthesize(params) {
+    const res = await fetch(`${this.baseUrl}/text-to-speech/${params.voiceId}`, {
+      method: "POST",
+      headers: {
+        "xi-api-key": this.apiKey,
+        "Content-Type": "application/json",
+        Accept: "audio/mpeg"
+      },
+      body: JSON.stringify({
+        text: params.text,
+        model_id: "eleven_multilingual_v2",
+        voice_settings: { stability: 0.5, similarity_boost: 0.75 }
+      }),
+      signal: AbortSignal.timeout(6e4)
+    });
+    if (!res.ok) throw new Error(`ElevenLabs TTS failed: ${res.status} ${await res.text()}`);
+    const buffer = Buffer.from(await res.arrayBuffer());
+    const durationMs = Math.round(buffer.byteLength / 16e3 * 1e3);
+    const audioUrl = `data:audio/mpeg;base64,${buffer.toString("base64")}`;
+    return { audioUrl, durationMs };
+  }
+};
+var HeyGenAvatarProvider = class {
+  apiKey;
+  baseUrl = "https://api.heygen.com";
+  constructor(apiKey) {
+    const key = apiKey ?? process.env.HEYGEN_API_KEY;
+    if (!key) throw new Error("HEYGEN_API_KEY is not set");
+    this.apiKey = key;
+  }
+  async generate(params) {
+    const dimensionMap = {
+      "9:16": { width: 1080, height: 1920 },
+      "16:9": { width: 1920, height: 1080 },
+      "1:1": { width: 1080, height: 1080 }
+    };
+    const dim = dimensionMap[params.aspect];
+    const res = await fetch(`${this.baseUrl}/v2/video/generate`, {
+      method: "POST",
+      headers: {
+        "X-Api-Key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        video_inputs: [{
+          character: { type: "avatar", avatar_id: params.avatarId, avatar_style: "normal" },
+          voice: params.audioUrl ? { type: "audio", audio_url: params.audioUrl } : { type: "text", input_text: params.text, voice_id: "en-US-SaraNeural" }
+        }],
+        dimension: dim
+      }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!res.ok) throw new Error(`HeyGen generate failed: ${res.status} ${await res.text()}`);
+    const data = await res.json();
+    if (data.error) throw new Error(`HeyGen error: ${data.error}`);
+    return { jobId: data.data.video_id };
+  }
+  async getStatus(jobId) {
+    const res = await fetch(`${this.baseUrl}/v1/video_status.get?video_id=${jobId}`, {
+      headers: { "X-Api-Key": this.apiKey },
+      signal: AbortSignal.timeout(15e3)
+    });
+    if (!res.ok) throw new Error(`HeyGen status failed: ${res.status}`);
+    const data = await res.json();
+    const s = data.data?.status;
+    if (s === "completed") return { status: "succeeded", resultUrl: data.data?.video_url };
+    if (s === "failed") return { status: "failed", error: data.data?.error };
+    return { status: "running" };
+  }
+};
+var HeyGenCloneProvider = class {
+  apiKey;
+  baseUrl = "https://api.heygen.com";
+  constructor(apiKey) {
+    const key = apiKey ?? process.env.HEYGEN_API_KEY;
+    if (!key) throw new Error("HEYGEN_API_KEY is not set");
+    this.apiKey = key;
+  }
+  async createAvatar(params) {
+    const res = await fetch(`${this.baseUrl}/v2/avatar/create`, {
+      method: "POST",
+      headers: { "X-Api-Key": this.apiKey, "Content-Type": "application/json" },
+      body: JSON.stringify({ name: params.name, video_url: params.videoUrl }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!res.ok) throw new Error(`HeyGen createAvatar failed: ${res.status} ${await res.text()}`);
+    const data = await res.json();
+    return { providerAvatarId: data.data.avatar_id };
+  }
+  async createVoice(params) {
+    const res = await fetch(`${this.baseUrl}/v2/voice/create`, {
+      method: "POST",
+      headers: { "X-Api-Key": this.apiKey, "Content-Type": "application/json" },
+      body: JSON.stringify({ name: params.name, audio_url: params.audioUrl }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!res.ok) throw new Error(`HeyGen createVoice failed: ${res.status} ${await res.text()}`);
+    const data = await res.json();
+    return { providerVoiceId: data.data.voice_id };
+  }
+};
+var ElevenLabsCloneProvider = class {
+  apiKey;
+  baseUrl = "https://api.elevenlabs.io/v1";
+  constructor(apiKey) {
+    const key = apiKey ?? process.env.ELEVENLABS_API_KEY;
+    if (!key) throw new Error("ELEVENLABS_API_KEY is not set");
+    this.apiKey = key;
+  }
+  async createAvatar() {
+    throw new Error("ElevenLabs does not support avatar cloning. Use HeyGen.");
+  }
+  async createVoice(params) {
+    const audioRes = await fetch(params.audioUrl, { signal: AbortSignal.timeout(6e4) });
+    if (!audioRes.ok) {
+      throw new Error(`Failed to download audio for voice cloning: ${audioRes.status}`);
+    }
+    const audioBuffer = await audioRes.arrayBuffer();
+    const contentType = audioRes.headers.get("content-type") ?? "audio/mpeg";
+    const audioBlob = new Blob([audioBuffer], { type: contentType });
+    const form = new FormData();
+    form.append("name", params.name);
+    form.append("files", audioBlob, "voice-sample.mp3");
+    form.append("description", `Cloned voice for workspace ${params.workspaceId}`);
+    const res = await fetch(`${this.baseUrl}/voices/add`, {
+      method: "POST",
+      headers: { "xi-api-key": this.apiKey },
+      body: form,
+      signal: AbortSignal.timeout(12e4)
+    });
+    if (!res.ok) throw new Error(`ElevenLabs createVoice failed: ${res.status} ${await res.text()}`);
+    const data = await res.json();
+    return { providerVoiceId: data.voice_id };
+  }
+};
+function getAvatarProvider(preferred = "fal", keys) {
+  const fal = keys?.FAL_API_KEY ?? process.env.FAL_API_KEY;
+  const heygen = keys?.HEYGEN_API_KEY ?? process.env.HEYGEN_API_KEY;
+  if (preferred === "fal" && fal) return new FalAvatarProvider(fal);
+  if (heygen) return new HeyGenAvatarProvider(heygen);
+  return new StubAvatarProvider();
+}
+function getVoiceProvider(preferred = "elevenlabs", keys) {
+  const el = keys?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY;
+  if (preferred === "elevenlabs" && el) return new ElevenLabsVoiceProvider(el);
+  return new StubVoiceProvider();
+}
+function getCloneProvider(preferred = "heygen", keys) {
+  const heygen = keys?.HEYGEN_API_KEY ?? process.env.HEYGEN_API_KEY;
+  const el = keys?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY;
+  if (preferred === "heygen" && heygen) return new HeyGenCloneProvider(heygen);
+  if (el) return new ElevenLabsCloneProvider(el);
+  throw new Error("No clone provider configured. Set HEYGEN_API_KEY or ELEVENLABS_API_KEY.");
+}
+var StubAvatarProvider = class {
+  async generate() {
+    return { jobId: `stub-avatar-${Date.now()}` };
+  }
+  async getStatus(_jobId) {
+    return { status: "succeeded", resultUrl: "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4" };
+  }
+};
+var StubVoiceProvider = class {
+  async synthesize(_params) {
+    return { audioUrl: "https://www.soundjay.com/misc/sounds/bell-ringing-05.mp3", durationMs: 15e3 };
+  }
+};
+function getProviderHealth(keys) {
+  const hasFal = Boolean(keys?.FAL_API_KEY ?? process.env.FAL_API_KEY);
+  const hasHeygen = Boolean(keys?.HEYGEN_API_KEY ?? process.env.HEYGEN_API_KEY);
+  const hasElevenLabs = Boolean(keys?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY);
+  const avatarProvider = hasFal ? "fal" : hasHeygen ? "heygen" : "stub";
+  const voiceProvider = hasElevenLabs ? "elevenlabs" : "stub";
+  return {
+    avatarProvider,
+    voiceProvider,
+    avatarReady: avatarProvider !== "stub",
+    voiceReady: voiceProvider !== "stub",
+    keys: {
+      FAL_API_KEY: hasFal,
+      HEYGEN_API_KEY: hasHeygen,
+      ELEVENLABS_API_KEY: hasElevenLabs
+    }
+  };
+}
+async function withRetry(fn, maxAttempts = 3, baseDelayMs = 1e3) {
+  let lastError = new Error("Unknown error");
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err instanceof Error ? err : new Error(String(err));
+      if (attempt < maxAttempts) {
+        const delay = baseDelayMs * Math.pow(2, attempt - 1);
+        await new Promise((r) => setTimeout(r, delay));
+      }
+    }
+  }
+  throw lastError;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ElevenLabsCloneProvider,
+  ElevenLabsVoiceProvider,
+  FalAvatarProvider,
+  HeyGenAvatarProvider,
+  HeyGenCloneProvider,
+  StubAvatarProvider,
+  StubVoiceProvider,
+  getAvatarProvider,
+  getCloneProvider,
+  getProviderHealth,
+  getVoiceProvider,
+  withRetry
+});

package/dist/index.mjs

@@ -0,0 +1,268 @@
+// src/index.ts
+var FalAvatarProvider = class {
+  apiKey;
+  baseUrl = "https://fal.run";
+  constructor(apiKey) {
+    const key = apiKey ?? process.env.FAL_API_KEY;
+    if (!key) throw new Error("FAL_API_KEY is not set");
+    this.apiKey = key;
+  }
+  async generate(params) {
+    const aspectMap = { "9:16": "portrait", "16:9": "landscape", "1:1": "square" };
+    const res = await fetch(`${this.baseUrl}/fal-ai/talking-head`, {
+      method: "POST",
+      headers: {
+        Authorization: `Key ${this.apiKey}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        avatar_id: params.avatarId,
+        ...params.audioUrl ? { audio_url: params.audioUrl } : { text: params.text },
+        aspect_ratio: aspectMap[params.aspect]
+      }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!res.ok) throw new Error(`fal.ai generate failed: ${res.status} ${await res.text()}`);
+    const data = await res.json();
+    const jobId = data.request_id ?? data.id;
+    if (!jobId) throw new Error("fal.ai returned no job ID");
+    return { jobId };
+  }
+  async getStatus(jobId) {
+    const res = await fetch(`${this.baseUrl}/fal-ai/talking-head/requests/${jobId}/status`, {
+      headers: { Authorization: `Key ${this.apiKey}` },
+      signal: AbortSignal.timeout(15e3)
+    });
+    if (!res.ok) throw new Error(`fal.ai status check failed: ${res.status}`);
+    const data = await res.json();
+    if (data.status === "COMPLETED" || data.status === "succeeded") {
+      return { status: "succeeded", resultUrl: data.output?.video?.url };
+    }
+    if (data.status === "FAILED" || data.status === "failed") {
+      return { status: "failed", error: data.error ?? "Unknown fal.ai error" };
+    }
+    return { status: "running" };
+  }
+};
+var ElevenLabsVoiceProvider = class {
+  apiKey;
+  baseUrl = "https://api.elevenlabs.io/v1";
+  constructor(apiKey) {
+    const key = apiKey ?? process.env.ELEVENLABS_API_KEY;
+    if (!key) throw new Error("ELEVENLABS_API_KEY is not set");
+    this.apiKey = key;
+  }
+  async synthesize(params) {
+    const res = await fetch(`${this.baseUrl}/text-to-speech/${params.voiceId}`, {
+      method: "POST",
+      headers: {
+        "xi-api-key": this.apiKey,
+        "Content-Type": "application/json",
+        Accept: "audio/mpeg"
+      },
+      body: JSON.stringify({
+        text: params.text,
+        model_id: "eleven_multilingual_v2",
+        voice_settings: { stability: 0.5, similarity_boost: 0.75 }
+      }),
+      signal: AbortSignal.timeout(6e4)
+    });
+    if (!res.ok) throw new Error(`ElevenLabs TTS failed: ${res.status} ${await res.text()}`);
+    const buffer = Buffer.from(await res.arrayBuffer());
+    const durationMs = Math.round(buffer.byteLength / 16e3 * 1e3);
+    const audioUrl = `data:audio/mpeg;base64,${buffer.toString("base64")}`;
+    return { audioUrl, durationMs };
+  }
+};
+var HeyGenAvatarProvider = class {
+  apiKey;
+  baseUrl = "https://api.heygen.com";
+  constructor(apiKey) {
+    const key = apiKey ?? process.env.HEYGEN_API_KEY;
+    if (!key) throw new Error("HEYGEN_API_KEY is not set");
+    this.apiKey = key;
+  }
+  async generate(params) {
+    const dimensionMap = {
+      "9:16": { width: 1080, height: 1920 },
+      "16:9": { width: 1920, height: 1080 },
+      "1:1": { width: 1080, height: 1080 }
+    };
+    const dim = dimensionMap[params.aspect];
+    const res = await fetch(`${this.baseUrl}/v2/video/generate`, {
+      method: "POST",
+      headers: {
+        "X-Api-Key": this.apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({
+        video_inputs: [{
+          character: { type: "avatar", avatar_id: params.avatarId, avatar_style: "normal" },
+          voice: params.audioUrl ? { type: "audio", audio_url: params.audioUrl } : { type: "text", input_text: params.text, voice_id: "en-US-SaraNeural" }
+        }],
+        dimension: dim
+      }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!res.ok) throw new Error(`HeyGen generate failed: ${res.status} ${await res.text()}`);
+    const data = await res.json();
+    if (data.error) throw new Error(`HeyGen error: ${data.error}`);
+    return { jobId: data.data.video_id };
+  }
+  async getStatus(jobId) {
+    const res = await fetch(`${this.baseUrl}/v1/video_status.get?video_id=${jobId}`, {
+      headers: { "X-Api-Key": this.apiKey },
+      signal: AbortSignal.timeout(15e3)
+    });
+    if (!res.ok) throw new Error(`HeyGen status failed: ${res.status}`);
+    const data = await res.json();
+    const s = data.data?.status;
+    if (s === "completed") return { status: "succeeded", resultUrl: data.data?.video_url };
+    if (s === "failed") return { status: "failed", error: data.data?.error };
+    return { status: "running" };
+  }
+};
+var HeyGenCloneProvider = class {
+  apiKey;
+  baseUrl = "https://api.heygen.com";
+  constructor(apiKey) {
+    const key = apiKey ?? process.env.HEYGEN_API_KEY;
+    if (!key) throw new Error("HEYGEN_API_KEY is not set");
+    this.apiKey = key;
+  }
+  async createAvatar(params) {
+    const res = await fetch(`${this.baseUrl}/v2/avatar/create`, {
+      method: "POST",
+      headers: { "X-Api-Key": this.apiKey, "Content-Type": "application/json" },
+      body: JSON.stringify({ name: params.name, video_url: params.videoUrl }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!res.ok) throw new Error(`HeyGen createAvatar failed: ${res.status} ${await res.text()}`);
+    const data = await res.json();
+    return { providerAvatarId: data.data.avatar_id };
+  }
+  async createVoice(params) {
+    const res = await fetch(`${this.baseUrl}/v2/voice/create`, {
+      method: "POST",
+      headers: { "X-Api-Key": this.apiKey, "Content-Type": "application/json" },
+      body: JSON.stringify({ name: params.name, audio_url: params.audioUrl }),
+      signal: AbortSignal.timeout(3e4)
+    });
+    if (!res.ok) throw new Error(`HeyGen createVoice failed: ${res.status} ${await res.text()}`);
+    const data = await res.json();
+    return { providerVoiceId: data.data.voice_id };
+  }
+};
+var ElevenLabsCloneProvider = class {
+  apiKey;
+  baseUrl = "https://api.elevenlabs.io/v1";
+  constructor(apiKey) {
+    const key = apiKey ?? process.env.ELEVENLABS_API_KEY;
+    if (!key) throw new Error("ELEVENLABS_API_KEY is not set");
+    this.apiKey = key;
+  }
+  async createAvatar() {
+    throw new Error("ElevenLabs does not support avatar cloning. Use HeyGen.");
+  }
+  async createVoice(params) {
+    const audioRes = await fetch(params.audioUrl, { signal: AbortSignal.timeout(6e4) });
+    if (!audioRes.ok) {
+      throw new Error(`Failed to download audio for voice cloning: ${audioRes.status}`);
+    }
+    const audioBuffer = await audioRes.arrayBuffer();
+    const contentType = audioRes.headers.get("content-type") ?? "audio/mpeg";
+    const audioBlob = new Blob([audioBuffer], { type: contentType });
+    const form = new FormData();
+    form.append("name", params.name);
+    form.append("files", audioBlob, "voice-sample.mp3");
+    form.append("description", `Cloned voice for workspace ${params.workspaceId}`);
+    const res = await fetch(`${this.baseUrl}/voices/add`, {
+      method: "POST",
+      headers: { "xi-api-key": this.apiKey },
+      body: form,
+      signal: AbortSignal.timeout(12e4)
+    });
+    if (!res.ok) throw new Error(`ElevenLabs createVoice failed: ${res.status} ${await res.text()}`);
+    const data = await res.json();
+    return { providerVoiceId: data.voice_id };
+  }
+};
+function getAvatarProvider(preferred = "fal", keys) {
+  const fal = keys?.FAL_API_KEY ?? process.env.FAL_API_KEY;
+  const heygen = keys?.HEYGEN_API_KEY ?? process.env.HEYGEN_API_KEY;
+  if (preferred === "fal" && fal) return new FalAvatarProvider(fal);
+  if (heygen) return new HeyGenAvatarProvider(heygen);
+  return new StubAvatarProvider();
+}
+function getVoiceProvider(preferred = "elevenlabs", keys) {
+  const el = keys?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY;
+  if (preferred === "elevenlabs" && el) return new ElevenLabsVoiceProvider(el);
+  return new StubVoiceProvider();
+}
+function getCloneProvider(preferred = "heygen", keys) {
+  const heygen = keys?.HEYGEN_API_KEY ?? process.env.HEYGEN_API_KEY;
+  const el = keys?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY;
+  if (preferred === "heygen" && heygen) return new HeyGenCloneProvider(heygen);
+  if (el) return new ElevenLabsCloneProvider(el);
+  throw new Error("No clone provider configured. Set HEYGEN_API_KEY or ELEVENLABS_API_KEY.");
+}
+var StubAvatarProvider = class {
+  async generate() {
+    return { jobId: `stub-avatar-${Date.now()}` };
+  }
+  async getStatus(_jobId) {
+    return { status: "succeeded", resultUrl: "https://storage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4" };
+  }
+};
+var StubVoiceProvider = class {
+  async synthesize(_params) {
+    return { audioUrl: "https://www.soundjay.com/misc/sounds/bell-ringing-05.mp3", durationMs: 15e3 };
+  }
+};
+function getProviderHealth(keys) {
+  const hasFal = Boolean(keys?.FAL_API_KEY ?? process.env.FAL_API_KEY);
+  const hasHeygen = Boolean(keys?.HEYGEN_API_KEY ?? process.env.HEYGEN_API_KEY);
+  const hasElevenLabs = Boolean(keys?.ELEVENLABS_API_KEY ?? process.env.ELEVENLABS_API_KEY);
+  const avatarProvider = hasFal ? "fal" : hasHeygen ? "heygen" : "stub";
+  const voiceProvider = hasElevenLabs ? "elevenlabs" : "stub";
+  return {
+    avatarProvider,
+    voiceProvider,
+    avatarReady: avatarProvider !== "stub",
+    voiceReady: voiceProvider !== "stub",
+    keys: {
+      FAL_API_KEY: hasFal,
+      HEYGEN_API_KEY: hasHeygen,
+      ELEVENLABS_API_KEY: hasElevenLabs
+    }
+  };
+}
+async function withRetry(fn, maxAttempts = 3, baseDelayMs = 1e3) {
+  let lastError = new Error("Unknown error");
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (err) {
+      lastError = err instanceof Error ? err : new Error(String(err));
+      if (attempt < maxAttempts) {
+        const delay = baseDelayMs * Math.pow(2, attempt - 1);
+        await new Promise((r) => setTimeout(r, delay));
+      }
+    }
+  }
+  throw lastError;
+}
+export {
+  ElevenLabsCloneProvider,
+  ElevenLabsVoiceProvider,
+  FalAvatarProvider,
+  HeyGenAvatarProvider,
+  HeyGenCloneProvider,
+  StubAvatarProvider,
+  StubVoiceProvider,
+  getAvatarProvider,
+  getCloneProvider,
+  getProviderHealth,
+  getVoiceProvider,
+  withRetry
+};

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@adforge-adgeniq/providers",
+  "version": "0.1.0",
+  "description": "Provider adapters for avatar (fal.ai, HeyGen), voice (ElevenLabs), and clone operations",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.10"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run"
+  }
+}