@antelopejs/interface-dms-saas 0.3.0 → 0.4.1

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

@@ -1,12 +1,59 @@
 import { Table } from "@antelopejs/interface-database-decorators";
+import type { PlanBillingMode, PlanInterval } from "./plans.table";
 export declare const tenantBillingStateTableName = "tenant_billing_state";
 export declare const BILLING_STATES: readonly ["free", "active", "trialing", "past_due", "suspended", "cancelled", "pending_payment"];
 export type BillingState = (typeof BILLING_STATES)[number];
-export declare class TenantBillingState extends Table {
+export declare const WORKSPACE_OWNER_STATUSES: readonly ["joined", "invited", "expired", "none"];
+export type WorkspaceOwnerStatus = (typeof WORKSPACE_OWNER_STATUSES)[number];
+export declare const WORKSPACE_RENEWAL_KINDS: readonly ["renews", "trial_ends", "free_until", "suspends", "suspended", "awaiting_payment", "deletes"];
+export type WorkspaceRenewalKind = (typeof WORKSPACE_RENEWAL_KINDS)[number];
+export interface WorkspaceDirectoryFields {
+    planId: string | null;
+    planName: string | null;
+    planInterval: PlanInterval | null;
+    planBillingMode: PlanBillingMode | null;
+    planUnitAmountMinor: number | null;
+    currency: string | null;
+    seats: number;
+    members: number;
+    pendingPlanId: string | null;
+    isComplimentary: boolean;
+    mrrMinor: number;
+    previousMrrMinor: number;
+    reportingMrr: number;
+    renewalKind: WorkspaceRenewalKind | null;
+    renewsAt: Date | null;
+    stateSince: Date | null;
+    ownerStatus: WorkspaceOwnerStatus;
+    ownerNeverJoined: boolean;
+    ownerName: string | null;
+    ownerEmail: string | null;
+}
+export declare class TenantBillingState extends Table implements WorkspaceDirectoryFields {
     _id: string;
     tenantId: string;
     billingState: BillingState;
     updatedAt: Date;
     revision: string;
     deletedAt: Date | null;
+    planId: string | null;
+    planName: string | null;
+    planInterval: PlanInterval | null;
+    planBillingMode: PlanBillingMode | null;
+    planUnitAmountMinor: number | null;
+    currency: string | null;
+    seats: number;
+    members: number;
+    pendingPlanId: string | null;
+    isComplimentary: boolean;
+    mrrMinor: number;
+    previousMrrMinor: number;
+    reportingMrr: number;
+    renewalKind: WorkspaceRenewalKind | null;
+    renewsAt: Date | null;
+    stateSince: Date | null;
+    ownerStatus: WorkspaceOwnerStatus;
+    ownerNeverJoined: boolean;
+    ownerName: string | null;
+    ownerEmail: string | null;
 }

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

@@ -9,7 +9,7 @@ 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.TenantBillingState = exports.BILLING_STATES = exports.tenantBillingStateTableName = void 0;
+exports.TenantBillingState = exports.WORKSPACE_RENEWAL_KINDS = exports.WORKSPACE_OWNER_STATUSES = exports.BILLING_STATES = exports.tenantBillingStateTableName = void 0;
 const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
 const constants_1 = require("@antelopejs/interface-dms/constants");
 const tenants_table_1 = require("@antelopejs/interface-dms/db/tables/tenants.table");
@@ -23,6 +23,21 @@ exports.BILLING_STATES = [
     "cancelled",
     "pending_payment",
 ];
+exports.WORKSPACE_OWNER_STATUSES = [
+    "joined",
+    "invited",
+    "expired",
+    "none",
+];
+exports.WORKSPACE_RENEWAL_KINDS = [
+    "renews",
+    "trial_ends",
+    "free_until",
+    "suspends",
+    "suspended",
+    "awaiting_payment",
+    "deletes",
+];
 let TenantBillingState = class TenantBillingState extends interface_database_decorators_1.Table {
 };
 exports.TenantBillingState = TenantBillingState;
@@ -53,6 +68,90 @@ __decorate([
     (0, interface_database_decorators_1.Field)("date"),
     __metadata("design:type", Object)
 ], TenantBillingState.prototype, "deletedAt", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Index)(),
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "planId", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "planName", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "planInterval", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "planBillingMode", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("number"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "planUnitAmountMinor", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "currency", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("number"),
+    __metadata("design:type", Number)
+], TenantBillingState.prototype, "seats", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("number"),
+    __metadata("design:type", Number)
+], TenantBillingState.prototype, "members", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Index)(),
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "pendingPlanId", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("boolean"),
+    __metadata("design:type", Boolean)
+], TenantBillingState.prototype, "isComplimentary", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Index)(),
+    (0, interface_database_decorators_1.Field)("number"),
+    __metadata("design:type", Number)
+], TenantBillingState.prototype, "mrrMinor", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("number"),
+    __metadata("design:type", Number)
+], TenantBillingState.prototype, "previousMrrMinor", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("number"),
+    __metadata("design:type", Number)
+], TenantBillingState.prototype, "reportingMrr", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "renewalKind", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Index)(),
+    (0, interface_database_decorators_1.Field)("date"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "renewsAt", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("date"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "stateSince", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", String)
+], TenantBillingState.prototype, "ownerStatus", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("boolean"),
+    __metadata("design:type", Boolean)
+], TenantBillingState.prototype, "ownerNeverJoined", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "ownerName", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], TenantBillingState.prototype, "ownerEmail", void 0);
 exports.TenantBillingState = TenantBillingState = __decorate([
     (0, interface_database_decorators_1.RegisterTable)(exports.tenantBillingStateTableName, constants_1.CORE_SCHEMA_NAME)
 ], TenantBillingState);

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

