@contractspec/example.saas-boilerplate 3.7.6 → 3.8.2

package/src/billing/billing.event.ts

@@ -1,108 +1,108 @@
-import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';
 import { defineEvent } from '@contractspec/lib.contracts-spec';
+import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
 
 /**
  * Payload when feature usage is recorded.
  */
 const UsageRecordedPayload = defineSchemaModel({
-  name: 'UsageRecordedPayload',
-  description: 'Payload when feature usage is recorded',
-  fields: {
-    organizationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    quantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    billingPeriod: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-    recordedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-  },
+	name: 'UsageRecordedPayload',
+	description: 'Payload when feature usage is recorded',
+	fields: {
+		organizationId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+		feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		quantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+		billingPeriod: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+		recordedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+	},
 });
 
 /**
  * Payload when usage limit is reached.
  */
 const UsageLimitReachedPayload = defineSchemaModel({
-  name: 'UsageLimitReachedPayload',
-  description: 'Payload when usage limit is reached',
-  fields: {
-    organizationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    currentUsage: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
-    reachedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-  },
+	name: 'UsageLimitReachedPayload',
+	description: 'Payload when usage limit is reached',
+	fields: {
+		organizationId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+		feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+		currentUsage: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+		reachedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+	},
 });
 
 /**
  * Payload when subscription status changes.
  */
 const SubscriptionChangedPayload = defineSchemaModel({
-  name: 'SubscriptionChangedPayload',
-  description: 'Payload when subscription status changes',
-  fields: {
-    organizationId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-    previousPlan: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    newPlan: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    previousStatus: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: true,
-    },
-    newStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    changedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
-  },
+	name: 'SubscriptionChangedPayload',
+	description: 'Payload when subscription status changes',
+	fields: {
+		organizationId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+		previousPlan: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+		newPlan: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		previousStatus: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true,
+		},
+		newStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		changedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+	},
 });
 
 /**
  * Event: Feature usage has been recorded.
  */
 export const UsageRecordedEvent = defineEvent({
-  meta: {
-    key: 'billing.usage.recorded',
-    version: '1.0.0',
-    description: 'Feature usage has been recorded.',
-    stability: 'stable',
-    owners: ['@saas-team'],
-    tags: ['billing', 'usage', 'recorded'],
-  },
-  payload: UsageRecordedPayload,
+	meta: {
+		key: 'billing.usage.recorded',
+		version: '1.0.0',
+		description: 'Feature usage has been recorded.',
+		stability: 'stable',
+		owners: ['@saas-team'],
+		tags: ['billing', 'usage', 'recorded'],
+	},
+	payload: UsageRecordedPayload,
 });
 
 /**
  * Event: Usage limit has been reached for a feature.
  */
 export const UsageLimitReachedEvent = defineEvent({
-  meta: {
-    key: 'billing.limit.reached',
-    version: '1.0.0',
-    description: 'Usage limit has been reached for a feature.',
-    stability: 'stable',
-    owners: ['@saas-team'],
-    tags: ['billing', 'limit', 'reached'],
-  },
-  payload: UsageLimitReachedPayload,
+	meta: {
+		key: 'billing.limit.reached',
+		version: '1.0.0',
+		description: 'Usage limit has been reached for a feature.',
+		stability: 'stable',
+		owners: ['@saas-team'],
+		tags: ['billing', 'limit', 'reached'],
+	},
+	payload: UsageLimitReachedPayload,
 });
 
 /**
  * Event: Subscription status has changed.
  */
 export const SubscriptionChangedEvent = defineEvent({
-  meta: {
-    key: 'billing.subscription.changed',
-    version: '1.0.0',
-    description: 'Subscription status has changed.',
-    stability: 'stable',
-    owners: ['@saas-team'],
-    tags: ['billing', 'subscription', 'changed'],
-  },
-  payload: SubscriptionChangedPayload,
+	meta: {
+		key: 'billing.subscription.changed',
+		version: '1.0.0',
+		description: 'Subscription status has changed.',
+		stability: 'stable',
+		owners: ['@saas-team'],
+		tags: ['billing', 'subscription', 'changed'],
+	},
+	payload: SubscriptionChangedPayload,
 });

package/src/billing/billing.handler.ts

