@contractspec/example.voice-providers 1.57.0

package/.turbo/turbo-build$colon$bundle.log

@@ -0,0 +1,46 @@
+$ tsdown
+ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/voice-providers/tsdown.config.js 
+ℹ entry: src/connection.sample.ts, src/example.ts, src/index.ts, src/run.ts, src/docs/index.ts, src/docs/voice-providers.docblock.ts, src/handlers/create-provider.ts, src/handlers/list-voices.ts, src/handlers/synthesize.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 33 files
+ℹ dist/run.js                                3.90 kB │ gzip: 1.33 kB
+ℹ dist/docs/voice-providers.docblock.js      1.85 kB │ gzip: 0.87 kB
+ℹ dist/connection.sample.js                  1.48 kB │ gzip: 0.58 kB
+ℹ dist/handlers/create-provider.js           1.21 kB │ gzip: 0.49 kB
+ℹ dist/example.js                            0.99 kB │ gzip: 0.51 kB
+ℹ dist/index.js                              0.49 kB │ gzip: 0.20 kB
+ℹ dist/handlers/synthesize.js                0.28 kB │ gzip: 0.19 kB
+ℹ dist/handlers/list-voices.js               0.26 kB │ gzip: 0.18 kB
+ℹ dist/docs/index.js                         0.04 kB │ gzip: 0.06 kB
+ℹ dist/run.js.map                            7.18 kB │ gzip: 2.33 kB
+ℹ dist/handlers/create-provider.js.map       2.73 kB │ gzip: 0.96 kB
+ℹ dist/docs/voice-providers.docblock.js.map  2.57 kB │ gzip: 1.08 kB
+ℹ dist/connection.sample.js.map              2.28 kB │ gzip: 0.83 kB
+ℹ dist/example.js.map                        1.46 kB │ gzip: 0.70 kB
+ℹ dist/handlers/synthesize.js.map            0.76 kB │ gzip: 0.40 kB
+ℹ dist/handlers/list-voices.js.map           0.56 kB │ gzip: 0.34 kB
+ℹ dist/handlers/create-provider.d.ts.map     0.43 kB │ gzip: 0.24 kB
+ℹ dist/handlers/synthesize.d.ts.map          0.22 kB │ gzip: 0.18 kB
+ℹ dist/connection.sample.d.ts.map            0.20 kB │ gzip: 0.14 kB
+ℹ dist/handlers/list-voices.d.ts.map         0.17 kB │ gzip: 0.15 kB
+ℹ dist/example.d.ts.map                      0.13 kB │ gzip: 0.13 kB
+ℹ dist/run.d.ts.map                          0.12 kB │ gzip: 0.13 kB
+ℹ dist/handlers/create-provider.d.ts         1.05 kB │ gzip: 0.45 kB
+ℹ dist/index.d.ts                            0.69 kB │ gzip: 0.24 kB
+ℹ dist/handlers/synthesize.d.ts              0.52 kB │ gzip: 0.27 kB
+ℹ dist/connection.sample.d.ts                0.45 kB │ gzip: 0.21 kB
+ℹ dist/handlers/list-voices.d.ts             0.35 kB │ gzip: 0.23 kB
+ℹ dist/example.d.ts                          0.25 kB │ gzip: 0.17 kB
+ℹ dist/run.d.ts                              0.20 kB │ gzip: 0.16 kB
+ℹ dist/docs/index.d.ts                       0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/voice-providers.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 31 files, total: 32.86 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - rolldown-plugin-dts:generate (49%)
+  - tsdown:external (48%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 21405ms

package/.turbo/turbo-build.log

@@ -0,0 +1,47 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
+ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/voice-providers/tsdown.config.js 
+ℹ entry: src/connection.sample.ts, src/example.ts, src/index.ts, src/run.ts, src/handlers/create-provider.ts, src/handlers/list-voices.ts, src/handlers/synthesize.ts, src/docs/index.ts, src/docs/voice-providers.docblock.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/run.js                                3.90 kB │ gzip: 1.33 kB
+ℹ dist/docs/voice-providers.docblock.js      1.85 kB │ gzip: 0.87 kB
+ℹ dist/connection.sample.js                  1.48 kB │ gzip: 0.58 kB
+ℹ dist/handlers/create-provider.js           1.21 kB │ gzip: 0.49 kB
+ℹ dist/example.js                            0.99 kB │ gzip: 0.51 kB
+ℹ dist/index.js                              0.49 kB │ gzip: 0.20 kB
+ℹ dist/handlers/synthesize.js                0.28 kB │ gzip: 0.19 kB
+ℹ dist/handlers/list-voices.js               0.26 kB │ gzip: 0.18 kB
+ℹ dist/docs/index.js                         0.04 kB │ gzip: 0.06 kB
+ℹ dist/run.js.map                            7.18 kB │ gzip: 2.33 kB
+ℹ dist/handlers/create-provider.js.map       2.73 kB │ gzip: 0.96 kB
+ℹ dist/docs/voice-providers.docblock.js.map  2.57 kB │ gzip: 1.08 kB
+ℹ dist/connection.sample.js.map              2.28 kB │ gzip: 0.83 kB
+ℹ dist/example.js.map                        1.46 kB │ gzip: 0.70 kB
+ℹ dist/handlers/synthesize.js.map            0.76 kB │ gzip: 0.40 kB
+ℹ dist/handlers/list-voices.js.map           0.56 kB │ gzip: 0.34 kB
+ℹ dist/handlers/create-provider.d.ts.map     0.43 kB │ gzip: 0.24 kB
+ℹ dist/handlers/synthesize.d.ts.map          0.22 kB │ gzip: 0.18 kB
+ℹ dist/connection.sample.d.ts.map            0.20 kB │ gzip: 0.14 kB
+ℹ dist/handlers/list-voices.d.ts.map         0.17 kB │ gzip: 0.15 kB
+ℹ dist/example.d.ts.map                      0.13 kB │ gzip: 0.13 kB
+ℹ dist/run.d.ts.map                          0.12 kB │ gzip: 0.13 kB
+ℹ dist/handlers/create-provider.d.ts         1.05 kB │ gzip: 0.45 kB
+ℹ dist/index.d.ts                            0.69 kB │ gzip: 0.24 kB
+ℹ dist/handlers/synthesize.d.ts              0.52 kB │ gzip: 0.27 kB
+ℹ dist/connection.sample.d.ts                0.45 kB │ gzip: 0.21 kB
+ℹ dist/handlers/list-voices.d.ts             0.35 kB │ gzip: 0.23 kB
+ℹ dist/example.d.ts                          0.25 kB │ gzip: 0.17 kB
+ℹ dist/run.d.ts                              0.20 kB │ gzip: 0.16 kB
+ℹ dist/docs/index.d.ts                       0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/voice-providers.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
+ℹ 31 files, total: 32.86 kB
+[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
+  - tsdown:external (56%)
+  - rolldown-plugin-dts:generate (42%)
+See https://rolldown.rs/options/checks#plugintimings for more details.
+
+✔ Build complete in 21592ms

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# @contractspec/example.voice-providers
+
+## 1.57.0
+
+### Minor Changes
+
+- 4651e06: Add Supabase and voice provider integrations with new runnable examples, and expose these providers across contracts, workspace tooling, and provider factory wiring.
+
+### Patch Changes
+
+- Updated dependencies [8ecf3c1]
+- Updated dependencies [47c48c2]
+- Updated dependencies [a119963]
+- Updated dependencies [4651e06]
+- Updated dependencies [ad9d10a]
+- Updated dependencies [11a5a05]
+  - @contractspec/lib.contracts@1.57.0
+  - @contractspec/integration.providers-impls@1.57.0
+
+## 1.56.1
+
+### Patch Changes
+
+- feat: add voice providers example for Gradium and Fal
+- Updated dependencies
+  - @contractspec/integration.providers-impls@1.56.1
+  - @contractspec/lib.contracts@1.56.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,14 @@
+# @contractspec/example.voice-providers
+
+Website: https://contractspec.io/
+
+Voice provider example for `ai-voice.gradium` and `ai-voice.fal`.
+
+This package demonstrates:
+
+- provider selection by integration key
+- listing available voices
+- synthesizing audio from plain text
+- connection metadata samples for BYOK setups
+
+Use this as a reference for wiring voice synthesis into workflows or service handlers.

package/dist/connection.sample.d.ts

@@ -0,0 +1,9 @@
+import { IntegrationConnection } from "@contractspec/lib.contracts/integrations/connection";
+
+//#region src/connection.sample.d.ts
+declare const gradiumVoiceConnection: IntegrationConnection;
+declare const falVoiceConnection: IntegrationConnection;
+declare const voiceSampleConnections: IntegrationConnection[];
+//#endregion
+export { falVoiceConnection, gradiumVoiceConnection, voiceSampleConnections };
+//# sourceMappingURL=connection.sample.d.ts.map

package/dist/connection.sample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.sample.d.ts","names":[],"sources":["../src/connection.sample.ts"],"mappings":";;;cAEa,sBAAA,EAAwB,qBAAA;AAAA,cAsBxB,kBAAA,EAAoB,qBAAA;AAAA,cA0BpB,sBAAA,EAAwB,qBAAA"}

package/dist/connection.sample.js

@@ -0,0 +1,51 @@
+//#region src/connection.sample.ts
+const gradiumVoiceConnection = {
+	meta: {
+		id: "conn-gradium-voice-demo",
+		tenantId: "acme-inc",
+		integrationKey: "ai-voice.gradium",
+		integrationVersion: "1.0.0",
+		label: "Gradium Voice",
+		environment: "production",
+		createdAt: "2026-01-01T00:00:00.000Z",
+		updatedAt: "2026-01-01T00:00:00.000Z"
+	},
+	ownershipMode: "byok",
+	config: {
+		defaultVoiceId: "YTpq7expH9539ERJ",
+		region: "eu",
+		outputFormat: "wav"
+	},
+	secretProvider: "vault",
+	secretRef: "vault://integrations/acme-inc/conn-gradium-voice-demo",
+	status: "connected"
+};
+const falVoiceConnection = {
+	meta: {
+		id: "conn-fal-voice-demo",
+		tenantId: "acme-inc",
+		integrationKey: "ai-voice.fal",
+		integrationVersion: "1.0.0",
+		label: "Fal Voice",
+		environment: "production",
+		createdAt: "2026-01-01T00:00:00.000Z",
+		updatedAt: "2026-01-01T00:00:00.000Z"
+	},
+	ownershipMode: "byok",
+	config: {
+		modelId: "fal-ai/chatterbox/text-to-speech",
+		defaultVoiceUrl: "https://storage.googleapis.com/chatterbox-demo-samples/prompts/male_rickmorty.mp3",
+		defaultExaggeration: .25,
+		defaultTemperature: .7,
+		defaultCfg: .5,
+		pollIntervalMs: 1e3
+	},
+	secretProvider: "vault",
+	secretRef: "vault://integrations/acme-inc/conn-fal-voice-demo",
+	status: "connected"
+};
+const voiceSampleConnections = [gradiumVoiceConnection, falVoiceConnection];
+
+//#endregion
+export { falVoiceConnection, gradiumVoiceConnection, voiceSampleConnections };
+//# sourceMappingURL=connection.sample.js.map

package/dist/connection.sample.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.sample.js","names":[],"sources":["../src/connection.sample.ts"],"sourcesContent":["import type { IntegrationConnection } from '@contractspec/lib.contracts/integrations/connection';\n\nexport const gradiumVoiceConnection: IntegrationConnection = {\n  meta: {\n    id: 'conn-gradium-voice-demo',\n    tenantId: 'acme-inc',\n    integrationKey: 'ai-voice.gradium',\n    integrationVersion: '1.0.0',\n    label: 'Gradium Voice',\n    environment: 'production',\n    createdAt: '2026-01-01T00:00:00.000Z',\n    updatedAt: '2026-01-01T00:00:00.000Z',\n  },\n  ownershipMode: 'byok',\n  config: {\n    defaultVoiceId: 'YTpq7expH9539ERJ',\n    region: 'eu',\n    outputFormat: 'wav',\n  },\n  secretProvider: 'vault',\n  secretRef: 'vault://integrations/acme-inc/conn-gradium-voice-demo',\n  status: 'connected',\n};\n\nexport const falVoiceConnection: IntegrationConnection = {\n  meta: {\n    id: 'conn-fal-voice-demo',\n    tenantId: 'acme-inc',\n    integrationKey: 'ai-voice.fal',\n    integrationVersion: '1.0.0',\n    label: 'Fal Voice',\n    environment: 'production',\n    createdAt: '2026-01-01T00:00:00.000Z',\n    updatedAt: '2026-01-01T00:00:00.000Z',\n  },\n  ownershipMode: 'byok',\n  config: {\n    modelId: 'fal-ai/chatterbox/text-to-speech',\n    defaultVoiceUrl:\n      'https://storage.googleapis.com/chatterbox-demo-samples/prompts/male_rickmorty.mp3',\n    defaultExaggeration: 0.25,\n    defaultTemperature: 0.7,\n    defaultCfg: 0.5,\n    pollIntervalMs: 1000,\n  },\n  secretProvider: 'vault',\n  secretRef: 'vault://integrations/acme-inc/conn-fal-voice-demo',\n  status: 'connected',\n};\n\nexport const voiceSampleConnections: IntegrationConnection[] = [\n  gradiumVoiceConnection,\n  falVoiceConnection,\n];\n"],"mappings":";AAEA,MAAa,yBAAgD;CAC3D,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,gBAAgB;EAChB,oBAAoB;EACpB,OAAO;EACP,aAAa;EACb,WAAW;EACX,WAAW;EACZ;CACD,eAAe;CACf,QAAQ;EACN,gBAAgB;EAChB,QAAQ;EACR,cAAc;EACf;CACD,gBAAgB;CAChB,WAAW;CACX,QAAQ;CACT;AAED,MAAa,qBAA4C;CACvD,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,gBAAgB;EAChB,oBAAoB;EACpB,OAAO;EACP,aAAa;EACb,WAAW;EACX,WAAW;EACZ;CACD,eAAe;CACf,QAAQ;EACN,SAAS;EACT,iBACE;EACF,qBAAqB;EACrB,oBAAoB;EACpB,YAAY;EACZ,gBAAgB;EACjB;CACD,gBAAgB;CAChB,WAAW;CACX,QAAQ;CACT;AAED,MAAa,yBAAkD,CAC7D,wBACA,mBACD"}

package/dist/docs/index.d.ts

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

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./voice-providers.docblock.js";

package/dist/docs/voice-providers.docblock.d.ts

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

package/dist/docs/voice-providers.docblock.js

@@ -0,0 +1,31 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/voice-providers.docblock.ts
+registerDocBlocks([{
+	id: "docs.examples.voice-providers",
+	title: "Voice Providers (example)",
+	summary: "Multi-provider voice integration example covering Gradium and Fal text-to-speech flows.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/examples/voice-providers",
+	tags: [
+		"voice",
+		"tts",
+		"gradium",
+		"fal",
+		"example"
+	],
+	body: "## What this example shows\n- Provider selection for `ai-voice.gradium` and `ai-voice.fal`.\n- Listing voice catalogs and synthesizing text into audio bytes.\n- Connection metadata patterns for BYOK secret references.\n\n## Secrets and config\n- `apiKey` for each provider.\n- Gradium config: `defaultVoiceId`, `region`, `outputFormat`.\n- Fal config: `modelId`, `defaultVoiceUrl`, synthesis tuning fields.\n\n## Guardrails\n- Keep API keys in secret providers only.\n- Prefer declarative provider config over hardcoded runtime options.\n- Keep synthesis side effects explicit for deterministic workflows."
+}, {
+	id: "docs.examples.voice-providers.usage",
+	title: "Voice Providers - Usage",
+	summary: "How to wire provider factory and synthesis helpers in runtime code.",
+	kind: "usage",
+	visibility: "public",
+	route: "/docs/examples/voice-providers/usage",
+	tags: ["voice", "usage"],
+	body: "## Usage\n- Call `createVoiceProvider` with integration key, secrets, and config.\n- Use `listVoices` to expose voice choices in admin/config screens.\n- Use `synthesizeVoice` for message generation or workflow steps.\n\n## Notes\n- Fal uses an audio URL output; this example downloads bytes for a canonical result shape.\n- Gradium maps provider output formats into ContractSpec voice result conventions."
+}]);
+
+//#endregion
+//# sourceMappingURL=voice-providers.docblock.js.map

package/dist/docs/voice-providers.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-providers.docblock.js","names":[],"sources":["../../src/docs/voice-providers.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst blocks: DocBlock[] = [\n  {\n    id: 'docs.examples.voice-providers',\n    title: 'Voice Providers (example)',\n    summary:\n      'Multi-provider voice integration example covering Gradium and Fal text-to-speech flows.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/examples/voice-providers',\n    tags: ['voice', 'tts', 'gradium', 'fal', 'example'],\n    body:\n      '## What this example shows\\n' +\n      '- Provider selection for `ai-voice.gradium` and `ai-voice.fal`.\\n' +\n      '- Listing voice catalogs and synthesizing text into audio bytes.\\n' +\n      '- Connection metadata patterns for BYOK secret references.\\n\\n' +\n      '## Secrets and config\\n' +\n      '- `apiKey` for each provider.\\n' +\n      '- Gradium config: `defaultVoiceId`, `region`, `outputFormat`.\\n' +\n      '- Fal config: `modelId`, `defaultVoiceUrl`, synthesis tuning fields.\\n\\n' +\n      '## Guardrails\\n' +\n      '- Keep API keys in secret providers only.\\n' +\n      '- Prefer declarative provider config over hardcoded runtime options.\\n' +\n      '- Keep synthesis side effects explicit for deterministic workflows.',\n  },\n  {\n    id: 'docs.examples.voice-providers.usage',\n    title: 'Voice Providers - Usage',\n    summary:\n      'How to wire provider factory and synthesis helpers in runtime code.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/voice-providers/usage',\n    tags: ['voice', 'usage'],\n    body:\n      '## Usage\\n' +\n      '- Call `createVoiceProvider` with integration key, secrets, and config.\\n' +\n      '- Use `listVoices` to expose voice choices in admin/config screens.\\n' +\n      '- Use `synthesizeVoice` for message generation or workflow steps.\\n\\n' +\n      '## Notes\\n' +\n      '- Fal uses an audio URL output; this example downloads bytes for a canonical result shape.\\n' +\n      '- Gradium maps provider output formats into ContractSpec voice result conventions.',\n  },\n];\n\nregisterDocBlocks(blocks);\n"],"mappings":";;;AA+CA,kBA5C2B,CACzB;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAS;EAAO;EAAW;EAAO;EAAU;CACnD,MACE;CAYH,EACD;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM,CAAC,SAAS,QAAQ;CACxB,MACE;CAOH,CACF,CAEwB"}

package/dist/example.d.ts

@@ -0,0 +1,7 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+
+//#region src/example.d.ts
+declare const example: _contractspec_lib_contracts0.ExampleSpec;
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"mappings":";;;cAEM,OAAA,EA2BJ,4BAAA,CA3BW,WAAA"}

package/dist/example.js

@@ -0,0 +1,46 @@
+import { defineExample } from "@contractspec/lib.contracts";
+
+//#region src/example.ts
+const example = defineExample({
+	meta: {
+		key: "voice-providers",
+		version: "1.0.0",
+		title: "Voice Providers (Gradium and Fal)",
+		description: "Multi-provider voice integration example for Gradium and Fal text-to-speech adapters.",
+		kind: "integration",
+		visibility: "public",
+		stability: "experimental",
+		owners: ["@platform.integrations"],
+		tags: [
+			"voice",
+			"tts",
+			"gradium",
+			"fal",
+			"integrations"
+		]
+	},
+	docs: {
+		rootDocId: "docs.examples.voice-providers",
+		usageDocId: "docs.examples.voice-providers.usage"
+	},
+	entrypoints: {
+		packageName: "@contractspec/example.voice-providers",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["markdown", "specs"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+});
+
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'voice-providers',\n    version: '1.0.0',\n    title: 'Voice Providers (Gradium and Fal)',\n    description:\n      'Multi-provider voice integration example for Gradium and Fal text-to-speech adapters.',\n    kind: 'integration',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.integrations'],\n    tags: ['voice', 'tts', 'gradium', 'fal', 'integrations'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.voice-providers',\n    usageDocId: 'docs.examples.voice-providers.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.voice-providers',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,yBAAyB;EAClC,MAAM;GAAC;GAAS;GAAO;GAAW;GAAO;GAAe;EACzD;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC"}

package/dist/handlers/create-provider.d.ts

@@ -0,0 +1,29 @@
+import { VoiceProvider } from "@contractspec/lib.contracts/integrations/providers/voice";
+
+//#region src/handlers/create-provider.d.ts
+type VoiceIntegrationKey = 'ai-voice.gradium' | 'ai-voice.fal';
+interface VoiceProviderSecrets {
+  apiKey: string;
+}
+interface VoiceProviderConfig {
+  defaultVoiceId?: string;
+  region?: 'eu' | 'us';
+  baseUrl?: string;
+  timeoutMs?: number;
+  outputFormat?: 'wav' | 'pcm' | 'opus' | 'ulaw_8000' | 'alaw_8000' | 'pcm_16000' | 'pcm_24000';
+  modelId?: string;
+  defaultVoiceUrl?: string;
+  defaultExaggeration?: number;
+  defaultTemperature?: number;
+  defaultCfg?: number;
+  pollIntervalMs?: number;
+}
+interface VoiceProviderFactoryInput {
+  integrationKey: VoiceIntegrationKey;
+  secrets: VoiceProviderSecrets;
+  config?: VoiceProviderConfig;
+}
+declare function createVoiceProvider(input: VoiceProviderFactoryInput): VoiceProvider;
+//#endregion
+export { VoiceIntegrationKey, VoiceProviderConfig, VoiceProviderFactoryInput, VoiceProviderSecrets, createVoiceProvider };
+//# sourceMappingURL=create-provider.d.ts.map

package/dist/handlers/create-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-provider.d.ts","names":[],"sources":["../../src/handlers/create-provider.ts"],"mappings":";;;KAIY,mBAAA;AAAA,UAEK,oBAAA;EACf,MAAA;AAAA;AAAA,UAGe,mBAAA;EACf,cAAA;EACA,MAAA;EACA,OAAA;EACA,SAAA;EACA,YAAA;EAQA,OAAA;EACA,eAAA;EACA,mBAAA;EACA,kBAAA;EACA,UAAA;EACA,cAAA;AAAA;AAAA,UAGe,yBAAA;EACf,cAAA,EAAgB,mBAAA;EAChB,OAAA,EAAS,oBAAA;EACT,MAAA,GAAS,mBAAA;AAAA;AAAA,iBAGK,mBAAA,CACd,KAAA,EAAO,yBAAA,GACN,aAAA"}

package/dist/handlers/create-provider.js

@@ -0,0 +1,32 @@
+import { FalVoiceProvider } from "@contractspec/integration.providers-impls/impls/fal-voice";
+import { GradiumVoiceProvider } from "@contractspec/integration.providers-impls/impls/gradium-voice";
+
+//#region src/handlers/create-provider.ts
+function createVoiceProvider(input) {
+	const { integrationKey, secrets, config } = input;
+	if (!secrets.apiKey) throw new Error("Voice provider apiKey is required.");
+	switch (integrationKey) {
+		case "ai-voice.gradium": return new GradiumVoiceProvider({
+			apiKey: secrets.apiKey,
+			defaultVoiceId: config?.defaultVoiceId,
+			region: config?.region,
+			baseUrl: config?.baseUrl,
+			timeoutMs: config?.timeoutMs,
+			outputFormat: config?.outputFormat
+		});
+		case "ai-voice.fal": return new FalVoiceProvider({
+			apiKey: secrets.apiKey,
+			modelId: config?.modelId,
+			defaultVoiceUrl: config?.defaultVoiceUrl,
+			defaultExaggeration: config?.defaultExaggeration,
+			defaultTemperature: config?.defaultTemperature,
+			defaultCfg: config?.defaultCfg,
+			pollIntervalMs: config?.pollIntervalMs
+		});
+		default: throw new Error(`Unsupported voice provider: ${integrationKey}`);
+	}
+}
+
+//#endregion
+export { createVoiceProvider };
+//# sourceMappingURL=create-provider.js.map

package/dist/handlers/create-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-provider.js","names":[],"sources":["../../src/handlers/create-provider.ts"],"sourcesContent":["import { FalVoiceProvider } from '@contractspec/integration.providers-impls/impls/fal-voice';\nimport { GradiumVoiceProvider } from '@contractspec/integration.providers-impls/impls/gradium-voice';\nimport type { VoiceProvider } from '@contractspec/lib.contracts/integrations/providers/voice';\n\nexport type VoiceIntegrationKey = 'ai-voice.gradium' | 'ai-voice.fal';\n\nexport interface VoiceProviderSecrets {\n  apiKey: string;\n}\n\nexport interface VoiceProviderConfig {\n  defaultVoiceId?: string;\n  region?: 'eu' | 'us';\n  baseUrl?: string;\n  timeoutMs?: number;\n  outputFormat?:\n    | 'wav'\n    | 'pcm'\n    | 'opus'\n    | 'ulaw_8000'\n    | 'alaw_8000'\n    | 'pcm_16000'\n    | 'pcm_24000';\n  modelId?: string;\n  defaultVoiceUrl?: string;\n  defaultExaggeration?: number;\n  defaultTemperature?: number;\n  defaultCfg?: number;\n  pollIntervalMs?: number;\n}\n\nexport interface VoiceProviderFactoryInput {\n  integrationKey: VoiceIntegrationKey;\n  secrets: VoiceProviderSecrets;\n  config?: VoiceProviderConfig;\n}\n\nexport function createVoiceProvider(\n  input: VoiceProviderFactoryInput\n): VoiceProvider {\n  const { integrationKey, secrets, config } = input;\n\n  if (!secrets.apiKey) {\n    throw new Error('Voice provider apiKey is required.');\n  }\n\n  switch (integrationKey) {\n    case 'ai-voice.gradium':\n      return new GradiumVoiceProvider({\n        apiKey: secrets.apiKey,\n        defaultVoiceId: config?.defaultVoiceId,\n        region: config?.region,\n        baseUrl: config?.baseUrl,\n        timeoutMs: config?.timeoutMs,\n        outputFormat: config?.outputFormat,\n      });\n    case 'ai-voice.fal':\n      return new FalVoiceProvider({\n        apiKey: secrets.apiKey,\n        modelId: config?.modelId,\n        defaultVoiceUrl: config?.defaultVoiceUrl,\n        defaultExaggeration: config?.defaultExaggeration,\n        defaultTemperature: config?.defaultTemperature,\n        defaultCfg: config?.defaultCfg,\n        pollIntervalMs: config?.pollIntervalMs,\n      });\n    default:\n      throw new Error(`Unsupported voice provider: ${integrationKey}`);\n  }\n}\n"],"mappings":";;;;AAqCA,SAAgB,oBACd,OACe;CACf,MAAM,EAAE,gBAAgB,SAAS,WAAW;AAE5C,KAAI,CAAC,QAAQ,OACX,OAAM,IAAI,MAAM,qCAAqC;AAGvD,SAAQ,gBAAR;EACE,KAAK,mBACH,QAAO,IAAI,qBAAqB;GAC9B,QAAQ,QAAQ;GAChB,gBAAgB,QAAQ;GACxB,QAAQ,QAAQ;GAChB,SAAS,QAAQ;GACjB,WAAW,QAAQ;GACnB,cAAc,QAAQ;GACvB,CAAC;EACJ,KAAK,eACH,QAAO,IAAI,iBAAiB;GAC1B,QAAQ,QAAQ;GAChB,SAAS,QAAQ;GACjB,iBAAiB,QAAQ;GACzB,qBAAqB,QAAQ;GAC7B,oBAAoB,QAAQ;GAC5B,YAAY,QAAQ;GACpB,gBAAgB,QAAQ;GACzB,CAAC;EACJ,QACE,OAAM,IAAI,MAAM,+BAA+B,iBAAiB"}

package/dist/handlers/list-voices.d.ts

@@ -0,0 +1,8 @@
+import { VoiceProviderFactoryInput } from "./create-provider.js";
+import { Voice } from "@contractspec/lib.contracts/integrations/providers/voice";
+
+//#region src/handlers/list-voices.d.ts
+declare function listVoices(input: VoiceProviderFactoryInput): Promise<Voice[]>;
+//#endregion
+export { listVoices };
+//# sourceMappingURL=list-voices.d.ts.map

package/dist/handlers/list-voices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-voices.d.ts","names":[],"sources":["../../src/handlers/list-voices.ts"],"mappings":";;;;iBAOsB,UAAA,CACpB,KAAA,EAAO,yBAAA,GACN,OAAA,CAAQ,KAAA"}

package/dist/handlers/list-voices.js

@@ -0,0 +1,10 @@
+import { createVoiceProvider } from "./create-provider.js";
+
+//#region src/handlers/list-voices.ts
+async function listVoices(input) {
+	return createVoiceProvider(input).listVoices();
+}
+
+//#endregion
+export { listVoices };
+//# sourceMappingURL=list-voices.js.map

package/dist/handlers/list-voices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-voices.js","names":[],"sources":["../../src/handlers/list-voices.ts"],"sourcesContent":["import type { Voice } from '@contractspec/lib.contracts/integrations/providers/voice';\n\nimport {\n  createVoiceProvider,\n  type VoiceProviderFactoryInput,\n} from './create-provider';\n\nexport async function listVoices(\n  input: VoiceProviderFactoryInput\n): Promise<Voice[]> {\n  const provider = createVoiceProvider(input);\n  return provider.listVoices();\n}\n"],"mappings":";;;AAOA,eAAsB,WACpB,OACkB;AAElB,QADiB,oBAAoB,MAAM,CAC3B,YAAY"}

package/dist/handlers/synthesize.d.ts

@@ -0,0 +1,11 @@
+import { VoiceProviderFactoryInput } from "./create-provider.js";
+import { VoiceSynthesisInput, VoiceSynthesisResult } from "@contractspec/lib.contracts/integrations/providers/voice";
+
+//#region src/handlers/synthesize.d.ts
+interface SynthesizeVoiceInput extends VoiceProviderFactoryInput {
+  synthesis: VoiceSynthesisInput;
+}
+declare function synthesizeVoice(input: SynthesizeVoiceInput): Promise<VoiceSynthesisResult>;
+//#endregion
+export { SynthesizeVoiceInput, synthesizeVoice };
+//# sourceMappingURL=synthesize.d.ts.map

package/dist/handlers/synthesize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.d.ts","names":[],"sources":["../../src/handlers/synthesize.ts"],"mappings":";;;;UAUiB,oBAAA,SAA6B,yBAAA;EAC5C,SAAA,EAAW,mBAAA;AAAA;AAAA,iBAGS,eAAA,CACpB,KAAA,EAAO,oBAAA,GACN,OAAA,CAAQ,oBAAA"}

package/dist/handlers/synthesize.js

@@ -0,0 +1,10 @@
+import { createVoiceProvider } from "./create-provider.js";
+
+//#region src/handlers/synthesize.ts
+async function synthesizeVoice(input) {
+	return createVoiceProvider(input).synthesize(input.synthesis);
+}
+
+//#endregion
+export { synthesizeVoice };
+//# sourceMappingURL=synthesize.js.map

package/dist/handlers/synthesize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesize.js","names":[],"sources":["../../src/handlers/synthesize.ts"],"sourcesContent":["import type {\n  VoiceSynthesisInput,\n  VoiceSynthesisResult,\n} from '@contractspec/lib.contracts/integrations/providers/voice';\n\nimport {\n  createVoiceProvider,\n  type VoiceProviderFactoryInput,\n} from './create-provider';\n\nexport interface SynthesizeVoiceInput extends VoiceProviderFactoryInput {\n  synthesis: VoiceSynthesisInput;\n}\n\nexport async function synthesizeVoice(\n  input: SynthesizeVoiceInput\n): Promise<VoiceSynthesisResult> {\n  const provider = createVoiceProvider(input);\n  return provider.synthesize(input.synthesis);\n}\n"],"mappings":";;;AAcA,eAAsB,gBACpB,OAC+B;AAE/B,QADiB,oBAAoB,MAAM,CAC3B,WAAW,MAAM,UAAU"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { falVoiceConnection, gradiumVoiceConnection, voiceSampleConnections } from "./connection.sample.js";
+import example from "./example.js";
+import { VoiceIntegrationKey, VoiceProviderConfig, VoiceProviderFactoryInput, VoiceProviderSecrets, createVoiceProvider } from "./handlers/create-provider.js";
+import { listVoices } from "./handlers/list-voices.js";
+import { SynthesizeVoiceInput, synthesizeVoice } from "./handlers/synthesize.js";
+export { SynthesizeVoiceInput, VoiceIntegrationKey, VoiceProviderConfig, VoiceProviderFactoryInput, VoiceProviderSecrets, createVoiceProvider, example, falVoiceConnection, gradiumVoiceConnection, listVoices, synthesizeVoice, voiceSampleConnections };

package/dist/index.js

@@ -0,0 +1,8 @@
+import { falVoiceConnection, gradiumVoiceConnection, voiceSampleConnections } from "./connection.sample.js";
+import example from "./example.js";
+import { createVoiceProvider } from "./handlers/create-provider.js";
+import { listVoices } from "./handlers/list-voices.js";
+import { synthesizeVoice } from "./handlers/synthesize.js";
+import "./docs/index.js";
+
+export { createVoiceProvider, example, falVoiceConnection, gradiumVoiceConnection, listVoices, synthesizeVoice, voiceSampleConnections };

package/dist/run.d.ts

@@ -0,0 +1,5 @@
+//#region src/run.d.ts
+declare function runVoiceProvidersExampleFromEnv(): Promise<Record<string, unknown>>;
+//#endregion
+export { runVoiceProvidersExampleFromEnv };
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","names":[],"sources":["../src/run.ts"],"mappings":";iBAUsB,+BAAA,CAAA,GAA+B,OAAA,CAAA,MAAA"}