@lssm/example.saas-boilerplate 1.41.0 → 1.42.2

package/dist/shared/mock-data.d.ts

@@ -0,0 +1,86 @@
+//#region src/shared/mock-data.d.ts
+/**
+ * Shared mock data for saas-boilerplate handlers.
+ */
+declare const MOCK_PROJECTS: ({
+  id: string;
+  name: string;
+  description: string;
+  slug: string;
+  organizationId: string;
+  createdBy: string;
+  status: "ACTIVE";
+  isPublic: boolean;
+  tags: string[];
+  createdAt: Date;
+  updatedAt: Date;
+} | {
+  id: string;
+  name: string;
+  description: string;
+  slug: string;
+  organizationId: string;
+  createdBy: string;
+  status: "DRAFT";
+  isPublic: boolean;
+  tags: string[];
+  createdAt: Date;
+  updatedAt: Date;
+} | {
+  id: string;
+  name: string;
+  description: string;
+  slug: string;
+  organizationId: string;
+  createdBy: string;
+  status: "ARCHIVED";
+  isPublic: boolean;
+  tags: string[];
+  createdAt: Date;
+  updatedAt: Date;
+})[];
+declare const MOCK_SUBSCRIPTION: {
+  id: string;
+  organizationId: string;
+  planId: string;
+  planName: string;
+  status: "ACTIVE";
+  currentPeriodStart: Date;
+  currentPeriodEnd: Date;
+  limits: {
+    projects: number;
+    users: number;
+    storage: number;
+    apiCalls: number;
+  };
+  usage: {
+    projects: number;
+    users: number;
+    storage: number;
+    apiCalls: number;
+  };
+};
+declare const MOCK_USAGE_SUMMARY: {
+  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;
+  }[];
+};
+//#endregion
+export { MOCK_PROJECTS, MOCK_SUBSCRIPTION, MOCK_USAGE_SUMMARY };
+//# sourceMappingURL=mock-data.d.ts.map

package/dist/shared/mock-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-data.d.ts","names":[],"sources":["../../src/shared/mock-data.ts"],"sourcesContent":[],"mappings":";;AAMA;;cAAa;;;;;;EAyDA,SAAA,EAAA,MAAA;EAwBA,MAAA,EAAA,QAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAxBA;;;;;;sBAoBZ;oBAAA;;;;;;;;;;;;;;cAIY"}

package/dist/shared/mock-data.js

