1export const postmarkIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'email.postmark',
4		version: '1.0.0',
5		category: 'email',
6		title: 'Postmark Transactional Email',
7		description: 'Postmark integration for transactional email delivery.',
8		domain: 'communications',
9		owners: ['platform.messaging'],
10		tags: ['email', 'transactional'],
11		stability: StabilityEnum.Stable,
12	},
13	supportedModes: ['managed', 'byok'],
14	transports: [
15		{ type: 'rest', baseUrl: 'https://api.postmarkapp.com' },
16		{
17			type: 'webhook',
18			inbound: {
19				signatureHeader: 'x-postmark-signature',
20				signingAlgorithm: 'hmac-sha256',
21			},
22		},
23	],
24	preferredTransport: 'rest',
25	supportedAuthMethods: [
26		{ type: 'header', headerName: 'X-Postmark-Server-Token' },
27	],
28	capabilities: {
29		provides: [{ key: 'email.transactional', version: '1.0.0' }],
30		requires: [
31			{
32				key: 'platform.webhooks',
33				optional: true,
34				reason: 'Optional for inbound bounce handling',
35			},
36		],
37	},
38	configSchema: {
39		schema: {
40			type: 'object',
41			properties: {
42				messageStream: {
43					type: 'string',
44					description:
45						'Optional message stream identifier (e.g., transactional).',
46				},
47				fromEmail: {
48					type: 'string',
49					description: 'Default From address used for outbound messages.',
50				},
51			},
52		},
53		example: {
54			messageStream: 'outbound',
55			fromEmail: 'notifications@example.com',
56		},
57	},
58	secretSchema: {
59		schema: {
60			type: 'object',
61			required: ['serverToken'],
62			properties: {
63				serverToken: {
64					type: 'string',
65					description: 'Server token for the Postmark account.',
66				},
67			},
68		},
69		example: {
70			serverToken: 'server-***',
71		},
72	},
73	healthCheck: {
74		method: 'ping',
75		timeoutMs: 3000,
76	},
77	docsUrl: 'https://postmarkapp.com/developer',
78	constraints: {
79		rateLimit: {
80			rpm: 500,
81		},
82	},
83	byokSetup: {
84		setupInstructions:
85			'Create a Postmark server token with outbound send permissions and configure allowed from addresses.',
86		keyRotationSupported: true,
87		quotaTrackingSupported: false,
88	},
89});