@lssm/example.saas-boilerplate 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217073102

package/dist/saas-boilerplate.feature.js

@@ -1 +1,199 @@
-const e={meta:{key:`saas-boilerplate`,title:`SaaS Boilerplate`,description:`SaaS application foundation with projects, billing, and settings`,domain:`saas`,owners:[`@saas-team`],tags:[`saas`,`projects`,`billing`],stability:`experimental`},operations:[{name:`saas.project.create`,version:1},{name:`saas.project.get`,version:1},{name:`saas.project.update`,version:1},{name:`saas.project.delete`,version:1},{name:`saas.project.list`,version:1},{name:`saas.billing.subscription.get`,version:1},{name:`saas.billing.usage.record`,version:1},{name:`saas.billing.usage.summary`,version:1},{name:`saas.billing.feature.check`,version:1}],events:[{name:`project.created`,version:1},{name:`project.updated`,version:1},{name:`project.deleted`,version:1},{name:`project.archived`,version:1},{name:`billing.usage.recorded`,version:1},{name:`billing.subscription.changed`,version:1},{name:`billing.limit.reached`,version:1}],presentations:[{name:`saas.dashboard`,version:1},{name:`saas.project.list`,version:1},{name:`saas.project.detail`,version:1},{name:`saas.billing.subscription`,version:1},{name:`saas.billing.usage`,version:1},{name:`saas.settings`,version:1}],opToPresentation:[{op:{name:`saas.project.list`,version:1},pres:{name:`saas.project.list`,version:1}},{op:{name:`saas.project.get`,version:1},pres:{name:`saas.project.detail`,version:1}},{op:{name:`saas.billing.subscription.get`,version:1},pres:{name:`saas.billing.subscription`,version:1}},{op:{name:`saas.billing.usage.summary`,version:1},pres:{name:`saas.billing.usage`,version:1}}],presentationsTargets:[{name:`saas.dashboard`,version:1,targets:[`react`,`markdown`]},{name:`saas.project.list`,version:1,targets:[`react`,`markdown`,`application/json`]},{name:`saas.billing.subscription`,version:1,targets:[`react`,`markdown`]},{name:`saas.billing.usage`,version:1,targets:[`react`,`markdown`]}],capabilities:{requires:[{key:`identity`,version:1},{key:`audit-trail`,version:1},{key:`notifications`,version:1}]}};export{e as SaasBoilerplateFeature};
+//#region src/saas-boilerplate.feature.ts
+/**
+* SaaS Boilerplate feature module that bundles project management,
+* billing, and settings operations into an installable feature.
+*/
+const SaasBoilerplateFeature = {
+	meta: {
+		key: "saas-boilerplate",
+		title: "SaaS Boilerplate",
+		description: "SaaS application foundation with projects, billing, and settings",
+		domain: "saas",
+		owners: ["@saas-team"],
+		tags: [
+			"saas",
+			"projects",
+			"billing"
+		],
+		stability: "experimental"
+	},
+	operations: [
+		{
+			name: "saas.project.create",
+			version: 1
+		},
+		{
+			name: "saas.project.get",
+			version: 1
+		},
+		{
+			name: "saas.project.update",
+			version: 1
+		},
+		{
+			name: "saas.project.delete",
+			version: 1
+		},
+		{
+			name: "saas.project.list",
+			version: 1
+		},
+		{
+			name: "saas.billing.subscription.get",
+			version: 1
+		},
+		{
+			name: "saas.billing.usage.record",
+			version: 1
+		},
+		{
+			name: "saas.billing.usage.summary",
+			version: 1
+		},
+		{
+			name: "saas.billing.feature.check",
+			version: 1
+		}
+	],
+	events: [
+		{
+			name: "project.created",
+			version: 1
+		},
+		{
+			name: "project.updated",
+			version: 1
+		},
+		{
+			name: "project.deleted",
+			version: 1
+		},
+		{
+			name: "project.archived",
+			version: 1
+		},
+		{
+			name: "billing.usage.recorded",
+			version: 1
+		},
+		{
+			name: "billing.subscription.changed",
+			version: 1
+		},
+		{
+			name: "billing.limit.reached",
+			version: 1
+		}
+	],
+	presentations: [
+		{
+			name: "saas.dashboard",
+			version: 1
+		},
+		{
+			name: "saas.project.list",
+			version: 1
+		},
+		{
+			name: "saas.project.detail",
+			version: 1
+		},
+		{
+			name: "saas.billing.subscription",
+			version: 1
+		},
+		{
+			name: "saas.billing.usage",
+			version: 1
+		},
+		{
+			name: "saas.settings",
+			version: 1
+		}
+	],
+	opToPresentation: [
+		{
+			op: {
+				name: "saas.project.list",
+				version: 1
+			},
+			pres: {
+				name: "saas.project.list",
+				version: 1
+			}
+		},
+		{
+			op: {
+				name: "saas.project.get",
+				version: 1
+			},
+			pres: {
+				name: "saas.project.detail",
+				version: 1
+			}
+		},
+		{
+			op: {
+				name: "saas.billing.subscription.get",
+				version: 1
+			},
+			pres: {
+				name: "saas.billing.subscription",
+				version: 1
+			}
+		},
+		{
+			op: {
+				name: "saas.billing.usage.summary",
+				version: 1
+			},
+			pres: {
+				name: "saas.billing.usage",
+				version: 1
+			}
+		}
+	],
+	presentationsTargets: [
+		{
+			name: "saas.dashboard",
+			version: 1,
+			targets: ["react", "markdown"]
+		},
+		{
+			name: "saas.project.list",
+			version: 1,
+			targets: [
+				"react",
+				"markdown",
+				"application/json"
+			]
+		},
+		{
+			name: "saas.billing.subscription",
+			version: 1,
+			targets: ["react", "markdown"]
+		},
+		{
+			name: "saas.billing.usage",
+			version: 1,
+			targets: ["react", "markdown"]
+		}
+	],
+	capabilities: { requires: [
+		{
+			key: "identity",
+			version: 1
+		},
+		{
+			key: "audit-trail",
+			version: 1
+		},
+		{
+			key: "notifications",
+			version: 1
+		}
+	] }
+};
+
+//#endregion
+export { SaasBoilerplateFeature };

