1export const powensIntegrationSpec = defineIntegration({
2  meta: {
3    key: 'openbanking.powens',
4    version: '1.0.0',
5    category: 'open-banking',
6    title: 'Powens Open Banking (Read)',
7    description:
8      'Read-only Open Banking integration powered by Powens, exposing accounts, transactions, and balances.',
9    domain: 'finance',
10    owners: ['platform.finance'],
11    tags: ['open-banking', 'powens', 'finance'],
12    stability: StabilityEnum.Experimental,
13  },
14  supportedModes: ['byok'],
15  capabilities: {
16    provides: [
17      { key: 'openbanking.accounts.read', version: '1.0.0' },
18      { key: 'openbanking.transactions.read', version: '1.0.0' },
19      { key: 'openbanking.balances.read', version: '1.0.0' },
20    ],
21  },
22  configSchema: {
23    schema: {
24      type: 'object',
25      required: ['environment'],
26      properties: {
27        environment: {
28          type: 'string',
29          enum: ['sandbox', 'production'],
30          description:
31            'Powens environment to target. Sandbox uses Powens test API base URL, production uses live endpoints.',
32        },
33        baseUrl: {
34          type: 'string',
35          description:
36            'Optional override for the Powens API base URL. Defaults to Powens environment defaults.',
37        },
38        region: {
39          type: 'string',
40          description:
41            'Optional Powens region identifier when targeting a specific data residency cluster.',
42        },
43        pollingIntervalMs: {
44          type: 'number',
45          description:
46            'Optional custom polling interval in milliseconds for background sync jobs (defaults to platform standard).',
47        },
48      },
49    },
50    example: {
51      environment: 'sandbox',
52      baseUrl: 'https://api-sandbox.powens.com/v2',
53      region: 'eu-west-1',
54      pollingIntervalMs: 300000,
55    },
56  },
57  secretSchema: {
58    schema: {
59      type: 'object',
60      required: ['clientId', 'clientSecret'],
61      properties: {
62        clientId: {
63          type: 'string',
64          description:
65            'Powens OAuth client identifier obtained from the Powens Console (BYOK project).',
66        },
67        clientSecret: {
68          type: 'string',
69          description:
70            'Powens OAuth client secret used to exchange for access tokens.',
71        },
72        apiKey: {
73          type: 'string',
74          description:
75            'Optional Powens API key (if the tenant project exposes a dedicated API token).',
76        },
77        webhookSecret: {
78          type: 'string',
79          description:
80            'Optional webhook signing secret used to verify Powens webhook payloads.',
81        },
82      },
83    },
84    example: {
85      clientId: 'powens-client-id',
86      clientSecret: 'powens-client-secret',
87      apiKey: 'powens-api-key',
88      webhookSecret: 'powens-webhook-secret',
89    },
90  },
91  healthCheck: {
92    method: 'ping',
93    timeoutMs: 8000,
94  },
95  docsUrl: 'https://docs.powens.com/',
96  constraints: {
97    rateLimit: {
98      rph: 10000,
99      rpm: 600,
100    },
101  },
102  byokSetup: {
103    setupInstructions:
104      'Create a Powens BYOK project, generate OAuth credentials, and optionally configure webhook delivery for account/transaction updates.',
105    requiredScopes: ['accounts:read', 'transactions:read', 'balances:read'],
106  },
107});