@@ -5,133 +5,133 @@ import { MOCK_SUBSCRIPTION, MOCK_USAGE_SUMMARY } from '../shared/mock-data';
 
 // Types inferred from contract schemas
 export interface Subscription {
-  id: string;
-  organizationId: string;
-  planId: string;
-  planName: string;
-  status: 'ACTIVE' | 'TRIALING' | 'PAST_DUE' | 'CANCELED' | 'UNPAID';
-  currentPeriodStart: Date;
-  currentPeriodEnd: Date;
-  limits: {
-    projects: number;
-    users: number;
-    storage: number;
-    apiCalls: number;
-  };
-  usage: {
-    projects: number;
-    users: number;
-    storage: number;
-    apiCalls: number;
-  };
+	id: string;
+	organizationId: string;
+	planId: string;
+	planName: string;
+	status: 'ACTIVE' | 'TRIALING' | 'PAST_DUE' | 'CANCELED' | 'UNPAID';
+	currentPeriodStart: Date;
+	currentPeriodEnd: Date;
+	limits: {
+		projects: number;
+		users: number;
+		storage: number;
+		apiCalls: number;
+	};
+	usage: {
+		projects: number;
+		users: number;
+		storage: number;
+		apiCalls: number;
+	};
 }
 
 export interface UsageSummary {
-  organizationId: string;
-  period: string;
-  apiCalls: {
-    total: number;
-    limit: number;
-    percentUsed: number;
-  };
-  storage: {
-    totalGb: number;
-    limitGb: number;
-    percentUsed: number;
-  };
-  activeProjects: number;
-  activeUsers: number;
-  breakdown: {
-    date: string;
-    apiCalls: number;
-    storageGb: number;
-  }[];
+	organizationId: string;
+	period: string;
+	apiCalls: {
+		total: number;
+		limit: number;
+		percentUsed: number;
+	};
+	storage: {
+		totalGb: number;
+		limitGb: number;
+		percentUsed: number;
+	};
+	activeProjects: number;
+	activeUsers: number;
+	breakdown: {
+		date: string;
+		apiCalls: number;
+		storageGb: number;
+	}[];
 }
 
 export interface RecordUsageInput {
-  metric: string;
-  quantity: number;
-  timestamp?: Date;
-  metadata?: Record<string, unknown>;
+	metric: string;
+	quantity: number;
+	timestamp?: Date;
+	metadata?: Record<string, unknown>;
 }
 
 export interface CheckFeatureAccessInput {
-  feature: string;
+	feature: string;
 }
 
 export interface CheckFeatureAccessOutput {
-  allowed: boolean;
-  reason?:
-    | 'PLAN_LIMIT'
-    | 'FEATURE_NOT_INCLUDED'
-    | 'QUOTA_EXCEEDED'
-    | 'SUBSCRIPTION_INACTIVE';
-  currentUsage?: number;
-  limit?: number;
+	allowed: boolean;
+	reason?:
+		| 'PLAN_LIMIT'
+		| 'FEATURE_NOT_INCLUDED'
+		| 'QUOTA_EXCEEDED'
+		| 'SUBSCRIPTION_INACTIVE';
+	currentUsage?: number;
+	limit?: number;
 }
 
 /**
  * Mock handler for GetSubscriptionContract.
  */
 export async function mockGetSubscriptionHandler(): Promise<Subscription> {
-  return MOCK_SUBSCRIPTION;
+	return MOCK_SUBSCRIPTION;
 }
 
 /**
  * Mock handler for GetUsageSummaryContract.
  */
 export async function mockGetUsageSummaryHandler(input: {
-  period?: string;
+	period?: string;
 }): Promise<UsageSummary> {
-  return {
-    ...MOCK_USAGE_SUMMARY,
-    period: input.period ?? 'current_month',
-  };
+	return {
+		...MOCK_USAGE_SUMMARY,
+		period: input.period ?? 'current_month',
+	};
 }
 
 /**
  * Mock handler for RecordUsageContract.
  */
 export async function mockRecordUsageHandler(
-  input: RecordUsageInput
+	input: RecordUsageInput
 ): Promise<{ recorded: boolean; newTotal: number }> {
-  const currentUsage = MOCK_USAGE_SUMMARY.apiCalls.total;
-  const newTotal = currentUsage + input.quantity;
+	const currentUsage = MOCK_USAGE_SUMMARY.apiCalls.total;
+	const newTotal = currentUsage + input.quantity;
 
-  return {
-    recorded: true,
-    newTotal,
-  };
+	return {
+		recorded: true,
+		newTotal,
+	};
 }
 
 /**
  * Mock handler for CheckFeatureAccessContract.
  */
 export async function mockCheckFeatureAccessHandler(
-  input: CheckFeatureAccessInput
+	input: CheckFeatureAccessInput
 ): Promise<CheckFeatureAccessOutput> {
-  const { feature } = input;
+	const { feature } = input;
 
-  const featureMap: Record<string, CheckFeatureAccessOutput> = {
-    custom_domains: {
-      allowed: true,
-    },
-    api_access: {
-      allowed: true,
-      currentUsage: MOCK_USAGE_SUMMARY.apiCalls.total,
-      limit: MOCK_USAGE_SUMMARY.apiCalls.limit,
-    },
-    advanced_analytics: {
-      allowed: false,
-      reason: 'FEATURE_NOT_INCLUDED',
-    },
-    unlimited_projects: {
-      allowed: false,
-      reason: 'PLAN_LIMIT',
-      currentUsage: MOCK_SUBSCRIPTION.usage.projects,
-      limit: MOCK_SUBSCRIPTION.limits.projects,
-    },
-  };
+	const featureMap: Record<string, CheckFeatureAccessOutput> = {
+		custom_domains: {
+			allowed: true,
+		},
+		api_access: {
+			allowed: true,
+			currentUsage: MOCK_USAGE_SUMMARY.apiCalls.total,
+			limit: MOCK_USAGE_SUMMARY.apiCalls.limit,
+		},
+		advanced_analytics: {
+			allowed: false,
+			reason: 'FEATURE_NOT_INCLUDED',
+		},
+		unlimited_projects: {
+			allowed: false,
+			reason: 'PLAN_LIMIT',
+			currentUsage: MOCK_SUBSCRIPTION.usage.projects,
+			limit: MOCK_SUBSCRIPTION.limits.projects,
+		},
+	};
 
-  return featureMap[feature] ?? { allowed: true };
+	return featureMap[feature] ?? { allowed: true };
 }