@contractspec/example.saas-boilerplate 1.46.0 → 1.47.0

package/dist/dashboard/dashboard.presentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.presentation.d.ts","names":[],"sources":["../../src/dashboard/dashboard.presentation.ts"],"sourcesContent":[],"mappings":";;;;;;AAMA;AA4Ba,cA5BA,yBA4B2B,EA5BA,gBAkDvC;;;;cAtBY,2BAA2B"}
+{"version":3,"file":"dashboard.presentation.d.ts","names":[],"sources":["../../src/dashboard/dashboard.presentation.ts"],"sourcesContent":[],"mappings":";;;;;;AAKa,cAAA,yBAuBX,EAAA,6BAAA,CAvBoC,gBAuBpC;AAKF;;;cAAa,2BAsBX,6BAAA,CAtBoC"}

package/dist/dashboard/dashboard.presentation.js

@@ -1,10 +1,10 @@
-import { StabilityEnum } from "@contractspec/lib.contracts";
+import { StabilityEnum, definePresentation } from "@contractspec/lib.contracts";
 
 //#region src/dashboard/dashboard.presentation.ts
 /**
 * Main dashboard presentation for the SaaS application.
 */
-const SaasDashboardPresentation = {
+const SaasDashboardPresentation = definePresentation({
 	meta: {
 		key: "saas.dashboard",
 		version: "1.0.0",
@@ -24,11 +24,11 @@ const SaasDashboardPresentation = {
 	},
 	targets: ["react", "markdown"],
 	policy: { flags: ["saas.enabled"] }
-};
+});
 /**
 * Settings panel presentation.
 */
-const SettingsPanelPresentation = {
+const SettingsPanelPresentation = definePresentation({
 	meta: {
 		key: "saas.settings",
 		version: "1.0.0",
@@ -48,7 +48,7 @@ const SettingsPanelPresentation = {
 	},
 	targets: ["react"],
 	policy: { flags: ["saas.enabled"] }
-};
+});
 
 //#endregion
 export { SaasDashboardPresentation, SettingsPanelPresentation };

package/dist/dashboard/dashboard.presentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.presentation.js","names":["SaasDashboardPresentation: PresentationSpec","SettingsPanelPresentation: PresentationSpec"],"sources":["../../src/dashboard/dashboard.presentation.ts"],"sourcesContent":["import type { PresentationSpec } from '@contractspec/lib.contracts';\nimport { StabilityEnum } from '@contractspec/lib.contracts';\n\n/**\n * Main dashboard presentation for the SaaS application.\n */\nexport const SaasDashboardPresentation: PresentationSpec = {\n  meta: {\n    key: 'saas.dashboard',\n    version: '1.0.0',\n    title: 'SaaS Dashboard',\n    description:\n      'Main SaaS dashboard with project overview, usage stats, and quick actions',\n    domain: 'saas-boilerplate',\n    owners: ['@saas-team'],\n    tags: ['dashboard', 'overview'],\n    stability: StabilityEnum.Beta,\n    goal: 'Overview of SaaS activity and metrics',\n    context: 'Main dashboard',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'SaasDashboard',\n  },\n  targets: ['react', 'markdown'],\n  policy: {\n    flags: ['saas.enabled'],\n  },\n};\n\n/**\n * Settings panel presentation.\n */\nexport const SettingsPanelPresentation: PresentationSpec = {\n  meta: {\n    key: 'saas.settings',\n    version: '1.0.0',\n    title: 'Settings Panel',\n    description: 'Organization and user settings panel',\n    domain: 'saas-boilerplate',\n    owners: ['@saas-team'],\n    tags: ['settings', 'config'],\n    stability: StabilityEnum.Beta,\n    goal: 'Configure organization and user settings',\n    context: 'Settings section',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'SettingsPanel',\n  },\n  targets: ['react'],\n  policy: {\n    flags: ['saas.enabled'],\n  },\n};\n"],"mappings":";;;;;;AAMA,MAAaA,4BAA8C;CACzD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,aAAa;EACtB,MAAM,CAAC,aAAa,WAAW;EAC/B,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,SAAS,WAAW;CAC9B,QAAQ,EACN,OAAO,CAAC,eAAe,EACxB;CACF;;;;AAKD,MAAaC,4BAA8C;CACzD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,aAAa;EACtB,MAAM,CAAC,YAAY,SAAS;EAC5B,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,QAAQ;CAClB,QAAQ,EACN,OAAO,CAAC,eAAe,EACxB;CACF"}
+{"version":3,"file":"dashboard.presentation.js","names":[],"sources":["../../src/dashboard/dashboard.presentation.ts"],"sourcesContent":["import { definePresentation, StabilityEnum } from '@contractspec/lib.contracts';\n\n/**\n * Main dashboard presentation for the SaaS application.\n */\nexport const SaasDashboardPresentation = definePresentation({\n  meta: {\n    key: 'saas.dashboard',\n    version: '1.0.0',\n    title: 'SaaS Dashboard',\n    description:\n      'Main SaaS dashboard with project overview, usage stats, and quick actions',\n    domain: 'saas-boilerplate',\n    owners: ['@saas-team'],\n    tags: ['dashboard', 'overview'],\n    stability: StabilityEnum.Beta,\n    goal: 'Overview of SaaS activity and metrics',\n    context: 'Main dashboard',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'SaasDashboard',\n  },\n  targets: ['react', 'markdown'],\n  policy: {\n    flags: ['saas.enabled'],\n  },\n});\n\n/**\n * Settings panel presentation.\n */\nexport const SettingsPanelPresentation = definePresentation({\n  meta: {\n    key: 'saas.settings',\n    version: '1.0.0',\n    title: 'Settings Panel',\n    description: 'Organization and user settings panel',\n    domain: 'saas-boilerplate',\n    owners: ['@saas-team'],\n    tags: ['settings', 'config'],\n    stability: StabilityEnum.Beta,\n    goal: 'Configure organization and user settings',\n    context: 'Settings section',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'SettingsPanel',\n  },\n  targets: ['react'],\n  policy: {\n    flags: ['saas.enabled'],\n  },\n});\n"],"mappings":";;;;;;AAKA,MAAa,4BAA4B,mBAAmB;CAC1D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,aAAa;EACtB,MAAM,CAAC,aAAa,WAAW;EAC/B,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,SAAS,WAAW;CAC9B,QAAQ,EACN,OAAO,CAAC,eAAe,EACxB;CACF,CAAC;;;;AAKF,MAAa,4BAA4B,mBAAmB;CAC1D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,aAAa;EACtB,MAAM,CAAC,YAAY,SAAS;EAC5B,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,QAAQ;CAClB,QAAQ,EACN,OAAO,CAAC,eAAe,EACxB;CACF,CAAC"}

package/dist/example.d.ts

@@ -1,7 +1,7 @@
-import { ExampleSpec } from "@contractspec/lib.contracts";
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
 
 //#region src/example.d.ts
-declare const example: ExampleSpec;
+declare const example: _contractspec_lib_contracts0.ExampleSpec;
 //#endregion
 export { example as default };
 //# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SAAS"}
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SAiCJ,4BAAA,CAjCW"}

package/dist/example.js

@@ -1,5 +1,7 @@
+import { defineExample } from "@contractspec/lib.contracts";
+
 //#region src/example.ts
-const example = {
+const example = defineExample({
 	meta: {
 		key: "saas-boilerplate",
 		version: "1.0.0",
@@ -43,7 +45,7 @@ const example = {
 		},
 		mcp: { enabled: true }
 	}
-};
+});
 var example_default = example;
 
 //#endregion

package/dist/example.js.map

@@ -1 +1 @@
-{"version":3,"file":"example.js","names":["example: ExampleSpec"],"sources":["../src/example.ts"],"sourcesContent":["import type { ExampleSpec } from '@contractspec/lib.contracts';\n\nconst example: ExampleSpec = {\n  meta: {\n    key: 'saas-boilerplate',\n    version: '1.0.0',\n    title: 'SaaS Boilerplate',\n    description:\n      'Multi-tenant SaaS foundation with orgs, projects, settings, billing usage, and RBAC.',\n    kind: 'template',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['saas', 'multi-tenant', 'billing', 'rbac'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.saas-boilerplate',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.saas-boilerplate',\n    feature: './feature',\n    contracts: './contracts',\n    presentations: './presentations',\n    handlers: './handlers',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: {\n      enabled: true,\n      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],\n    },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n};\n\nexport default example;\n"],"mappings":";AAEA,MAAMA,UAAuB;CAC3B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAQ;GAAgB;GAAW;GAAO;EAClD;CACD,MAAM,EACJ,WAAW,kCACZ;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,WAAW;EACX,eAAe;EACf,UAAU;EACV,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GACP,SAAS;GACT,OAAO;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY;GACnE;EACD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'saas-boilerplate',\n    version: '1.0.0',\n    title: 'SaaS Boilerplate',\n    description:\n      'Multi-tenant SaaS foundation with orgs, projects, settings, billing usage, and RBAC.',\n    kind: 'template',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['saas', 'multi-tenant', 'billing', 'rbac'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.saas-boilerplate',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.saas-boilerplate',\n    feature: './feature',\n    contracts: './contracts',\n    presentations: './presentations',\n    handlers: './handlers',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: {\n      enabled: true,\n      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],\n    },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAQ;GAAgB;GAAW;GAAO;EAClD;CACD,MAAM,EACJ,WAAW,kCACZ;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,WAAW;EACX,eAAe;EACf,UAAU;EACV,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GACP,SAAS;GACT,OAAO;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY;GACnE;EACD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC;AAEF,sBAAe"}

package/dist/handlers/index.d.ts

@@ -1,3 +1,4 @@
 import { mockCheckFeatureAccessHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockRecordUsageHandler } from "../billing/billing.handler.js";
 import { mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler } from "../project/project.handler.js";
-export { mockCheckFeatureAccessHandler, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockListProjectsHandler, mockRecordUsageHandler, mockUpdateProjectHandler };
+import { CreateProjectInput, ListProjectsInput, ListProjectsOutput, Project, SaasHandlers, Subscription, UpdateProjectInput, createSaasHandlers } from "./saas.handlers.js";
+export { CreateProjectInput, ListProjectsInput, ListProjectsOutput, Project, SaasHandlers, Subscription, UpdateProjectInput, createSaasHandlers, mockCheckFeatureAccessHandler, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockListProjectsHandler, mockRecordUsageHandler, mockUpdateProjectHandler };

package/dist/handlers/index.js

@@ -1,4 +1,5 @@
 import { mockCheckFeatureAccessHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockRecordUsageHandler } from "../billing/billing.handler.js";
 import { mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler } from "../project/project.handler.js";
+import { createSaasHandlers } from "./saas.handlers.js";
 
-export { mockCheckFeatureAccessHandler, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockListProjectsHandler, mockRecordUsageHandler, mockUpdateProjectHandler };
+export { createSaasHandlers, mockCheckFeatureAccessHandler, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockListProjectsHandler, mockRecordUsageHandler, mockUpdateProjectHandler };

package/dist/handlers/saas.handlers.d.ts

@@ -0,0 +1,68 @@
+import { DatabasePort } from "@contractspec/lib.runtime-sandbox";
+
+//#region src/handlers/saas.handlers.d.ts
+
+interface Project {
+  id: string;
+  projectId: string;
+  organizationId: string;
+  name: string;
+  description?: string;
+  status: 'DRAFT' | 'ACTIVE' | 'ARCHIVED';
+  tier: 'FREE' | 'PRO' | 'ENTERPRISE';
+  createdAt: Date;
+  updatedAt: Date;
+}
+interface Subscription {
+  id: string;
+  projectId: string;
+  organizationId: string;
+  plan: 'FREE' | 'PRO' | 'ENTERPRISE';
+  status: 'ACTIVE' | 'PAST_DUE' | 'CANCELED';
+  billingCycle: 'MONTHLY' | 'YEARLY';
+  currentPeriodStart: Date;
+  currentPeriodEnd: Date;
+  cancelAtPeriodEnd: boolean;
+}
+interface ListProjectsInput {
+  projectId: string;
+  organizationId?: string;
+  status?: Project['status'] | 'all';
+  search?: string;
+  limit?: number;
+  offset?: number;
+}
+interface ListProjectsOutput {
+  items: Project[];
+  total: number;
+  hasMore: boolean;
+}
+interface CreateProjectInput {
+  name: string;
+  description?: string;
+  tier?: Project['tier'];
+}
+interface UpdateProjectInput {
+  id: string;
+  name?: string;
+  description?: string;
+  status?: Project['status'];
+}
+declare function createSaasHandlers(db: DatabasePort): {
+  listProjects: (input: ListProjectsInput) => Promise<ListProjectsOutput>;
+  getProject: (id: string) => Promise<Project | null>;
+  createProject: (input: CreateProjectInput, context: {
+    projectId: string;
+    organizationId: string;
+  }) => Promise<Project>;
+  updateProject: (input: UpdateProjectInput) => Promise<Project>;
+  deleteProject: (id: string) => Promise<void>;
+  getSubscription: (input: {
+    projectId: string;
+    organizationId?: string;
+  }) => Promise<Subscription | null>;
+};
+type SaasHandlers = ReturnType<typeof createSaasHandlers>;
+//#endregion
+export { CreateProjectInput, ListProjectsInput, ListProjectsOutput, Project, SaasHandlers, Subscription, UpdateProjectInput, createSaasHandlers };
+//# sourceMappingURL=saas.handlers.d.ts.map

package/dist/handlers/saas.handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"saas.handlers.d.ts","names":[],"sources":["../../src/handlers/saas.handlers.ts"],"sourcesContent":[],"mappings":";;;;AA6CiB,UAjCA,OAAA,CAiCkB;EAMlB,EAAA,EAAA,MAAA;EAMA,SAAA,EAAA,MAAA;EA+DD,cAAA,EAAA,MAAkB;EAAK,IAAA,EAAA,MAAA;EAK5B,WAAA,CAAA,EAAA,MAAA;EACE,MAAA,EAAA,OAAA,GAAA,QAAA,GAAA,UAAA;EAAR,IAAA,EAAA,MAAA,GAAA,KAAA,GAAA,YAAA;EAqD4C,SAAA,EA/JpC,IA+JoC;EAAR,SAAA,EA9J5B,IA8J4B;;AAa5B,UAxKI,YAAA,CAwKJ;EAAR,EAAA,EAAA,MAAA;EA8BiC,SAAA,EAAA,MAAA;EAA6B,cAAA,EAAA,MAAA;EAAR,IAAA,EAAA,MAAA,GAAA,KAAA,GAAA,YAAA;EAyCf,MAAA,EAAA,QAAA,GAAA,UAAA,GAAA,UAAA;EAU9B,YAAA,EAAA,SAAA,GAAA,QAAA;EAAR,kBAAA,EAlPgB,IAkPhB;EAAO,gBAAA,EAjPO,IAiPP;EA0BD,iBAAY,EAAA,OAAA;;UAvQP,iBAAA;;;WAGN;;;;;UAMM,kBAAA;SACR;;;;UAKQ,kBAAA;;;SAGR;;UAGQ,kBAAA;;;;WAIN;;iBA2DK,kBAAA,KAAuB;wBAK5B,sBACN,QAAQ;8BAqD4B,QAAQ;yBAWtC;;;QAEN,QAAQ;yBA8ByB,uBAAqB,QAAQ;iCAyCvB;;;;QAUtC,QAAQ;;KA0BF,YAAA,GAAe,kBAAkB"}

package/dist/handlers/saas.handlers.js

@@ -0,0 +1,148 @@
+import { web } from "@contractspec/lib.runtime-sandbox";
+
+//#region src/handlers/saas.handlers.ts
+const { generateId } = web;
+function rowToProject(row) {
+	return {
+		id: row.id,
+		projectId: row.projectId,
+		organizationId: row.organizationId,
+		name: row.name,
+		description: row.description ?? void 0,
+		status: row.status,
+		tier: row.tier,
+		createdAt: new Date(row.createdAt),
+		updatedAt: new Date(row.updatedAt)
+	};
+}
+function rowToSubscription(row) {
+	return {
+		id: row.id,
+		projectId: row.projectId,
+		organizationId: row.organizationId,
+		plan: row.plan,
+		status: row.status,
+		billingCycle: row.billingCycle,
+		currentPeriodStart: new Date(row.currentPeriodStart),
+		currentPeriodEnd: new Date(row.currentPeriodEnd),
+		cancelAtPeriodEnd: Boolean(row.cancelAtPeriodEnd)
+	};
+}
+function createSaasHandlers(db) {
+	/**
+	* List projects
+	*/
+	async function listProjects(input) {
+		const { projectId, organizationId, status, search, limit = 20, offset = 0 } = input;
+		let whereClause = "WHERE projectId = ?";
+		const params = [projectId];
+		if (organizationId) {
+			whereClause += " AND organizationId = ?";
+			params.push(organizationId);
+		}
+		if (status && status !== "all") {
+			whereClause += " AND status = ?";
+			params.push(status);
+		}
+		if (search) {
+			whereClause += " AND (name LIKE ? OR description LIKE ?)";
+			params.push(`%${search}%`, `%${search}%`);
+		}
+		const total = (await db.query(`SELECT COUNT(*) as count FROM saas_project ${whereClause}`, params)).rows[0]?.count ?? 0;
+		const rows = (await db.query(`SELECT * FROM saas_project ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`, [
+			...params,
+			limit,
+			offset
+		])).rows;
+		return {
+			items: rows.map(rowToProject),
+			total,
+			hasMore: offset + rows.length < total
+		};
+	}
+	/**
+	* Get a single project
+	*/
+	async function getProject(id) {
+		const rows = (await db.query(`SELECT * FROM saas_project WHERE id = ?`, [id])).rows;
+		return rows[0] ? rowToProject(rows[0]) : null;
+	}
+	/**
+	* Create a project
+	*/
+	async function createProject(input, context) {
+		const id = generateId("proj");
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		await db.execute(`INSERT INTO saas_project (id, projectId, organizationId, name, description, status, tier, createdAt, updatedAt)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+			id,
+			context.projectId,
+			context.organizationId,
+			input.name,
+			input.description ?? null,
+			"DRAFT",
+			input.tier ?? "FREE",
+			now,
+			now
+		]);
+		const rows = (await db.query(`SELECT * FROM saas_project WHERE id = ?`, [id])).rows;
+		return rowToProject(rows[0]);
+	}
+	/**
+	* Update a project
+	*/
+	async function updateProject(input) {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const updates = ["updatedAt = ?"];
+		const params = [now];
+		if (input.name !== void 0) {
+			updates.push("name = ?");
+			params.push(input.name);
+		}
+		if (input.description !== void 0) {
+			updates.push("description = ?");
+			params.push(input.description);
+		}
+		if (input.status !== void 0) {
+			updates.push("status = ?");
+			params.push(input.status);
+		}
+		params.push(input.id);
+		await db.execute(`UPDATE saas_project SET ${updates.join(", ")} WHERE id = ?`, params);
+		const rows = (await db.query(`SELECT * FROM saas_project WHERE id = ?`, [input.id])).rows;
+		if (!rows[0]) throw new Error("NOT_FOUND");
+		return rowToProject(rows[0]);
+	}
+	/**
+	* Delete a project
+	*/
+	async function deleteProject(id) {
+		await db.execute(`DELETE FROM saas_project WHERE id = ?`, [id]);
+	}
+	/**
+	* Get subscription for an organization
+	*/
+	async function getSubscription(input) {
+		let query = `SELECT * FROM saas_subscription WHERE projectId = ?`;
+		const params = [input.projectId];
+		if (input.organizationId) {
+			query += " AND organizationId = ?";
+			params.push(input.organizationId);
+		}
+		query += " LIMIT 1";
+		const rows = (await db.query(query, params)).rows;
+		return rows[0] ? rowToSubscription(rows[0]) : null;
+	}
+	return {
+		listProjects,
+		getProject,
+		createProject,
+		updateProject,
+		deleteProject,
+		getSubscription
+	};
+}
+
+//#endregion
+export { createSaasHandlers };
+//# sourceMappingURL=saas.handlers.js.map

package/dist/handlers/saas.handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"saas.handlers.js","names":[],"sources":["../../src/handlers/saas.handlers.ts"],"sourcesContent":["/**\n * Runtime-local SaaS Boilerplate handlers\n *\n * Database-backed handlers for project and billing management.\n */\nimport type { DatabasePort } from '@contractspec/lib.runtime-sandbox';\n/* eslint-disable @typescript-eslint/no-non-null-assertion */\nimport { web } from '@contractspec/lib.runtime-sandbox';\nconst { generateId } = web;\n\n// ============ Types ============\n\nexport interface Project {\n  id: string;\n  projectId: string;\n  organizationId: string;\n  name: string;\n  description?: string;\n  status: 'DRAFT' | 'ACTIVE' | 'ARCHIVED';\n  tier: 'FREE' | 'PRO' | 'ENTERPRISE';\n  createdAt: Date;\n  updatedAt: Date;\n}\n\nexport interface Subscription {\n  id: string;\n  projectId: string;\n  organizationId: string;\n  plan: 'FREE' | 'PRO' | 'ENTERPRISE';\n  status: 'ACTIVE' | 'PAST_DUE' | 'CANCELED';\n  billingCycle: 'MONTHLY' | 'YEARLY';\n  currentPeriodStart: Date;\n  currentPeriodEnd: Date;\n  cancelAtPeriodEnd: boolean;\n}\n\nexport interface ListProjectsInput {\n  projectId: string;\n  organizationId?: string;\n  status?: Project['status'] | 'all';\n  search?: string;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface ListProjectsOutput {\n  items: Project[];\n  total: number;\n  hasMore: boolean;\n}\n\nexport interface CreateProjectInput {\n  name: string;\n  description?: string;\n  tier?: Project['tier'];\n}\n\nexport interface UpdateProjectInput {\n  id: string;\n  name?: string;\n  description?: string;\n  status?: Project['status'];\n}\n\n// ============ Row Types ============\n\ninterface ProjectRow extends Record<string, unknown> {\n  id: string;\n  projectId: string;\n  organizationId: string;\n  name: string;\n  description: string | null;\n  status: string;\n  tier: string;\n  createdAt: string;\n  updatedAt: string;\n}\n\ninterface SubscriptionRow extends Record<string, unknown> {\n  id: string;\n  projectId: string;\n  organizationId: string;\n  plan: string;\n  status: string;\n  billingCycle: string;\n  currentPeriodStart: string;\n  currentPeriodEnd: string;\n  cancelAtPeriodEnd: number;\n}\n\nfunction rowToProject(row: ProjectRow): Project {\n  return {\n    id: row.id,\n    projectId: row.projectId,\n    organizationId: row.organizationId,\n    name: row.name,\n    description: row.description ?? undefined,\n    status: row.status as Project['status'],\n    tier: row.tier as Project['tier'],\n    createdAt: new Date(row.createdAt),\n    updatedAt: new Date(row.updatedAt),\n  };\n}\n\nfunction rowToSubscription(row: SubscriptionRow): Subscription {\n  return {\n    id: row.id,\n    projectId: row.projectId,\n    organizationId: row.organizationId,\n    plan: row.plan as Subscription['plan'],\n    status: row.status as Subscription['status'],\n    billingCycle: row.billingCycle as Subscription['billingCycle'],\n    currentPeriodStart: new Date(row.currentPeriodStart),\n    currentPeriodEnd: new Date(row.currentPeriodEnd),\n    cancelAtPeriodEnd: Boolean(row.cancelAtPeriodEnd),\n  };\n}\n\n// ============ Handler Factory ============\n\nexport function createSaasHandlers(db: DatabasePort) {\n  /**\n   * List projects\n   */\n  async function listProjects(\n    input: ListProjectsInput\n  ): Promise<ListProjectsOutput> {\n    const {\n      projectId,\n      organizationId,\n      status,\n      search,\n      limit = 20,\n      offset = 0,\n    } = input;\n\n    let whereClause = 'WHERE projectId = ?';\n    const params: (string | number)[] = [projectId];\n\n    if (organizationId) {\n      whereClause += ' AND organizationId = ?';\n      params.push(organizationId);\n    }\n\n    if (status && status !== 'all') {\n      whereClause += ' AND status = ?';\n      params.push(status);\n    }\n\n    if (search) {\n      whereClause += ' AND (name LIKE ? OR description LIKE ?)';\n      params.push(`%${search}%`, `%${search}%`);\n    }\n\n    const countResult = (\n      await db.query(\n        `SELECT COUNT(*) as count FROM saas_project ${whereClause}`,\n        params\n      )\n    ).rows as unknown as { count: number }[];\n    const total = countResult[0]?.count ?? 0;\n\n    const rows = (\n      await db.query(\n        `SELECT * FROM saas_project ${whereClause} ORDER BY createdAt DESC LIMIT ? OFFSET ?`,\n        [...params, limit, offset]\n      )\n    ).rows as unknown as ProjectRow[];\n\n    return {\n      items: rows.map(rowToProject),\n      total,\n      hasMore: offset + rows.length < total,\n    };\n  }\n\n  /**\n   * Get a single project\n   */\n  async function getProject(id: string): Promise<Project | null> {\n    const rows = (\n      await db.query(`SELECT * FROM saas_project WHERE id = ?`, [id])\n    ).rows as unknown as ProjectRow[];\n    return rows[0] ? rowToProject(rows[0]) : null;\n  }\n\n  /**\n   * Create a project\n   */\n  async function createProject(\n    input: CreateProjectInput,\n    context: { projectId: string; organizationId: string }\n  ): Promise<Project> {\n    const id = generateId('proj');\n    const now = new Date().toISOString();\n\n    await db.execute(\n      `INSERT INTO saas_project (id, projectId, organizationId, name, description, status, tier, createdAt, updatedAt)\n       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n      [\n        id,\n        context.projectId,\n        context.organizationId,\n        input.name,\n        input.description ?? null,\n        'DRAFT',\n        input.tier ?? 'FREE',\n        now,\n        now,\n      ]\n    );\n\n    const rows = (\n      await db.query(`SELECT * FROM saas_project WHERE id = ?`, [id])\n    ).rows as unknown as ProjectRow[];\n\n    return rowToProject(rows[0]!);\n  }\n\n  /**\n   * Update a project\n   */\n  async function updateProject(input: UpdateProjectInput): Promise<Project> {\n    const now = new Date().toISOString();\n    const updates: string[] = ['updatedAt = ?'];\n    const params: (string | null)[] = [now];\n\n    if (input.name !== undefined) {\n      updates.push('name = ?');\n      params.push(input.name);\n    }\n\n    if (input.description !== undefined) {\n      updates.push('description = ?');\n      params.push(input.description);\n    }\n\n    if (input.status !== undefined) {\n      updates.push('status = ?');\n      params.push(input.status);\n    }\n\n    params.push(input.id);\n\n    await db.execute(\n      `UPDATE saas_project SET ${updates.join(', ')} WHERE id = ?`,\n      params\n    );\n\n    const rows = (\n      await db.query(`SELECT * FROM saas_project WHERE id = ?`, [input.id])\n    ).rows as unknown as ProjectRow[];\n\n    if (!rows[0]) {\n      throw new Error('NOT_FOUND');\n    }\n\n    return rowToProject(rows[0]);\n  }\n\n  /**\n   * Delete a project\n   */\n  async function deleteProject(id: string): Promise<void> {\n    await db.execute(`DELETE FROM saas_project WHERE id = ?`, [id]);\n  }\n\n  /**\n   * Get subscription for an organization\n   */\n  async function getSubscription(input: {\n    projectId: string;\n    organizationId?: string;\n  }): Promise<Subscription | null> {\n    let query = `SELECT * FROM saas_subscription WHERE projectId = ?`;\n    const params: string[] = [input.projectId];\n\n    if (input.organizationId) {\n      query += ' AND organizationId = ?';\n      params.push(input.organizationId);\n    }\n\n    query += ' LIMIT 1';\n\n    const rows = (await db.query(query, params))\n      .rows as unknown as SubscriptionRow[];\n    return rows[0] ? rowToSubscription(rows[0]) : null;\n  }\n\n  return {\n    listProjects,\n    getProject,\n    createProject,\n    updateProject,\n    deleteProject,\n    getSubscription,\n  };\n}\n\nexport type SaasHandlers = ReturnType<typeof createSaasHandlers>;\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -10,6 +10,7 @@ import { SaasDashboardPresentation, SettingsPanelPresentation } from "./dashboar
 import "./dashboard/index.js";
 import example from "./example.js";
 import { CreateProjectInput, ListProjectsInput, ListProjectsOutput, Project, UpdateProjectInput, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler } from "./project/project.handler.js";
+import { SaasHandlers, createSaasHandlers } from "./handlers/saas.handlers.js";
 import { ProjectStatusFilterEnum, ProjectStatusSchemaEnum } from "./project/project.enum.js";
 import { CreateProjectInputModel, DeleteProjectInputModel, DeleteProjectOutputModel, GetProjectInputModel, ListProjectsInputModel, ListProjectsOutputModel, ProjectDeletedPayloadModel, ProjectModel, UpdateProjectInputModel } from "./project/project.schema.js";
 import { CreateProjectContract, DeleteProjectContract, GetProjectContract, ListProjectsContract, UpdateProjectContract } from "./project/project.operations.js";
@@ -21,6 +22,17 @@ import { SettingsScopeEnum } from "./settings/settings.enum.js";
 import { FeatureFlagEntity, SettingsEntity } from "./settings/settings.entity.js";
 import "./settings/index.js";
 import { SaasBoilerplateFeature } from "./saas-boilerplate.feature.js";
+import { SaasDashboard } from "./ui/SaasDashboard.js";
+import { SaasProjectList } from "./ui/SaasProjectList.js";
+import { SaasSettingsPanel } from "./ui/SaasSettingsPanel.js";
+import { CreateProjectModal } from "./ui/modals/CreateProjectModal.js";
+import { ProjectActionsModal } from "./ui/modals/ProjectActionsModal.js";
+import { UseProjectListOptions, useProjectList } from "./ui/hooks/useProjectList.js";
+import { UseProjectMutationsOptions, useProjectMutations } from "./ui/hooks/useProjectMutations.js";
+import { projectListReactRenderer } from "./ui/renderers/project-list.renderer.js";
+import { projectListMarkdownRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer } from "./ui/renderers/project-list.markdown.js";
+import { saasDemoOverlay, saasFreeUserOverlay, saasOverlays } from "./ui/overlays/demo-overlays.js";
+import "./ui/index.js";
 import { ModuleSchemaContribution } from "@contractspec/lib.schema";
 
 //#region src/index.d.ts
@@ -38,5 +50,5 @@ declare const schemaComposition: {
   outputPath: string;
 };
 //#endregion
-export { BillingUsageEntity, CheckFeatureAccessContract, CheckFeatureAccessInput, CheckFeatureAccessInputModel, CheckFeatureAccessOutput, CheckFeatureAccessOutputModel, CreateProjectContract, CreateProjectInput, CreateProjectInputModel, DeleteProjectContract, DeleteProjectInputModel, DeleteProjectOutputModel, FeatureAccessReasonEnum, FeatureFlagEntity, GetProjectContract, GetProjectInputModel, GetSubscriptionContract, GetUsageSummaryContract, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, ListProjectsContract, ListProjectsInput, ListProjectsInputModel, ListProjectsOutput, ListProjectsOutputModel, Project, ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectDeletedPayloadModel, ProjectDetailPresentation, ProjectEntity, ProjectListPresentation, ProjectMemberEntity, ProjectModel, ProjectStatusEnum, ProjectStatusFilterEnum, ProjectStatusSchemaEnum, ProjectUpdatedEvent, RecordUsageContract, RecordUsageInput, RecordUsageInputModel, RecordUsageOutputModel, SaasBoilerplateFeature, SaasDashboardPresentation, SettingsEntity, SettingsPanelPresentation, SettingsScopeEnum, Subscription, SubscriptionChangedEvent, SubscriptionEntity, SubscriptionModel, SubscriptionPresentation, SubscriptionStatusEnum, SubscriptionStatusSchemaEnum, UpdateProjectContract, UpdateProjectInput, UpdateProjectInputModel, UsageDashboardPresentation, UsageLimitEntity, UsageLimitReachedEvent, UsageRecordedEvent, UsageRecordedPayloadModel, UsageSummary, UsageSummaryModel, example, mockCheckFeatureAccessHandler, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockListProjectsHandler, mockRecordUsageHandler, mockUpdateProjectHandler, saasBoilerplateSchemaContribution, schemaComposition };
+export { BillingUsageEntity, CheckFeatureAccessContract, CheckFeatureAccessInput, CheckFeatureAccessInputModel, CheckFeatureAccessOutput, CheckFeatureAccessOutputModel, CreateProjectContract, CreateProjectInput, CreateProjectInputModel, CreateProjectModal, DeleteProjectContract, DeleteProjectInputModel, DeleteProjectOutputModel, FeatureAccessReasonEnum, FeatureFlagEntity, GetProjectContract, GetProjectInputModel, GetSubscriptionContract, GetUsageSummaryContract, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, ListProjectsContract, ListProjectsInput, ListProjectsInputModel, ListProjectsOutput, ListProjectsOutputModel, Project, ProjectActionsModal, ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectDeletedPayloadModel, ProjectDetailPresentation, ProjectEntity, ProjectListPresentation, ProjectMemberEntity, ProjectModel, ProjectStatusEnum, ProjectStatusFilterEnum, ProjectStatusSchemaEnum, ProjectUpdatedEvent, RecordUsageContract, RecordUsageInput, RecordUsageInputModel, RecordUsageOutputModel, SaasBoilerplateFeature, SaasDashboard, SaasDashboardPresentation, type SaasHandlers, SaasProjectList, SaasSettingsPanel, SettingsEntity, SettingsPanelPresentation, SettingsScopeEnum, Subscription, SubscriptionChangedEvent, SubscriptionEntity, SubscriptionModel, SubscriptionPresentation, SubscriptionStatusEnum, SubscriptionStatusSchemaEnum, UpdateProjectContract, UpdateProjectInput, UpdateProjectInputModel, UsageDashboardPresentation, UsageLimitEntity, UsageLimitReachedEvent, UsageRecordedEvent, UsageRecordedPayloadModel, UsageSummary, UsageSummaryModel, UseProjectListOptions, UseProjectMutationsOptions, createSaasHandlers, example, mockCheckFeatureAccessHandler, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockListProjectsHandler, mockRecordUsageHandler, mockUpdateProjectHandler, projectListMarkdownRenderer, projectListReactRenderer, saasBillingMarkdownRenderer, saasBoilerplateSchemaContribution, saasDashboardMarkdownRenderer, saasDemoOverlay, saasFreeUserOverlay, saasOverlays, schemaComposition, useProjectList, useProjectMutations };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA0Ca,mCAAmC;;;;;cAkBnC;WAUZ"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA+Ca,mCAAmC;;;;;cAkBnC;WAUZ"}

