1export const jiraIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'project-management.jira',
4		version: '1.0.0',
5		category: 'project-management',
6		title: 'Jira Cloud',
7		description: 'Jira Cloud integration for creating and tracking work items.',
8		domain: 'productivity',
9		owners: ['@platform.integrations'],
10		tags: ['project-management', 'jira'],
11		stability: StabilityEnum.Beta,
12	},
13	supportedModes: ['managed', 'byok'],
14	transports: [
15		{ type: 'rest' },
16		{
17			type: 'webhook',
18			inbound: {
19				signatureHeader: 'x-atlassian-webhook-signature',
20				signingAlgorithm: 'hmac-sha256',
21			},
22		},
23	],
24	preferredTransport: 'rest',
25	supportedAuthMethods: [
26		{ type: 'basic' },
27		{
28			type: 'oauth2',
29			grantType: 'authorization_code',
30			authorizationUrl: 'https://auth.atlassian.com/authorize',
31			tokenUrl: 'https://auth.atlassian.com/oauth/token',
32			scopes: ['read:jira-work', 'write:jira-work'],
33		},
34	],
35	capabilities: {
36		provides: [{ key: 'project-management.work-items', version: '1.0.0' }],
37	},
38	configSchema: {
39		schema: {
40			type: 'object',
41			required: ['siteUrl'],
42			properties: {
43				siteUrl: {
44					type: 'string',
45					description:
46						'Jira Cloud site URL (e.g., https://acme.atlassian.net).',
47				},
48				projectKey: {
49					type: 'string',
50					description: 'Default Jira project key for new issues.',
51				},
52				issueType: {
53					type: 'string',
54					description: 'Default Jira issue type (e.g., Task, Story).',
55				},
56				defaultLabels: {
57					type: 'array',
58					items: { type: 'string' },
59					description: 'Labels applied to each issue by default.',
60				},
61				issueTypeMap: {
62					type: 'object',
63					additionalProperties: { type: 'string' },
64					description:
65						'Optional mapping from work item types to Jira issue types.',
66				},
67			},
68		},
69		example: {
70			siteUrl: 'https://acme.atlassian.net',
71			projectKey: 'PM',
72			issueType: 'Task',
73		},
74	},
75	secretSchema: {
76		schema: {
77			type: 'object',
78			required: ['email', 'apiToken'],
79			properties: {
80				email: {
81					type: 'string',
82					description: 'Jira account email used for API token auth.',
83				},
84				apiToken: {
85					type: 'string',
86					description: 'Jira Cloud API token for the account.',
87				},
88			},
89		},
90		example: {
91			email: 'user@acme.com',
92			apiToken: 'jira_api_token',
93		},
94	},
95	healthCheck: {
96		method: 'custom',
97		timeoutMs: 4000,
98	},
99	docsUrl: 'https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/',
100	constraints: {},
101	byokSetup: {
102		setupInstructions:
103			'Create a Jira API token and store it with the associated account email.',
104		keyRotationSupported: false,
105		quotaTrackingSupported: false,
106	},
107});