@lssm/example.saas-boilerplate 0.0.0-canary-20251215234340 → 0.0.0-canary-20251216023757

package/.turbo/turbo-build.log

@@ -2,31 +2,39 @@ $ bun build:bundle && bun build:types
 $ tsdown
 ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
 ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/saas-boilerplate/tsdown.config.js 
-ℹ entry: src/events.ts, src/example.ts, src/feature.ts, src/index.ts, src/contracts/billing.ts, src/contracts/index.ts, src/contracts/project.ts, src/docs/index.ts, src/docs/saas-boilerplate.docblock.ts, src/entities/billing.ts, src/entities/index.ts, src/entities/project.ts, src/entities/settings.ts, src/handlers/billing.handlers.ts, src/handlers/index.ts, src/handlers/mock-data.ts, src/handlers/project.handlers.ts, src/presentations/billing.ts, src/presentations/dashboard.ts, src/presentations/index.ts, src/presentations/project-list.ts
+ℹ entry: src/example.ts, src/feature.ts, src/index.ts, src/billing/billing.contracts.ts, src/billing/billing.entity.ts, src/billing/billing.enum.ts, src/billing/billing.event.ts, src/billing/billing.handler.ts, src/billing/billing.presentation.ts, src/billing/billing.schema.ts, src/billing/index.ts, src/dashboard/dashboard.presentation.ts, src/dashboard/index.ts, src/docs/index.ts, src/docs/saas-boilerplate.docblock.ts, src/handlers/index.ts, src/presentations/index.ts, src/project/index.ts, src/project/project.contracts.ts, src/project/project.entity.ts, src/project/project.enum.ts, src/project/project.event.ts, src/project/project.handler.ts, src/project/project.presentation.ts, src/project/project.schema.ts, src/settings/index.ts, src/settings/settings.entity.ts, src/settings/settings.enum.ts, src/shared/mock-data.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/contracts/project.js               5.13 kB │ gzip: 1.37 kB
-ℹ dist/index.js                           5.05 kB │ gzip: 1.33 kB
-ℹ dist/contracts/billing.js               4.43 kB │ gzip: 1.25 kB
-ℹ dist/events.js                          3.50 kB │ gzip: 0.76 kB
-ℹ dist/docs/saas-boilerplate.docblock.js  3.46 kB │ gzip: 1.38 kB
-ℹ dist/entities/billing.js                2.57 kB │ gzip: 0.94 kB
-ℹ dist/handlers/mock-data.js              2.06 kB │ gzip: 0.78 kB
-ℹ dist/feature.js                         1.95 kB │ gzip: 0.52 kB
-ℹ dist/contracts/index.js                 1.70 kB │ gzip: 0.44 kB
-ℹ dist/entities/project.js                1.64 kB │ gzip: 0.67 kB
-ℹ dist/entities/settings.js               1.60 kB │ gzip: 0.67 kB
-ℹ dist/handlers/project.handlers.js       1.43 kB │ gzip: 0.64 kB
-ℹ dist/entities/index.js                  0.87 kB │ gzip: 0.36 kB
-ℹ dist/presentations/project-list.js      0.84 kB │ gzip: 0.38 kB
-ℹ dist/handlers/index.js                  0.78 kB │ gzip: 0.30 kB
-ℹ dist/presentations/billing.js           0.77 kB │ gzip: 0.32 kB
-ℹ dist/handlers/billing.handlers.js       0.72 kB │ gzip: 0.41 kB
-ℹ dist/presentations/dashboard.js         0.71 kB │ gzip: 0.33 kB
-ℹ dist/example.js                         0.63 kB │ gzip: 0.38 kB
-ℹ dist/presentations/index.js             0.52 kB │ gzip: 0.21 kB
-ℹ dist/docs/index.js                      0.04 kB │ gzip: 0.06 kB
-ℹ 21 files, total: 40.39 kB
-✔ Build complete in 42ms
+ℹ dist/index.js                             5.02 kB │ gzip: 1.28 kB
+ℹ dist/docs/saas-boilerplate.docblock.js    3.46 kB │ gzip: 1.38 kB
+ℹ dist/project/project.contracts.js         2.78 kB │ gzip: 0.94 kB
+ℹ dist/billing/billing.schema.js            2.73 kB │ gzip: 0.70 kB
+ℹ dist/billing/billing.entity.js            2.57 kB │ gzip: 0.94 kB
+ℹ dist/project/project.schema.js            2.57 kB │ gzip: 0.59 kB
+ℹ dist/shared/mock-data.js                  2.06 kB │ gzip: 0.78 kB
+ℹ dist/feature.js                           1.95 kB │ gzip: 0.52 kB
+ℹ dist/project/index.js                     1.87 kB │ gzip: 0.50 kB
+ℹ dist/billing/index.js                     1.87 kB │ gzip: 0.51 kB
+ℹ dist/billing/billing.contracts.js         1.86 kB │ gzip: 0.69 kB
+ℹ dist/project/project.event.js             1.80 kB │ gzip: 0.45 kB
+ℹ dist/billing/billing.event.js             1.65 kB │ gzip: 0.49 kB
+ℹ dist/project/project.entity.js            1.64 kB │ gzip: 0.67 kB
+ℹ dist/settings/settings.entity.js          1.49 kB │ gzip: 0.63 kB
+ℹ dist/project/project.handler.js           1.43 kB │ gzip: 0.65 kB
+ℹ dist/project/project.presentation.js      0.84 kB │ gzip: 0.38 kB
+ℹ dist/billing/billing.presentation.js      0.77 kB │ gzip: 0.32 kB
+ℹ dist/presentations/index.js               0.76 kB │ gzip: 0.25 kB
+ℹ dist/billing/billing.handler.js           0.72 kB │ gzip: 0.42 kB
+ℹ dist/dashboard/dashboard.presentation.js  0.71 kB │ gzip: 0.33 kB
+ℹ dist/handlers/index.js                    0.64 kB │ gzip: 0.23 kB
+ℹ dist/example.js                           0.63 kB │ gzip: 0.38 kB
+ℹ dist/billing/billing.enum.js              0.29 kB │ gzip: 0.22 kB
+ℹ dist/project/project.enum.js              0.24 kB │ gzip: 0.17 kB
+ℹ dist/settings/settings.enum.js            0.21 kB │ gzip: 0.18 kB
+ℹ dist/settings/index.js                    0.21 kB │ gzip: 0.13 kB
+ℹ dist/dashboard/index.js                   0.17 kB │ gzip: 0.11 kB
+ℹ dist/docs/index.js                        0.04 kB │ gzip: 0.06 kB
+ℹ 29 files, total: 42.99 kB
+✔ Build complete in 65ms
 $ tsc --noEmit

package/CHANGELOG.md

@@ -1,15 +1,15 @@
 # @lssm/example.saas-boilerplate
 
-## 0.0.0-canary-20251215234340
+## 0.0.0-canary-20251216023757
 
 ### Patch Changes
 
 - 3086383: refactor: dependencies upgrade
 - Updated dependencies [3086383]