@@ -1 +1,138 @@
-const e=[{id:`proj-1`,name:`Marketing Website`,description:`Main company website redesign project`,slug:`marketing-website`,organizationId:`demo-org`,createdBy:`user-1`,status:`ACTIVE`,isPublic:!1,tags:[`marketing`,`website`,`redesign`],createdAt:new Date(`2024-01-15T10:00:00Z`),updatedAt:new Date(`2024-03-20T14:30:00Z`)},{id:`proj-2`,name:`Mobile App v2`,description:`Next generation mobile application`,slug:`mobile-app-v2`,organizationId:`demo-org`,createdBy:`user-2`,status:`ACTIVE`,isPublic:!1,tags:[`mobile`,`app`,`v2`],createdAt:new Date(`2024-02-01T09:00:00Z`),updatedAt:new Date(`2024-04-05T11:15:00Z`)},{id:`proj-3`,name:`API Integration`,description:`Third-party API integration project`,slug:`api-integration`,organizationId:`demo-org`,createdBy:`user-1`,status:`DRAFT`,isPublic:!1,tags:[`api`,`integration`],createdAt:new Date(`2024-03-10T08:00:00Z`),updatedAt:new Date(`2024-03-10T08:00:00Z`)},{id:`proj-4`,name:`Analytics Dashboard`,description:`Internal analytics and reporting dashboard`,slug:`analytics-dashboard`,organizationId:`demo-org`,createdBy:`user-3`,status:`ARCHIVED`,isPublic:!0,tags:[`analytics`,`dashboard`,`reporting`],createdAt:new Date(`2023-10-01T12:00:00Z`),updatedAt:new Date(`2024-02-28T16:45:00Z`)}],t={id:`sub-1`,organizationId:`demo-org`,planId:`pro`,planName:`Professional`,status:`ACTIVE`,currentPeriodStart:new Date(`2024-04-01T00:00:00Z`),currentPeriodEnd:new Date(`2024-05-01T00:00:00Z`),limits:{projects:25,users:10,storage:50,apiCalls:1e5},usage:{projects:4,users:5,storage:12.5,apiCalls:45230}},n={organizationId:`demo-org`,period:`current_month`,apiCalls:{total:45230,limit:1e5,percentUsed:45.23},storage:{totalGb:12.5,limitGb:50,percentUsed:25},activeProjects:4,activeUsers:5,breakdown:[{date:`2024-04-01`,apiCalls:3200,storageGb:12.1},{date:`2024-04-02`,apiCalls:2800,storageGb:12.2},{date:`2024-04-03`,apiCalls:4100,storageGb:12.3},{date:`2024-04-04`,apiCalls:3600,storageGb:12.4},{date:`2024-04-05`,apiCalls:3800,storageGb:12.5}]};export{e as MOCK_PROJECTS,t as MOCK_SUBSCRIPTION,n as MOCK_USAGE_SUMMARY};
+//#region src/shared/mock-data.ts
+/**
+* Shared mock data for saas-boilerplate handlers.
+*/
+const MOCK_PROJECTS = [
+	{
+		id: "proj-1",
+		name: "Marketing Website",
+		description: "Main company website redesign project",
+		slug: "marketing-website",
+		organizationId: "demo-org",
+		createdBy: "user-1",
+		status: "ACTIVE",
+		isPublic: false,
+		tags: [
+			"marketing",
+			"website",
+			"redesign"
+		],
+		createdAt: /* @__PURE__ */ new Date("2024-01-15T10:00:00Z"),
+		updatedAt: /* @__PURE__ */ new Date("2024-03-20T14:30:00Z")
+	},
+	{
+		id: "proj-2",
+		name: "Mobile App v2",
+		description: "Next generation mobile application",
+		slug: "mobile-app-v2",
+		organizationId: "demo-org",
+		createdBy: "user-2",
+		status: "ACTIVE",
+		isPublic: false,
+		tags: [
+			"mobile",
+			"app",
+			"v2"
+		],
+		createdAt: /* @__PURE__ */ new Date("2024-02-01T09:00:00Z"),
+		updatedAt: /* @__PURE__ */ new Date("2024-04-05T11:15:00Z")
+	},
+	{
+		id: "proj-3",
+		name: "API Integration",
+		description: "Third-party API integration project",
+		slug: "api-integration",
+		organizationId: "demo-org",
+		createdBy: "user-1",
+		status: "DRAFT",
+		isPublic: false,
+		tags: ["api", "integration"],
+		createdAt: /* @__PURE__ */ new Date("2024-03-10T08:00:00Z"),
+		updatedAt: /* @__PURE__ */ new Date("2024-03-10T08:00:00Z")
+	},
+	{
+		id: "proj-4",
+		name: "Analytics Dashboard",
+		description: "Internal analytics and reporting dashboard",
+		slug: "analytics-dashboard",
+		organizationId: "demo-org",
+		createdBy: "user-3",
+		status: "ARCHIVED",
+		isPublic: true,
+		tags: [
+			"analytics",
+			"dashboard",
+			"reporting"
+		],
+		createdAt: /* @__PURE__ */ new Date("2023-10-01T12:00:00Z"),
+		updatedAt: /* @__PURE__ */ new Date("2024-02-28T16:45:00Z")
+	}
+];
+const MOCK_SUBSCRIPTION = {
+	id: "sub-1",
+	organizationId: "demo-org",
+	planId: "pro",
+	planName: "Professional",
+	status: "ACTIVE",
+	currentPeriodStart: /* @__PURE__ */ new Date("2024-04-01T00:00:00Z"),
+	currentPeriodEnd: /* @__PURE__ */ new Date("2024-05-01T00:00:00Z"),
+	limits: {
+		projects: 25,
+		users: 10,
+		storage: 50,
+		apiCalls: 1e5
+	},
+	usage: {
+		projects: 4,
+		users: 5,
+		storage: 12.5,
+		apiCalls: 45230
+	}
+};
+const MOCK_USAGE_SUMMARY = {
+	organizationId: "demo-org",
+	period: "current_month",
+	apiCalls: {
+		total: 45230,
+		limit: 1e5,
+		percentUsed: 45.23
+	},
+	storage: {
+		totalGb: 12.5,
+		limitGb: 50,
+		percentUsed: 25
+	},
+	activeProjects: 4,
+	activeUsers: 5,
+	breakdown: [
+		{
+			date: "2024-04-01",
+			apiCalls: 3200,
+			storageGb: 12.1
+		},
+		{
+			date: "2024-04-02",
+			apiCalls: 2800,
+			storageGb: 12.2
+		},
+		{
+			date: "2024-04-03",
+			apiCalls: 4100,
+			storageGb: 12.3
+		},
+		{
+			date: "2024-04-04",
+			apiCalls: 3600,
+			storageGb: 12.4
+		},
+		{
+			date: "2024-04-05",
+			apiCalls: 3800,
+			storageGb: 12.5
+		}
+	]
+};
+
+//#endregion
+export { MOCK_PROJECTS, MOCK_SUBSCRIPTION, MOCK_USAGE_SUMMARY };
+//# sourceMappingURL=mock-data.js.map

