@happyvertical/smrt-subscriptions 0.57.8 → 0.57.10

package/AGENTS.md

@@ -64,6 +64,27 @@ that reverted to DECIMAL passes every SQLite suite.
   are BIGINT, and hydration rejects values outside JavaScript's safe-integer
   range. Existing PostgreSQL `int4` columns require the explicit widening in #2424.
 
+## Plan versions (#4032)
+
+- `SubscriptionPlan.save()` publishes the next immutable
+  `SubscriptionPlanVersion` when its terms (`PLAN_TERM_FIELDS`) change; the
+  logic lives in `src/plan-versioning.ts`. Versions are append-only,
+  contiguous, and monotonic in `effectiveFrom`.
+- `TenantSubscription.validateBeforeSave()` maintains `planVersionId` via
+  `pinSubscriptionPlanVersion()`: pin at period start, re-pin when
+  `currentPeriodStart` moves, and refuse in-period changes that are not an
+  `isEntitlementUpgrade()` unless `replacePlanVersion({ policy: 'authorized',
+  reason })`. Never relax this to "latest version wins": a paid period must
+  not lose entitlements.
+- The resolver reads the pinned version; a missing or inactive pinned version
+  fails closed. Only unpinned rows on plans without versions fall back to the
+  live plan. `migrateSubscriptionPlanVersions(db)` backfills both.
+- Renewal means the new `currentPeriodStart` is at or after the stored
+  `currentPeriodEnd`; creation and renewal pin the boundary's version, and a
+  caller-named other version needs an authorized replacement.
+- `canceled` subscriptions entitle until `currentPeriodEnd` only with
+  `retainsPaidPeriod`, derived on save from an entitled pre-cancel row.
+
 ## Reseller billing (#3059)
 
 - Billing ownership is consumed from `smrt-tenancy`'s

package/README.md

@@ -55,7 +55,8 @@ subscription and plan.
   their agreed amount for pay-what-you-can, never the suggested amount, and
   skips free plans. External subscriber invoice routing remains host-owned. Pricing
   mode and minimum are immutable after the plan is saved; create a