-  - @lssm/lib.contracts@0.0.0-canary-20251215234340
-  - @lssm/lib.schema@0.0.0-canary-20251215234340
-  - @lssm/lib.jobs@0.0.0-canary-20251215234340
-  - @lssm/lib.bus@0.0.0-canary-20251215234340
-  - @lssm/lib.identity-rbac@0.0.0-canary-20251215234340
-  - @lssm/module.audit-trail@0.0.0-canary-20251215234340
-  - @lssm/module.notifications@0.0.0-canary-20251215234340
+  - @lssm/lib.contracts@0.0.0-canary-20251216023757
+  - @lssm/lib.schema@0.0.0-canary-20251216023757
+  - @lssm/lib.jobs@0.0.0-canary-20251216023757
+  - @lssm/lib.bus@0.0.0-canary-20251216023757
+  - @lssm/lib.identity-rbac@0.0.0-canary-20251216023757
+  - @lssm/module.audit-trail@0.0.0-canary-20251216023757
+  - @lssm/module.notifications@0.0.0-canary-20251216023757

package/dist/billing/billing.contracts.js

@@ -0,0 +1 @@
+import{CheckFeatureAccessInputModel as e,CheckFeatureAccessOutputModel as t,GetUsageSummaryInputModel as n,GetUsageSummaryOutputModel as r,RecordUsageInputModel as i,RecordUsageOutputModel as a,SubscriptionModel as o,UsageRecordedPayloadModel as s}from"./billing.schema.js";import{defineCommand as c,defineQuery as l}from"@lssm/lib.contracts";const u=[`example.saas-boilerplate`],d=l({meta:{name:`saas.billing.subscription.get`,version:1,stability:`stable`,owners:[...u],tags:[`saas`,`billing`,`subscription`],description:`Get organization subscription status.`,goal:`Show current plan and billing status.`,context:`Billing page, plan upgrade prompts.`},io:{input:null,output:o},policy:{auth:`user`}}),f=c({meta:{name:`saas.billing.usage.record`,version:1,stability:`stable`,owners:[...u],tags:[`saas`,`billing`,`usage`],description:`Record usage of a metered feature.`,goal:`Track feature usage for billing.`,context:`Called by services when metered features are used.`},io:{input:i,output:a},policy:{auth:`user`},sideEffects:{emits:[{name:`billing.usage.recorded`,version:1,when:`Usage is recorded`,payload:s}]}}),p=l({meta:{name:`saas.billing.usage.summary`,version:1,stability:`stable`,owners:[...u],tags:[`saas`,`billing`,`usage`],description:`Get usage summary for the current billing period.`,goal:`Show usage vs limits.`,context:`Billing page, usage dashboards.`},io:{input:n,output:r},policy:{auth:`user`}}),m=l({meta:{name:`saas.billing.feature.check`,version:1,stability:`stable`,owners:[...u],tags:[`saas`,`billing`,`feature`],description:`Check if organization has access to a feature.`,goal:`Gate features based on plan/usage.`,context:`Feature access checks, upgrade prompts.`},io:{input:e,output:t},policy:{auth:`user`}});export{m as CheckFeatureAccessContract,d as GetSubscriptionContract,p as GetUsageSummaryContract,f as RecordUsageContract};

package/dist/billing/billing.enum.js

@@ -0,0 +1 @@
+import{defineEnum as e}from"@lssm/lib.schema";const t=e(`SubscriptionStatus`,[`TRIALING`,`ACTIVE`,`PAST_DUE`,`CANCELED`,`PAUSED`]),n=e(`FeatureAccessReason`,[`included`,`limit_available`,`limit_reached`,`not_in_plan`]);export{n as FeatureAccessReasonEnum,t as SubscriptionStatusSchemaEnum};

package/dist/billing/billing.event.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,defineSchemaModel as t}from"@lssm/lib.schema";import{defineEvent as n}from"@lssm/lib.contracts";const r=t({name:`UsageRecordedPayload`,description:`Payload when feature usage is recorded`,fields:{organizationId:{type:e.String_unsecure(),isOptional:!1},feature:{type:e.String_unsecure(),isOptional:!1},quantity:{type:e.Int_unsecure(),isOptional:!1},billingPeriod:{type:e.String_unsecure(),isOptional:!1},recordedAt:{type:e.DateTime(),isOptional:!1}}}),i=t({name:`UsageLimitReachedPayload`,description:`Payload when usage limit is reached`,fields:{organizationId:{type:e.String_unsecure(),isOptional:!1},feature:{type:e.String_unsecure(),isOptional:!1},limit:{type:e.Int_unsecure(),isOptional:!1},currentUsage:{type:e.Int_unsecure(),isOptional:!1},reachedAt:{type:e.DateTime(),isOptional:!1}}}),a=t({name:`SubscriptionChangedPayload`,description:`Payload when subscription status changes`,fields:{organizationId:{type:e.String_unsecure(),isOptional:!1},previousPlan:{type:e.String_unsecure(),isOptional:!0},newPlan:{type:e.String_unsecure(),isOptional:!1},previousStatus:{type:e.String_unsecure(),isOptional:!0},newStatus:{type:e.String_unsecure(),isOptional:!1},changedAt:{type:e.DateTime(),isOptional:!1}}}),o=n({name:`billing.usage.recorded`,version:1,description:`Feature usage has been recorded.`,payload:r}),s=n({name:`billing.limit.reached`,version:1,description:`Usage limit has been reached for a feature.`,payload:i}),c=n({name:`billing.subscription.changed`,version:1,description:`Subscription status has changed.`,payload:a});export{c as SubscriptionChangedEvent,s as UsageLimitReachedEvent,o as UsageRecordedEvent};

package/dist/billing/billing.handler.js

@@ -0,0 +1 @@
+import{MOCK_SUBSCRIPTION as e,MOCK_USAGE_SUMMARY as t}from"../shared/mock-data.js";async function n(){return e}async function r(e){return{...t,period:e.period??`current_month`}}async function i(e){return{recorded:!0,newTotal:t.apiCalls.total+e.quantity}}async function a(n){let{feature:r}=n;return{custom_domains:{allowed:!0},api_access:{allowed:!0,currentUsage:t.apiCalls.total,limit:t.apiCalls.limit},advanced_analytics:{allowed:!1,reason:`FEATURE_NOT_INCLUDED`},unlimited_projects:{allowed:!1,reason:`PLAN_LIMIT`,currentUsage:e.usage.projects,limit:e.limits.projects}}[r]??{allowed:!0}}export{a as mockCheckFeatureAccessHandler,n as mockGetSubscriptionHandler,r as mockGetUsageSummaryHandler,i as mockRecordUsageHandler};

package/dist/billing/billing.schema.js

