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  capabilities: {
15    provides: [{ key: 'email.transactional', version: '1.0.0' }],
16    requires: [
17      {
18        key: 'platform.webhooks',
19        optional: true,
20        reason: 'Optional for inbound bounce handling',
21      },
22    ],
23  },
24  configSchema: {
25    schema: {
26      type: 'object',
27      properties: {
28        messageStream: {
29          type: 'string',
30          description:
31            'Optional message stream identifier (e.g., transactional).',
32        },
33        fromEmail: {
34          type: 'string',
35          description: 'Default From address used for outbound messages.',
36        },
37      },
38    },
39    example: {
40      messageStream: 'outbound',
41      fromEmail: 'notifications@example.com',
42    },
43  },
44  secretSchema: {
45    schema: {
46      type: 'object',
47      required: ['serverToken'],
48      properties: {
49        serverToken: {
50          type: 'string',
51          description: 'Server token for the Postmark account.',
52        },
53      },
54    },
55    example: {
56      serverToken: 'server-***',
57    },
58  },
59  healthCheck: {
60    method: 'ping',
61    timeoutMs: 3000,
62  },
63  docsUrl: 'https://postmarkapp.com/developer',
64  constraints: {
65    rateLimit: {
66      rpm: 500,
67    },
68  },
69  byokSetup: {
70    setupInstructions:
71      'Create a Postmark server token with outbound send permissions and configure allowed from addresses.',
72  },
73});