@antelopejs/interface-dms-saas 0.3.0 → 0.4.1

package/README.md

@@ -1,76 +1,85 @@
+<div align="center">
+
 # @antelopejs/interface-dms-saas
 
-<div align="center">
-<a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/license-Apache--2.0-blue?style=for-the-badge&labelColor=000000"></a>
-<a href="https://discord.gg/sjK28QHrA7"><img src="https://img.shields.io/badge/Discord-18181B?logo=discord&style=for-the-badge&color=000000" alt="Discord"></a>
-<a href="https://antelopejs.com"><img src="https://img.shields.io/badge/Docs-18181B?style=for-the-badge&color=000000" alt="Documentation"></a>
+<a href="https://www.npmjs.com/package/@antelopejs/interface-dms-saas"><img alt="npm" src="https://img.shields.io/npm/v/@antelopejs/interface-dms-saas?style=for-the-badge&labelColor=000000&color=000000"></a>
+<a href="./LICENSE"><img alt="License" src="https://img.shields.io/npm/l/@antelopejs/interface-dms-saas?style=for-the-badge&labelColor=000000&color=000000"></a>
+<a href="https://discord.gg/sjK28QHrA7"><img alt="Discord" src="https://img.shields.io/badge/Discord-18181B?logo=discord&style=for-the-badge&color=000000"></a>
+<a href="https://dms.antelopejs.com/docs/modules/saas/extending"><img alt="Documentation" src="https://img.shields.io/badge/Docs-18181B?style=for-the-badge&color=000000"></a>
+
+The AntelopeJS interface to extend the DMS SaaS module: billing, plans, registration, workspace pages and lifecycle.
+
 </div>
 
-Public interfaces of the AntelopeJS DMS SaaS module.
+## What it does
 
-A module that extends `@antelopejs/dms-saas` depends on this package rather than
-on the runtime, and imports the extension points from it:
+- Adds invoice line items, reads customer balances and previews the upcoming invoice.
+- Builds plan projections and catalogues, and normalizes prices.
+- Extends registration and the provisioning of a new workspace.
+- Adds workspace settings categories and blocks to the tenant billing page.
+- Listens to workspace lifecycle events and operator actions, and exposes the canonical SaaS tables and models (`/db`).
 
-| Subpath | Surface |
-| --- | --- |
-| `@antelopejs/interface-dms-saas` | every extension point except `db`: billing, data API, pages, plans, provisioning and registration flat, plus the `invoiceLineItems` and `workspaceLifecycle` namespaces |
-| `@antelopejs/interface-dms-saas/billing` | customer balance, upcoming invoice preview and complimentary subscription state |
-| `@antelopejs/interface-dms-saas/data-api` | hidden-value data API filters |
-| `@antelopejs/interface-dms-saas/db` | canonical SaaS tables and data models |
-| `@antelopejs/interface-dms-saas/hidden-filter` | the `HiddenStringFilter` decorator on its own |
-| `@antelopejs/interface-dms-saas/invoice-line-items` | provider registration, line item types, line key helpers |
-| `@antelopejs/interface-dms-saas/page-definitions` | page and module ids, slugs and descriptors |
-| `@antelopejs/interface-dms-saas/pages` | workspace settings category and tenant billing page extensions |
-| `@antelopejs/interface-dms-saas/plans` | plan projections, catalog builder, and price normalization |
-| `@antelopejs/interface-dms-saas/provisioning` | provisioning hook payload |
-| `@antelopejs/interface-dms-saas/registration` | public registration capture limits |
-| `@antelopejs/interface-dms-saas/workspace-lifecycle` | workspace lifecycle events and operator actions |
-
-Two of those surfaces reach the root entry as namespaces rather than flat
-re-exports, because each exposes an `internal` proxy namespace and two
-`internal` names cannot coexist in one barrel:
-
-```ts
+A module that extends [`@antelopejs/dms-saas`](https://www.npmjs.com/package/@antelopejs/dms-saas) depends on this package, never on the runtime.
+
+## Install
+
+```bash
+pnpm add @antelopejs/interface-dms-saas
+```
+
+## Quick start
+
+The root entry holds every extension point except `db`, with `invoiceLineItems` and `workspaceLifecycle` as namespaces:
+
+```ts docs-check
 import { invoiceLineItems, workspaceLifecycle } from "@antelopejs/interface-dms-saas";
 
