@lssm/example.saas-boilerplate 0.0.0-canary-20251217062139 → 0.0.0-canary-20251217072406

package/CHANGELOG.md

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

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

@@ -1,100 +1,100 @@
-import * as _lssm_lib_schema41 from "@lssm/lib.schema";
-import * as _lssm_lib_contracts2 from "@lssm/lib.contracts";
+import * as _lssm_lib_schema0 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
 
 //#region src/billing/billing.contracts.d.ts
 /**
  * Get subscription status.
  */
-declare const GetSubscriptionContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema41.AnySchemaModel, _lssm_lib_schema41.SchemaModel<{
+declare const GetSubscriptionContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.AnySchemaModel, _lssm_lib_schema0.SchemaModel<{
   id: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   organizationId: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   planId: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   planName: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   status: {
-    type: _lssm_lib_schema41.EnumType<[string, string, string, string, string]>;
+    type: _lssm_lib_schema0.EnumType<[string, string, string, string, string]>;
     isOptional: false;
   };
   currentPeriodStart: {
-    type: _lssm_lib_schema41.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: false;
   };
   currentPeriodEnd: {
-    type: _lssm_lib_schema41.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: false;
   };
   trialEndsAt: {
-    type: _lssm_lib_schema41.FieldType<Date, string>;
+    type: _lssm_lib_schema0.FieldType<Date, string>;
     isOptional: true;
   };
   cancelAtPeriodEnd: {
-    type: _lssm_lib_schema41.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>, undefined>;
 /**
  * Record feature usage.
  */
-declare const RecordUsageContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema41.SchemaModel<{
+declare const RecordUsageContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
   feature: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   quantity: {
-    type: _lssm_lib_schema41.FieldType<number, number>;
+    type: _lssm_lib_schema0.FieldType<number, number>;
     isOptional: false;
   };
   sourceId: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   sourceType: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
   metadata: {
-    type: _lssm_lib_schema41.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    type: _lssm_lib_schema0.FieldType<Record<string, unknown>, Record<string, unknown>>;
     isOptional: true;
   };
-}>, _lssm_lib_schema41.SchemaModel<{
+}>, _lssm_lib_schema0.SchemaModel<{
   recorded: {
-    type: _lssm_lib_schema41.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
     isOptional: false;
   };
   currentUsage: {
-    type: _lssm_lib_schema41.FieldType<number, number>;
+    type: _lssm_lib_schema0.FieldType<number, number>;
     isOptional: false;
   };
   limit: {
-    type: _lssm_lib_schema41.FieldType<number, number>;
+    type: _lssm_lib_schema0.FieldType<number, number>;
     isOptional: true;
   };
   limitReached: {
-    type: _lssm_lib_schema41.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
     isOptional: false;
   };
 }>, {
   name: string;
   version: number;
   when: string;
-  payload: _lssm_lib_schema41.SchemaModel<{
+  payload: _lssm_lib_schema0.SchemaModel<{
     feature: {
-      type: _lssm_lib_schema41.FieldType<string, string>;
+      type: _lssm_lib_schema0.FieldType<string, string>;
       isOptional: false;
     };
     quantity: {
-      type: _lssm_lib_schema41.FieldType<number, number>;
+      type: _lssm_lib_schema0.FieldType<number, number>;
       isOptional: false;
     };
   }>;
@@ -102,36 +102,36 @@ declare const RecordUsageContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_s
 /**
  * Get usage summary.
  */
-declare const GetUsageSummaryContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema41.SchemaModel<{
+declare const GetUsageSummaryContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
   billingPeriod: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: true;
   };
-}>, _lssm_lib_schema41.SchemaModel<{
+}>, _lssm_lib_schema0.SchemaModel<{
   billingPeriod: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
   usage: {
-    type: _lssm_lib_schema41.SchemaModel<{
+    type: _lssm_lib_schema0.SchemaModel<{
       feature: {
-        type: _lssm_lib_schema41.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: false;
       };
       used: {
-        type: _lssm_lib_schema41.FieldType<number, number>;
+        type: _lssm_lib_schema0.FieldType<number, number>;
         isOptional: false;
       };
       limit: {
-        type: _lssm_lib_schema41.FieldType<number, number>;
+        type: _lssm_lib_schema0.FieldType<number, number>;
         isOptional: true;
       };
       unit: {
-        type: _lssm_lib_schema41.FieldType<string, string>;
+        type: _lssm_lib_schema0.FieldType<string, string>;
         isOptional: true;
       };
       percentage: {
-        type: _lssm_lib_schema41.FieldType<number, number>;
+        type: _lssm_lib_schema0.FieldType<number, number>;
         isOptional: true;
       };
     }>;
@@ -142,22 +142,22 @@ declare const GetUsageSummaryContract: _lssm_lib_contracts2.ContractSpec<_lssm_l
 /**
  * Check feature access.
  */
-declare const CheckFeatureAccessContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema41.SchemaModel<{
+declare const CheckFeatureAccessContract: _lssm_lib_contracts0.ContractSpec<_lssm_lib_schema0.SchemaModel<{
   feature: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.FieldType<string, string>;
     isOptional: false;
   };
-}>, _lssm_lib_schema41.SchemaModel<{
+}>, _lssm_lib_schema0.SchemaModel<{
   hasAccess: {
-    type: _lssm_lib_schema41.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema0.FieldType<boolean, boolean>;
     isOptional: false;
   };
   reason: {
-    type: _lssm_lib_schema41.EnumType<[string, string, string, string]>;
+    type: _lssm_lib_schema0.EnumType<[string, string, string, string]>;
     isOptional: true;
   };
   upgradeUrl: {
-    type: _lssm_lib_schema41.FieldType<string, string>;
+    type: _lssm_lib_schema0.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{n as c,t as l}from"../libs/contracts/dist/spec.js";import"../libs/contracts/dist/index.js";const u=[`@example.saas-boilerplate`],d=c({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=l({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=c({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=c({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_schema302 from "@lssm/lib.schema";
+import * as _lssm_lib_schema40 from "@lssm/lib.schema";
 
 //#region src/billing/billing.entity.d.ts
 /**
  * Subscription status enum for entities.
  */
-declare const SubscriptionStatusEnum: _lssm_lib_schema302.EntityEnumDef;
+declare const SubscriptionStatusEnum: _lssm_lib_schema40.EntityEnumDef;
 /**
  * Subscription entity - organization subscription info.
  */
-declare const SubscriptionEntity: _lssm_lib_schema302.EntitySpec<{
-  id: _lssm_lib_schema302.EntityScalarField;
-  organizationId: _lssm_lib_schema302.EntityScalarField;
-  planId: _lssm_lib_schema302.EntityScalarField;
-  planName: _lssm_lib_schema302.EntityScalarField;
-  status: _lssm_lib_schema302.EntityEnumField;
-  currentPeriodStart: _lssm_lib_schema302.EntityScalarField;
-  currentPeriodEnd: _lssm_lib_schema302.EntityScalarField;
-  trialEndsAt: _lssm_lib_schema302.EntityScalarField;
-  cancelAtPeriodEnd: _lssm_lib_schema302.EntityScalarField;
-  canceledAt: _lssm_lib_schema302.EntityScalarField;
-  stripeSubscriptionId: _lssm_lib_schema302.EntityScalarField;
-  stripeCustomerId: _lssm_lib_schema302.EntityScalarField;
-  metadata: _lssm_lib_schema302.EntityScalarField;
-  createdAt: _lssm_lib_schema302.EntityScalarField;
-  updatedAt: _lssm_lib_schema302.EntityScalarField;
+declare const SubscriptionEntity: _lssm_lib_schema40.EntitySpec<{
+  id: _lssm_lib_schema40.EntityScalarField;
+  organizationId: _lssm_lib_schema40.EntityScalarField;
+  planId: _lssm_lib_schema40.EntityScalarField;
+  planName: _lssm_lib_schema40.EntityScalarField;
+  status: _lssm_lib_schema40.EntityEnumField;
+  currentPeriodStart: _lssm_lib_schema40.EntityScalarField;
+  currentPeriodEnd: _lssm_lib_schema40.EntityScalarField;
+  trialEndsAt: _lssm_lib_schema40.EntityScalarField;
+  cancelAtPeriodEnd: _lssm_lib_schema40.EntityScalarField;
+  canceledAt: _lssm_lib_schema40.EntityScalarField;
+  stripeSubscriptionId: _lssm_lib_schema40.EntityScalarField;
+  stripeCustomerId: _lssm_lib_schema40.EntityScalarField;
+  metadata: _lssm_lib_schema40.EntityScalarField;
+  createdAt: _lssm_lib_schema40.EntityScalarField;
+  updatedAt: _lssm_lib_schema40.EntityScalarField;
 }>;
 /**
  * BillingUsage entity - track feature usage.
  */
-declare const BillingUsageEntity: _lssm_lib_schema302.EntitySpec<{
-  id: _lssm_lib_schema302.EntityScalarField;
-  organizationId: _lssm_lib_schema302.EntityScalarField;
-  feature: _lssm_lib_schema302.EntityScalarField;
-  quantity: _lssm_lib_schema302.EntityScalarField;
-  unit: _lssm_lib_schema302.EntityScalarField;
-  billingPeriod: _lssm_lib_schema302.EntityScalarField;
-  recordedAt: _lssm_lib_schema302.EntityScalarField;
-  sourceId: _lssm_lib_schema302.EntityScalarField;
-  sourceType: _lssm_lib_schema302.EntityScalarField;
-  metadata: _lssm_lib_schema302.EntityScalarField;
+declare const BillingUsageEntity: _lssm_lib_schema40.EntitySpec<{
+  id: _lssm_lib_schema40.EntityScalarField;
+  organizationId: _lssm_lib_schema40.EntityScalarField;
+  feature: _lssm_lib_schema40.EntityScalarField;
+  quantity: _lssm_lib_schema40.EntityScalarField;
+  unit: _lssm_lib_schema40.EntityScalarField;
+  billingPeriod: _lssm_lib_schema40.EntityScalarField;
+  recordedAt: _lssm_lib_schema40.EntityScalarField;
+  sourceId: _lssm_lib_schema40.EntityScalarField;
+  sourceType: _lssm_lib_schema40.EntityScalarField;
+  metadata: _lssm_lib_schema40.EntityScalarField;
 }>;
 /**
  * UsageLimit entity - feature usage limits per plan.
  */
-declare const UsageLimitEntity: _lssm_lib_schema302.EntitySpec<{
-  id: _lssm_lib_schema302.EntityScalarField;
-  planId: _lssm_lib_schema302.EntityScalarField;
-  organizationId: _lssm_lib_schema302.EntityScalarField;
-  feature: _lssm_lib_schema302.EntityScalarField;
-  limit: _lssm_lib_schema302.EntityScalarField;
-  resetPeriod: _lssm_lib_schema302.EntityScalarField;
-  isSoftLimit: _lssm_lib_schema302.EntityScalarField;
-  overage: _lssm_lib_schema302.EntityScalarField;
-  overageRate: _lssm_lib_schema302.EntityScalarField;
-  createdAt: _lssm_lib_schema302.EntityScalarField;
-  updatedAt: _lssm_lib_schema302.EntityScalarField;
+declare const UsageLimitEntity: _lssm_lib_schema40.EntitySpec<{
+  id: _lssm_lib_schema40.EntityScalarField;
+  planId: _lssm_lib_schema40.EntityScalarField;
+  organizationId: _lssm_lib_schema40.EntityScalarField;
+  feature: _lssm_lib_schema40.EntityScalarField;
+  limit: _lssm_lib_schema40.EntityScalarField;
+  resetPeriod: _lssm_lib_schema40.EntityScalarField;
+  isSoftLimit: _lssm_lib_schema40.EntityScalarField;
+  overage: _lssm_lib_schema40.EntityScalarField;
+  overageRate: _lssm_lib_schema40.EntityScalarField;
+  createdAt: _lssm_lib_schema40.EntityScalarField;
+  updatedAt: _lssm_lib_schema40.EntityScalarField;
 }>;
 //#endregion
 export { BillingUsageEntity, SubscriptionEntity, SubscriptionStatusEnum, UsageLimitEntity };

package/dist/billing/billing.entity.js

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

package/dist/billing/billing.enum.d.ts

@@ -1,4 +1,4 @@
-import * as _lssm_lib_schema342 from "@lssm/lib.schema";
+import * as _lssm_lib_schema80 from "@lssm/lib.schema";
 
 //#region src/billing/billing.enum.d.ts
 
@@ -6,10 +6,10 @@ import * as _lssm_lib_schema342 from "@lssm/lib.schema";
  * Subscription status enum for contract schemas.
  * Note: Entity enum is defined separately in billing.entity.ts
  */
-declare const SubscriptionStatusSchemaEnum: _lssm_lib_schema342.EnumType<[string, string, string, string, string]>;
+declare const SubscriptionStatusSchemaEnum: _lssm_lib_schema80.EnumType<[string, string, string, string, string]>;
 /**
  * Feature access reason enum.
  */
-declare const FeatureAccessReasonEnum: _lssm_lib_schema342.EnumType<[string, string, string, string]>;
+declare const FeatureAccessReasonEnum: _lssm_lib_schema80.EnumType<[string, string, string, string]>;
 //#endregion
 export { FeatureAccessReasonEnum, SubscriptionStatusSchemaEnum };

package/dist/billing/billing.enum.js

@@ -1 +1,27 @@
-import{r as e}from"../libs/schema/dist/EnumType.js";import"../libs/schema/dist/index.js";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};
+import { defineEnum } from "../libs/schema/dist/EnumType.js";
+import "../libs/schema/dist/index.js";
+
+//#region src/billing/billing.enum.ts
+/**
+* Subscription status enum for contract schemas.
+* Note: Entity enum is defined separately in billing.entity.ts
+*/
+const SubscriptionStatusSchemaEnum = defineEnum("SubscriptionStatus", [
+	"TRIALING",
+	"ACTIVE",
+	"PAST_DUE",
+	"CANCELED",
+	"PAUSED"
+]);
+/**
+* Feature access reason enum.
+*/
+const FeatureAccessReasonEnum = defineEnum("FeatureAccessReason", [
+	"included",
+	"limit_available",
+	"limit_reached",
+	"not_in_plan"
+]);
+
+//#endregion
+export { FeatureAccessReasonEnum, SubscriptionStatusSchemaEnum };