@contractspec/example.saas-boilerplate 0.0.0-canary-20260113170453

package/dist/ui/renderers/project-list.markdown.d.ts

@@ -0,0 +1,31 @@
+import { PresentationRenderer } from "@contractspec/lib.contracts";
+
+//#region src/ui/renderers/project-list.markdown.d.ts
+
+/**
+ * Markdown renderer for saas-boilerplate.project.list presentation
+ * Only handles ProjectListView component
+ */
+declare const projectListMarkdownRenderer: PresentationRenderer<{
+  mimeType: string;
+  body: string;
+}>;
+/**
+ * Markdown renderer for saas-boilerplate.dashboard presentation
+ * Only handles SaasDashboard component
+ */
+declare const saasDashboardMarkdownRenderer: PresentationRenderer<{
+  mimeType: string;
+  body: string;
+}>;
+/**
+ * Markdown renderer for saas-boilerplate.billing.settings presentation
+ * Only handles SubscriptionView component
+ */
+declare const saasBillingMarkdownRenderer: PresentationRenderer<{
+  mimeType: string;
+  body: string;
+}>;
+//#endregion
+export { projectListMarkdownRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer };
+//# sourceMappingURL=project-list.markdown.d.ts.map

package/dist/ui/renderers/project-list.markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.markdown.d.ts","names":[],"sources":["../../../src/ui/renderers/project-list.markdown.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAsBa,6BAA6B;;;;;;;;cA6D7B,+BAA+B;;;;;;;;cA0F/B,6BAA6B"}

package/dist/ui/renderers/project-list.markdown.js

