1import { defineCommand, defineQuery } from '@lssm-tech/lib.contracts-spec';
2import {
3	CheckFeatureAccessInputModel,
4	CheckFeatureAccessOutputModel,
5	GetUsageSummaryInputModel,
6	GetUsageSummaryOutputModel,
7	RecordUsageInputModel,
8	RecordUsageOutputModel,
9	SubscriptionModel,
10	UsageRecordedPayloadModel,
11} from './billing.schema';
12
13export const GetUsageSummaryContract = defineQuery({
14	meta: {
15		key: 'saas.billing.usage.summary',
16		version: '1.0.0',
17		stability: 'stable',
18		owners: ['@example.saas-boilerplate'],
19		tags: ['saas', 'billing', 'usage'],
20		description: 'Get usage summary for the current billing period.',
21		goal: 'Show usage vs limits.',
22		context: 'Billing page, usage dashboards.',
23	},
24	io: {
25		input: GetUsageSummaryInputModel,
26		output: GetUsageSummaryOutputModel,
27	},
28	policy: {
29		auth: 'user',
30	},
31	acceptance: {
32		scenarios: [
33			{
34				key: 'get-usage-happy-path',
35				given: ['Organization has usage history'],
36				when: ['User requests usage summary'],
37				then: ['Usage metrics are returned'],
38			},
39		],
40		examples: [
41			{
42				key: 'get-current-usage',
43				input: { period: 'current' },
44				output: { features: [{ name: 'api_calls', used: 100, limit: 1000 }] },
45			},
46		],
47	},
48});