@@ -1 +1 @@
-{"version":3,"file":"tenantBillingState.table.js","sourceRoot":"","sources":["../../../src/db/tables/tenantBillingState.table.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6FAMmD;AACnD,mEAAuE;AACvE,qFAA2E;AAE9D,QAAA,2BAA2B,GAAG,sBAAsB,CAAC;AAErD,QAAA,cAAc,GAAG;IAC5B,MAAM;IACN,QAAQ;IACR,UAAU;IACV,UAAU;IACV,WAAW;IACX,WAAW;IACX,iBAAiB;CACT,CAAC;AAKJ,IAAM,kBAAkB,GAAxB,MAAM,kBAAmB,SAAQ,qCAAK;CAsB5C,CAAA;AAtBY,gDAAkB;AAErB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;+CACI;AAKZ;IAHP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;IACf,IAAA,wCAAQ,EAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,sBAAM,EAAE,CAAC;;oDACN;AAIjB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;wDACmB;AAG3B;IADP,IAAA,qCAAK,EAAC,MAAM,CAAC;8BACK,IAAI;qDAAC;AAGhB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;oDACS;AAIjB;IADP,IAAA,qCAAK,EAAC,MAAM,CAAC;;qDACiB;6BArBpB,kBAAkB;IAD9B,IAAA,6CAAa,EAAC,mCAA2B,EAAE,4BAAgB,CAAC;GAChD,kBAAkB,CAsB9B"}
+{"version":3,"file":"tenantBillingState.table.js","sourceRoot":"","sources":["../../../src/db/tables/tenantBillingState.table.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6FAMmD;AACnD,mEAAuE;AACvE,qFAA2E;AAG9D,QAAA,2BAA2B,GAAG,sBAAsB,CAAC;AAErD,QAAA,cAAc,GAAG;IAC5B,MAAM;IACN,QAAQ;IACR,UAAU;IACV,UAAU;IACV,WAAW;IACX,WAAW;IACX,iBAAiB;CACT,CAAC;AAIE,QAAA,wBAAwB,GAAG;IACtC,QAAQ;IACR,SAAS;IACT,SAAS;IACT,MAAM;CACE,CAAC;AASE,QAAA,uBAAuB,GAAG;IACrC,QAAQ;IACR,YAAY;IACZ,YAAY;IACZ,UAAU;IACV,WAAW;IACX,kBAAkB;IAClB,SAAS;CACD,CAAC;AA+CJ,IAAM,kBAAkB,GAAxB,MAAM,kBACX,SAAQ,qCAAK;CAwFd,CAAA;AAzFY,gDAAkB;AAKrB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;+CACI;AAKZ;IAHP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;IACf,IAAA,wCAAQ,EAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,sBAAM,EAAE,CAAC;;oDACN;AAIjB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;wDACmB;AAG3B;IADP,IAAA,qCAAK,EAAC,MAAM,CAAC;8BACK,IAAI;qDAAC;AAGhB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;oDACS;AAIjB;IADP,IAAA,qCAAK,EAAC,MAAM,CAAC;;qDACiB;AAIvB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;kDACc;AAGtB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;oDACgB;AAGxB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;wDAC0B;AAGlC;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;2DACgC;AAGxC;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;+DAC2B;AAGnC;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;oDACgB;AAGxB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;iDACM;AAGd;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;mDACQ;AAIhB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;yDACqB;AAG7B;IADP,IAAA,qCAAK,EAAC,SAAS,CAAC;;2DACgB;AAIzB;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;oDACS;AAGjB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;4DACiB;AAGzB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;wDACa;AAGrB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;uDACiC;AAIzC;IAFP,IAAA,qCAAK,GAAE;IACP,IAAA,qCAAK,EAAC,MAAM,CAAC;;oDACgB;AAGtB;IADP,IAAA,qCAAK,EAAC,MAAM,CAAC;;sDACkB;AAGxB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;uDAC0B;AAGlC;IADP,IAAA,qCAAK,EAAC,SAAS,CAAC;;4DACiB;AAG1B;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;qDACiB;AAGzB;IADP,IAAA,qCAAK,EAAC,QAAQ,CAAC;;sDACkB;6BAxFvB,kBAAkB;IAD9B,IAAA,6CAAa,EAAC,mCAA2B,EAAE,4BAAgB,CAAC;GAChD,kBAAkB,CAyF9B"}

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

@@ -36,6 +36,8 @@ export declare class TenantSubscription extends Table {
     revision: string;
     createdBy: string | null;
     refundRequestedAt: Date | null;
+    deletionRequestedAt: Date | null;
+    deletionRequestedBy: string | null;
     pastDueSince: Date | null;
     freeUntil: Date | null;
     isComplimentary: boolean;

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

@@ -92,6 +92,7 @@ __decorate([
     __metadata("design:type", Object)
 ], TenantSubscription.prototype, "currentPeriodEnd", void 0);
 __decorate([
+    (0, interface_database_decorators_1.Index)({ crossInstance: true }),
     (0, interface_database_decorators_1.Field)("string"),
     (0, interface_database_decorators_1.Relation)({ to: () => plans_table_1.Plan }),
     __metadata("design:type", Object)
@@ -117,6 +118,14 @@ __decorate([
     (0, interface_database_decorators_1.Field)("date"),
     __metadata("design:type", Object)
 ], TenantSubscription.prototype, "refundRequestedAt", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("date"),
+    __metadata("design:type", Object)
+], TenantSubscription.prototype, "deletionRequestedAt", void 0);
+__decorate([
+    (0, interface_database_decorators_1.Field)("string"),
+    __metadata("design:type", Object)
+], TenantSubscription.prototype, "deletionRequestedBy", void 0);
 __decorate([
     (0, exports.DunningClock)(),
     (0, interface_database_decorators_1.Index)(),

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/page-definitions.d.ts

@@ -1,17 +1,10 @@
-import type { MenuOptions, ModuleInfo, PageInfo } from "@antelopejs/interface-dms/page";
+import type { ModuleInfo, PageInfo } from "@antelopejs/interface-dms/page";
 interface SaasModuleDefinition {
     fullId: string;
     fullSlug: string;
     registration: ModuleInfo;
 }
-interface WorkspaceSettingsCategoryDefinition extends Omit<MenuOptions, "category" | "module"> {
-    id: string;
-    fullId: string;
-    fullSlug: string;
-}
 export declare const MODULES_ROOT_DEFINITION: PageInfo;
-export declare const SETTINGS_ROOT_DEFINITION: PageInfo;
 export declare const SAAS_MODULE_ID = "saas";
 export declare const SAAS_MODULE_DEFINITION: SaasModuleDefinition;
-export declare const WORKSPACE_SETTINGS_CATEGORY_DEFINITION: WorkspaceSettingsCategoryDefinition;
 export {};

package/dist/page-definitions.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WORKSPACE_SETTINGS_CATEGORY_DEFINITION = exports.SAAS_MODULE_DEFINITION = exports.SAAS_MODULE_ID = exports.SETTINGS_ROOT_DEFINITION = exports.MODULES_ROOT_DEFINITION = void 0;
+exports.SAAS_MODULE_DEFINITION = exports.SAAS_MODULE_ID = exports.MODULES_ROOT_DEFINITION = void 0;
 exports.MODULES_ROOT_DEFINITION = {
     id: "modules",
     fullId: "modules",
@@ -19,23 +19,6 @@ exports.MODULES_ROOT_DEFINITION = {
     authOnly: undefined,
     bypassTenantAccessGate: undefined,
 };
-exports.SETTINGS_ROOT_DEFINITION = {
-    id: "settings",
-    fullId: "settings",
-    fullSlug: "/settings",
-    layoutUrl: "/settings/pagelayout",
-    category: undefined,
-    displayName: "$page.settings.title",
-    description: "$page.settings.intro",
-    urlSlug: "/settings",
-    icon: "i-ph-gear",
-    order: 3,
-    noComponentPermissions: true,
-    hidden: undefined,
-    publicAccess: undefined,
-    authOnly: undefined,
-    bypassTenantAccessGate: undefined,
-};
 exports.SAAS_MODULE_ID = "saas";
 exports.SAAS_MODULE_DEFINITION = {
     fullId: `${exports.MODULES_ROOT_DEFINITION.fullId}.${exports.SAAS_MODULE_ID}`,
@@ -48,13 +31,4 @@ exports.SAAS_MODULE_DEFINITION = {
         landingPage: "dashboard",
     },
 };
-exports.WORKSPACE_SETTINGS_CATEGORY_DEFINITION = {
-    id: "workspace",
-    fullId: `${exports.SETTINGS_ROOT_DEFINITION.fullId}.workspace`,
-    fullSlug: `${exports.SETTINGS_ROOT_DEFINITION.fullSlug}/workspace`,
-    displayName: "$saas.workspace.settings.title",
-    urlSlug: "workspace",
-    icon: "i-ph-buildings",
-    order: 2,
-};
 //# sourceMappingURL=page-definitions.js.map

package/dist/page-definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-definitions.js","sourceRoot":"","sources":["../src/page-definitions.ts"],"names":[],"mappings":";;;AAqBa,QAAA,uBAAuB,GAAa;IAC/C,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,qBAAqB;IAChC,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,gBAAgB;IAC7B,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,CAAC;IACR,sBAAsB,EAAE,IAAI;IAC5B,YAAY,EAAE,IAAI;IAClB,MAAM,EAAE,SAAS;IACjB,YAAY,EAAE,SAAS;IACvB,QAAQ,EAAE,SAAS;IACnB,sBAAsB,EAAE,SAAS;CAClC,CAAC;AAEW,QAAA,wBAAwB,GAAa;IAChD,EAAE,EAAE,UAAU;IACd,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,WAAW;IACrB,SAAS,EAAE,sBAAsB;IACjC,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,sBAAsB;IACnC,WAAW,EAAE,sBAAsB;IACnC,OAAO,EAAE,WAAW;IACpB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,CAAC;IACR,sBAAsB,EAAE,IAAI;IAC5B,MAAM,EAAE,SAAS;IACjB,YAAY,EAAE,SAAS;IACvB,QAAQ,EAAE,SAAS;IACnB,sBAAsB,EAAE,SAAS;CAClC,CAAC;AAEW,QAAA,cAAc,GAAG,MAAM,CAAC;AAExB,QAAA,sBAAsB,GAAyB;IAC1D,MAAM,EAAE,GAAG,+BAAuB,CAAC,MAAM,IAAI,sBAAc,EAAE;IAC7D,QAAQ,EAAE,GAAG,+BAAuB,CAAC,QAAQ,IAAI,sBAAc,EAAE;IACjE,YAAY,EAAE;QACZ,EAAE,EAAE,sBAAc;QAClB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,0BAA0B;QACvC,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,WAAW;KACzB;CACF,CAAC;AAEW,QAAA,sCAAsC,GACjD;IACE,EAAE,EAAE,WAAW;IACf,MAAM,EAAE,GAAG,gCAAwB,CAAC,MAAM,YAAY;IACtD,QAAQ,EAAE,GAAG,gCAAwB,CAAC,QAAQ,YAAY;IAC1D,WAAW,EAAE,gCAAgC;IAC7C,OAAO,EAAE,WAAW;IACpB,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,CAAC;CACT,CAAC"}
+{"version":3,"file":"page-definitions.js","sourceRoot":"","sources":["../src/page-definitions.ts"],"names":[],"mappings":";;;AAQa,QAAA,uBAAuB,GAAa;IAC/C,EAAE,EAAE,SAAS;IACb,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,qBAAqB;IAChC,QAAQ,EAAE,SAAS;IACnB,WAAW,EAAE,gBAAgB;IAC7B,WAAW,EAAE,gBAAgB;IAC7B,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,mBAAmB;IACzB,KAAK,EAAE,CAAC;IACR,sBAAsB,EAAE,IAAI;IAC5B,YAAY,EAAE,IAAI;IAClB,MAAM,EAAE,SAAS;IACjB,YAAY,EAAE,SAAS;IACvB,QAAQ,EAAE,SAAS;IACnB,sBAAsB,EAAE,SAAS;CAClC,CAAC;AAEW,QAAA,cAAc,GAAG,MAAM,CAAC;AAExB,QAAA,sBAAsB,GAAyB;IAC1D,MAAM,EAAE,GAAG,+BAAuB,CAAC,MAAM,IAAI,sBAAc,EAAE;IAC7D,QAAQ,EAAE,GAAG,+BAAuB,CAAC,QAAQ,IAAI,sBAAc,EAAE;IACjE,YAAY,EAAE;QACZ,EAAE,EAAE,sBAAc;QAClB,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,0BAA0B;QACvC,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,WAAW;KACzB;CACF,CAAC"}

package/dist/pages.d.ts

@@ -1,7 +1,5 @@
 import type { Component, PlacementSide } from "@antelopejs/interface-dms/component";
 import { type CategoryInfo, type PageExtensionComponent } from "@antelopejs/interface-dms/page";
-export declare const workspaceSettingsCategory: CategoryInfo;
-export declare const GetWorkspaceSettingsCategory: () => Promise<CategoryInfo>;
 export declare const tenantBillingPage: {
     readonly id: "billing";
     readonly fullId: "settings.workspace.billing";
@@ -17,6 +15,7 @@ export declare const tenantBillingPage: {
     };
 };
 export type TenantBillingPageComponentKey = (typeof tenantBillingPage.components)[keyof typeof tenantBillingPage.components];
+export declare const tenantBillingPageAnchorPaths: Readonly<Record<TenantBillingPageComponentKey, readonly string[]>>;
 export interface TenantBillingPageExtensionComponentBase {
     key: string;
     component: Component;

package/dist/pages.js

@@ -1,19 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.platformWorkspaceDetailPage = exports.GetPlatformSaasModule = exports.platformSaasModule = exports.tenantBillingPage = exports.GetWorkspaceSettingsCategory = exports.workspaceSettingsCategory = void 0;
+exports.platformWorkspaceDetailPage = exports.GetPlatformSaasModule = exports.platformSaasModule = exports.tenantBillingPageAnchorPaths = exports.tenantBillingPage = void 0;
 exports.RegisterTenantBillingPageExtension = RegisterTenantBillingPageExtension;
 exports.RegisterPlatformWorkspaceDetailPageExtension = RegisterPlatformWorkspaceDetailPageExtension;
 const interface_core_1 = require("@antelopejs/interface-core");
 const page_1 = require("@antelopejs/interface-dms/page");
 const page_definitions_1 = require("./page-definitions");
-exports.workspaceSettingsCategory = {
-    ...page_definitions_1.WORKSPACE_SETTINGS_CATEGORY_DEFINITION,
-    category: page_definitions_1.SETTINGS_ROOT_DEFINITION,
-    urlTransparent: false,
-    hidden: undefined,
-    bypassTenantAccessGate: undefined,
-};
-exports.GetWorkspaceSettingsCategory = (0, interface_core_1.InterfaceFunction)();
 exports.tenantBillingPage = {
     id: "billing",
     fullId: "settings.workspace.billing",
@@ -28,6 +20,15 @@ exports.tenantBillingPage = {
         table: "table",
     },
 };
+exports.tenantBillingPageAnchorPaths = {
+    freeAccessBanner: ["freeAccessBanner"],
+    pastDueAlert: ["pastDueAlert"],
+    planCard: ["overview", "plan", "current", "planCard"],
+    paymentMethod: ["overview", "payment", "method", "paymentMethod"],
+    refundButton: ["overview", "payment", "guarantee", "refundButton"],
+    billingForm: ["billingForm"],
+    table: ["invoices", "table"],
+};
 exports.platformSaasModule = {
     id: page_definitions_1.SAAS_MODULE_DEFINITION.registration.id,
     fullId: page_definitions_1.SAAS_MODULE_DEFINITION.fullId,
@@ -59,8 +60,9 @@ function toPageExtensionComponent(input) {
         side: input.side ?? "end",
         order: input.order ?? 0,
     };
-    if (input.anchorKey)
-        component.anchorPath = [input.anchorKey];
+    if (input.anchorKey) {
+        component.anchorPath = exports.tenantBillingPageAnchorPaths[input.anchorKey];
+    }
     return component;
 }
 function RegisterTenantBillingPageExtension(extension) {

package/dist/pages.js.map

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

package/dist/plans.d.ts

@@ -23,7 +23,7 @@ export interface TenantPlanCatalog {
     features: TenantPlanFeature[];
 }
 export declare function monthlyPrice(plan: Plan): number;
-export declare function isDowngrade(current: Plan | null, target: Plan): boolean;
+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 buildTenantPlanCatalog(planModel: PlanModel, featureModel: FeatureModel, plans: Plan[], locale: string): Promise<TenantPlanCatalog>;

package/dist/plans.js

@@ -13,14 +13,24 @@ const MONTHS_PER_INTERVAL = {
 function monthlyPrice(plan) {
     return plan.price / MONTHS_PER_INTERVAL[plan.interval];
 }
-function isDowngrade(current, target) {
+const SEAT_BILLING_MODE = "seat";
+const MIN_BILLED_SEATS = 1;
+function monthlyCost(plan, seats) {
+    const units = plan.billingMode === SEAT_BILLING_MODE
+        ? Math.max(MIN_BILLED_SEATS, seats)
+        : 1;
+    return monthlyPrice(plan) * units;
+}
+function isDowngrade(current, target, seats = MIN_BILLED_SEATS) {
     if (!current)
         return false;
-    return monthlyPrice(target) < monthlyPrice(current);
+    return monthlyCost(target, seats) < monthlyCost(current, seats);
 }
 exports.FEATURE_LOCALIZED_FIELDS = [
     "displayName",
+    "description",
     "tooltip",
+    "unit",
 ];
 function localizeFeature(feature, locale) {
     return feature.localize(locale, exports.FEATURE_LOCALIZED_FIELDS);

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/docs/1.index.md

@@ -0,0 +1,47 @@
+---
+title: SaaS interface
+description: Supported backend imports and side-effect boundaries for modules extending DMS SaaS.
+---
+
+# SaaS interface
+
+Consumers depend on `@antelopejs/interface-dms-saas`, not the runtime's private services or page controllers. Load `@antelopejs/dms-saas` in the same AntelopeJS project for functions that need an implementation. Compile with `moduleResolution: "bundler"`, `"node16"` or `"nodenext"` so subpaths resolve through the package's exports map.
+
+## Entry points
+
+| Import after `@antelopejs/interface-dms-saas` | Contract |
+| --- | --- |
+| Root | Billing, data API, pages, plans, provisioning and registration exports; `invoiceLineItems` and `workspaceLifecycle` 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) |
+| `/workspace-lifecycle` | [Durable lifecycle consumers and provisioning gate](./3.lifecycle-and-usage.md#workspace-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) |
+| `/plans` | [Plan projections, localization and pricing helpers](./4.pages-plans-data.md#plan-helpers) |
+| `/data-api`, `/hidden-filter` | [HiddenStringFilter](./4.pages-plans-data.md#hiddenstringfilter) |
+| `/db`, `/db/models`, `/db/tables` | Canonical SaaS models and table classes; see the data boundary below |
+
+`invoiceLineItems` and `workspaceLifecycle` are namespaces at the root, not flat exports. Use their direct subpaths for individual functions. Their `internal` proxy namespaces are implementation plumbing, not consumer APIs.
+
+```ts docs-check
+import { invoiceLineItems, workspaceLifecycle } from "@antelopejs/interface-dms-saas";
+
+export const usageKey = invoiceLineItems.buildInvoiceLineKey("example.compute", "minutes");
+
+export async function mayProvision(tenantId: string): Promise<boolean> {
+  // Errors propagate: unavailable storage must not grant eligibility.
+  return workspaceLifecycle.IsWorkspaceProvisioningCommitted(tenantId);
+}
+```
+
+## Database imports have side effects
+
+The root does not re-export `db`. Importing `/db` registers the canonical SaaS tables; do not create duplicate table definitions or load the runtime's registration graph to reach them. Prefer `import type` when only a type is needed. The root also exports plan helpers that import database values, so do not assume that a root value import avoids all transitive table registration. Narrow subpaths express which contract the consumer needs.
+
+Database exports are persistence primitives, not an authorization or billing-service API. Use tenant-scoped models with the correct tenant, and keep direct writes in trusted import/seed code. Direct writes do not automatically perform all Stripe, lifecycle, cache and directory work of the runtime's normal operations.
+
+After seeding or importing subscription records, call [RecomputeTenantBillingState](./2.billing.md#recomputetenantbillingstate) for each affected tenant once writes finish. This republishes derived billing and directory state; it does not make an arbitrary direct write equivalent to a normal billing operation. When seeding plans, leave `Plan.paymentProviderRefs` empty and never overwrite the runtime's Stripe linkage. See the [plan and Stripe guide](/docs/modules/saas/stripe#plans-and-stripe).
+
+`workspaceSettingsCategory` belongs to `@antelopejs/interface-dms/page`, not this package. There is no SaaS `GetWorkspaceSettingsCategory` export. Use `/pages` for SaaS billing and platform-workspace extension anchors.
+
+The [runtime guide](/docs/modules/saas/extending) covers installation, public screens, UI integration and examples. These pages define the backend consumer contracts.

package/docs/2.billing.md

@@ -0,0 +1,66 @@
+---
+title: Billing
+description: Authorized customer balances and invoice previews, and republishing derived billing state after direct writes.
+---
+
+# Billing
+
+Import these functions and types from `@antelopejs/interface-dms-saas/billing` or the package root.
+
+## 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.
+
+| Result | Fields |
+| --- | --- |
+| `AvailableTenantCustomerBalance` | `status: "available"`, `balanceMinorUnits: number`, `currency: string` |
+| `AbsentTenantCustomerBalance` | `status: "absent"`, `reason: TenantCustomerBalanceAbsenceReason`, `balanceMinorUnits: null`, `currency: null` |
+
+Amounts are Stripe minor units: negative means customer credit, positive means money owed, and zero means settled. Currency is uppercase ISO 4217. Absence reasons are `complimentary`, `customer_not_configured`, `customer_deleted`, and `currency_unavailable`. Stripe read failures reject with 502 and `saas.errors.billing.customer_balance_provider_unavailable`; they are not an absent balance. This call does not charge or refund the customer.
+
+`isComplimentarySubscription(subscription: ComplimentarySubscriptionState | null | undefined): boolean` is a synchronous helper. `ComplimentarySubscriptionState` has `isComplimentary?: boolean | null`; only an explicit `true` returns true. A free plan alone is not the complimentary marker.
+
+## GetUpcomingInvoicePreview
+
+`GetUpcomingInvoicePreview(scope: UpcomingInvoicePreviewScope): Promise<UpcomingInvoicePreview>` uses the same `{ tenantId, userId }` scope and authorization checks. Stripe failures become an `unavailable` result rather than an invented total; authentication, implementation availability or local storage failures can still reject.
+
+| `status` | Result type and reason |
+| --- | --- |
+| `available` | `AvailableUpcomingInvoicePreview`: Stripe priced the next invoice |
+| `absent` | `AbsentUpcomingInvoicePreview`: `complimentary`, `free_plan`, `customer_not_configured`, `subscription_not_configured`, or `no_upcoming_invoice` |
+| `unavailable` | `UnavailableUpcomingInvoicePreview`: `stripe_not_configured`, `tax_not_configured`, `tax_location_invalid`, `tax_location_required`, `tax_calculation_failed`, `usage_unavailable`, or `provider_error` |
+
+Both non-available variants have `reason` and `computedAt: string`. The corresponding exported unions are `UpcomingInvoicePreviewAbsenceReason` and `UpcomingInvoicePreviewUnavailableReason`.
+
+An available preview includes these fields. All amounts are integers in the minor units of its uppercase `currency`; all dates are ISO 8601 strings.
+
+| Fields | Type and meaning |
+| --- | --- |
+| `subtotalMinorUnits`, `totalExcludingTaxMinorUnits`, `taxMinorUnits`, `totalMinorUnits`, `amountDueMinorUnits` | `number`: subtotal before discounts/tax; total after discounts before tax; tax; tax-inclusive total; amount after customer balance |
+| `lines`, `hasMoreLines` | `UpcomingInvoiceLine[]`, `boolean`: line page and truncation flag; totals remain complete |
+| `taxes`, `taxCountry`, `isReverseCharge` | `UpcomingInvoiceTax[]`, `string \| null`, `boolean` |
+| `periodStart`, `periodEnd`, `billingDate`, `computedAt` | `string`: cycle bounds, issue date and computation time |
+| `usageThrough` | `string \| null`: end of quoted usage, null without usage lines |
+
+`UpcomingInvoiceLine` has `kind: UpcomingInvoiceLineKind` (`subscription`, `usage`, or `invoice_item`), `description: string | null`, `amountMinorUnits: number`, `taxMinorUnits: number`, `quantity: number | null`, `periodStart: string`, `periodEnd: string`, `isProration: boolean`, `usageLineKey: string | null`, and `productId: string | null`. Usage keys are `<provider id>:<key>`; other line kinds have a null usage key.
+
+`UpcomingInvoiceTax` has `amountMinorUnits: number`, `taxableAmountMinorUnits: number | null`, `isInclusive: boolean`, `ratePercentage: number | null`, `isReverseCharge: boolean`, and nullable string fields `country`, `taxType`, `displayName`, `jurisdiction`, and `taxabilityReason`. A reverse charge can produce zero tax with `isReverseCharge: true`.
+
+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).
+
+## 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.
+
+This is a trusted administrative call with no user scope or membership check. Authorize the tenant before invoking it. It writes derived database state, does not mutate the Stripe subscription, and does not replace lifecycle delivery or preview-cache invalidation. Deleted directory rows and subscriptions whose deletion has started are left alone. Storage errors propagate; repeated concurrent-publication conflicts reject after bounded retries. Await completion and report failures instead of displaying stale directory state as current.
+
+```ts docs-check
+import { RecomputeTenantBillingState } from "@antelopejs/interface-dms-saas/billing";
+
+// Invoke only after the import has committed all rows for these authorized tenants.
+export async function refreshImportedTenants(tenantIds: readonly string[]): Promise<void> {
+  for (const tenantId of new Set(tenantIds)) {
+    await RecomputeTenantBillingState(tenantId);
+  }
+}
+```