@@ -0,0 +1,148 @@
+import { mockGetSubscriptionHandler, mockListProjectsHandler } from "@contractspec/example.saas-boilerplate/handlers";
+
+//#region src/ui/renderers/project-list.markdown.ts
+/**
+* Markdown renderer for saas-boilerplate.project.list presentation
+* Only handles ProjectListView component
+*/
+const projectListMarkdownRenderer = {
+	target: "markdown",
+	render: async (desc, _ctx) => {
+		if (desc.source.type !== "component" || desc.source.componentKey !== "ProjectListView") throw new Error("projectListMarkdownRenderer: not ProjectListView");
+		const data = await mockListProjectsHandler({
+			limit: 20,
+			offset: 0
+		});
+		const items = data.projects ?? data.items ?? [];
+		const lines = [
+			"# Projects",
+			"",
+			`**Total**: ${data.total} projects`,
+			""
+		];
+		if (items.length === 0) lines.push("_No projects found._");
+		else {
+			lines.push("| Status | Project | Description |");
+			lines.push("|--------|---------|-------------|");
+			for (const project of items) {
+				const status = project.status === "ACTIVE" ? "✅" : project.status === "ARCHIVED" ? "📦" : "⏸️";
+				lines.push(`| ${status} | **${project.name}** | ${project.description ?? "-"} |`);
+			}
+		}
+		return {
+			mimeType: "text/markdown",
+			body: lines.join("\n")
+		};
+	}
+};
+/**
+* Markdown renderer for saas-boilerplate.dashboard presentation
+* Only handles SaasDashboard component
+*/
+const saasDashboardMarkdownRenderer = {
+	target: "markdown",
+	render: async (desc, _ctx) => {
+		if (desc.source.type !== "component" || desc.source.componentKey !== "SaasDashboard") throw new Error("saasDashboardMarkdownRenderer: not SaasDashboard");
+		const [projectsData, subscription] = await Promise.all([mockListProjectsHandler({ limit: 50 }), mockGetSubscriptionHandler()]);
+		const projects = projectsData.projects ?? [];
+		const activeProjects = projects.filter((p) => p.status === "ACTIVE").length;
+		const archivedProjects = projects.filter((p) => p.status === "ARCHIVED").length;
+		const lines = [
+			"# SaaS Dashboard",
+			"",
+			"> Organization overview and usage summary",
+			"",
+			"## Summary",
+			"",
+			"| Metric | Value |",
+			"|--------|-------|",
+			`| Total Projects | ${projectsData.total} |`,
+			`| Active Projects | ${activeProjects} |`,
+			`| Archived Projects | ${archivedProjects} |`,
+			`| Subscription Plan | ${subscription.planName} |`,
+			`| Subscription Status | ${subscription.status} |`,
+			"",
+			"## Projects",
+			""
+		];
+		if (projects.length === 0) lines.push("_No projects yet._");
+		else {
+			lines.push("| Status | Project | Description |");
+			lines.push("|--------|---------|-------------|");
+			for (const project of projects.slice(0, 10)) {
+				const status = project.status === "ACTIVE" ? "✅" : project.status === "ARCHIVED" ? "📦" : "⏸️";
+				lines.push(`| ${status} | **${project.name}** | ${project.description ?? "-"} |`);
+			}
+			if (projects.length > 10) lines.push(`| ... | ... | _${projectsData.total - 10} more projects_ |`);
+		}
+		lines.push("");
+		lines.push("## Subscription");
+		lines.push("");
+		lines.push(`- **Plan**: ${subscription.planName}`);
+		lines.push(`- **Status**: ${subscription.status}`);
+		if (subscription.currentPeriodEnd) lines.push(`- **Period End**: ${new Date(subscription.currentPeriodEnd).toLocaleDateString()}`);
+		return {
+			mimeType: "text/markdown",
+			body: lines.join("\n")
+		};
+	}
+};
+/**
+* Markdown renderer for saas-boilerplate.billing.settings presentation
+* Only handles SubscriptionView component
+*/
+const saasBillingMarkdownRenderer = {
+	target: "markdown",
+	render: async (desc, _ctx) => {
+		if (desc.source.type !== "component" || desc.source.componentKey !== "SubscriptionView") throw new Error("saasBillingMarkdownRenderer: not SubscriptionView");
+		const subscription = await mockGetSubscriptionHandler();
+		const lines = [
+			"# Billing & Subscription",
+			"",
+			"> Current subscription details and billing information",
+			"",
+			"## Subscription Details",
+			"",
+			"| Property | Value |",
+			"|----------|-------|",
+			`| Plan | ${subscription.planName} |`,
+			`| Status | ${subscription.status} |`,
+			`| ID | ${subscription.id} |`,
+			`| Period Start | ${new Date(subscription.currentPeriodStart).toLocaleDateString()} |`,
+			`| Period End | ${new Date(subscription.currentPeriodEnd).toLocaleDateString()} |`
+		];
+		lines.push("");
+		lines.push("## Plan Limits");
+		lines.push("");
+		lines.push(`- **Projects**: ${subscription.limits.projects}`);
+		lines.push(`- **Users**: ${subscription.limits.users}`);
+		lines.push("");
+		lines.push("## Plan Features");
+		lines.push("");
+		if (subscription.planName.toLowerCase().includes("free")) {
+			lines.push("- ✅ Up to 3 projects");
+			lines.push("- ✅ Basic support");
+			lines.push("- ❌ Priority support");
+			lines.push("- ❌ Advanced analytics");
+		} else if (subscription.planName.toLowerCase().includes("pro")) {
+			lines.push("- ✅ Unlimited projects");
+			lines.push("- ✅ Priority support");
+			lines.push("- ✅ Advanced analytics");
+			lines.push("- ❌ Custom integrations");
+		} else {
+			lines.push("- ✅ Unlimited projects");
+			lines.push("- ✅ Priority support");
+			lines.push("- ✅ Advanced analytics");
+			lines.push("- ✅ Custom integrations");
+			lines.push("- ✅ Dedicated support");
+		}
+		return {
+			mimeType: "text/markdown",
+			body: lines.join("\n")
+		};
+	}
+};
+
+//#endregion
+export { projectListMarkdownRenderer, saasBillingMarkdownRenderer, saasDashboardMarkdownRenderer };
+//# sourceMappingURL=project-list.markdown.js.map