-  new plan instead (effective-dated transitions are tracked in #4032).
+  new plan instead. Other term changes publish a new plan version (see
+  [Plan versions](#plan-versions-and-paid-periods)).
   Invalid legacy pricing fails only its payer group at period close and reports
   the subscription ID while other payer groups continue. Ordinary subscription
   writes resolve only their own tenant's plans or legacy global plans; trusted
@@ -63,6 +64,8 @@ subscription and plan.
   Entitlement resolution validates plan ownership on both reader and supplied
   context paths; trusted seller-to-child resolution requires explicit system
   context too.
+- `SubscriptionPlanVersion` is an immutable, effective-dated snapshot of a
+  plan's terms; subscriptions pin the version their period paid for.
 - `TenantUsageMetric` is immutable, idempotent usage evidence.
 - `SubscriptionResolver` combines current subscription, plan, and batched usage
   summaries into one entitlement decision.
@@ -87,8 +90,8 @@ pass `null` explicitly for legacy global plans. Update callers from the old
 single-argument signature. Pricing mode and minimum cannot be edited after
 persistence, even before the first subscriber, so a concurrent signup cannot
 observe terms that change mode underneath it. Existing fixed-price edits and
-current-period entitlement versioning remain separate work in #4032; this
-foundation does not provide immutable period snapshots. Concurrent first creates
+current-period entitlement versioning arrived with #4032 (see
+[Plan versions](#plan-versions-and-paid-periods)). Concurrent first creates
 for one `(tenantId, planKey)` use a strict insert: one succeeds and a collision
 fails without changing the winner. Retry by reading the existing plan; a
 sequential create with matching mode/minimum retains natural-key upsert behavior.
@@ -105,6 +108,112 @@ migration so different tenants can reuse a plan key. The script supports SQLite
 and PostgreSQL and refuses DuckDB, whose inline unique constraint needs a
 reviewed table rebuild.
 
+## Plan versions and paid periods
+
+A `SubscriptionPlan` is the stable tier identity, scoped by
+`(tenantId, planKey)`. Its terms — `status`, `priceAmount`, `currency`,
+`billingInterval`, `pricingMode`, `minimumAmount`, `suggestedAmount`,
+feature grants and thresholds — are published as immutable
+`SubscriptionPlanVersion` rows (#4032):
+
+- Saving a plan whose terms differ from its latest version publishes the next
+  version (1, 2, 3 …), effective now. `plan.publishTerms({ effectiveFrom })`
+  schedules a future amendment instead. Versions are append-only (no update,
+  no delete) and monotonic: a version cannot start before the previous one.
+  Re-saving unchanged terms, or changing only `name`/`description`/metadata,
+  publishes nothing.
+- A version is in force from its `effectiveFrom` until the next version's;
+  an instant before the first version resolves to version 1.
+- `TenantSubscription.planVersionId` is the version frozen for the current
+  period (`planVersionPinnedAt`, `planVersionPinReason`, and
+  `planVersionPinNote` audit it). It is maintained on every save:
+  - a new subscription pins the version in force at its period start
+    (`currentPeriodStart ?? startedAt`);
+  - **renewal** — a save whose new `currentPeriodStart` is at or after the
+    stored `currentPeriodEnd` (or, for an open-ended row, after the stored
+    start) — re-pins the version in force at the new boundary, for the plan
+    the row now names. A downgrade or a plan change that removes features is
+    applied this way. Moving the start within a paid period is not a renewal,
+    and a renewal saved before its start date may change the pinned terms
+    only as an upgrade (otherwise save it once the period has started). It
+    pins the version scheduled for its boundary at save time; an amendment
+    published later but effective before that boundary applies from the
+    following renewal (or re-save the renewal after the period starts).
+    Period dates are host/provider-owned: shortening `currentPeriodEnd` ends
+    the paid period;
+  - at creation and renewal the boundary decides the version: naming any
+    other `planVersionId` (for example to grandfather an import) needs an
+    authorized replacement;
+  - within an unchanged period, a different plan or version is accepted only
+    when it is an **upgrade** (`isEntitlementUpgrade()`: every enabled feature
+    stays enabled and no threshold is added, lowered or made stricter), or
+    when the period no longer entitles. Anything else is rejected;
+  - `subscription.replacePlanVersion({ policy: 'authorized', reason })` is the
+    explicit, audited escape hatch for an approved in-period downgrade or
+    correction. `policy: 'upgrade'` applies an amended version of the same
+    plan mid-period when it only adds.
+- **Cancellation** keeps the paid period: a subscription canceled while it
+  entitled (`active`/`trialing` within its period) records
+  `retainsPaidPeriod` and entitles until `currentPeriodEnd`, then resolves
+  nothing. A subscription canceled from `incomplete`, `past_due` or `unpaid`
+  (for example a provider's `incomplete_expired`) entitles nothing. For an
+  immediate cancellation of a paid period (e.g. with a refund) set
+  `currentPeriodEnd` to the cancellation time.
+
+`SubscriptionResolver` resolves entitlements at `options.now` from the pinned
+version, not the live plan: editing, archiving, or removing a feature from a
+plan never changes a paid period. A pinned version that cannot be found, or
+whose status is not `active`, fails closed. `EntitlementResolution` reports
+`planVersionId` and `planVersion`; `EntitlementResolutionContext` carries
+`planVersion`, validated against the subscription's plan, pin and tenant like
+`plan`. Resolvers built from custom readers without `planVersions` keep the
+live-plan behavior.
+
+```ts
+// A co-op removes a perk. Paying members keep it until their renewal.
+plan.setFeatureGrants(['coop:vote']);
+await plan.save(); // publishes version 2, effective now
+
+// Schedule an entitlement change from a future date.
+plan.setFeatureGrants(['coop:vote', 'coop:shift-swap']);
+await plan.publishTerms({ effectiveFrom: new Date('2027-01-01T00:00:00Z') });
+
+// Resolve what a member is entitled to at an instant.
+const result = await resolver.resolveEntitlements(subscriber, { now });
+result.planVersion; // the version their current period paid for
+```
+
+The plan row always shows the latest published terms, including a scheduled
+version's. Hosts that charge from the plan row must price from the pinned
+version instead; commerce period-close still reads the live row until #4146,
+so do not schedule a price change ahead of time while relying on it.
+
+The plan row is written before its version. If publishing fails, the save
+rejects with the row already updated and the next save publishes the missing
+version; wrap the save in `plan.withTransaction()` when both writes must be
+atomic.
+
+### Migrating existing data
+
+1. Run the ordinary manifest migration (`smrt db:migrate`). It adds the
+   `_smrt_subscription_plan_versions` table and the nullable `plan_version_id`,
+   `plan_version_pinned_at`, `plan_version_pin_reason` and
+   `plan_version_pin_note` and `retains_paid_period` columns on
+   `_smrt_tenant_subscriptions`. Nothing is dropped or rewritten. Existing
+   `canceled` rows default to `retains_paid_period = false`, so they stay
+   unentitled exactly as before.
+2. Run `migrateSubscriptionPlanVersions(db)` once. Every plan without versions
+   gets version 1 — its current terms, effective from the plan's creation —
+   and every unpinned subscription is pinned to it with
+   `planVersionPinReason: 'migration'`. Entitlements are unchanged. The run is
+   idempotent, works across tenants in system context, and reports any
+   subscription it could not re-save in `failed` (that row keeps resolving
+   through version 1).
+
+Until step 2, unpinned subscriptions to plans without versions keep resolving
+from the live plan, and the first edit of such a plan records its pre-edit
+terms as version 1 before publishing the change.
+
 ## Thresholds and spending
 
 Thresholds define a metric key, time window, limit, and enforcement behavior.

package/dist/chunks/SubscriptionPlanCollection-CqlYYtPg.js

@@ -0,0 +1,229 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { f as normalizeFeatureGrants, g as stringifyJson, h as parseJsonObject, m as parseJsonArray, r as extractPlanTerms } from "./plan-terms-BoeXvDhs.js";
+import { SmrtCollection, SmrtObject, smrt } from "@happyvertical/smrt-core";
+import { TenantScoped, getTenantId, tenantId } from "@happyvertical/smrt-tenancy";
+//#region src/models/SubscriptionPlan.ts
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp(target, key, result);
+	return result;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var requestedEffectiveFrom = /* @__PURE__ */ new WeakMap();
+var priorTerms = /* @__PURE__ */ new WeakMap();
+var publishedVersions = /* @__PURE__ */ new WeakMap();
+var SubscriptionPlan = class extends SmrtObject {
+	tenantId = null;
+	planKey = "";
+	name = "";
+	description = "";
+	status = "active";
+	sortOrder = 0;
+	/**
+	* Plan price in **integer minor units** of {@link currency} — `$19.99` is
+	* `1999`. The `= 0` initializer is load-bearing: SMRT maps an integer literal
+	* to INTEGER and a decimal literal to DECIMAL, and money is exact (#2401).
+	*/
+	priceAmount = 0;
+	currency = "USD";
+	billingInterval = "month";
+	pricingMode = "fixed";
+	minimumAmount = 0;
+	suggestedAmount = 0;
+	/** Optional provider binding; plan semantics never require a provider. */
+	externalProvider = null;
+	providerProductId = null;
+	providerPriceId = null;
+	/** @deprecated Use providerProductId. */
+	stripeProductId = null;
+	/** @deprecated Use providerPriceId. */
+	stripePriceId = null;
+	features = "[]";
+	thresholds = "[]";
+	metadata = "{}";
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.planKey !== void 0) this.planKey = options.planKey;
+		if (options.name !== void 0) this.name = options.name;
+		if (options.description !== void 0) this.description = options.description;
+		if (options.status !== void 0) this.status = options.status;
+		if (options.sortOrder !== void 0) this.sortOrder = options.sortOrder;
+		if (options.priceAmount !== void 0) this.priceAmount = options.priceAmount;
+		if (options.currency !== void 0) this.currency = options.currency;
+		if (options.billingInterval !== void 0) this.billingInterval = options.billingInterval;
+		if (options.externalProvider !== void 0) this.externalProvider = options.externalProvider;
+		if (options.pricingMode !== void 0) this.pricingMode = options.pricingMode;
+		if (options.minimumAmount !== void 0) this.minimumAmount = options.minimumAmount;
+		if (options.suggestedAmount !== void 0) this.suggestedAmount = options.suggestedAmount;
+		if (options.providerProductId !== void 0) this.providerProductId = options.providerProductId;
+		if (options.providerPriceId !== void 0) this.providerPriceId = options.providerPriceId;
+		if (options.stripeProductId !== void 0) this.stripeProductId = options.stripeProductId;
+		if (options.stripePriceId !== void 0) this.stripePriceId = options.stripePriceId;
+		if (options.features !== void 0) this.features = options.features;
+		if (options.thresholds !== void 0) this.thresholds = options.thresholds;
+		if (options.metadata !== void 0) this.metadata = options.metadata;
+	}
+	isActive() {
+		return this.status === "active";
+	}
+	/** The versioned terms currently on this row (the latest published). */
+	getTerms() {
+		return extractPlanTerms(this);
+	}
+	/**
+	* Persist this plan. When its terms (status, price, pricing configuration,
+	* feature grants or thresholds) differ from the latest published version —
+	* or no version exists yet — the save then publishes the next immutable
+	* {@link SubscriptionPlanVersion}, effective now (#4032). Use
+	* {@link publishTerms} to choose a different effective date. Subscribers
+	* keep the version pinned for their current period; the new terms apply
+	* from their next renewal.
+	*
+	* A plan saved before versioning existed first records its pre-edit terms
+	* as version 1, effective from its creation, so subscriptions sold under
+	* them are not re-priced.
+	*
+	* The row is written before the version. If publishing fails the save
+	* rejects with the row already updated; saving again publishes the
+	* missing version. Wrap the call in `plan.withTransaction()` when the
+	* adapter supports transactions and the two writes must be atomic.
+	*/
+	async save(options) {
+		const effectiveFrom = requestedEffectiveFrom.get(this) ?? /* @__PURE__ */ new Date();
+		requestedEffectiveFrom.delete(this);
+		await super.save(options);
+		const { publishPlanVersion } = await import("./plan-versioning-Bp0NqTJf.js").then((n) => n.n);
+		const prior = priorTerms.get(this);
+		priorTerms.delete(this);
+		publishedVersions.set(this, await publishPlanVersion(this, effectiveFrom, prior));
+		return this;
+	}
+	/**
+	* Save this plan and publish its current terms as a version effective at
+	* `effectiveFrom` (default now). A future date schedules an amendment: the
+	* plan row shows the new terms immediately, but subscriptions starting or
+	* renewing before that date pin the earlier version. Versions are
+	* monotonic, so `effectiveFrom` may not precede the latest version's.
+	*
+	* @returns the latest version, which carries the saved terms.
+	*/
+	async publishTerms(options = {}) {
+		if (options.effectiveFrom) requestedEffectiveFrom.set(this, options.effectiveFrom);
+		await this.save();
+		const version = publishedVersions.get(this);
+		if (!version) throw new Error("Plan version was not published");
+		return version;
+	}
+	/** The version of this plan in force at `at` (default now). */
+	async getVersionInForce(at = /* @__PURE__ */ new Date()) {
+		if (!this.id) return null;
+		const { SubscriptionPlanVersionCollection } = await import("./SubscriptionPlanVersionCollection-CV0QPmp0.js").then((n) => n.n);
+		return (await SubscriptionPlanVersionCollection.create({ db: this.db })).findInForce(String(this.id), at);
+	}
+	getFeatureGrants() {
+		return normalizeFeatureGrants(parseJsonArray(this.features));
+	}
+	setFeatureGrants(grants) {
+		this.features = stringifyJson(normalizeFeatureGrants(grants));
+	}
+	getFeatureKeys() {
+		return this.getFeatureGrants().filter((grant) => grant.enabled !== false).map((grant) => grant.featureKey);
+	}
+	getThresholds() {
+		return parseJsonArray(this.thresholds).filter((threshold) => threshold.metricKey);
+	}
+	setThresholds(thresholds) {
+		this.thresholds = stringifyJson(thresholds);
+	}
+	getMetadata() {
+		return parseJsonObject(this.metadata, {});
+	}
+	setMetadata(metadata) {
+		this.metadata = stringifyJson(metadata);
+	}
+	async validateBeforeSave() {
+		await super.validateBeforeSave();
+		const { SubscriptionPlanCollection } = await Promise.resolve().then(() => SubscriptionPlanCollection_exports);
+		const plans = await SubscriptionPlanCollection.create({ db: this.db });
+		const persisted = (this.id ? await plans.get({ id: String(this.id) }, { cache: false }) : null) ?? await plans.findByPlanKey(this.tenantId ?? getTenantId() ?? null, this.planKey);
+		if (!persisted) this.requireInsertOnSave();
+		else priorTerms.set(this, persisted);
+		if (persisted && (persisted.pricingMode !== this.pricingMode || persisted.minimumAmount !== this.minimumAmount)) throw new Error("Create a new plan to change pricing mode or minimum after persistence");
+		if (![
+			"free",
+			"fixed",
+			"pay_what_you_can"
+		].includes(this.pricingMode)) throw new Error("Invalid pricingMode");
+		if (this.pricingMode !== "fixed" && this.priceAmount !== 0) throw new Error("priceAmount must be zero for free and pay_what_you_can plans");
+		for (const [name, value] of [
+			["priceAmount", this.priceAmount],
+			["minimumAmount", this.minimumAmount],
+			["suggestedAmount", this.suggestedAmount]
+		]) if (!Number.isSafeInteger(value) || value < 0) throw new Error(`${name} must be a non-negative integer minor-unit amount`);
+		if (this.pricingMode === "pay_what_you_can" && this.suggestedAmount > 0 && this.suggestedAmount < this.minimumAmount) throw new Error("suggestedAmount must be at least minimumAmount");
+	}
+};
+__publicField(SubscriptionPlan, "__smrtPackage__", "@happyvertical/smrt-subscriptions");
+__decorateClass([tenantId({ nullable: true })], SubscriptionPlan.prototype, "tenantId", 2);
+SubscriptionPlan = __decorateClass([TenantScoped({ mode: "optional" }), smrt({
+	tableName: "_smrt_subscription_plans",
+	api: { include: [
+		"list",
+		"get",
+		"create",
+		"update"
+	] },
+	cli: { skipApiCheck: true },
+	mcp: { include: ["list", "get"] },
+	conflictColumns: ["tenant_id", "plan_key"]
+})], SubscriptionPlan);
+//#endregion
+//#region src/collections/SubscriptionPlanCollection.ts
+var SubscriptionPlanCollection_exports = /* @__PURE__ */ __exportAll({ SubscriptionPlanCollection: () => SubscriptionPlanCollection });
+var SubscriptionPlanCollection = class extends SmrtCollection {
+	static _itemClass = SubscriptionPlan;
+	async findByPlanKey(tenantId, planKey) {
+		return (await this.list({
+			where: {
+				tenantId,
+				planKey
+			},
+			limit: 1
+		}))[0] ?? null;
+	}
+	async findActive() {
+		return this.list({
+			where: { status: "active" },
+			orderBy: "sortOrder ASC"
+		});
+	}
+	async findByProviderPriceId(providerPriceId) {
+		const plans = await this.list({
+			where: { providerPriceId },
+			limit: 1
+		});
+		if (plans[0]) return plans[0];
+		return (await this.list({ where: { stripePriceId: providerPriceId } })).find((plan) => !plan.externalProvider || plan.externalProvider === "stripe") ?? null;
+	}
+	/** @deprecated Provider-neutral integrations should use findByProviderPriceId. */
+	async findByStripePriceId(stripePriceId) {
+		return (await this.list({
+			where: { stripePriceId },
+			limit: 1
+		}))[0] ?? null;
+	}
+};
+//#endregion
+export { SubscriptionPlanCollection_exports as n, SubscriptionPlan as r, SubscriptionPlanCollection as t };
+
+//# sourceMappingURL=SubscriptionPlanCollection-CqlYYtPg.js.map

package/dist/chunks/SubscriptionPlanCollection-CqlYYtPg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscriptionPlanCollection-CqlYYtPg.js","names":[],"sources":["../../src/models/SubscriptionPlan.ts","../../src/collections/SubscriptionPlanCollection.ts"],"sourcesContent":["import {\n  SmrtObject,\n  type SmrtSaveOptions,\n  smrt,\n} from '@happyvertical/smrt-core';\nimport {\n  getTenantId,\n  TenantScoped,\n  tenantId,\n} from '@happyvertical/smrt-tenancy';\nimport { extractPlanTerms } from '../plan-terms.js';\nimport type {\n  BillingInterval,\n  JsonObject,\n  PlanFeatureGrant,\n  PlanTerms,\n  PlanThreshold,\n  PricingMode,\n  SubscriptionPlanOptions,\n  SubscriptionPlanStatus,\n} from '../types.js';\nimport {\n  normalizeFeatureGrants,\n  parseJsonArray,\n  parseJsonObject,\n  stringifyJson,\n} from '../utils.js';\nimport type { SubscriptionPlanVersion } from './SubscriptionPlanVersion.js';\n\n/** Effective date requested by {@link SubscriptionPlan.publishTerms}. */\nconst requestedEffectiveFrom = new WeakMap<SubscriptionPlan, Date>();\n/** The persisted row a save is about to overwrite, read during validation. */\nconst priorTerms = new WeakMap<SubscriptionPlan, SubscriptionPlan>();\n/** The latest version after the most recent save. */\nconst publishedVersions = new WeakMap<\n  SubscriptionPlan,\n  SubscriptionPlanVersion\n>();\n\n@TenantScoped({ mode: 'optional' })\n@smrt({\n  tableName: '_smrt_subscription_plans',\n  api: { include: ['list', 'get', 'create', 'update'] },\n  cli: { skipApiCheck: true },\n  mcp: { include: ['list', 'get'] },\n  conflictColumns: ['tenant_id', 'plan_key'],\n})\nexport class SubscriptionPlan extends SmrtObject implements PlanTerms { static __smrtPackage__ = \"@happyvertical/smrt-subscriptions\";\n  @tenantId({ nullable: true })\n  tenantId: string | null = null;\n\n  planKey: string = '';\n  name: string = '';\n  description: string = '';\n  status: SubscriptionPlanStatus = 'active';\n  sortOrder: number = 0;\n  /**\n   * Plan price in **integer minor units** of {@link currency} — `$19.99` is\n   * `1999`. The `= 0` initializer is load-bearing: SMRT maps an integer literal\n   * to INTEGER and a decimal literal to DECIMAL, and money is exact (#2401).\n   */\n  priceAmount: number = 0;\n  currency: string = 'USD';\n  billingInterval: BillingInterval = 'month';\n  pricingMode: PricingMode = 'fixed';\n  minimumAmount: number = 0;\n  suggestedAmount: number = 0;\n  /** Optional provider binding; plan semantics never require a provider. */\n  externalProvider: string | null = null;\n  providerProductId: string | null = null;\n  providerPriceId: string | null = null;\n  /** @deprecated Use providerProductId. */\n  stripeProductId: string | null = null;\n  /** @deprecated Use providerPriceId. */\n  stripePriceId: string | null = null;\n  features: string = '[]';\n  thresholds: string = '[]';\n  metadata: string = '{}';\n\n  constructor(options: SubscriptionPlanOptions = {}) {\n    super(options);\n    if (options.tenantId !== undefined) this.tenantId = options.tenantId;\n    if (options.planKey !== undefined) this.planKey = options.planKey;\n    if (options.name !== undefined) this.name = options.name;\n    if (options.description !== undefined)\n      this.description = options.description;\n    if (options.status !== undefined) this.status = options.status;\n    if (options.sortOrder !== undefined) this.sortOrder = options.sortOrder;\n    if (options.priceAmount !== undefined)\n      this.priceAmount = options.priceAmount;\n    if (options.currency !== undefined) this.currency = options.currency;\n    if (options.billingInterval !== undefined) {\n      this.billingInterval = options.billingInterval;\n    }\n    if (options.externalProvider !== undefined) {\n      this.externalProvider = options.externalProvider;\n    }\n    if (options.pricingMode !== undefined)\n      this.pricingMode = options.pricingMode;\n    if (options.minimumAmount !== undefined)\n      this.minimumAmount = options.minimumAmount;\n    if (options.suggestedAmount !== undefined)\n      this.suggestedAmount = options.suggestedAmount;\n    if (options.providerProductId !== undefined) {\n      this.providerProductId = options.providerProductId;\n    }\n    if (options.providerPriceId !== undefined) {\n      this.providerPriceId = options.providerPriceId;\n    }\n    if (options.stripeProductId !== undefined) {\n      this.stripeProductId = options.stripeProductId;\n    }\n    if (options.stripePriceId !== undefined) {\n      this.stripePriceId = options.stripePriceId;\n    }\n    if (options.features !== undefined) this.features = options.features;\n    if (options.thresholds !== undefined) this.thresholds = options.thresholds;\n    if (options.metadata !== undefined) this.metadata = options.metadata;\n  }\n\n  isActive(): boolean {\n    return this.status === 'active';\n  }\n\n  /** The versioned terms currently on this row (the latest published). */\n  getTerms(): PlanTerms {\n    return extractPlanTerms(this);\n  }\n\n  /**\n   * Persist this plan. When its terms (status, price, pricing configuration,\n   * feature grants or thresholds) differ from the latest published version —\n   * or no version exists yet — the save then publishes the next immutable\n   * {@link SubscriptionPlanVersion}, effective now (#4032). Use\n   * {@link publishTerms} to choose a different effective date. Subscribers\n   * keep the version pinned for their current period; the new terms apply\n   * from their next renewal.\n   *\n   * A plan saved before versioning existed first records its pre-edit terms\n   * as version 1, effective from its creation, so subscriptions sold under\n   * them are not re-priced.\n   *\n   * The row is written before the version. If publishing fails the save\n   * rejects with the row already updated; saving again publishes the\n   * missing version. Wrap the call in `plan.withTransaction()` when the\n   * adapter supports transactions and the two writes must be atomic.\n   */\n  override async save(options?: SmrtSaveOptions): Promise<this> {\n    const effectiveFrom = requestedEffectiveFrom.get(this) ?? new Date();\n    requestedEffectiveFrom.delete(this);\n    await super.save(options);\n    const { publishPlanVersion } = await import('../plan-versioning.js');\n    const prior = priorTerms.get(this);\n    priorTerms.delete(this);\n    publishedVersions.set(\n      this,\n      await publishPlanVersion(this, effectiveFrom, prior),\n    );\n    return this;\n  }\n\n  /**\n   * Save this plan and publish its current terms as a version effective at\n   * `effectiveFrom` (default now). A future date schedules an amendment: the\n   * plan row shows the new terms immediately, but subscriptions starting or\n   * renewing before that date pin the earlier version. Versions are\n   * monotonic, so `effectiveFrom` may not precede the latest version's.\n   *\n   * @returns the latest version, which carries the saved terms.\n   */\n  async publishTerms(\n    options: { effectiveFrom?: Date } = {},\n  ): Promise<SubscriptionPlanVersion> {\n    if (options.effectiveFrom) {\n      requestedEffectiveFrom.set(this, options.effectiveFrom);\n    }\n    await this.save();\n    const version = publishedVersions.get(this);\n    if (!version) throw new Error('Plan version was not published');\n    return version;\n  }\n\n  /** The version of this plan in force at `at` (default now). */\n  async getVersionInForce(\n    at = new Date(),\n  ): Promise<SubscriptionPlanVersion | null> {\n    if (!this.id) return null;\n    const { SubscriptionPlanVersionCollection } = await import(\n      '../collections/SubscriptionPlanVersionCollection.js'\n    );\n    const versions = await SubscriptionPlanVersionCollection.create({\n      db: this.db,\n    });\n    return versions.findInForce(String(this.id), at);\n  }\n\n  getFeatureGrants(): PlanFeatureGrant[] {\n    return normalizeFeatureGrants(\n      parseJsonArray<string | PlanFeatureGrant>(this.features),\n    );\n  }\n\n  setFeatureGrants(grants: Array<string | PlanFeatureGrant>): void {\n    this.features = stringifyJson(normalizeFeatureGrants(grants));\n  }\n\n  getFeatureKeys(): string[] {\n    return this.getFeatureGrants()\n      .filter((grant) => grant.enabled !== false)\n      .map((grant) => grant.featureKey);\n  }\n\n  getThresholds(): PlanThreshold[] {\n    return parseJsonArray<PlanThreshold>(this.thresholds).filter(\n      (threshold) => threshold.metricKey,\n    );\n  }\n\n  setThresholds(thresholds: PlanThreshold[]): void {\n    this.thresholds = stringifyJson(thresholds);\n  }\n\n  getMetadata(): JsonObject {\n    return parseJsonObject(this.metadata, {});\n  }\n\n  setMetadata(metadata: JsonObject): void {\n    this.metadata = stringifyJson(metadata);\n  }\n\n  protected async validateBeforeSave(): Promise<void> {\n    await super.validateBeforeSave();\n    const { SubscriptionPlanCollection } = await import(\n      '../collections/SubscriptionPlanCollection.js'\n    );\n    const plans = await SubscriptionPlanCollection.create({ db: this.db });\n    const persisted =\n      (this.id\n        ? await plans.get({ id: String(this.id) }, { cache: false })\n        : null) ??\n      (await plans.findByPlanKey(\n        this.tenantId ?? getTenantId() ?? null,\n        this.planKey,\n      ));\n    // A concurrently created natural-key row must never be adopted after this\n    // validation: its pricing terms may differ from the terms checked here.\n    if (!persisted) this.requireInsertOnSave();\n    else priorTerms.set(this, persisted);\n    if (\n      persisted &&\n      (persisted.pricingMode !== this.pricingMode ||\n        persisted.minimumAmount !== this.minimumAmount)\n    ) {\n      throw new Error(\n        'Create a new plan to change pricing mode or minimum after persistence',\n      );\n    }\n    if (!['free', 'fixed', 'pay_what_you_can'].includes(this.pricingMode)) {\n      throw new Error('Invalid pricingMode');\n    }\n    if (this.pricingMode !== 'fixed' && this.priceAmount !== 0) {\n      throw new Error(\n        'priceAmount must be zero for free and pay_what_you_can plans',\n      );\n    }\n    for (const [name, value] of [\n      ['priceAmount', this.priceAmount],\n      ['minimumAmount', this.minimumAmount],\n      ['suggestedAmount', this.suggestedAmount],\n    ] as const) {\n      if (!Number.isSafeInteger(value) || value < 0) {\n        throw new Error(\n          `${name} must be a non-negative integer minor-unit amount`,\n        );\n      }\n    }\n    if (\n      this.pricingMode === 'pay_what_you_can' &&\n      this.suggestedAmount > 0 &&\n      this.suggestedAmount < this.minimumAmount\n    ) {\n      throw new Error('suggestedAmount must be at least minimumAmount');\n    }\n  }\n}\n\nexport default SubscriptionPlan;\n","import { SmrtCollection } from '@happyvertical/smrt-core';\nimport { SubscriptionPlan } from '../models/SubscriptionPlan.js';\n\nexport class SubscriptionPlanCollection extends SmrtCollection<SubscriptionPlan> {\n  static readonly _itemClass = SubscriptionPlan;\n\n  async findByPlanKey(\n    tenantId: string | null,\n    planKey: string,\n  ): Promise<SubscriptionPlan | null> {\n    const plans = await this.list({ where: { tenantId, planKey }, limit: 1 });\n    return plans[0] ?? null;\n  }\n\n  async findActive(): Promise<SubscriptionPlan[]> {\n    return this.list({\n      where: { status: 'active' },\n      orderBy: 'sortOrder ASC',\n    });\n  }\n\n  async findByProviderPriceId(\n    providerPriceId: string,\n  ): Promise<SubscriptionPlan | null> {\n    const plans = await this.list({ where: { providerPriceId }, limit: 1 });\n    if (plans[0]) return plans[0];\n    const legacy = await this.list({\n      where: { stripePriceId: providerPriceId },\n    });\n    return (\n      legacy.find(\n        (plan) => !plan.externalProvider || plan.externalProvider === 'stripe',\n      ) ?? null\n    );\n  }\n\n  /** @deprecated Provider-neutral integrations should use findByProviderPriceId. */\n  async findByStripePriceId(\n    stripePriceId: string,\n  ): Promise<SubscriptionPlan | null> {\n    const plans = await this.list({ where: { stripePriceId }, limit: 1 });\n    return plans[0] ?? null;\n  }\n}\n"],"mappings":"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"}

package/dist/chunks/SubscriptionPlanVersionCollection-CV0QPmp0.js

@@ -0,0 +1,193 @@
+import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.js";
+import { f as normalizeFeatureGrants, m as parseJsonArray, n as enabledFeatureKeys, o as validThresholds, r as extractPlanTerms } from "./plan-terms-BoeXvDhs.js";
+import { SmrtCollection, SmrtObject, foreignKey, smrt } from "@happyvertical/smrt-core";
+import { TenantScoped, getTenantId, isSystemContext, tenantId, withSystemContext } from "@happyvertical/smrt-tenancy";
+//#region src/models/SubscriptionPlanVersion.ts
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, {
+	enumerable: true,
+	configurable: true,
+	writable: true,
+	value
+}) : obj[key] = value;
+var __decorateClass = (decorators, target, key, kind) => {
+	var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+	for (var i = decorators.length - 1, decorator; i >= 0; i--) if (decorator = decorators[i]) result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+	if (kind && result) __defProp(target, key, result);
+	return result;
+};
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+var PRICING_MODES = [
+	"free",
+	"fixed",
+	"pay_what_you_can"
+];
+var SubscriptionPlanVersion = class extends SmrtObject {
+	tenantId = null;
+	planId = "";
+	/** The plan's natural key, copied for auditing and resolution output. */
+	planKey = "";
+	/** 1-based sequence within the plan; contiguous and monotonic. */
+	version = 0;
+	/** Start of this version's effective interval. */
+	effectiveFrom = /* @__PURE__ */ new Date();
+	/** Plan name when this version was published (display only). */
+	name = "";
+	status = "active";
+	/** Integer minor units of {@link currency}. */
+	priceAmount = 0;
+	currency = "USD";
+	billingInterval = "month";
+	pricingMode = "fixed";
+	/** Integer minor units. */
+	minimumAmount = 0;
+	/** Integer minor units. */
+	suggestedAmount = 0;
+	features = "[]";
+	thresholds = "[]";
+	constructor(options = {}) {
+		super(options);
+		if (options.tenantId !== void 0) this.tenantId = options.tenantId;
+		if (options.planId !== void 0) this.planId = options.planId;
+		if (options.planKey !== void 0) this.planKey = options.planKey;
+		if (options.version !== void 0) this.version = options.version;
+		if (options.effectiveFrom !== void 0) this.effectiveFrom = options.effectiveFrom;
+		if (options.name !== void 0) this.name = options.name;
+		if (options.status !== void 0) this.status = options.status;
+		if (options.priceAmount !== void 0) this.priceAmount = options.priceAmount;
+		if (options.currency !== void 0) this.currency = options.currency;
+		if (options.billingInterval !== void 0) this.billingInterval = options.billingInterval;
+		if (options.pricingMode !== void 0) this.pricingMode = options.pricingMode;
+		if (options.minimumAmount !== void 0) this.minimumAmount = options.minimumAmount;
+		if (options.suggestedAmount !== void 0) this.suggestedAmount = options.suggestedAmount;
+		if (options.features !== void 0) this.features = options.features;
+		if (options.thresholds !== void 0) this.thresholds = options.thresholds;
+	}
+	isActive() {
+		return this.status === "active";
+	}
+	getTerms() {
+		return extractPlanTerms(this);
+	}
+	getFeatureGrants() {
+		return normalizeFeatureGrants(parseJsonArray(this.features));
+	}
+	getFeatureKeys() {
+		return enabledFeatureKeys(this);
+	}
+	getThresholds() {
+		return validThresholds(this);
+	}
+	/** Append-only: a version is corrected by publishing the next one. */
+	refuseDelete() {
+		throw new Error("Subscription plan versions are append-only; publish a new version instead of deleting.");
+	}
+	async validateBeforeSave() {
+		await super.validateBeforeSave();
+		if (this.isPersisted) throw new Error("Subscription plan versions are immutable; publish a new version instead.");
+		this.requireInsertOnSave();
+		if (!Number.isSafeInteger(this.version) || this.version < 1) throw new Error("Plan version must be a positive integer");
+		if (!(this.effectiveFrom instanceof Date) || Number.isNaN(this.effectiveFrom.getTime())) throw new Error("Plan version effectiveFrom must be a valid date");
+		if (!PRICING_MODES.includes(this.pricingMode)) throw new Error("Invalid pricingMode");
+		for (const [name, value] of [
+			["priceAmount", this.priceAmount],
+			["minimumAmount", this.minimumAmount],
+			["suggestedAmount", this.suggestedAmount]
+		]) if (!Number.isSafeInteger(value) || value < 0) throw new Error(`${name} must be a non-negative integer minor-unit amount`);
+		const { SubscriptionPlanCollection } = await import("./SubscriptionPlanCollection-CqlYYtPg.js").then((n) => n.n);
+		const { SubscriptionPlanVersionCollection } = await Promise.resolve().then(() => SubscriptionPlanVersionCollection_exports);
+		const owner = this.tenantId ?? null;
+		const [plan, latest] = await withSystemContext(async () => {
+			const plans = await SubscriptionPlanCollection.create({ db: this.db });
+			const versions = await SubscriptionPlanVersionCollection.create({ db: this.db });
+			return Promise.all([plans.get({
+				id: this.planId,
+				tenantId: owner
+			}, { cache: false }), versions.findLatest(this.planId, owner)]);
+		});
+		if (!plan || plan.planKey !== this.planKey) throw new Error("Plan version must belong to an existing plan");
+		const expected = (latest?.version ?? 0) + 1;
+		if (this.version !== expected) throw new Error(`Next version of plan ${plan.planKey} is ${expected}`);
+		if (latest && this.effectiveFrom.getTime() < latest.effectiveFrom.getTime()) throw new Error(`Plan ${plan.planKey} version ${latest.version} is effective from ${latest.effectiveFrom.toISOString()}; a later version cannot start earlier`);
+	}
+};
+__publicField(SubscriptionPlanVersion, "__smrtPackage__", "@happyvertical/smrt-subscriptions");
+__decorateClass([tenantId({ nullable: true })], SubscriptionPlanVersion.prototype, "tenantId", 2);
+__decorateClass([foreignKey("SubscriptionPlan")], SubscriptionPlanVersion.prototype, "planId", 2);
+SubscriptionPlanVersion = __decorateClass([TenantScoped({ mode: "optional" }), smrt({
+	tableName: "_smrt_subscription_plan_versions",
+	api: { include: ["list", "get"] },
+	cli: { include: ["list", "get"] },
+	mcp: { include: ["list", "get"] },
+	conflictColumns: ["plan_id", "version"],
+	hooks: { beforeDelete: "refuseDelete" }
+})], SubscriptionPlanVersion);
+//#endregion
+//#region src/collections/SubscriptionPlanVersionCollection.ts
+var SubscriptionPlanVersionCollection_exports = /* @__PURE__ */ __exportAll({ SubscriptionPlanVersionCollection: () => SubscriptionPlanVersionCollection });
+var SubscriptionPlanVersionCollection = class extends SmrtCollection {
+	static _itemClass = SubscriptionPlanVersion;
+	/**
+	* One version by id, through the caller's tenancy plus the bounded
+	* fallback to legacy global plans' versions.
+	*/
+	async findVisibleById(id) {
+		return (await this.withGlobalFallback((where) => this.list({
+			where: {
+				...where,
+				id
+			},
+			limit: 1
+		})))[0] ?? null;
+	}
+	/** Every version of a plan, oldest first. */
+	async listForPlan(planId) {
+		return this.withGlobalFallback((where) => this.list({
+			where: {
+				...where,
+				planId
+			},
+			orderBy: "version ASC"
+		}));
+	}
+	/**
+	* The most recently published version of a plan. Pass `tenantId` to name
+	* the owner explicitly (`null` for a global plan); omit it to read through
+	* the caller's tenancy.
+	*/
+	async findLatest(planId, tenantId) {
+		const read = (where) => this.list({
+			where: {
+				...where,
+				planId
+			},
+			orderBy: "version DESC",
+			limit: 1
+		});
+		return (tenantId === void 0 ? await this.withGlobalFallback(read) : await read({ tenantId }))[0] ?? null;
+	}
+	/**
+	* The version of a plan in force at `at`: the latest version whose
+	* `effectiveFrom` is at or before `at`. An instant before the first
+	* version resolves to the first version, so subscriptions that predate
+	* versioning keep the terms they were sold. Returns null only when the plan
+	* has no versions.
+	*/
+	async findInForce(planId, at) {
+		const versions = await this.listForPlan(planId);
+		const time = at.getTime();
+		let inForce = versions[0] ?? null;
+		for (const version of versions) if (version.effectiveFrom.getTime() <= time) inForce = version;
+		return inForce;
+	}
+	async withGlobalFallback(read) {
+		const scoped = await read({});
+		if (scoped.length > 0 || isSystemContext() || !getTenantId()) return scoped;
+		return withSystemContext(() => read({ tenantId: null }));
+	}
+};
+//#endregion
+export { SubscriptionPlanVersionCollection_exports as n, SubscriptionPlanVersion as r, SubscriptionPlanVersionCollection as t };
+
+//# sourceMappingURL=SubscriptionPlanVersionCollection-CV0QPmp0.js.map