@contractspec/integration.providers-impls 1.56.1 → 1.58.0

package/README.md

@@ -2,19 +2,133 @@
 
 Website: https://contractspec.io/
 
-
 SDK-backed implementations of ContractSpec integration provider interfaces.
 
 Depends on:
+
 - `@contractspec/lib.contracts` for provider interface types and IntegrationSpec declarations
 - `@contractspec/integration.runtime` for secret/guard helpers (when needed)
 
+## PostHog analytics
+
+This package ships a PostHog analytics provider:
+
+- `analytics.posthog` via `PosthogAnalyticsProvider`
+
+Connection config example:
+
+```json
+{
+  "host": "https://app.posthog.com",
+  "projectId": "12345",
+  "mcpUrl": "https://your-mcp-endpoint"
+}
+```
+
+Secret payload example (`secretRef` target value):
+
+```json
+{
+  "personalApiKey": "phx_personal_api_key",
+  "projectApiKey": "phc_project_api_key"
+}
+```
+
+Factory usage:
+
+```ts
+import { IntegrationProviderFactory } from "@contractspec/integration.providers-impls/impls/provider-factory";
+
+const factory = new IntegrationProviderFactory();
+const analytics = await factory.createAnalyticsProvider(context); // key: analytics.posthog
+```
+
+## Supabase integrations
+
+This package now ships two Supabase providers:
+
+- `vectordb.supabase` via `SupabaseVectorProvider`
+- `database.supabase` via `SupabasePostgresProvider`
+
+Both providers are available through `IntegrationProviderFactory` and can also be instantiated directly.
+
+### 1) Connection shapes
+
+#### Vector store (`vectordb.supabase`)
+
+`IntegrationConnection.config` example:
+
+```json
+{
+  "schema": "public",
+  "table": "contractspec_vectors",
+  "createTableIfMissing": true,
+  "distanceMetric": "cosine",
+  "maxConnections": 5,
+  "sslMode": "require"
+}
+```
+
+Secret payload example (`secretRef` target value):
+
+```json
+{
+  "databaseUrl": "postgresql://postgres.<project-ref>:<password>@aws-0-<region>.pooler.supabase.com:6543/postgres"
+}
+```
+
+#### Database (`database.supabase`)
+
+`IntegrationConnection.config` example:
+
+```json
+{
+  "maxConnections": 10,
+  "sslMode": "require"
+}
+```
+
+Secret payload example (`secretRef` target value):
+
+```json
+{
+  "databaseUrl": "postgresql://postgres.<project-ref>:<password>@aws-0-<region>.pooler.supabase.com:6543/postgres"
+}
+```
+
+### 2) Factory usage
 
+```ts
+import { IntegrationProviderFactory } from "@contractspec/integration.providers-impls/impls/provider-factory";
 
+const factory = new IntegrationProviderFactory();
 
+const vectorProvider = await factory.createVectorStoreProvider(vectorContext); // key: vectordb.supabase
+const dbProvider = await factory.createDatabaseProvider(databaseContext); // key: database.supabase
+```
 
+### 3) Direct provider usage
 
+```ts
+import { SupabaseVectorProvider } from "@contractspec/integration.providers-impls/impls/supabase-vector";
+import { SupabasePostgresProvider } from "@contractspec/integration.providers-impls/impls/supabase-psql";
 
+const vector = new SupabaseVectorProvider({
+  connectionString: process.env.SUPABASE_DATABASE_URL,
+  schema: "public",
+  table: "contractspec_vectors",
+  distanceMetric: "cosine",
+});
 
+const database = new SupabasePostgresProvider({
+  connectionString: process.env.SUPABASE_DATABASE_URL,
+  maxConnections: 10,
+  sslMode: "require",
+});
+```
 
+### 4) Notes
 
+- `SupabaseVectorProvider` creates `vector` extension/table/indexes automatically when `createTableIfMissing=true`.
+- `SupabaseVectorProvider` maps scores from pgvector distances (`cosine`, `l2`, `inner_product`) to `VectorSearchResult.score`.
+- `SupabasePostgresProvider` supports `$1`, `$2`, ... placeholders, transactions, and clean connection shutdown through `close()`.