package/dist/ui/renderers/project-list.markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.markdown.js","names":[],"sources":["../../../src/ui/renderers/project-list.markdown.ts"],"sourcesContent":["/**\n * Markdown renderer for SaaS Project List presentation\n *\n * Uses dynamic import to ensure correct build order.\n */\nimport type { PresentationRenderer } from '@contractspec/lib.contracts';\nimport {\n  mockListProjectsHandler,\n  mockGetSubscriptionHandler,\n} from '@contractspec/example.saas-boilerplate/handlers';\n\ninterface ProjectItem {\n  id: string;\n  name: string;\n  status: string;\n  description?: string;\n}\n\n/**\n * Markdown renderer for saas-boilerplate.project.list presentation\n * Only handles ProjectListView component\n */\nexport const projectListMarkdownRenderer: PresentationRenderer<{\n  mimeType: string;\n  body: string;\n}> = {\n  target: 'markdown',\n  render: async (desc, _ctx) => {\n    // Only handle ProjectListView\n    if (\n      desc.source.type !== 'component' ||\n      desc.source.componentKey !== 'ProjectListView'\n    ) {\n      throw new Error('projectListMarkdownRenderer: not ProjectListView');\n    }\n\n    const data = await mockListProjectsHandler({\n      limit: 20,\n      offset: 0,\n    });\n\n    // The example handler returns 'projects', not 'items'\n    const items =\n      (data as { projects?: ProjectItem[]; items?: ProjectItem[] }).projects ??\n      (data as { items?: ProjectItem[] }).items ??\n      [];\n\n    const lines: string[] = [\n      '# Projects',\n      '',\n      `**Total**: ${data.total} projects`,\n      '',\n    ];\n\n    if (items.length === 0) {\n      lines.push('_No projects found._');\n    } else {\n      lines.push('| Status | Project | Description |');\n      lines.push('|--------|---------|-------------|');\n      for (const project of items) {\n        const status =\n          project.status === 'ACTIVE'\n            ? '✅'\n            : project.status === 'ARCHIVED'\n              ? '📦'\n              : '⏸️';\n        lines.push(\n          `| ${status} | **${project.name}** | ${project.description ?? '-'} |`\n        );\n      }\n    }\n\n    return {\n      mimeType: 'text/markdown',\n      body: lines.join('\\n'),\n    };\n  },\n};\n\n/**\n * Markdown renderer for saas-boilerplate.dashboard presentation\n * Only handles SaasDashboard component\n */\nexport const saasDashboardMarkdownRenderer: PresentationRenderer<{\n  mimeType: string;\n  body: string;\n}> = {\n  target: 'markdown',\n  render: async (desc, _ctx) => {\n    // Only handle SaasDashboard\n    if (\n      desc.source.type !== 'component' ||\n      desc.source.componentKey !== 'SaasDashboard'\n    ) {\n      throw new Error('saasDashboardMarkdownRenderer: not SaasDashboard');\n    }\n\n    const [projectsData, subscription] = await Promise.all([\n      mockListProjectsHandler({ limit: 50 }),\n      mockGetSubscriptionHandler(),\n    ]);\n\n    const projects =\n      (projectsData as { projects?: ProjectItem[] }).projects ?? [];\n    const activeProjects = projects.filter((p) => p.status === 'ACTIVE').length;\n    const archivedProjects = projects.filter(\n      (p) => p.status === 'ARCHIVED'\n    ).length;\n\n    const lines: string[] = [\n      '# SaaS Dashboard',\n      '',\n      '> Organization overview and usage summary',\n      '',\n      '## Summary',\n      '',\n      '| Metric | Value |',\n      '|--------|-------|',\n      `| Total Projects | ${projectsData.total} |`,\n      `| Active Projects | ${activeProjects} |`,\n      `| Archived Projects | ${archivedProjects} |`,\n      `| Subscription Plan | ${subscription.planName} |`,\n      `| Subscription Status | ${subscription.status} |`,\n      '',\n      '## Projects',\n      '',\n    ];\n\n    if (projects.length === 0) {\n      lines.push('_No projects yet._');\n    } else {\n      lines.push('| Status | Project | Description |');\n      lines.push('|--------|---------|-------------|');\n      for (const project of projects.slice(0, 10)) {\n        const status =\n          project.status === 'ACTIVE'\n            ? '✅'\n            : project.status === 'ARCHIVED'\n              ? '📦'\n              : '⏸️';\n        lines.push(\n          `| ${status} | **${project.name}** | ${project.description ?? '-'} |`\n        );\n      }\n      if (projects.length > 10) {\n        lines.push(\n          `| ... | ... | _${projectsData.total - 10} more projects_ |`\n        );\n      }\n    }\n\n    lines.push('');\n    lines.push('## Subscription');\n    lines.push('');\n    lines.push(`- **Plan**: ${subscription.planName}`);\n    lines.push(`- **Status**: ${subscription.status}`);\n    if (subscription.currentPeriodEnd) {\n      lines.push(\n        `- **Period End**: ${new Date(subscription.currentPeriodEnd).toLocaleDateString()}`\n      );\n    }\n\n    return {\n      mimeType: 'text/markdown',\n      body: lines.join('\\n'),\n    };\n  },\n};\n\n/**\n * Markdown renderer for saas-boilerplate.billing.settings presentation\n * Only handles SubscriptionView component\n */\nexport const saasBillingMarkdownRenderer: PresentationRenderer<{\n  mimeType: string;\n  body: string;\n}> = {\n  target: 'markdown',\n  render: async (desc, _ctx) => {\n    // Only handle SubscriptionView\n    if (\n      desc.source.type !== 'component' ||\n      desc.source.componentKey !== 'SubscriptionView'\n    ) {\n      throw new Error('saasBillingMarkdownRenderer: not SubscriptionView');\n    }\n\n    const subscription = await mockGetSubscriptionHandler();\n\n    const lines: string[] = [\n      '# Billing & Subscription',\n      '',\n      '> Current subscription details and billing information',\n      '',\n      '## Subscription Details',\n      '',\n      '| Property | Value |',\n      '|----------|-------|',\n      `| Plan | ${subscription.planName} |`,\n      `| Status | ${subscription.status} |`,\n      `| ID | ${subscription.id} |`,\n      `| Period Start | ${new Date(subscription.currentPeriodStart).toLocaleDateString()} |`,\n      `| Period End | ${new Date(subscription.currentPeriodEnd).toLocaleDateString()} |`,\n    ];\n\n    lines.push('');\n    lines.push('## Plan Limits');\n    lines.push('');\n    lines.push(`- **Projects**: ${subscription.limits.projects}`);\n    lines.push(`- **Users**: ${subscription.limits.users}`);\n\n    lines.push('');\n    lines.push('## Plan Features');\n    lines.push('');\n\n    if (subscription.planName.toLowerCase().includes('free')) {\n      lines.push('- ✅ Up to 3 projects');\n      lines.push('- ✅ Basic support');\n      lines.push('- ❌ Priority support');\n      lines.push('- ❌ Advanced analytics');\n    } else if (subscription.planName.toLowerCase().includes('pro')) {\n      lines.push('- ✅ Unlimited projects');\n      lines.push('- ✅ Priority support');\n      lines.push('- ✅ Advanced analytics');\n      lines.push('- ❌ Custom integrations');\n    } else {\n      lines.push('- ✅ Unlimited projects');\n      lines.push('- ✅ Priority support');\n      lines.push('- ✅ Advanced analytics');\n      lines.push('- ✅ Custom integrations');\n      lines.push('- ✅ Dedicated support');\n    }\n\n    return {\n      mimeType: 'text/markdown',\n      body: lines.join('\\n'),\n    };\n  },\n};\n"],"mappings":"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"}

package/dist/ui/renderers/project-list.renderer.d.ts

@@ -0,0 +1,9 @@
+import { PresentationRenderer } from "@contractspec/lib.contracts";
+import * as React from "react";
+
+//#region src/ui/renderers/project-list.renderer.d.ts
+
+declare const projectListReactRenderer: PresentationRenderer<React.ReactElement>;
+//#endregion
+export { projectListReactRenderer };
+//# sourceMappingURL=project-list.renderer.d.ts.map

package/dist/ui/renderers/project-list.renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.renderer.d.ts","names":[],"sources":["../../../src/ui/renderers/project-list.renderer.tsx"],"sourcesContent":[],"mappings":";;;;;cAOa,0BAA0B,qBAAqB,KAAA,CAAM"}

package/dist/ui/renderers/project-list.renderer.js

@@ -0,0 +1,17 @@
+import { SaasProjectList } from "../SaasProjectList.js";
+import "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/ui/renderers/project-list.renderer.tsx
+const projectListReactRenderer = {
+	target: "react",
+	render: async (desc, _ctx) => {
+		if (desc.source.type !== "component") throw new Error("Invalid source type");
+		if (desc.source.componentKey !== "SaasProjectListView") throw new Error(`Unknown component: ${desc.source.componentKey}`);
+		return /* @__PURE__ */ jsx(SaasProjectList, {});
+	}
+};
+
+//#endregion
+export { projectListReactRenderer };
+//# sourceMappingURL=project-list.renderer.js.map

package/dist/ui/renderers/project-list.renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-list.renderer.js","names":[],"sources":["../../../src/ui/renderers/project-list.renderer.tsx"],"sourcesContent":["/**\n * React renderer for SaaS Project List presentation\n */\nimport * as React from 'react';\nimport type { PresentationRenderer } from '@contractspec/lib.contracts';\nimport { SaasProjectList } from '../SaasProjectList';\n\nexport const projectListReactRenderer: PresentationRenderer<React.ReactElement> =\n  {\n    target: 'react',\n    render: async (desc, _ctx) => {\n      if (desc.source.type !== 'component') {\n        throw new Error('Invalid source type');\n      }\n\n      if (desc.source.componentKey !== 'SaasProjectListView') {\n        throw new Error(`Unknown component: ${desc.source.componentKey}`);\n      }\n\n      return <SaasProjectList />;\n    },\n  };\n"],"mappings":";;;;;AAOA,MAAa,2BACX;CACE,QAAQ;CACR,QAAQ,OAAO,MAAM,SAAS;AAC5B,MAAI,KAAK,OAAO,SAAS,YACvB,OAAM,IAAI,MAAM,sBAAsB;AAGxC,MAAI,KAAK,OAAO,iBAAiB,sBAC/B,OAAM,IAAI,MAAM,sBAAsB,KAAK,OAAO,eAAe;AAGnE,SAAO,oBAAC,oBAAkB;;CAE7B"}

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';

package/package.json

@@ -0,0 +1,135 @@
+{
+  "name": "@contractspec/example.saas-boilerplate",
+  "version": "0.0.0-canary-20260113170453",
+  "description": "SaaS Boilerplate - Users, Orgs, Projects, Billing, Settings",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./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",
+    "./handlers/saas.handlers": "./dist/handlers/saas.handlers.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",
+    "./seeders": "./dist/seeders/index.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",
+    "./shared/overlay-types": "./dist/shared/overlay-types.js",
+    "./tests/operations.test-spec": "./dist/tests/operations.test-spec.js",
+    "./ui": "./dist/ui/index.js",
+    "./ui/hooks": "./dist/ui/hooks/index.js",
+    "./ui/hooks/useProjectList": "./dist/ui/hooks/useProjectList.js",
+    "./ui/hooks/useProjectMutations": "./dist/ui/hooks/useProjectMutations.js",
+    "./ui/modals": "./dist/ui/modals/index.js",
+    "./ui/modals/CreateProjectModal": "./dist/ui/modals/CreateProjectModal.js",
+    "./ui/modals/ProjectActionsModal": "./dist/ui/modals/ProjectActionsModal.js",
+    "./ui/overlays": "./dist/ui/overlays/index.js",
+    "./ui/overlays/demo-overlays": "./dist/ui/overlays/demo-overlays.js",
+    "./ui/renderers": "./dist/ui/renderers/index.js",
+    "./ui/renderers/project-list.markdown": "./dist/ui/renderers/project-list.markdown.js",
+    "./ui/renderers/project-list.renderer": "./dist/ui/renderers/project-list.renderer.js",
+    "./ui/SaasDashboard": "./dist/ui/SaasDashboard.js",
+    "./ui/SaasProjectList": "./dist/ui/SaasProjectList.js",
+    "./ui/SaasSettingsPanel": "./dist/ui/SaasSettingsPanel.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "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",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/lib.identity-rbac": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.jobs": "0.0.0-canary-20260113170453",
+    "@contractspec/module.audit-trail": "0.0.0-canary-20260113170453",
+    "@contractspec/module.notifications": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.contracts": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.schema": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.example-shared-ui": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.design-system": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.runtime-sandbox": "0.0.0-canary-20260113170453",
+    "react": "19.2.3",
+    "react-dom": "19.2.3"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113170453",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113170453",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3",
+    "@types/react": "^19.2.8",
+    "@types/react-dom": "^19.2.2"
+  },
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.js",
+      "./billing": "./dist/billing/index.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",
+      "./billing/billing.handler": "./dist/billing/billing.handler.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.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",
+      "./project/project.handler": "./dist/project/project.handler.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",
+      "./*": "./*"
+    },
+    "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"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/billing/billing.entity.ts

@@ -0,0 +1,158 @@
+import {
+  defineEntity,
+  defineEntityEnum,
+  field,
+  index,
+} from '@contractspec/lib.schema';
+
+/**
+ * Subscription status enum for entities.
+ */
+export const SubscriptionStatusEnum = defineEntityEnum({
+  name: 'SubscriptionStatus',
+  values: ['TRIALING', 'ACTIVE', 'PAST_DUE', 'CANCELED', 'PAUSED'] as const,
+  schema: 'saas_app',
+  description: 'Status of a subscription.',
+});
+
+/**
+ * Subscription entity - organization subscription info.
+ */
+export const SubscriptionEntity = defineEntity({
+  name: 'Subscription',
+  description: 'Organization subscription/plan information.',
+  schema: 'saas_app',
+  map: 'subscription',
+  fields: {
+    id: field.id(),
+    organizationId: field.foreignKey({ isUnique: true }),
+
+    // Plan info
+    planId: field.string({ description: 'Plan identifier' }),
+    planName: field.string({ description: 'Plan display name' }),
+
+    // Status
+    status: field.enum('SubscriptionStatus'),
+
+    // Billing cycle
+    currentPeriodStart: field.dateTime(),
+    currentPeriodEnd: field.dateTime(),
+
+    // Trial
+    trialEndsAt: field.dateTime({ isOptional: true }),
+
+    // Cancellation
+    cancelAtPeriodEnd: field.boolean({ default: false }),
+    canceledAt: field.dateTime({ isOptional: true }),
+
+    // External reference
+    stripeSubscriptionId: field.string({ isOptional: true }),
+    stripeCustomerId: field.string({ isOptional: true }),
+
+    // Metadata
+    metadata: field.json({ isOptional: true }),
+
+    // Timestamps
+    createdAt: field.createdAt(),
+    updatedAt: field.updatedAt(),
+  },
+  enums: [SubscriptionStatusEnum],
+});
+
+/**
+ * BillingUsage entity - track feature usage.
+ */
+export const BillingUsageEntity = defineEntity({
+  name: 'BillingUsage',
+  description: 'Track usage of metered features.',
+  schema: 'saas_app',
+  map: 'billing_usage',
+  fields: {
+    id: field.id(),
+    organizationId: field.foreignKey(),
+
+    // Feature
+    feature: field.string({
+      description: 'Feature being tracked (e.g., "api_calls", "storage_gb")',
+    }),
+
+    // Usage
+    quantity: field.int({ description: 'Usage quantity' }),
+    unit: field.string({
+      isOptional: true,
+      description: 'Unit of measurement',
+    }),
+
+    // Period
+    billingPeriod: field.string({
+      description: 'Billing period (e.g., "2024-01")',
+    }),
+
+    // Aggregation
+    recordedAt: field.dateTime({ description: 'When usage was recorded' }),
+
+    // Source
+    sourceId: field.string({
+      isOptional: true,
+      description: 'Source of usage (e.g., request ID)',
+    }),
+    sourceType: field.string({ isOptional: true }),
+
+    // Metadata
+    metadata: field.json({ isOptional: true }),
+  },
+  indexes: [
+    index.on(['organizationId', 'feature', 'billingPeriod']),
+    index.on(['organizationId', 'recordedAt']),
+  ],
+});
+
+/**
+ * UsageLimit entity - feature usage limits per plan.
+ */
+export const UsageLimitEntity = defineEntity({
+  name: 'UsageLimit',
+  description: 'Usage limits per plan/organization.',
+  schema: 'saas_app',
+  map: 'usage_limit',
+  fields: {
+    id: field.id(),
+
+    // Scope
+    planId: field.string({
+      isOptional: true,
+      description: 'Plan this limit applies to',
+    }),
+    organizationId: field.string({
+      isOptional: true,
+      description: 'Org-specific override',
+    }),
+
+    // Limit
+    feature: field.string({ description: 'Feature being limited' }),
+    limit: field.int({ description: 'Maximum allowed usage' }),
+    resetPeriod: field.string({
+      default: '"monthly"',
+      description: 'When limit resets',
+    }),
+
+    // Soft/hard limit
+    isSoftLimit: field.boolean({
+      default: false,
+      description: 'Whether to warn vs block',
+    }),
+    overage: field.boolean({
+      default: false,
+      description: 'Whether overage is allowed',
+    }),
+    overageRate: field.float({
+      isOptional: true,
+      description: 'Cost per unit over limit',
+    }),
+
+    // Timestamps
+    createdAt: field.createdAt(),
+    updatedAt: field.updatedAt(),
+  },
+  indexes: [index.unique(['planId', 'feature'])],
+});

package/src/billing/billing.enum.ts

@@ -0,0 +1,23 @@
+import { defineEnum } from '@contractspec/lib.schema';
+
+/**
+ * Subscription status enum for contract schemas.
+ * Note: Entity enum is defined separately in billing.entity.ts
+ */
+export const SubscriptionStatusSchemaEnum = defineEnum('SubscriptionStatus', [
+  'TRIALING',
+  'ACTIVE',
+  'PAST_DUE',
+  'CANCELED',
+  'PAUSED',
+]);
+
+/**
+ * Feature access reason enum.
+ */
+export const FeatureAccessReasonEnum = defineEnum('FeatureAccessReason', [
+  'included',
+  'limit_available',
+  'limit_reached',
+  'not_in_plan',
+]);