1export const gcsStorageIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'storage.gcs',
4		version: '1.0.0',
5		category: 'storage',
6		title: 'Google Cloud Storage Buckets',
7		description:
8			'Google Cloud Storage integration for object storage and retrieval.',
9		domain: 'infrastructure',
10		owners: ['platform.infrastructure'],
11		tags: ['storage', 'gcs', 'google-cloud'],
12		stability: StabilityEnum.Beta,
13	},
14	supportedModes: ['managed', 'byok'],
15	transports: [
16		{ type: 'rest', baseUrl: 'https://storage.googleapis.com' },
17		{ type: 'sdk', packageName: '@google-cloud/storage', minVersion: '7.0.0' },
18	],
19	preferredTransport: 'sdk',
20	supportedAuthMethods: [
21		{ type: 'service-account', credentialFormat: 'json-key' },
22		{ type: 'api-key' },
23	],
24	capabilities: {
25		provides: [{ key: 'storage.objects', version: '1.0.0' }],
26	},
27	configSchema: {
28		schema: {
29			type: 'object',
30			required: ['bucket'],
31			properties: {
32				bucket: {
33					type: 'string',
34					description: 'Primary bucket name used for storing objects.',
35				},
36				prefix: {
37					type: 'string',
38					description: 'Optional prefix applied to object keys.',
39				},
40			},
41		},
42		example: {
43			bucket: 'pfo-tenant-assets',
44			prefix: 'documents/',
45		},
46	},
47	secretSchema: {
48		schema: {
49			type: 'object',
50			properties: {
51				type: {
52					type: 'string',
53					description:
54						'Service account type field from Google credentials JSON (if provided).',
55				},
56				client_email: { type: 'string' },
57				private_key: { type: 'string' },
58				project_id: { type: 'string' },
59			},
60		},
61		example: {
62			type: 'service_account',
63			client_email: 'svc-account@example.iam.gserviceaccount.com',
64			private_key: '-----BEGIN PRIVATE KEY-----...',
65			project_id: 'example-project',
66		},
67	},
68	healthCheck: {
69		method: 'ping',
70		timeoutMs: 4000,
71	},
72	docsUrl: 'https://cloud.google.com/storage/docs/apis',
73	constraints: {
74		quotas: {
75			storageGb: 5120,
76		},
77	},
78	byokSetup: {
79		setupInstructions:
80			'Create a Google Cloud service account with Storage Object Admin role and upload the JSON credentials to the secret store.',
81		keyRotationSupported: false,
82		quotaTrackingSupported: true,
83	},
84});