1import { defineCommand } from '@lssm-tech/lib.contracts-spec/operations';
2import {
3	ConnectionModel,
4	CreateConnectionInputModel,
5} from './connection.schema';
6
7export const CreateConnectionContract = defineCommand({
8	meta: {
9		key: 'integration.connection.create',
10		version: '1.0.0',
11		stability: 'stable',
12		owners: ['@example.integration-hub'],
13		tags: ['integration', 'connection', 'create'],
14		description: 'Create a connection to an external system.',
15		goal: 'Authenticate with external systems.',
16		context: 'Connection setup.',
17	},
18	io: { input: CreateConnectionInputModel, output: ConnectionModel },
19	policy: { auth: 'user' },
20	sideEffects: {
21		emits: [
22			{
23				key: 'integration.connection.created',
24				version: '1.0.0',
25				when: 'Connection created',
26				payload: ConnectionModel,
27			},
28		],
29		audit: ['integration.connection.created'],
30	},
31	acceptance: {
32		scenarios: [
33			{
34				key: 'create-connection-happy-path',
35				given: ['User is authenticated'],
36				when: ['User creates connection with valid credentials'],
37				then: ['Connection is created', 'ConnectionCreated event is emitted'],
38			},
39		],
40		examples: [
41			{
42				key: 'connect-payments',
43				input: {
44					name: 'Stripe Prod',
45					integrationId: 'spec_payments_stripe',
46					credentials: { clientId: 'xxx' },
47				},
48				output: {
49					id: 'conn-123',
50					status: 'connected',
51					connectedAt: '2025-01-01T12:00:00Z',
52				},
53			},
54		],
55	},
56});