@saasicat/nest 1.0.0-rc.2 → 1.0.0-rc.21

package/dist/testing/index.d.cts

@@ -1,20 +1,24 @@
-import { BundleRepository, BundleRow, BundleVersionRow, BundleListFilter, CreateBundleData, UpdateBundleData, CreateBundleVersionDraftData, UpdateBundleVersionDraftData, VersionChange, MarketingProjectionRepository, MarketingProjectionRow, MarketingProjectionFilter, CreateMarketingProjectionData, UpdateMarketingProjectionData, PlanRepository, PlanRow, PlanVersionRow, PlanListFilter, CreatePlanData, UpdatePlanData, CreatePlanVersionDraftData, UpdatePlanVersionDraftData, PlanVersionRepository, PlanVersionRecord, TransactionContext, SubscriptionBundleRepository, SubscriptionBundleRecord, CreateSubscriptionBundleData, CancelSubscriptionBundleData, SubscriptionContractRepository, SubscriptionContractFilter, SubscriptionContractRecord, CreateSubscriptionContractData, TerminateSubscriptionContractData, SubscriptionRepository, SubscriptionRecord, TransactionRunner, PlanCatalog, QuotaProvider } from '@saasicat/core';
+import { BundleRepository, BundleRow, BundleVersionRow, BundleListFilter, CreateBundleData, UpdateBundleData, CreateBundleVersionDraftData, UpdateBundleVersionDraftData, VersionChange, MarketingProjectionRepository, MarketingProjectionRow, MarketingProjectionFilter, CreateMarketingProjectionData, UpdateMarketingProjectionData, PlanRepository, PlanRow, PlanVersionRow, PlanListFilter, CreatePlanData, UpdatePlanData, CreatePlanVersionDraftData, UpdatePlanVersionDraftData, PlanVersionRepository, PlanVersionRecord, TransactionContext, SubscriberRepository, CreateSubscriberData, SubscriberRecord, SubscriberContactChange, SubscriberCorrectionData, SubscriberCorrectionResult, SubscriberCorrectionRecord, SubscriptionBundleRepository, SubscriptionBundleRecord, CreateSubscriptionBundleData, CancelSubscriptionBundleData, SubscriptionContractRepository, SubscriptionContractFilter, SubscriptionContractRecord, NewSubscriptionContractData, TerminateSubscriptionContractData, RunningContractIssuers, SubscriptionRepository, SubscriptionRecord, TransactionRunner, PlanCatalog, QuotaProvider } from '@saasicat/core';
 import { Type, DynamicModule } from '@nestjs/common';
-import { S as SaaSiCatAdapters } from '../module-options-BG3MzQva.cjs';
-export { P as PLAN_RESOLVER_PORT_TOKEN, n as StaticPlanResolver } from '../module-options-BG3MzQva.cjs';
-export { E as EnforceQuotaInterceptor, S as StaticEntitlementService, a as StaticFeatureGuard } from '../enforce-quota.interceptor-Df0e3OWe.cjs';
+import { S as SaaSiCatAdapters } from '../module-options-qAOwinHR.cjs';
+export { P as PLAN_RESOLVER_PORT_TOKEN, a as StaticPlanResolver } from '../module-options-qAOwinHR.cjs';
+export { E as EnforceQuotaInterceptor, S as StaticEntitlementService, a as StaticFeatureGuard } from '../enforce-quota.interceptor-BFyVdWe8.cjs';
 import '../di-CcNeq9v-.cjs';
-import '../admin-resources.module-CpvzcfCc.cjs';
+import '../admin-resources.module-B4XNvdH-.cjs';
 import '../admin-audit.service-4P3Djdxk.cjs';
-import '../tenant-billing.module-BznC3XtW.cjs';
-import '../catalog.module-BDDO6iwq.cjs';
-import '../discovery.scanner-9cMqF95o.cjs';
+import '../tenant-billing.module-ClbjzocC.cjs';
+import '../tenant-billing.tokens-G-1xOlMr.cjs';
+import '../contract-line-item-money-B0Z3Ogur.cjs';
+import '../catalog.module-T-I5Ricz.cjs';
+import '../discovery.scanner-DXKc6JkV.cjs';
 import '@nestjs/core';