@@ -0,0 +1 @@
+import{FeatureAccessReasonEnum as e,SubscriptionStatusSchemaEnum as t}from"./billing.enum.js";import{ScalarTypeEnum as n,defineSchemaModel as r}from"@lssm/lib.schema";const i=r({name:`Subscription`,description:`Organization subscription details`,fields:{id:{type:n.String_unsecure(),isOptional:!1},organizationId:{type:n.String_unsecure(),isOptional:!1},planId:{type:n.String_unsecure(),isOptional:!1},planName:{type:n.String_unsecure(),isOptional:!1},status:{type:t,isOptional:!1},currentPeriodStart:{type:n.DateTime(),isOptional:!1},currentPeriodEnd:{type:n.DateTime(),isOptional:!1},trialEndsAt:{type:n.DateTime(),isOptional:!0},cancelAtPeriodEnd:{type:n.Boolean(),isOptional:!1}}}),a=r({name:`UsageSummary`,description:`Usage summary for a feature`,fields:{feature:{type:n.String_unsecure(),isOptional:!1},used:{type:n.Int_unsecure(),isOptional:!1},limit:{type:n.Int_unsecure(),isOptional:!0},unit:{type:n.String_unsecure(),isOptional:!0},percentage:{type:n.Float_unsecure(),isOptional:!0}}}),o=r({name:`RecordUsageInput`,description:`Input for recording feature usage`,fields:{feature:{type:n.String_unsecure(),isOptional:!1},quantity:{type:n.Int_unsecure(),isOptional:!1},sourceId:{type:n.String_unsecure(),isOptional:!0},sourceType:{type:n.String_unsecure(),isOptional:!0},metadata:{type:n.JSONObject(),isOptional:!0}}}),s=r({name:`RecordUsageOutput`,description:`Output for recording feature usage`,fields:{recorded:{type:n.Boolean(),isOptional:!1},currentUsage:{type:n.Int_unsecure(),isOptional:!1},limit:{type:n.Int_unsecure(),isOptional:!0},limitReached:{type:n.Boolean(),isOptional:!1}}}),c=r({name:`UsageRecordedPayload`,description:`Payload for usage.recorded event`,fields:{feature:{type:n.String_unsecure(),isOptional:!1},quantity:{type:n.Int_unsecure(),isOptional:!1}}}),l=r({name:`GetUsageSummaryInput`,description:`Input for getting usage summary`,fields:{billingPeriod:{type:n.String_unsecure(),isOptional:!0}}}),u=r({name:`GetUsageSummaryOutput`,description:`Output for usage summary`,fields:{billingPeriod:{type:n.String_unsecure(),isOptional:!1},usage:{type:a,isArray:!0,isOptional:!1}}}),d=r({name:`CheckFeatureAccessInput`,description:`Input for checking feature access`,fields:{feature:{type:n.String_unsecure(),isOptional:!1}}}),f=r({name:`CheckFeatureAccessOutput`,description:`Output for feature access check`,fields:{hasAccess:{type:n.Boolean(),isOptional:!1},reason:{type:e,isOptional:!0},upgradeUrl:{type:n.URL(),isOptional:!0}}});export{d as CheckFeatureAccessInputModel,f as CheckFeatureAccessOutputModel,l as GetUsageSummaryInputModel,u as GetUsageSummaryOutputModel,o as RecordUsageInputModel,s as RecordUsageOutputModel,i as SubscriptionModel,c as UsageRecordedPayloadModel,a as UsageSummaryModel};

package/dist/billing/index.js

@@ -0,0 +1 @@
+import{FeatureAccessReasonEnum as e,SubscriptionStatusSchemaEnum as t}from"./billing.enum.js";import{CheckFeatureAccessInputModel as n,CheckFeatureAccessOutputModel as r,GetUsageSummaryInputModel as i,GetUsageSummaryOutputModel as a,RecordUsageInputModel as o,RecordUsageOutputModel as s,SubscriptionModel as c,UsageRecordedPayloadModel as l,UsageSummaryModel as u}from"./billing.schema.js";import{CheckFeatureAccessContract as d,GetSubscriptionContract as f,GetUsageSummaryContract as p,RecordUsageContract as m}from"./billing.contracts.js";import{SubscriptionChangedEvent as h,UsageLimitReachedEvent as g,UsageRecordedEvent as _}from"./billing.event.js";import{BillingUsageEntity as v,SubscriptionEntity as y,SubscriptionStatusEnum as b,UsageLimitEntity as x}from"./billing.entity.js";import{SubscriptionPresentation as S,UsageDashboardPresentation as C}from"./billing.presentation.js";import{mockCheckFeatureAccessHandler as w,mockGetSubscriptionHandler as T,mockGetUsageSummaryHandler as E,mockRecordUsageHandler as D}from"./billing.handler.js";export{v as BillingUsageEntity,d as CheckFeatureAccessContract,n as CheckFeatureAccessInputModel,r as CheckFeatureAccessOutputModel,e as FeatureAccessReasonEnum,f as GetSubscriptionContract,p as GetUsageSummaryContract,i as GetUsageSummaryInputModel,a as GetUsageSummaryOutputModel,m as RecordUsageContract,o as RecordUsageInputModel,s as RecordUsageOutputModel,h as SubscriptionChangedEvent,y as SubscriptionEntity,c as SubscriptionModel,S as SubscriptionPresentation,b as SubscriptionStatusEnum,t as SubscriptionStatusSchemaEnum,C as UsageDashboardPresentation,x as UsageLimitEntity,g as UsageLimitReachedEvent,_ as UsageRecordedEvent,l as UsageRecordedPayloadModel,u as UsageSummaryModel,w as mockCheckFeatureAccessHandler,T as mockGetSubscriptionHandler,E as mockGetUsageSummaryHandler,D as mockRecordUsageHandler};

package/dist/dashboard/index.js

@@ -0,0 +1 @@
+import{SaasDashboardPresentation as e,SettingsPanelPresentation as t}from"./dashboard.presentation.js";export{e as SaasDashboardPresentation,t as SettingsPanelPresentation};

package/dist/handlers/index.js

@@ -1 +1 @@
-import{MOCK_PROJECTS as e,MOCK_SUBSCRIPTION as t,MOCK_USAGE_SUMMARY as n}from"./mock-data.js";import{mockCreateProjectHandler as r,mockDeleteProjectHandler as i,mockGetProjectHandler as a,mockListProjectsHandler as o,mockUpdateProjectHandler as s}from"./project.handlers.js";import{mockCheckFeatureAccessHandler as c,mockGetSubscriptionHandler as l,mockGetUsageSummaryHandler as u,mockRecordUsageHandler as d}from"./billing.handlers.js";export{e as MOCK_PROJECTS,t as MOCK_SUBSCRIPTION,n as MOCK_USAGE_SUMMARY,c as mockCheckFeatureAccessHandler,r as mockCreateProjectHandler,i as mockDeleteProjectHandler,a as mockGetProjectHandler,l as mockGetSubscriptionHandler,u as mockGetUsageSummaryHandler,o as mockListProjectsHandler,d as mockRecordUsageHandler,s as mockUpdateProjectHandler};
+import{mockCheckFeatureAccessHandler as e,mockGetSubscriptionHandler as t,mockGetUsageSummaryHandler as n,mockRecordUsageHandler as r}from"../billing/billing.handler.js";import{mockCreateProjectHandler as i,mockDeleteProjectHandler as a,mockGetProjectHandler as o,mockListProjectsHandler as s,mockUpdateProjectHandler as c}from"../project/project.handler.js";export{e as mockCheckFeatureAccessHandler,i as mockCreateProjectHandler,a as mockDeleteProjectHandler,o as mockGetProjectHandler,t as mockGetSubscriptionHandler,n as mockGetUsageSummaryHandler,s as mockListProjectsHandler,r as mockRecordUsageHandler,c as mockUpdateProjectHandler};

package/dist/index.js

