1export const tldvIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'meeting-recorder.tldv',
4		version: '1.0.0',
5		category: 'meeting-recorder',
6		title: 'tl;dv Meeting Recorder',
7		description:
8			'tl;dv Public API for meeting recordings, transcripts, and webhook events.',
9		domain: 'productivity',
10		owners: ['platform.integrations'],
11		tags: ['meeting-recorder', 'tldv', 'transcripts'],
12		stability: StabilityEnum.Experimental,
13	},
14	supportedModes: ['byok'],
15	transports: [
16		{ type: 'rest' },
17		{
18			type: 'webhook',
19			inbound: {
20				signatureHeader: 'x-tldv-signature',
21				signingAlgorithm: 'hmac-sha256',
22			},
23		},
24	],
25	preferredTransport: 'rest',
26	supportedAuthMethods: [
27		{ type: 'api-key' },
28		{
29			type: 'webhook-signing',
30			algorithm: 'hmac-sha256',
31			signatureHeader: 'x-tldv-signature',
32		},
33	],
34	capabilities: {
35		provides: [
36			{ key: 'meeting-recorder.meetings.read', version: '1.0.0' },
37			{ key: 'meeting-recorder.transcripts.read', version: '1.0.0' },
38			{ key: 'meeting-recorder.webhooks', version: '1.0.0' },
39		],
40	},
41	configSchema: {
42		schema: {
43			type: 'object',
44			properties: {
45				baseUrl: {
46					type: 'string',
47					description:
48						'Optional override for the tl;dv API base URL. Defaults to https://pasta.tldv.io/v1alpha1.',
49				},
50				webhookUrl: {
51					type: 'string',
52					description:
53						'Webhook destination URL configured in tl;dv settings (MeetingReady/TranscriptReady).',
54				},
55				webhookEvents: {
56					type: 'array',
57					items: { type: 'string' },
58					description:
59						'Webhook triggers to enable (MeetingReady, TranscriptReady).',
60				},
61				webhookScope: {
62					type: 'string',
63					description:
64						'Webhook scope to configure (user, team, or organization).',
65				},
66			},
67		},
68		example: {
69			baseUrl: 'https://pasta.tldv.io/v1alpha1',
70			webhookUrl: 'https://example.com/webhooks/tldv',
71			webhookEvents: ['MeetingReady', 'TranscriptReady'],
72			webhookScope: 'team',
73		},
74	},
75	secretSchema: {
76		schema: {
77			type: 'object',
78			required: ['apiKey'],
79			properties: {
80				apiKey: {
81					type: 'string',
82					description:
83						'tl;dv API key used in the x-api-key header for API requests.',
84				},
85				webhookSecret: {
86					type: 'string',
87					description:
88						'Optional shared secret for webhook verification if configured in your environment.',
89				},
90			},
91		},
92		example: {
93			apiKey: 'tldv-***',
94			webhookSecret: 'tldv-webhook-secret',
95		},
96	},
97	healthCheck: {
98		method: 'ping',
99		timeoutMs: 6000,
100	},
101	docsUrl: 'https://doc.tldv.io/index.html',
102	byokSetup: {
103		setupInstructions:
104			'Generate a tl;dv API key and optionally configure MeetingReady/TranscriptReady webhooks.',
105		keyRotationSupported: false,
106		quotaTrackingSupported: false,
107	},
108});