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

package/.turbo/turbo-build.log

@@ -1,69 +1,42 @@
-$ 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/example.ts, src/index.ts, src/saas-boilerplate.feature.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/index.js                                5.04 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/saas-boilerplate.feature.js             2.00 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
-ℹ dist/project/project.contracts.d.ts         10.87 kB │ gzip: 0.84 kB
-ℹ dist/project/project.schema.d.ts             6.08 kB │ gzip: 0.73 kB
-ℹ dist/billing/billing.schema.d.ts             5.29 kB │ gzip: 0.76 kB
-ℹ dist/index.d.ts                              4.98 kB │ gzip: 1.03 kB
-ℹ dist/billing/billing.contracts.d.ts          4.45 kB │ gzip: 0.74 kB
-ℹ dist/billing/billing.entity.d.ts             2.57 kB │ gzip: 0.49 kB
-ℹ dist/project/project.event.d.ts              2.50 kB │ gzip: 0.40 kB
-ℹ dist/billing/billing.event.d.ts              2.33 kB │ gzip: 0.46 kB
-ℹ dist/billing/billing.handler.d.ts            2.07 kB │ gzip: 0.69 kB
-ℹ dist/billing/index.d.ts                      1.90 kB │ gzip: 0.42 kB
-ℹ dist/project/project.handler.d.ts            1.89 kB │ gzip: 0.51 kB
-ℹ dist/project/index.d.ts                      1.87 kB │ gzip: 0.40 kB
-ℹ dist/shared/mock-data.d.ts                   1.64 kB │ gzip: 0.48 kB
-ℹ dist/project/project.entity.d.ts             1.54 kB │ gzip: 0.39 kB
-ℹ dist/settings/settings.entity.d.ts           1.46 kB │ gzip: 0.34 kB
-ℹ dist/example.d.ts                            1.13 kB │ gzip: 0.46 kB
-ℹ dist/presentations/index.d.ts                0.86 kB │ gzip: 0.26 kB
-ℹ dist/handlers/index.d.ts                     0.58 kB │ gzip: 0.20 kB
-ℹ dist/project/project.enum.d.ts               0.56 kB │ gzip: 0.27 kB
-ℹ dist/billing/billing.enum.d.ts               0.55 kB │ gzip: 0.27 kB
-ℹ dist/dashboard/dashboard.presentation.d.ts   0.43 kB │ gzip: 0.21 kB
-ℹ dist/project/project.presentation.d.ts       0.43 kB │ gzip: 0.21 kB
-ℹ dist/billing/billing.presentation.d.ts       0.42 kB │ gzip: 0.20 kB
-ℹ dist/saas-boilerplate.feature.d.ts           0.35 kB │ gzip: 0.23 kB
-ℹ dist/settings/settings.enum.d.ts             0.24 kB │ gzip: 0.17 kB
-ℹ dist/settings/index.d.ts                     0.19 kB │ gzip: 0.11 kB
-ℹ dist/dashboard/index.d.ts                    0.16 kB │ gzip: 0.10 kB
-ℹ dist/docs/index.d.ts                         0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/saas-boilerplate.docblock.d.ts     0.01 kB │ gzip: 0.03 kB
-ℹ 58 files, total: 100.45 kB
-✔ Build complete in 51890ms
-$ tsc --noEmit
+
+$ bun build:bundle && bun build:types
+$ tsdown
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
+ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/examples/saas-boilerplate/tsdown.config.js (unrun)
+ℹ entry: src/example.ts, src/index.ts, src/saas-boilerplate.feature.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/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/presentations/index.ts, src/shared/mock-data.ts, src/handlers/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 37 files
+ℹ dist/index.js                             5.04 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/saas-boilerplate.feature.js          2.00 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: 43.06 kB
+✔ Build complete in 205ms
+$ tsc --noEmit

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @lssm/example.saas-boilerplate
 
-## 0.0.0-canary-20251217060834
+## 0.0.0-canary-20251217073102
 
 ### Minor Changes
 
@@ -9,10 +9,10 @@
 ### Patch Changes
 
 - Updated dependencies [66a5dfd]