@@ -1 +1 @@
-import{ProjectArchivedEvent as e,ProjectCreatedEvent as t,ProjectDeletedEvent as n,ProjectUpdatedEvent as r,SaasBoilerplateEvents as i,SubscriptionChangedEvent as a,UsageLimitReachedEvent as o,UsageRecordedEvent as s}from"./events.js";import c from"./example.js";import{SaasBoilerplateFeature as l}from"./feature.js";import{ProjectEntity as u,ProjectMemberEntity as d,ProjectStatusEnum as f}from"./entities/project.js";import{FeatureFlagEntity as p,SettingsEntity as m,SettingsScopeEnum as h}from"./entities/settings.js";import{BillingUsageEntity as g,SubscriptionEntity as _,SubscriptionStatusEnum as v,UsageLimitEntity as y}from"./entities/billing.js";import{identityRbacEntities as b,identityRbacSchemaContribution as x,saasBoilerplateEntities as S,saasBoilerplateSchemaContribution as C}from"./entities/index.js";import{CreateProjectContract as w,CreateProjectInputModel as T,DeleteProjectContract as E,DeleteProjectInputModel as D,DeleteProjectOutputModel as O,GetProjectContract as k,GetProjectInputModel as A,ListProjectsContract as j,ListProjectsInputModel as M,ListProjectsOutputModel as N,ProjectDeletedPayloadModel as P,ProjectModel as F,ProjectStatusFilterEnum as I,UpdateProjectContract as L,UpdateProjectInputModel as R}from"./contracts/project.js";import{CheckFeatureAccessContract as z,CheckFeatureAccessInputModel as B,CheckFeatureAccessOutputModel as V,FeatureAccessReasonEnum as ee,GetSubscriptionContract as H,GetUsageSummaryContract as U,GetUsageSummaryInputModel as W,GetUsageSummaryOutputModel as G,RecordUsageContract as K,RecordUsageInputModel as q,RecordUsageOutputModel as J,SubscriptionModel as Y,UsageRecordedPayloadModel as X,UsageSummaryModel as Z}from"./contracts/billing.js";import"./contracts/index.js";import{MOCK_PROJECTS as Q,MOCK_SUBSCRIPTION as $,MOCK_USAGE_SUMMARY as te}from"./handlers/mock-data.js";import{mockCreateProjectHandler as ne,mockDeleteProjectHandler as re,mockGetProjectHandler as ie,mockListProjectsHandler as ae,mockUpdateProjectHandler as oe}from"./handlers/project.handlers.js";import{mockCheckFeatureAccessHandler as se,mockGetSubscriptionHandler as ce,mockGetUsageSummaryHandler as le,mockRecordUsageHandler as ue}from"./handlers/billing.handlers.js";import{ProjectDetailPresentation as de,ProjectListPresentation as fe}from"./presentations/project-list.js";import{SubscriptionPresentation as pe,UsageDashboardPresentation as me}from"./presentations/billing.js";import{SaasDashboardPresentation as he,SettingsPanelPresentation as ge}from"./presentations/dashboard.js";import{SaasBoilerplatePresentations as _e}from"./presentations/index.js";import"./docs/index.js";import{identityRbacSchemaContribution as ve}from"@lssm/lib.identity-rbac";import{jobsSchemaContribution as ye}from"@lssm/lib.jobs";import{auditTrailSchemaContribution as be}from"@lssm/module.audit-trail";import{notificationsSchemaContribution as xe}from"@lssm/module.notifications";const Se={modules:[ve,ye,be,xe,C],provider:`postgresql`,outputPath:`./prisma/schema/generated.prisma`};export{g as BillingUsageEntity,z as CheckFeatureAccessContract,B as CheckFeatureAccessInputModel,V as CheckFeatureAccessOutputModel,w as CreateProjectContract,T as CreateProjectInputModel,E as DeleteProjectContract,D as DeleteProjectInputModel,O as DeleteProjectOutputModel,ee as FeatureAccessReasonEnum,p as FeatureFlagEntity,k as GetProjectContract,A as GetProjectInputModel,H as GetSubscriptionContract,U as GetUsageSummaryContract,W as GetUsageSummaryInputModel,G as GetUsageSummaryOutputModel,j as ListProjectsContract,M as ListProjectsInputModel,N as ListProjectsOutputModel,Q as MOCK_PROJECTS,$ as MOCK_SUBSCRIPTION,te as MOCK_USAGE_SUMMARY,e as ProjectArchivedEvent,t as ProjectCreatedEvent,n as ProjectDeletedEvent,P as ProjectDeletedPayloadModel,de as ProjectDetailPresentation,u as ProjectEntity,fe as ProjectListPresentation,d as ProjectMemberEntity,F as ProjectModel,f as ProjectStatusEnum,I as ProjectStatusFilterEnum,r as ProjectUpdatedEvent,K as RecordUsageContract,q as RecordUsageInputModel,J as RecordUsageOutputModel,i as SaasBoilerplateEvents,l as SaasBoilerplateFeature,_e as SaasBoilerplatePresentations,he as SaasDashboardPresentation,m as SettingsEntity,ge as SettingsPanelPresentation,h as SettingsScopeEnum,a as SubscriptionChangedEvent,_ as SubscriptionEntity,Y as SubscriptionModel,pe as SubscriptionPresentation,v as SubscriptionStatusEnum,L as UpdateProjectContract,R as UpdateProjectInputModel,me as UsageDashboardPresentation,y as UsageLimitEntity,o as UsageLimitReachedEvent,s as UsageRecordedEvent,X as UsageRecordedPayloadModel,Z as UsageSummaryModel,c as example,b as identityRbacEntities,x as identityRbacSchemaContribution,se as mockCheckFeatureAccessHandler,ne as mockCreateProjectHandler,re as mockDeleteProjectHandler,ie as mockGetProjectHandler,ce as mockGetSubscriptionHandler,le as mockGetUsageSummaryHandler,ae as mockListProjectsHandler,ue as mockRecordUsageHandler,oe as mockUpdateProjectHandler,S as saasBoilerplateEntities,C as saasBoilerplateSchemaContribution,Se as schemaComposition};
+import e from"./example.js";import{SaasBoilerplateFeature as t}from"./feature.js";import{FeatureAccessReasonEnum as n,SubscriptionStatusSchemaEnum as r}from"./billing/billing.enum.js";import{CheckFeatureAccessInputModel as i,CheckFeatureAccessOutputModel as a,GetUsageSummaryInputModel as o,GetUsageSummaryOutputModel as s,RecordUsageInputModel as c,RecordUsageOutputModel as ee,SubscriptionModel as te,UsageRecordedPayloadModel as ne,UsageSummaryModel as re}from"./billing/billing.schema.js";import{CheckFeatureAccessContract as l,GetSubscriptionContract as u,GetUsageSummaryContract as d,RecordUsageContract as f}from"./billing/billing.contracts.js";import{SubscriptionChangedEvent as p,UsageLimitReachedEvent as m,UsageRecordedEvent as h}from"./billing/billing.event.js";import{BillingUsageEntity as g,SubscriptionEntity as _,SubscriptionStatusEnum as v,UsageLimitEntity as y}from"./billing/billing.entity.js";import{SubscriptionPresentation as b,UsageDashboardPresentation as x}from"./billing/billing.presentation.js";import{mockCheckFeatureAccessHandler as S,mockGetSubscriptionHandler as C,mockGetUsageSummaryHandler as w,mockRecordUsageHandler as T}from"./billing/billing.handler.js";import"./billing/index.js";import{ProjectStatusFilterEnum as E,ProjectStatusSchemaEnum as D}from"./project/project.enum.js";import{CreateProjectInputModel as O,DeleteProjectInputModel as k,DeleteProjectOutputModel as A,GetProjectInputModel as j,ListProjectsInputModel as M,ListProjectsOutputModel as N,ProjectDeletedPayloadModel as P,ProjectModel as F,UpdateProjectInputModel as ie}from"./project/project.schema.js";import{CreateProjectContract as I,DeleteProjectContract as L,GetProjectContract as R,ListProjectsContract as z,UpdateProjectContract as B}from"./project/project.contracts.js";import{ProjectArchivedEvent as V,ProjectCreatedEvent as H,ProjectDeletedEvent as U,ProjectUpdatedEvent as W}from"./project/project.event.js";import{ProjectEntity as G,ProjectMemberEntity as K,ProjectStatusEnum as q}from"./project/project.entity.js";import{ProjectDetailPresentation as J,ProjectListPresentation as Y}from"./project/project.presentation.js";import{mockCreateProjectHandler as ae,mockDeleteProjectHandler as oe,mockGetProjectHandler as se,mockListProjectsHandler as ce,mockUpdateProjectHandler as le}from"./project/project.handler.js";import"./project/index.js";import{SettingsScopeEnum as X}from"./settings/settings.enum.js";import{FeatureFlagEntity as Z,SettingsEntity as Q}from"./settings/settings.entity.js";import"./settings/index.js";import{SaasDashboardPresentation as ue,SettingsPanelPresentation as de}from"./dashboard/dashboard.presentation.js";import"./docs/index.js";import{identityRbacSchemaContribution as fe}from"@lssm/lib.identity-rbac";import{jobsSchemaContribution as pe}from"@lssm/lib.jobs";import{auditTrailSchemaContribution as me}from"@lssm/module.audit-trail";import{notificationsSchemaContribution as he}from"@lssm/module.notifications";const $={moduleId:`@lssm/example.saas-boilerplate`,entities:[G,K,Q,Z,_,g,y],enums:[q,X,v]},ge={modules:[fe,pe,me,he,$],provider:`postgresql`,outputPath:`./prisma/schema/generated.prisma`};export{g as BillingUsageEntity,l as CheckFeatureAccessContract,i as CheckFeatureAccessInputModel,a as CheckFeatureAccessOutputModel,I as CreateProjectContract,O as CreateProjectInputModel,L as DeleteProjectContract,k as DeleteProjectInputModel,A as DeleteProjectOutputModel,n as FeatureAccessReasonEnum,Z as FeatureFlagEntity,R as GetProjectContract,j as GetProjectInputModel,u as GetSubscriptionContract,d as GetUsageSummaryContract,o as GetUsageSummaryInputModel,s as GetUsageSummaryOutputModel,z as ListProjectsContract,M as ListProjectsInputModel,N as ListProjectsOutputModel,V as ProjectArchivedEvent,H as ProjectCreatedEvent,U as ProjectDeletedEvent,P as ProjectDeletedPayloadModel,J as ProjectDetailPresentation,G as ProjectEntity,Y as ProjectListPresentation,K as ProjectMemberEntity,F as ProjectModel,q as ProjectStatusEnum,E as ProjectStatusFilterEnum,D as ProjectStatusSchemaEnum,W as ProjectUpdatedEvent,f as RecordUsageContract,c as RecordUsageInputModel,ee as RecordUsageOutputModel,t as SaasBoilerplateFeature,ue as SaasDashboardPresentation,Q as SettingsEntity,de as SettingsPanelPresentation,X as SettingsScopeEnum,p as SubscriptionChangedEvent,_ as SubscriptionEntity,te as SubscriptionModel,b as SubscriptionPresentation,v as SubscriptionStatusEnum,r as SubscriptionStatusSchemaEnum,B as UpdateProjectContract,ie as UpdateProjectInputModel,x as UsageDashboardPresentation,y as UsageLimitEntity,m as UsageLimitReachedEvent,h as UsageRecordedEvent,ne as UsageRecordedPayloadModel,re as UsageSummaryModel,e as example,S as mockCheckFeatureAccessHandler,ae as mockCreateProjectHandler,oe as mockDeleteProjectHandler,se as mockGetProjectHandler,C as mockGetSubscriptionHandler,w as mockGetUsageSummaryHandler,ce as mockListProjectsHandler,T as mockRecordUsageHandler,le as mockUpdateProjectHandler,$ as saasBoilerplateSchemaContribution,ge as schemaComposition};