-invoiceLineItems.RegisterInvoiceLineItemsProvider(/* … */);
+export const usageKey = invoiceLineItems.buildInvoiceLineKey("example.compute", "minutes");
+export const isProvisioningCommitted = workspaceLifecycle.IsWorkspaceProvisioningCommitted;
 ```
 
-Their own subpaths stay the direct route to the same symbols. `./db` is the one
-surface the root entry leaves out: importing it registers the SaaS tables, and a
-consumer that only wants types should not pay for that.
-
-Subpaths resolve through the `exports` map only, so consumers must compile with
-`moduleResolution` set to `bundler`, `node16` or `nodenext`; the legacy `node`
-(node10) mode is not supported.
-
-This package is released on its own workflow and must be published before the
-runtime module: `@antelopejs/dms-saas` depends on it through
-`>=<interface version> <0.<minor + 1>.0`, a range that only resolves once this
-package is released. The runtime implements this interface, so it caps the range
-below the next minor: a breaking minor of this package never reaches an older
-dms-saas.
-
-## Writing plans
-
-A module may seed plans straight into the `db` plan table. It leaves
-`Plan.paymentProviderRefs` empty on creation and never rewrites it: dms-saas
-links every plan billed through Stripe to a matching Stripe product and price,
-at startup and whenever the plan is offered or billed, and records what it
-synced in `paymentProviderRefs.stripeSyncedTerms`. See
-[Plans and Stripe](../dms-saas/README.md#plans-and-stripe).
-
-## Upgrading
-
-### Rows written by earlier builds
-
-The data contract no longer tolerates rows that predate the current fields:
-`TenantSubscription.isComplimentary` is a required boolean and
-`isComplimentarySubscription` only returns `true` for `isComplimentary: true`,
-`InvoiceModel.getAllInvoices` only matches `documentType: "invoice"`,
-`WebhookResult` no longer includes `failed`, `TenantSubscription.paidUsagePeriods`
-is a required array that alone decides billable usage, and `revision` is
-required on `TenantSubscription`, `Segment`, `UserSegment`, `PlanMigration` and
-`StripeWebhookEvent`, whose revision-fenced writes refuse a row without one.
-Fix such rows before upgrading, as described in the
-[`@antelopejs/dms-saas` upgrade notes](../dms-saas/README.md#upgrading).
+Use the [entry-point reference](./docs/1.index.md#entry-points) for supported
+subpaths. Importing `/db` registers SaaS tables; it is not a side-effect-free
+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).
+
+## Compatibility
+
+The implementation is `@antelopejs/dms-saas >=0.6.0`. The interface declares these dependencies:
+
+<!-- docs-compat: ./package.json#dependencies -->
+
+| Package | Range |
+| --- | --- |
+| `@antelopejs/interface-data-api` | `>=0.2.2 <1.0.0` |
+| `@antelopejs/interface-dms` | `>=0.7.2 <1.0.0` |
+
+Peer dependencies:
+
+<!-- docs-compat: ./package.json#peerDependencies -->
+
+| Package | Range |
+| --- | --- |
+| `@antelopejs/interface-core` | `>=0.2.4 <1.0.0` |
+| `@antelopejs/interface-database` | `>=0.1.10 <1.0.0` |
+| `@antelopejs/interface-database-decorators` | `>=0.1.9 <1.0.0` |
+
+Subpaths resolve through the `exports` map only: compile consumers with `moduleResolution` set to `bundler`, `node16` or `nodenext`. Upgrade this package together with `@antelopejs/dms-saas`; the [upgrade notes](https://dms.antelopejs.com/docs/modules/saas/faq#upgrading) cover the tenant billing page anchors and the rows written by earlier builds.
+
+## Documentation
+
+- [Consumer reference](./docs/1.index.md): billing, usage, lifecycle, pages, plans and database boundaries
+- [Extending the SaaS module](https://dms.antelopejs.com/docs/modules/saas/extending): every extension point with examples
+- [Stripe](https://dms.antelopejs.com/docs/modules/saas/stripe)
+- [SaaS module guide](https://dms.antelopejs.com/docs/modules/saas)
+
+## Contributing
+
+This package lives in the [`AntelopeJS/dms-saas`](https://github.com/AntelopeJS/dms-saas) pnpm workspace, next to the module that implements it. Read [CONTRIBUTING.md](https://github.com/AntelopeJS/dms-saas/blob/main/CONTRIBUTING.md) and the [repository README](https://github.com/AntelopeJS/dms-saas#contributing) for the development commands. Release this package on its own workflow before the module that implements it.
+
+## License
+
+[Apache-2.0](./LICENSE)

package/dist/billing.d.ts

@@ -32,6 +32,7 @@ export interface UpcomingInvoiceLine {
     periodEnd: string;
     isProration: boolean;
     usageLineKey: string | null;
+    productId: string | null;
 }
 export interface UpcomingInvoiceTax {
     amountMinorUnits: number;
@@ -78,3 +79,4 @@ export interface UnavailableUpcomingInvoicePreview {
 }
 export type UpcomingInvoicePreview = AvailableUpcomingInvoicePreview | AbsentUpcomingInvoicePreview | UnavailableUpcomingInvoicePreview;
 export declare const GetUpcomingInvoicePreview: (scope: TenantCustomerBalanceScope) => Promise<UpcomingInvoicePreview>;
+export declare const RecomputeTenantBillingState: (tenantId: string) => Promise<void>;

package/dist/billing.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetUpcomingInvoicePreview = exports.GetTenantCustomerBalance = void 0;
+exports.RecomputeTenantBillingState = exports.GetUpcomingInvoicePreview = exports.GetTenantCustomerBalance = void 0;
 exports.isComplimentarySubscription = isComplimentarySubscription;
 const interface_core_1 = require("@antelopejs/interface-core");
 function isComplimentarySubscription(subscription) {
@@ -8,4 +8,5 @@ function isComplimentarySubscription(subscription) {
 }
 exports.GetTenantCustomerBalance = (0, interface_core_1.InterfaceFunction)();
 exports.GetUpcomingInvoicePreview = (0, interface_core_1.InterfaceFunction)();
+exports.RecomputeTenantBillingState = (0, interface_core_1.InterfaceFunction)();
 //# sourceMappingURL=billing.js.map

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;AAiIO,QAAA,yBAAyB,GACpC,IAAA,kCAAiB,GAEd,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;AAwCY,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/billingSettings.model.d.ts

@@ -12,6 +12,7 @@ declare const BillingSettingsModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<BillingSettings>;
     fromPlainData(obj: any): BillingSettings;
     fromDatabase(obj: any): BillingSettings | undefined;
     toDatabase(obj: any): Record<string, any>;

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

@@ -13,6 +13,7 @@ declare const CreditNoteModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<CreditNote>;
     fromPlainData(obj: any): CreditNote;
     fromDatabase(obj: any): CreditNote | undefined;
     toDatabase(obj: any): Record<string, any>;
@@ -20,6 +21,7 @@ declare const CreditNoteModel_base: {
 };
 export declare class CreditNoteModel extends CreditNoteModel_base {
     updateUnlessVoided(id: string, patch: DeepPartial<CreditNote>): Promise<boolean>;
+    findByInvoice(invoiceId: string): Promise<CreditNote[]>;
     findOneByStripeCreditNote(stripeCreditNoteId: string): Promise<CreditNote | undefined>;
 }
 export {};

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

@@ -13,6 +13,15 @@ class CreditNoteModel extends (0, interface_database_decorators_1.BasicDataModel
             .run();
         return (0, update_result_1.hasSelectedRow)(result);
     }
+    async findByInvoice(invoiceId) {
+        const rows = await this.table
+            .getAll(invoiceId, "invoiceId")
+            .orderBy("issuedAt")
+            .run();
+        return rows
+            .map((row) => CreditNoteModel.fromDatabase(row))
+            .filter((row) => row !== undefined);
+    }
     async findOneByStripeCreditNote(stripeCreditNoteId) {
         const row = await this.table
             .getAll(stripeCreditNoteId, "stripeCreditNoteId")

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

@@ -1 +1 @@
-{"version":3,"file":"creditNotes.model.js","sourceRoot":"","sources":["../../../src/db/models/creditNotes.model.ts"],"names":[],"mappings":";;;AACA,6FAA2E;AAC3E,mEAA+E;AAC/E,mDAAiD;AAGjD,MAAa,eAAgB,SAAQ,IAAA,8CAAc,EACjD,8BAAU,EACV,wCAAoB,CACrB;IAEC,KAAK,CAAC,kBAAkB,CACtB,EAAU,EACV,KAA8B;QAE9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK;aAC5B,MAAM,CAAC,EAAE,CAAC;aACV,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;aAC7C,MAAM,CAAC,KAAK,CAAC;aACb,GAAG,EAAE,CAAC;QACT,OAAO,IAAA,8BAAc,EAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,yBAAyB,CAC7B,kBAA0B;QAE1B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK;aACzB,MAAM,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;aAChD,GAAG,CAAC,CAAC,CAAC;aACN,OAAO,CAAC,SAAS,CAAC;aAClB,GAAG,EAAE,CAAC;QACT,OAAO,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;CACF;AA3BD,0CA2BC"}
+{"version":3,"file":"creditNotes.model.js","sourceRoot":"","sources":["../../../src/db/models/creditNotes.model.ts"],"names":[],"mappings":";;;AACA,6FAA2E;AAC3E,mEAA+E;AAC/E,mDAAiD;AAGjD,MAAa,eAAgB,SAAQ,IAAA,8CAAc,EACjD,8BAAU,EACV,wCAAoB,CACrB;IAEC,KAAK,CAAC,kBAAkB,CACtB,EAAU,EACV,KAA8B;QAE9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK;aAC5B,MAAM,CAAC,EAAE,CAAC;aACV,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;aAC7C,MAAM,CAAC,KAAK,CAAC;aACb,GAAG,EAAE,CAAC;QACT,OAAO,IAAA,8BAAc,EAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAGD,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK;aAC1B,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC;aAC9B,OAAO,CAAC,UAAU,CAAC;aACnB,GAAG,EAAE,CAAC;QACT,OAAO,IAAI;aACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;aAC/C,MAAM,CAAC,CAAC,GAAG,EAAqB,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,yBAAyB,CAC7B,kBAA0B;QAE1B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK;aACzB,MAAM,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;aAChD,GAAG,CAAC,CAAC,CAAC;aACN,OAAO,CAAC,SAAS,CAAC;aAClB,GAAG,EAAE,CAAC;QACT,OAAO,GAAG,CAAC,CAAC,CAAC,eAAe,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,CAAC;CACF;AAtCD,0CAsCC"}

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

@@ -12,6 +12,7 @@ declare const FeatureModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<Feature>;
     fromPlainData(obj: any): Feature;
     fromDatabase(obj: any): Feature | undefined;
     toDatabase(obj: any): Record<string, any>;

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

@@ -13,6 +13,7 @@ declare const InvoiceModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<Invoice>;
     fromPlainData(obj: any): Invoice;
     fromDatabase(obj: any): Invoice | undefined;
     toDatabase(obj: any): Record<string, any>;

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

@@ -12,6 +12,7 @@ declare const LegalDocumentsModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<LegalDocuments>;
     fromPlainData(obj: any): LegalDocuments;
     fromDatabase(obj: any): LegalDocuments | undefined;
     toDatabase(obj: any): Record<string, any>;

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

@@ -1,5 +1,5 @@
 import { type DeepPartial, type ValidateOptions } from "@antelopejs/interface-database-decorators";
-import { PlanMigration, type PlanMigrationSnapshot } from "../tables/planMigrations.table";
+import { PlanMigration, type PlanMigrationSnapshot, type PlanMigrationStage } from "../tables/planMigrations.table";
 declare const PlanMigrationModel_base: {
     new (database: import("@antelopejs/interface-database").SchemaInstance<any>): {
         readonly table: import("@antelopejs/interface-database").Table<PlanMigration>;
@@ -13,6 +13,7 @@ declare const PlanMigrationModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<PlanMigration>;
     fromPlainData(obj: any): PlanMigration;
     fromDatabase(obj: any): PlanMigration | undefined;
     toDatabase(obj: any): Record<string, any>;
@@ -23,8 +24,11 @@ export declare class PlanMigrationModel extends PlanMigrationModel_base {
     beginJob(job: PlanMigration, snapshot: PlanMigrationSnapshot): Promise<boolean>;
     checkpoint(job: PlanMigration, patch: Partial<PlanMigration>): Promise<void>;
     markInterrupted(job: PlanMigration): Promise<boolean>;
+    updateSettled(job: PlanMigration, patch: Partial<PlanMigration>): Promise<boolean>;
+    reopen(job: PlanMigration): Promise<boolean>;
     private persist;
     findResumable(): Promise<PlanMigration[]>;
-    existsPendingOrRunningForPlan(fromPlanId: string): Promise<boolean>;
+    existsUnsettledForPlan(fromPlanId: string): Promise<boolean>;
+    findByStage(stage: PlanMigrationStage): Promise<PlanMigration[]>;
 }
 export {};

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

@@ -10,6 +10,7 @@ class PlanMigrationModel extends (0, interface_database_decorators_1.BasicDataMo
             ...row,
             revision: (0, node_crypto_1.randomUUID)(),
             tenantOutcomes: [],
+            stage: (0, planMigrations_table_1.planMigrationStageOf)(row.status ?? "pending"),
         });
         return super.insert(Array.isArray(rows) ? rows.map(initialize) : initialize(rows), options);
     }
@@ -32,22 +33,35 @@ class PlanMigrationModel extends (0, interface_database_decorators_1.BasicDataMo
             return false;
         return this.persist(job, { status: "reconciliation_required" });
     }
+    async updateSettled(job, patch) {
+        if ((0, planMigrations_table_1.isPlanMigrationExecuting)(job.status))
+            return false;
+        return this.persist(job, patch);
+    }
+    async reopen(job) {
+        if ((0, planMigrations_table_1.isPlanMigrationExecuting)(job.status))
+            return false;
+        return this.persist(job, { status: "running", completedAt: null });
+    }
     async persist(job, patch) {
         const nextRevision = (0, node_crypto_1.randomUUID)();
+        const written = patch.status
+            ? { ...patch, stage: (0, planMigrations_table_1.planMigrationStageOf)(patch.status) }
+            : patch;
         const outcome = await this.table
             .atomicMutation(job._id, {
             type: "update",
             revisionField: "revision",
             expectedRevision: job.revision,
             nextRevision,
-            patch,
+            patch: written,
         })
             .run();
         if (outcome === "unknown")
             throw new Error("Migration acknowledgement unknown; reconciliation required");
         if (outcome !== "applied")
             return false;
-        Object.assign(job, patch, { revision: nextRevision });
+        Object.assign(job, written, { revision: nextRevision });
         return true;
     }
     async findResumable() {
@@ -58,18 +72,21 @@ class PlanMigrationModel extends (0, interface_database_decorators_1.BasicDataMo
             .map((row) => PlanMigrationModel.fromDatabase(row))
             .filter((row) => row !== undefined);
     }
-    async existsPendingOrRunningForPlan(fromPlanId) {
+    async existsUnsettledForPlan(fromPlanId) {
         const count = await this.table
             .getAll(fromPlanId, "fromPlanId")
-            .filter((row) => row
-            .key("status")
-            .eq("pending")
-            .or(row.key("status").eq("running"))
-            .or(row.key("status").eq("reconciliation_required")))
+            .filter((row) => row.key("stage").ne("done"))
             .count()
             .run();
         return count > 0;
     }
+    async findByStage(stage) {
+        const rows = await this.table.getAll(stage, "stage").run();
+        return rows
+            .map((row) => PlanMigrationModel.fromDatabase(row))
+            .filter((row) => row !== undefined)
+            .sort((left, right) => right.createdAt.getTime() - left.createdAt.getTime());
+    }
 }
 exports.PlanMigrationModel = PlanMigrationModel;
 //# sourceMappingURL=planMigrations.model.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"planMigrations.model.js","sourceRoot":"","sources":["../../../src/db/models/planMigrations.model.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AACzC,6FAImD;AACnD,yEAIwC;AAGxC,MAAa,kBAAmB,SAAQ,IAAA,8CAAc,EACpD,oCAAa,EACb,8CAAuB,CACxB;IAEU,MAAM,CACb,IAA+D,EAC/D,OAAyB;QAEzB,MAAM,UAAU,GAAG,CACjB,GAA+B,EACH,EAAE,CAAC,CAAC;YAChC,GAAG,GAAG;YACN,QAAQ,EAAE,IAAA,wBAAU,GAAE;YACtB,cAAc,EAAE,EAAE;SACnB,CAAC,CAAC;QACH,OAAO,KAAK,CAAC,MAAM,CACjB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAC7D,OAAO,CACR,CAAC;IACJ,CAAC;IAGD,KAAK,CAAC,QAAQ,CACZ,GAAkB,EAClB,QAA+B;QAE/B,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YACvB,QAAQ;YACR,eAAe,EAAE,QAAQ,CAAC,SAAS,CAAC,MAAM;YAC1C,MAAM,EAAE,SAAS;YACjB,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAGD,KAAK,CAAC,UAAU,CACd,GAAkB,EAClB,KAA6B;QAE7B,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC3E,CAAC;IAGD,KAAK,CAAC,eAAe,CAAC,GAAkB;QACtC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC,CAAC;IAClE,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,GAAkB,EAClB,KAA6B;QAE7B,MAAM,YAAY,GAAG,IAAA,wBAAU,GAAE,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK;aAC7B,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE;YACvB,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,UAAU;YACzB,gBAAgB,EAAE,GAAG,CAAC,QAAQ;YAC9B,YAAY;YACZ,KAAK;SACN,CAAC;aACD,GAAG,EAAE,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;QACJ,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAGD,KAAK,CAAC,aAAa;QACjB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK;aAC1B,MAAM,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC;aACxC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI;aACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,kBAAkB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;aAClD,MAAM,CAAC,CAAC,GAAG,EAAwB,EAAE,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;IAC9D,CAAC;IAGD,KAAK,CAAC,6BAA6B,CAAC,UAAkB;QACpD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK;aAC3B,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC;aAChC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACd,GAAG;aACA,GAAG,CAAC,QAAQ,CAAC;aACb,EAAE,CAAC,SAAS,CAAC;aACb,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;aACnC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,CACvD;aACA,KAAK,EAAE;aACP,GAAG,EAAE,CAAC;QACT,OAAO,KAAK,GAAG,CAAC,CAAC;IACnB,CAAC;CACF;AAnGD,gDAmGC"}
+{"version":3,"file":"planMigrations.model.js","sourceRoot":"","sources":["../../../src/db/models/planMigrations.model.ts"],"names":[],"mappings":"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"}

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

@@ -16,6 +16,7 @@ declare const PlanModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<Plan>;
     fromPlainData(obj: any): Plan;
     fromDatabase(obj: any): Plan | undefined;
     toDatabase(obj: any): Record<string, any>;

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

@@ -22,6 +22,7 @@ declare const PlatformNoteModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<PlatformNote>;
     fromPlainData(obj: any): PlatformNote;
     fromDatabase(obj: any): PlatformNote | undefined;
     toDatabase(obj: any): Record<string, any>;

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

@@ -12,6 +12,7 @@ declare const RefundModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<Refund>;
     fromPlainData(obj: any): Refund;
     fromDatabase(obj: any): Refund | undefined;
     toDatabase(obj: any): Record<string, any>;

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

@@ -1,5 +1,10 @@
 import { type DeepPartial, type ValidateOptions } from "@antelopejs/interface-database-decorators";
-import { Segment } from "../tables/segments.table";
+import { Segment, type SegmentCountPoint } from "../tables/segments.table";
+export declare const SEGMENT_COUNT_HISTORY_DAYS = 30;
+export interface SegmentEvaluationStats {
+    durationMs?: number;
+}
+export declare function appendSegmentCountPoint(history: readonly SegmentCountPoint[], count: number, evaluatedAt: Date): SegmentCountPoint[];
 declare const SegmentModel_base: {
     new (database: import("@antelopejs/interface-database").SchemaInstance<any>): {
         readonly table: import("@antelopejs/interface-database").Table<Segment>;
@@ -13,6 +18,7 @@ declare const SegmentModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<Segment>;
     fromPlainData(obj: any): Segment;
     fromDatabase(obj: any): Segment | undefined;
     toDatabase(obj: any): Record<string, any>;
@@ -22,7 +28,7 @@ export declare class SegmentModel extends SegmentModel_base {
     update(id: string, patch: DeepPartial<Segment>, options?: ValidateOptions): Promise<number>;
     update(patch: DeepPartial<Segment>, options?: ValidateOptions): Promise<number>;
     private updateRevision;
-    publishMemberships(segment: Segment, generation: string, count: number, evaluatedAt: Date): Promise<boolean>;
+    publishMemberships(segment: Segment, generation: string, count: number, evaluatedAt: Date, stats?: SegmentEvaluationStats): Promise<boolean>;
     getMany(ids: readonly string[]): Promise<Segment[]>;
 }
 export {};

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

@@ -1,9 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SegmentModel = void 0;
+exports.SegmentModel = exports.SEGMENT_COUNT_HISTORY_DAYS = void 0;
+exports.appendSegmentCountPoint = appendSegmentCountPoint;
 const node_crypto_1 = require("node:crypto");
 const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
 const segments_table_1 = require("../tables/segments.table");
+exports.SEGMENT_COUNT_HISTORY_DAYS = 30;
+const ISO_DAY_LENGTH = 10;
+function appendSegmentCountPoint(history, count, evaluatedAt) {
+    const day = evaluatedAt.toISOString().slice(0, ISO_DAY_LENGTH);
+    const kept = history.filter((point) => point.day !== day);
+    return [...kept, { day, count }]
+        .sort((a, b) => a.day.localeCompare(b.day))
+        .slice(-exports.SEGMENT_COUNT_HISTORY_DAYS);
+}
 class SegmentModel extends (0, interface_database_decorators_1.BasicDataModel)(segments_table_1.Segment, segments_table_1.segmentsTableName) {
     async update(idOrPatch, patchOrOptions, options) {
         const id = typeof idOrPatch === "string" ? idOrPatch : idOrPatch._id;
@@ -39,7 +49,7 @@ class SegmentModel extends (0, interface_database_decorators_1.BasicDataModel)(s
             throw new Error(`Segment edit ${outcome}; reload before retry`);
         return 1;
     }
-    async publishMemberships(segment, generation, count, evaluatedAt) {
+    async publishMemberships(segment, generation, count, evaluatedAt, stats = {}) {
         const outcome = await this.table
             .atomicMutation(segment._id, {
             type: "update",
@@ -50,7 +60,8 @@ class SegmentModel extends (0, interface_database_decorators_1.BasicDataModel)(s
                 membershipGeneration: generation,
                 estimatedCount: count,
                 lastEvaluatedAt: evaluatedAt,
-                updatedAt: evaluatedAt,
+                lastEvaluationMs: stats.durationMs ?? null,
+                countHistory: appendSegmentCountPoint(segment.countHistory, count, evaluatedAt),
             },
         })
             .run();

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

@@ -1 +1 @@
-{"version":3,"file":"segments.model.js","sourceRoot":"","sources":["../../../src/db/models/segments.model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"segments.model.js","sourceRoot":"","sources":["../../../src/db/models/segments.model.ts"],"names":[],"mappings":";;;AA6BA,0DAUC;AAvCD,6CAAyC;AACzC,6FAKmD;AACnD,6DAIkC;AAGrB,QAAA,0BAA0B,GAAG,EAAE,CAAC;AAE7C,MAAM,cAAc,GAAG,EAAE,CAAC;AAa1B,SAAgB,uBAAuB,CACrC,OAAqC,EACrC,KAAa,EACb,WAAiB;IAEjB,MAAM,GAAG,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;SAC7B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;SAC1C,KAAK,CAAC,CAAC,kCAA0B,CAAC,CAAC;AACxC,CAAC;AAGD,MAAa,YAAa,SAAQ,IAAA,8CAAc,EAAC,wBAAO,EAAE,kCAAiB,CAAC;IAW1E,KAAK,CAAC,MAAM,CACV,SAAwC,EACxC,cAAuD,EACvD,OAAyB;QAEzB,MAAM,EAAE,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;QACrE,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,cAAc,CACxB,EAAE,EACF,OAAO,SAAS,KAAK,QAAQ;YAC3B,CAAC,CAAE,cAAuC;YAC1C,CAAC,CAAC,SAAS,EACb,OAAO,SAAS,KAAK,QAAQ;YAC3B,CAAC,CAAC,OAAO;YACT,CAAC,CAAE,cAAkC,CACxC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,EAAU,EACV,KAA2B,EAC3B,OAAyB;QAEzB,IACE,OAAO,EAAE,QAAQ;YACjB,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;YAEnD,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC;QACvB,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,GAAG,KAAK,CAAC;QAC5C,MAAM,QAAQ,GAAG,YAAY,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACrD,IAAA,4CAAY,EAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEjC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,GACtC,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK;aAC7B,cAAc,CAAC,EAAE,EAAE;YAClB,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,UAAU;YACzB,gBAAgB,EAAE,OAAO,CAAC,QAAQ;YAClC,YAAY,EAAE,IAAA,wBAAU,GAAE;YAC1B,KAAK,EAAE,OAAO;SACf,CAAC;aACD,GAAG,EAAE,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,gBAAgB,OAAO,uBAAuB,CAAC,CAAC;QAClE,OAAO,CAAC,CAAC;IACX,CAAC;IAGD,KAAK,CAAC,kBAAkB,CACtB,OAAgB,EAChB,UAAkB,EAClB,KAAa,EACb,WAAiB,EACjB,QAAgC,EAAE;QAElC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,KAAK;aAC7B,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE;YAC3B,IAAI,EAAE,QAAQ;YACd,aAAa,EAAE,UAAU;YACzB,gBAAgB,EAAE,OAAO,CAAC,QAAQ;YAClC,YAAY,EAAE,IAAA,wBAAU,GAAE;YAC1B,KAAK,EAAE;gBACL,oBAAoB,EAAE,UAAU;gBAChC,cAAc,EAAE,KAAK;gBACrB,eAAe,EAAE,WAAW;gBAC5B,gBAAgB,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;gBAC1C,YAAY,EAAE,uBAAuB,CACnC,OAAO,CAAC,YAAY,EACpB,KAAK,EACL,WAAW,CACZ;aACF;SACF,CAAC;aACD,GAAG,EAAE,CAAC;QACT,IAAI,OAAO,KAAK,SAAS;YACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,OAAO,OAAO,KAAK,SAAS,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,GAAsB;QAClC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAe,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5D,OAAO,IAAI;aACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;aAC5C,MAAM,CAAC,CAAC,CAAC,EAAgB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IAClD,CAAC;CACF;AApGD,oCAoGC"}

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

@@ -13,6 +13,7 @@ declare const StripeWebhookEventModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<StripeWebhookEvent>;
     fromPlainData(obj: any): StripeWebhookEvent;
     fromDatabase(obj: any): StripeWebhookEvent | undefined;
     toDatabase(obj: any): Record<string, any>;

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

@@ -12,6 +12,7 @@ declare const TenantBillingInfoModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<TenantBillingInfo>;
     fromPlainData(obj: any): TenantBillingInfo;
     fromDatabase(obj: any): TenantBillingInfo | undefined;
     toDatabase(obj: any): Record<string, any>;

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

@@ -1,4 +1,4 @@
-import { type BillingState, TenantBillingState } from "../tables/tenantBillingState.table";
+import { type BillingState, TenantBillingState, type WorkspaceDirectoryFields } from "../tables/tenantBillingState.table";
 declare const TenantBillingStateModel_base: {
     new (database: import("@antelopejs/interface-database").SchemaInstance<any>): {
         readonly table: import("@antelopejs/interface-database").Table<TenantBillingState>;
@@ -12,6 +12,7 @@ declare const TenantBillingStateModel_base: {
         delete(id: string): Promise<number>;
     };
     readonly schemaName: string;
+    readonly tableClass: import("@antelopejs/interface-database-decorators").Constructible<TenantBillingState>;
     fromPlainData(obj: any): TenantBillingState;
     fromDatabase(obj: any): TenantBillingState | undefined;
     toDatabase(obj: any): Record<string, any>;
@@ -19,9 +20,10 @@ declare const TenantBillingStateModel_base: {
 };
 export declare class TenantBillingStateModel extends TenantBillingStateModel_base {
     findByTenant(tenantId: string): Promise<TenantBillingState | undefined>;
-    upsertForTenant(tenantId: string, billingState: BillingState, existing: TenantBillingState | undefined): Promise<boolean>;
+    upsertForTenant(tenantId: string, billingState: BillingState, existing: TenantBillingState | undefined, directory: WorkspaceDirectoryFields): Promise<boolean>;
     private publish;
     private insertPublication;
+    findByPlan(planId: string): Promise<TenantBillingState[]>;
     countByState(billingState: BillingState): Promise<number>;
     deleteForTenant(tenantId: string): Promise<void>;
 }

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

@@ -5,20 +5,53 @@ const node_crypto_1 = require("node:crypto");
 const interface_database_decorators_1 = require("@antelopejs/interface-database-decorators");
 const tenantBillingState_table_1 = require("../tables/tenantBillingState.table");
 const DELETE_ATTEMPTS = 3;
+const DELETED_WORKSPACE_DIRECTORY = {
+    planId: null,
+    planName: null,
+    planInterval: null,
+    planBillingMode: null,
+    planUnitAmountMinor: null,
+    currency: null,
+    seats: 0,
+    members: 0,
+    pendingPlanId: null,
+    isComplimentary: false,
+    mrrMinor: 0,
+    previousMrrMinor: 0,
+    reportingMrr: 0,
+    renewalKind: null,
+    renewsAt: null,
+    stateSince: null,
+    ownerStatus: "none",
+    ownerNeverJoined: false,
+    ownerName: null,
+    ownerEmail: null,
+};
 class TenantBillingStateModel extends (0, interface_database_decorators_1.BasicDataModel)(tenantBillingState_table_1.TenantBillingState, tenantBillingState_table_1.tenantBillingStateTableName) {
     async findByTenant(tenantId) {
         return this.get(tenantId);
     }
-    async upsertForTenant(tenantId, billingState, existing) {
+    async upsertForTenant(tenantId, billingState, existing, directory) {
         if (existing?.deletedAt)
             return true;
-        return this.publish(tenantId, existing, billingState, null);
+        return this.publish(tenantId, existing, billingState, null, directory);
     }
-    async publish(tenantId, existing, billingState, deletedAt) {
+    async publish(tenantId, existing, billingState, deletedAt, directory) {
         const revision = (0, node_crypto_1.randomUUID)();
-        const patch = { tenantId, billingState, updatedAt: new Date(), deletedAt };
+        const patch = {
+            ...directory,
+            tenantId,
+            billingState,
+            updatedAt: new Date(),
+            deletedAt,
+        };
         if (!existing)
-            return this.insertPublication({ _id: tenantId, ...patch, revision });
+            return this.insertPublication({
+                ...DELETED_WORKSPACE_DIRECTORY,
+                _id: tenantId,
+                ...patch,
+                revision,
+            });
         const outcome = await this.table
             .atomicMutation(tenantId, {
             type: "update",
@@ -47,6 +80,15 @@ class TenantBillingStateModel extends (0, interface_database_decorators_1.BasicD
             throw new Error("Billing publication was not persisted");
         return current.revision === row.revision;
     }
+    async findByPlan(planId) {
+        const rows = await this.table
+            .getAll(planId, "planId")
+            .filter((row) => row.key("deletedAt").eq(null))
+            .run();
+        return rows
+            .map((row) => TenantBillingStateModel.fromDatabase(row))
+            .filter((row) => row !== undefined);
+    }
     async countByState(billingState) {
         return this.table
             .getAll(billingState, "billingState")