@antelopejs/interface-dms-saas 0.5.0 → 0.6.0

package/README.md

@@ -44,7 +44,7 @@ types barrel. After direct subscription writes, call
 [`RecomputeTenantBillingState`](./docs/2.billing.md#recomputetenantbillingstate)
 to refresh derived billing and workspace directory state.
 
-A module may seed plans straight into the `db` plan table: it leaves `Plan.paymentProviderRefs` empty and never rewrites it, since dms-saas links every billed plan to Stripe itself. See [Plans and Stripe](https://dms.antelopejs.com/docs/modules/saas/stripe#plans-and-stripe).
+A module may seed plans straight into the `db` plan table: it writes `name`, `description` and `borderLabel` with one value per locale through `localize("*")`, leaves `Plan.paymentProviderRefs` empty and never rewrites it, since dms-saas links every billed plan to Stripe itself. See [Plans and Stripe](https://dms.antelopejs.com/docs/modules/saas/stripe#plans-and-stripe).
 
 ## Compatibility
 
@@ -55,7 +55,7 @@ The implementation is `@antelopejs/dms-saas >=0.6.0`. The interface declares the
 | Package | Range |
 | --- | --- |
 | `@antelopejs/interface-data-api` | `>=0.2.2 <1.0.0` |
-| `@antelopejs/interface-dms` | `>=0.7.2 <1.0.0` |
+| `@antelopejs/interface-dms` | `>=0.7.4 <1.0.0` |
 
 Peer dependencies:
 

package/dist/billing.d.ts

@@ -2,6 +2,11 @@ export interface ComplimentarySubscriptionState {
     isComplimentary?: boolean | null;
 }
 export declare function isComplimentarySubscription(subscription: ComplimentarySubscriptionState | null | undefined): boolean;
+export interface TenantBillingPeriod {
+    start: Date;
+    end: Date;
+}
+export declare const GetTenantBillingPeriod: (tenantId: string) => Promise<TenantBillingPeriod | null>;
 export interface TenantCustomerBalanceScope {
     tenantId: string;
     userId: string;

package/dist/billing.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RecomputeTenantBillingState = exports.GetUpcomingInvoicePreview = exports.GetTenantCustomerBalance = void 0;
+exports.RecomputeTenantBillingState = exports.GetUpcomingInvoicePreview = exports.GetTenantCustomerBalance = exports.GetTenantBillingPeriod = void 0;
 exports.isComplimentarySubscription = isComplimentarySubscription;
 const interface_core_1 = require("@antelopejs/interface-core");
 function isComplimentarySubscription(subscription) {
     return subscription?.isComplimentary === true;
 }
+exports.GetTenantBillingPeriod = (0, interface_core_1.InterfaceFunction)();
 exports.GetTenantCustomerBalance = (0, interface_core_1.InterfaceFunction)();
 exports.GetUpcomingInvoicePreview = (0, interface_core_1.InterfaceFunction)();
 exports.RecomputeTenantBillingState = (0, interface_core_1.InterfaceFunction)();

package/dist/billing.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing.js","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":";;;AAQA,kEAIC;AAZD,+DAA+D;AAQ/D,SAAgB,2BAA2B,CACzC,YAA+D;IAE/D,OAAO,YAAY,EAAE,eAAe,KAAK,IAAI,CAAC;AAChD,CAAC;AAwCY,QAAA,wBAAwB,GACnC,IAAA,kCAAiB,GAEd,CAAC;AAmIO,QAAA,yBAAyB,GACpC,IAAA,kCAAiB,GAEd,CAAC;AAQO,QAAA,2BAA2B,GACtC,IAAA,kCAAiB,GAAuC,CAAC"}
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../src/billing.ts"],"names":[],"mappings":";;;AAQA,kEAIC;AAZD,+DAA+D;AAQ/D,SAAgB,2BAA2B,CACzC,YAA+D;IAE/D,OAAO,YAAY,EAAE,eAAe,KAAK,IAAI,CAAC;AAChD,CAAC;AAgBY,QAAA,sBAAsB,GACjC,IAAA,kCAAiB,GAEd,CAAC;AAwCO,QAAA,wBAAwB,GACnC,IAAA,kCAAiB,GAEd,CAAC;AAmIO,QAAA,yBAAyB,GACpC,IAAA,kCAAiB,GAEd,CAAC;AAQO,QAAA,2BAA2B,GACtC,IAAA,kCAAiB,GAAuC,CAAC"}

package/dist/db/models/plans.model.d.ts

@@ -23,6 +23,9 @@ declare const PlanModel_base: {
     validate(obj: unknown, options?: import("@antelopejs/interface-database-decorators").ValidateInputOptions): import("@antelopejs/interface-database-decorators").ValidationResult;
 };
 export declare class PlanModel extends PlanModel_base {
+    get(id: string): Promise<Plan | undefined>;
+    getBy(index: keyof Plan, ...keys: unknown[]): Promise<Plan[]>;
+    getAll(): Promise<Plan[]>;
     findNotDeleted(): Promise<Plan[]>;
     findActiveNotDeleted(): Promise<Plan[]>;
     findPubliclyVisible(): Promise<Plan[]>;

package/dist/db/models/plans.model.js

@@ -4,22 +4,37 @@ exports.PlanModel = void 0;
 const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
 const plans_table_1 = require("../tables/plans.table");
 const MAX_INHERITANCE_DEPTH = 10;
+function inFallbackLocale(plan) {
+    return plan.localize(plans_table_1.PLAN_FALLBACK_LOCALE, plans_table_1.PLAN_LOCALIZED_FIELDS);
+}
+function readPlans(rows) {
+    return rows
+        .map((row) => PlanModel.fromDatabase(row))
+        .filter((row) => row !== undefined)
+        .map(inFallbackLocale);
+}
 class PlanModel extends (0, interface_database_decorators_1.BasicDataModel)(plans_table_1.Plan, plans_table_1.plansTableName) {
+    async get(id) {
+        const plan = await super.get(id);
+        return plan && inFallbackLocale(plan);
+    }
+    async getBy(index, ...keys) {
+        return (await super.getBy(index, ...keys)).map(inFallbackLocale);
+    }
+    async getAll() {
+        return (await super.getAll()).map(inFallbackLocale);
+    }
     async findNotDeleted() {
         const rows = await this.table
             .filter((row) => row.key("isDeleted").eq(false))
             .run();
-        return rows
-            .map((row) => PlanModel.fromDatabase(row))
-            .filter((row) => row !== undefined);
+        return readPlans(rows);
     }
     async findActiveNotDeleted() {
         const rows = await this.table
             .filter((row) => row.key("isDeleted").eq(false).and(row.key("isActive").eq(true)))
             .run();
-        return rows
-            .map((row) => PlanModel.fromDatabase(row))
-            .filter((row) => row !== undefined);
+        return readPlans(rows);
     }
     async findPubliclyVisible() {
         const rows = await this.table
@@ -29,9 +44,7 @@ class PlanModel extends (0, interface_database_decorators_1.BasicDataModel)(plan
             .and(row.key("isActive").eq(true))
             .and(row.key("isPublic").eq(true)))
             .run();
-        return rows
-            .map((row) => PlanModel.fromDatabase(row))
-            .filter((row) => row !== undefined);
+        return readPlans(rows);
     }
     async resolveInheritanceChain(plan) {
         const visited = new Set();

package/dist/db/models/plans.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"plans.model.js","sourceRoot":"","sources":["../../../src/db/models/plans.model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plans.model.js","sourceRoot":"","sources":["../../../src/db/models/plans.model.ts"],"names":[],"mappings":"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"}

package/dist/db/models/stripeWebhookEvents.model.d.ts

@@ -22,6 +22,7 @@ declare const StripeWebhookEventModel_base: {
 export declare class StripeWebhookEventModel extends StripeWebhookEventModel_base {
     tryClaim(eventId: string, type: string): Promise<string | undefined>;
     markResult(eventId: string, admittedRevision: string, result: WebhookCompletion, errorMessage: string | null): Promise<void>;
+    resolveTakenOver(eventId: string, type: string, staleBefore: Date, note: string): Promise<boolean>;
     deleteProcessedBefore(cutoff: Date): Promise<void>;
 }
 export {};

package/dist/db/models/stripeWebhookEvents.model.js

@@ -42,6 +42,30 @@ class StripeWebhookEventModel extends (0, interface_database_decorators_1.BasicD
         if (outcome !== "applied")
             throw new Error(`Webhook completion ${outcome}; reconciliation required`);
     }
+    async resolveTakenOver(eventId, type, staleBefore, note) {
+        const current = await this.get(eventId);
+        if (!current || current.type !== type)
+            return false;
+        if (TERMINAL_RESULTS.has(current.result))
+            return true;
+        const isStalePending = current.result === "pending" && current.processedAt < staleBefore;
+        if (current.result !== "reconciliation_required" && !isStalePending)
+            return false;
+        const outcome = await this.table
+            .atomicMutation(eventId, {
+            type: "update",
+            revisionField: "revision",
+            expectedRevision: current.revision,
+            nextRevision: (0, node_crypto_1.randomUUID)(),
+            patch: {
+                result: "success",
+                errorMessage: note,
+                processedAt: new Date(),
+            },
+        })
+            .run();
+        return outcome === "applied";
+    }
     async deleteProcessedBefore(cutoff) {
         const candidates = await this.table
             .between("processedAt", EPOCH_LOWER_BOUND, cutoff)

package/dist/db/models/stripeWebhookEvents.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"stripeWebhookEvents.model.js","sourceRoot":"","sources":["../../../src/db/models/stripeWebhookEvents.model.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AACzC,6FAA2E;AAC3E,mFAG6C;AAE7C,MAAM,iBAAiB,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;AACtC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAQzD,MAAa,uBAAwB,SAAQ,IAAA,8CAAc,EACzD,8CAAkB,EAClB,wDAA4B,CAC7B;IAEC,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,IAAY;QAC1C,MAAM,QAAQ,GAAG,IAAA,wBAAU,GAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC;gBAChB,GAAG,EAAE,OAAO;gBACZ,IAAI;gBACJ,WAAW,EAAE,IAAI,IAAI,EAAE;gBACvB,MAAM,EAAE,SAAS;gBACjB,YAAY,EAAE,IAAI;gBAClB,QAAQ;aACT,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAC7D,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACjE,OAAO,SAAS,CAAC;YACnB,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;IAGD,KAAK,CAAC,UAAU,CACd,OAAe,EACf,gBAAwB,EACxB,MAAyB,EACzB,YAA2B;QAE3B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK;aAC7B,cAAc,CAAC,OAAO,EAAE;YACvB,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,UAAU;YACzB,gBAAgB,EAAE,gBAAgB;YAClC,YAAY,EAAE,IAAA,wBAAU,GAAE;YAC1B,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,EAAE;SACzD,CAAC;aACD,GAAG,EAAE,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,2BAA2B,CAAC,CAAC;IAC9E,CAAC;IAGD,KAAK,CAAC,qBAAqB,CAAC,MAAY;QACtC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK;aAChC,OAAO,CAAC,aAAa,EAAE,iBAAiB,EAAE,MAAM,CAAC;aACjD,GAAG,EAAE,CAAC;QACT,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC9C,IACE,CAAC,OAAO;gBACR,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC;gBACrC,OAAO,CAAC,WAAW,IAAI,MAAM;gBAE7B,SAAS;YACX,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK;iBAC7B,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE;gBAC3B,IAAI,EAAE,QAAQ;gBACd,aAAa,EAAE,UAAU;gBACzB,gBAAgB,EAAE,OAAO,CAAC,QAAQ;aACnC,CAAC;iBACD,GAAG,EAAE,CAAC;YACT,IAAI,OAAO,KAAK,SAAS;gBACvB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;CACF;AAxED,0DAwEC"}
+{"version":3,"file":"stripeWebhookEvents.model.js","sourceRoot":"","sources":["../../../src/db/models/stripeWebhookEvents.model.ts"],"names":[],"mappings":"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"}

package/dist/db/models/tenantSubscriptions.model.js

@@ -53,6 +53,8 @@ class TenantSubscriptionModel extends (0, interface_database_decorators_1.BasicD
     async beginTransition(current, intent) {
         if (current.deletionStartedAt)
             throw new Error("Subscription deletion has started");
+        if (current.guardedPlanChange)
+            throw new Error("Guarded downgrade must settle before another billing transition");
         if (current.domainTransition &&
             (current.domainTransition.operationId !== intent.operationId ||
                 current.domainTransition.kind !== intent.kind ||
@@ -274,7 +276,8 @@ class TenantSubscriptionModel extends (0, interface_database_decorators_1.BasicD
             return undefined;
         if (current.deletionStartedAt)
             return current;
-        if (current.domainTransition ||
+        if (current.guardedPlanChange ||
+            current.domainTransition ||
             current.status !== STATUS_CANCELLED ||
             current.updatedAt >= cutoff)
             return undefined;

package/dist/db/models/tenantSubscriptions.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"tenantSubscriptions.model.js","sourceRoot":"","sources":["../../../src/db/models/tenantSubscriptions.model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tenantSubscriptions.model.js","sourceRoot":"","sources":["../../../src/db/models/tenantSubscriptions.model.ts"],"names":[],"mappings":"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"}

package/dist/db/tables/plans.table.d.ts

@@ -1,5 +1,7 @@
 import { Table } from "@antelopejs/interface-database-decorators";
 export declare const plansTableName = "plans";
+export declare const PLAN_FALLBACK_LOCALE = "en";
+export type PlanLocalizedText = Record<string, string>;
 export declare const PLAN_AUDIENCES: readonly ["any", "individual", "business"];
 export type PlanAudience = (typeof PLAN_AUDIENCES)[number];
 export declare const PLAN_INTERVALS: readonly ["month", "year"];
@@ -30,8 +32,14 @@ export interface PlanProviderRefs {
     stripePriceId?: string;
     stripeSyncedTerms?: PlanStripeSyncedTerms;
 }
+export declare const PLAN_LOCALIZED_FIELDS: Array<keyof Plan>;
 export declare const PLAN_UNLIMITED = -1;
-export declare class Plan extends Table {
+declare const Plan_base: import("@antelopejs/interface-database-decorators").TableClass<Table & {
+    localize<This extends {
+        constructor: any;
+    }>(this: This, locale: string, fields?: Array<keyof This>): This;
+}, [], object>;
+export declare class Plan extends Plan_base {
     _id: string;
     name: string;
     slug: string;
@@ -56,3 +64,4 @@ export declare class Plan extends Table {
     createdAt: Date;
     updatedAt: Date;
 }
+export {};

package/dist/db/tables/plans.table.js

@@ -9,15 +9,21 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Plan = exports.PLAN_UNLIMITED = exports.PLAN_BILLING_MODES = exports.PLAN_INTERVALS = exports.PLAN_AUDIENCES = exports.plansTableName = void 0;
+exports.Plan = exports.PLAN_UNLIMITED = exports.PLAN_LOCALIZED_FIELDS = exports.PLAN_BILLING_MODES = exports.PLAN_INTERVALS = exports.PLAN_AUDIENCES = exports.PLAN_FALLBACK_LOCALE = exports.plansTableName = void 0;
 const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
 const constants_1 = require("@antelopejs/interface-dms/constants");
 exports.plansTableName = "plans";
+exports.PLAN_FALLBACK_LOCALE = "en";
 exports.PLAN_AUDIENCES = ["any", "individual", "business"];
 exports.PLAN_INTERVALS = ["month", "year"];
 exports.PLAN_BILLING_MODES = ["flat", "seat"];
+exports.PLAN_LOCALIZED_FIELDS = [
+    "name",
+    "description",
+    "borderLabel",
+];
 exports.PLAN_UNLIMITED = -1;
-let Plan = class Plan extends interface_database_decorators_1.Table {
+let Plan = class Plan extends interface_database_decorators_1.Table.with(interface_database_decorators_1.LocalizationModifier) {
 };
 exports.Plan = Plan;
 __decorate([
@@ -25,6 +31,7 @@ __decorate([
     __metadata("design:type", String)
 ], Plan.prototype, "_id", void 0);
 __decorate([
+    (0, interface_database_decorators_1.Localized)({ fallbackLocale: exports.PLAN_FALLBACK_LOCALE }),
     (0, interface_database_decorators_1.Field)("string"),
     __metadata("design:type", String)
 ], Plan.prototype, "name", void 0);
@@ -34,6 +41,7 @@ __decorate([
     __metadata("design:type", String)
 ], Plan.prototype, "slug", void 0);
 __decorate([
+    (0, interface_database_decorators_1.Localized)({ fallbackLocale: exports.PLAN_FALLBACK_LOCALE }),
     (0, interface_database_decorators_1.Field)("string"),
     __metadata("design:type", String)
 ], Plan.prototype, "description", void 0);
@@ -93,6 +101,7 @@ __decorate([
     __metadata("design:type", Object)
 ], Plan.prototype, "borderColor", void 0);
 __decorate([
+    (0, interface_database_decorators_1.Localized)({ fallbackLocale: exports.PLAN_FALLBACK_LOCALE }),
     (0, interface_database_decorators_1.Field)("string"),
     __metadata("design:type", Object)
 ], Plan.prototype, "borderLabel", void 0);

package/dist/db/tables/plans.table.js.map

@@ -1 +1 @@
-{"version":3,"file":"plans.table.js","sourceRoot":"","sources":["../../../src/db/tables/plans.table.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6FAQmD;AACnD,mEAAuE;AAE1D,QAAA,cAAc,GAAG,OAAO,CAAC;AAEzB,QAAA,cAAc,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,CAAU,CAAC;AAG5D,QAAA,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,CAAU,CAAC;AAG5C,QAAA,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC;AA4C/C,QAAA,cAAc,GAAG,CAAC,CAAC,CAAC;AAI1B,IAAM,IAAI,GAAV,MAAM,IAAK,SAAQ,qCAAK;CA8E9B,CAAA;AA9EY,oBAAI;AAEP;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;iCACI;AAGZ;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;kCACK;AAIb;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;kCACK;AAGb;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;yCACY;AAIpB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;sCACe;AAGvB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;mCACM;AAGd;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;sCACS;AAGjB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;sCACe;AAGvB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;yCACqB;AAG7B;IADP,IAAA,qCAAK,EAAC,KAAK,CAAC;;sCACwB;AAG7B;IADP,IAAA,qCAAK,EAAC,CAAC,QAAQ,CAAC,CAAC;;yCACY;AAItB;IAFP,IAAA,qCAAK,EAAC,QAAQ,CAAC;IACf,IAAA,wCAAQ,EAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;;gDACa;AAGlC;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;uCACU;AAIlB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;wCACW;AAInB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,SAAS,CAAC;;sCACS;AAGlB;IADP,IAAA,qCAAK,EAAC,KAAK,CAAC;;iDACiC;AAGtC;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;yCACmB;AAG3B;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;yCACmB;AAI3B;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;mCACM;AAId;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,SAAS,CAAC;;sCACS;AAGlB;IADP,IAAA,qCAAK,EAAC,SAAS,CAAC;;uCACU;AAInB;IAFP,IAAA,4CAAY,GAAE;IACd,IAAA,qCAAK,EAAC,MAAM,CAAC;8BACK,IAAI;uCAAC;AAIhB;IAFP,IAAA,0CAAU,GAAE;IACZ,IAAA,qCAAK,EAAC,MAAM,CAAC;8BACK,IAAI;uCAAC;eA7Eb,IAAI;IADhB,IAAA,6CAAa,EAAC,sBAAc,EAAE,4BAAgB,CAAC;GACnC,IAAI,CA8EhB"}
+{"version":3,"file":"plans.table.js","sourceRoot":"","sources":["../../../src/db/tables/plans.table.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6FAUmD;AACnD,mEAAuE;AAE1D,QAAA,cAAc,GAAG,OAAO,CAAC;AAGzB,QAAA,oBAAoB,GAAG,IAAI,CAAC;AAK5B,QAAA,cAAc,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,UAAU,CAAU,CAAC;AAG5D,QAAA,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,CAAU,CAAC;AAG5C,QAAA,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC;AA4C/C,QAAA,qBAAqB,GAAsB;IACtD,MAAM;IACN,aAAa;IACb,aAAa;CACd,CAAC;AAGW,QAAA,cAAc,GAAG,CAAC,CAAC,CAAC;AAW1B,IAAM,IAAI,GAAV,MAAM,IAAK,SAAQ,qCAAK,CAAC,IAAI,CAAC,oDAAoB,CAAC;CAiFzD,CAAA;AAjFY,oBAAI;AAEP;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;iCACI;AAIZ;IAFP,IAAA,yCAAS,EAAC,EAAE,cAAc,EAAE,4BAAoB,EAAE,CAAC;IACnD,IAAA,qCAAK,EAAC,QAAQ,CAAC;;kCACK;AAIb;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;kCACK;AAIb;IAFP,IAAA,yCAAS,EAAC,EAAE,cAAc,EAAE,4BAAoB,EAAE,CAAC;IACnD,IAAA,qCAAK,EAAC,QAAQ,CAAC;;yCACY;AAIpB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;sCACe;AAGvB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;mCACM;AAGd;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;sCACS;AAGjB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;sCACe;AAGvB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;yCACqB;AAG7B;IADP,IAAA,qCAAK,EAAC,KAAK,CAAC;;sCACwB;AAG7B;IADP,IAAA,qCAAK,EAAC,CAAC,QAAQ,CAAC,CAAC;;yCACY;AAItB;IAFP,IAAA,qCAAK,EAAC,QAAQ,CAAC;IACf,IAAA,wCAAQ,EAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;;gDACa;AAGlC;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;uCACU;AAIlB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;wCACW;AAInB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,SAAS,CAAC;;sCACS;AAGlB;IADP,IAAA,qCAAK,EAAC,KAAK,CAAC;;iDACiC;AAGtC;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;yCACmB;AAI3B;IAFP,IAAA,yCAAS,EAAC,EAAE,cAAc,EAAE,4BAAoB,EAAE,CAAC;IACnD,IAAA,qCAAK,EAAC,QAAQ,CAAC;;yCACmB;AAI3B;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;mCACM;AAId;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,SAAS,CAAC;;sCACS;AAGlB;IADP,IAAA,qCAAK,EAAC,SAAS,CAAC;;uCACU;AAInB;IAFP,IAAA,4CAAY,GAAE;IACd,IAAA,qCAAK,EAAC,MAAM,CAAC;8BACK,IAAI;uCAAC;AAIhB;IAFP,IAAA,0CAAU,GAAE;IACZ,IAAA,qCAAK,EAAC,MAAM,CAAC;8BACK,IAAI;uCAAC;eAhFb,IAAI;IADhB,IAAA,6CAAa,EAAC,sBAAc,EAAE,4BAAgB,CAAC;GACnC,IAAI,CAiFhB"}

package/dist/db/tables/tenantSubscriptions.table.d.ts

@@ -1,4 +1,5 @@
 import { Table } from "@antelopejs/interface-database-decorators";
+import type { PlanChangeIncompatibility } from "../../plan-changes";
 export declare const tenantSubscriptionsTableName = "tenant_subscriptions";
 export declare const TENANT_SUBSCRIPTION_STATUSES: readonly ["pending_payment", "active", "trialing", "past_due", "suspended", "cancelled"];
 export type TenantSubscriptionStatus = (typeof TENANT_SUBSCRIPTION_STATUSES)[number];
@@ -12,6 +13,18 @@ export interface SubscriptionTransition {
     targetPlanId: string | null;
     requestedAt: Date;
 }
+export interface GuardedPlanChange {
+    operationId: string;
+    policyName: string;
+    targetPlanId: string;
+    stripeSubscriptionId: string;
+    requestedAt: Date;
+    effectiveAt: Date;
+    barrierId: string;
+    validationStartedAt?: Date;
+    phase: "preparing" | "aborting" | "provider_pending" | "scheduled" | "cancel_pending" | "effective" | "activating" | "blocked";
+    incompatibilities: PlanChangeIncompatibility[];
+}
 export interface PaidUsagePeriod {
     stripeSubscriptionId: string;
     start: Date;
@@ -29,9 +42,11 @@ export declare class TenantSubscription extends Table {
     stripeCheckoutSessionId: string | null;
     completedCheckoutSessionId: string | null;
     cardFingerprint: string | null;
+    currentPeriodStart: Date | null;
     currentPeriodEnd: Date | null;
     pendingPlanId: string | null;
     pendingPlanChangeAt: Date | null;
+    guardedPlanChange: GuardedPlanChange | null;
     domainTransition: SubscriptionTransition | null;
     revision: string;
     createdBy: string | null;

package/dist/db/tables/tenantSubscriptions.table.js

@@ -87,6 +87,10 @@ __decorate([
     (0, interface_database_decorators_1.Field)("string"),
     __metadata("design:type", Object)
 ], TenantSubscription.prototype, "cardFingerprint", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("date"),
+    __metadata("design:type", Object)
+], TenantSubscription.prototype, "currentPeriodStart", void 0);
 __decorate([
     (0, interface_database_decorators_1.Field)("date"),
     __metadata("design:type", Object)
@@ -101,6 +105,10 @@ __decorate([
     (0, interface_database_decorators_1.Field)("date"),
     __metadata("design:type", Object)
 ], TenantSubscription.prototype, "pendingPlanChangeAt", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("any"),
+    __metadata("design:type", Object)
+], TenantSubscription.prototype, "guardedPlanChange", void 0);
 __decorate([
     (0, interface_database_decorators_1.Field)("any"),
     __metadata("design:type", Object)

package/dist/db/tables/tenantSubscriptions.table.js.map

@@ -1 +1 @@
-{"version":3,"file":"tenantSubscriptions.table.js","sourceRoot":"","sources":["../../../src/db/tables/tenantSubscriptions.table.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tenantSubscriptions.table.js","sourceRoot":"","sources":["../../../src/db/tables/tenantSubscriptions.table.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,3 +6,4 @@ export * from "./provisioning";
 export * from "./registration";
 export * as invoiceLineItems from "./invoice-line-items";
 export * as tenantLifecycle from "./tenant-lifecycle";
+export * as planChanges from "./plan-changes";

package/dist/index.js

@@ -36,7 +36,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.tenantLifecycle = exports.invoiceLineItems = void 0;
+exports.planChanges = exports.tenantLifecycle = exports.invoiceLineItems = void 0;
 __exportStar(require("./billing"), exports);
 __exportStar(require("./data-api"), exports);
 __exportStar(require("./pages"), exports);
@@ -45,4 +45,5 @@ __exportStar(require("./provisioning"), exports);
 __exportStar(require("./registration"), exports);
 exports.invoiceLineItems = __importStar(require("./invoice-line-items"));
 exports.tenantLifecycle = __importStar(require("./tenant-lifecycle"));
+exports.planChanges = __importStar(require("./plan-changes"));
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,4CAA0B;AAC1B,6CAA2B;AAC3B,0CAAwB;AACxB,0CAAwB;AACxB,iDAA+B;AAC/B,iDAA+B;AAC/B,yEAAyD;AACzD,sEAAsD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,4CAA0B;AAC1B,6CAA2B;AAC3B,0CAAwB;AACxB,0CAAwB;AACxB,iDAA+B;AAC/B,iDAA+B;AAC/B,yEAAyD;AACzD,sEAAsD;AACtD,8DAA8C"}

package/dist/invoice-line-items.d.ts

@@ -15,10 +15,29 @@ export interface InvoiceLineItemsContext {
     periodEnd: Date;
     isPreview?: boolean;
 }
-export type InvoiceLineItemsResolver = (context: InvoiceLineItemsContext) => Promise<InvoiceLineItem[]> | InvoiceLineItem[];
+export interface InvoiceLineItemsReady {
+    status: "ready";
+    lines: InvoiceLineItem[];
+}
+export interface InvoiceLineItemsNotReady {
+    status: "not_ready";
+    reason: string;
+}
+export type InvoiceLineItemsResolution = InvoiceLineItemsReady | InvoiceLineItemsNotReady;
+export type InvoiceLineItemsResolver = (context: InvoiceLineItemsContext) => Promise<InvoiceLineItem[] | InvoiceLineItemsResolution> | InvoiceLineItem[] | InvoiceLineItemsResolution;
+export declare const INVALID_RESOLUTION_REASON = "invalid_resolution";
+export declare function normalizeInvoiceLineItemsResolution(value: unknown): InvoiceLineItemsResolution;
+export interface InvoiceUsageGap {
+    tenantId: string;
+    invoiceId: string;
+    periodStart: Date;
+    periodEnd: Date;
+    reasons: string[];
+}
 export interface InvoiceLineItemsProvider {
     id: string;
     resolve: InvoiceLineItemsResolver;
+    onUsageGap?: (gap: InvoiceUsageGap) => void;
 }
 export declare const LINE_KEY_SEPARATOR = ":";
 export type SkippedLineItemReason = "already_invoiced" | "duplicate_key" | "zero_amount" | "invalid";
@@ -37,7 +56,7 @@ export interface InvoiceLineItemSelection {
 export declare function buildInvoiceLineKey(providerId: string, key: string): string;
 export declare function selectInvoiceLineItemsToCreate(providerId: string, items: readonly InvoiceLineItem[], alreadyInjectedKeys: ReadonlySet<string>): InvoiceLineItemSelection;
 export declare namespace internal {
-    const RegisterInvoiceLineItemsProvider: RegisteringProxy<(providerId: string, resolve: InvoiceLineItemsResolver) => void>;
+    const RegisterInvoiceLineItemsProvider: RegisteringProxy<(providerId: string, provider: InvoiceLineItemsProvider) => void>;
 }
 export declare function RegisterInvoiceLineItemsProvider(provider: InvoiceLineItemsProvider): void;
 export declare function UnregisterInvoiceLineItemsProvider(providerId: string): void;

package/dist/invoice-line-items.js

@@ -1,11 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.internal = exports.LINE_KEY_SEPARATOR = void 0;
+exports.internal = exports.LINE_KEY_SEPARATOR = exports.INVALID_RESOLUTION_REASON = void 0;
+exports.normalizeInvoiceLineItemsResolution = normalizeInvoiceLineItemsResolution;
 exports.buildInvoiceLineKey = buildInvoiceLineKey;
 exports.selectInvoiceLineItemsToCreate = selectInvoiceLineItemsToCreate;
 exports.RegisterInvoiceLineItemsProvider = RegisterInvoiceLineItemsProvider;
 exports.UnregisterInvoiceLineItemsProvider = UnregisterInvoiceLineItemsProvider;
 const interface_core_1 = require("@antelopejs/interface-core");
+exports.INVALID_RESOLUTION_REASON = "invalid_resolution";
+function normalizeInvoiceLineItemsResolution(value) {
+    if (Array.isArray(value))
+        return { status: "ready", lines: value };
+    const candidate = value;
+    if (candidate?.status === "ready" && Array.isArray(candidate.lines))
+        return { status: "ready", lines: candidate.lines };
+    if (candidate?.status === "not_ready")
+        return { status: "not_ready", reason: String(candidate.reason) };
+    return { status: "not_ready", reason: exports.INVALID_RESOLUTION_REASON };
+}
 exports.LINE_KEY_SEPARATOR = ":";
 const MAX_LINE_KEY_LENGTH = 150;
 function isFilledString(value) {
@@ -75,7 +87,7 @@ function RegisterInvoiceLineItemsProvider(provider) {
     if (provider.id.includes(exports.LINE_KEY_SEPARATOR)) {
         throw new Error(`An invoice line items provider id cannot contain '${exports.LINE_KEY_SEPARATOR}' (got '${provider.id}').`);
     }
-    internal.RegisterInvoiceLineItemsProvider.register(provider.id, provider.resolve);
+    internal.RegisterInvoiceLineItemsProvider.register(provider.id, provider);
 }
 function UnregisterInvoiceLineItemsProvider(providerId) {
     internal.RegisterInvoiceLineItemsProvider.unregister(providerId);

package/dist/invoice-line-items.js.map

@@ -1 +1 @@
-{"version":3,"file":"invoice-line-items.js","sourceRoot":"","sources":["../src/invoice-line-items.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"invoice-line-items.js","sourceRoot":"","sources":["../src/invoice-line-items.ts"],"names":[],"mappings":"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"}

package/dist/plan-changes.d.ts

@@ -0,0 +1,41 @@
+import { RegisteringProxy } from "@antelopejs/interface-core";
+import type { Plan } from "./db/tables/plans.table";
+export interface PlanChangeIncompatibility {
+    code: string;
+    message: string;
+    resource?: string;
+}
+export interface PlanChangeValidationRequest {
+    tenantId: string;
+    currentPlan: Plan | null;
+    targetPlan: Plan;
+    operationId: string;
+    phase: "preview" | "schedule" | "effective";
+    effectiveAt: Date | null;
+}
+export interface PlanChangePolicy {
+    name: string;
+    validatePlanChange(request: PlanChangeValidationRequest): Promise<PlanChangeIncompatibility[]>;
+}
+export interface TenantPlanConstraints {
+    currentPlan: Plan | null;
+    pendingPlan: Plan | null;
+    effectiveAt: Date | null;
+    planChangeOperationId: string | null;
+    blocked: boolean;
+    admissionBlocked: boolean;
+    incompatibilities: PlanChangeIncompatibility[];
+}
+export declare const GetTenantPlanConstraints: (tenantId: string) => Promise<TenantPlanConstraints>;
+export declare const CountOccupiedSeats: (tenantId: string) => Promise<number>;
+export interface PlanChangeActivation {
+    planChangeOperationId: string;
+    operationId: string;
+    gateId: string;
+}
+export declare const GetPlanChangeActivation: (tenantId: string) => Promise<PlanChangeActivation | null>;
+export declare namespace internal {
+    const RegisterPlanChangePolicy: RegisteringProxy<(name: string, policy: PlanChangePolicy) => void>;
+}
+export declare function RegisterPlanChangePolicy(policy: PlanChangePolicy): void;
+export declare function UnregisterPlanChangePolicy(name: string): void;

package/dist/plan-changes.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.internal = exports.GetPlanChangeActivation = exports.CountOccupiedSeats = exports.GetTenantPlanConstraints = void 0;
+exports.RegisterPlanChangePolicy = RegisterPlanChangePolicy;
+exports.UnregisterPlanChangePolicy = UnregisterPlanChangePolicy;
+const interface_core_1 = require("@antelopejs/interface-core");
+exports.GetTenantPlanConstraints = (0, interface_core_1.InterfaceFunction)();
+exports.CountOccupiedSeats = (0, interface_core_1.InterfaceFunction)();
+exports.GetPlanChangeActivation = (0, interface_core_1.InterfaceFunction)();
+var internal;
+(function (internal) {
+    internal.RegisterPlanChangePolicy = new interface_core_1.RegisteringProxy();
+})(internal || (exports.internal = internal = {}));
+function RegisterPlanChangePolicy(policy) {
+    if (!policy.name.trim())
+        throw new Error("Plan change policy name is required");
+    internal.RegisterPlanChangePolicy.register(policy.name, policy);
+}
+function UnregisterPlanChangePolicy(name) {
+    internal.RegisterPlanChangePolicy.unregister(name);
+}
+//# sourceMappingURL=plan-changes.js.map

package/dist/plan-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-changes.js","sourceRoot":"","sources":["../src/plan-changes.ts"],"names":[],"mappings":";;;AA4FA,4DAIC;AAGD,gEAEC;AArGD,+DAGoC;AAkDvB,QAAA,wBAAwB,GACnC,IAAA,kCAAiB,GAAwD,CAAC;AAQ/D,QAAA,kBAAkB,GAC7B,IAAA,kCAAiB,GAAyC,CAAC;AAgBhD,QAAA,uBAAuB,GAClC,IAAA,kCAAiB,GAEd,CAAC;AAGN,IAAiB,QAAQ,CAIxB;AAJD,WAAiB,QAAQ;IACV,iCAAwB,GAAG,IAAI,iCAAgB,EAEzD,CAAC;AACN,CAAC,EAJgB,QAAQ,wBAAR,QAAQ,QAIxB;AAGD,SAAgB,wBAAwB,CAAC,MAAwB;IAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;QACrB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,QAAQ,CAAC,wBAAwB,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAClE,CAAC;AAGD,SAAgB,0BAA0B,CAAC,IAAY;IACrD,QAAQ,CAAC,wBAAwB,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/plans.d.ts

@@ -26,4 +26,5 @@ export declare function monthlyPrice(plan: Plan): number;
 export declare function isDowngrade(current: Plan | null, target: Plan, seats?: number): boolean;
 export declare const FEATURE_LOCALIZED_FIELDS: Array<keyof Feature>;
 export declare function localizeFeature(feature: Feature, locale: string): Feature;
+export declare function localizePlan(plan: Plan, locale: string): Plan;
 export declare function buildTenantPlanCatalog(planModel: PlanModel, featureModel: FeatureModel, plans: Plan[], locale: string): Promise<TenantPlanCatalog>;

package/dist/plans.js

@@ -4,6 +4,7 @@ exports.FEATURE_LOCALIZED_FIELDS = void 0;
 exports.monthlyPrice = monthlyPrice;
 exports.isDowngrade = isDowngrade;
 exports.localizeFeature = localizeFeature;
+exports.localizePlan = localizePlan;
 exports.buildTenantPlanCatalog = buildTenantPlanCatalog;
 const db_1 = require("./db");
 const MONTHS_PER_INTERVAL = {
@@ -35,6 +36,9 @@ exports.FEATURE_LOCALIZED_FIELDS = [
 function localizeFeature(feature, locale) {
     return feature.localize(locale, exports.FEATURE_LOCALIZED_FIELDS);
 }
+function localizePlan(plan, locale) {
+    return plan.localize(locale, db_1.PLAN_LOCALIZED_FIELDS);
+}
 function toPlanFeature(feature) {
     return {
         featureId: feature._id,
@@ -46,7 +50,7 @@ function toPlanFeature(feature) {
         order: feature.order ?? db_1.FEATURE_DEFAULT_ORDER,
     };
 }
-async function toPlanView(planModel, plan, knownFeatureIds) {
+async function toPlanView(planModel, plan, knownFeatureIds, locale) {
     const resolved = await planModel.resolveInheritance(plan);
     const featureValues = {};
     for (const entry of resolved.features) {
@@ -56,7 +60,7 @@ async function toPlanView(planModel, plan, knownFeatureIds) {
     }
     return {
         _id: plan._id,
-        name: plan.name,
+        name: localizePlan(plan, locale).name,
         price: plan.price,
         currency: plan.currency,
         interval: plan.interval,
@@ -68,7 +72,7 @@ async function toPlanView(planModel, plan, knownFeatureIds) {
 async function buildTenantPlanCatalog(planModel, featureModel, plans, locale) {
     const features = await featureModel.getAll();
     const knownFeatureIds = new Set(features.map((feature) => feature._id));
-    const views = await Promise.all(plans.map((plan) => toPlanView(planModel, plan, knownFeatureIds)));
+    const views = await Promise.all(plans.map((plan) => toPlanView(planModel, plan, knownFeatureIds, locale)));
     return {
         plans: views.sort((left, right) => left.order - right.order),
         features: features

package/dist/plans.js.map

@@ -1 +1 @@
-{"version":3,"file":"plans.js","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plans.js","sourceRoot":"","sources":["../src/plans.ts"],"names":[],"mappings":"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"}

package/dist/tenant-lifecycle.d.ts

@@ -6,6 +6,7 @@ export interface TenantLifecycleMessage {
     operationId: string;
     transition: TenantLifecycleTransition;
     requestedAt: Date;
+    planChangeOperationId?: string;
 }
 export interface TenantLifecycleReceipt {
     receiptId: string;

package/dist/tenant-lifecycle.js.map

@@ -1 +1 @@
-{"version":3,"file":"tenant-lifecycle.js","sourceRoot":"","sources":["../src/tenant-lifecycle.ts"],"names":[],"mappings":";;;AA+DA,8EAEC;AAWD,0EAUC;AAtFD,+DAGoC;AAEpC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAG5C,QAAA,4BAA4B,GAAG;IAC1C,SAAS;IACT,WAAW;IACX,wBAAwB;CAChB,CAAC;AAwCE,QAAA,6BAA6B,GACxC,IAAA,kCAAiB,GAA0C,CAAC;AAG9D,IAAiB,QAAQ,CAIxB;AAJD,WAAiB,QAAQ;IACV,wCAA+B,GAAG,IAAI,iCAAgB,EAEhE,CAAC;AACN,CAAC,EAJgB,QAAQ,wBAAR,QAAQ,QAIxB;AAGD,SAAgB,iCAAiC,CAAC,IAAY;IAC5D,QAAQ,CAAC,+BAA+B,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAWD,SAAgB,+BAA+B,CAC7C,QAAiC;IAEjC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,QAAQ,CAAC,+BAA+B,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3E,OAAO;QACL,UAAU,EAAE,GAAG,EAAE,CAAC,iCAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC;KACnE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"tenant-lifecycle.js","sourceRoot":"","sources":["../src/tenant-lifecycle.ts"],"names":[],"mappings":";;;AAiEA,8EAEC;AAWD,0EAUC;AAxFD,+DAGoC;AAEpC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAG5C,QAAA,4BAA4B,GAAG;IAC1C,SAAS;IACT,WAAW;IACX,wBAAwB;CAChB,CAAC;AA0CE,QAAA,6BAA6B,GACxC,IAAA,kCAAiB,GAA0C,CAAC;AAG9D,IAAiB,QAAQ,CAIxB;AAJD,WAAiB,QAAQ;IACV,wCAA+B,GAAG,IAAI,iCAAgB,EAEhE,CAAC;AACN,CAAC,EAJgB,QAAQ,wBAAR,QAAQ,QAIxB;AAGD,SAAgB,iCAAiC,CAAC,IAAY;IAC5D,QAAQ,CAAC,+BAA+B,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAWD,SAAgB,+BAA+B,CAC7C,QAAiC;IAEjC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,QAAQ,CAAC,+BAA+B,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3E,OAAO;QACL,UAAU,EAAE,GAAG,EAAE,CAAC,iCAAiC,CAAC,QAAQ,CAAC,IAAI,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/docs/1.index.md

@@ -14,6 +14,7 @@ Consumers depend on `@antelopejs/interface-dms-saas`, not the runtime's private
 | Root | Billing, data API, pages, plans, provisioning and registration exports; `invoiceLineItems` and `tenantLifecycle` namespaces |
 | `/billing` | [Balances, previews and billing-state recomputation](./2.billing.md) |
 | `/invoice-line-items` | [Usage providers, line types and key helpers](./3.lifecycle-and-usage.md#invoice-line-items) |
+| `/plan-changes` | [Inventory policy and guarded Free downgrade](./3.lifecycle-and-usage.md#plan-changes) |
 | `/tenant-lifecycle` | [Durable lifecycle consumers and provisioning gate](./3.lifecycle-and-usage.md#tenant-lifecycle) |
 | `/provisioning`, `/registration` | [Provisioning payload and registration limits](./3.lifecycle-and-usage.md#registration-and-provisioning) |
 | `/pages`, `/page-definitions` | [Page descriptors and extension registration](./4.pages-plans-data.md#page-extensions) |

package/docs/2.billing.md

@@ -7,6 +7,31 @@ description: Authorized customer balances and invoice previews, and republishing
 
 Import these functions and types from `@antelopejs/interface-dms-saas/billing` or the package root.
 
+## Read a customer's balance
+
+Use this read when a billing page needs to distinguish credit from money owed.
+Pass IDs obtained from your authenticated request, not unchecked request fields.
+
+```ts docs-check
+import {
+  GetTenantCustomerBalance,
+  type TenantCustomerBalanceScope,
+} from "@antelopejs/interface-dms-saas/billing";
+
+export async function describeBalance(scope: TenantCustomerBalanceScope): Promise<string> {
+  const balance = await GetTenantCustomerBalance(scope);
+  if (balance.status === "absent") return `No balance: ${balance.reason}`;
+  const amount = balance.balanceMinorUnits;
+  if (amount === 0) return "Settled";
+  return `${Math.abs(amount)} ${balance.currency} minor units ${amount < 0 ? "in credit" : "owed"}`;
+}
+```
+
+For an available EUR balance of `-1250`, this returns `1250 EUR minor units in
+credit`: €12.50 available for future invoices, not a refund. A provider failure
+rejects the call; do not turn it into a zero balance. The reference below covers
+all absence reasons and the separate upcoming-invoice estimate.
+
 ## GetTenantCustomerBalance
 
 `GetTenantCustomerBalance(scope: TenantCustomerBalanceScope): Promise<TenantCustomerBalance>` takes `{ tenantId: string, userId: string }` from a trusted authentication boundary. It requires membership and a successful tenant access gate; it rejects unauthorized callers with 403. It does not trust a supplied user ID as proof of authentication.
@@ -48,6 +73,12 @@ An available preview includes these fields. All amounts are integers in the mino
 
 The preview calls usage providers with `isPreview: true` and can populate a tenant-level shared database cache. It never creates an invoice or charges quoted lines. Usage covers the running cycle so far, not its final total; display `computedAt`. A missing payment method does not itself prevent previewing. Cache lifetime, invalidation and Stripe read timeouts are [runtime configuration](/docs/modules/saas/extending#upcoming-invoice-preview).
 
+## GetTenantBillingPeriod
+
+`GetTenantBillingPeriod(tenantId: string): Promise<TenantBillingPeriod | null>` returns the tenant's current Stripe billing period as `{ start: Date, end: Date }`, half-open (`[start, end)`). It is clipped to the paid usage exactly as renewal invoices clip their usage window: a period opened before the paid usage started starts with it, and a guarded downgrade or a closed paid period ends it early. It is `null` for a free or complimentary tenant and for one whose period dms-saas has not recorded yet (`currentPeriodStart` is stored from the subscription webhooks).
+
+This is a trusted read with no user scope or membership check; storage errors propagate. It does not call Stripe. Usage credits in dms-saas consumers may follow another cycle (Cloud resets its allowance on the UTC calendar month): use this period only where you mean the invoice's.
+
 ## RecomputeTenantBillingState
 
 `RecomputeTenantBillingState(tenantId: string): Promise<void>` republishes the tenant's billing state and workspace directory fields, including plan, seats, MRR, renewal and owner, from current records. Call it after a seed or import finishes direct writes. Normal runtime billing operations already do this.

package/docs/3.lifecycle-and-usage.md

@@ -7,9 +7,24 @@ description: Registration extras, durable tenant lifecycle consumers and idempot
 
 Use the direct subpaths below or the root's `invoiceLineItems` and `tenantLifecycle` namespaces. Register consumers/providers from the owning module's lifecycle, not a request handler. Registrations replay when SaaS attaches or reloads and are released when their owner unloads.
 
+## Choose when your work should happen
+
+| Task | Integration | Example result |
+| --- | --- | --- |
+| Save onboarding answers | Provisioning hook | A referral code is stored before signup completes |
+| Create paid product resources | `created` lifecycle consumer | A workspace gets its resources after payment is committed |
+| Pause or resume resources | Lifecycle consumer | SaaS access waits for the required reactivation receipts |
+| Add measured usage to a bill | Invoice line-item provider | 120 compute minutes produce one priced line |
+
+For that last example, `amountCents: 600` and `quantity: 120` mean a line total
+of €6.00 on an EUR invoice, not 120 × €6.00. Your resolver calculates the total;
+SaaS does not multiply it by the quantity. See the
+[working provider example](/docs/modules/saas/extending#invoice-line-items)
+before implementing the contract below.
+
 ## Invoice line items
 
-Import from `/invoice-line-items`. `RegisterInvoiceLineItemsProvider(provider: InvoiceLineItemsProvider): void` registers `{ id: string, resolve: InvoiceLineItemsResolver }`. `UnregisterInvoiceLineItemsProvider(providerId: string): void` removes it; unknown IDs are ignored. Register during `construct()` and unregister during `stop()`.
+Import from `/invoice-line-items`. `RegisterInvoiceLineItemsProvider(provider: InvoiceLineItemsProvider): void` registers `{ id: string, resolve: InvoiceLineItemsResolver, onUsageGap?: (gap: InvoiceUsageGap) => void }`. `UnregisterInvoiceLineItemsProvider(providerId: string): void` removes it; unknown IDs are ignored. Register during `construct()` and unregister during `stop()`.
 
 ```ts [Contract]
 interface InvoiceLineItemsContext {
@@ -30,16 +45,45 @@ interface InvoiceLineItem {
   metadata?: Record<string, string>;
 }
 
+type InvoiceLineItemsResolution =
+  | { status: "ready"; lines: InvoiceLineItem[] }
+  | { status: "not_ready"; reason: string };
+
+interface InvoiceUsageGap {
+  tenantId: string;
+  invoiceId: string;
+  periodStart: Date;
+  periodEnd: Date;
+  reasons: string[];
+}
+
 type InvoiceLineItemsResolver = (
   context: InvoiceLineItemsContext,
-) => Promise<InvoiceLineItem[]> | InvoiceLineItem[];
+) =>
+  | Promise<InvoiceLineItem[] | InvoiceLineItemsResolution>
+  | InvoiceLineItem[]
+  | InvoiceLineItemsResolution;
 ```
 
-The runtime asks providers for `subscription_cycle` renewal invoices, not initial or one-off invoices. The dates cover the cycle just closed, clipped to the subscription's paid usage period. Complimentary/grace usage is excluded; no provider runs for an empty covered window. Read tenant-scoped, pre-aggregated usage because the resolver runs inside the webhook request.
+The runtime asks providers for `subscription_cycle` renewal invoices, not initial or one-off invoices. The dates cover the cycle just closed, clipped to the subscription's paid usage period. Complimentary/grace usage is excluded; no provider runs for an empty covered window. Read tenant-scoped, pre-aggregated usage because the resolver runs inside the webhook request or the recovery worker, and return the same lines every time for a closed window.
 
 `amountCents` is the safe-integer line total in the invoice currency, including negative credits. Quantity and unit are audit metadata, not factors multiplied into the total. Zero amounts are dropped. Empty keys/descriptions, non-safe-integer amounts, keys containing `:`, or combined keys over 150 characters are invalid. Provider IDs must not contain `:`; registration throws if they do. IDs must be globally unique across modules: a collision replaces the earlier provider, and collisions before attachment can collapse silently.
 
-Keep each line key stable. The runtime injects at most one line per invoice/provider/key across webhook replays and concurrent workers. A throwing provider is logged and skipped so others can run, but partial/invalid injection ultimately fails the webhook to expose underbilling. Returning lines is not a guarantee that Stripe accepted the invoice items.
+Keep each line key stable. The runtime injects at most one line per invoice/provider/key across webhook replays and concurrent workers. Returning lines is not a guarantee that Stripe accepted the invoice items.
+
+On a closing invoice the runtime first suspends the draft (`auto_advance=false`) and hands the injection to a durable task. The invoice is always finalized: once every provider's lines are on it, or 48 hours after it was registered with the lines available:
+
+| Resolver answer | Effect |
+| --- | --- |
+| An array, or `{ status: "ready", lines }` | The lines are injected; an empty array states an empty bill. |
+| `{ status: "not_ready", reason }`, or a thrown error | The draft stays suspended and the provider is asked again later; past the deadline, the invoice is finalized without its lines. |
+| Anything else | Treated as `not_ready` with reason `invalid_resolution` (`INVALID_RESOLUTION_REASON`); `normalizeInvoiceLineItemsResolution` applies that rule. |
+
+An invoice finalized without some of its lines — a provider not ready at the deadline, invalid lines, Stripe refusing a line, or a draft changed outside dms-saas — never bills the missing usage: the gap favours the customer. The runtime logs it at error level (`invoice finalized with missing usage`) and calls `onUsageGap` on every provider the invoice was registered with, so the provider can raise an alert and its owner can fix the system. Each reason starts with a stable code (`provider_not_ready`, `managed_lines_unexpected_or_changed`, `before_finalize`, ...) followed by `:` and its detail.
+
+`periodStart` is inclusive and `periodEnd` exclusive, so two adjacent cycle invoices cover disjoint windows. A preview covers the open cycle up to the request time; it is a quote of the next invoice, not an addition to it. A negative `amountCents` is a credit line.
+
+A provider that may still be loading when an invoice is created is listed in the runtime's `invoiceLineRequiredProviders` option so the invoice waits for it. See the [runtime configuration](/docs/modules/saas/configuration).
 
 Preview calls set `isPreview: true`, use a synthetic `upcoming_<subscription id>` invoice ID, and end at the request time. They quote usage without invoicing it. Do not mutate usage accounting inside a resolver. A failed resolver or invalid line makes the preview unavailable.
 
@@ -49,6 +93,29 @@ Preview calls set `isPreview: true`, use a synthetic `upcoming_<subscription id>
 
 `selectInvoiceLineItemsToCreate(providerId: string, items: readonly InvoiceLineItem[], alreadyInjectedKeys: ReadonlySet<string>): InvoiceLineItemSelection` is synchronous and has no Stripe side effects. It returns `accepted: PreparedInvoiceLineItem[]` (`{ lineKey, item }`, with trimmed item keys) and `skipped: SkippedInvoiceLineItem[]` (`{ lineKey, reason }`). `SkippedLineItemReason` is `already_invoiced`, `duplicate_key`, `zero_amount`, or `invalid`. The set must contain full provider-prefixed keys. This selection helper does not itself provide transactional idempotency.
 
+## Plan changes
+
+Import from `/plan-changes`. A module that owns tenant inventory (applications, environments, seats it counts) registers the policy SaaS consults before a paid-to-Free downgrade lands:
+
+```ts [Contract]
+interface PlanChangePolicy {
+  name: string;
+  validatePlanChange(
+    request: PlanChangeValidationRequest,
+  ): Promise<PlanChangeIncompatibility[]>;
+}
+```
+
+`RegisterPlanChangePolicy(policy)` registers the sole policy and `UnregisterPlanChangePolicy(name)` removes it; registering opts deferred changes into the guarded paid-to-Free flow. `validatePlanChange` runs for the `preview`, `schedule` and `effective` phases; the effective call runs after DMS tenant admission is paused and earlier membership writers have drained. It must not mutate inventory or call Stripe. A missing policy, when the runtime's `requiredPlanChangePolicy` names one, fails closed.
+
+| Function | Use |
+| --- | --- |
+| `GetTenantPlanConstraints(tenantId)` | Current and pending plan, `blocked`/`admissionBlocked` and the incompatibilities, for inventory writers to check after entering their own admission. Read-only, not a reservation. |
+| `CountOccupiedSeats(tenantId)` | Occupied seats, including unexpired invitations and excluding platform support. |
+| `GetPlanChangeActivation(tenantId)` | `{ planChangeOperationId, operationId, gateId }` of the only downgrade hold an activation consumer may release, or `null`. Match both operation IDs on the lifecycle message, evaluate every DMS access gate (`EvaluateTenantAccess`) and preserve every other denial. |
+
+`TenantLifecycleMessage.planChangeOperationId` marks a lifecycle delivery produced by a guarded downgrade; never treat one you cannot authorize as an ordinary resume.
+
 ## Tenant lifecycle
 
 Import from `/tenant-lifecycle`. `TENANT_LIFECYCLE_TRANSITIONS` contains `created`, `suspended` and `reactivation_requested`; `TenantLifecycleTransition` is their union.

package/docs/4.pages-plans-data.md

@@ -42,14 +42,15 @@ Import from `/plans`. These helpers do not charge customers or authorize access.
 | `monthlyPrice(plan: Plan): number` | Returns the price as a monthly amount; yearly prices divide by 12 |
 | `isDowngrade(current: Plan \| null, target: Plan, seats?: number): boolean` | Compares monthly cost, multiplying seat plans by at least one seat; seats default to 1. No current plan returns false; equal cost is not a downgrade |
 | `localizeFeature(feature: Feature, locale: string): Feature` | Applies localization to `displayName`, `description`, `tooltip`, and `unit`, listed by exported `FEATURE_LOCALIZED_FIELDS`; missing translations fall back to the table locale (`en`) |
-| `buildTenantPlanCatalog(planModel: PlanModel, featureModel: FeatureModel, plans: Plan[], locale: string): Promise<TenantPlanCatalog>` | Reads features, resolves plan inheritance, excludes unknown feature IDs and sorts plans/features by order; model read failures reject |
+| `localizePlan(plan: Plan, locale: string): Plan` | Applies localization to `name`, `description`, and `borderLabel`, listed by exported `PLAN_LOCALIZED_FIELDS`; missing translations fall back to `PLAN_FALLBACK_LOCALE` (`en`). `PlanModel` reads already return plans unlocked in that fallback locale |
+| `buildTenantPlanCatalog(planModel: PlanModel, featureModel: FeatureModel, plans: Plan[], locale: string): Promise<TenantPlanCatalog>` | Reads features, resolves plan inheritance, excludes unknown feature IDs and sorts plans/features by order; plan names and feature labels are read in `locale`; model read failures reject |
 
 `TenantPlanCatalog` has `plans: TenantPlanView[]` and `features: TenantPlanFeature[]`.
 
 - `TenantPlanView`: `_id: string`, `name: string`, `price: number`, `currency: string`, `interval: PlanInterval` (`month` or `year`), `order: number`, `checkoutAvailable: boolean`, and `featureValues: Record<string, unknown>`. Checkout availability reflects a Stripe price reference, not an authorization decision.
 - `TenantPlanFeature`: `featureId: string`, `displayName: string`, `tooltip: string | null`, `unit: string | null`, `valueType: FeatureValueType` (`boolean`, `number`, or `string`), `isDetailRow: boolean`, and `order: number`.
 
-Keep caller-supplied plan/model scopes authorized. The catalogue builder does not filter an arbitrary plan list to what a user may buy. Write localized feature values using the canonical model's `localize("*")` convention; see the [feature integration guide](/docs/modules/saas/extending#plan-feature-labels-and-values).
+Keep caller-supplied plan/model scopes authorized. The catalogue builder does not filter an arbitrary plan list to what a user may buy. Write localized plan and feature texts using the canonical model's `localize("*")` convention, one value per locale (`{ en: "Pro", fr: "Pro" }`), never `$` i18n keys; see the [feature integration guide](/docs/modules/saas/extending#plan-feature-labels-and-values).
 
 ## HiddenStringFilter
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antelopejs/interface-dms-saas",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "AntelopeJS interface for the DMS SaaS module: billing, plans, registration, workspace pages and lifecycle extension points.",
   "keywords": [
     "antelopejs",
@@ -71,7 +71,7 @@
   },
   "dependencies": {
     "@antelopejs/interface-data-api": ">=0.2.2 <1.0.0",
-    "@antelopejs/interface-dms": ">=0.7.2 <1.0.0"
+    "@antelopejs/interface-dms": ">=0.7.4 <1.0.0"
   },
   "devDependencies": {
     "@antelopejs/interface-core": ">=0.2.4 <1.0.0",