package/dist/presentations/index.js

@@ -1 +1 @@
-import{ProjectDetailPresentation as e,ProjectListPresentation as t}from"./project-list.js";import{SubscriptionPresentation as n,UsageDashboardPresentation as r}from"./billing.js";import{SaasDashboardPresentation as i,SettingsPanelPresentation as a}from"./dashboard.js";const o=[i,t,e,n,r,a];export{e as ProjectDetailPresentation,t as ProjectListPresentation,o as SaasBoilerplatePresentations,i as SaasDashboardPresentation,a as SettingsPanelPresentation,n as SubscriptionPresentation,r as UsageDashboardPresentation};
+import{SubscriptionPresentation as e,UsageDashboardPresentation as t}from"../billing/billing.presentation.js";import{ProjectDetailPresentation as n,ProjectListPresentation as r}from"../project/project.presentation.js";import{SaasDashboardPresentation as i,SettingsPanelPresentation as a}from"../dashboard/dashboard.presentation.js";const o={SubscriptionPresentation:void 0,UsageDashboardPresentation:void 0,ProjectListPresentation:void 0,ProjectDetailPresentation:void 0,SaasDashboardPresentation:void 0,SettingsPanelPresentation:void 0};export{n as ProjectDetailPresentation,r as ProjectListPresentation,o as SaasBoilerplatePresentations,i as SaasDashboardPresentation,a as SettingsPanelPresentation,e as SubscriptionPresentation,t as UsageDashboardPresentation};

package/dist/project/index.js

@@ -0,0 +1 @@
+import{ProjectStatusFilterEnum as e,ProjectStatusSchemaEnum as t}from"./project.enum.js";import{CreateProjectInputModel as n,DeleteProjectInputModel as r,DeleteProjectOutputModel as i,GetProjectInputModel as a,ListProjectsInputModel as o,ListProjectsOutputModel as s,ProjectDeletedPayloadModel as c,ProjectModel as l,UpdateProjectInputModel as u}from"./project.schema.js";import{CreateProjectContract as d,DeleteProjectContract as f,GetProjectContract as p,ListProjectsContract as m,UpdateProjectContract as h}from"./project.contracts.js";import{ProjectArchivedEvent as g,ProjectCreatedEvent as _,ProjectDeletedEvent as v,ProjectUpdatedEvent as y}from"./project.event.js";import{ProjectEntity as b,ProjectMemberEntity as x,ProjectStatusEnum as S}from"./project.entity.js";import{ProjectDetailPresentation as C,ProjectListPresentation as w}from"./project.presentation.js";import{mockCreateProjectHandler as T,mockDeleteProjectHandler as E,mockGetProjectHandler as D,mockListProjectsHandler as O,mockUpdateProjectHandler as k}from"./project.handler.js";export{d as CreateProjectContract,n as CreateProjectInputModel,f as DeleteProjectContract,r as DeleteProjectInputModel,i as DeleteProjectOutputModel,p as GetProjectContract,a as GetProjectInputModel,m as ListProjectsContract,o as ListProjectsInputModel,s as ListProjectsOutputModel,g as ProjectArchivedEvent,_ as ProjectCreatedEvent,v as ProjectDeletedEvent,c as ProjectDeletedPayloadModel,C as ProjectDetailPresentation,b as ProjectEntity,w as ProjectListPresentation,x as ProjectMemberEntity,l as ProjectModel,S as ProjectStatusEnum,e as ProjectStatusFilterEnum,t as ProjectStatusSchemaEnum,y as ProjectUpdatedEvent,h as UpdateProjectContract,u as UpdateProjectInputModel,T as mockCreateProjectHandler,E as mockDeleteProjectHandler,D as mockGetProjectHandler,O as mockListProjectsHandler,k as mockUpdateProjectHandler};

package/dist/project/project.contracts.js