package/dist/analytics.d.ts

@@ -0,0 +1,2 @@
+export * from '@contractspec/lib.contracts/integrations/providers/analytics';
+//# sourceMappingURL=analytics.d.ts.map

package/dist/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,cAAc,8DAA8D,CAAC"}

package/dist/analytics.js

@@ -0,0 +1,3 @@
+// @bun
+// src/analytics.ts
+export * from "@contractspec/lib.contracts/integrations/providers/analytics";

package/dist/calendar.d.ts

@@ -1,8 +1,2 @@
-export * from "@contractspec/lib.contracts/integrations/providers/calendar";
-
-//#region src/calendar.d.ts
-
-import * as import__contractspec_lib_contracts_integrations_providers_calendar from "@contractspec/lib.contracts/integrations/providers/calendar";
-//#endregion
-export { import__contractspec_lib_contracts_integrations_providers_calendar as calendar_d_exports };
+export * from '@contractspec/lib.contracts/integrations/providers/calendar';
 //# sourceMappingURL=calendar.d.ts.map

package/dist/calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendar.d.ts","names":[],"sources":["../src/calendar.ts"],"sourcesContent":[],"mappings":""}
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../src/calendar.ts"],"names":[],"mappings":"AAAA,cAAc,6DAA6D,CAAC"}

package/dist/calendar.js

@@ -1,3 +1,3 @@
-import { __reExport } from "./_virtual/rolldown_runtime.js";
-
-export * from "@contractspec/lib.contracts/integrations/providers/calendar"
+// @bun
+// src/calendar.ts
+export * from "@contractspec/lib.contracts/integrations/providers/calendar";

package/dist/database.d.ts

@@ -0,0 +1,2 @@
+export * from '@contractspec/lib.contracts/integrations/providers/database';
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,cAAc,6DAA6D,CAAC"}

package/dist/database.js

@@ -0,0 +1,3 @@
+// @bun
+// src/database.ts
+export * from "@contractspec/lib.contracts/integrations/providers/database";

package/dist/email.d.ts

@@ -1,8 +1,2 @@
-export * from "@contractspec/lib.contracts/integrations/providers/email";
-
-//#region src/email.d.ts
-
-import * as import__contractspec_lib_contracts_integrations_providers_email from "@contractspec/lib.contracts/integrations/providers/email";
-//#endregion
-export { import__contractspec_lib_contracts_integrations_providers_email as email_d_exports };
+export * from '@contractspec/lib.contracts/integrations/providers/email';
 //# sourceMappingURL=email.d.ts.map

package/dist/email.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.d.ts","names":[],"sources":["../src/email.ts"],"sourcesContent":[],"mappings":""}
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../src/email.ts"],"names":[],"mappings":"AAAA,cAAc,0DAA0D,CAAC"}

package/dist/email.js

@@ -1,3 +1,3 @@
-import { __reExport } from "./_virtual/rolldown_runtime.js";
-
-export * from "@contractspec/lib.contracts/integrations/providers/email"
+// @bun
+// src/email.ts
+export * from "@contractspec/lib.contracts/integrations/providers/email";

package/dist/embedding.d.ts

@@ -1,8 +1,2 @@
-export * from "@contractspec/lib.contracts/integrations/providers/embedding";
-
-//#region src/embedding.d.ts
-
-import * as import__contractspec_lib_contracts_integrations_providers_embedding from "@contractspec/lib.contracts/integrations/providers/embedding";
-//#endregion
-export { import__contractspec_lib_contracts_integrations_providers_embedding as embedding_d_exports };
+export * from '@contractspec/lib.contracts/integrations/providers/embedding';
 //# sourceMappingURL=embedding.d.ts.map