-import '../plan-resolution-Cgo_TR1H.cjs';
-import '../promo.module-DtvIycpt.cjs';
-import '../promo.service-BJbKAmw3.cjs';
-import '../checkout-offer.module-CVpWrzbe.cjs';
-import '../subscription-contract.module-CEK8HS5-.cjs';
+import '../plan-resolution-CwUy_OqC.cjs';
+import '../promo.module-CKkECmU8.cjs';
+import '../promo.service-BYBu6dy3.cjs';
+import '../plan-catalog-source-DWe-BGY1.cjs';
+import '../checkout-offer.module-DFhGy6JO.cjs';
+import '../payments.module-BdUq9ot_.cjs';
+import '../subscription-contract.module-DTMuUJYd.cjs';
 import 'rxjs';
 
 /**
@@ -87,11 +91,34 @@ declare class FakeSubscriptionContractRepository implements SubscriptionContract
     list(filter: SubscriptionContractFilter): Promise<SubscriptionContractRecord[]>;
     findById(contractId: string): Promise<SubscriptionContractRecord | null>;
     findActiveByTenantId(tenantId: string, asOf?: Date): Promise<SubscriptionContractRecord | null>;
-    create(data: CreateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    findByOriginalOfferId(offerId: string): Promise<SubscriptionContractRecord | null>;
+    create(data: NewSubscriptionContractData): Promise<SubscriptionContractRecord>;
     terminate(contractId: string, data: TerminateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    listRunningIssuers(limit: number, asOf?: Date): Promise<RunningContractIssuers>;
     private isActiveAt;
     private cloneRecord;
 }
+/**
+ * In-memory FakeSubscriberRepository — one live subscriber per tenant, customer
+ * numbers counted from 10001 like the canonical schema, and corrections
+ * recorded with the values they replaced. No transactions: `tx` is accepted and
+ * ignored.
+ */
+declare class FakeSubscriberRepository implements SubscriberRepository {
+    /** Where the canonical schema starts counting (`sql/constraints.postgres.sql`). */
+    static readonly FIRST_CUSTOMER_NUMBER = 10001;
+    private readonly byId;
+    private readonly corrections;
+    private nextSequence;
+    private nextCorrectionId;
+    createForTenant(data: CreateSubscriberData): Promise<SubscriberRecord | null>;
+    findById(subscriberId: string): Promise<SubscriberRecord | null>;
+    findByTenantId(tenantId: string): Promise<SubscriberRecord | null>;
+    updateContact(subscriberId: string, change: SubscriberContactChange): Promise<SubscriberRecord | null>;
+    correctIdentity(subscriberId: string, data: SubscriberCorrectionData): Promise<SubscriberCorrectionResult | null>;
+    listCorrections(subscriberId: string): Promise<SubscriberCorrectionRecord[]>;
+    private liveFor;
+}
 /**
  * In-memory FakePlanVersionRepository — stores PlanVersions per `planId`
  * and returns the most recently set one as "latest live".
@@ -132,7 +159,7 @@ declare class FakeBundleRepository implements BundleRepository {
     clear(): void;
     list(filter: BundleListFilter): Promise<BundleRow[]>;
     findById(bundleId: string): Promise<BundleRow | null>;
-    findByKey(projectKey: string, bundleKey: string): Promise<BundleRow | null>;
+    findByKey(bundleKey: string): Promise<BundleRow | null>;
     create(data: CreateBundleData): Promise<BundleRow>;
     update(bundleId: string, data: UpdateBundleData): Promise<BundleRow>;
     softDelete(bundleId: string): Promise<void>;
@@ -183,7 +210,7 @@ declare class FakePlanRepository implements PlanRepository {
     clear(): void;
     list(filter: PlanListFilter): Promise<PlanRow[]>;
     findById(planId: string): Promise<PlanRow | null>;
-    findByKey(projectKey: string, planKey: string): Promise<PlanRow | null>;
+    findByKey(planKey: string): Promise<PlanRow | null>;
     create(data: CreatePlanData): Promise<PlanRow>;
     update(planId: string, data: UpdatePlanData): Promise<PlanRow>;
     softDelete(planId: string): Promise<void>;
@@ -250,4 +277,4 @@ interface CreateSaaSiCatTestModuleOptions {
  */
 declare function createSaaSiCatTestModule(options: CreateSaaSiCatTestModuleOptions): DynamicModule;
 