package/dist/shared/mock-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-data.js","names":[],"sources":["../../src/shared/mock-data.ts"],"sourcesContent":["/**\n * Shared mock data for saas-boilerplate handlers.\n */\n\n// ============ Project Mock Data ============\n\nexport const MOCK_PROJECTS = [\n  {\n    id: 'proj-1',\n    name: 'Marketing Website',\n    description: 'Main company website redesign project',\n    slug: 'marketing-website',\n    organizationId: 'demo-org',\n    createdBy: 'user-1',\n    status: 'ACTIVE' as const,\n    isPublic: false,\n    tags: ['marketing', 'website', 'redesign'],\n    createdAt: new Date('2024-01-15T10:00:00Z'),\n    updatedAt: new Date('2024-03-20T14:30:00Z'),\n  },\n  {\n    id: 'proj-2',\n    name: 'Mobile App v2',\n    description: 'Next generation mobile application',\n    slug: 'mobile-app-v2',\n    organizationId: 'demo-org',\n    createdBy: 'user-2',\n    status: 'ACTIVE' as const,\n    isPublic: false,\n    tags: ['mobile', 'app', 'v2'],\n    createdAt: new Date('2024-02-01T09:00:00Z'),\n    updatedAt: new Date('2024-04-05T11:15:00Z'),\n  },\n  {\n    id: 'proj-3',\n    name: 'API Integration',\n    description: 'Third-party API integration project',\n    slug: 'api-integration',\n    organizationId: 'demo-org',\n    createdBy: 'user-1',\n    status: 'DRAFT' as const,\n    isPublic: false,\n    tags: ['api', 'integration'],\n    createdAt: new Date('2024-03-10T08:00:00Z'),\n    updatedAt: new Date('2024-03-10T08:00:00Z'),\n  },\n  {\n    id: 'proj-4',\n    name: 'Analytics Dashboard',\n    description: 'Internal analytics and reporting dashboard',\n    slug: 'analytics-dashboard',\n    organizationId: 'demo-org',\n    createdBy: 'user-3',\n    status: 'ARCHIVED' as const,\n    isPublic: true,\n    tags: ['analytics', 'dashboard', 'reporting'],\n    createdAt: new Date('2023-10-01T12:00:00Z'),\n    updatedAt: new Date('2024-02-28T16:45:00Z'),\n  },\n];\n\n// ============ Subscription Mock Data ============\n\nexport const MOCK_SUBSCRIPTION = {\n  id: 'sub-1',\n  organizationId: 'demo-org',\n  planId: 'pro',\n  planName: 'Professional',\n  status: 'ACTIVE' as const,\n  currentPeriodStart: new Date('2024-04-01T00:00:00Z'),\n  currentPeriodEnd: new Date('2024-05-01T00:00:00Z'),\n  limits: {\n    projects: 25,\n    users: 10,\n    storage: 50, // GB\n    apiCalls: 100000,\n  },\n  usage: {\n    projects: 4,\n    users: 5,\n    storage: 12.5,\n    apiCalls: 45230,\n  },\n};\n\n// ============ Usage Summary Mock Data ============\n\nexport const MOCK_USAGE_SUMMARY = {\n  organizationId: 'demo-org',\n  period: 'current_month',\n  apiCalls: {\n    total: 45230,\n    limit: 100000,\n    percentUsed: 45.23,\n  },\n  storage: {\n    totalGb: 12.5,\n    limitGb: 50,\n    percentUsed: 25,\n  },\n  activeProjects: 4,\n  activeUsers: 5,\n  breakdown: [\n    { date: '2024-04-01', apiCalls: 3200, storageGb: 12.1 },\n    { date: '2024-04-02', apiCalls: 2800, storageGb: 12.2 },\n    { date: '2024-04-03', apiCalls: 4100, storageGb: 12.3 },\n    { date: '2024-04-04', apiCalls: 3600, storageGb: 12.4 },\n    { date: '2024-04-05', apiCalls: 3800, storageGb: 12.5 },\n  ],\n};\n"],"mappings":";;;;AAMA,MAAa,gBAAgB;CAC3B;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,MAAM;EACN,gBAAgB;EAChB,WAAW;EACX,QAAQ;EACR,UAAU;EACV,MAAM;GAAC;GAAa;GAAW;GAAW;EAC1C,2BAAW,IAAI,KAAK,uBAAuB;EAC3C,2BAAW,IAAI,KAAK,uBAAuB;EAC5C;CACD;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,MAAM;EACN,gBAAgB;EAChB,WAAW;EACX,QAAQ;EACR,UAAU;EACV,MAAM;GAAC;GAAU;GAAO;GAAK;EAC7B,2BAAW,IAAI,KAAK,uBAAuB;EAC3C,2BAAW,IAAI,KAAK,uBAAuB;EAC5C;CACD;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,MAAM;EACN,gBAAgB;EAChB,WAAW;EACX,QAAQ;EACR,UAAU;EACV,MAAM,CAAC,OAAO,cAAc;EAC5B,2BAAW,IAAI,KAAK,uBAAuB;EAC3C,2BAAW,IAAI,KAAK,uBAAuB;EAC5C;CACD;EACE,IAAI;EACJ,MAAM;EACN,aAAa;EACb,MAAM;EACN,gBAAgB;EAChB,WAAW;EACX,QAAQ;EACR,UAAU;EACV,MAAM;GAAC;GAAa;GAAa;GAAY;EAC7C,2BAAW,IAAI,KAAK,uBAAuB;EAC3C,2BAAW,IAAI,KAAK,uBAAuB;EAC5C;CACF;AAID,MAAa,oBAAoB;CAC/B,IAAI;CACJ,gBAAgB;CAChB,QAAQ;CACR,UAAU;CACV,QAAQ;CACR,oCAAoB,IAAI,KAAK,uBAAuB;CACpD,kCAAkB,IAAI,KAAK,uBAAuB;CAClD,QAAQ;EACN,UAAU;EACV,OAAO;EACP,SAAS;EACT,UAAU;EACX;CACD,OAAO;EACL,UAAU;EACV,OAAO;EACP,SAAS;EACT,UAAU;EACX;CACF;AAID,MAAa,qBAAqB;CAChC,gBAAgB;CAChB,QAAQ;CACR,UAAU;EACR,OAAO;EACP,OAAO;EACP,aAAa;EACd;CACD,SAAS;EACP,SAAS;EACT,SAAS;EACT,aAAa;EACd;CACD,gBAAgB;CAChB,aAAa;CACb,WAAW;EACT;GAAE,MAAM;GAAc,UAAU;GAAM,WAAW;GAAM;EACvD;GAAE,MAAM;GAAc,UAAU;GAAM,WAAW;GAAM;EACvD;GAAE,MAAM;GAAc,UAAU;GAAM,WAAW;GAAM;EACvD;GAAE,MAAM;GAAc,UAAU;GAAM,WAAW;GAAM;EACvD;GAAE,MAAM;GAAc,UAAU;GAAM,WAAW;GAAM;EACxD;CACF"}

