@contractspec/example.saas-boilerplate 1.56.1 → 1.58.0

package/dist/billing/billing.operations.js

@@ -1,181 +1,279 @@
-import { CheckFeatureAccessInputModel, CheckFeatureAccessOutputModel, GetUsageSummaryInputModel, GetUsageSummaryOutputModel, RecordUsageInputModel, RecordUsageOutputModel, SubscriptionModel, UsageRecordedPayloadModel } from "./billing.schema.js";
-import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
+// @bun
+// src/billing/billing.enum.ts
+import { defineEnum } from "@contractspec/lib.schema";
+var SubscriptionStatusSchemaEnum = defineEnum("SubscriptionStatus", [
+  "TRIALING",
+  "ACTIVE",
+  "PAST_DUE",
+  "CANCELED",
+  "PAUSED"
+]);
+var FeatureAccessReasonEnum = defineEnum("FeatureAccessReason", [
+  "included",
+  "limit_available",
+  "limit_reached",
+  "not_in_plan"
+]);
 
-//#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.0.0",
-		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"
-			}
-		}]
-	}
+// src/billing/billing.schema.ts
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
+var SubscriptionModel = defineSchemaModel({
+  name: "Subscription",
+  description: "Organization subscription details",
+  fields: {
+    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    organizationId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    planId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    planName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    status: { type: SubscriptionStatusSchemaEnum, isOptional: false },
+    currentPeriodStart: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    currentPeriodEnd: { type: ScalarTypeEnum.DateTime(), isOptional: false },
+    trialEndsAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },
+    cancelAtPeriodEnd: { type: ScalarTypeEnum.Boolean(), isOptional: false }
+  }
+});
+var UsageSummaryModel = defineSchemaModel({
+  name: "UsageSummary",
+  description: "Usage summary for a feature",
+  fields: {
+    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    used: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    unit: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    percentage: { type: ScalarTypeEnum.Float_unsecure(), isOptional: true }
+  }
+});
+var RecordUsageInputModel = defineSchemaModel({
+  name: "RecordUsageInput",
+  description: "Input for recording feature usage",
+  fields: {
+    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    quantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    sourceId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    sourceType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+    metadata: { type: ScalarTypeEnum.JSONObject(), isOptional: true }
+  }
+});
+var RecordUsageOutputModel = defineSchemaModel({
+  name: "RecordUsageOutput",
+  description: "Output for recording feature usage",
+  fields: {
+    recorded: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+    currentUsage: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
+    limitReached: { type: ScalarTypeEnum.Boolean(), isOptional: false }
+  }
+});
+var UsageRecordedPayloadModel = defineSchemaModel({
+  name: "UsageRecordedPayload",
+  description: "Payload for usage.recorded event",
+  fields: {
+    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    quantity: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false }
+  }
+});
+var GetUsageSummaryInputModel = defineSchemaModel({
+  name: "GetUsageSummaryInput",
+  description: "Input for getting usage summary",
+  fields: {
+    billingPeriod: { type: ScalarTypeEnum.String_unsecure(), isOptional: true }
+  }
 });
-/**
-* Record feature usage.
-*/
-const RecordUsageContract = defineCommand({
-	meta: {
-		key: "saas.billing.usage.record",
-		version: "1.0.0",
-		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.0.0",
-		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
-			}
-		}]
-	}
+var GetUsageSummaryOutputModel = defineSchemaModel({
+  name: "GetUsageSummaryOutput",
+  description: "Output for usage summary",
+  fields: {
+    billingPeriod: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false
+    },
+    usage: { type: UsageSummaryModel, isArray: true, isOptional: false }
+  }
 });
-/**
-* Get usage summary.
-*/
-const GetUsageSummaryContract = defineQuery({
-	meta: {
-		key: "saas.billing.usage.summary",
-		version: "1.0.0",
-		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
-			}] }
-		}]
-	}
+var CheckFeatureAccessInputModel = defineSchemaModel({
+  name: "CheckFeatureAccessInput",
+  description: "Input for checking feature access",
+  fields: {
+    feature: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
+  }
 });
-/**
-* Check feature access.
-*/
-const CheckFeatureAccessContract = defineQuery({
-	meta: {
-		key: "saas.billing.feature.check",
-		version: "1.0.0",
-		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"
-			}
-		}]
-	}
+var CheckFeatureAccessOutputModel = defineSchemaModel({
+  name: "CheckFeatureAccessOutput",
+  description: "Output for feature access check",
+  fields: {
+    hasAccess: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+    reason: { type: FeatureAccessReasonEnum, isOptional: true },
+    upgradeUrl: { type: ScalarTypeEnum.URL(), isOptional: true }
+  }
 });
 
-//#endregion
-export { CheckFeatureAccessContract, GetSubscriptionContract, GetUsageSummaryContract, RecordUsageContract };
-//# sourceMappingURL=billing.operations.js.map
+// src/billing/billing.operations.ts
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
+var OWNERS = ["@example.saas-boilerplate"];
+var GetSubscriptionContract = defineQuery({
+  meta: {
+    key: "saas.billing.subscription.get",
+    version: "1.0.0",
+    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"
+        }
+      }
+    ]
+  }
+});
+var RecordUsageContract = defineCommand({
+  meta: {
+    key: "saas.billing.usage.record",
+    version: "1.0.0",
+    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.0.0",
+        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 }
+      }
+    ]
+  }
+});
+var GetUsageSummaryContract = defineQuery({
+  meta: {
+    key: "saas.billing.usage.summary",
+    version: "1.0.0",
+    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: 1000 }] }
+      }
+    ]
+  }
+});
+var CheckFeatureAccessContract = defineQuery({
+  meta: {
+    key: "saas.billing.feature.check",
+    version: "1.0.0",
+    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" }
+      }
+    ]
+  }
+});
+export {
+  RecordUsageContract,
+  GetUsageSummaryContract,
+  GetSubscriptionContract,
+  CheckFeatureAccessContract
+};

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"billing.presentation.d.ts","names":[],"sources":["../../src/billing/billing.presentation.ts"],"sourcesContent":[],"mappings":";;;;;;AAKa,cAAA,wBAuBX,EAAA,4BAAA,CAvBmC,gBAuBnC;AAKF;;;cAAa,4BAsBX,4BAAA,CAtBqC"}
+{"version":3,"file":"billing.presentation.d.ts","sourceRoot":"","sources":["../../src/billing/billing.presentation.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,wBAAwB,wDAuBnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B,wDAsBrC,CAAC"}

package/dist/billing/billing.presentation.js

@@ -1,59 +1,53 @@
-import { StabilityEnum, definePresentation } from "@contractspec/lib.contracts";
-
-//#region src/billing/billing.presentation.ts
-/**
-* Presentation for subscription overview.
-*/
-const SubscriptionPresentation = definePresentation({
-	meta: {
-		key: "saas.billing.subscription",
-		version: "1.0.0",
-		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"] }
+// @bun
+// src/billing/billing.presentation.ts
+import { definePresentation, StabilityEnum } from "@contractspec/lib.contracts";
+var SubscriptionPresentation = definePresentation({
+  meta: {
+    key: "saas.billing.subscription",
+    version: "1.0.0",
+    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 = definePresentation({
-	meta: {
-		key: "saas.billing.usage",
-		version: "1.0.0",
-		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"] }
+var UsageDashboardPresentation = definePresentation({
+  meta: {
+    key: "saas.billing.usage",
+    version: "1.0.0",
+    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
+export {
+  UsageDashboardPresentation,
+  SubscriptionPresentation
+};