-export { type CreateSaaSiCatTestModuleOptions, FakeBundleRepository, FakeMarketingProjectionRepository, FakePlanRepository, FakePlanVersionRepository, FakeSubscriptionBundleRepository, FakeSubscriptionContractRepository, FakeSubscriptionRepository, FakeTransactionRunner, StubAuditPort, StubMfaPort, StubRlsBypassPort, createSaaSiCatTestModule };
+export { type CreateSaaSiCatTestModuleOptions, FakeBundleRepository, FakeMarketingProjectionRepository, FakePlanRepository, FakePlanVersionRepository, FakeSubscriberRepository, FakeSubscriptionBundleRepository, FakeSubscriptionContractRepository, FakeSubscriptionRepository, FakeTransactionRunner, StubAuditPort, StubMfaPort, StubRlsBypassPort, createSaaSiCatTestModule };

package/dist/testing/index.d.ts

@@ -1,20 +1,24 @@
-import { BundleRepository, BundleRow, BundleVersionRow, BundleListFilter, CreateBundleData, UpdateBundleData, CreateBundleVersionDraftData, UpdateBundleVersionDraftData, VersionChange, MarketingProjectionRepository, MarketingProjectionRow, MarketingProjectionFilter, CreateMarketingProjectionData, UpdateMarketingProjectionData, PlanRepository, PlanRow, PlanVersionRow, PlanListFilter, CreatePlanData, UpdatePlanData, CreatePlanVersionDraftData, UpdatePlanVersionDraftData, PlanVersionRepository, PlanVersionRecord, TransactionContext, SubscriptionBundleRepository, SubscriptionBundleRecord, CreateSubscriptionBundleData, CancelSubscriptionBundleData, SubscriptionContractRepository, SubscriptionContractFilter, SubscriptionContractRecord, CreateSubscriptionContractData, TerminateSubscriptionContractData, SubscriptionRepository, SubscriptionRecord, TransactionRunner, PlanCatalog, QuotaProvider } from '@saasicat/core';
+import { BundleRepository, BundleRow, BundleVersionRow, BundleListFilter, CreateBundleData, UpdateBundleData, CreateBundleVersionDraftData, UpdateBundleVersionDraftData, VersionChange, MarketingProjectionRepository, MarketingProjectionRow, MarketingProjectionFilter, CreateMarketingProjectionData, UpdateMarketingProjectionData, PlanRepository, PlanRow, PlanVersionRow, PlanListFilter, CreatePlanData, UpdatePlanData, CreatePlanVersionDraftData, UpdatePlanVersionDraftData, PlanVersionRepository, PlanVersionRecord, TransactionContext, SubscriberRepository, CreateSubscriberData, SubscriberRecord, SubscriberContactChange, SubscriberCorrectionData, SubscriberCorrectionResult, SubscriberCorrectionRecord, SubscriptionBundleRepository, SubscriptionBundleRecord, CreateSubscriptionBundleData, CancelSubscriptionBundleData, SubscriptionContractRepository, SubscriptionContractFilter, SubscriptionContractRecord, NewSubscriptionContractData, TerminateSubscriptionContractData, RunningContractIssuers, SubscriptionRepository, SubscriptionRecord, TransactionRunner, PlanCatalog, QuotaProvider } from '@saasicat/core';
 import { Type, DynamicModule } from '@nestjs/common';
-import { S as SaaSiCatAdapters } from '../module-options-COSEb0VW.js';
-export { P as PLAN_RESOLVER_PORT_TOKEN, n as StaticPlanResolver } from '../module-options-COSEb0VW.js';
-export { E as EnforceQuotaInterceptor, S as StaticEntitlementService, a as StaticFeatureGuard } from '../enforce-quota.interceptor-DW3etVyI.js';
+import { S as SaaSiCatAdapters } from '../module-options-DmQ3G4sZ.js';
+export { P as PLAN_RESOLVER_PORT_TOKEN, a as StaticPlanResolver } from '../module-options-DmQ3G4sZ.js';
+export { E as EnforceQuotaInterceptor, S as StaticEntitlementService, a as StaticFeatureGuard } from '../enforce-quota.interceptor-GaBXboGx.js';
 import '../di-CcNeq9v-.js';
-import '../admin-resources.module-DF5_Q7RD.js';
+import '../admin-resources.module-CWqdI9BV.js';
 import '../admin-audit.service-4P3Djdxk.js';
-import '../tenant-billing.module-wUbsQSFG.js';
-import '../catalog.module-BTnMsE6u.js';
-import '../discovery.scanner-9cMqF95o.js';
+import '../tenant-billing.module-DohgJJ2m.js';
+import '../tenant-billing.tokens-G-1xOlMr.js';
+import '../contract-line-item-money-B0Z3Ogur.js';
+import '../catalog.module-C9O7BxRq.js';
+import '../discovery.scanner-DXKc6JkV.js';
 import '@nestjs/core';
