1/**
2 * SaaS Boilerplate Feature Module Specification
3 *
4 * Defines the feature module for the SaaS application foundation.
5 */
6import { defineFeature } from '@lssm-tech/lib.contracts-spec';
7import { SaasVisualizationRefs } from './visualizations';
8
9/**
10 * SaaS Boilerplate feature module that bundles project management,
11 * billing, and settings operations into an installable feature.
12 */
13export const SaasBoilerplateFeature = defineFeature({
14	meta: {
15		key: 'saas-boilerplate',
16		title: 'SaaS Boilerplate',
17		description:
18			'SaaS application foundation with projects, billing, and settings',
19		domain: 'saas',
20		owners: ['@saas-team'],
21		tags: ['saas', 'projects', 'billing'],
22		stability: 'experimental',
23		version: '1.0.0',
24	},
25
26	// All contract operations included in this feature
27	operations: [
28		// Project operations
29		{ key: 'saas.project.create', version: '1.0.0' },
30		{ key: 'saas.project.get', version: '1.0.0' },
31		{ key: 'saas.project.update', version: '1.0.0' },
32		{ key: 'saas.project.delete', version: '1.0.0' },
33		{ key: 'saas.project.list', version: '1.0.0' },
34
35		// Billing operations
36		{ key: 'saas.billing.subscription.get', version: '1.0.0' },
37		{ key: 'saas.billing.usage.record', version: '1.0.0' },
38		{ key: 'saas.billing.usage.summary', version: '1.0.0' },
39		{ key: 'saas.billing.feature.check', version: '1.0.0' },
40	],
41
42	// Events emitted by this feature
43	events: [
44		// Project events
45		{ key: 'project.created', version: '1.0.0' },
46		{ key: 'project.updated', version: '1.0.0' },
47		{ key: 'project.deleted', version: '1.0.0' },
48		{ key: 'project.archived', version: '1.0.0' },
49
50		// Billing events
51		{ key: 'billing.usage.recorded', version: '1.0.0' },
52		{ key: 'billing.subscription.changed', version: '1.0.0' },
53		{ key: 'billing.limit.reached', version: '1.0.0' },
54	],
55
56	// Presentations associated with this feature
57	presentations: [
58		{ key: 'saas.dashboard', version: '1.0.0' },
59		{ key: 'saas.project.list', version: '1.0.0' },
60		{ key: 'saas.project.detail', version: '1.0.0' },
61		{ key: 'saas.billing.subscription', version: '1.0.0' },
62		{ key: 'saas.billing.usage', version: '1.0.0' },
63		{ key: 'saas.settings', version: '1.0.0' },
64	],
65
66	// Link operations to their primary presentations
67	opToPresentation: [
68		{
69			op: { key: 'saas.project.list', version: '1.0.0' },
70			pres: { key: 'saas.project.list', version: '1.0.0' },
71		},
72		{
73			op: { key: 'saas.project.get', version: '1.0.0' },
74			pres: { key: 'saas.project.detail', version: '1.0.0' },
75		},
76		{
77			op: { key: 'saas.billing.subscription.get', version: '1.0.0' },
78			pres: { key: 'saas.billing.subscription', version: '1.0.0' },
79		},
80		{
81			op: { key: 'saas.billing.usage.summary', version: '1.0.0' },
82			pres: { key: 'saas.billing.usage', version: '1.0.0' },
83		},
84	],
85
86	// Target requirements for multi-surface rendering
87	presentationsTargets: [
88		{ key: 'saas.dashboard', version: '1.0.0', targets: ['react', 'markdown'] },
89		{
90			key: 'saas.project.list',
91			version: '1.0.0',
92			targets: ['react', 'markdown', 'application/json'],
93		},
94		{
95			key: 'saas.billing.subscription',
96			version: '1.0.0',
97			targets: ['react', 'markdown'],
98		},
99		{
100			key: 'saas.billing.usage',
101			version: '1.0.0',
102			targets: ['react', 'markdown'],
103		},
104	],
105
106	visualizations: SaasVisualizationRefs,
107
108	// Capability requirements
109	capabilities: {
110		requires: [
111			{ key: 'identity', version: '1.0.0' },
112			{ key: 'audit-trail', version: '1.0.0' },
113			{ key: 'notifications', version: '1.0.0' },
114		],
115	},
116
117	telemetry: [{ key: 'saas-boilerplate.telemetry', version: '1.0.0' }],
118
119	jobs: [{ key: 'saas-boilerplate.job.usage-recording', version: '1.0.0' }],
120
121	docs: [
122		'docs.examples.saas-boilerplate.goal',
123		'docs.examples.saas-boilerplate.usage',
124		'docs.examples.saas-boilerplate.reference',
125		'docs.examples.saas-boilerplate.constraints',
126	],
127});
128