@@ -0,0 +1 @@
+import{CreateProjectInputModel as e,DeleteProjectInputModel as t,DeleteProjectOutputModel as n,GetProjectInputModel as r,ListProjectsInputModel as i,ListProjectsOutputModel as a,ProjectDeletedPayloadModel as o,ProjectModel as s,UpdateProjectInputModel as c}from"./project.schema.js";import{defineCommand as l,defineQuery as u}from"@lssm/lib.contracts/spec";const d=[`example.saas-boilerplate`],f=l({meta:{name:`saas.project.create`,version:1,stability:`stable`,owners:[...d],tags:[`saas`,`project`,`create`],description:`Create a new project in the organization.`,goal:`Allow users to create projects for organizing work.`,context:`Called from project creation UI or API.`},io:{input:e,output:s,errors:{SLUG_EXISTS:{description:`A project with this slug already exists`,http:409,gqlCode:`SLUG_EXISTS`,when:`Slug is already taken in the organization`},LIMIT_REACHED:{description:`Project limit reached for this plan`,http:403,gqlCode:`LIMIT_REACHED`,when:`Organization has reached project limit`}}},policy:{auth:`user`},sideEffects:{emits:[{name:`project.created`,version:1,when:`Project is created`,payload:s}],audit:[`project.created`]}}),p=u({meta:{name:`saas.project.get`,version:1,stability:`stable`,owners:[...d],tags:[`saas`,`project`,`get`],description:`Get a project by ID.`,goal:`Retrieve project details.`,context:`Project detail page, API calls.`},io:{input:r,output:s,errors:{NOT_FOUND:{description:`Project not found`,http:404,gqlCode:`NOT_FOUND`,when:`Project ID is invalid or user lacks access`}}},policy:{auth:`user`}}),m=l({meta:{name:`saas.project.update`,version:1,stability:`stable`,owners:[...d],tags:[`saas`,`project`,`update`],description:`Update project details.`,goal:`Allow project owners/editors to modify project.`,context:`Project settings page.`},io:{input:c,output:s},policy:{auth:`user`},sideEffects:{emits:[{name:`project.updated`,version:1,when:`Project is updated`,payload:s}],audit:[`project.updated`]}}),h=l({meta:{name:`saas.project.delete`,version:1,stability:`stable`,owners:[...d],tags:[`saas`,`project`,`delete`],description:`Delete a project (soft delete).`,goal:`Allow project owners to remove projects.`,context:`Project settings page.`},io:{input:t,output:n},policy:{auth:`user`},sideEffects:{emits:[{name:`project.deleted`,version:1,when:`Project is deleted`,payload:o}],audit:[`project.deleted`]}}),g=u({meta:{name:`saas.project.list`,version:1,stability:`stable`,owners:[...d],tags:[`saas`,`project`,`list`],description:`List projects in the organization.`,goal:`Show all projects user has access to.`,context:`Project list page, dashboard.`},io:{input:i,output:a},policy:{auth:`user`}});export{f as CreateProjectContract,h as DeleteProjectContract,p as GetProjectContract,g as ListProjectsContract,m as UpdateProjectContract};

package/dist/project/project.enum.js

@@ -0,0 +1 @@
+import{defineEnum as e}from"@lssm/lib.schema";const t=e(`ProjectStatus`,[`DRAFT`,`ACTIVE`,`ARCHIVED`,`DELETED`]),n=e(`ProjectStatusFilter`,[`DRAFT`,`ACTIVE`,`ARCHIVED`,`all`]);export{n as ProjectStatusFilterEnum,t as ProjectStatusSchemaEnum};

package/dist/project/project.event.js