-import '../plan-resolution-Cgo_TR1H.js';
-import '../promo.module-Z8h1PNX-.js';
-import '../promo.service-BJbKAmw3.js';
-import '../checkout-offer.module-CMtiQJTT.js';
-import '../subscription-contract.module-fDFdQ0jm.js';
+import '../plan-resolution-CwUy_OqC.js';
+import '../promo.module-DuIJdK3U.js';
+import '../promo.service-CFjfF0Xm.js';
+import '../plan-catalog-source-DWe-BGY1.js';
+import '../checkout-offer.module-x7SP_dX4.js';
+import '../payments.module-CQGv_VG7.js';
+import '../subscription-contract.module-BfIRpc1o.js';
 import 'rxjs';
 
 /**
@@ -87,11 +91,34 @@ declare class FakeSubscriptionContractRepository implements SubscriptionContract
     list(filter: SubscriptionContractFilter): Promise<SubscriptionContractRecord[]>;
     findById(contractId: string): Promise<SubscriptionContractRecord | null>;
     findActiveByTenantId(tenantId: string, asOf?: Date): Promise<SubscriptionContractRecord | null>;
-    create(data: CreateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    findByOriginalOfferId(offerId: string): Promise<SubscriptionContractRecord | null>;
+    create(data: NewSubscriptionContractData): Promise<SubscriptionContractRecord>;
     terminate(contractId: string, data: TerminateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    listRunningIssuers(limit: number, asOf?: Date): Promise<RunningContractIssuers>;
     private isActiveAt;
     private cloneRecord;
 }
+/**
+ * In-memory FakeSubscriberRepository — one live subscriber per tenant, customer
+ * numbers counted from 10001 like the canonical schema, and corrections
+ * recorded with the values they replaced. No transactions: `tx` is accepted and
+ * ignored.
+ */
+declare class FakeSubscriberRepository implements SubscriberRepository {
+    /** Where the canonical schema starts counting (`sql/constraints.postgres.sql`). */
+    static readonly FIRST_CUSTOMER_NUMBER = 10001;
+    private readonly byId;
+    private readonly corrections;
+    private nextSequence;
+    private nextCorrectionId;
+    createForTenant(data: CreateSubscriberData): Promise<SubscriberRecord | null>;
+    findById(subscriberId: string): Promise<SubscriberRecord | null>;
+    findByTenantId(tenantId: string): Promise<SubscriberRecord | null>;
+    updateContact(subscriberId: string, change: SubscriberContactChange): Promise<SubscriberRecord | null>;
+    correctIdentity(subscriberId: string, data: SubscriberCorrectionData): Promise<SubscriberCorrectionResult | null>;
+    listCorrections(subscriberId: string): Promise<SubscriberCorrectionRecord[]>;
+    private liveFor;
+}
 /**
  * In-memory FakePlanVersionRepository — stores PlanVersions per `planId`
  * and returns the most recently set one as "latest live".
@@ -132,7 +159,7 @@ declare class FakeBundleRepository implements BundleRepository {
     clear(): void;
     list(filter: BundleListFilter): Promise<BundleRow[]>;
     findById(bundleId: string): Promise<BundleRow | null>;
-    findByKey(projectKey: string, bundleKey: string): Promise<BundleRow | null>;
+    findByKey(bundleKey: string): Promise<BundleRow | null>;
     create(data: CreateBundleData): Promise<BundleRow>;
     update(bundleId: string, data: UpdateBundleData): Promise<BundleRow>;
     softDelete(bundleId: string): Promise<void>;
@@ -183,7 +210,7 @@ declare class FakePlanRepository implements PlanRepository {
     clear(): void;
     list(filter: PlanListFilter): Promise<PlanRow[]>;
     findById(planId: string): Promise<PlanRow | null>;
-    findByKey(projectKey: string, planKey: string): Promise<PlanRow | null>;
+    findByKey(planKey: string): Promise<PlanRow | null>;
     create(data: CreatePlanData): Promise<PlanRow>;
     update(planId: string, data: UpdatePlanData): Promise<PlanRow>;
     softDelete(planId: string): Promise<void>;
@@ -250,4 +277,4 @@ interface CreateSaaSiCatTestModuleOptions {
  */
 declare function createSaaSiCatTestModule(options: CreateSaaSiCatTestModuleOptions): DynamicModule;
 