package/package.json

@@ -1,44 +1,46 @@
 {
   "name": "@lssm/example.saas-boilerplate",
-  "version": "1.41.0",
+  "version": "1.42.2",
   "description": "SaaS Boilerplate - Users, Orgs, Projects, Billing, Settings",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./billing": "./src/billing/index.ts",
-    "./billing/billing.contracts": "./src/billing/billing.contracts.ts",
-    "./billing/billing.entity": "./src/billing/billing.entity.ts",
-    "./billing/billing.enum": "./src/billing/billing.enum.ts",
-    "./billing/billing.event": "./src/billing/billing.event.ts",
-    "./billing/billing.handler": "./src/billing/billing.handler.ts",
-    "./billing/billing.presentation": "./src/billing/billing.presentation.ts",
-    "./billing/billing.schema": "./src/billing/billing.schema.ts",
-    "./dashboard": "./src/dashboard/index.ts",
-    "./dashboard/dashboard.presentation": "./src/dashboard/dashboard.presentation.ts",
-    "./docs": "./src/docs/index.ts",
-    "./docs/saas-boilerplate.docblock": "./src/docs/saas-boilerplate.docblock.ts",
-    "./example": "./src/example.ts",
-    "./handlers": "./src/handlers/index.ts",
-    "./presentations": "./src/presentations/index.ts",
-    "./project": "./src/project/index.ts",
-    "./project/project.contracts": "./src/project/project.contracts.ts",
-    "./project/project.entity": "./src/project/project.entity.ts",
-    "./project/project.enum": "./src/project/project.enum.ts",
-    "./project/project.event": "./src/project/project.event.ts",
-    "./project/project.handler": "./src/project/project.handler.ts",
-    "./project/project.presentation": "./src/project/project.presentation.ts",
-    "./project/project.schema": "./src/project/project.schema.ts",
-    "./saas-boilerplate.feature": "./src/saas-boilerplate.feature.ts",
-    "./settings": "./src/settings/index.ts",
-    "./settings/settings.entity": "./src/settings/settings.entity.ts",
-    "./settings/settings.enum": "./src/settings/settings.enum.ts",
-    "./shared/mock-data": "./src/shared/mock-data.ts",
+    ".": "./dist/index.js",
+    "./billing": "./dist/billing/index.js",
+    "./billing/billing.entity": "./dist/billing/billing.entity.js",
+    "./billing/billing.enum": "./dist/billing/billing.enum.js",
+    "./billing/billing.event": "./dist/billing/billing.event.js",
+    "./billing/billing.handler": "./dist/billing/billing.handler.js",
+    "./billing/billing.operations": "./dist/billing/billing.operations.js",
+    "./billing/billing.presentation": "./dist/billing/billing.presentation.js",
+    "./billing/billing.schema": "./dist/billing/billing.schema.js",
+    "./dashboard": "./dist/dashboard/index.js",
+    "./dashboard/dashboard.presentation": "./dist/dashboard/dashboard.presentation.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/saas-boilerplate.docblock": "./dist/docs/saas-boilerplate.docblock.js",
+    "./example": "./dist/example.js",
+    "./handlers": "./dist/handlers/index.js",
+    "./presentations": "./dist/presentations/index.js",
+    "./project": "./dist/project/index.js",
+    "./project/project.entity": "./dist/project/project.entity.js",
+    "./project/project.enum": "./dist/project/project.enum.js",
+    "./project/project.event": "./dist/project/project.event.js",
+    "./project/project.handler": "./dist/project/project.handler.js",
+    "./project/project.operations": "./dist/project/project.operations.js",
+    "./project/project.presentation": "./dist/project/project.presentation.js",
+    "./project/project.schema": "./dist/project/project.schema.js",
+    "./saas-boilerplate.feature": "./dist/saas-boilerplate.feature.js",
+    "./settings": "./dist/settings/index.js",
+    "./settings/settings.entity": "./dist/settings/settings.entity.js",
+    "./settings/settings.enum": "./dist/settings/settings.enum.js",
+    "./shared/mock-data": "./dist/shared/mock-data.js",
     "./*": "./*"
   },
   "scripts": {
-    "build": "bun build:bundle && bun build:types",
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
     "dev": "bun build:bundle --watch",
@@ -49,19 +51,19 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/lib.schema": "workspace:*",
-    "@lssm/lib.contracts": "workspace:*",
-    "@lssm/lib.bus": "workspace:*",
-    "@lssm/lib.identity-rbac": "workspace:*",
-    "@lssm/lib.jobs": "workspace:*",
-    "@lssm/module.audit-trail": "workspace:*",
-    "@lssm/module.notifications": "workspace:*",
+    "@lssm/lib.schema": "1.42.2",
+    "@lssm/lib.contracts": "1.42.2",
+    "@lssm/lib.bus": "1.42.2",
+    "@lssm/lib.identity-rbac": "1.42.2",
+    "@lssm/lib.jobs": "1.42.2",
+    "@lssm/module.audit-trail": "1.42.2",
+    "@lssm/module.notifications": "1.42.2",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "workspace:*",
-    "@lssm/tool.typescript": "workspace:*",
-    "tsdown": "^0.17.4",
+    "@lssm/tool.tsdown": "1.42.2",
+    "@lssm/tool.typescript": "1.42.2",
+    "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },
   "module": "./dist/index.js",
@@ -69,7 +71,7 @@
     "exports": {
       ".": "./dist/index.js",
       "./billing": "./dist/billing/index.js",
-      "./billing/billing.contracts": "./dist/billing/billing.contracts.js",
+      "./billing/billing.contracts": "./dist/billing/billing.operations.js",
       "./billing/billing.entity": "./dist/billing/billing.entity.js",
       "./billing/billing.enum": "./dist/billing/billing.enum.js",
       "./billing/billing.event": "./dist/billing/billing.event.js",
@@ -84,7 +86,7 @@
       "./handlers": "./dist/handlers/index.js",
       "./presentations": "./dist/presentations/index.js",
       "./project": "./dist/project/index.js",
-      "./project/project.contracts": "./dist/project/project.contracts.js",
+      "./project/project.contracts": "./dist/project/project.operations.js",
       "./project/project.entity": "./dist/project/project.entity.js",
       "./project/project.enum": "./dist/project/project.enum.js",
       "./project/project.event": "./dist/project/project.event.js",
@@ -97,6 +99,14 @@
       "./settings/settings.enum": "./dist/settings/settings.enum.js",
       "./shared/mock-data": "./dist/shared/mock-data.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/saas-boilerplate"
   }
 }