-  - @lssm/lib.bus@0.0.0-canary-20251217060834
-  - @lssm/lib.contracts@0.0.0-canary-20251217060834
-  - @lssm/lib.identity-rbac@0.0.0-canary-20251217060834
-  - @lssm/lib.jobs@0.0.0-canary-20251217060834
-  - @lssm/lib.schema@0.0.0-canary-20251217060834
-  - @lssm/module.audit-trail@0.0.0-canary-20251217060834
-  - @lssm/module.notifications@0.0.0-canary-20251217060834
+  - @lssm/lib.bus@0.0.0-canary-20251217073102
+  - @lssm/lib.contracts@0.0.0-canary-20251217073102
+  - @lssm/lib.identity-rbac@0.0.0-canary-20251217073102
+  - @lssm/lib.jobs@0.0.0-canary-20251217073102
+  - @lssm/lib.schema@0.0.0-canary-20251217073102
+  - @lssm/module.audit-trail@0.0.0-canary-20251217073102
+  - @lssm/module.notifications@0.0.0-canary-20251217073102

package/dist/billing/billing.contracts.d.ts

@@ -1,100 +1,100 @@
-import * as _lssm_lib_schema0 from "@lssm/lib.schema";
-import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
+import * as _lssm_lib_schema159 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts6 from "@lssm/lib.contracts";
 
 //#region src/billing/billing.contracts.d.ts
 /**
  * Get subscription status.
  */
-declare const GetSubscriptionContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.AnySchemaModel, _lssm_lib_schema0.SchemaModel<{
+declare const GetSubscriptionContract: _lssm_lib_contracts6.ContractSpec<_lssm_lib_schema159.AnySchemaModel, _lssm_lib_schema159.SchemaModel<{
   id: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: false;
   };
   organizationId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: false;
   };
   planId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: false;
   };
   planName: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _lssm_lib_schema0.EnumType<[string, string, string, string, string]>;
+    type: _lssm_lib_schema159.EnumType<[string, string, string, string, string]>;
     isOptional: false;
   };
   currentPeriodStart: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema159.FieldType<Date, string>;
     isOptional: false;
   };
   currentPeriodEnd: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema159.FieldType<Date, string>;
     isOptional: false;
   };
   trialEndsAt: {
-    type: _lssm_lib_schema0.FieldType<Date, string>;
+    type: _lssm_lib_schema159.FieldType<Date, string>;
     isOptional: true;
   };
   cancelAtPeriodEnd: {
-    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema159.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>, undefined>;
 /**
  * Record feature usage.
  */
-declare const RecordUsageContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+declare const RecordUsageContract: _lssm_lib_contracts6.ContractSpec<_lssm_lib_schema159.SchemaModel<{
   feature: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: false;
   };
   quantity: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema159.FieldType<number, number>;
     isOptional: false;
   };
   sourceId: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: true;
   };
   sourceType: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: true;
   };
   metadata: {
-    type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _lssm_lib_schema159.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: true;
   };