package/dist/embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding.d.ts","names":[],"sources":["../src/embedding.ts"],"sourcesContent":[],"mappings":""}
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../src/embedding.ts"],"names":[],"mappings":"AAAA,cAAc,8DAA8D,CAAC"}

package/dist/embedding.js

@@ -1,3 +1,3 @@
-import { __reExport } from "./_virtual/rolldown_runtime.js";
-
-export * from "@contractspec/lib.contracts/integrations/providers/embedding"
+// @bun
+// src/embedding.ts
+export * from "@contractspec/lib.contracts/integrations/providers/embedding";

package/dist/impls/elevenlabs-voice.d.ts

@@ -1,21 +1,17 @@
-import { voice_d_exports } from "../voice.js";
-import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
-
-//#region src/impls/elevenlabs-voice.d.ts
-interface ElevenLabsVoiceProviderOptions {
-  apiKey: string;
-  defaultVoiceId?: string;
-  modelId?: string;
-  client?: ElevenLabsClient;
+import { ElevenLabsClient } from '@elevenlabs/elevenlabs-js';
+import type { Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult } from '../voice';
+export interface ElevenLabsVoiceProviderOptions {
+    apiKey: string;
+    defaultVoiceId?: string;
+    modelId?: string;
+    client?: ElevenLabsClient;
 }
-declare class ElevenLabsVoiceProvider implements voice_d_exports.VoiceProvider {
-  private readonly client;
-  private readonly defaultVoiceId?;
-  private readonly modelId?;
-  constructor(options: ElevenLabsVoiceProviderOptions);
-  listVoices(): Promise<voice_d_exports.Voice[]>;
-  synthesize(input: voice_d_exports.VoiceSynthesisInput): Promise<voice_d_exports.VoiceSynthesisResult>;
+export declare class ElevenLabsVoiceProvider implements VoiceProvider {
+    private readonly client;
+    private readonly defaultVoiceId?;
+    private readonly modelId?;
+    constructor(options: ElevenLabsVoiceProviderOptions);
+    listVoices(): Promise<Voice[]>;
+    synthesize(input: VoiceSynthesisInput): Promise<VoiceSynthesisResult>;
 }
-//#endregion
-export { ElevenLabsVoiceProvider, ElevenLabsVoiceProviderOptions };
 //# sourceMappingURL=elevenlabs-voice.d.ts.map

package/dist/impls/elevenlabs-voice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elevenlabs-voice.d.ts","names":[],"sources":["../../src/impls/elevenlabs-voice.ts"],"sourcesContent":[],"mappings":";;;;UAUiB,8BAAA;;EAAA,cAAA,CAAA,EAAA,MAAA;EAiCJ,OAAA,CAAA,EAAA,MAAA;EAKU,MAAA,CAAA,EAlCZ,gBAkCY;;AAUD,cAfT,uBAAA,YAAmC,eAAA,CAAA,aAe1B,CAAA;EAkBI,iBAAA,MAAA;EAA8B,iBAAA,cAAA;EAAR,iBAAA,OAAA;EAjCA,WAAA,CAAA,OAAA,EAKzB,8BALyB;EAAa,UAAA,CAAA,CAAA,EAevC,OAfuC,CAe/B,eAAA,CAAA,KAf+B,EAAA,CAAA;oBAiCnC,eAAA,CAAA,sBAAsB,QAAQ,eAAA,CAAA"}
+{"version":3,"file":"elevenlabs-voice.d.ts","sourceRoot":"","sources":["../../src/impls/elevenlabs-voice.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAC;CAC3B;AA4BD,qBAAa,uBAAwB,YAAW,aAAa;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAS;gBAEtB,OAAO,EAAE,8BAA8B;IAU7C,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAkB9B,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA4C5E"}

package/dist/impls/elevenlabs-voice.js

@@ -1,93 +1,103 @@
+// @bun
+// src/impls/elevenlabs-voice.ts
 import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
-
-//#region src/impls/elevenlabs-voice.ts
-const FORMAT_MAP = {
-	mp3: "mp3_44100_128",
-	wav: "pcm_44100",
-	ogg: "mp3_44100_128",
-	pcm: "pcm_16000"
-};
-const SAMPLE_RATE = {
-	mp3_22050_32: 22050,
-	mp3_44100_32: 44100,
-	mp3_44100_64: 44100,
-	mp3_44100_96: 44100,
-	mp3_44100_128: 44100,
-	mp3_44100_192: 44100,
-	pcm_16000: 16e3,
-	pcm_22050: 22050,
-	pcm_24000: 24e3,
-	pcm_44100: 44100,
-	ulaw_8000: 8e3
+var FORMAT_MAP = {
+  mp3: "mp3_44100_128",
+  wav: "pcm_44100",
+  ogg: "mp3_44100_128",
+  pcm: "pcm_16000"
 };
-var ElevenLabsVoiceProvider = class {
-	client;
-	defaultVoiceId;
-	modelId;
-	constructor(options) {
-		this.client = options.client ?? new ElevenLabsClient({ apiKey: options.apiKey });
-		this.defaultVoiceId = options.defaultVoiceId;
-		this.modelId = options.modelId;
-	}
-	async listVoices() {
-		return ((await this.client.voices.getAll()).voices ?? []).map((voice) => ({
-			id: voice.voiceId ?? "",
-			name: voice.name ?? "",
-			description: voice.description ?? void 0,
-			language: voice.labels?.language ?? void 0,
-			metadata: {
-				category: voice.category ?? "",
-				...voice.previewUrl ? { previewUrl: voice.previewUrl } : {},
-				...(() => {
-					const { language, ...rest } = voice.labels ?? {};
-					return rest;
-				})()
-			}
-		}));
-	}
-	async synthesize(input) {
-		const voiceId = input.voiceId ?? this.defaultVoiceId;
-		if (!voiceId) throw new Error("Voice ID is required for ElevenLabs synthesis.");
-		const formatKey = input.format ?? "mp3";
-		const outputFormat = FORMAT_MAP[formatKey] ?? FORMAT_MAP.mp3;
-		const sampleRate = input.sampleRateHz ?? SAMPLE_RATE[outputFormat] ?? SAMPLE_RATE.mp3_44100_128 ?? 44100;
-		const voiceSettings = input.stability != null || input.similarityBoost != null || input.style != null ? {
-			...input.stability != null ? { stability: input.stability } : {},
-			...input.similarityBoost != null ? { similarityBoost: input.similarityBoost } : {},
-			...input.style != null ? { style: input.style } : {}
-		} : void 0;
-		return {
-			audio: await readWebStream(await this.client.textToSpeech.convert(voiceId, {
-				text: input.text,
-				modelId: this.modelId,
-				outputFormat,
-				voiceSettings
-			})),
-			format: formatKey,
-			sampleRateHz: sampleRate,
-			durationSeconds: void 0,
-			url: void 0
-		};
-	}
+var SAMPLE_RATE = {
+  mp3_22050_32: 22050,
+  mp3_44100_32: 44100,
+  mp3_44100_64: 44100,
+  mp3_44100_96: 44100,
+  mp3_44100_128: 44100,
+  mp3_44100_192: 44100,
+  pcm_16000: 16000,
+  pcm_22050: 22050,
+  pcm_24000: 24000,
+  pcm_44100: 44100,
+  ulaw_8000: 8000
 };
+
+class ElevenLabsVoiceProvider {
+  client;
+  defaultVoiceId;
+  modelId;
+  constructor(options) {
+    this.client = options.client ?? new ElevenLabsClient({
+      apiKey: options.apiKey
+    });
+    this.defaultVoiceId = options.defaultVoiceId;
+    this.modelId = options.modelId;
+  }
+  async listVoices() {
+    const response = await this.client.voices.getAll();
+    return (response.voices ?? []).map((voice) => ({
+      id: voice.voiceId ?? "",
+      name: voice.name ?? "",
+      description: voice.description ?? undefined,
+      language: voice.labels?.language ?? undefined,
+      metadata: {
+        category: voice.category ?? "",
+        ...voice.previewUrl ? { previewUrl: voice.previewUrl } : {},
+        ...(() => {
+          const { language, ...rest } = voice.labels ?? {};
+          return rest;
+        })()
+      }
+    }));
+  }
+  async synthesize(input) {
+    const voiceId = input.voiceId ?? this.defaultVoiceId;
+    if (!voiceId) {
+      throw new Error("Voice ID is required for ElevenLabs synthesis.");
+    }
+    const formatKey = input.format ?? "mp3";
+    const outputFormat = FORMAT_MAP[formatKey] ?? FORMAT_MAP.mp3;
+    const sampleRate = input.sampleRateHz ?? SAMPLE_RATE[outputFormat] ?? SAMPLE_RATE.mp3_44100_128 ?? 44100;
+    const voiceSettings = input.stability != null || input.similarityBoost != null || input.style != null ? {
+      ...input.stability != null ? { stability: input.stability } : {},
+      ...input.similarityBoost != null ? { similarityBoost: input.similarityBoost } : {},
+      ...input.style != null ? { style: input.style } : {}
+    } : undefined;
+    const stream = await this.client.textToSpeech.convert(voiceId, {
+      text: input.text,
+      modelId: this.modelId,
+      outputFormat,
+      voiceSettings
+    });
+    const audio = await readWebStream(stream);
+    return {
+      audio,
+      format: formatKey,
+      sampleRateHz: sampleRate,
+      durationSeconds: undefined,
+      url: undefined
+    };
+  }
+}
 async function readWebStream(stream) {
-	const reader = stream.getReader();
-	const chunks = [];
-	while (true) {
-		const { done, value } = await reader.read();
-		if (done) break;
-		if (value) chunks.push(value);
-	}
-	const length = chunks.reduce((total, chunk) => total + chunk.length, 0);
-	const result = new Uint8Array(length);
-	let offset = 0;
-	for (const chunk of chunks) {
-		result.set(chunk, offset);
-		offset += chunk.length;
-	}
-	return result;
+  const reader = stream.getReader();
+  const chunks = [];
+  while (true) {
+    const { done, value } = await reader.read();
+    if (done)
+      break;
+    if (value) {
+      chunks.push(value);
+    }
+  }
+  const length = chunks.reduce((total, chunk) => total + chunk.length, 0);
+  const result = new Uint8Array(length);
+  let offset = 0;
+  for (const chunk of chunks) {
+    result.set(chunk, offset);
+    offset += chunk.length;
+  }
+  return result;
 }
-
-//#endregion
-export { ElevenLabsVoiceProvider };
-//# sourceMappingURL=elevenlabs-voice.js.map
+export {
+  ElevenLabsVoiceProvider
+};

package/dist/impls/fal-voice.d.ts

@@ -0,0 +1,25 @@
+import type { FalClient } from '@fal-ai/client';
+import type { Voice, VoiceProvider, VoiceSynthesisInput, VoiceSynthesisResult } from '../voice';
+export interface FalVoiceProviderOptions {
+    apiKey: string;
+    modelId?: string;
+    defaultVoiceUrl?: string;
+    defaultExaggeration?: number;
+    defaultTemperature?: number;
+    defaultCfg?: number;
+    pollIntervalMs?: number;
+    client?: FalClient;
+}
+export declare class FalVoiceProvider implements VoiceProvider {
+    private readonly client;
+    private readonly modelId;
+    private readonly defaultVoiceUrl?;
+    private readonly defaultExaggeration?;
+    private readonly defaultTemperature?;
+    private readonly defaultCfg?;
+    private readonly pollIntervalMs?;
+    constructor(options: FalVoiceProviderOptions);
+    listVoices(): Promise<Voice[]>;
+    synthesize(input: VoiceSynthesisInput): Promise<VoiceSynthesisResult>;
+}
+//# sourceMappingURL=fal-voice.d.ts.map

package/dist/impls/fal-voice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fal-voice.d.ts","sourceRoot":"","sources":["../../src/impls/fal-voice.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAUlB,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAS;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;gBAE7B,OAAO,EAAE,uBAAuB;IActC,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IA8B9B,UAAU,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA0C5E"}

package/dist/impls/fal-voice.js

@@ -0,0 +1,113 @@
+// @bun
+// src/impls/fal-voice.ts
+import { createFalClient } from "@fal-ai/client";
+var DEFAULT_MODEL_ID = "fal-ai/chatterbox/text-to-speech";
+
+class FalVoiceProvider {
+  client;
+  modelId;
+  defaultVoiceUrl;
+  defaultExaggeration;
+  defaultTemperature;
+  defaultCfg;
+  pollIntervalMs;
+  constructor(options) {
+    this.client = options.client ?? createFalClient({
+      credentials: options.apiKey
+    });
+    this.modelId = options.modelId ?? DEFAULT_MODEL_ID;
+    this.defaultVoiceUrl = options.defaultVoiceUrl;
+    this.defaultExaggeration = options.defaultExaggeration;
+    this.defaultTemperature = options.defaultTemperature;
+    this.defaultCfg = options.defaultCfg;
+    this.pollIntervalMs = options.pollIntervalMs;
+  }
+  async listVoices() {
+    const voices = [
+      {
+        id: "default",
+        name: "Default Chatterbox Voice",
+        description: "Uses the default model voice (or configured default reference audio URL).",
+        metadata: {
+          modelId: this.modelId
+        }
+      }
+    ];
+    if (this.defaultVoiceUrl) {
+      voices.push({
+        id: this.defaultVoiceUrl,
+        name: "Configured Reference Voice",
+        description: "Reference voice configured at provider setup and used when voiceId is default.",
+        previewUrl: this.defaultVoiceUrl,
+        metadata: {
+          modelId: this.modelId,
+          source: "config.defaultVoiceUrl"
+        }
+      });
+    }
+    return voices;
+  }
+  async synthesize(input) {
+    const referenceVoiceUrl = resolveVoiceUrl(input.voiceId, this.defaultVoiceUrl);
+    const result = await this.client.subscribe(this.modelId, {
+      input: {
+        text: input.text,
+        ...referenceVoiceUrl ? { audio_url: referenceVoiceUrl } : {},
+        ...this.defaultExaggeration != null ? { exaggeration: this.defaultExaggeration } : {},
+        ...this.defaultTemperature != null ? { temperature: this.defaultTemperature } : {},
+        ...this.defaultCfg != null ? { cfg: this.defaultCfg } : {}
+      },
+      pollInterval: this.pollIntervalMs
+    });
+    const audioUrl = extractAudioUrl(result.data);
+    if (!audioUrl) {
+      throw new Error("Fal synthesis completed without an audio URL in response.");
+    }
+    const response = await fetch(audioUrl);
+    if (!response.ok) {
+      throw new Error(`Fal audio download failed (${response.status}).`);
+    }
+    const audio = new Uint8Array(await response.arrayBuffer());
+    return {
+      audio,
+      format: input.format ?? inferFormatFromUrl(audioUrl) ?? "wav",
+      sampleRateHz: input.sampleRateHz ?? 24000,
+      durationSeconds: undefined,
+      url: audioUrl
+    };
+  }
+}
+function resolveVoiceUrl(voiceId, defaultVoiceUrl) {
+  if (!voiceId || voiceId === "default")
+    return defaultVoiceUrl;
+  if (isHttpUrl(voiceId))
+    return voiceId;
+  throw new Error('Fal voiceId must be "default" or a public reference audio URL.');
+}
+function extractAudioUrl(output) {
+  if (output.audio?.url)
+    return output.audio.url;
+  if (typeof output.audio_url === "string")
+    return output.audio_url;
+  if (typeof output.url === "string")
+    return output.url;
+  return;
+}
+function inferFormatFromUrl(url) {
+  const normalized = url.toLowerCase();
+  if (normalized.endsWith(".wav"))
+    return "wav";
+  if (normalized.endsWith(".mp3"))
+    return "mp3";
+  if (normalized.endsWith(".ogg") || normalized.endsWith(".opus"))
+    return "ogg";
+  if (normalized.endsWith(".pcm"))
+    return "pcm";
+  return;
+}
+function isHttpUrl(value) {
+  return value.startsWith("https://") || value.startsWith("http://");
+}
+export {
+  FalVoiceProvider
+};

package/dist/impls/fathom-meeting-recorder.d.ts

@@ -0,0 +1,38 @@
+import { Fathom } from 'fathom-typescript';
+import type { MeetingRecord, MeetingRecorderGetMeetingParams, MeetingRecorderGetTranscriptParams, MeetingRecorderListMeetingsParams, MeetingRecorderListMeetingsResult, MeetingRecorderProvider, MeetingRecorderWebhookEvent, MeetingRecorderWebhookRegistration, MeetingRecorderWebhookRequest, MeetingTranscriptRecord } from '../meeting-recorder';
+export interface FathomMeetingRecorderProviderOptions {
+    apiKey: string;
+    baseUrl?: string;
+    includeTranscript?: boolean;
+    includeSummary?: boolean;
+    includeActionItems?: boolean;
+    includeCrmMatches?: boolean;
+    triggeredFor?: string[];
+    webhookSecret?: string;
+    maxPages?: number;
+    client?: Fathom;
+}
+export declare class FathomMeetingRecorderProvider implements MeetingRecorderProvider {
+    private readonly client;
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly includeTranscript;
+    private readonly includeSummary;
+    private readonly includeActionItems;
+    private readonly includeCrmMatches;
+    private readonly triggeredFor?;
+    private readonly webhookSecret?;
+    private readonly maxPages;
+    constructor(options: FathomMeetingRecorderProviderOptions);
+    listMeetings(params: MeetingRecorderListMeetingsParams): Promise<MeetingRecorderListMeetingsResult>;
+    getMeeting(params: MeetingRecorderGetMeetingParams): Promise<MeetingRecord>;
+    getTranscript(params: MeetingRecorderGetTranscriptParams): Promise<MeetingTranscriptRecord>;
+    parseWebhook(request: MeetingRecorderWebhookRequest): Promise<MeetingRecorderWebhookEvent>;
+    verifyWebhook(request: MeetingRecorderWebhookRequest): Promise<boolean>;
+    registerWebhook(registration: MeetingRecorderWebhookRegistration): Promise<{
+        id: string;
+        secret?: string;
+    }>;
+    private request;
+}
+//# sourceMappingURL=fathom-meeting-recorder.d.ts.map

package/dist/impls/fathom-meeting-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fathom-meeting-recorder.d.ts","sourceRoot":"","sources":["../../src/impls/fathom-meeting-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,KAAK,EACV,aAAa,EACb,+BAA+B,EAC/B,kCAAkC,EAClC,iCAAiC,EACjC,iCAAiC,EACjC,uBAAuB,EACvB,2BAA2B,EAC3B,kCAAkC,EAClC,6BAA6B,EAC7B,uBAAuB,EACxB,MAAM,qBAAqB,CAAC;AAkB7B,MAAM,WAAW,oCAAoC;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,qBAAa,6BAA8B,YAAW,uBAAuB;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,oCAAoC;IAoBnD,YAAY,CAChB,MAAM,EAAE,iCAAiC,GACxC,OAAO,CAAC,iCAAiC,CAAC;IA8BvC,UAAU,CACd,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC,aAAa,CAAC;IAwBnB,aAAa,CACjB,MAAM,EAAE,kCAAkC,GACzC,OAAO,CAAC,uBAAuB,CAAC;IA0B7B,YAAY,CAChB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,2BAA2B,CAAC;IAuBjC,aAAa,CACjB,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,OAAO,CAAC;IAYb,eAAe,CACnB,YAAY,EAAE,kCAAkC,GAC/C,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;YAiB7B,OAAO;CAatB"}