@contractspec/example.saas-boilerplate 1.44.0

package/dist/billing/billing.operations.d.ts

@@ -0,0 +1,166 @@
+import * as _contractspec_lib_schema60 from "@contractspec/lib.schema";
+import * as _contractspec_lib_contracts2 from "@contractspec/lib.contracts";
+
+//#region src/billing/billing.operations.d.ts
+/**
+ * Get subscription status.
+ */
+declare const GetSubscriptionContract: _contractspec_lib_contracts2.OperationSpec<_contractspec_lib_schema60.AnySchemaModel, _contractspec_lib_schema60.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: false;
+  };
+  organizationId: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: false;
+  };
+  planId: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: false;
+  };
+  planName: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema60.EnumType<[string, string, string, string, string]>;
+    isOptional: false;
+  };
+  currentPeriodStart: {
+    type: _contractspec_lib_schema60.FieldType<Date, string>;
+    isOptional: false;
+  };
+  currentPeriodEnd: {
+    type: _contractspec_lib_schema60.FieldType<Date, string>;
+    isOptional: false;
+  };
+  trialEndsAt: {
+    type: _contractspec_lib_schema60.FieldType<Date, string>;
+    isOptional: true;
+  };
+  cancelAtPeriodEnd: {
+    type: _contractspec_lib_schema60.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+}>, undefined>;
+/**
+ * Record feature usage.
+ */
+declare const RecordUsageContract: _contractspec_lib_contracts2.OperationSpec<_contractspec_lib_schema60.SchemaModel<{
+  feature: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: false;
+  };
+  quantity: {
+    type: _contractspec_lib_schema60.FieldType<number, number>;
+    isOptional: false;
+  };
+  sourceId: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: true;
+  };
+  sourceType: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: true;
+  };
+  metadata: {
+    type: _contractspec_lib_schema60.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+}>, _contractspec_lib_schema60.SchemaModel<{
+  recorded: {
+    type: _contractspec_lib_schema60.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  currentUsage: {
+    type: _contractspec_lib_schema60.FieldType<number, number>;
+    isOptional: false;
+  };
+  limit: {
+    type: _contractspec_lib_schema60.FieldType<number, number>;
+    isOptional: true;
+  };
+  limitReached: {
+    type: _contractspec_lib_schema60.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+}>, {
+  key: string;
+  version: number;
+  when: string;
+  payload: _contractspec_lib_schema60.SchemaModel<{
+    feature: {
+      type: _contractspec_lib_schema60.FieldType<string, string>;
+      isOptional: false;
+    };
+    quantity: {
+      type: _contractspec_lib_schema60.FieldType<number, number>;
+      isOptional: false;
+    };
+  }>;
+}[]>;
+/**
+ * Get usage summary.
+ */
+declare const GetUsageSummaryContract: _contractspec_lib_contracts2.OperationSpec<_contractspec_lib_schema60.SchemaModel<{
+  billingPeriod: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, _contractspec_lib_schema60.SchemaModel<{
+  billingPeriod: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: false;
+  };
+  usage: {
+    type: _contractspec_lib_schema60.SchemaModel<{
+      feature: {
+        type: _contractspec_lib_schema60.FieldType<string, string>;
+        isOptional: false;
+      };
+      used: {
+        type: _contractspec_lib_schema60.FieldType<number, number>;
+        isOptional: false;
+      };
+      limit: {
+        type: _contractspec_lib_schema60.FieldType<number, number>;
+        isOptional: true;
+      };
+      unit: {
+        type: _contractspec_lib_schema60.FieldType<string, string>;
+        isOptional: true;
+      };
+      percentage: {
+        type: _contractspec_lib_schema60.FieldType<number, number>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+}>, undefined>;
+/**
+ * Check feature access.
+ */
+declare const CheckFeatureAccessContract: _contractspec_lib_contracts2.OperationSpec<_contractspec_lib_schema60.SchemaModel<{
+  feature: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema60.SchemaModel<{
+  hasAccess: {
+    type: _contractspec_lib_schema60.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  reason: {
+    type: _contractspec_lib_schema60.EnumType<[string, string, string, string]>;
+    isOptional: true;
+  };
+  upgradeUrl: {
+    type: _contractspec_lib_schema60.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+//#endregion
+export { CheckFeatureAccessContract, GetSubscriptionContract, GetUsageSummaryContract, RecordUsageContract };
+//# sourceMappingURL=billing.operations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.operations.d.ts","names":[],"sources":["../../src/billing/billing.operations.ts"],"sourcesContent":[],"mappings":";;;;;;;cAiBa,yBAAuB,4BAAA,CAAA,cAuClC,0BAAA,CAvCkC,cAAA,6BAAA;EAAvB,EAAA,EAAA;IAuCX,IAAA,EAvCkC,0BAAA,CAAA,SAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;;;;;;;EAAA,CAAA;EAAA,MAAA,EAAA;IA4CvB,IAAA,qCA6CX,CAAA,CAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;8CA7C8B,KAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;;;;;;;;EAAA,CAAA;AAkDhC,CAAA,CAAA,EAAa,SAAA,CAAA;;;;cAlDA,kDAAmB,yCAAA;;UA6C9B,0BAAA,CAAA;;;;;;EAKkC,CAAA;EAwCvB,QAAA,EAAA;IAmCX,IAAA,sCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;EAnCqC,CAAA;;;;;EAAA,QAAA,EAAA;;;;;;UA1FP,0BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAkDnB,sDAAuB,yCAAA;;UAmClC,0BAAA,CAAA;;;;;UAnCkC,0BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwCvB,yDAA0B,yCAAA;;UAmCrC,0BAAA,CAAA;;;;;UAnCqC,0BAAA,CAAA"}

package/dist/billing/billing.operations.js

@@ -0,0 +1,181 @@
+import { CheckFeatureAccessInputModel, CheckFeatureAccessOutputModel, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, RecordUsageInputModel, RecordUsageOutputModel, SubscriptionModel, UsageRecordedPayloadModel } from "./billing.schema.js";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
+
+//#region src/billing/billing.operations.ts
+const OWNERS = ["@example.saas-boilerplate"];
+/**
+* Get subscription status.
+*/
+const GetSubscriptionContract = defineQuery({
+	meta: {
+		key: "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" },
+	acceptance: {
+		scenarios: [{
+			key: "get-subscription-happy-path",
+			given: ["Organization has active subscription"],
+			when: ["User requests subscription status"],
+			then: ["Subscription details are returned"]
+		}],
+		examples: [{
+			key: "get-basic",
+			input: null,
+			output: {
+				plan: "pro",
+				status: "active",
+				currentPeriodEnd: "2025-02-01T00:00:00Z"
+			}
+		}]
+	}
+});
+/**
+* Record feature usage.
+*/
+const RecordUsageContract = defineCommand({
+	meta: {
+		key: "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: [{
+		key: "billing.usage.recorded",
+		version: 1,
+		when: "Usage is recorded",
+		payload: UsageRecordedPayloadModel
+	}] },
+	acceptance: {
+		scenarios: [{
+			key: "record-usage-happy-path",
+			given: ["Organization exists"],
+			when: ["System records feature usage"],
+			then: ["Usage is recorded"]
+		}],
+		examples: [{
+			key: "record-api-call",
+			input: {
+				feature: "api_calls",
+				quantity: 1,
+				idempotencyKey: "abc-123"
+			},
+			output: {
+				recorded: true,
+				currentUsage: 100
+			}
+		}]
+	}
+});
+/**
+* Get usage summary.
+*/
+const GetUsageSummaryContract = defineQuery({
+	meta: {
+		key: "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" },
+	acceptance: {
+		scenarios: [{
+			key: "get-usage-happy-path",
+			given: ["Organization has usage history"],
+			when: ["User requests usage summary"],
+			then: ["Usage metrics are returned"]
+		}],
+		examples: [{
+			key: "get-current-usage",
+			input: { period: "current" },
+			output: { features: [{
+				name: "api_calls",
+				used: 100,
+				limit: 1e3
+			}] }
+		}]
+	}
+});
+/**
+* Check feature access.
+*/
+const CheckFeatureAccessContract = defineQuery({
+	meta: {
+		key: "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" },
+	acceptance: {
+		scenarios: [{
+			key: "check-access-granted",
+			given: ["Organization is on Pro plan"],
+			when: ["User checks access to Pro feature"],
+			then: ["Access is granted"]
+		}],
+		examples: [{
+			key: "check-advanced-reports",
+			input: { feature: "advanced_reports" },
+			output: {
+				hasAccess: true,
+				reason: "Included in Pro plan"
+			}
+		}]
+	}
+});
+
+//#endregion
+export { CheckFeatureAccessContract, GetSubscriptionContract, GetUsageSummaryContract, RecordUsageContract };
+//# sourceMappingURL=billing.operations.js.map

package/dist/billing/billing.operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.operations.js","names":[],"sources":["../../src/billing/billing.operations.ts"],"sourcesContent":["import { defineCommand, defineQuery } from '@contractspec/lib.contracts';\nimport {\n  CheckFeatureAccessInputModel,\n  CheckFeatureAccessOutputModel,\n  GetUsageSummaryInputModel,\n  GetUsageSummaryOutputModel,\n  RecordUsageInputModel,\n  RecordUsageOutputModel,\n  SubscriptionModel,\n  UsageRecordedPayloadModel,\n} from './billing.schema';\n\nconst OWNERS = ['@example.saas-boilerplate'] as const;\n\n/**\n * Get subscription status.\n */\nexport const GetSubscriptionContract = defineQuery({\n  meta: {\n    key: 'saas.billing.subscription.get',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['saas', 'billing', 'subscription'],\n    description: 'Get organization subscription status.',\n    goal: 'Show current plan and billing status.',\n    context: 'Billing page, plan upgrade prompts.',\n  },\n  io: {\n    input: null,\n    output: SubscriptionModel,\n  },\n  policy: {\n    auth: 'user',\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'get-subscription-happy-path',\n        given: ['Organization has active subscription'],\n        when: ['User requests subscription status'],\n        then: ['Subscription details are returned'],\n      },\n    ],\n    examples: [\n      {\n        key: 'get-basic',\n        input: null,\n        output: {\n          plan: 'pro',\n          status: 'active',\n          currentPeriodEnd: '2025-02-01T00:00:00Z',\n        },\n      },\n    ],\n  },\n});\n\n/**\n * Record feature usage.\n */\nexport const RecordUsageContract = defineCommand({\n  meta: {\n    key: 'saas.billing.usage.record',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['saas', 'billing', 'usage'],\n    description: 'Record usage of a metered feature.',\n    goal: 'Track feature usage for billing.',\n    context: 'Called by services when metered features are used.',\n  },\n  io: {\n    input: RecordUsageInputModel,\n    output: RecordUsageOutputModel,\n  },\n  policy: {\n    auth: 'user',\n  },\n  sideEffects: {\n    emits: [\n      {\n        key: 'billing.usage.recorded',\n        version: 1,\n        when: 'Usage is recorded',\n        payload: UsageRecordedPayloadModel,\n      },\n    ],\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'record-usage-happy-path',\n        given: ['Organization exists'],\n        when: ['System records feature usage'],\n        then: ['Usage is recorded'],\n      },\n    ],\n    examples: [\n      {\n        key: 'record-api-call',\n        input: { feature: 'api_calls', quantity: 1, idempotencyKey: 'abc-123' },\n        output: { recorded: true, currentUsage: 100 },\n      },\n    ],\n  },\n});\n\n/**\n * Get usage summary.\n */\nexport const GetUsageSummaryContract = defineQuery({\n  meta: {\n    key: 'saas.billing.usage.summary',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['saas', 'billing', 'usage'],\n    description: 'Get usage summary for the current billing period.',\n    goal: 'Show usage vs limits.',\n    context: 'Billing page, usage dashboards.',\n  },\n  io: {\n    input: GetUsageSummaryInputModel,\n    output: GetUsageSummaryOutputModel,\n  },\n  policy: {\n    auth: 'user',\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'get-usage-happy-path',\n        given: ['Organization has usage history'],\n        when: ['User requests usage summary'],\n        then: ['Usage metrics are returned'],\n      },\n    ],\n    examples: [\n      {\n        key: 'get-current-usage',\n        input: { period: 'current' },\n        output: { features: [{ name: 'api_calls', used: 100, limit: 1000 }] },\n      },\n    ],\n  },\n});\n\n/**\n * Check feature access.\n */\nexport const CheckFeatureAccessContract = defineQuery({\n  meta: {\n    key: 'saas.billing.feature.check',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['saas', 'billing', 'feature'],\n    description: 'Check if organization has access to a feature.',\n    goal: 'Gate features based on plan/usage.',\n    context: 'Feature access checks, upgrade prompts.',\n  },\n  io: {\n    input: CheckFeatureAccessInputModel,\n    output: CheckFeatureAccessOutputModel,\n  },\n  policy: {\n    auth: 'user',\n  },\n  acceptance: {\n    scenarios: [\n      {\n        key: 'check-access-granted',\n        given: ['Organization is on Pro plan'],\n        when: ['User checks access to Pro feature'],\n        then: ['Access is granted'],\n      },\n    ],\n    examples: [\n      {\n        key: 'check-advanced-reports',\n        input: { feature: 'advanced_reports' },\n        output: { hasAccess: true, reason: 'Included in Pro plan' },\n      },\n    ],\n  },\n});\n"],"mappings":";;;;AAYA,MAAM,SAAS,CAAC,4BAA4B;;;;AAK5C,MAAa,0BAA0B,YAAY;CACjD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAQ;GAAW;GAAe;EACzC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ,EACN,MAAM,QACP;CACD,YAAY;EACV,WAAW,CACT;GACE,KAAK;GACL,OAAO,CAAC,uCAAuC;GAC/C,MAAM,CAAC,oCAAoC;GAC3C,MAAM,CAAC,oCAAoC;GAC5C,CACF;EACD,UAAU,CACR;GACE,KAAK;GACL,OAAO;GACP,QAAQ;IACN,MAAM;IACN,QAAQ;IACR,kBAAkB;IACnB;GACF,CACF;EACF;CACF,CAAC;;;;AAKF,MAAa,sBAAsB,cAAc;CAC/C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAQ;GAAW;GAAQ;EAClC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ,EACN,MAAM,QACP;CACD,aAAa,EACX,OAAO,CACL;EACE,KAAK;EACL,SAAS;EACT,MAAM;EACN,SAAS;EACV,CACF,EACF;CACD,YAAY;EACV,WAAW,CACT;GACE,KAAK;GACL,OAAO,CAAC,sBAAsB;GAC9B,MAAM,CAAC,+BAA+B;GACtC,MAAM,CAAC,oBAAoB;GAC5B,CACF;EACD,UAAU,CACR;GACE,KAAK;GACL,OAAO;IAAE,SAAS;IAAa,UAAU;IAAG,gBAAgB;IAAW;GACvE,QAAQ;IAAE,UAAU;IAAM,cAAc;IAAK;GAC9C,CACF;EACF;CACF,CAAC;;;;AAKF,MAAa,0BAA0B,YAAY;CACjD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAQ;GAAW;GAAQ;EAClC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ,EACN,MAAM,QACP;CACD,YAAY;EACV,WAAW,CACT;GACE,KAAK;GACL,OAAO,CAAC,iCAAiC;GACzC,MAAM,CAAC,8BAA8B;GACrC,MAAM,CAAC,6BAA6B;GACrC,CACF;EACD,UAAU,CACR;GACE,KAAK;GACL,OAAO,EAAE,QAAQ,WAAW;GAC5B,QAAQ,EAAE,UAAU,CAAC;IAAE,MAAM;IAAa,MAAM;IAAK,OAAO;IAAM,CAAC,EAAE;GACtE,CACF;EACF;CACF,CAAC;;;;AAKF,MAAa,6BAA6B,YAAY;CACpD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAQ;GAAW;GAAU;EACpC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ,EACN,MAAM,QACP;CACD,YAAY;EACV,WAAW,CACT;GACE,KAAK;GACL,OAAO,CAAC,8BAA8B;GACtC,MAAM,CAAC,oCAAoC;GAC3C,MAAM,CAAC,oBAAoB;GAC5B,CACF;EACD,UAAU,CACR;GACE,KAAK;GACL,OAAO,EAAE,SAAS,oBAAoB;GACtC,QAAQ;IAAE,WAAW;IAAM,QAAQ;IAAwB;GAC5D,CACF;EACF;CACF,CAAC"}

package/dist/billing/billing.presentation.d.ts

@@ -0,0 +1,15 @@
+import { PresentationSpec } from "@contractspec/lib.contracts";
+
+//#region src/billing/billing.presentation.d.ts
+
+/**
+ * Presentation for subscription overview.
+ */
+declare const SubscriptionPresentation: PresentationSpec;
+/**
+ * Presentation for usage dashboard.
+ */
+declare const UsageDashboardPresentation: PresentationSpec;
+//#endregion
+export { SubscriptionPresentation, UsageDashboardPresentation };
+//# sourceMappingURL=billing.presentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.presentation.d.ts","names":[],"sources":["../../src/billing/billing.presentation.ts"],"sourcesContent":[],"mappings":";;;;;;AAMA;AA4Ba,cA5BA,wBA4B4B,EA5BF,gBAkDtC;;;;cAtBY,4BAA4B"}

package/dist/billing/billing.presentation.js

@@ -0,0 +1,59 @@
+import { StabilityEnum } from "@contractspec/lib.contracts";
+
+//#region src/billing/billing.presentation.ts
+/**
+* Presentation for subscription overview.
+*/
+const SubscriptionPresentation = {
+	meta: {
+		key: "saas.billing.subscription",
+		version: 1,
+		title: "Subscription Status",
+		description: "Subscription status with plan info, limits, and current usage",
+		domain: "saas-boilerplate",
+		owners: ["@saas-team"],
+		tags: ["billing", "subscription"],
+		stability: StabilityEnum.Beta,
+		goal: "View subscription plan and status",
+		context: "Billing section"
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "SubscriptionView"
+	},
+	targets: ["react", "markdown"],
+	policy: { flags: ["saas.billing.enabled"] }
+};
+/**
+* Presentation for usage dashboard.
+*/
+const UsageDashboardPresentation = {
+	meta: {
+		key: "saas.billing.usage",
+		version: 1,
+		title: "Usage Dashboard",
+		description: "Usage metrics and breakdown by resource type",
+		domain: "saas-boilerplate",
+		owners: ["@saas-team"],
+		tags: [
+			"billing",
+			"usage",
+			"metrics"
+		],
+		stability: StabilityEnum.Beta,
+		goal: "Monitor feature usage and limits",
+		context: "Billing section"
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "UsageDashboardView"
+	},
+	targets: ["react", "markdown"],
+	policy: { flags: ["saas.billing.enabled"] }
+};
+
+//#endregion
+export { SubscriptionPresentation, UsageDashboardPresentation };
+//# sourceMappingURL=billing.presentation.js.map

package/dist/billing/billing.presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.presentation.js","names":["SubscriptionPresentation: PresentationSpec","UsageDashboardPresentation: PresentationSpec"],"sources":["../../src/billing/billing.presentation.ts"],"sourcesContent":["import type { PresentationSpec } from '@contractspec/lib.contracts';\nimport { StabilityEnum } from '@contractspec/lib.contracts';\n\n/**\n * Presentation for subscription overview.\n */\nexport const SubscriptionPresentation: PresentationSpec = {\n  meta: {\n    key: 'saas.billing.subscription',\n    version: 1,\n    title: 'Subscription Status',\n    description:\n      'Subscription status with plan info, limits, and current usage',\n    domain: 'saas-boilerplate',\n    owners: ['@saas-team'],\n    tags: ['billing', 'subscription'],\n    stability: StabilityEnum.Beta,\n    goal: 'View subscription plan and status',\n    context: 'Billing section',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'SubscriptionView',\n  },\n  targets: ['react', 'markdown'],\n  policy: {\n    flags: ['saas.billing.enabled'],\n  },\n};\n\n/**\n * Presentation for usage dashboard.\n */\nexport const UsageDashboardPresentation: PresentationSpec = {\n  meta: {\n    key: 'saas.billing.usage',\n    version: 1,\n    title: 'Usage Dashboard',\n    description: 'Usage metrics and breakdown by resource type',\n    domain: 'saas-boilerplate',\n    owners: ['@saas-team'],\n    tags: ['billing', 'usage', 'metrics'],\n    stability: StabilityEnum.Beta,\n    goal: 'Monitor feature usage and limits',\n    context: 'Billing section',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'UsageDashboardView',\n  },\n  targets: ['react', 'markdown'],\n  policy: {\n    flags: ['saas.billing.enabled'],\n  },\n};\n"],"mappings":";;;;;;AAMA,MAAaA,2BAA6C;CACxD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,aAAa;EACtB,MAAM,CAAC,WAAW,eAAe;EACjC,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,SAAS,WAAW;CAC9B,QAAQ,EACN,OAAO,CAAC,uBAAuB,EAChC;CACF;;;;AAKD,MAAaC,6BAA+C;CAC1D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,aAAa;EACtB,MAAM;GAAC;GAAW;GAAS;GAAU;EACrC,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,SAAS,WAAW;CAC9B,QAAQ,EACN,OAAO,CAAC,uBAAuB,EAChC;CACF"}

package/dist/billing/billing.schema.d.ts

@@ -0,0 +1,201 @@
+import * as _contractspec_lib_schema101 from "@contractspec/lib.schema";
+
+//#region src/billing/billing.schema.d.ts
+/**
+ * Organization subscription details schema.
+ */
+declare const SubscriptionModel: _contractspec_lib_schema101.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: false;
+  };
+  organizationId: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: false;
+  };
+  planId: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: false;
+  };
+  planName: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema101.EnumType<[string, string, string, string, string]>;
+    isOptional: false;
+  };
+  currentPeriodStart: {
+    type: _contractspec_lib_schema101.FieldType<Date, string>;
+    isOptional: false;
+  };
+  currentPeriodEnd: {
+    type: _contractspec_lib_schema101.FieldType<Date, string>;
+    isOptional: false;
+  };
+  trialEndsAt: {
+    type: _contractspec_lib_schema101.FieldType<Date, string>;
+    isOptional: true;
+  };
+  cancelAtPeriodEnd: {
+    type: _contractspec_lib_schema101.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+}>;
+/**
+ * Usage summary for a feature schema.
+ */
+declare const UsageSummaryModel: _contractspec_lib_schema101.SchemaModel<{
+  feature: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: false;
+  };
+  used: {
+    type: _contractspec_lib_schema101.FieldType<number, number>;
+    isOptional: false;
+  };
+  limit: {
+    type: _contractspec_lib_schema101.FieldType<number, number>;
+    isOptional: true;
+  };
+  unit: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: true;
+  };
+  percentage: {
+    type: _contractspec_lib_schema101.FieldType<number, number>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Input for recording feature usage.
+ */
+declare const RecordUsageInputModel: _contractspec_lib_schema101.SchemaModel<{
+  feature: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: false;
+  };
+  quantity: {
+    type: _contractspec_lib_schema101.FieldType<number, number>;
+    isOptional: false;
+  };
+  sourceId: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: true;
+  };
+  sourceType: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: true;
+  };
+  metadata: {
+    type: _contractspec_lib_schema101.FieldType<Record<string, unknown>, Record<string, unknown>>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Output for recording feature usage.
+ */
+declare const RecordUsageOutputModel: _contractspec_lib_schema101.SchemaModel<{
+  recorded: {
+    type: _contractspec_lib_schema101.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  currentUsage: {
+    type: _contractspec_lib_schema101.FieldType<number, number>;
+    isOptional: false;
+  };
+  limit: {
+    type: _contractspec_lib_schema101.FieldType<number, number>;
+    isOptional: true;
+  };
+  limitReached: {
+    type: _contractspec_lib_schema101.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+}>;
+/**
+ * Payload for usage.recorded event.
+ */
+declare const UsageRecordedPayloadModel: _contractspec_lib_schema101.SchemaModel<{
+  feature: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: false;
+  };
+  quantity: {
+    type: _contractspec_lib_schema101.FieldType<number, number>;
+    isOptional: false;
+  };
+}>;
+/**
+ * Input for getting usage summary.
+ */
+declare const GetUsageSummaryInputModel: _contractspec_lib_schema101.SchemaModel<{
+  billingPeriod: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: true;
+  };
+}>;
+/**
+ * Output for usage summary.
+ */
+declare const GetUsageSummaryOutputModel: _contractspec_lib_schema101.SchemaModel<{
+  billingPeriod: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: false;
+  };
+  usage: {
+    type: _contractspec_lib_schema101.SchemaModel<{
+      feature: {
+        type: _contractspec_lib_schema101.FieldType<string, string>;
+        isOptional: false;
+      };
+      used: {
+        type: _contractspec_lib_schema101.FieldType<number, number>;
+        isOptional: false;
+      };
+      limit: {
+        type: _contractspec_lib_schema101.FieldType<number, number>;
+        isOptional: true;
+      };
+      unit: {
+        type: _contractspec_lib_schema101.FieldType<string, string>;
+        isOptional: true;
+      };
+      percentage: {
+        type: _contractspec_lib_schema101.FieldType<number, number>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+}>;
+/**
+ * Input for checking feature access.
+ */
+declare const CheckFeatureAccessInputModel: _contractspec_lib_schema101.SchemaModel<{
+  feature: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: false;
+  };
+}>;
+/**
+ * Output for feature access check.
+ */
+declare const CheckFeatureAccessOutputModel: _contractspec_lib_schema101.SchemaModel<{
+  hasAccess: {
+    type: _contractspec_lib_schema101.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  reason: {
+    type: _contractspec_lib_schema101.EnumType<[string, string, string, string]>;
+    isOptional: true;
+  };
+  upgradeUrl: {
+    type: _contractspec_lib_schema101.FieldType<string, string>;
+    isOptional: true;
+  };
+}>;
+//#endregion
+export { CheckFeatureAccessInputModel, CheckFeatureAccessOutputModel, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, RecordUsageInputModel, RecordUsageOutputModel, SubscriptionModel, UsageRecordedPayloadModel, UsageSummaryModel };
+//# sourceMappingURL=billing.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.schema.d.ts","names":[],"sources":["../../src/billing/billing.schema.ts"],"sourcesContent":[],"mappings":";;;;;;AASa,cAAA,iBAiBX,8BAjB4B,WAiB5B,CAAA;EAAA,EAAA,EAAA;UAAA,2BAAA,CAAA;;;;;;;;;;;;IAjB4B,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAsBjB,UAAA,EAAA,KAUX;EAAA,CAAA;;;;;;IAV4B,IAAA,uCAAA,KAAA,EAAA,MAAA,CAAA;IAejB,UAAA,EAAA,KAAA;EAUX,CAAA;;;;;;;;EAVgC,CAAA;EAerB,iBAAA,EAAA;IASX,IAAA,uCAAA,CAAA,OAAA,EAAA,OAAA,CAAA;;;;;;AAKF;AAOE,cAnDW,iBAmDX,8BAnD4B,WAmD5B,CAAA;;UAzCA,2BAAA,CAAA,SAkCoC,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;EAYzB,CAAA;EAWA,IAAA,EAAA;IAUX,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;IAVqC,IAAA,uCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;IAe1B,UAAA,EAAA,IAAA;EAWA,CAAA;EAQX,UAAA,EAAA;;;;CARwC,CAAA;;;;cA9E7B,mDAAqB;;UAUhC,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;cAKW,oDAAsB;;UASjC,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;cAKW,uDAAyB;;UAOpC,2BAAA,CAAA;;;;;;;;;;;cAKW,2BAMX,2BAAA,CANoC;;UAMpC,2BAAA,CAAA;;;;;;;cAKW,wDAA0B;;UAUrC,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAKW,8BAMX,2BAAA,CANuC;;UAMvC,2BAAA,CAAA;;;;;;;cAKW,2DAA6B;;UAQxC,2BAAA,CAAA"}