-}>, _lssm_lib_schema0.SchemaModel<{
+}>, _lssm_lib_schema159.SchemaModel<{
   recorded: {
-    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema159.FieldType<boolean, boolean>;
     isOptional: false;
   };
   currentUsage: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema159.FieldType<number, number>;
     isOptional: false;
   };
   limit: {
-    type: _lssm_lib_schema0.FieldType<number, number>;
+    type: _lssm_lib_schema159.FieldType<number, number>;
     isOptional: true;
   };
   limitReached: {
-    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema159.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>, {
   name: string;
   version: number;
   when: string;
-  payload: _lssm_lib_schema0.SchemaModel<{
+  payload: _lssm_lib_schema159.SchemaModel<{
     feature: {
-      type: _lssm_lib_schema0.FieldType<string, string>;
+      type: _lssm_lib_schema159.FieldType<string, string>;
       isOptional: false;
     };
     quantity: {
-      type: _lssm_lib_schema0.FieldType<number, number>;
+      type: _lssm_lib_schema159.FieldType<number, number>;
       isOptional: false;
     };
   }>;
@@ -102,36 +102,36 @@ declare const RecordUsageContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_s
 /**
  * Get usage summary.
  */
-declare const GetUsageSummaryContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+declare const GetUsageSummaryContract: _lssm_lib_contracts6.ContractSpec<_lssm_lib_schema159.SchemaModel<{
   billingPeriod: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: true;
   };
-}>, _lssm_lib_schema0.SchemaModel<{
+}>, _lssm_lib_schema159.SchemaModel<{
   billingPeriod: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: false;
   };
   usage: {
-    type: _lssm_lib_schema0.SchemaModel<{
+    type: _lssm_lib_schema159.SchemaModel<{
       feature: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema159.FieldType<string, string>;
         isOptional: false;
       };
       used: {
-        type: _lssm_lib_schema0.FieldType<number, number>;
+        type: _lssm_lib_schema159.FieldType<number, number>;
         isOptional: false;
       };
       limit: {
-        type: _lssm_lib_schema0.FieldType<number, number>;
+        type: _lssm_lib_schema159.FieldType<number, number>;
         isOptional: true;
       };
       unit: {
-        type: _lssm_lib_schema0.FieldType<string, string>;
+        type: _lssm_lib_schema159.FieldType<string, string>;
         isOptional: true;
       };
       percentage: {
-        type: _lssm_lib_schema0.FieldType<number, number>;
+        type: _lssm_lib_schema159.FieldType<number, number>;
         isOptional: true;
       };
     }>;
@@ -142,22 +142,22 @@ declare const GetUsageSummaryContract: _lssm_lib_contracts0.ContractSpec<_lssm_l
 /**
  * Check feature access.
  */
-declare const CheckFeatureAccessContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
+declare const CheckFeatureAccessContract: _lssm_lib_contracts6.ContractSpec<_lssm_lib_schema159.SchemaModel<{
   feature: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: false;
   };
-}>, _lssm_lib_schema0.SchemaModel<{
+}>, _lssm_lib_schema159.SchemaModel<{
   hasAccess: {
-    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema159.FieldType<boolean, boolean>;
     isOptional: false;
   };
   reason: {
-    type: _lssm_lib_schema0.EnumType<[string, string, string, string]>;
+    type: _lssm_lib_schema159.EnumType<[string, string, string, string]>;
     isOptional: true;
   };
   upgradeUrl: {
-    type: _lssm_lib_schema0.FieldType<string, string>;
+    type: _lssm_lib_schema159.FieldType<string, string>;
     isOptional: true;
   };
 }>, undefined>;

package/dist/billing/billing.contracts.js

@@ -1 +1,111 @@
-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};
+import { CheckFeatureAccessInputModel, CheckFeatureAccessOutputModel, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, RecordUsageInputModel, RecordUsageOutputModel, SubscriptionModel, UsageRecordedPayloadModel } from "./billing.schema.js";
+import { defineCommand, defineQuery } from "../libs/contracts/dist/spec.js";
+import "../libs/contracts/dist/index.js";
+
+//#region src/billing/billing.contracts.ts
+const OWNERS = ["@example.saas-boilerplate"];
+/**
+* Get subscription status.
+*/
+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.
+*/
+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.
+*/
+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.
+*/
+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" }
+});
+
+//#endregion
+export { CheckFeatureAccessContract, GetSubscriptionContract, GetUsageSummaryContract, RecordUsageContract };

package/dist/billing/billing.entity.d.ts

@@ -1,60 +1,60 @@
-import * as _lssm_lib_schema141 from "@lssm/lib.schema";
+import * as _lssm_lib_schema41 from "@lssm/lib.schema";
 
 //#region src/billing/billing.entity.d.ts
 /**
  * Subscription status enum for entities.
  */
-declare const SubscriptionStatusEnum: _lssm_lib_schema141.EntityEnumDef;
+declare const SubscriptionStatusEnum: _lssm_lib_schema41.EntityEnumDef;
 /**
  * Subscription entity - organization subscription info.
  */
