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

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

@@ -0,0 +1,54 @@
+import { BillingUsageEntity, SubscriptionEntity, SubscriptionStatusEnum, UsageLimitEntity } from "./billing/billing.entity.js";
+import { FeatureAccessReasonEnum, SubscriptionStatusSchemaEnum } from "./billing/billing.enum.js";
+import { SubscriptionChangedEvent, UsageLimitReachedEvent, UsageRecordedEvent } from "./billing/billing.event.js";
+import { CheckFeatureAccessInput, CheckFeatureAccessOutput, RecordUsageInput, Subscription, UsageSummary, mockCheckFeatureAccessHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockRecordUsageHandler } from "./billing/billing.handler.js";
+import { CheckFeatureAccessContract, GetSubscriptionContract, GetUsageSummaryContract, RecordUsageContract } from "./billing/billing.operations.js";
+import { SubscriptionPresentation, UsageDashboardPresentation } from "./billing/billing.presentation.js";
+import { CheckFeatureAccessInputModel, CheckFeatureAccessOutputModel, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, RecordUsageInputModel, RecordUsageOutputModel, SubscriptionModel, UsageRecordedPayloadModel, UsageSummaryModel } from "./billing/billing.schema.js";
+import "./billing/index.js";
+import { SaasDashboardPresentation, SettingsPanelPresentation } from "./dashboard/dashboard.presentation.js";
+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";
+import { ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectUpdatedEvent } from "./project/project.event.js";
+import { ProjectEntity, ProjectMemberEntity, ProjectStatusEnum } from "./project/project.entity.js";
+import { ProjectDetailPresentation, ProjectListPresentation } from "./project/project.presentation.js";
+import "./project/index.js";
+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
+/**
+ * SaaS boilerplate schema contribution.
+ */
+declare const saasBoilerplateSchemaContribution: ModuleSchemaContribution;
+/**
+ * Complete schema composition for SaaS Boilerplate.
+ * Use with `database schema:compose` to generate Prisma schema.
+ */
+declare const schemaComposition: {
+  modules: ModuleSchemaContribution[];
+  provider: "postgresql";
+  outputPath: string;
+};
+//#endregion
+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

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

package/dist/index.js

@@ -0,0 +1,81 @@
+import example_default from "./example.js";
+import { FeatureAccessReasonEnum, SubscriptionStatusSchemaEnum } from "./billing/billing.enum.js";
+import { CheckFeatureAccessInputModel, CheckFeatureAccessOutputModel, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, RecordUsageInputModel, RecordUsageOutputModel, SubscriptionModel, UsageRecordedPayloadModel, UsageSummaryModel } from "./billing/billing.schema.js";
+import { CheckFeatureAccessContract, GetSubscriptionContract, GetUsageSummaryContract, RecordUsageContract } from "./billing/billing.operations.js";
+import { SubscriptionChangedEvent, UsageLimitReachedEvent, UsageRecordedEvent } from "./billing/billing.event.js";
+import { BillingUsageEntity, SubscriptionEntity, SubscriptionStatusEnum, UsageLimitEntity } from "./billing/billing.entity.js";
+import { SubscriptionPresentation, UsageDashboardPresentation } from "./billing/billing.presentation.js";
+import { mockCheckFeatureAccessHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockRecordUsageHandler } from "./billing/billing.handler.js";
+import "./billing/index.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";
+import { ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectUpdatedEvent } from "./project/project.event.js";
+import { ProjectEntity, ProjectMemberEntity, ProjectStatusEnum } from "./project/project.entity.js";
+import { ProjectDetailPresentation, ProjectListPresentation } from "./project/project.presentation.js";
+import { mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler } from "./project/project.handler.js";
+import "./project/index.js";
+import { SettingsScopeEnum } from "./settings/settings.enum.js";
+import { FeatureFlagEntity, SettingsEntity } from "./settings/settings.entity.js";
+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";
+import { auditTrailSchemaContribution } from "@contractspec/module.audit-trail";
+import { notificationsSchemaContribution } from "@contractspec/module.notifications";
+
+//#region src/index.ts
+/**
+* SaaS boilerplate schema contribution.
+*/
+const saasBoilerplateSchemaContribution = {
+	moduleId: "@contractspec/example.saas-boilerplate",
+	entities: [
+		ProjectEntity,
+		ProjectMemberEntity,
+		SettingsEntity,
+		FeatureFlagEntity,
+		SubscriptionEntity,
+		BillingUsageEntity,
+		UsageLimitEntity
+	],
+	enums: [
+		ProjectStatusEnum,
+		SettingsScopeEnum,
+		SubscriptionStatusEnum
+	]
+};
+/**
+* Complete schema composition for SaaS Boilerplate.
+* Use with `database schema:compose` to generate Prisma schema.
+*/
+const schemaComposition = {
+	modules: [
+		identityRbacSchemaContribution,
+		jobsSchemaContribution,
+		auditTrailSchemaContribution,
+		notificationsSchemaContribution,
+		saasBoilerplateSchemaContribution
+	],
+	provider: "postgresql",
+	outputPath: "./prisma/schema/generated.prisma"
+};
+
+//#endregion
+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