package/dist/settings/index.js

@@ -1 +1,4 @@
-import{SettingsScopeEnum as e}from"./settings.enum.js";import{FeatureFlagEntity as t,SettingsEntity as n}from"./settings.entity.js";export{t as FeatureFlagEntity,n as SettingsEntity,e as SettingsScopeEnum};
+import { SettingsScopeEnum } from "./settings.enum.js";
+import { FeatureFlagEntity, SettingsEntity } from "./settings.entity.js";
+
+export { FeatureFlagEntity, SettingsEntity, SettingsScopeEnum };

package/dist/settings/settings.entity.d.ts

@@ -1,36 +1,36 @@
-import * as _lssm_lib_schema247 from "@lssm/lib.schema";
+import * as _lssm_lib_schema347 from "@lssm/lib.schema";
 
 //#region src/settings/settings.entity.d.ts
 /**
  * Settings entity - key-value configuration store.
  */
-declare const SettingsEntity: _lssm_lib_schema247.EntitySpec<{
-  id: _lssm_lib_schema247.EntityScalarField;
-  key: _lssm_lib_schema247.EntityScalarField;
-  scope: _lssm_lib_schema247.EntityEnumField;
-  scopeId: _lssm_lib_schema247.EntityScalarField;
-  value: _lssm_lib_schema247.EntityScalarField;
-  valueType: _lssm_lib_schema247.EntityScalarField;
-  schema: _lssm_lib_schema247.EntityScalarField;
-  description: _lssm_lib_schema247.EntityScalarField;
-  isSecret: _lssm_lib_schema247.EntityScalarField;
-  createdAt: _lssm_lib_schema247.EntityScalarField;
-  updatedAt: _lssm_lib_schema247.EntityScalarField;
+declare const SettingsEntity: _lssm_lib_schema347.EntitySpec<{
+  id: _lssm_lib_schema347.EntityScalarField;
+  key: _lssm_lib_schema347.EntityScalarField;
+  scope: _lssm_lib_schema347.EntityEnumField;
+  scopeId: _lssm_lib_schema347.EntityScalarField;
+  value: _lssm_lib_schema347.EntityScalarField;
+  valueType: _lssm_lib_schema347.EntityScalarField;
+  schema: _lssm_lib_schema347.EntityScalarField;
+  description: _lssm_lib_schema347.EntityScalarField;
+  isSecret: _lssm_lib_schema347.EntityScalarField;
+  createdAt: _lssm_lib_schema347.EntityScalarField;
+  updatedAt: _lssm_lib_schema347.EntityScalarField;
 }>;
 /**
  * FeatureFlag entity - feature toggles.
  */
-declare const FeatureFlagEntity: _lssm_lib_schema247.EntitySpec<{
-  id: _lssm_lib_schema247.EntityScalarField;
-  key: _lssm_lib_schema247.EntityScalarField;
-  name: _lssm_lib_schema247.EntityScalarField;
-  description: _lssm_lib_schema247.EntityScalarField;
-  enabled: _lssm_lib_schema247.EntityScalarField;
-  defaultValue: _lssm_lib_schema247.EntityScalarField;
-  rules: _lssm_lib_schema247.EntityScalarField;
-  rolloutPercentage: _lssm_lib_schema247.EntityScalarField;
-  createdAt: _lssm_lib_schema247.EntityScalarField;
-  updatedAt: _lssm_lib_schema247.EntityScalarField;
+declare const FeatureFlagEntity: _lssm_lib_schema347.EntitySpec<{
+  id: _lssm_lib_schema347.EntityScalarField;
+  key: _lssm_lib_schema347.EntityScalarField;
+  name: _lssm_lib_schema347.EntityScalarField;
+  description: _lssm_lib_schema347.EntityScalarField;
+  enabled: _lssm_lib_schema347.EntityScalarField;
+  defaultValue: _lssm_lib_schema347.EntityScalarField;
+  rules: _lssm_lib_schema347.EntityScalarField;
+  rolloutPercentage: _lssm_lib_schema347.EntityScalarField;
+  createdAt: _lssm_lib_schema347.EntityScalarField;
+  updatedAt: _lssm_lib_schema347.EntityScalarField;
 }>;
 //#endregion
 export { FeatureFlagEntity, SettingsEntity };

package/dist/settings/settings.entity.js

@@ -1 +1,78 @@
-import{SettingsScopeEnum as e}from"./settings.enum.js";import{defineEntity as t,field as n,index as r}from"@lssm/lib.schema";const i=t({name:`Settings`,description:`Application, organization, or user settings.`,schema:`saas_app`,map:`settings`,fields:{id:n.id(),key:n.string({description:`Setting key (e.g., "theme", "notifications.email")`}),scope:n.enum(`SettingsScope`),scopeId:n.string({isOptional:!0,description:`ID of scoped entity (org, user, project)`}),value:n.json({description:`Setting value`}),valueType:n.string({default:`"string"`,description:`Type hint for value`}),schema:n.json({isOptional:!0,description:`JSON schema for validation`}),description:n.string({isOptional:!0}),isSecret:n.boolean({default:!1,description:`Whether value should be encrypted`}),createdAt:n.createdAt(),updatedAt:n.updatedAt()},indexes:[r.unique([`scope`,`scopeId`,`key`]),r.on([`scope`,`key`])],enums:[e]}),a=t({name:`FeatureFlag`,description:`Feature flags for progressive rollout.`,schema:`saas_app`,map:`feature_flag`,fields:{id:n.id(),key:n.string({isUnique:!0,description:`Feature flag key`}),name:n.string({description:`Human-readable name`}),description:n.string({isOptional:!0}),enabled:n.boolean({default:!1}),defaultValue:n.boolean({default:!1}),rules:n.json({isOptional:!0,description:`Targeting rules`}),rolloutPercentage:n.int({default:0,description:`Percentage rollout (0-100)`}),createdAt:n.createdAt(),updatedAt:n.updatedAt()}});export{a as FeatureFlagEntity,i as SettingsEntity};
+import { defineEntity, field, index } from "../libs/schema/dist/entity/defineEntity.js";
+import "../libs/schema/dist/index.js";
+import { SettingsScopeEnum } from "./settings.enum.js";
+
+//#region src/settings/settings.entity.ts
+/**
+* Settings entity - key-value configuration store.
+*/
+const SettingsEntity = defineEntity({
+	name: "Settings",
+	description: "Application, organization, or user settings.",
+	schema: "saas_app",
+	map: "settings",
+	fields: {
+		id: field.id(),
+		key: field.string({ description: "Setting key (e.g., \"theme\", \"notifications.email\")" }),
+		scope: field.enum("SettingsScope"),
+		scopeId: field.string({
+			isOptional: true,
+			description: "ID of scoped entity (org, user, project)"
+		}),
+		value: field.json({ description: "Setting value" }),
+		valueType: field.string({
+			default: "\"string\"",
+			description: "Type hint for value"
+		}),
+		schema: field.json({
+			isOptional: true,
+			description: "JSON schema for validation"
+		}),
+		description: field.string({ isOptional: true }),
+		isSecret: field.boolean({
+			default: false,
+			description: "Whether value should be encrypted"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt()
+	},
+	indexes: [index.unique([
+		"scope",
+		"scopeId",
+		"key"
+	]), index.on(["scope", "key"])],
+	enums: [SettingsScopeEnum]
+});
+/**
+* FeatureFlag entity - feature toggles.
+*/
+const FeatureFlagEntity = defineEntity({
+	name: "FeatureFlag",
+	description: "Feature flags for progressive rollout.",
+	schema: "saas_app",
+	map: "feature_flag",
+	fields: {
+		id: field.id(),
+		key: field.string({
+			isUnique: true,
+			description: "Feature flag key"
+		}),
+		name: field.string({ description: "Human-readable name" }),
+		description: field.string({ isOptional: true }),
+		enabled: field.boolean({ default: false }),
+		defaultValue: field.boolean({ default: false }),
+		rules: field.json({
+			isOptional: true,
+			description: "Targeting rules"
+		}),
+		rolloutPercentage: field.int({
+			default: 0,
+			description: "Percentage rollout (0-100)"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt()
+	}
+});
+
+//#endregion
+export { FeatureFlagEntity, SettingsEntity };

package/dist/settings/settings.enum.d.ts

@@ -1,9 +1,9 @@
-import * as _lssm_lib_schema316 from "@lssm/lib.schema";
+import * as _lssm_lib_schema40 from "@lssm/lib.schema";
 
 //#region src/settings/settings.enum.d.ts
 /**
  * Settings scope enum.
  */
-declare const SettingsScopeEnum: _lssm_lib_schema316.EntityEnumDef;
+declare const SettingsScopeEnum: _lssm_lib_schema40.EntityEnumDef;
 //#endregion
 export { SettingsScopeEnum };

package/dist/settings/settings.enum.js

@@ -1 +1,21 @@
-import{defineEntityEnum as e}from"@lssm/lib.schema";const t=e({name:`SettingsScope`,values:[`APP`,`ORG`,`USER`,`PROJECT`],schema:`saas_app`,description:`Scope of a setting.`});export{t as SettingsScopeEnum};
+import { defineEntityEnum } from "../libs/schema/dist/entity/defineEntity.js";
+import "../libs/schema/dist/index.js";
+
+//#region src/settings/settings.enum.ts
+/**
+* Settings scope enum.
+*/
+const SettingsScopeEnum = defineEntityEnum({
+	name: "SettingsScope",
+	values: [
+		"APP",
+		"ORG",
+		"USER",
+		"PROJECT"
+	],
+	schema: "saas_app",
+	description: "Scope of a setting."
+});
+
+//#endregion
+export { SettingsScopeEnum };

package/dist/shared/mock-data.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.saas-boilerplate",
-  "version": "0.0.0-canary-20251217060834",
+  "version": "0.0.0-canary-20251217073102",
   "description": "SaaS Boilerplate - Users, Orgs, Projects, Billing, Settings",
   "type": "module",
   "main": "./dist/index.js",
@@ -51,18 +51,18 @@
     "test": "bun run"
   },
   "dependencies": {
-    "@lssm/lib.schema": "0.0.0-canary-20251217060834",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217060834",
-    "@lssm/lib.bus": "0.0.0-canary-20251217060834",
-    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217060834",
-    "@lssm/lib.jobs": "0.0.0-canary-20251217060834",
-    "@lssm/module.audit-trail": "0.0.0-canary-20251217060834",
-    "@lssm/module.notifications": "0.0.0-canary-20251217060834",
+    "@lssm/lib.schema": "0.0.0-canary-20251217073102",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217073102",
+    "@lssm/lib.bus": "0.0.0-canary-20251217073102",
+    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217073102",
+    "@lssm/lib.jobs": "0.0.0-canary-20251217073102",
+    "@lssm/module.audit-trail": "0.0.0-canary-20251217073102",
+    "@lssm/module.notifications": "0.0.0-canary-20251217073102",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217060834",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217060834",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217073102",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217073102",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },