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	transports: [
16		{ type: 'rest', baseUrl: 'https://api.powens.com' },
17		{
18			type: 'webhook',
19			inbound: {
20				signatureHeader: 'x-powens-signature',
21				signingAlgorithm: 'hmac-sha256',
22			},
23		},
24	],
25	preferredTransport: 'rest',
26	supportedAuthMethods: [
27		{
28			type: 'oauth2',
29			grantType: 'authorization_code',
30			authorizationUrl: 'https://auth.powens.com/authorize',
31			tokenUrl: 'https://auth.powens.com/token',
32			scopes: ['accounts:read', 'transactions:read', 'balances:read'],
33		},
34	],
35	capabilities: {
36		provides: [
37			{ key: 'openbanking.accounts.read', version: '1.0.0' },
38			{ key: 'openbanking.transactions.read', version: '1.0.0' },
39			{ key: 'openbanking.balances.read', version: '1.0.0' },
40		],
41	},
42	configSchema: {
43		schema: {
44			type: 'object',
45			required: ['environment'],
46			properties: {
47				environment: {
48					type: 'string',
49					enum: ['sandbox', 'production'],
50					description:
51						'Powens environment to target. Sandbox uses Powens test API base URL, production uses live endpoints.',
52				},
53				baseUrl: {
54					type: 'string',
55					description:
56						'Optional override for the Powens API base URL. Defaults to Powens environment defaults.',
57				},
58				region: {
59					type: 'string',
60					description:
61						'Optional Powens region identifier when targeting a specific data residency cluster.',
62				},
63				pollingIntervalMs: {
64					type: 'number',
65					description:
66						'Optional custom polling interval in milliseconds for background sync jobs (defaults to platform standard).',
67				},
68			},
69		},
70		example: {
71			environment: 'sandbox',
72			baseUrl: 'https://api-sandbox.powens.com/v2',
73			region: 'eu-west-1',
74			pollingIntervalMs: 300000,
75		},
76	},
77	secretSchema: {
78		schema: {
79			type: 'object',
80			required: ['clientId', 'clientSecret'],
81			properties: {
82				clientId: {
83					type: 'string',
84					description:
85						'Powens OAuth client identifier obtained from the Powens Console (BYOK project).',
86				},
87				clientSecret: {
88					type: 'string',
89					description:
90						'Powens OAuth client secret used to exchange for access tokens.',
91				},
92				apiKey: {
93					type: 'string',
94					description:
95						'Optional Powens API key (if the tenant project exposes a dedicated API token).',
96				},
97				webhookSecret: {
98					type: 'string',
99					description:
100						'Optional webhook signing secret used to verify Powens webhook payloads.',
101				},
102			},
103		},
104		example: {
105			clientId: 'powens-client-id',
106			clientSecret: 'powens-client-secret',
107			apiKey: 'powens-api-key',
108			webhookSecret: 'powens-webhook-secret',
109		},
110	},
111	healthCheck: {
112		method: 'ping',
113		timeoutMs: 8000,
114	},
115	docsUrl: 'https://docs.powens.com/',
116	constraints: {
117		rateLimit: {
118			rph: 10000,
119			rpm: 600,
120		},
121	},
122	byokSetup: {
123		setupInstructions:
124			'Create a Powens BYOK project, generate OAuth credentials, and optionally configure webhook delivery for account/transaction updates.',
125		requiredScopes: ['accounts:read', 'transactions:read', 'balances:read'],
126		keyRotationSupported: false,
127		quotaTrackingSupported: false,
128	},
129});