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

package/dist/billing/billing.entity.js

@@ -0,0 +1,122 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#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 };
+//# sourceMappingURL=billing.entity.js.map

package/dist/billing/billing.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.entity.js","names":[],"sources":["../../src/billing/billing.entity.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\n\n/**\n * Subscription status enum for entities.\n */\nexport const SubscriptionStatusEnum = defineEntityEnum({\n  name: 'SubscriptionStatus',\n  values: ['TRIALING', 'ACTIVE', 'PAST_DUE', 'CANCELED', 'PAUSED'] as const,\n  schema: 'saas_app',\n  description: 'Status of a subscription.',\n});\n\n/**\n * Subscription entity - organization subscription info.\n */\nexport const SubscriptionEntity = defineEntity({\n  name: 'Subscription',\n  description: 'Organization subscription/plan information.',\n  schema: 'saas_app',\n  map: 'subscription',\n  fields: {\n    id: field.id(),\n    organizationId: field.foreignKey({ isUnique: true }),\n\n    // Plan info\n    planId: field.string({ description: 'Plan identifier' }),\n    planName: field.string({ description: 'Plan display name' }),\n\n    // Status\n    status: field.enum('SubscriptionStatus'),\n\n    // Billing cycle\n    currentPeriodStart: field.dateTime(),\n    currentPeriodEnd: field.dateTime(),\n\n    // Trial\n    trialEndsAt: field.dateTime({ isOptional: true }),\n\n    // Cancellation\n    cancelAtPeriodEnd: field.boolean({ default: false }),\n    canceledAt: field.dateTime({ isOptional: true }),\n\n    // External reference\n    stripeSubscriptionId: field.string({ isOptional: true }),\n    stripeCustomerId: field.string({ isOptional: true }),\n\n    // Metadata\n    metadata: field.json({ isOptional: true }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n  },\n  enums: [SubscriptionStatusEnum],\n});\n\n/**\n * BillingUsage entity - track feature usage.\n */\nexport const BillingUsageEntity = defineEntity({\n  name: 'BillingUsage',\n  description: 'Track usage of metered features.',\n  schema: 'saas_app',\n  map: 'billing_usage',\n  fields: {\n    id: field.id(),\n    organizationId: field.foreignKey(),\n\n    // Feature\n    feature: field.string({\n      description: 'Feature being tracked (e.g., \"api_calls\", \"storage_gb\")',\n    }),\n\n    // Usage\n    quantity: field.int({ description: 'Usage quantity' }),\n    unit: field.string({\n      isOptional: true,\n      description: 'Unit of measurement',\n    }),\n\n    // Period\n    billingPeriod: field.string({\n      description: 'Billing period (e.g., \"2024-01\")',\n    }),\n\n    // Aggregation\n    recordedAt: field.dateTime({ description: 'When usage was recorded' }),\n\n    // Source\n    sourceId: field.string({\n      isOptional: true,\n      description: 'Source of usage (e.g., request ID)',\n    }),\n    sourceType: field.string({ isOptional: true }),\n\n    // Metadata\n    metadata: field.json({ isOptional: true }),\n  },\n  indexes: [\n    index.on(['organizationId', 'feature', 'billingPeriod']),\n    index.on(['organizationId', 'recordedAt']),\n  ],\n});\n\n/**\n * UsageLimit entity - feature usage limits per plan.\n */\nexport const UsageLimitEntity = defineEntity({\n  name: 'UsageLimit',\n  description: 'Usage limits per plan/organization.',\n  schema: 'saas_app',\n  map: 'usage_limit',\n  fields: {\n    id: field.id(),\n\n    // Scope\n    planId: field.string({\n      isOptional: true,\n      description: 'Plan this limit applies to',\n    }),\n    organizationId: field.string({\n      isOptional: true,\n      description: 'Org-specific override',\n    }),\n\n    // Limit\n    feature: field.string({ description: 'Feature being limited' }),\n    limit: field.int({ description: 'Maximum allowed usage' }),\n    resetPeriod: field.string({\n      default: '\"monthly\"',\n      description: 'When limit resets',\n    }),\n\n    // Soft/hard limit\n    isSoftLimit: field.boolean({\n      default: false,\n      description: 'Whether to warn vs block',\n    }),\n    overage: field.boolean({\n      default: false,\n      description: 'Whether overage is allowed',\n    }),\n    overageRate: field.float({\n      isOptional: true,\n      description: 'Cost per unit over limit',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n  },\n  indexes: [index.unique(['planId', 'feature'])],\n});\n"],"mappings":";;;;;;AAUA,MAAa,yBAAyB,iBAAiB;CACrD,MAAM;CACN,QAAQ;EAAC;EAAY;EAAU;EAAY;EAAY;EAAS;CAChE,QAAQ;CACR,aAAa;CACd,CAAC;;;;AAKF,MAAa,qBAAqB,aAAa;CAC7C,MAAM;CACN,aAAa;CACb,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,IAAI,MAAM,IAAI;EACd,gBAAgB,MAAM,WAAW,EAAE,UAAU,MAAM,CAAC;EAGpD,QAAQ,MAAM,OAAO,EAAE,aAAa,mBAAmB,CAAC;EACxD,UAAU,MAAM,OAAO,EAAE,aAAa,qBAAqB,CAAC;EAG5D,QAAQ,MAAM,KAAK,qBAAqB;EAGxC,oBAAoB,MAAM,UAAU;EACpC,kBAAkB,MAAM,UAAU;EAGlC,aAAa,MAAM,SAAS,EAAE,YAAY,MAAM,CAAC;EAGjD,mBAAmB,MAAM,QAAQ,EAAE,SAAS,OAAO,CAAC;EACpD,YAAY,MAAM,SAAS,EAAE,YAAY,MAAM,CAAC;EAGhD,sBAAsB,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EACxD,kBAAkB,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EAGpD,UAAU,MAAM,KAAK,EAAE,YAAY,MAAM,CAAC;EAG1C,WAAW,MAAM,WAAW;EAC5B,WAAW,MAAM,WAAW;EAC7B;CACD,OAAO,CAAC,uBAAuB;CAChC,CAAC;;;;AAKF,MAAa,qBAAqB,aAAa;CAC7C,MAAM;CACN,aAAa;CACb,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,IAAI,MAAM,IAAI;EACd,gBAAgB,MAAM,YAAY;EAGlC,SAAS,MAAM,OAAO,EACpB,aAAa,+DACd,CAAC;EAGF,UAAU,MAAM,IAAI,EAAE,aAAa,kBAAkB,CAAC;EACtD,MAAM,MAAM,OAAO;GACjB,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,eAAe,MAAM,OAAO,EAC1B,aAAa,sCACd,CAAC;EAGF,YAAY,MAAM,SAAS,EAAE,aAAa,2BAA2B,CAAC;EAGtE,UAAU,MAAM,OAAO;GACrB,YAAY;GACZ,aAAa;GACd,CAAC;EACF,YAAY,MAAM,OAAO,EAAE,YAAY,MAAM,CAAC;EAG9C,UAAU,MAAM,KAAK,EAAE,YAAY,MAAM,CAAC;EAC3C;CACD,SAAS,CACP,MAAM,GAAG;EAAC;EAAkB;EAAW;EAAgB,CAAC,EACxD,MAAM,GAAG,CAAC,kBAAkB,aAAa,CAAC,CAC3C;CACF,CAAC;;;;AAKF,MAAa,mBAAmB,aAAa;CAC3C,MAAM;CACN,aAAa;CACb,QAAQ;CACR,KAAK;CACL,QAAQ;EACN,IAAI,MAAM,IAAI;EAGd,QAAQ,MAAM,OAAO;GACnB,YAAY;GACZ,aAAa;GACd,CAAC;EACF,gBAAgB,MAAM,OAAO;GAC3B,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,SAAS,MAAM,OAAO,EAAE,aAAa,yBAAyB,CAAC;EAC/D,OAAO,MAAM,IAAI,EAAE,aAAa,yBAAyB,CAAC;EAC1D,aAAa,MAAM,OAAO;GACxB,SAAS;GACT,aAAa;GACd,CAAC;EAGF,aAAa,MAAM,QAAQ;GACzB,SAAS;GACT,aAAa;GACd,CAAC;EACF,SAAS,MAAM,QAAQ;GACrB,SAAS;GACT,aAAa;GACd,CAAC;EACF,aAAa,MAAM,MAAM;GACvB,YAAY;GACZ,aAAa;GACd,CAAC;EAGF,WAAW,MAAM,WAAW;EAC5B,WAAW,MAAM,WAAW;EAC7B;CACD,SAAS,CAAC,MAAM,OAAO,CAAC,UAAU,UAAU,CAAC,CAAC;CAC/C,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.enum.d.ts","names":[],"sources":["../../src/billing/billing.enum.ts"],"sourcesContent":[],"mappings":";;;;;;;AAMA;AAWa,cAXA,4BAgBX,EAVA,2BAAA,CANuC,QAWL,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;;;;cAAvB,yBAKX,2BAAA,CALkC"}

package/dist/billing/billing.enum.js

@@ -0,0 +1,27 @@
+import { defineEnum } from "@contractspec/lib.schema";
+
+//#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 };
+//# sourceMappingURL=billing.enum.js.map

package/dist/billing/billing.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.enum.js","names":[],"sources":["../../src/billing/billing.enum.ts"],"sourcesContent":["import { defineEnum } from '@contractspec/lib.schema';\n\n/**\n * Subscription status enum for contract schemas.\n * Note: Entity enum is defined separately in billing.entity.ts\n */\nexport const SubscriptionStatusSchemaEnum = defineEnum('SubscriptionStatus', [\n  'TRIALING',\n  'ACTIVE',\n  'PAST_DUE',\n  'CANCELED',\n  'PAUSED',\n]);\n\n/**\n * Feature access reason enum.\n */\nexport const FeatureAccessReasonEnum = defineEnum('FeatureAccessReason', [\n  'included',\n  'limit_available',\n  'limit_reached',\n  'not_in_plan',\n]);\n"],"mappings":";;;;;;;AAMA,MAAa,+BAA+B,WAAW,sBAAsB;CAC3E;CACA;CACA;CACA;CACA;CACD,CAAC;;;;AAKF,MAAa,0BAA0B,WAAW,uBAAuB;CACvE;CACA;CACA;CACA;CACD,CAAC"}

package/dist/billing/billing.event.d.ts

@@ -0,0 +1,86 @@
+import * as _contractspec_lib_contracts20 from "@contractspec/lib.contracts";
+import * as _contractspec_lib_schema305 from "@contractspec/lib.schema";
+
+//#region src/billing/billing.event.d.ts
+/**
+ * Event: Feature usage has been recorded.
+ */
+declare const UsageRecordedEvent: _contractspec_lib_contracts20.EventSpec<_contractspec_lib_schema305.SchemaModel<{
+  organizationId: {
+    type: _contractspec_lib_schema305.FieldType<string, string>;
+    isOptional: false;
+  };
+  feature: {
+    type: _contractspec_lib_schema305.FieldType<string, string>;
+    isOptional: false;
+  };
+  quantity: {
+    type: _contractspec_lib_schema305.FieldType<number, number>;
+    isOptional: false;
+  };
+  billingPeriod: {
+    type: _contractspec_lib_schema305.FieldType<string, string>;
+    isOptional: false;
+  };
+  recordedAt: {
+    type: _contractspec_lib_schema305.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+/**
+ * Event: Usage limit has been reached for a feature.
+ */
+declare const UsageLimitReachedEvent: _contractspec_lib_contracts20.EventSpec<_contractspec_lib_schema305.SchemaModel<{
+  organizationId: {
+    type: _contractspec_lib_schema305.FieldType<string, string>;
+    isOptional: false;
+  };
+  feature: {
+    type: _contractspec_lib_schema305.FieldType<string, string>;
+    isOptional: false;
+  };
+  limit: {
+    type: _contractspec_lib_schema305.FieldType<number, number>;
+    isOptional: false;
+  };
+  currentUsage: {
+    type: _contractspec_lib_schema305.FieldType<number, number>;
+    isOptional: false;
+  };
+  reachedAt: {
+    type: _contractspec_lib_schema305.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+/**
+ * Event: Subscription status has changed.
+ */
+declare const SubscriptionChangedEvent: _contractspec_lib_contracts20.EventSpec<_contractspec_lib_schema305.SchemaModel<{
+  organizationId: {
+    type: _contractspec_lib_schema305.FieldType<string, string>;
+    isOptional: false;
+  };
+  previousPlan: {
+    type: _contractspec_lib_schema305.FieldType<string, string>;
+    isOptional: true;
+  };
+  newPlan: {
+    type: _contractspec_lib_schema305.FieldType<string, string>;
+    isOptional: false;
+  };
+  previousStatus: {
+    type: _contractspec_lib_schema305.FieldType<string, string>;
+    isOptional: true;
+  };
+  newStatus: {
+    type: _contractspec_lib_schema305.FieldType<string, string>;
+    isOptional: false;
+  };
+  changedAt: {
+    type: _contractspec_lib_schema305.FieldType<Date, string>;
+    isOptional: false;
+  };
+}>>;
+//#endregion
+export { SubscriptionChangedEvent, UsageLimitReachedEvent, UsageRecordedEvent };
+//# sourceMappingURL=billing.event.d.ts.map

package/dist/billing/billing.event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.event.d.ts","names":[],"sources":["../../src/billing/billing.event.ts"],"sourcesContent":[],"mappings":";;;;;;;cAmEa,oBAAkB,6BAAA,CAAA,sCAAA;EAAlB,cAAA,EAAA;IAUX,IAAA,EAAA,2BAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;EAV6B,QAAA,EAAA;IAAA,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAelB,UAAA,EAAA,KAAA;EAUX,CAAA;;;;;;+CAViC,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAAA,CAAA;AAenC,CAAA,CAAA,CAAA;;;;cAfa,wBAAsB,6BAAA,CAAA,sCAAA;;UAUjC,2BAAA,CAAA;;;EAKmC,OAAA,EAAA;IAAA,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;;cAAxB,0BAAwB,6BAAA,CAAA,sCAAA;;UAUnC,2BAAA,CAAA"}

package/dist/billing/billing.event.js

@@ -0,0 +1,153 @@
+import { defineEvent } from "@contractspec/lib.contracts";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+
+//#region src/billing/billing.event.ts
+/**
+* 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.
+*/
+const UsageRecordedEvent = defineEvent({
+	meta: {
+		key: "billing.usage.recorded",
+		version: "1.0.0",
+		description: "Feature usage has been recorded.",
+		stability: "stable",
+		owners: ["@saas-team"],
+		tags: [
+			"billing",
+			"usage",
+			"recorded"
+		]
+	},
+	payload: UsageRecordedPayload
+});
+/**
+* Event: Usage limit has been reached for a feature.
+*/
+const UsageLimitReachedEvent = defineEvent({
+	meta: {
+		key: "billing.limit.reached",
+		version: "1.0.0",
+		description: "Usage limit has been reached for a feature.",
+		stability: "stable",
+		owners: ["@saas-team"],
+		tags: [
+			"billing",
+			"limit",
+			"reached"
+		]
+	},
+	payload: UsageLimitReachedPayload
+});
+/**
+* Event: Subscription status has changed.
+*/
+const SubscriptionChangedEvent = defineEvent({
+	meta: {
+		key: "billing.subscription.changed",
+		version: "1.0.0",
+		description: "Subscription status has changed.",
+		stability: "stable",
+		owners: ["@saas-team"],
+		tags: [
+			"billing",
+			"subscription",
+			"changed"
+		]
+	},
+	payload: SubscriptionChangedPayload
+});
+
+//#endregion
+export { SubscriptionChangedEvent, UsageLimitReachedEvent, UsageRecordedEvent };
+//# sourceMappingURL=billing.event.js.map

package/dist/billing/billing.event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.event.js","names":[],"sources":["../../src/billing/billing.event.ts"],"sourcesContent":["import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\nimport { defineEvent } from '@contractspec/lib.contracts';\n\n/**\n * Payload when feature usage is recorded.\n */\nconst UsageRecordedPayload = defineSchemaModel({\n  name: 'UsageRecordedPayload',\n  description: 'Payload when feature usage is recorded',\n  fields: {\n    organizationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    quantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    billingPeriod: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    recordedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Payload when usage limit is reached.\n */\nconst UsageLimitReachedPayload = defineSchemaModel({\n  name: 'UsageLimitReachedPayload',\n  description: 'Payload when usage limit is reached',\n  fields: {\n    organizationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    currentUsage: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    reachedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Payload when subscription status changes.\n */\nconst SubscriptionChangedPayload = defineSchemaModel({\n  name: 'SubscriptionChangedPayload',\n  description: 'Payload when subscription status changes',\n  fields: {\n    organizationId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    previousPlan: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    newPlan: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    previousStatus: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    newStatus: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    changedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\n/**\n * Event: Feature usage has been recorded.\n */\nexport const UsageRecordedEvent = defineEvent({\n  meta: {\n    key: 'billing.usage.recorded',\n    version: '1.0.0',\n    description: 'Feature usage has been recorded.',\n    stability: 'stable',\n    owners: ['@saas-team'],\n    tags: ['billing', 'usage', 'recorded'],\n  },\n  payload: UsageRecordedPayload,\n});\n\n/**\n * Event: Usage limit has been reached for a feature.\n */\nexport const UsageLimitReachedEvent = defineEvent({\n  meta: {\n    key: 'billing.limit.reached',\n    version: '1.0.0',\n    description: 'Usage limit has been reached for a feature.',\n    stability: 'stable',\n    owners: ['@saas-team'],\n    tags: ['billing', 'limit', 'reached'],\n  },\n  payload: UsageLimitReachedPayload,\n});\n\n/**\n * Event: Subscription status has changed.\n */\nexport const SubscriptionChangedEvent = defineEvent({\n  meta: {\n    key: 'billing.subscription.changed',\n    version: '1.0.0',\n    description: 'Subscription status has changed.',\n    stability: 'stable',\n    owners: ['@saas-team'],\n    tags: ['billing', 'subscription', 'changed'],\n  },\n  payload: SubscriptionChangedPayload,\n});\n"],"mappings":";;;;;;;AAMA,MAAM,uBAAuB,kBAAkB;CAC7C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,gBAAgB;GACd,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,UAAU;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAO;EACpE,eAAe;GACb,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,YAAY;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EACnE;CACF,CAAC;;;;AAKF,MAAM,2BAA2B,kBAAkB;CACjD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,gBAAgB;GACd,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,OAAO;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAO;EACjE,cAAc;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAO;EACxE,WAAW;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EAClE;CACF,CAAC;;;;AAKF,MAAM,6BAA6B,kBAAkB;CACnD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,gBAAgB;GACd,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EAC1E,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,gBAAgB;GACd,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE,WAAW;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAO;EAClE;CACF,CAAC;;;;AAKF,MAAa,qBAAqB,YAAY;CAC5C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,aAAa;EACtB,MAAM;GAAC;GAAW;GAAS;GAAW;EACvC;CACD,SAAS;CACV,CAAC;;;;AAKF,MAAa,yBAAyB,YAAY;CAChD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,aAAa;EACtB,MAAM;GAAC;GAAW;GAAS;GAAU;EACtC;CACD,SAAS;CACV,CAAC;;;;AAKF,MAAa,2BAA2B,YAAY;CAClD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW;EACX,QAAQ,CAAC,aAAa;EACtB,MAAM;GAAC;GAAW;GAAgB;GAAU;EAC7C;CACD,SAAS;CACV,CAAC"}

package/dist/billing/billing.handler.d.ts

@@ -0,0 +1,82 @@
+//#region src/billing/billing.handler.d.ts
+interface Subscription {
+  id: string;
+  organizationId: string;
+  planId: string;
+  planName: string;
+  status: 'ACTIVE' | 'TRIALING' | 'PAST_DUE' | 'CANCELED' | 'UNPAID';
+  currentPeriodStart: Date;
+  currentPeriodEnd: Date;
+  limits: {
+    projects: number;
+    users: number;
+    storage: number;
+    apiCalls: number;
+  };
+  usage: {
+    projects: number;
+    users: number;
+    storage: number;
+    apiCalls: number;
+  };
+}
+interface UsageSummary {
+  organizationId: string;
+  period: string;
+  apiCalls: {
+    total: number;
+    limit: number;
+    percentUsed: number;
+  };
+  storage: {
+    totalGb: number;
+    limitGb: number;
+    percentUsed: number;
+  };
+  activeProjects: number;
+  activeUsers: number;
+  breakdown: {
+    date: string;
+    apiCalls: number;
+    storageGb: number;
+  }[];
+}
+interface RecordUsageInput {
+  metric: string;
+  quantity: number;
+  timestamp?: Date;
+  metadata?: Record<string, unknown>;
+}
+interface CheckFeatureAccessInput {
+  feature: string;
+}
+interface CheckFeatureAccessOutput {
+  allowed: boolean;
+  reason?: 'PLAN_LIMIT' | 'FEATURE_NOT_INCLUDED' | 'QUOTA_EXCEEDED' | 'SUBSCRIPTION_INACTIVE';
+  currentUsage?: number;
+  limit?: number;
+}
+/**
+ * Mock handler for GetSubscriptionContract.
+ */
+declare function mockGetSubscriptionHandler(): Promise<Subscription>;
+/**
+ * Mock handler for GetUsageSummaryContract.
+ */
+declare function mockGetUsageSummaryHandler(input: {
+  period?: string;
+}): Promise<UsageSummary>;
+/**
+ * Mock handler for RecordUsageContract.
+ */
+declare function mockRecordUsageHandler(input: RecordUsageInput): Promise<{
+  recorded: boolean;
+  newTotal: number;
+}>;
+/**
+ * Mock handler for CheckFeatureAccessContract.
+ */
+declare function mockCheckFeatureAccessHandler(input: CheckFeatureAccessInput): Promise<CheckFeatureAccessOutput>;
+//#endregion
+export { CheckFeatureAccessInput, CheckFeatureAccessOutput, RecordUsageInput, Subscription, UsageSummary, mockCheckFeatureAccessHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockRecordUsageHandler };
+//# sourceMappingURL=billing.handler.d.ts.map

package/dist/billing/billing.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.handler.d.ts","names":[],"sources":["../../src/billing/billing.handler.ts"],"sourcesContent":[],"mappings":";UAMiB,YAAA;EAAA,EAAA,EAAA,MAAA;EAsBA,cAAA,EAAY,MAAA;EAsBZ,MAAA,EAAA,MAAA;EAOA,QAAA,EAAA,MAAA;EAIA,MAAA,EAAA,QAAA,GAAA,UAAwB,GAAA,UAAA,GAAA,UAAA,GAAA,QAAA;EAcnB,kBAAA,EA/DA,IA+DA;EAOA,gBAAA,EArEF,IAqEE;EAYA,MAAA,EAAA;IAeA,QAAA,EAAA,MAAA;IACb,KAAA,EAAA,MAAA;IACE,OAAA,EAAA,MAAA;IAAR,QAAA,EAAA,MAAA;EAAO,CAAA;;;;;;;;UAnFO,YAAA;;;;;;;;;;;;;;;;;;;;;UAsBA,gBAAA;;;cAGH;aACD;;UAGI,uBAAA;;;UAIA,wBAAA;;;;;;;;;iBAcK,0BAAA,CAAA,GAA8B,QAAQ;;;;iBAOtC,0BAAA;;IAElB,QAAQ;;;;iBAUU,sBAAA,QACb,mBACN;;;;;;;iBAamB,6BAAA,QACb,0BACN,QAAQ"}

package/dist/billing/billing.handler.js

@@ -0,0 +1,58 @@
+import { MOCK_SUBSCRIPTION, MOCK_USAGE_SUMMARY } from "../shared/mock-data.js";
+
+//#region src/billing/billing.handler.ts
+/**
+* Mock handlers for Billing contracts.
+*/
+/**
+* Mock handler for GetSubscriptionContract.
+*/
+async function mockGetSubscriptionHandler() {
+	return MOCK_SUBSCRIPTION;
+}
+/**
+* Mock handler for GetUsageSummaryContract.
+*/
+async function mockGetUsageSummaryHandler(input) {
+	return {
+		...MOCK_USAGE_SUMMARY,
+		period: input.period ?? "current_month"
+	};
+}
+/**
+* Mock handler for RecordUsageContract.
+*/
+async function mockRecordUsageHandler(input) {
+	return {
+		recorded: true,
+		newTotal: MOCK_USAGE_SUMMARY.apiCalls.total + input.quantity
+	};
+}
+/**
+* Mock handler for CheckFeatureAccessContract.
+*/
+async function mockCheckFeatureAccessHandler(input) {
+	const { feature } = input;
+	return {
+		custom_domains: { allowed: true },
+		api_access: {
+			allowed: true,
+			currentUsage: MOCK_USAGE_SUMMARY.apiCalls.total,
+			limit: MOCK_USAGE_SUMMARY.apiCalls.limit
+		},
+		advanced_analytics: {
+			allowed: false,
+			reason: "FEATURE_NOT_INCLUDED"
+		},
+		unlimited_projects: {
+			allowed: false,
+			reason: "PLAN_LIMIT",
+			currentUsage: MOCK_SUBSCRIPTION.usage.projects,
+			limit: MOCK_SUBSCRIPTION.limits.projects
+		}
+	}[feature] ?? { allowed: true };
+}
+
+//#endregion
+export { mockCheckFeatureAccessHandler, mockGetSubscriptionHandler, mockGetUsageSummaryHandler, mockRecordUsageHandler };
+//# sourceMappingURL=billing.handler.js.map

package/dist/billing/billing.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.handler.js","names":[],"sources":["../../src/billing/billing.handler.ts"],"sourcesContent":["/**\n * Mock handlers for Billing contracts.\n */\nimport { MOCK_SUBSCRIPTION, MOCK_USAGE_SUMMARY } from '../shared/mock-data';\n\n// Types inferred from contract schemas\nexport interface Subscription {\n  id: string;\n  organizationId: string;\n  planId: string;\n  planName: string;\n  status: 'ACTIVE' | 'TRIALING' | 'PAST_DUE' | 'CANCELED' | 'UNPAID';\n  currentPeriodStart: Date;\n  currentPeriodEnd: Date;\n  limits: {\n    projects: number;\n    users: number;\n    storage: number;\n    apiCalls: number;\n  };\n  usage: {\n    projects: number;\n    users: number;\n    storage: number;\n    apiCalls: number;\n  };\n}\n\nexport interface UsageSummary {\n  organizationId: string;\n  period: string;\n  apiCalls: {\n    total: number;\n    limit: number;\n    percentUsed: number;\n  };\n  storage: {\n    totalGb: number;\n    limitGb: number;\n    percentUsed: number;\n  };\n  activeProjects: number;\n  activeUsers: number;\n  breakdown: {\n    date: string;\n    apiCalls: number;\n    storageGb: number;\n  }[];\n}\n\nexport interface RecordUsageInput {\n  metric: string;\n  quantity: number;\n  timestamp?: Date;\n  metadata?: Record<string, unknown>;\n}\n\nexport interface CheckFeatureAccessInput {\n  feature: string;\n}\n\nexport interface CheckFeatureAccessOutput {\n  allowed: boolean;\n  reason?:\n    | 'PLAN_LIMIT'\n    | 'FEATURE_NOT_INCLUDED'\n    | 'QUOTA_EXCEEDED'\n    | 'SUBSCRIPTION_INACTIVE';\n  currentUsage?: number;\n  limit?: number;\n}\n\n/**\n * Mock handler for GetSubscriptionContract.\n */\nexport async function mockGetSubscriptionHandler(): Promise<Subscription> {\n  return MOCK_SUBSCRIPTION;\n}\n\n/**\n * Mock handler for GetUsageSummaryContract.\n */\nexport async function mockGetUsageSummaryHandler(input: {\n  period?: string;\n}): Promise<UsageSummary> {\n  return {\n    ...MOCK_USAGE_SUMMARY,\n    period: input.period ?? 'current_month',\n  };\n}\n\n/**\n * Mock handler for RecordUsageContract.\n */\nexport async function mockRecordUsageHandler(\n  input: RecordUsageInput\n): Promise<{ recorded: boolean; newTotal: number }> {\n  const currentUsage = MOCK_USAGE_SUMMARY.apiCalls.total;\n  const newTotal = currentUsage + input.quantity;\n\n  return {\n    recorded: true,\n    newTotal,\n  };\n}\n\n/**\n * Mock handler for CheckFeatureAccessContract.\n */\nexport async function mockCheckFeatureAccessHandler(\n  input: CheckFeatureAccessInput\n): Promise<CheckFeatureAccessOutput> {\n  const { feature } = input;\n\n  const featureMap: Record<string, CheckFeatureAccessOutput> = {\n    custom_domains: {\n      allowed: true,\n    },\n    api_access: {\n      allowed: true,\n      currentUsage: MOCK_USAGE_SUMMARY.apiCalls.total,\n      limit: MOCK_USAGE_SUMMARY.apiCalls.limit,\n    },\n    advanced_analytics: {\n      allowed: false,\n      reason: 'FEATURE_NOT_INCLUDED',\n    },\n    unlimited_projects: {\n      allowed: false,\n      reason: 'PLAN_LIMIT',\n      currentUsage: MOCK_SUBSCRIPTION.usage.projects,\n      limit: MOCK_SUBSCRIPTION.limits.projects,\n    },\n  };\n\n  return featureMap[feature] ?? { allowed: true };\n}\n"],"mappings":";;;;;;;;;AA2EA,eAAsB,6BAAoD;AACxE,QAAO;;;;;AAMT,eAAsB,2BAA2B,OAEvB;AACxB,QAAO;EACL,GAAG;EACH,QAAQ,MAAM,UAAU;EACzB;;;;;AAMH,eAAsB,uBACpB,OACkD;AAIlD,QAAO;EACL,UAAU;EACV,UALmB,mBAAmB,SAAS,QACjB,MAAM;EAKrC;;;;;AAMH,eAAsB,8BACpB,OACmC;CACnC,MAAM,EAAE,YAAY;AAuBpB,QArB6D;EAC3D,gBAAgB,EACd,SAAS,MACV;EACD,YAAY;GACV,SAAS;GACT,cAAc,mBAAmB,SAAS;GAC1C,OAAO,mBAAmB,SAAS;GACpC;EACD,oBAAoB;GAClB,SAAS;GACT,QAAQ;GACT;EACD,oBAAoB;GAClB,SAAS;GACT,QAAQ;GACR,cAAc,kBAAkB,MAAM;GACtC,OAAO,kBAAkB,OAAO;GACjC;EACF,CAEiB,YAAY,EAAE,SAAS,MAAM"}