1export const notionIntegrationSpec = defineIntegration({
2	meta: {
3		key: 'project-management.notion',
4		version: '1.0.0',
5		category: 'project-management',
6		title: 'Notion',
7		description:
8			'Notion integration for creating shared project summaries and task entries.',
9		domain: 'productivity',
10		owners: ['@platform.integrations'],
11		tags: ['project-management', 'notion'],
12		stability: StabilityEnum.Beta,
13	},
14	supportedModes: ['managed', 'byok'],
15	transports: [
16		{
17			type: 'rest',
18			baseUrl: 'https://api.notion.com',
19			apiVersionHeader: 'Notion-Version',
20		},
21	],
22	preferredTransport: 'rest',
23	supportedAuthMethods: [
24		{ type: 'bearer' },
25		{
26			type: 'oauth2',
27			grantType: 'authorization_code',
28			authorizationUrl: 'https://api.notion.com/v1/oauth/authorize',
29			tokenUrl: 'https://api.notion.com/v1/oauth/token',
30			scopes: [],
31		},
32	],
33	versionPolicy: {
34		currentVersion: '2022-06-28',
35		supportedVersions: [{ version: '2022-06-28', status: 'stable' }],
36		versionHeader: 'Notion-Version',
37	},
38	capabilities: {
39		provides: [{ key: 'project-management.work-items', version: '1.0.0' }],
40	},
41	configSchema: {
42		schema: {
43			type: 'object',
44			properties: {
45				databaseId: {
46					type: 'string',
47					description: 'Optional Notion database ID to store tasks.',
48				},
49				summaryParentPageId: {
50					type: 'string',
51					description: 'Optional parent page ID for summary pages.',
52				},
53				titleProperty: {
54					type: 'string',
55					description: 'Database title property name (defaults to "Name").',
56				},
57				statusProperty: {
58					type: 'string',
59					description: 'Database status/select property name.',
60				},
61				priorityProperty: {
62					type: 'string',
63					description: 'Database priority/select property name.',
64				},
65				tagsProperty: {
66					type: 'string',
67					description: 'Database multi-select tags property name.',
68				},
69				dueDateProperty: {
70					type: 'string',
71					description: 'Database date property name for due dates.',
72				},
73				descriptionProperty: {
74					type: 'string',
75					description: 'Database rich-text property for descriptions.',
76				},
77			},
78		},
79		example: {
80			databaseId: 'xxxxxxxxxxxxxxxx',
81			summaryParentPageId: 'yyyyyyyyyyyyyyyy',
82			titleProperty: 'Name',
83			statusProperty: 'Status',
84		},
85	},
86	secretSchema: {
87		schema: {
88			type: 'object',
89			required: ['apiKey'],
90			properties: {
91				apiKey: {
92					type: 'string',
93					description: 'Notion integration secret token.',
94				},
95			},
96		},
97		example: {
98			apiKey: 'secret_notion_token',
99		},
100	},
101	healthCheck: {
102		method: 'custom',
103		timeoutMs: 4000,
104	},
105	docsUrl: 'https://developers.notion.com',
106	constraints: {},
107	byokSetup: {
108		setupInstructions:
109			'Create a Notion internal integration, share the target database/page with it, and store the secret token.',
110		keyRotationSupported: false,
111		quotaTrackingSupported: false,
112	},
113});