package/dist/index.js

@@ -21,6 +21,18 @@ import "./settings/index.js";
 import { SaasDashboardPresentation, SettingsPanelPresentation } from "./dashboard/dashboard.presentation.js";
 import "./dashboard/index.js";
 import { SaasBoilerplateFeature } from "./saas-boilerplate.feature.js";
+import { useProjectList } from "./ui/hooks/useProjectList.js";
+import { useProjectMutations } from "./ui/hooks/useProjectMutations.js";
+import { CreateProjectModal } from "./ui/modals/CreateProjectModal.js";
+import { ProjectActionsModal } from "./ui/modals/ProjectActionsModal.js";
+import { SaasDashboard } from "./ui/SaasDashboard.js";
+import { SaasProjectList } from "./ui/SaasProjectList.js";
+import { SaasSettingsPanel } from "./ui/SaasSettingsPanel.js";
+import { projectListReactRenderer } from "./ui/renderers/project-list.renderer.js";
+import { projectListMarkdownRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer } from "./ui/renderers/project-list.markdown.js";
+import { saasDemoOverlay, saasFreeUserOverlay, saasOverlays } from "./ui/overlays/demo-overlays.js";
+import "./ui/index.js";
+import { createSaasHandlers } from "./handlers/saas.handlers.js";
 import "./docs/index.js";
 import { identityRbacSchemaContribution } from "@contractspec/lib.identity-rbac";
 import { jobsSchemaContribution } from "@contractspec/lib.jobs";