-export { type CreateSaaSiCatTestModuleOptions, FakeBundleRepository, FakeMarketingProjectionRepository, FakePlanRepository, FakePlanVersionRepository, FakeSubscriptionBundleRepository, FakeSubscriptionContractRepository, FakeSubscriptionRepository, FakeTransactionRunner, StubAuditPort, StubMfaPort, StubRlsBypassPort, createSaaSiCatTestModule };
+export { type CreateSaaSiCatTestModuleOptions, FakeBundleRepository, FakeMarketingProjectionRepository, FakePlanRepository, FakePlanVersionRepository, FakeSubscriberRepository, FakeSubscriptionBundleRepository, FakeSubscriptionContractRepository, FakeSubscriptionRepository, FakeTransactionRunner, StubAuditPort, StubMfaPort, StubRlsBypassPort, createSaaSiCatTestModule };

package/dist/testing/index.js

@@ -5,36 +5,46 @@ import {
   StaticEntitlementService,
   StaticFeatureGuard,
   StaticPlanResolver
-} from "../chunk-RUNZ3X4C.js";
-import "../chunk-TXC3LHHB.js";
-import "../chunk-AU3OOREM.js";
-import "../chunk-LTT736P3.js";
-import "../chunk-6Z7JR4EW.js";
-import "../chunk-VXEYLNIB.js";
-import "../chunk-KFT5AIIH.js";
-import "../chunk-WOVQPXV4.js";
-import "../chunk-N3L3AICU.js";
-import "../chunk-O2J2HDXA.js";
-import "../chunk-WUDYIPYH.js";
-import "../chunk-BSK6YBLI.js";
-import "../chunk-YSC46BGM.js";
-import "../chunk-7ZEGFL42.js";
-import "../chunk-VIJ5NJWC.js";
-import "../chunk-DQKCK7DX.js";
-import "../chunk-VBRYPU7V.js";
-import "../chunk-57V6ZTI6.js";
+} from "../chunk-AOS2JPDD.js";
+import "../chunk-4SDSYV4A.js";
+import "../chunk-XSSWYPP5.js";
+import "../chunk-LLYVYRGJ.js";
+import "../chunk-M47BNEY2.js";
+import "../chunk-CQ2ZZMTD.js";
+import "../chunk-GZTL64QK.js";
+import "../chunk-34XVPR6P.js";
+import "../chunk-OOTEXP47.js";
+import "../chunk-TOEFN7DN.js";
+import "../chunk-55QEDAMX.js";
+import "../chunk-3RLWML2S.js";
+import "../chunk-NDLC5GYK.js";
+import "../chunk-KPEMTBOP.js";
+import "../chunk-S33SO5XX.js";
+import "../chunk-JVAEKTJ4.js";
+import "../chunk-WHJSYKNC.js";
+import "../chunk-G6EZWECL.js";
 import "../chunk-OUDSQ3PU.js";
-import "../chunk-AOQJEYOL.js";
-import "../chunk-SABTXESR.js";
-import "../chunk-XBYAFEOR.js";
-import "../chunk-WXYJHZCN.js";
+import "../chunk-TBBZWZQT.js";
+import "../chunk-VBRYPU7V.js";
+import "../chunk-6PJE7EWO.js";
+import "../chunk-3QVGA6JX.js";
 import "../chunk-QUZU2M33.js";
+import "../chunk-QPVDCKYS.js";
+import "../chunk-7NJKVC5X.js";
+import "../chunk-5CKC7O52.js";
+import "../chunk-GPQWGA6B.js";
+import "../chunk-SZ7RFPXA.js";
+import "../chunk-WOEJ6K7M.js";
+import "../chunk-LF6J4YYN.js";
+import "../chunk-YSC46BGM.js";
+import "../chunk-FEQZCWUL.js";
+import "../chunk-J7NJRK3K.js";
 import {
   __name
 } from "../chunk-SHUYVCID.js";
 
 // src/testing/fake-repositories.ts