package/src/billing/billing.event.ts

@@ -66,9 +66,14 @@ const SubscriptionChangedPayload = defineSchemaModel({
  * Event: Feature usage has been recorded.
  */
 export const UsageRecordedEvent = defineEvent({
-  name: 'billing.usage.recorded',
-  version: 1,
-  description: 'Feature usage has been recorded.',
+  meta: {
+    key: 'billing.usage.recorded',
+    version: 1,
+    description: 'Feature usage has been recorded.',
+    stability: 'stable',
+    owners: ['@saas-team'],
+    tags: ['billing', 'usage', 'recorded'],
+  },
   payload: UsageRecordedPayload,
 });
 
@@ -76,9 +81,14 @@ export const UsageRecordedEvent = defineEvent({
  * Event: Usage limit has been reached for a feature.
  */
 export const UsageLimitReachedEvent = defineEvent({
-  name: 'billing.limit.reached',
-  version: 1,
-  description: 'Usage limit has been reached for a feature.',
+  meta: {
+    key: 'billing.limit.reached',
+    version: 1,
+    description: 'Usage limit has been reached for a feature.',
+    stability: 'stable',
+    owners: ['@saas-team'],
+    tags: ['billing', 'limit', 'reached'],
+  },
   payload: UsageLimitReachedPayload,
 });
 
@@ -86,8 +96,13 @@ export const UsageLimitReachedEvent = defineEvent({
  * Event: Subscription status has changed.
  */
 export const SubscriptionChangedEvent = defineEvent({
-  name: 'billing.subscription.changed',
-  version: 1,
-  description: 'Subscription status has changed.',
+  meta: {
+    key: 'billing.subscription.changed',
+    version: 1,
+    description: 'Subscription status has changed.',
+    stability: 'stable',
+    owners: ['@saas-team'],
+    tags: ['billing', 'subscription', 'changed'],
+  },
   payload: SubscriptionChangedPayload,
 });

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

@@ -1,13 +1,13 @@
 import { defineCommand, defineQuery } from '@lssm/lib.contracts';
 import {
-  SubscriptionModel,
+  CheckFeatureAccessInputModel,
+  CheckFeatureAccessOutputModel,
+  GetUsageSummaryInputModel,
+  GetUsageSummaryOutputModel,
   RecordUsageInputModel,
   RecordUsageOutputModel,
+  SubscriptionModel,
   UsageRecordedPayloadModel,
-  GetUsageSummaryInputModel,
-  GetUsageSummaryOutputModel,
-  CheckFeatureAccessInputModel,
-  CheckFeatureAccessOutputModel,
 } from './billing.schema';
 
 const OWNERS = ['@example.saas-boilerplate'] as const;
@@ -17,7 +17,7 @@ const OWNERS = ['@example.saas-boilerplate'] as const;
  */
 export const GetSubscriptionContract = defineQuery({
   meta: {
-    name: 'saas.billing.subscription.get',
+    key: 'saas.billing.subscription.get',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -33,6 +33,27 @@ export const GetSubscriptionContract = defineQuery({
   policy: {
     auth: 'user',
   },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'get-subscription-happy-path',
+        given: ['Organization has active subscription'],
+        when: ['User requests subscription status'],
+        then: ['Subscription details are returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'get-basic',
+        input: null,
+        output: {
+          plan: 'pro',
+          status: 'active',
+          currentPeriodEnd: '2025-02-01T00:00:00Z',
+        },
+      },
+    ],
+  },
 });
 
 /**
@@ -40,7 +61,7 @@ export const GetSubscriptionContract = defineQuery({
  */
 export const RecordUsageContract = defineCommand({
   meta: {
-    name: 'saas.billing.usage.record',
+    key: 'saas.billing.usage.record',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -59,13 +80,30 @@ export const RecordUsageContract = defineCommand({
   sideEffects: {
     emits: [
       {
-        name: 'billing.usage.recorded',
+        key: 'billing.usage.recorded',
         version: 1,
         when: 'Usage is recorded',
         payload: UsageRecordedPayloadModel,
       },
     ],
   },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'record-usage-happy-path',
+        given: ['Organization exists'],
+        when: ['System records feature usage'],
+        then: ['Usage is recorded'],
+      },
+    ],
+    examples: [
+      {
+        key: 'record-api-call',
+        input: { feature: 'api_calls', quantity: 1, idempotencyKey: 'abc-123' },
+        output: { recorded: true, currentUsage: 100 },
+      },
+    ],
+  },
 });
 
 /**
@@ -73,7 +111,7 @@ export const RecordUsageContract = defineCommand({
  */
 export const GetUsageSummaryContract = defineQuery({
   meta: {
-    name: 'saas.billing.usage.summary',
+    key: 'saas.billing.usage.summary',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -89,6 +127,23 @@ export const GetUsageSummaryContract = defineQuery({
   policy: {
     auth: 'user',
   },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'get-usage-happy-path',
+        given: ['Organization has usage history'],
+        when: ['User requests usage summary'],
+        then: ['Usage metrics are returned'],
+      },
+    ],
+    examples: [
+      {
+        key: 'get-current-usage',
+        input: { period: 'current' },
+        output: { features: [{ name: 'api_calls', used: 100, limit: 1000 }] },
+      },
+    ],
+  },
 });
 
 /**
@@ -96,7 +151,7 @@ export const GetUsageSummaryContract = defineQuery({
  */
 export const CheckFeatureAccessContract = defineQuery({
   meta: {
-    name: 'saas.billing.feature.check',
+    key: 'saas.billing.feature.check',
     version: 1,
     stability: 'stable',
     owners: [...OWNERS],
@@ -112,4 +167,21 @@ export const CheckFeatureAccessContract = defineQuery({
   policy: {
     auth: 'user',
   },
+  acceptance: {
+    scenarios: [
+      {
+        key: 'check-access-granted',
+        given: ['Organization is on Pro plan'],
+        when: ['User checks access to Pro feature'],
+        then: ['Access is granted'],
+      },
+    ],
+    examples: [
+      {
+        key: 'check-advanced-reports',
+        input: { feature: 'advanced_reports' },
+        output: { hasAccess: true, reason: 'Included in Pro plan' },
+      },
+    ],
+  },
 });

package/src/billing/billing.presentation.ts

@@ -1,17 +1,22 @@
-import type { PresentationDescriptorV2 } from '@lssm/lib.contracts';
+import type { PresentationSpec } from '@lssm/lib.contracts';
+import { StabilityEnum } from '@lssm/lib.contracts';
 
 /**
  * Presentation for subscription overview.
  */
-export const SubscriptionPresentation: PresentationDescriptorV2 = {
+export const SubscriptionPresentation: PresentationSpec = {
   meta: {
-    name: 'saas.billing.subscription',
+    key: 'saas.billing.subscription',
     version: 1,
+    title: 'Subscription Status',
     description:
       'Subscription status with plan info, limits, and current usage',
     domain: 'saas-boilerplate',
     owners: ['@saas-team'],
     tags: ['billing', 'subscription'],
+    stability: StabilityEnum.Beta,
+    goal: 'View subscription plan and status',
+    context: 'Billing section',
   },
   source: {
     type: 'component',
@@ -27,14 +32,18 @@ export const SubscriptionPresentation: PresentationDescriptorV2 = {
 /**
  * Presentation for usage dashboard.
  */
-export const UsageDashboardPresentation: PresentationDescriptorV2 = {
+export const UsageDashboardPresentation: PresentationSpec = {
   meta: {
-    name: 'saas.billing.usage',
+    key: 'saas.billing.usage',
     version: 1,
+    title: 'Usage Dashboard',
     description: 'Usage metrics and breakdown by resource type',
     domain: 'saas-boilerplate',
     owners: ['@saas-team'],
     tags: ['billing', 'usage', 'metrics'],
+    stability: StabilityEnum.Beta,
+    goal: 'Monitor feature usage and limits',
+    context: 'Billing section',
   },
   source: {
     type: 'component',

package/src/billing/index.ts

@@ -27,7 +27,7 @@ export {
   RecordUsageContract,
   GetUsageSummaryContract,
   CheckFeatureAccessContract,
-} from './billing.contracts';
+} from './billing.operations';
 
 // Events
 export {