1export const firefliesIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'meeting-recorder.fireflies',
4		version: '1.0.0',
5		category: 'meeting-recorder',
6		title: 'Fireflies.ai Meeting Recorder',
7		description:
8			'Fireflies GraphQL API for meeting transcripts, metadata, and webhook events.',
9		domain: 'productivity',
10		owners: ['platform.integrations'],
11		tags: ['meeting-recorder', 'fireflies', 'transcripts'],
12		stability: StabilityEnum.Experimental,
13	},
14	supportedModes: ['byok'],
15	transports: [
16		{ type: 'rest', baseUrl: 'https://api.fireflies.ai/graphql' },
17		{
18			type: 'webhook',
19			inbound: {
20				signatureHeader: 'x-fireflies-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-fireflies-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 Fireflies GraphQL endpoint. Defaults to https://api.fireflies.ai/graphql.',
49				},
50				webhookUrl: {
51					type: 'string',
52					description:
53						'Webhook destination URL configured in Fireflies developer settings.',
54				},
55				webhookEvents: {
56					type: 'array',
57					items: { type: 'string' },
58					description:
59						'Webhook events to subscribe to (e.g., Transcription completed).',
60				},
61				transcriptsPageSize: {
62					type: 'number',
63					description: 'Number of transcripts to request per GraphQL query.',
64				},
65			},
66		},
67		example: {
68			baseUrl: 'https://api.fireflies.ai/graphql',
69			webhookUrl: 'https://example.com/webhooks/fireflies',
70			webhookEvents: ['Transcription completed'],
71			transcriptsPageSize: 25,
72		},
73	},
74	secretSchema: {
75		schema: {
76			type: 'object',
77			required: ['apiKey'],
78			properties: {
79				apiKey: {
80					type: 'string',
81					description: 'Fireflies API key for GraphQL requests.',
82				},
83				webhookSecret: {
84					type: 'string',
85					description:
86						'Optional webhook secret used to verify x-hub-signature HMAC payloads.',
87				},
88			},
89		},
90		example: {
91			apiKey: 'fireflies-***',
92			webhookSecret: 'fireflies-webhook-secret',
93		},
94	},
95	healthCheck: {
96		method: 'custom',
97		timeoutMs: 6000,
98	},
99	docsUrl: 'https://docs.fireflies.ai/getting-started/introduction',
100	byokSetup: {
101		setupInstructions:
102			'Create a Fireflies API key and optionally configure webhook settings in Developer Settings.',
103		keyRotationSupported: false,
104		quotaTrackingSupported: false,
105	},
106});