-declare const SubscriptionEntity: _lssm_lib_schema141.EntitySpec<{
-  id: _lssm_lib_schema141.EntityScalarField;
-  organizationId: _lssm_lib_schema141.EntityScalarField;
-  planId: _lssm_lib_schema141.EntityScalarField;
-  planName: _lssm_lib_schema141.EntityScalarField;
-  status: _lssm_lib_schema141.EntityEnumField;
-  currentPeriodStart: _lssm_lib_schema141.EntityScalarField;
-  currentPeriodEnd: _lssm_lib_schema141.EntityScalarField;
-  trialEndsAt: _lssm_lib_schema141.EntityScalarField;
-  cancelAtPeriodEnd: _lssm_lib_schema141.EntityScalarField;
-  canceledAt: _lssm_lib_schema141.EntityScalarField;
-  stripeSubscriptionId: _lssm_lib_schema141.EntityScalarField;
-  stripeCustomerId: _lssm_lib_schema141.EntityScalarField;
-  metadata: _lssm_lib_schema141.EntityScalarField;
-  createdAt: _lssm_lib_schema141.EntityScalarField;
-  updatedAt: _lssm_lib_schema141.EntityScalarField;
+declare const SubscriptionEntity: _lssm_lib_schema41.EntitySpec<{
+  id: _lssm_lib_schema41.EntityScalarField;
+  organizationId: _lssm_lib_schema41.EntityScalarField;
+  planId: _lssm_lib_schema41.EntityScalarField;
+  planName: _lssm_lib_schema41.EntityScalarField;
+  status: _lssm_lib_schema41.EntityEnumField;
+  currentPeriodStart: _lssm_lib_schema41.EntityScalarField;
+  currentPeriodEnd: _lssm_lib_schema41.EntityScalarField;
+  trialEndsAt: _lssm_lib_schema41.EntityScalarField;
+  cancelAtPeriodEnd: _lssm_lib_schema41.EntityScalarField;
+  canceledAt: _lssm_lib_schema41.EntityScalarField;
+  stripeSubscriptionId: _lssm_lib_schema41.EntityScalarField;
+  stripeCustomerId: _lssm_lib_schema41.EntityScalarField;
+  metadata: _lssm_lib_schema41.EntityScalarField;
+  createdAt: _lssm_lib_schema41.EntityScalarField;
+  updatedAt: _lssm_lib_schema41.EntityScalarField;
 }>;
 /**
  * BillingUsage entity - track feature usage.
  */
-declare const BillingUsageEntity: _lssm_lib_schema141.EntitySpec<{
-  id: _lssm_lib_schema141.EntityScalarField;
-  organizationId: _lssm_lib_schema141.EntityScalarField;
-  feature: _lssm_lib_schema141.EntityScalarField;
-  quantity: _lssm_lib_schema141.EntityScalarField;
-  unit: _lssm_lib_schema141.EntityScalarField;
-  billingPeriod: _lssm_lib_schema141.EntityScalarField;
-  recordedAt: _lssm_lib_schema141.EntityScalarField;
-  sourceId: _lssm_lib_schema141.EntityScalarField;
-  sourceType: _lssm_lib_schema141.EntityScalarField;
-  metadata: _lssm_lib_schema141.EntityScalarField;
+declare const BillingUsageEntity: _lssm_lib_schema41.EntitySpec<{
+  id: _lssm_lib_schema41.EntityScalarField;
+  organizationId: _lssm_lib_schema41.EntityScalarField;
+  feature: _lssm_lib_schema41.EntityScalarField;
+  quantity: _lssm_lib_schema41.EntityScalarField;
+  unit: _lssm_lib_schema41.EntityScalarField;
+  billingPeriod: _lssm_lib_schema41.EntityScalarField;
+  recordedAt: _lssm_lib_schema41.EntityScalarField;
+  sourceId: _lssm_lib_schema41.EntityScalarField;
+  sourceType: _lssm_lib_schema41.EntityScalarField;
+  metadata: _lssm_lib_schema41.EntityScalarField;
 }>;
 /**
  * UsageLimit entity - feature usage limits per plan.
  */
-declare const UsageLimitEntity: _lssm_lib_schema141.EntitySpec<{
-  id: _lssm_lib_schema141.EntityScalarField;
-  planId: _lssm_lib_schema141.EntityScalarField;
-  organizationId: _lssm_lib_schema141.EntityScalarField;
-  feature: _lssm_lib_schema141.EntityScalarField;
-  limit: _lssm_lib_schema141.EntityScalarField;
-  resetPeriod: _lssm_lib_schema141.EntityScalarField;
-  isSoftLimit: _lssm_lib_schema141.EntityScalarField;
-  overage: _lssm_lib_schema141.EntityScalarField;
-  overageRate: _lssm_lib_schema141.EntityScalarField;
-  createdAt: _lssm_lib_schema141.EntityScalarField;
-  updatedAt: _lssm_lib_schema141.EntityScalarField;
+declare const UsageLimitEntity: _lssm_lib_schema41.EntitySpec<{
+  id: _lssm_lib_schema41.EntityScalarField;
+  planId: _lssm_lib_schema41.EntityScalarField;
+  organizationId: _lssm_lib_schema41.EntityScalarField;
+  feature: _lssm_lib_schema41.EntityScalarField;
+  limit: _lssm_lib_schema41.EntityScalarField;
+  resetPeriod: _lssm_lib_schema41.EntityScalarField;
+  isSoftLimit: _lssm_lib_schema41.EntityScalarField;
+  overage: _lssm_lib_schema41.EntityScalarField;
+  overageRate: _lssm_lib_schema41.EntityScalarField;
+  createdAt: _lssm_lib_schema41.EntityScalarField;
+  updatedAt: _lssm_lib_schema41.EntityScalarField;
 }>;
 //#endregion
 export { BillingUsageEntity, SubscriptionEntity, SubscriptionStatusEnum, UsageLimitEntity };