@@ -0,0 +1 @@
+{"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/presentations/index.d.ts

@@ -0,0 +1,17 @@
+import { SubscriptionPresentation, UsageDashboardPresentation } from "../billing/billing.presentation.js";
+import { SaasDashboardPresentation, SettingsPanelPresentation } from "../dashboard/dashboard.presentation.js";
+import { ProjectDetailPresentation, ProjectListPresentation } from "../project/project.presentation.js";
+
+//#region src/presentations/index.d.ts
+
+declare const SaasBoilerplatePresentations: {
+  SubscriptionPresentation: undefined;
+  UsageDashboardPresentation: undefined;
+  ProjectListPresentation: undefined;
+  ProjectDetailPresentation: undefined;
+  SaasDashboardPresentation: undefined;
+  SettingsPanelPresentation: undefined;
+};
+//#endregion
+export { ProjectDetailPresentation, ProjectListPresentation, SaasBoilerplatePresentations, SaasDashboardPresentation, SettingsPanelPresentation, SubscriptionPresentation, UsageDashboardPresentation };
+//# sourceMappingURL=index.d.ts.map

package/dist/presentations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/presentations/index.ts"],"sourcesContent":[],"mappings":";;;;;;cAuBa"}

package/dist/presentations/index.js

@@ -0,0 +1,17 @@
+import { SubscriptionPresentation, UsageDashboardPresentation } from "../billing/billing.presentation.js";
+import { ProjectDetailPresentation, ProjectListPresentation } from "../project/project.presentation.js";
+import { SaasDashboardPresentation, SettingsPanelPresentation } from "../dashboard/dashboard.presentation.js";
+
+//#region src/presentations/index.ts
+const SaasBoilerplatePresentations = {
+	SubscriptionPresentation: void 0,
+	UsageDashboardPresentation: void 0,
+	ProjectListPresentation: void 0,
+	ProjectDetailPresentation: void 0,
+	SaasDashboardPresentation: void 0,
+	SettingsPanelPresentation: void 0
+};
+
+//#endregion
+export { ProjectDetailPresentation, ProjectListPresentation, SaasBoilerplatePresentations, SaasDashboardPresentation, SettingsPanelPresentation, SubscriptionPresentation, UsageDashboardPresentation };
+//# sourceMappingURL=index.js.map

package/dist/presentations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/presentations/index.ts"],"sourcesContent":["/**\n * SaaS Boilerplate Presentations - re-exports from domain modules for backward compatibility.\n */\n\n// Billing presentations\nexport {\n  SubscriptionPresentation,\n  UsageDashboardPresentation,\n} from '../billing/billing.presentation';\n\n// Project presentations\nexport {\n  ProjectListPresentation,\n  ProjectDetailPresentation,\n} from '../project/project.presentation';\n\n// Dashboard presentations\nexport {\n  SaasDashboardPresentation,\n  SettingsPanelPresentation,\n} from '../dashboard/dashboard.presentation';\n\n// All presentations collection\nexport const SaasBoilerplatePresentations = {\n  // Billing\n  SubscriptionPresentation: undefined,\n  UsageDashboardPresentation: undefined,\n\n  // Project\n  ProjectListPresentation: undefined,\n  ProjectDetailPresentation: undefined,\n\n  // Dashboard\n  SaasDashboardPresentation: undefined,\n  SettingsPanelPresentation: undefined,\n};\n"],"mappings":";;;;;AAuBA,MAAa,+BAA+B;CAE1C,0BAA0B;CAC1B,4BAA4B;CAG5B,yBAAyB;CACzB,2BAA2B;CAG3B,2BAA2B;CAC3B,2BAA2B;CAC5B"}

package/dist/project/index.d.ts

@@ -0,0 +1,8 @@
+import { CreateProjectInput, ListProjectsInput, ListProjectsOutput, Project, UpdateProjectInput, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler } from "./project.handler.js";
+import { ProjectStatusFilterEnum, ProjectStatusSchemaEnum } from "./project.enum.js";
+import { CreateProjectInputModel, DeleteProjectInputModel, DeleteProjectOutputModel, GetProjectInputModel, ListProjectsInputModel, ListProjectsOutputModel, ProjectDeletedPayloadModel, ProjectModel, UpdateProjectInputModel } from "./project.schema.js";
+import { CreateProjectContract, DeleteProjectContract, GetProjectContract, ListProjectsContract, UpdateProjectContract } from "./project.operations.js";
+import { ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectUpdatedEvent } from "./project.event.js";
+import { ProjectEntity, ProjectMemberEntity, ProjectStatusEnum } from "./project.entity.js";
+import { ProjectDetailPresentation, ProjectListPresentation } from "./project.presentation.js";
+export { CreateProjectContract, type CreateProjectInput, CreateProjectInputModel, DeleteProjectContract, DeleteProjectInputModel, DeleteProjectOutputModel, GetProjectContract, GetProjectInputModel, ListProjectsContract, type ListProjectsInput, ListProjectsInputModel, type ListProjectsOutput, ListProjectsOutputModel, type Project, ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectDeletedPayloadModel, ProjectDetailPresentation, ProjectEntity, ProjectListPresentation, ProjectMemberEntity, ProjectModel, ProjectStatusEnum, ProjectStatusFilterEnum, ProjectStatusSchemaEnum, ProjectUpdatedEvent, UpdateProjectContract, type UpdateProjectInput, UpdateProjectInputModel, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler };

package/dist/project/index.js

@@ -0,0 +1,9 @@
+import { ProjectStatusFilterEnum, ProjectStatusSchemaEnum } from "./project.enum.js";
+import { CreateProjectInputModel, DeleteProjectInputModel, DeleteProjectOutputModel, GetProjectInputModel, ListProjectsInputModel, ListProjectsOutputModel, ProjectDeletedPayloadModel, ProjectModel, UpdateProjectInputModel } from "./project.schema.js";
+import { CreateProjectContract, DeleteProjectContract, GetProjectContract, ListProjectsContract, UpdateProjectContract } from "./project.operations.js";
+import { ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectUpdatedEvent } from "./project.event.js";
+import { ProjectEntity, ProjectMemberEntity, ProjectStatusEnum } from "./project.entity.js";
+import { ProjectDetailPresentation, ProjectListPresentation } from "./project.presentation.js";
+import { mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler } from "./project.handler.js";
+
+export { CreateProjectContract, CreateProjectInputModel, DeleteProjectContract, DeleteProjectInputModel, DeleteProjectOutputModel, GetProjectContract, GetProjectInputModel, ListProjectsContract, ListProjectsInputModel, ListProjectsOutputModel, ProjectArchivedEvent, ProjectCreatedEvent, ProjectDeletedEvent, ProjectDeletedPayloadModel, ProjectDetailPresentation, ProjectEntity, ProjectListPresentation, ProjectMemberEntity, ProjectModel, ProjectStatusEnum, ProjectStatusFilterEnum, ProjectStatusSchemaEnum, ProjectUpdatedEvent, UpdateProjectContract, UpdateProjectInputModel, mockCreateProjectHandler, mockDeleteProjectHandler, mockGetProjectHandler, mockListProjectsHandler, mockUpdateProjectHandler };

package/dist/project/project.entity.d.ts

@@ -0,0 +1,40 @@
+import * as _contractspec_lib_schema92 from "@contractspec/lib.schema";
+
+//#region src/project/project.entity.d.ts
+/**
+ * Project status enum for entities.
+ */
+declare const ProjectStatusEnum: _contractspec_lib_schema92.EntityEnumDef;
+/**
+ * Project entity - team-scoped work container.
+ */
+declare const ProjectEntity: _contractspec_lib_schema92.EntitySpec<{
+  id: _contractspec_lib_schema92.EntityScalarField;
+  name: _contractspec_lib_schema92.EntityScalarField;
+  description: _contractspec_lib_schema92.EntityScalarField;
+  slug: _contractspec_lib_schema92.EntityScalarField;
+  organizationId: _contractspec_lib_schema92.EntityScalarField;
+  createdBy: _contractspec_lib_schema92.EntityScalarField;
+  status: _contractspec_lib_schema92.EntityEnumField;
+  isPublic: _contractspec_lib_schema92.EntityScalarField;
+  settings: _contractspec_lib_schema92.EntityScalarField;
+  tags: _contractspec_lib_schema92.EntityScalarField;
+  metadata: _contractspec_lib_schema92.EntityScalarField;
+  createdAt: _contractspec_lib_schema92.EntityScalarField;
+  updatedAt: _contractspec_lib_schema92.EntityScalarField;
+  archivedAt: _contractspec_lib_schema92.EntityScalarField;
+}>;
+/**
+ * ProjectMember entity - project-level access.
+ */
+declare const ProjectMemberEntity: _contractspec_lib_schema92.EntitySpec<{
+  id: _contractspec_lib_schema92.EntityScalarField;
+  projectId: _contractspec_lib_schema92.EntityScalarField;
+  userId: _contractspec_lib_schema92.EntityScalarField;
+  role: _contractspec_lib_schema92.EntityScalarField;
+  addedBy: _contractspec_lib_schema92.EntityScalarField;
+  createdAt: _contractspec_lib_schema92.EntityScalarField;
+}>;
+//#endregion
+export { ProjectEntity, ProjectMemberEntity, ProjectStatusEnum };
+//# sourceMappingURL=project.entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project.entity.d.ts","names":[],"sources":["../../src/project/project.entity.ts"],"sourcesContent":[],"mappings":";;;;;;AAUa,cAAA,iBAKX,EAAA,0BAAA,CAL4B,aAK5B;AAKF;;;cAAa,0CAAa;MAmDxB,0BAAA,CAAA;;;;;;;;;;;yDAnDwB;EAAA,SAAA,8CAAA;EAwDb,UAAA,8CAgBX;CAAA,CAAA;;;;cAhBW,gDAAmB;MAgB9B,0BAAA,CAAA;yDAhB8B;EAAA,MAAA,8CAAA"}

package/dist/project/project.entity.js

@@ -0,0 +1,85 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#region src/project/project.entity.ts
+/**
+* Project status enum for entities.
+*/
+const ProjectStatusEnum = defineEntityEnum({
+	name: "ProjectStatus",
+	values: [
+		"DRAFT",
+		"ACTIVE",
+		"ARCHIVED",
+		"DELETED"
+	],
+	schema: "saas_app",
+	description: "Status of a project."
+});
+/**
+* Project entity - team-scoped work container.
+*/
+const ProjectEntity = defineEntity({
+	name: "Project",
+	description: "A project belonging to an organization.",
+	schema: "saas_app",
+	map: "project",
+	fields: {
+		id: field.id({ description: "Unique project ID" }),
+		name: field.string({ description: "Project name" }),
+		description: field.string({
+			isOptional: true,
+			description: "Project description"
+		}),
+		slug: field.string({
+			isOptional: true,
+			description: "URL-friendly identifier"
+		}),
+		organizationId: field.foreignKey({ description: "Owning organization" }),
+		createdBy: field.foreignKey({ description: "User who created the project" }),
+		status: field.enum("ProjectStatus", { default: "DRAFT" }),
+		isPublic: field.boolean({
+			default: false,
+			description: "Whether project is publicly visible"
+		}),
+		settings: field.json({
+			isOptional: true,
+			description: "Project-specific settings"
+		}),
+		tags: field.string({
+			isArray: true,
+			description: "Project tags"
+		}),
+		metadata: field.json({ isOptional: true }),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		archivedAt: field.dateTime({ isOptional: true })
+	},
+	indexes: [
+		index.on(["organizationId", "status"]),
+		index.on(["organizationId", "createdAt"]),
+		index.unique(["organizationId", "slug"])
+	],
+	enums: [ProjectStatusEnum]
+});
+/**
+* ProjectMember entity - project-level access.
+*/
+const ProjectMemberEntity = defineEntity({
+	name: "ProjectMember",
+	description: "User access to a specific project.",
+	schema: "saas_app",
+	map: "project_member",
+	fields: {
+		id: field.id(),
+		projectId: field.foreignKey(),
+		userId: field.foreignKey(),
+		role: field.string({ description: "Role in project (owner, editor, viewer)" }),
+		addedBy: field.string({ isOptional: true }),
+		createdAt: field.createdAt()
+	},
+	indexes: [index.unique(["projectId", "userId"])]
+});
+
+//#endregion
+export { ProjectEntity, ProjectMemberEntity, ProjectStatusEnum };
+//# sourceMappingURL=project.entity.js.map

package/dist/project/project.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.entity.js","names":[],"sources":["../../src/project/project.entity.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\n\n/**\n * Project status enum for entities.\n */\nexport const ProjectStatusEnum = defineEntityEnum({\n  name: 'ProjectStatus',\n  values: ['DRAFT', 'ACTIVE', 'ARCHIVED', 'DELETED'] as const,\n  schema: 'saas_app',\n  description: 'Status of a project.',\n});\n\n/**\n * Project entity - team-scoped work container.\n */\nexport const ProjectEntity = defineEntity({\n  name: 'Project',\n  description: 'A project belonging to an organization.',\n  schema: 'saas_app',\n  map: 'project',\n  fields: {\n    id: field.id({ description: 'Unique project ID' }),\n    name: field.string({ description: 'Project name' }),\n    description: field.string({\n      isOptional: true,\n      description: 'Project description',\n    }),\n    slug: field.string({\n      isOptional: true,\n      description: 'URL-friendly identifier',\n    }),\n\n    // Ownership\n    organizationId: field.foreignKey({ description: 'Owning organization' }),\n    createdBy: field.foreignKey({\n      description: 'User who created the project',\n    }),\n\n    // Status\n    status: field.enum('ProjectStatus', { default: 'DRAFT' }),\n\n    // Settings\n    isPublic: field.boolean({\n      default: false,\n      description: 'Whether project is publicly visible',\n    }),\n    settings: field.json({\n      isOptional: true,\n      description: 'Project-specific settings',\n    }),\n\n    // Metadata\n    tags: field.string({ isArray: true, description: 'Project tags' }),\n    metadata: field.json({ isOptional: true }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n    archivedAt: field.dateTime({ isOptional: true }),\n  },\n  indexes: [\n    index.on(['organizationId', 'status']),\n    index.on(['organizationId', 'createdAt']),\n    index.unique(['organizationId', 'slug']),\n  ],\n  enums: [ProjectStatusEnum],\n});\n\n/**\n * ProjectMember entity - project-level access.\n */\nexport const ProjectMemberEntity = defineEntity({\n  name: 'ProjectMember',\n  description: 'User access to a specific project.',\n  schema: 'saas_app',\n  map: 'project_member',\n  fields: {\n    id: field.id(),\n    projectId: field.foreignKey(),\n    userId: field.foreignKey(),\n    role: field.string({\n      description: 'Role in project (owner, editor, viewer)',\n    }),\n    addedBy: field.string({ isOptional: true }),\n    createdAt: field.createdAt(),\n  },\n  indexes: [index.unique(['projectId', 'userId'])],\n});\n"],"mappings":";;;;;;AAUA,MAAa,oBAAoB,iBAAiB;CAChD,MAAM;CACN,QAAQ;EAAC;EAAS;EAAU;EAAY;EAAU;CAClD,QAAQ;CACR,aAAa;CACd,CAAC;;;;AAKF,MAAa,gBAAgB,aAAa;CACxC,MAAM;CACN,aAAa;CACb,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,IAAI,MAAM,GAAG,EAAE,aAAa,qBAAqB,CAAC;EAClD,MAAM,MAAM,OAAO,EAAE,aAAa,gBAAgB,CAAC;EACnD,aAAa,MAAM,OAAO;GACxB,YAAY;GACZ,aAAa;GACd,CAAC;EACF,MAAM,MAAM,OAAO;GACjB,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,gBAAgB,MAAM,WAAW,EAAE,aAAa,uBAAuB,CAAC;EACxE,WAAW,MAAM,WAAW,EAC1B,aAAa,gCACd,CAAC;EAGF,QAAQ,MAAM,KAAK,iBAAiB,EAAE,SAAS,SAAS,CAAC;EAGzD,UAAU,MAAM,QAAQ;GACtB,SAAS;GACT,aAAa;GACd,CAAC;EACF,UAAU,MAAM,KAAK;GACnB,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,MAAM,MAAM,OAAO;GAAE,SAAS;GAAM,aAAa;GAAgB,CAAC;EAClE,UAAU,MAAM,KAAK,EAAE,YAAY,MAAM,CAAC;EAG1C,WAAW,MAAM,WAAW;EAC5B,WAAW,MAAM,WAAW;EAC5B,YAAY,MAAM,SAAS,EAAE,YAAY,MAAM,CAAC;EACjD;CACD,SAAS;EACP,MAAM,GAAG,CAAC,kBAAkB,SAAS,CAAC;EACtC,MAAM,GAAG,CAAC,kBAAkB,YAAY,CAAC;EACzC,MAAM,OAAO,CAAC,kBAAkB,OAAO,CAAC;EACzC;CACD,OAAO,CAAC,kBAAkB;CAC3B,CAAC;;;;AAKF,MAAa,sBAAsB,aAAa;CAC9C,MAAM;CACN,aAAa;CACb,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,IAAI,MAAM,IAAI;EACd,WAAW,MAAM,YAAY;EAC7B,QAAQ,MAAM,YAAY;EAC1B,MAAM,MAAM,OAAO,EACjB,aAAa,2CACd,CAAC;EACF,SAAS,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EAC3C,WAAW,MAAM,WAAW;EAC7B;CACD,SAAS,CAAC,MAAM,OAAO,CAAC,aAAa,SAAS,CAAC,CAAC;CACjD,CAAC"}

package/dist/project/project.enum.d.ts

@@ -0,0 +1,16 @@
+import * as _contractspec_lib_schema138 from "@contractspec/lib.schema";
+
+//#region src/project/project.enum.d.ts
+
+/**
+ * Project status enum for contract schemas.
+ * Note: Entity enum is defined separately in project.entity.ts
+ */
+declare const ProjectStatusSchemaEnum: _contractspec_lib_schema138.EnumType<[string, string, string, string]>;
+/**
+ * Project status filter enum (includes 'all' option).
+ */
+declare const ProjectStatusFilterEnum: _contractspec_lib_schema138.EnumType<[string, string, string, string]>;
+//#endregion
+export { ProjectStatusFilterEnum, ProjectStatusSchemaEnum };
+//# sourceMappingURL=project.enum.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project.enum.d.ts","names":[],"sources":["../../src/project/project.enum.ts"],"sourcesContent":[],"mappings":";;;;;;;AAMA;AAUa,cAVA,uBAeX,EAVA,2BAAA,CALkC,QAUA,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;;;;cAAvB,yBAKX,2BAAA,CALkC"}

package/dist/project/project.enum.js

@@ -0,0 +1,26 @@
+import { defineEnum } from "@contractspec/lib.schema";
+
+//#region src/project/project.enum.ts
+/**
+* Project status enum for contract schemas.
+* Note: Entity enum is defined separately in project.entity.ts
+*/
+const ProjectStatusSchemaEnum = defineEnum("ProjectStatus", [
+	"DRAFT",
+	"ACTIVE",
+	"ARCHIVED",
+	"DELETED"
+]);
+/**
+* Project status filter enum (includes 'all' option).
+*/
+const ProjectStatusFilterEnum = defineEnum("ProjectStatusFilter", [
+	"DRAFT",
+	"ACTIVE",
+	"ARCHIVED",
+	"all"
+]);
+
+//#endregion
+export { ProjectStatusFilterEnum, ProjectStatusSchemaEnum };
+//# sourceMappingURL=project.enum.js.map

package/dist/project/project.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.enum.js","names":[],"sources":["../../src/project/project.enum.ts"],"sourcesContent":["import { defineEnum } from '@contractspec/lib.schema';\n\n/**\n * Project status enum for contract schemas.\n * Note: Entity enum is defined separately in project.entity.ts\n */\nexport const ProjectStatusSchemaEnum = defineEnum('ProjectStatus', [\n  'DRAFT',\n  'ACTIVE',\n  'ARCHIVED',\n  'DELETED',\n]);\n\n/**\n * Project status filter enum (includes 'all' option).\n */\nexport const ProjectStatusFilterEnum = defineEnum('ProjectStatusFilter', [\n  'DRAFT',\n  'ACTIVE',\n  'ARCHIVED',\n  'all',\n]);\n"],"mappings":";;;;;;;AAMA,MAAa,0BAA0B,WAAW,iBAAiB;CACjE;CACA;CACA;CACA;CACD,CAAC;;;;AAKF,MAAa,0BAA0B,WAAW,uBAAuB;CACvE;CACA;CACA;CACA;CACD,CAAC"}