@@ -0,0 +1 @@
+import{ScalarTypeEnum as e,defineSchemaModel as t}from"@lssm/lib.schema";import{defineEvent as n}from"@lssm/lib.contracts";const r=t({name:`ProjectCreatedPayload`,description:`Payload when a project is created`,fields:{projectId:{type:e.String_unsecure(),isOptional:!1},name:{type:e.String_unsecure(),isOptional:!1},organizationId:{type:e.String_unsecure(),isOptional:!1},createdBy:{type:e.String_unsecure(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),i=t({name:`ProjectUpdatedPayload`,description:`Payload when a project is updated`,fields:{projectId:{type:e.String_unsecure(),isOptional:!1},updatedFields:{type:e.String_unsecure(),isArray:!0,isOptional:!1},updatedBy:{type:e.String_unsecure(),isOptional:!1},updatedAt:{type:e.DateTime(),isOptional:!1}}}),a=t({name:`ProjectDeletedPayload`,description:`Payload when a project is deleted`,fields:{projectId:{type:e.String_unsecure(),isOptional:!1},organizationId:{type:e.String_unsecure(),isOptional:!1},deletedBy:{type:e.String_unsecure(),isOptional:!1},deletedAt:{type:e.DateTime(),isOptional:!1}}}),o=t({name:`ProjectArchivedPayload`,description:`Payload when a project is archived`,fields:{projectId:{type:e.String_unsecure(),isOptional:!1},archivedBy:{type:e.String_unsecure(),isOptional:!1},archivedAt:{type:e.DateTime(),isOptional:!1}}}),s=n({name:`project.created`,version:1,description:`A new project has been created.`,payload:r}),c=n({name:`project.updated`,version:1,description:`A project has been updated.`,payload:i}),l=n({name:`project.deleted`,version:1,description:`A project has been deleted.`,payload:a}),u=n({name:`project.archived`,version:1,description:`A project has been archived.`,payload:o});export{u as ProjectArchivedEvent,s as ProjectCreatedEvent,l as ProjectDeletedEvent,c as ProjectUpdatedEvent};

package/dist/project/project.handler.js

@@ -0,0 +1 @@
+import{MOCK_PROJECTS as e}from"../shared/mock-data.js";async function t(t){let{status:n,search:r,limit:i=20,offset:a=0}=t,o=[...e];if(n&&n!==`all`&&(o=o.filter(e=>e.status===n)),r){let e=r.toLowerCase();o=o.filter(t=>t.name.toLowerCase().includes(e)||t.description?.toLowerCase().includes(e)||t.tags.some(t=>t.toLowerCase().includes(e)))}o.sort((e,t)=>t.updatedAt.getTime()-e.updatedAt.getTime());let s=o.length;return{projects:o.slice(a,a+i),total:s}}async function n(t){let n=e.find(e=>e.id===t.projectId);if(!n)throw Error(`NOT_FOUND`);return n}async function r(t,n){if(t.slug&&e.some(e=>e.slug===t.slug))throw Error(`SLUG_EXISTS`);let r=new Date;return{id:`proj-${Date.now()}`,name:t.name,description:t.description,slug:t.slug??t.name.toLowerCase().replace(/\s+/g,`-`),organizationId:n.organizationId,createdBy:n.userId,status:`DRAFT`,isPublic:t.isPublic??!1,tags:t.tags??[],createdAt:r,updatedAt:r}}async function i(t){let n=e.find(e=>e.id===t.projectId);if(!n)throw Error(`NOT_FOUND`);return{...n,name:t.name??n.name,description:t.description??n.description,slug:t.slug??n.slug,isPublic:t.isPublic??n.isPublic,tags:t.tags??n.tags,status:t.status??n.status,updatedAt:new Date}}async function a(t){if(!e.find(e=>e.id===t.projectId))throw Error(`NOT_FOUND`);return{success:!0}}export{r as mockCreateProjectHandler,a as mockDeleteProjectHandler,n as mockGetProjectHandler,t as mockListProjectsHandler,i as mockUpdateProjectHandler};

package/dist/project/project.presentation.js

@@ -0,0 +1 @@
+import{ProjectModel as e}from"./project.schema.js";const t={meta:{name:`saas.project.list`,version:1,description:`List view of projects with status, tags, and last updated info`,domain:`saas-boilerplate`,owners:[`saas-team`],tags:[`project`,`list`,`dashboard`]},source:{type:`component`,framework:`react`,componentKey:`ProjectListView`,props:e},targets:[`react`,`markdown`,`application/json`],policy:{flags:[`saas.projects.enabled`]}},n={meta:{name:`saas.project.detail`,version:1,description:`Detailed view of a project with settings and activity`,domain:`saas-boilerplate`,owners:[`saas-team`],tags:[`project`,`detail`]},source:{type:`component`,framework:`react`,componentKey:`ProjectDetailView`},targets:[`react`,`markdown`],policy:{flags:[`saas.projects.enabled`]}};export{n as ProjectDetailPresentation,t as ProjectListPresentation};

package/dist/project/project.schema.js

@@ -0,0 +1 @@
+import{ProjectStatusFilterEnum as e,ProjectStatusSchemaEnum as t}from"./project.enum.js";import{ScalarTypeEnum as n,defineSchemaModel as r}from"@lssm/lib.schema";const i=r({name:`Project`,description:`A project within an organization`,fields:{id:{type:n.String_unsecure(),isOptional:!1},name:{type:n.String_unsecure(),isOptional:!1},description:{type:n.String_unsecure(),isOptional:!0},slug:{type:n.String_unsecure(),isOptional:!0},organizationId:{type:n.String_unsecure(),isOptional:!1},createdBy:{type:n.String_unsecure(),isOptional:!1},status:{type:t,isOptional:!1},isPublic:{type:n.Boolean(),isOptional:!1},tags:{type:n.String_unsecure(),isArray:!0,isOptional:!1},createdAt:{type:n.DateTime(),isOptional:!1},updatedAt:{type:n.DateTime(),isOptional:!1}}}),a=r({name:`CreateProjectInput`,description:`Input for creating a project`,fields:{name:{type:n.NonEmptyString(),isOptional:!1},description:{type:n.String_unsecure(),isOptional:!0},slug:{type:n.String_unsecure(),isOptional:!0},isPublic:{type:n.Boolean(),isOptional:!0},tags:{type:n.String_unsecure(),isArray:!0,isOptional:!0}}}),o=r({name:`UpdateProjectInput`,description:`Input for updating a project`,fields:{projectId:{type:n.String_unsecure(),isOptional:!1},name:{type:n.String_unsecure(),isOptional:!0},description:{type:n.String_unsecure(),isOptional:!0},slug:{type:n.String_unsecure(),isOptional:!0},isPublic:{type:n.Boolean(),isOptional:!0},tags:{type:n.String_unsecure(),isArray:!0,isOptional:!0},status:{type:t,isOptional:!0}}}),s=r({name:`GetProjectInput`,fields:{projectId:{type:n.String_unsecure(),isOptional:!1}}}),c=r({name:`DeleteProjectInput`,fields:{projectId:{type:n.String_unsecure(),isOptional:!1}}}),l=r({name:`DeleteProjectOutput`,fields:{success:{type:n.Boolean(),isOptional:!1}}}),u=r({name:`ProjectDeletedPayload`,fields:{projectId:{type:n.String_unsecure(),isOptional:!1}}}),d=r({name:`ListProjectsInput`,description:`Input for listing projects`,fields:{status:{type:e,isOptional:!0},search:{type:n.String_unsecure(),isOptional:!0},limit:{type:n.Int_unsecure(),isOptional:!0,defaultValue:20},offset:{type:n.Int_unsecure(),isOptional:!0,defaultValue:0}}}),f=r({name:`ListProjectsOutput`,description:`Output for listing projects`,fields:{projects:{type:i,isArray:!0,isOptional:!1},total:{type:n.Int_unsecure(),isOptional:!1}}});export{a as CreateProjectInputModel,c as DeleteProjectInputModel,l as DeleteProjectOutputModel,s as GetProjectInputModel,d as ListProjectsInputModel,f as ListProjectsOutputModel,u as ProjectDeletedPayloadModel,i as ProjectModel,o as UpdateProjectInputModel};

package/dist/settings/index.js

@@ -0,0 +1 @@
+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};

package/dist/settings/settings.entity.js

@@ -0,0 +1 @@
+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};

package/dist/settings/settings.enum.js

@@ -0,0 +1 @@
+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};

package/package.json

@@ -1,32 +1,40 @@
 {
   "name": "@lssm/example.saas-boilerplate",
-  "version": "0.0.0-canary-20251215234340",
+  "version": "0.0.0-canary-20251216023757",
   "description": "SaaS Boilerplate - Users, Orgs, Projects, Billing, Settings",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": "./src/index.ts",
-    "./contracts": "./src/contracts/index.ts",
-    "./contracts/billing": "./src/contracts/billing.ts",
-    "./contracts/project": "./src/contracts/project.ts",
+    "./billing": "./src/billing/index.ts",
+    "./billing/billing.contracts": "./src/billing/billing.contracts.ts",
+    "./billing/billing.entity": "./src/billing/billing.entity.ts",
+    "./billing/billing.enum": "./src/billing/billing.enum.ts",
+    "./billing/billing.event": "./src/billing/billing.event.ts",
+    "./billing/billing.handler": "./src/billing/billing.handler.ts",
+    "./billing/billing.presentation": "./src/billing/billing.presentation.ts",
+    "./billing/billing.schema": "./src/billing/billing.schema.ts",
+    "./dashboard": "./src/dashboard/index.ts",
+    "./dashboard/dashboard.presentation": "./src/dashboard/dashboard.presentation.ts",
     "./docs": "./src/docs/index.ts",
     "./docs/saas-boilerplate.docblock": "./src/docs/saas-boilerplate.docblock.ts",
-    "./entities": "./src/entities/index.ts",
-    "./entities/billing": "./src/entities/billing.ts",
-    "./entities/project": "./src/entities/project.ts",
-    "./entities/settings": "./src/entities/settings.ts",
-    "./events": "./src/events.ts",
     "./example": "./src/example.ts",
     "./feature": "./src/feature.ts",
     "./handlers": "./src/handlers/index.ts",
-    "./handlers/billing.handlers": "./src/handlers/billing.handlers.ts",
-    "./handlers/mock-data": "./src/handlers/mock-data.ts",
-    "./handlers/project.handlers": "./src/handlers/project.handlers.ts",
     "./presentations": "./src/presentations/index.ts",
-    "./presentations/billing": "./src/presentations/billing.ts",
-    "./presentations/dashboard": "./src/presentations/dashboard.ts",
-    "./presentations/project-list": "./src/presentations/project-list.ts",
+    "./project": "./src/project/index.ts",
+    "./project/project.contracts": "./src/project/project.contracts.ts",
+    "./project/project.entity": "./src/project/project.entity.ts",
+    "./project/project.enum": "./src/project/project.enum.ts",
+    "./project/project.event": "./src/project/project.event.ts",
+    "./project/project.handler": "./src/project/project.handler.ts",
+    "./project/project.presentation": "./src/project/project.presentation.ts",
+    "./project/project.schema": "./src/project/project.schema.ts",
+    "./settings": "./src/settings/index.ts",
+    "./settings/settings.entity": "./src/settings/settings.entity.ts",
+    "./settings/settings.enum": "./src/settings/settings.enum.ts",
+    "./shared/mock-data": "./src/shared/mock-data.ts",
     "./*": "./*"
   },
   "scripts": {
@@ -60,26 +68,34 @@
   "publishConfig": {
     "exports": {
       ".": "./dist/index.js",
-      "./contracts": "./dist/contracts/index.js",
-      "./contracts/billing": "./dist/contracts/billing.js",
-      "./contracts/project": "./dist/contracts/project.js",
+      "./billing": "./dist/billing/index.js",
+      "./billing/billing.contracts": "./dist/billing/billing.contracts.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",
-      "./entities": "./dist/entities/index.js",
-      "./entities/billing": "./dist/entities/billing.js",
-      "./entities/project": "./dist/entities/project.js",
-      "./entities/settings": "./dist/entities/settings.js",
-      "./events": "./dist/events.js",
       "./example": "./dist/example.js",
       "./feature": "./dist/feature.js",
       "./handlers": "./dist/handlers/index.js",
-      "./handlers/billing.handlers": "./dist/handlers/billing.handlers.js",
-      "./handlers/mock-data": "./dist/handlers/mock-data.js",
-      "./handlers/project.handlers": "./dist/handlers/project.handlers.js",
       "./presentations": "./dist/presentations/index.js",
-      "./presentations/billing": "./dist/presentations/billing.js",
-      "./presentations/dashboard": "./dist/presentations/dashboard.js",
-      "./presentations/project-list": "./dist/presentations/project-list.js",
+      "./project": "./dist/project/index.js",
+      "./project/project.contracts": "./dist/project/project.contracts.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",
+      "./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",
       "./*": "./*"
     }
   }

package/src/billing/billing.contracts.ts

@@ -0,0 +1,116 @@
+import { defineCommand, defineQuery } from '@lssm/lib.contracts';
+import {
+  SubscriptionModel,
+  RecordUsageInputModel,
+  RecordUsageOutputModel,
+  UsageRecordedPayloadModel,
+  GetUsageSummaryInputModel,
+  GetUsageSummaryOutputModel,
+  CheckFeatureAccessInputModel,
+  CheckFeatureAccessOutputModel,
+} from './billing.schema';
+
+const OWNERS = ['example.saas-boilerplate'] as const;
+
+/**
+ * Get subscription status.
+ */
+export const GetSubscriptionContract = defineQuery({
+  meta: {
+    name: 'saas.billing.subscription.get',
+    version: 1,
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['saas', 'billing', 'subscription'],
+    description: 'Get organization subscription status.',
+    goal: 'Show current plan and billing status.',
+    context: 'Billing page, plan upgrade prompts.',
+  },
+  io: {
+    input: null,
+    output: SubscriptionModel,
+  },
+  policy: {
+    auth: 'user',
+  },
+});
+
+/**
+ * Record feature usage.
+ */
+export const RecordUsageContract = defineCommand({
+  meta: {
+    name: 'saas.billing.usage.record',
+    version: 1,
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['saas', 'billing', 'usage'],
+    description: 'Record usage of a metered feature.',
+    goal: 'Track feature usage for billing.',
+    context: 'Called by services when metered features are used.',
+  },
+  io: {
+    input: RecordUsageInputModel,
+    output: RecordUsageOutputModel,
+  },
+  policy: {
+    auth: 'user',
+  },
+  sideEffects: {
+    emits: [
+      {
+        name: 'billing.usage.recorded',
+        version: 1,
+        when: 'Usage is recorded',
+        payload: UsageRecordedPayloadModel,
+      },
+    ],
+  },
+});
+
+/**
+ * Get usage summary.
+ */
+export const GetUsageSummaryContract = defineQuery({
+  meta: {
+    name: 'saas.billing.usage.summary',
+    version: 1,
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['saas', 'billing', 'usage'],
+    description: 'Get usage summary for the current billing period.',
+    goal: 'Show usage vs limits.',
+    context: 'Billing page, usage dashboards.',
+  },
+  io: {
+    input: GetUsageSummaryInputModel,
+    output: GetUsageSummaryOutputModel,
+  },
+  policy: {
+    auth: 'user',
+  },
+});
+
+/**
+ * Check feature access.
+ */
+export const CheckFeatureAccessContract = defineQuery({
+  meta: {
+    name: 'saas.billing.feature.check',
+    version: 1,
+    stability: 'stable',
+    owners: [...OWNERS],
+    tags: ['saas', 'billing', 'feature'],
+    description: 'Check if organization has access to a feature.',
+    goal: 'Gate features based on plan/usage.',
+    context: 'Feature access checks, upgrade prompts.',
+  },
+  io: {
+    input: CheckFeatureAccessInputModel,
+    output: CheckFeatureAccessOutputModel,
+  },
+  policy: {
+    auth: 'user',
+  },
+});
+

package/src/{entities/billing.ts → billing/billing.entity.ts}

@@ -1,7 +1,7 @@
 import { defineEntity, defineEntityEnum, field, index } from '@lssm/lib.schema';
 
 /**
- * Subscription status enum.
+ * Subscription status enum for entities.
  */
 export const SubscriptionStatusEnum = defineEntityEnum({
   name: 'SubscriptionStatus',
@@ -151,3 +151,4 @@ export const UsageLimitEntity = defineEntity({
   },
   indexes: [index.unique(['planId', 'feature'])],
 });
+

package/src/billing/billing.enum.ts

@@ -0,0 +1,24 @@
+import { defineEnum } from '@lssm/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',
+]);
+

package/src/billing/billing.event.ts

@@ -0,0 +1,94 @@
+import { ScalarTypeEnum, defineSchemaModel } from '@lssm/lib.schema';
+import { defineEvent } from '@lssm/lib.contracts';
+
+/**
+ * Payload when feature usage is recorded.
+ */
+const UsageRecordedPayload = defineSchemaModel({
+  name: 'UsageRecordedPayload',
+  description: 'Payload when feature usage is recorded',
+  fields: {
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    quantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    billingPeriod: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    recordedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * Payload when usage limit is reached.
+ */
+const UsageLimitReachedPayload = defineSchemaModel({
+  name: 'UsageLimitReachedPayload',
+  description: 'Payload when usage limit is reached',
+  fields: {
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    currentUsage: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    reachedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * Payload when subscription status changes.
+ */
+const SubscriptionChangedPayload = defineSchemaModel({
+  name: 'SubscriptionChangedPayload',
+  description: 'Payload when subscription status changes',
+  fields: {
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    previousPlan: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    newPlan: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    previousStatus: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: true,
+    },
+    newStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    changedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+  },
+});
+
+/**
+ * Event: Feature usage has been recorded.
+ */
+export const UsageRecordedEvent = defineEvent({
+  name: 'billing.usage.recorded',
+  version: 1,
+  description: 'Feature usage has been recorded.',
+  payload: UsageRecordedPayload,
+});
+
+/**
+ * Event: Usage limit has been reached for a feature.
+ */
+export const UsageLimitReachedEvent = defineEvent({
+  name: 'billing.limit.reached',
+  version: 1,
+  description: 'Usage limit has been reached for a feature.',
+  payload: UsageLimitReachedPayload,
+});
+
+/**
+ * Event: Subscription status has changed.
+ */
+export const SubscriptionChangedEvent = defineEvent({
+  name: 'billing.subscription.changed',
+  version: 1,
+  description: 'Subscription status has changed.',
+  payload: SubscriptionChangedPayload,
+});
+