@lssm/example.saas-boilerplate 0.0.0-canary-20251215234153 → 0.0.0-canary-20251216023757

package/src/{handlers/billing.handlers.ts → billing/billing.handler.ts}

@@ -1,7 +1,7 @@
 /**
- * Mock handlers for Billing contracts
+ * Mock handlers for Billing contracts.
  */
-import { MOCK_SUBSCRIPTION, MOCK_USAGE_SUMMARY } from './mock-data';
+import { MOCK_SUBSCRIPTION, MOCK_USAGE_SUMMARY } from '../shared/mock-data';
 
 // Types inferred from contract schemas
 export interface Subscription {
@@ -71,14 +71,14 @@ export interface CheckFeatureAccessOutput {
 }
 
 /**
- * Mock handler for GetSubscriptionContract
+ * Mock handler for GetSubscriptionContract.
  */
 export async function mockGetSubscriptionHandler(): Promise<Subscription> {
   return MOCK_SUBSCRIPTION;
 }
 
 /**
- * Mock handler for GetUsageSummaryContract
+ * Mock handler for GetUsageSummaryContract.
  */
 export async function mockGetUsageSummaryHandler(input: {
   period?: string;
@@ -90,12 +90,11 @@ export async function mockGetUsageSummaryHandler(input: {
 }
 
 /**
- * Mock handler for RecordUsageContract
+ * Mock handler for RecordUsageContract.
  */
 export async function mockRecordUsageHandler(
   input: RecordUsageInput
 ): Promise<{ recorded: boolean; newTotal: number }> {
-  // Simulate recording usage
   const currentUsage = MOCK_USAGE_SUMMARY.apiCalls.total;
   const newTotal = currentUsage + input.quantity;
 
@@ -106,14 +105,13 @@ export async function mockRecordUsageHandler(
 }
 
 /**
- * Mock handler for CheckFeatureAccessContract
+ * Mock handler for CheckFeatureAccessContract.
  */
 export async function mockCheckFeatureAccessHandler(
   input: CheckFeatureAccessInput
 ): Promise<CheckFeatureAccessOutput> {
   const { feature } = input;
 
-  // Simulate feature access checks
   const featureMap: Record<string, CheckFeatureAccessOutput> = {
     custom_domains: {
       allowed: true,
@@ -137,3 +135,4 @@ export async function mockCheckFeatureAccessHandler(
 
   return featureMap[feature] ?? { allowed: true };
 }
+

package/src/{presentations/billing.ts → billing/billing.presentation.ts}

@@ -1,6 +1,3 @@
-/**
- * Billing Presentation Descriptors
- */
 import type { PresentationDescriptorV2 } from '@lssm/lib.contracts';
 
 /**
@@ -49,3 +46,4 @@ export const UsageDashboardPresentation: PresentationDescriptorV2 = {
     flags: ['saas.billing.enabled'],
   },
 };
+

package/src/{contracts/billing.ts → billing/billing.schema.ts}

@@ -1,32 +1,9 @@
-import {
-  defineCommand,
-  defineQuery,
-  defineSchemaModel,
-} from '@lssm/lib.contracts';
-import { ScalarTypeEnum, defineEnum } from '@lssm/lib.schema';
-
-const OWNERS = ['example.saas-boilerplate'] as const;
-
-// ============ Enums (for contract schemas) ============
-// Note: Entity enums for Prisma are defined separately in ../entities
-
-const SubscriptionStatusSchemaEnum = defineEnum('SubscriptionStatus', [
-  'TRIALING',
-  'ACTIVE',
-  'PAST_DUE',
-  'CANCELED',
-  'PAUSED',
-]);
-
-export const FeatureAccessReasonEnum = defineEnum('FeatureAccessReason', [
-  'included',
-  'limit_available',
-  'limit_reached',
-  'not_in_plan',
-]);
-
-// ============ Schemas ============
+import { defineSchemaModel, ScalarTypeEnum } from '@lssm/lib.schema';
+import { SubscriptionStatusSchemaEnum, FeatureAccessReasonEnum } from './billing.enum';
 
+/**
+ * Organization subscription details schema.
+ */
 export const SubscriptionModel = defineSchemaModel({
   name: 'Subscription',
   description: 'Organization subscription details',
@@ -46,6 +23,9 @@ export const SubscriptionModel = defineSchemaModel({
   },
 });
 
+/**
+ * Usage summary for a feature schema.
+ */
 export const UsageSummaryModel = defineSchemaModel({
   name: 'UsageSummary',
   description: 'Usage summary for a feature',
@@ -58,6 +38,9 @@ export const UsageSummaryModel = defineSchemaModel({
   },
 });
 
+/**
+ * Input for recording feature usage.
+ */
 export const RecordUsageInputModel = defineSchemaModel({
   name: 'RecordUsageInput',
   description: 'Input for recording feature usage',
@@ -70,6 +53,9 @@ export const RecordUsageInputModel = defineSchemaModel({
   },
 });
 
+/**
+ * Output for recording feature usage.
+ */
 export const RecordUsageOutputModel = defineSchemaModel({
   name: 'RecordUsageOutput',
   description: 'Output for recording feature usage',
@@ -81,6 +67,9 @@ export const RecordUsageOutputModel = defineSchemaModel({
   },
 });
 
+/**
+ * Payload for usage.recorded event.
+ */
 export const UsageRecordedPayloadModel = defineSchemaModel({
   name: 'UsageRecordedPayload',
   description: 'Payload for usage.recorded event',
@@ -90,6 +79,9 @@ export const UsageRecordedPayloadModel = defineSchemaModel({
   },
 });
 
+/**
+ * Input for getting usage summary.
+ */
 export const GetUsageSummaryInputModel = defineSchemaModel({
   name: 'GetUsageSummaryInput',
   description: 'Input for getting usage summary',
@@ -98,6 +90,9 @@ export const GetUsageSummaryInputModel = defineSchemaModel({
   },
 });
 
+/**
+ * Output for usage summary.
+ */
 export const GetUsageSummaryOutputModel = defineSchemaModel({
   name: 'GetUsageSummaryOutput',
   description: 'Output for usage summary',
@@ -110,6 +105,9 @@ export const GetUsageSummaryOutputModel = defineSchemaModel({
   },
 });
 
+/**
+ * Input for checking feature access.
+ */
 export const CheckFeatureAccessInputModel = defineSchemaModel({
   name: 'CheckFeatureAccessInput',
   description: 'Input for checking feature access',
@@ -118,6 +116,9 @@ export const CheckFeatureAccessInputModel = defineSchemaModel({
   },
 });
 
+/**
+ * Output for feature access check.
+ */
 export const CheckFeatureAccessOutputModel = defineSchemaModel({
   name: 'CheckFeatureAccessOutput',
   description: 'Output for feature access check',
@@ -128,106 +129,3 @@ export const CheckFeatureAccessOutputModel = defineSchemaModel({
   },
 });
 
-// ============ Contracts ============
-
-/**
- * Get subscription status.
- */
-export const GetSubscriptionContract = defineQuery({
-  meta: {
-    name: 'saas.billing.subscription.get',
-    version: 1,
-    stability: 'stable',
-    owners: [...OWNERS],
-    tags: ['saas', 'billing', 'subscription'],
-    description: 'Get organization subscription status.',
-    goal: 'Show current plan and billing status.',
-    context: 'Billing page, plan upgrade prompts.',
-  },
-  io: {
-    input: null,
-    output: SubscriptionModel,
-  },
-  policy: {
-    auth: 'user',
-  },
-});
-
-/**
- * Record feature usage.
- */
-export const RecordUsageContract = defineCommand({
-  meta: {
-    name: 'saas.billing.usage.record',
-    version: 1,
-    stability: 'stable',
-    owners: [...OWNERS],
-    tags: ['saas', 'billing', 'usage'],
-    description: 'Record usage of a metered feature.',
-    goal: 'Track feature usage for billing.',
-    context: 'Called by services when metered features are used.',
-  },
-  io: {
-    input: RecordUsageInputModel,
-    output: RecordUsageOutputModel,
-  },
-  policy: {
-    auth: 'user',
-  },
-  sideEffects: {
-    emits: [
-      {
-        name: 'billing.usage.recorded',
-        version: 1,
-        when: 'Usage is recorded',
-        payload: UsageRecordedPayloadModel,
-      },
-    ],
-  },
-});
-
-/**
- * Get usage summary.
- */
-export const GetUsageSummaryContract = defineQuery({
-  meta: {
-    name: 'saas.billing.usage.summary',
-    version: 1,
-    stability: 'stable',
-    owners: [...OWNERS],
-    tags: ['saas', 'billing', 'usage'],
-    description: 'Get usage summary for the current billing period.',
-    goal: 'Show usage vs limits.',
-    context: 'Billing page, usage dashboards.',
-  },
-  io: {
-    input: GetUsageSummaryInputModel,
-    output: GetUsageSummaryOutputModel,
-  },
-  policy: {
-    auth: 'user',
-  },
-});
-
-/**
- * Check feature access.
- */
-export const CheckFeatureAccessContract = defineQuery({
-  meta: {
-    name: 'saas.billing.feature.check',
-    version: 1,
-    stability: 'stable',
-    owners: [...OWNERS],
-    tags: ['saas', 'billing', 'feature'],
-    description: 'Check if organization has access to a feature.',
-    goal: 'Gate features based on plan/usage.',
-    context: 'Feature access checks, upgrade prompts.',
-  },
-  io: {
-    input: CheckFeatureAccessInputModel,
-    output: CheckFeatureAccessOutputModel,
-  },
-  policy: {
-    auth: 'user',
-  },
-});

package/src/billing/index.ts

@@ -0,0 +1,65 @@
+/**
+ * Billing domain - subscription, usage tracking, and feature access.
+ */
+
+// Enums
+export {
+  SubscriptionStatusSchemaEnum,
+  FeatureAccessReasonEnum,
+} from './billing.enum';
+
+// Schema models
+export {
+  SubscriptionModel,
+  UsageSummaryModel,
+  RecordUsageInputModel,
+  RecordUsageOutputModel,
+  UsageRecordedPayloadModel,
+  GetUsageSummaryInputModel,
+  GetUsageSummaryOutputModel,
+  CheckFeatureAccessInputModel,
+  CheckFeatureAccessOutputModel,
+} from './billing.schema';
+
+// Contracts
+export {
+  GetSubscriptionContract,
+  RecordUsageContract,
+  GetUsageSummaryContract,
+  CheckFeatureAccessContract,
+} from './billing.contracts';
+
+// Events
+export {
+  UsageRecordedEvent,
+  UsageLimitReachedEvent,
+  SubscriptionChangedEvent,
+} from './billing.event';
+
+// Entities
+export {
+  SubscriptionStatusEnum,
+  SubscriptionEntity,
+  BillingUsageEntity,
+  UsageLimitEntity,
+} from './billing.entity';
+
+// Presentations
+export {
+  SubscriptionPresentation,
+  UsageDashboardPresentation,
+} from './billing.presentation';
+
+// Handlers
+export {
+  mockGetSubscriptionHandler,
+  mockGetUsageSummaryHandler,
+  mockRecordUsageHandler,
+  mockCheckFeatureAccessHandler,
+  type Subscription,
+  type UsageSummary,
+  type RecordUsageInput,
+  type CheckFeatureAccessInput,
+  type CheckFeatureAccessOutput,
+} from './billing.handler';
+

package/src/{presentations/dashboard.ts → dashboard/dashboard.presentation.ts}

@@ -1,6 +1,3 @@
-/**
- * SaaS Dashboard Presentation Descriptor
- */
 import type { PresentationDescriptorV2 } from '@lssm/lib.contracts';
 
 /**
@@ -49,3 +46,4 @@ export const SettingsPanelPresentation: PresentationDescriptorV2 = {
     flags: ['saas.enabled'],
   },
 };
+

package/src/dashboard/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Dashboard domain - main SaaS dashboard and settings panels.
+ */
+
+export {
+  SaasDashboardPresentation,
+  SettingsPanelPresentation,
+} from './dashboard.presentation';
+

package/src/handlers/index.ts

@@ -1,36 +1,22 @@
 /**
- * Mock handlers for saas-boilerplate example
- *
- * These handlers provide mock implementations of all contracts
- * for use in demos, tests, and the sandbox environment.
+ * SaaS Boilerplate Handlers - re-exports from domain modules for backward compatibility.
  */
 
-// Mock data
-export * from './mock-data';
+// Billing handlers
+export {
+  mockGetSubscriptionHandler,
+  mockRecordUsageHandler,
+  mockGetUsageSummaryHandler,
+  mockCheckFeatureAccessHandler,
+} from '../billing/billing.handler';
 
 // Project handlers
 export {
-  mockListProjectsHandler,
-  mockGetProjectHandler,
   mockCreateProjectHandler,
+  mockGetProjectHandler,
+  mockListProjectsHandler,
   mockUpdateProjectHandler,
   mockDeleteProjectHandler,
-  type Project,
-  type CreateProjectInput,
-  type UpdateProjectInput,
-  type ListProjectsInput,
-  type ListProjectsOutput,
-} from './project.handlers';
+} from '../project/project.handler';
+
 
-// Billing handlers
-export {
-  mockGetSubscriptionHandler,
-  mockGetUsageSummaryHandler,
-  mockRecordUsageHandler,
-  mockCheckFeatureAccessHandler,
-  type Subscription,
-  type UsageSummary,
-  type RecordUsageInput,
-  type CheckFeatureAccessInput,
-  type CheckFeatureAccessOutput,
-} from './billing.handlers';

package/src/index.ts

@@ -1,13 +1,17 @@
 // SaaS Boilerplate Example
 // Demonstrates ContractSpec principles for a complete SaaS application
 
-export * from './entities';
-export * from './contracts';
-export * from './events';
-export * from './handlers';
-export * from './presentations';
+// Export all domain modules
+export * from './billing';
+export * from './project';
+export * from './settings';
+export * from './dashboard';
+
+// Export feature and example metadata
 export * from './feature';
 export { default as example } from './example';
+
+// Import docs for registration
 import './docs';
 
 // Schema composition configuration
@@ -15,7 +19,40 @@ import { identityRbacSchemaContribution } from '@lssm/lib.identity-rbac';
 import { jobsSchemaContribution } from '@lssm/lib.jobs';
 import { auditTrailSchemaContribution } from '@lssm/module.audit-trail';
 import { notificationsSchemaContribution } from '@lssm/module.notifications';
-import { saasBoilerplateSchemaContribution } from './entities';
+import type { ModuleSchemaContribution } from '@lssm/lib.schema';
+import {
+  ProjectEntity,
+  ProjectMemberEntity,
+  ProjectStatusEnum,
+} from './project/project.entity';
+import {
+  SettingsEntity,
+  FeatureFlagEntity,
+  SettingsScopeEnum,
+} from './settings';
+import {
+  SubscriptionEntity,
+  BillingUsageEntity,
+  UsageLimitEntity,
+  SubscriptionStatusEnum,
+} from './billing/billing.entity';
+
+/**
+ * SaaS boilerplate schema contribution.
+ */
+export const saasBoilerplateSchemaContribution: ModuleSchemaContribution = {
+  moduleId: '@lssm/example.saas-boilerplate',
+  entities: [
+    ProjectEntity,
+    ProjectMemberEntity,
+    SettingsEntity,
+    FeatureFlagEntity,
+    SubscriptionEntity,
+    BillingUsageEntity,
+    UsageLimitEntity,
+  ],
+  enums: [ProjectStatusEnum, SettingsScopeEnum, SubscriptionStatusEnum],
+};
 
 /**
  * Complete schema composition for SaaS Boilerplate.

package/src/presentations/index.ts

@@ -1,44 +1,38 @@
 /**
- * Presentation descriptors for saas-boilerplate
+ * SaaS Boilerplate Presentations - re-exports from domain modules for backward compatibility.
  */
 
-// Project presentations
-export {
-  ProjectListPresentation,
-  ProjectDetailPresentation,
-} from './project-list';
-
 // Billing presentations
 export {
   SubscriptionPresentation,
   UsageDashboardPresentation,
-} from './billing';
+} from '../billing/billing.presentation';
 
-// Dashboard presentations
+// Project presentations
 export {
-  SaasDashboardPresentation,
-  SettingsPanelPresentation,
-} from './dashboard';
-
-// Re-export all presentations as an array
-import {
   ProjectListPresentation,
   ProjectDetailPresentation,
-} from './project-list';
-import {
-  SubscriptionPresentation,
-  UsageDashboardPresentation,
-} from './billing';
-import {
-  SaasDashboardPresentation,
-  SettingsPanelPresentation,
-} from './dashboard';
+} from '../project/project.presentation';
 
-export const SaasBoilerplatePresentations = [
+// Dashboard presentations
+export {
   SaasDashboardPresentation,
-  ProjectListPresentation,
-  ProjectDetailPresentation,
-  SubscriptionPresentation,
-  UsageDashboardPresentation,
   SettingsPanelPresentation,
-];
+} from '../dashboard/dashboard.presentation';
+
+// All presentations collection
+export const SaasBoilerplatePresentations = {
+  // Billing
+  SubscriptionPresentation: undefined,
+  UsageDashboardPresentation: undefined,
+
+  // Project
+  ProjectListPresentation: undefined,
+  ProjectDetailPresentation: undefined,
+
+  // Dashboard
+  SaasDashboardPresentation: undefined,
+  SettingsPanelPresentation: undefined,
+};
+
+

package/src/project/index.ts

@@ -0,0 +1,67 @@
+/**
+ * Project domain - project management within organizations.
+ */
+
+// Enums
+export {
+  ProjectStatusSchemaEnum,
+  ProjectStatusFilterEnum,
+} from './project.enum';
+
+// Schema models
+export {
+  ProjectModel,
+  CreateProjectInputModel,
+  UpdateProjectInputModel,
+  GetProjectInputModel,
+  DeleteProjectInputModel,
+  DeleteProjectOutputModel,
+  ProjectDeletedPayloadModel,
+  ListProjectsInputModel,
+  ListProjectsOutputModel,
+} from './project.schema';
+
+// Contracts
+export {
+  CreateProjectContract,
+  GetProjectContract,
+  UpdateProjectContract,
+  DeleteProjectContract,
+  ListProjectsContract,
+} from './project.contracts';
+
+// Events
+export {
+  ProjectCreatedEvent,
+  ProjectUpdatedEvent,
+  ProjectDeletedEvent,
+  ProjectArchivedEvent,
+} from './project.event';
+
+// Entities
+export {
+  ProjectStatusEnum,
+  ProjectEntity,
+  ProjectMemberEntity,
+} from './project.entity';
+
+// Presentations
+export {
+  ProjectListPresentation,
+  ProjectDetailPresentation,
+} from './project.presentation';
+
+// Handlers
+export {
+  mockListProjectsHandler,
+  mockGetProjectHandler,
+  mockCreateProjectHandler,
+  mockUpdateProjectHandler,
+  mockDeleteProjectHandler,
+  type Project,
+  type CreateProjectInput,
+  type UpdateProjectInput,
+  type ListProjectsInput,
+  type ListProjectsOutput,
+} from './project.handler';
+