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 RecordUsageContract = defineCommand({
14	meta: {
15		key: 'saas.billing.usage.record',
16		version: '1.0.0',
17		stability: 'stable',
18		owners: ['@example.saas-boilerplate'],
19		tags: ['saas', 'billing', 'usage'],
20		description: 'Record usage of a metered feature.',
21		goal: 'Track feature usage for billing.',
22		context: 'Called by services when metered features are used.',
23	},
24	io: {
25		input: RecordUsageInputModel,
26		output: RecordUsageOutputModel,
27	},
28	policy: {
29		auth: 'user',
30	},
31	sideEffects: {
32		emits: [
33			{
34				key: 'billing.usage.recorded',
35				version: '1.0.0',
36				when: 'Usage is recorded',
37				payload: UsageRecordedPayloadModel,
38			},
39		],
40	},
41	acceptance: {
42		scenarios: [
43			{
44				key: 'record-usage-happy-path',
45				given: ['Organization exists'],
46				when: ['System records feature usage'],
47				then: ['Usage is recorded'],
48			},
49		],
50		examples: [
51			{
52				key: 'record-api-call',
53				input: { feature: 'api_calls', quantity: 1, idempotencyKey: 'abc-123' },
54				output: { recorded: true, currentUsage: 100 },
55			},
56		],
57	},
58});