@@ -65,5 +77,5 @@ const schemaComposition = {
 };
 
 //#endregion
-export { BillingUsageEntity, CheckFeatureAccessContract, CheckFeatureAccessInputModel, CheckFeatureAccessOutputModel, CreateProjectContract, CreateProjectInputModel, DeleteProjectContract, DeleteProjectInputModel, DeleteProjectOutputModel, FeatureAccessReasonEnum, FeatureFlagEntity, GetProjectContract, GetProjectInputModel, GetSubscriptionContract, GetUsageSummaryContract, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, ListProjectsContract, ListProjectsInputModel, ListProjectsOutputModel, ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectDeletedPayloadModel, ProjectDetailPresentation, ProjectEntity, ProjectListPresentation, ProjectMemberEntity, ProjectModel, ProjectStatusEnum, ProjectStatusFilterEnum, ProjectStatusSchemaEnum, ProjectUpdatedEvent, RecordUsageContract, RecordUsageInputModel, RecordUsageOutputModel, SaasBoilerplateFeature, SaasDashboardPresentation, SettingsEntity, SettingsPanelPresentation, SettingsScopeEnum, SubscriptionChangedEvent, SubscriptionEntity, SubscriptionModel, SubscriptionPresentation, SubscriptionStatusEnum, SubscriptionStatusSchemaEnum, UpdateProjectContract, UpdateProjectInputModel, UsageDashboardPresentation, UsageLimitEntity, UsageLimitReachedEvent, UsageRecordedEvent, UsageRecordedPayloadModel, UsageSummaryModel, example_default as example, mockCheckFeatureAccessHandler, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockListProjectsHandler, mockRecordUsageHandler, mockUpdateProjectHandler, saasBoilerplateSchemaContribution, schemaComposition };
+export { BillingUsageEntity, CheckFeatureAccessContract, CheckFeatureAccessInputModel, CheckFeatureAccessOutputModel, CreateProjectContract, CreateProjectInputModel, CreateProjectModal, DeleteProjectContract, DeleteProjectInputModel, DeleteProjectOutputModel, FeatureAccessReasonEnum, FeatureFlagEntity, GetProjectContract, GetProjectInputModel, GetSubscriptionContract, GetUsageSummaryContract, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, ListProjectsContract, ListProjectsInputModel, ListProjectsOutputModel, ProjectActionsModal, ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectDeletedPayloadModel, ProjectDetailPresentation, ProjectEntity, ProjectListPresentation, ProjectMemberEntity, ProjectModel, ProjectStatusEnum, ProjectStatusFilterEnum, ProjectStatusSchemaEnum, ProjectUpdatedEvent, RecordUsageContract, RecordUsageInputModel, RecordUsageOutputModel, SaasBoilerplateFeature, SaasDashboard, SaasDashboardPresentation, SaasProjectList, SaasSettingsPanel, SettingsEntity, SettingsPanelPresentation, SettingsScopeEnum, SubscriptionChangedEvent, SubscriptionEntity, SubscriptionModel, SubscriptionPresentation, SubscriptionStatusEnum, SubscriptionStatusSchemaEnum, UpdateProjectContract, UpdateProjectInputModel, UsageDashboardPresentation, UsageLimitEntity, UsageLimitReachedEvent, UsageRecordedEvent, UsageRecordedPayloadModel, UsageSummaryModel, createSaasHandlers, example_default as example, mockCheckFeatureAccessHandler, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockListProjectsHandler, mockRecordUsageHandler, mockUpdateProjectHandler, projectListMarkdownRenderer, projectListReactRenderer, saasBillingMarkdownRenderer, saasBoilerplateSchemaContribution, saasDashboardMarkdownRenderer, saasDemoOverlay, saasFreeUserOverlay, saasOverlays, schemaComposition, useProjectList, useProjectMutations };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["saasBoilerplateSchemaContribution: ModuleSchemaContribution"],"sources":["../src/index.ts"],"sourcesContent":["// SaaS Boilerplate Example\n// Demonstrates ContractSpec principles for a complete SaaS application\n\n// Export all domain modules\nexport * from './billing';\nexport * from './project';\nexport * from './settings';\nexport * from './dashboard';\n\n// Export feature and example metadata\nexport * from './saas-boilerplate.feature';\nexport { default as example } from './example';\n\n// Import docs for registration\nimport './docs';\n\n// Schema composition configuration\nimport { identityRbacSchemaContribution } from '@contractspec/lib.identity-rbac';\nimport { jobsSchemaContribution } from '@contractspec/lib.jobs';\nimport { auditTrailSchemaContribution } from '@contractspec/module.audit-trail';\nimport { notificationsSchemaContribution } from '@contractspec/module.notifications';\nimport type { ModuleSchemaContribution } from '@contractspec/lib.schema';\nimport {\n  ProjectEntity,\n  ProjectMemberEntity,\n  ProjectStatusEnum,\n} from './project/project.entity';\nimport {\n  SettingsEntity,\n  FeatureFlagEntity,\n  SettingsScopeEnum,\n} from './settings';\nimport {\n  SubscriptionEntity,\n  BillingUsageEntity,\n  UsageLimitEntity,\n  SubscriptionStatusEnum,\n} from './billing/billing.entity';\n\n/**\n * SaaS boilerplate schema contribution.\n */\nexport const saasBoilerplateSchemaContribution: ModuleSchemaContribution = {\n  moduleId: '@contractspec/example.saas-boilerplate',\n  entities: [\n    ProjectEntity,\n    ProjectMemberEntity,\n    SettingsEntity,\n    FeatureFlagEntity,\n    SubscriptionEntity,\n    BillingUsageEntity,\n    UsageLimitEntity,\n  ],\n  enums: [ProjectStatusEnum, SettingsScopeEnum, SubscriptionStatusEnum],\n};\n\n/**\n * Complete schema composition for SaaS Boilerplate.\n * Use with `database schema:compose` to generate Prisma schema.\n */\nexport const schemaComposition = {\n  modules: [\n    identityRbacSchemaContribution,\n    jobsSchemaContribution,\n    auditTrailSchemaContribution,\n    notificationsSchemaContribution,\n    saasBoilerplateSchemaContribution,\n  ],\n  provider: 'postgresql' as const,\n  outputPath: './prisma/schema/generated.prisma',\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAaA,oCAA8D;CACzE,UAAU;CACV,UAAU;EACR;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CACD,OAAO;EAAC;EAAmB;EAAmB;EAAuB;CACtE;;;;;AAMD,MAAa,oBAAoB;CAC/B,SAAS;EACP;EACA;EACA;EACA;EACA;EACD;CACD,UAAU;CACV,YAAY;CACb"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["// SaaS Boilerplate Example\n// Demonstrates ContractSpec principles for a complete SaaS application\n\n// Export all domain modules\nexport * from './billing';\nexport * from './project';\nexport * from './settings';\nexport * from './dashboard';\n\n// Export feature and example metadata\nexport * from './saas-boilerplate.feature';\nexport * from './ui';\nexport {\n  createSaasHandlers,\n  type SaasHandlers,\n} from './handlers/saas.handlers';\nexport { default as example } from './example';\n\n// Import docs for registration\nimport './docs';\n\n// Schema composition configuration\nimport { identityRbacSchemaContribution } from '@contractspec/lib.identity-rbac';\nimport { jobsSchemaContribution } from '@contractspec/lib.jobs';\nimport { auditTrailSchemaContribution } from '@contractspec/module.audit-trail';\nimport { notificationsSchemaContribution } from '@contractspec/module.notifications';\nimport type { ModuleSchemaContribution } from '@contractspec/lib.schema';\nimport {\n  ProjectEntity,\n  ProjectMemberEntity,\n  ProjectStatusEnum,\n} from './project/project.entity';\nimport {\n  SettingsEntity,\n  FeatureFlagEntity,\n  SettingsScopeEnum,\n} from './settings';\nimport {\n  SubscriptionEntity,\n  BillingUsageEntity,\n  UsageLimitEntity,\n  SubscriptionStatusEnum,\n} from './billing/billing.entity';\n\n/**\n * SaaS boilerplate schema contribution.\n */\nexport const saasBoilerplateSchemaContribution: ModuleSchemaContribution = {\n  moduleId: '@contractspec/example.saas-boilerplate',\n  entities: [\n    ProjectEntity,\n    ProjectMemberEntity,\n    SettingsEntity,\n    FeatureFlagEntity,\n    SubscriptionEntity,\n    BillingUsageEntity,\n    UsageLimitEntity,\n  ],\n  enums: [ProjectStatusEnum, SettingsScopeEnum, SubscriptionStatusEnum],\n};\n\n/**\n * Complete schema composition for SaaS Boilerplate.\n * Use with `database schema:compose` to generate Prisma schema.\n */\nexport const schemaComposition = {\n  modules: [\n    identityRbacSchemaContribution,\n    jobsSchemaContribution,\n    auditTrailSchemaContribution,\n    notificationsSchemaContribution,\n    saasBoilerplateSchemaContribution,\n  ],\n  provider: 'postgresql' as const,\n  outputPath: './prisma/schema/generated.prisma',\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,MAAa,oCAA8D;CACzE,UAAU;CACV,UAAU;EACR;EACA;EACA;EACA;EACA;EACA;EACA;EACD;CACD,OAAO;EAAC;EAAmB;EAAmB;EAAuB;CACtE;;;;;AAMD,MAAa,oBAAoB;CAC/B,SAAS;EACP;EACA;EACA;EACA;EACA;EACD;CACD,UAAU;CACV,YAAY;CACb"}

package/dist/project/project.event.d.ts

@@ -1,11 +1,11 @@
+import * as _contractspec_lib_contracts12 from "@contractspec/lib.contracts";
 import * as _contractspec_lib_schema172 from "@contractspec/lib.schema";
-import * as _contractspec_lib_contracts6 from "@contractspec/lib.contracts";
 
 //#region src/project/project.event.d.ts
 /**
  * Event: A new project has been created.
  */
-declare const ProjectCreatedEvent: _contractspec_lib_contracts6.EventSpec<_contractspec_lib_schema172.SchemaModel<{
+declare const ProjectCreatedEvent: _contractspec_lib_contracts12.EventSpec<_contractspec_lib_schema172.SchemaModel<{
   projectId: {
     type: _contractspec_lib_schema172.FieldType<string, string>;
     isOptional: false;
@@ -30,7 +30,7 @@ declare const ProjectCreatedEvent: _contractspec_lib_contracts6.EventSpec<_contr
 /**
  * Event: A project has been updated.
  */
-declare const ProjectUpdatedEvent: _contractspec_lib_contracts6.EventSpec<_contractspec_lib_schema172.SchemaModel<{
+declare const ProjectUpdatedEvent: _contractspec_lib_contracts12.EventSpec<_contractspec_lib_schema172.SchemaModel<{
   projectId: {
     type: _contractspec_lib_schema172.FieldType<string, string>;
     isOptional: false;
@@ -52,7 +52,7 @@ declare const ProjectUpdatedEvent: _contractspec_lib_contracts6.EventSpec<_contr
 /**
  * Event: A project has been deleted.
  */
-declare const ProjectDeletedEvent: _contractspec_lib_contracts6.EventSpec<_contractspec_lib_schema172.SchemaModel<{
+declare const ProjectDeletedEvent: _contractspec_lib_contracts12.EventSpec<_contractspec_lib_schema172.SchemaModel<{
   projectId: {
     type: _contractspec_lib_schema172.FieldType<string, string>;
     isOptional: false;
@@ -73,7 +73,7 @@ declare const ProjectDeletedEvent: _contractspec_lib_contracts6.EventSpec<_contr
 /**
  * Event: A project has been archived.
  */
-declare const ProjectArchivedEvent: _contractspec_lib_contracts6.EventSpec<_contractspec_lib_schema172.SchemaModel<{
+declare const ProjectArchivedEvent: _contractspec_lib_contracts12.EventSpec<_contractspec_lib_schema172.SchemaModel<{
   projectId: {
     type: _contractspec_lib_schema172.FieldType<string, string>;
     isOptional: false;

package/dist/project/project.event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.event.d.ts","names":[],"sources":["../../src/project/project.event.ts"],"sourcesContent":[],"mappings":";;;;;;;cAwEa,qBAAmB,4BAAA,CAAA,sCAAA;EAAnB,SAAA,EAAA;IAUX,IAAA,EAAA,2BAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;EAV8B,cAAA,EAAA;IAAA,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAenB,UAAA,EAAA,KAAA;EAUX,CAAA;;;;;;IAV8B,IAAA,uCAAA,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAenB,CAAA;CAUX,CAAA,CAAA;;;;cAzBW,qBAAmB,4BAAA,CAAA,sCAAA;;IAeA,IAAA,EAL9B,2BAAA,CAAA,SAK8B,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAenB,CAAA;EAUX,aAAA,EAAA;;;;;EAV+B,SAAA,EAAA;IAAA,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;cAfpB,qBAAmB,4BAAA,CAAA,sCAAA;;UAU9B,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;cAKW,sBAAoB,4BAAA,CAAA,sCAAA;;UAU/B,2BAAA,CAAA"}
+{"version":3,"file":"project.event.d.ts","names":[],"sources":["../../src/project/project.event.ts"],"sourcesContent":[],"mappings":";;;;;;;cAwEa,qBAAmB,6BAAA,CAAA,sCAAA;EAAnB,SAAA,EAAA;IAUX,IAAA,EAAA,2BAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;EAV8B,cAAA,EAAA;IAAA,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAenB,UAAA,EAAA,KAAA;EAUX,CAAA;;;;;;IAV8B,IAAA,uCAAA,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAenB,CAAA;CAUX,CAAA,CAAA;;;;cAzBW,qBAAmB,6BAAA,CAAA,sCAAA;;IAeA,IAAA,EAL9B,2BAAA,CAAA,SAK8B,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAenB,CAAA;EAUX,aAAA,EAAA;;;;;EAV+B,SAAA,EAAA;IAAA,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;cAfpB,qBAAmB,6BAAA,CAAA,sCAAA;;UAU9B,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;cAKW,sBAAoB,6BAAA,CAAA,sCAAA;;UAU/B,2BAAA,CAAA"}

package/dist/project/project.event.js

@@ -1,5 +1,5 @@
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 
 //#region src/project/project.event.ts
 /**

package/dist/project/project.operations.d.ts

@@ -1,11 +1,11 @@
+import * as _contractspec_lib_contracts16 from "@contractspec/lib.contracts";
 import * as _contractspec_lib_schema192 from "@contractspec/lib.schema";
-import * as _contractspec_lib_contracts10 from "@contractspec/lib.contracts";
 
 //#region src/project/project.operations.d.ts
 /**
  * Create a new project.
  */
-declare const CreateProjectContract: _contractspec_lib_contracts10.OperationSpec<_contractspec_lib_schema192.SchemaModel<{
+declare const CreateProjectContract: _contractspec_lib_contracts16.OperationSpec<_contractspec_lib_schema192.SchemaModel<{
   name: {
     type: _contractspec_lib_schema192.FieldType<string, string>;
     isOptional: false;
@@ -128,7 +128,7 @@ declare const CreateProjectContract: _contractspec_lib_contracts10.OperationSpec
 /**
  * Get project by ID.
  */
-declare const GetProjectContract: _contractspec_lib_contracts10.OperationSpec<_contractspec_lib_schema192.SchemaModel<{
+declare const GetProjectContract: _contractspec_lib_contracts16.OperationSpec<_contractspec_lib_schema192.SchemaModel<{
   projectId: {
     type: _contractspec_lib_schema192.FieldType<string, string>;
     isOptional: false;
@@ -183,7 +183,7 @@ declare const GetProjectContract: _contractspec_lib_contracts10.OperationSpec<_c
 /**
  * Update a project.
  */
-declare const UpdateProjectContract: _contractspec_lib_contracts10.OperationSpec<_contractspec_lib_schema192.SchemaModel<{
+declare const UpdateProjectContract: _contractspec_lib_contracts16.OperationSpec<_contractspec_lib_schema192.SchemaModel<{
   projectId: {
     type: _contractspec_lib_schema192.FieldType<string, string>;
     isOptional: false;
@@ -314,7 +314,7 @@ declare const UpdateProjectContract: _contractspec_lib_contracts10.OperationSpec
 /**
  * Delete a project.
  */
-declare const DeleteProjectContract: _contractspec_lib_contracts10.OperationSpec<_contractspec_lib_schema192.SchemaModel<{
+declare const DeleteProjectContract: _contractspec_lib_contracts16.OperationSpec<_contractspec_lib_schema192.SchemaModel<{
   projectId: {
     type: _contractspec_lib_schema192.FieldType<string, string>;
     isOptional: false;
@@ -338,7 +338,7 @@ declare const DeleteProjectContract: _contractspec_lib_contracts10.OperationSpec
 /**
  * List organization projects.
  */
-declare const ListProjectsContract: _contractspec_lib_contracts10.OperationSpec<_contractspec_lib_schema192.SchemaModel<{
+declare const ListProjectsContract: _contractspec_lib_contracts16.OperationSpec<_contractspec_lib_schema192.SchemaModel<{
   status: {
     type: _contractspec_lib_schema192.EnumType<[string, string, string, string]>;
     isOptional: true;

package/dist/project/project.presentation.d.ts

@@ -1,15 +1,14 @@
-import { PresentationSpec } from "@contractspec/lib.contracts";
+import * as _contractspec_lib_contracts21 from "@contractspec/lib.contracts";
 
 //#region src/project/project.presentation.d.ts
-
 /**
  * Presentation for displaying a list of projects.
  */
-declare const ProjectListPresentation: PresentationSpec;
+declare const ProjectListPresentation: _contractspec_lib_contracts21.PresentationSpec;
 /**
  * Presentation for project detail view.
  */
-declare const ProjectDetailPresentation: PresentationSpec;
+declare const ProjectDetailPresentation: _contractspec_lib_contracts21.PresentationSpec;
 //#endregion
 export { ProjectDetailPresentation, ProjectListPresentation };
 //# sourceMappingURL=project.presentation.d.ts.map

package/dist/project/project.presentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.presentation.d.ts","names":[],"sources":["../../src/project/project.presentation.ts"],"sourcesContent":[],"mappings":";;;;;;AAOA;AA6Ba,cA7BA,uBA6B2B,EA7BF,gBAmDrC;;;;cAtBY,2BAA2B"}
+{"version":3,"file":"project.presentation.d.ts","names":[],"sources":["../../src/project/project.presentation.ts"],"sourcesContent":[],"mappings":";;;;;;AAMa,cAAA,uBAwBX,EAAA,6BAAA,CAxBkC,gBAwBlC;AAKF;;;cAAa,2BAsBX,6BAAA,CAtBoC"}

package/dist/project/project.presentation.js

@@ -1,11 +1,11 @@
 import { ProjectModel } from "./project.schema.js";
-import { StabilityEnum } from "@contractspec/lib.contracts";
+import { StabilityEnum, definePresentation } from "@contractspec/lib.contracts";
 
 //#region src/project/project.presentation.ts
 /**
 * Presentation for displaying a list of projects.
 */
-const ProjectListPresentation = {
+const ProjectListPresentation = definePresentation({
 	meta: {
 		key: "saas.project.list",
 		version: "1.0.0",
@@ -34,11 +34,11 @@ const ProjectListPresentation = {
 		"application/json"
 	],
 	policy: { flags: ["saas.projects.enabled"] }
-};
+});
 /**
 * Presentation for project detail view.
 */
-const ProjectDetailPresentation = {
+const ProjectDetailPresentation = definePresentation({
 	meta: {
 		key: "saas.project.detail",
 		version: "1.0.0",
@@ -58,7 +58,7 @@ const ProjectDetailPresentation = {
 	},
 	targets: ["react", "markdown"],
 	policy: { flags: ["saas.projects.enabled"] }
-};
+});
 
 //#endregion
 export { ProjectDetailPresentation, ProjectListPresentation };