1/**
2 * Files Feature Module Specification
3 *
4 * Defines the feature module for file management capabilities.
5 */
6import { defineFeature } from '@lssm-tech/lib.contracts-spec';
7
8/**
9 * Files feature module that bundles file storage,
10 * attachments, and media processing capabilities.
11 */
12export const FilesFeature = defineFeature({
13	meta: {
14		key: 'files',
15		version: '1.0.0',
16		title: 'File Management',
17		description:
18			'File storage, attachments, and media processing with presigned URLs',
19		domain: 'platform',
20		owners: ['@platform.files'],
21		tags: ['files', 'upload', 'attachments', 'storage'],
22		stability: 'stable',
23	},
24
25	// All contract operations included in this feature
26	operations: [
27		// File CRUD operations
28		{ key: 'file.upload', version: '1.0.0' },
29		{ key: 'file.update', version: '1.0.0' },
30		{ key: 'file.delete', version: '1.0.0' },
31		{ key: 'file.get', version: '1.0.0' },
32		{ key: 'file.list', version: '1.0.0' },
33		{ key: 'file.downloadUrl', version: '1.0.0' },
34		{ key: 'file.presignedUrl.create', version: '1.0.0' },
35
36		// Version operations
37		{ key: 'file.version.create', version: '1.0.0' },
38		{ key: 'file.version.list', version: '1.0.0' },
39
40		// Attachment operations
41		{ key: 'attachment.attach', version: '1.0.0' },
42		{ key: 'attachment.detach', version: '1.0.0' },
43		{ key: 'attachment.list', version: '1.0.0' },
44	],
45
46	// Events emitted by this feature
47	events: [
48		// File events
49		{ key: 'file.uploaded', version: '1.0.0' },
50		{ key: 'file.updated', version: '1.0.0' },
51		{ key: 'file.deleted', version: '1.0.0' },
52		{ key: 'file.version_created', version: '1.0.0' },
53
54		// Attachment events
55		{ key: 'attachment.attached', version: '1.0.0' },
56		{ key: 'attachment.detached', version: '1.0.0' },
57
58		// Upload session events
59		{ key: 'upload.session_started', version: '1.0.0' },
60		{ key: 'upload.session_completed', version: '1.0.0' },
61	],
62
63	// No presentations for this library feature
64	presentations: [],
65	opToPresentation: [],
66	presentationsTargets: [],
67
68	// Capability definitions
69	capabilities: {
70		provides: [
71			{ key: 'files', version: '1.0.0' },
72			{ key: 'attachments', version: '1.0.0' },
73		],
74		requires: [{ key: 'identity', version: '1.0.0' }],
75	},
76});
77