-import { startOfUtcDay } from "@saasicat/core";
+import { formatCustomerNumber, identityCorrectionDelta, startOfUtcDay } from "@saasicat/core";
 var FakeSubscriptionRepository = class {
   static {
     __name(this, "FakeSubscriptionRepository");
@@ -116,6 +126,9 @@ var FakeSubscriptionBundleRepository = class {
       minimumTermEndsAt: data.minimumTermEndsAt ?? null,
       canceledAt: null,
       canceledEffectiveAt: null,
+      billingCycle: data.billingCycle ?? null,
+      currentPeriodStart: data.currentPeriodStart ?? null,
+      currentPeriodEnd: data.currentPeriodEnd ?? null,
       createdAt,
       updatedAt: createdAt
     };
@@ -180,7 +193,7 @@ var FakeSubscriptionContractRepository = class {
   async list(filter) {
     return [
       ...this.byId.values()
-    ].filter((row) => !filter.projectKey || row.projectKey === filter.projectKey).filter((row) => !filter.tenantId || row.tenantId === filter.tenantId).filter((row) => !filter.status || row.status === filter.status).filter((row) => !filter.asOf || this.isActiveAt(row, filter.asOf)).sort((a, b) => b.effectiveFrom.getTime() - a.effectiveFrom.getTime()).map((row) => this.cloneRecord(row));
+    ].filter((row) => !filter.tenantId || row.tenantId === filter.tenantId).filter((row) => !filter.status || row.status === filter.status).filter((row) => !filter.asOf || this.isActiveAt(row, filter.asOf)).sort((a, b) => b.effectiveFrom.getTime() - a.effectiveFrom.getTime()).map((row) => this.cloneRecord(row));
   }
   async findById(contractId) {
     const row = this.byId.get(contractId);
@@ -192,13 +205,26 @@ var FakeSubscriptionContractRepository = class {
     ].filter((row) => row.tenantId === tenantId).filter((row) => this.isActiveAt(row, asOf)).sort((a, b) => b.effectiveFrom.getTime() - a.effectiveFrom.getTime())[0];
     return active ? this.cloneRecord(active) : null;
   }
+  async findByOriginalOfferId(offerId) {
+    const first = [
+      ...this.byId.values()
+    ].find((row) => row.originalOfferId === offerId);
+    return first ? this.cloneRecord(first) : null;
+  }
   async create(data) {
     const now = /* @__PURE__ */ new Date();
     const id = `contract-${this.nextContractId++}`;
     const row = {
       id,
-      projectKey: data.projectKey,
       tenantId: data.tenantId,
+      subscriberId: data.parties.subscriberId,
+      subscriber: {
+        ...data.parties.subscriber
+      },
+      issuer: data.parties.issuer ? {
+        ...data.parties.issuer
+      } : null,
+      partiesMigrated: false,
       status: data.status ?? "active",
       effectiveFrom: new Date(data.effectiveFrom),
       effectiveUntil: data.effectiveUntil ? new Date(data.effectiveUntil) : null,
@@ -255,13 +281,29 @@ var FakeSubscriptionContractRepository = class {
     if (!existing) throw new Error(`SubscriptionContract '${contractId}' not found`);
     const updated = {
       ...existing,
-      status: data.status,
+      // Null means "end it by date": the row keeps the status it has and
+      // leaves the active window when `effectiveUntil` passes.
+      status: data.status ?? existing.status,
       effectiveUntil: new Date(data.effectiveUntil),
       updatedAt: /* @__PURE__ */ new Date()
     };
     this.byId.set(contractId, updated);
     return this.cloneRecord(updated);
   }
+  async listRunningIssuers(limit, asOf = /* @__PURE__ */ new Date()) {
+    const running = [
+      ...this.byId.values()
+    ].filter((row) => row.status === "active" || row.status === "scheduled").filter((row) => row.effectiveUntil === null || row.effectiveUntil > asOf).sort((a, b) => a.effectiveFrom.getTime() - b.effectiveFrom.getTime() || a.createdAt.getTime() - b.createdAt.getTime() || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    return {
+      total: running.length,
+      contracts: running.slice(0, limit).map((row) => ({
+        id: row.id,
+        tenantId: row.tenantId,
+        issuerLegalName: row.issuer?.legalName ?? null,
+        effectiveFrom: new Date(row.effectiveFrom)
+      }))
+    };
+  }
   isActiveAt(row, asOf) {
     if (row.status !== "active" && row.status !== "scheduled") return false;
     return row.effectiveFrom.getTime() <= asOf.getTime() && (row.effectiveUntil === null || row.effectiveUntil.getTime() > asOf.getTime());
@@ -269,6 +311,12 @@ var FakeSubscriptionContractRepository = class {
   cloneRecord(row) {
     return {
       ...row,
+      subscriber: {
+        ...row.subscriber
+      },
+      issuer: row.issuer ? {
+        ...row.issuer
+      } : null,
       effectiveFrom: new Date(row.effectiveFrom),
       effectiveUntil: row.effectiveUntil ? new Date(row.effectiveUntil) : null,
       originalBundleVersionIds: [
@@ -314,6 +362,108 @@ var FakeSubscriptionContractRepository = class {
     };
   }
 };
+var FakeSubscriberRepository = class _FakeSubscriberRepository {
+  static {
+    __name(this, "FakeSubscriberRepository");
+  }
+  /** Where the canonical schema starts counting (`sql/constraints.postgres.sql`). */
+  static FIRST_CUSTOMER_NUMBER = 10001;
+  byId = /* @__PURE__ */ new Map();
+  corrections = [];
+  nextSequence = _FakeSubscriberRepository.FIRST_CUSTOMER_NUMBER;
+  nextCorrectionId = 1;
+  async createForTenant(data) {
+    if (this.liveFor(data.tenantId)) return null;
+    const now = /* @__PURE__ */ new Date();
+    const sequence = this.nextSequence++;
+    const { tenantId, customerNumberPrefix, ...details } = data;
+    const record = {
+      ...details,
+      id: `subscriber-${sequence}`,
+      customerNumber: formatCustomerNumber(customerNumberPrefix, sequence),
+      tenantId,
+      migrated: false,
+      createdAt: now,
+      updatedAt: now
+    };
+    this.byId.set(record.id, record);
+    return {
+      ...record
+    };
+  }
+  async findById(subscriberId) {
+    const record = this.byId.get(subscriberId);
+    return record ? {
+      ...record
+    } : null;
+  }
+  async findByTenantId(tenantId) {
+    const record = this.liveFor(tenantId);
+    return record ? {
+      ...record
+    } : null;
+  }
+  async updateContact(subscriberId, change) {
+    const record = this.byId.get(subscriberId);
+    if (!record) return null;
+    const updated = {
+      ...record,
+      ...change,
+      updatedAt: /* @__PURE__ */ new Date()
+    };
+    this.byId.set(subscriberId, updated);
+    return {
+      ...updated
+    };
+  }
+  async correctIdentity(subscriberId, data) {
+    const record = this.byId.get(subscriberId);
+    if (!record) return null;
+    const delta = identityCorrectionDelta(record, data.corrected);
+    if (Object.keys(delta.corrected).length === 0) {
+      return {
+        subscriber: {
+          ...record
+        },
+        correction: null
+      };
+    }
+    const updated = {
+      ...record,
+      ...delta.corrected,
+      updatedAt: /* @__PURE__ */ new Date()
+    };
+    this.byId.set(subscriberId, updated);
+    const correction = {
+      id: `correction-${this.nextCorrectionId++}`,
+      subscriberId,
+      previous: delta.previous,
+      corrected: delta.corrected,
+      reason: data.reason,
+      correctedBy: data.correctedBy,
+      correctedAt: data.correctedAt
+    };
+    this.corrections.push(correction);
+    return {
+      subscriber: {
+        ...updated
+      },
+      correction: {
+        ...correction
+      }
+    };
+  }
+  async listCorrections(subscriberId) {
+    return this.corrections.filter((correction) => correction.subscriberId === subscriberId).reverse().map((correction) => ({
+      ...correction
+    }));
+  }
+  liveFor(tenantId) {
+    return [
+      ...this.byId.values()
+    ].find((record) => record.tenantId === tenantId);
+  }
+};
 var FakePlanVersionRepository = class {
   static {
     __name(this, "FakePlanVersionRepository");
@@ -379,24 +529,24 @@ var FakeBundleRepository = class {
     const excludeDeleted = filter.excludeDeleted ?? true;
     return [
       ...this.bundles.values()
-    ].filter((b) => b.projectKey === filter.projectKey && (!excludeDeleted || b.deletedAt === null));
+    ].filter((b) => !excludeDeleted || b.deletedAt === null);
   }
   async findById(bundleId) {
     return this.bundles.get(bundleId) ?? null;
   }
-  async findByKey(projectKey, bundleKey) {
+  async findByKey(bundleKey) {
     for (const b of this.bundles.values()) {
-      if (b.projectKey === projectKey && b.bundleKey === bundleKey && b.deletedAt === null) {
-        return b;
-      }
+      if (b.bundleKey === bundleKey) return b;
     }
     return null;
   }
   async create(data) {
+    if (await this.findByKey(data.bundleKey)) {
+      throw new Error(`bundleKey '${data.bundleKey}' is already taken.`);
+    }
     const now = this.nowIso();
     const row = {
       id: this.genId("bbbb"),
-      projectKey: data.projectKey,
       bundleKey: data.bundleKey,
       label: data.label,
       description: data.description ?? null,
@@ -579,7 +729,6 @@ var FakeMarketingProjectionRepository = class {
     return [
       ...this.rows.values()
     ].filter((r) => {
-      if (r.projectKey !== filter.projectKey) return false;
       if (filter.targetType && r.targetType !== filter.targetType) return false;
       if (filter.targetVersionId && r.targetVersionId !== filter.targetVersionId) return false;
       if (filter.locale && r.locale !== filter.locale) return false;
@@ -606,7 +755,6 @@ var FakeMarketingProjectionRepository = class {
     const now = this.nowIso();
     const row = {
       id: this.genId(),
-      projectKey: data.projectKey,
       targetType: data.targetType,
       targetVersionId: data.targetVersionId,
       locale,
@@ -691,24 +839,24 @@ var FakePlanRepository = class {
     ].filter((v) => v.publishedAt != null && v.supersededAt == null).map((v) => v.planId)) : null;
     return [
       ...this.plans.values()
-    ].filter((p) => p.projectKey === filter.projectKey && (!excludeDeleted || p.deletedAt === null) && (!liveKeys || liveKeys.has(p.planKey)));
+    ].filter((p) => (!excludeDeleted || p.deletedAt === null) && (!liveKeys || liveKeys.has(p.planKey)));
   }
   async findById(planId) {
     return this.plans.get(planId) ?? null;
   }
-  async findByKey(projectKey, planKey) {
+  async findByKey(planKey) {
     for (const p of this.plans.values()) {
-      if (p.projectKey === projectKey && p.planKey === planKey && p.deletedAt === null) {
-        return p;
-      }
+      if (p.planKey === planKey) return p;
     }
     return null;
   }
   async create(data) {
+    if (await this.findByKey(data.planKey)) {
+      throw new Error(`planKey '${data.planKey}' is already taken.`);
+    }
     const now = this.nowIso();
     const row = {
       id: this.genId(),
-      projectKey: data.projectKey,
       planKey: data.planKey,
       label: data.label,
       description: data.description ?? null,
@@ -1001,6 +1149,7 @@ export {
   FakeMarketingProjectionRepository,
   FakePlanRepository,
   FakePlanVersionRepository,
+  FakeSubscriberRepository,
   FakeSubscriptionBundleRepository,
   FakeSubscriptionContractRepository,
   FakeSubscriptionRepository,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saasicat/nest",
-  "version": "1.0.0-rc.2",
+  "version": "1.0.0-rc.21",
   "description": "NestJS implementation of SaaSiCat: capability discovery, catalog packaging, contracts, entitlement enforcement, billing and admin APIs.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -117,6 +117,26 @@
         "default": "./dist/subscription-contract/index.cjs"
       }
     },
+    "./subscriber": {
+      "import": {
+        "types": "./dist/subscriber/index.d.ts",
+        "default": "./dist/subscriber/index.js"
+      },
+      "require": {
+        "types": "./dist/subscriber/index.d.cts",
+        "default": "./dist/subscriber/index.cjs"
+      }
+    },
+    "./payments": {
+      "import": {
+        "types": "./dist/payments/index.d.ts",
+        "default": "./dist/payments/index.js"
+      },
+      "require": {
+        "types": "./dist/payments/index.d.cts",
+        "default": "./dist/payments/index.cjs"
+      }
+    },
     "./platform": {
       "import": {
         "types": "./dist/platform/index.d.ts",
@@ -135,11 +155,11 @@
   "dependencies": {
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
-    "js-yaml": "^4.3.1",
+    "js-yaml": "^4.3.2",
     "otplib": "^13.4.1",
     "qrcode": "^1.5.4",
-    "@saasicat/spec": "^1.0.0-rc.2",
-    "@saasicat/core": "^1.0.0-rc.2"
+    "@saasicat/spec": "^1.0.0-rc.21",
+    "@saasicat/core": "^1.0.0-rc.21"
   },
   "peerDependencies": {
     "@nestjs/common": "^11.0.0",