@saasicat/nest 0.2.0

package/dist/testing/index.d.cts

@@ -0,0 +1,279 @@
+import { BundleRepository, BundleRow, BundleVersionRow, BundleListFilter, CreateBundleData, UpdateBundleData, CreateBundleVersionDraftData, UpdateBundleVersionDraftData, VersionChange, BusinessTypeRepository, BusinessTypeRow, BusinessTypeVersionRow, BusinessTypeListFilter, CreateBusinessTypeData, UpdateBusinessTypeData, CreateBusinessTypeVersionDraftData, UpdateBusinessTypeVersionDraftData, 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/types';
+import { Type, DynamicModule } from '@nestjs/common';
+import { S as SaasPlatformModuleOptions } from '../saas-platform.module-CgZ2omgg.cjs';
+import '../di-CcNeq9v-.cjs';
+import '../admin-manifest.config-DyrQNT7M.cjs';
+import '../discovery.scanner-CUYLKlYT.cjs';
+import '@nestjs/core';
+import '../plan-resolution-CFCoUkrE.cjs';
+
+/**
+ * In-memory FakeSubscriptionRepository — stores subscriptions by
+ * `tenantId` and returns them as a read snapshot. Lock semantics are not
+ * emulated (`findByTenantIdLocked` delegates to `findByTenantId`).
+ *
+ * Test setup:
+ *
+ *     const repo = new FakeSubscriptionRepository();
+ *     repo.set({ id: 'sub-1', tenantId: 't1', plan: 'STANDARD', ... });
+ */
+declare class FakeSubscriptionRepository implements SubscriptionRepository {
+    private readonly byTenantId;
+    /**
+     * Test stubs for the `countBy*` editability methods. Tests set them
+     * directly; default 0 (= "no subscription binds the version" →
+     * published-but-future versions are editable when they are latest-in-chain
+     * and validFrom lies in the future).
+     */
+    private readonly planVersionCounts;
+    private readonly bundleVersionCounts;
+    set(record: SubscriptionRecord): void;
+    delete(tenantId: string): void;
+    clear(): void;
+    /** Test helper: force the number of subscriptions for a PlanVersion. */
+    setPlanVersionCount(planVersionId: string, count: number): void;
+    /** Test helper: force the number of subscriptions for a BundleVersion. */
+    setBundleVersionCount(bundleVersionId: string, count: number): void;
+    findByTenantId(tenantId: string): Promise<SubscriptionRecord | null>;
+    findByTenantIdLocked(tenantId: string, _tx: TransactionContext): Promise<SubscriptionRecord | null>;
+    countByPlanVersionId(planVersionId: string): Promise<number>;
+    countByBundleVersionId(bundleVersionId: string): Promise<number>;
+}
+/**
+ * In-memory FakeSubscriptionBundleRepository — stores
+ * `subscription_bundles` entries by id. `add` / `cancel` are
+ * fail-fast (no re-cancel); the minimum-term default comes from the service
+ * (not implemented yet today — tests set the field explicitly).
+ *
+ * Test setup:
+ *
+ *     const repo = new FakeSubscriptionBundleRepository();
+ *     const row = await repo.add({ subscriptionId: 's1',
+ *         bundleVersionId: 'bv1', startedAt: new Date() });
+ */
+declare class FakeSubscriptionBundleRepository implements SubscriptionBundleRepository {
+    private readonly byId;
+    private nextId;
+    private now;
+    clear(): void;
+    listBySubscription(subscriptionId: string): Promise<SubscriptionBundleRecord[]>;
+    findById(subscriptionBundleId: string): Promise<SubscriptionBundleRecord | null>;
+    listActiveBySubscription(subscriptionId: string, asOf?: Date): Promise<SubscriptionBundleRecord[]>;
+    add(data: CreateSubscriptionBundleData): Promise<SubscriptionBundleRecord>;
+    cancel(subscriptionBundleId: string, data: CancelSubscriptionBundleData): Promise<SubscriptionBundleRecord>;
+    reactivate(subscriptionBundleId: string): Promise<SubscriptionBundleRecord>;
+    countActiveByBundleVersionId(bundleVersionId: string, asOf?: Date): Promise<number>;
+}
+/**
+ * In-memory FakeSubscriptionContractRepository — models the V3
+ * append-only contract schema. `create` clones snapshots deeply enough for
+ * immutability tests; `terminate` only changes status/effectiveUntil.
+ */
+declare class FakeSubscriptionContractRepository implements SubscriptionContractRepository {
+    private readonly byId;
+    private nextContractId;
+    private nextLineItemId;
+    clear(): void;
+    list(filter: SubscriptionContractFilter): Promise<SubscriptionContractRecord[]>;
+    findById(contractId: string): Promise<SubscriptionContractRecord | null>;
+    findActiveByTenantId(tenantId: string, asOf?: Date): Promise<SubscriptionContractRecord | null>;
+    create(data: CreateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    terminate(contractId: string, data: TerminateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    private isActiveAt;
+    private cloneRecord;
+}
+/**
+ * In-memory FakePlanVersionRepository — stores PlanVersions per `planId`
+ * and returns the most recently set one as "latest live".
+ */
+declare class FakePlanVersionRepository implements PlanVersionRepository {
+    private readonly byPlanId;
+    set(record: PlanVersionRecord): void;
+    clear(): void;
+    findLatestLive(planId: string, _tx?: TransactionContext): Promise<PlanVersionRecord | null>;
+    findActive(planId: string, _asOf?: Date, _tx?: TransactionContext): Promise<PlanVersionRecord | null>;
+}
+/**
+ * Fake TransactionRunner for tests — runs the callback function directly
+ * and passes a sentinel `tx` value. No rollback behavior, no atomic
+ * guarantees — tests that need to check the tx semantics should run
+ * against a real DB.
+ */
+declare class FakeTransactionRunner implements TransactionRunner {
+    /** Sentinel value passed through as the TransactionContext. */
+    static readonly TX_SENTINEL: unique symbol;
+    runCount: number;
+    run<T>(fn: (tx: TransactionContext) => Promise<T>): Promise<T>;
+}
+/**
+ * In-memory implementation of `BundleRepository` for tests of the
+ * `BundlesService`. Implements the partial unique constraints (max. 1
+ * draft per bundle) and the publish semantics (previous live gets
+ * superseded) as pure-JS logic.
+ */
+declare class FakeBundleRepository implements BundleRepository {
+    private readonly bundles;
+    private readonly versions;
+    private nextId;
+    private genId;
+    private nowIso;
+    seedBundle(row: BundleRow): void;
+    seedVersion(row: BundleVersionRow): void;
+    clear(): void;
+    list(filter: BundleListFilter): Promise<BundleRow[]>;
+    findById(bundleId: string): Promise<BundleRow | null>;
+    findByKey(projectKey: string, bundleKey: string): Promise<BundleRow | null>;
+    create(data: CreateBundleData): Promise<BundleRow>;
+    update(bundleId: string, data: UpdateBundleData): Promise<BundleRow>;
+    softDelete(bundleId: string): Promise<void>;
+    listVersions(bundleId: string): Promise<BundleVersionRow[]>;
+    findVersionById(versionId: string): Promise<BundleVersionRow | null>;
+    findCurrentDraft(bundleId: string): Promise<BundleVersionRow | null>;
+    findLatestLive(bundleId: string): Promise<BundleVersionRow | null>;
+    createDraft(data: CreateBundleVersionDraftData): Promise<BundleVersionRow>;
+    updateDraft(versionId: string, data: UpdateBundleVersionDraftData): Promise<BundleVersionRow>;
+    deleteDraft(versionId: string): Promise<void>;
+    publishDraft(versionId: string, publishMeta: {
+        publishedByUserId: string | null;
+        publishedChanges: VersionChange[];
+        nonRegressive: boolean;
+        validFrom: Date;
+        validUntil: Date | null;
+    }): Promise<BundleVersionRow>;
+}
+/**
+ * In-memory implementation of `BusinessTypeRepository`. Keeps the
+ * BusinessTypeBundle junction directly inside the BusinessTypeVersionRow objects
+ * (analogous to the wire-format convention).
+ */
+declare class FakeBusinessTypeRepository implements BusinessTypeRepository {
+    private readonly types;
+    private readonly versions;
+    private nextId;
+    private genId;
+    private nowIso;
+    seedBusinessType(row: BusinessTypeRow): void;
+    seedVersion(row: BusinessTypeVersionRow): void;
+    clear(): void;
+    list(filter: BusinessTypeListFilter): Promise<BusinessTypeRow[]>;
+    findById(businessTypeId: string): Promise<BusinessTypeRow | null>;
+    findByKey(projectKey: string, businessTypeKey: string): Promise<BusinessTypeRow | null>;
+    create(data: CreateBusinessTypeData): Promise<BusinessTypeRow>;
+    update(businessTypeId: string, data: UpdateBusinessTypeData): Promise<BusinessTypeRow>;
+    softDelete(businessTypeId: string): Promise<void>;
+    listVersions(businessTypeId: string): Promise<BusinessTypeVersionRow[]>;
+    findVersionById(versionId: string): Promise<BusinessTypeVersionRow | null>;
+    findCurrentDraft(businessTypeId: string): Promise<BusinessTypeVersionRow | null>;
+    findLatestLive(businessTypeId: string): Promise<BusinessTypeVersionRow | null>;
+    createDraft(data: CreateBusinessTypeVersionDraftData): Promise<BusinessTypeVersionRow>;
+    updateDraft(versionId: string, data: UpdateBusinessTypeVersionDraftData): Promise<BusinessTypeVersionRow>;
+    publishDraft(versionId: string, publishMeta: {
+        publishedByUserId: string | null;
+        publishedChanges: VersionChange[];
+        nonRegressive: boolean;
+    }): Promise<BusinessTypeVersionRow>;
+}
+/**
+ * In-memory implementation of `MarketingProjectionRepository`. Enforces
+ * uniqueness over (`targetType`, `targetVersionId`, `locale`) like the
+ * DB schema.
+ */
+declare class FakeMarketingProjectionRepository implements MarketingProjectionRepository {
+    private readonly rows;
+    private nextId;
+    private genId;
+    private nowIso;
+    seed(row: MarketingProjectionRow): void;
+    clear(): void;
+    list(filter: MarketingProjectionFilter): Promise<MarketingProjectionRow[]>;
+    findById(id: string): Promise<MarketingProjectionRow | null>;
+    findByTarget(targetType: string, targetVersionId: string, locale: string): Promise<MarketingProjectionRow | null>;
+    create(data: CreateMarketingProjectionData): Promise<MarketingProjectionRow>;
+    update(id: string, data: UpdateMarketingProjectionData): Promise<MarketingProjectionRow>;
+    delete(id: string): Promise<void>;
+}
+declare class FakePlanRepository implements PlanRepository {
+    private readonly plans;
+    private readonly versions;
+    private nextId;
+    private nextVersionId;
+    private genId;
+    private genVersionId;
+    private nowIso;
+    seed(row: PlanRow): void;
+    seedVersion(row: PlanVersionRow): void;
+    clear(): void;
+    list(filter: PlanListFilter): Promise<PlanRow[]>;
+    findById(planId: string): Promise<PlanRow | null>;
+    findByKey(projectKey: string, planKey: string): Promise<PlanRow | null>;
+    create(data: CreatePlanData): Promise<PlanRow>;
+    update(planId: string, data: UpdatePlanData): Promise<PlanRow>;
+    softDelete(planId: string): Promise<void>;
+    hardDelete(planId: string): Promise<void>;
+    listVersions(planKey: string): Promise<PlanVersionRow[]>;
+    findVersionById(versionId: string): Promise<PlanVersionRow | null>;
+    findCurrentDraft(planKey: string): Promise<PlanVersionRow | null>;
+    findLatestLivePlanVersion(planKey: string): Promise<PlanVersionRow | null>;
+    findActivePlanVersion(planKey: string, asOf?: Date): Promise<PlanVersionRow | null>;
+    createPlanVersionDraft(data: CreatePlanVersionDraftData): Promise<PlanVersionRow>;
+    updatePlanVersionDraft(versionId: string, data: UpdatePlanVersionDraftData): Promise<PlanVersionRow>;
+    publishPlanVersionDraft(versionId: string, publishMeta: {
+        publishedByUserId: string | null;
+        publishedChanges: VersionChange[];
+        nonRegressive: boolean;
+        validFrom: Date;
+        validUntil: Date | null;
+    }): Promise<PlanVersionRow>;
+    deletePlanVersionDraft(versionId: string): Promise<void>;
+    terminate(versionId: string, endsAt: Date): Promise<PlanVersionRow>;
+}
+
+/** No-op stub for `MfaPort`. */
+declare class StubMfaPort {
+    private secrets;
+    getSecret(userId: string): Promise<string | null>;
+    setSecret(userId: string, secret: string | null): Promise<void>;
+    isEnabled(userId: string): Promise<boolean>;
+}
+/** No-op stub for `AuditPort`. Keeps calls as a list for asserts. */
+declare class StubAuditPort {
+    readonly calls: Array<{
+        actor: unknown;
+        entity: string;
+        entityId: string;
+        action: string;
+        changes?: Record<string, unknown>;
+    }>;
+    write(input: {
+        actor: unknown;
+        entity: string;
+        entityId: string;
+        action: string;
+        changes?: Record<string, unknown>;
+    }): Promise<void>;
+}
+/** No-op stub for `RlsBypassPort` — calls the callback without wrapping. */
+declare class StubRlsBypassPort {
+    runWithBypass<T>(fn: () => Promise<T>): Promise<T>;
+}
+interface CreateSaasPlatformTestModuleOptions {
+    planCatalog: PlanCatalog;
+    /** Default `'starter'` if the catalog has at least one plan. */
+    defaultPlanId?: string;
+    /** QuotaProvider classes for the `EnforceQuotaInterceptor`. */
+    quotaProviders?: Array<Type<QuotaProvider>>;
+    /** Overrides — if the test needs a different adapter. */
+    overrides?: Partial<{
+        mfa: SaasPlatformModuleOptions['adapters']['mfa'];
+        audit: SaasPlatformModuleOptions['adapters']['audit'];
+        rlsBypass: SaasPlatformModuleOptions['adapters']['rlsBypass'];
+    }>;
+}
+/**
+ * Returns a `DynamicModule` that sets up the SaasPlatformModule with stub
+ * adapters + the given PlanCatalog in static entitlement mode.
+ * Tests can drop this into `Test.createTestingModule({ imports: [...] })`.
+ */
+declare function createSaasPlatformTestModule(options: CreateSaasPlatformTestModuleOptions): DynamicModule;
+
+export { type CreateSaasPlatformTestModuleOptions, FakeBundleRepository, FakeBusinessTypeRepository, FakeMarketingProjectionRepository, FakePlanRepository, FakePlanVersionRepository, FakeSubscriptionBundleRepository, FakeSubscriptionContractRepository, FakeSubscriptionRepository, FakeTransactionRunner, StubAuditPort, StubMfaPort, StubRlsBypassPort, createSaasPlatformTestModule };

package/dist/testing/index.d.ts

@@ -0,0 +1,279 @@
+import { BundleRepository, BundleRow, BundleVersionRow, BundleListFilter, CreateBundleData, UpdateBundleData, CreateBundleVersionDraftData, UpdateBundleVersionDraftData, VersionChange, BusinessTypeRepository, BusinessTypeRow, BusinessTypeVersionRow, BusinessTypeListFilter, CreateBusinessTypeData, UpdateBusinessTypeData, CreateBusinessTypeVersionDraftData, UpdateBusinessTypeVersionDraftData, 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/types';
+import { Type, DynamicModule } from '@nestjs/common';
+import { S as SaasPlatformModuleOptions } from '../saas-platform.module-DT9TnCzk.js';
+import '../di-CcNeq9v-.js';
+import '../admin-manifest.config-DyrQNT7M.js';
+import '../discovery.scanner-CUYLKlYT.js';
+import '@nestjs/core';
+import '../plan-resolution-CFCoUkrE.js';
+
+/**
+ * In-memory FakeSubscriptionRepository — stores subscriptions by
+ * `tenantId` and returns them as a read snapshot. Lock semantics are not
+ * emulated (`findByTenantIdLocked` delegates to `findByTenantId`).
+ *
+ * Test setup:
+ *
+ *     const repo = new FakeSubscriptionRepository();
+ *     repo.set({ id: 'sub-1', tenantId: 't1', plan: 'STANDARD', ... });
+ */
+declare class FakeSubscriptionRepository implements SubscriptionRepository {
+    private readonly byTenantId;
+    /**
+     * Test stubs for the `countBy*` editability methods. Tests set them
+     * directly; default 0 (= "no subscription binds the version" →
+     * published-but-future versions are editable when they are latest-in-chain
+     * and validFrom lies in the future).
+     */
+    private readonly planVersionCounts;
+    private readonly bundleVersionCounts;
+    set(record: SubscriptionRecord): void;
+    delete(tenantId: string): void;
+    clear(): void;
+    /** Test helper: force the number of subscriptions for a PlanVersion. */
+    setPlanVersionCount(planVersionId: string, count: number): void;
+    /** Test helper: force the number of subscriptions for a BundleVersion. */
+    setBundleVersionCount(bundleVersionId: string, count: number): void;
+    findByTenantId(tenantId: string): Promise<SubscriptionRecord | null>;
+    findByTenantIdLocked(tenantId: string, _tx: TransactionContext): Promise<SubscriptionRecord | null>;
+    countByPlanVersionId(planVersionId: string): Promise<number>;
+    countByBundleVersionId(bundleVersionId: string): Promise<number>;
+}
+/**
+ * In-memory FakeSubscriptionBundleRepository — stores
+ * `subscription_bundles` entries by id. `add` / `cancel` are
+ * fail-fast (no re-cancel); the minimum-term default comes from the service
+ * (not implemented yet today — tests set the field explicitly).
+ *
+ * Test setup:
+ *
+ *     const repo = new FakeSubscriptionBundleRepository();
+ *     const row = await repo.add({ subscriptionId: 's1',
+ *         bundleVersionId: 'bv1', startedAt: new Date() });
+ */
+declare class FakeSubscriptionBundleRepository implements SubscriptionBundleRepository {
+    private readonly byId;
+    private nextId;
+    private now;
+    clear(): void;
+    listBySubscription(subscriptionId: string): Promise<SubscriptionBundleRecord[]>;
+    findById(subscriptionBundleId: string): Promise<SubscriptionBundleRecord | null>;
+    listActiveBySubscription(subscriptionId: string, asOf?: Date): Promise<SubscriptionBundleRecord[]>;
+    add(data: CreateSubscriptionBundleData): Promise<SubscriptionBundleRecord>;
+    cancel(subscriptionBundleId: string, data: CancelSubscriptionBundleData): Promise<SubscriptionBundleRecord>;
+    reactivate(subscriptionBundleId: string): Promise<SubscriptionBundleRecord>;
+    countActiveByBundleVersionId(bundleVersionId: string, asOf?: Date): Promise<number>;
+}
+/**
+ * In-memory FakeSubscriptionContractRepository — models the V3
+ * append-only contract schema. `create` clones snapshots deeply enough for
+ * immutability tests; `terminate` only changes status/effectiveUntil.
+ */
+declare class FakeSubscriptionContractRepository implements SubscriptionContractRepository {
+    private readonly byId;
+    private nextContractId;
+    private nextLineItemId;
+    clear(): void;
+    list(filter: SubscriptionContractFilter): Promise<SubscriptionContractRecord[]>;
+    findById(contractId: string): Promise<SubscriptionContractRecord | null>;
+    findActiveByTenantId(tenantId: string, asOf?: Date): Promise<SubscriptionContractRecord | null>;
+    create(data: CreateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    terminate(contractId: string, data: TerminateSubscriptionContractData): Promise<SubscriptionContractRecord>;
+    private isActiveAt;
+    private cloneRecord;
+}
+/**
+ * In-memory FakePlanVersionRepository — stores PlanVersions per `planId`
+ * and returns the most recently set one as "latest live".
+ */
+declare class FakePlanVersionRepository implements PlanVersionRepository {
+    private readonly byPlanId;
+    set(record: PlanVersionRecord): void;
+    clear(): void;
+    findLatestLive(planId: string, _tx?: TransactionContext): Promise<PlanVersionRecord | null>;
+    findActive(planId: string, _asOf?: Date, _tx?: TransactionContext): Promise<PlanVersionRecord | null>;
+}
+/**
+ * Fake TransactionRunner for tests — runs the callback function directly
+ * and passes a sentinel `tx` value. No rollback behavior, no atomic
+ * guarantees — tests that need to check the tx semantics should run
+ * against a real DB.
+ */
+declare class FakeTransactionRunner implements TransactionRunner {
+    /** Sentinel value passed through as the TransactionContext. */
+    static readonly TX_SENTINEL: unique symbol;
+    runCount: number;
+    run<T>(fn: (tx: TransactionContext) => Promise<T>): Promise<T>;
+}
+/**
+ * In-memory implementation of `BundleRepository` for tests of the
+ * `BundlesService`. Implements the partial unique constraints (max. 1
+ * draft per bundle) and the publish semantics (previous live gets
+ * superseded) as pure-JS logic.
+ */
+declare class FakeBundleRepository implements BundleRepository {
+    private readonly bundles;
+    private readonly versions;
+    private nextId;
+    private genId;
+    private nowIso;
+    seedBundle(row: BundleRow): void;
+    seedVersion(row: BundleVersionRow): void;
+    clear(): void;
+    list(filter: BundleListFilter): Promise<BundleRow[]>;
+    findById(bundleId: string): Promise<BundleRow | null>;
+    findByKey(projectKey: string, bundleKey: string): Promise<BundleRow | null>;
+    create(data: CreateBundleData): Promise<BundleRow>;
+    update(bundleId: string, data: UpdateBundleData): Promise<BundleRow>;
+    softDelete(bundleId: string): Promise<void>;
+    listVersions(bundleId: string): Promise<BundleVersionRow[]>;
+    findVersionById(versionId: string): Promise<BundleVersionRow | null>;
+    findCurrentDraft(bundleId: string): Promise<BundleVersionRow | null>;
+    findLatestLive(bundleId: string): Promise<BundleVersionRow | null>;
+    createDraft(data: CreateBundleVersionDraftData): Promise<BundleVersionRow>;
+    updateDraft(versionId: string, data: UpdateBundleVersionDraftData): Promise<BundleVersionRow>;
+    deleteDraft(versionId: string): Promise<void>;
+    publishDraft(versionId: string, publishMeta: {
+        publishedByUserId: string | null;
+        publishedChanges: VersionChange[];
+        nonRegressive: boolean;
+        validFrom: Date;
+        validUntil: Date | null;
+    }): Promise<BundleVersionRow>;
+}
+/**
+ * In-memory implementation of `BusinessTypeRepository`. Keeps the
+ * BusinessTypeBundle junction directly inside the BusinessTypeVersionRow objects
+ * (analogous to the wire-format convention).
+ */
+declare class FakeBusinessTypeRepository implements BusinessTypeRepository {
+    private readonly types;
+    private readonly versions;
+    private nextId;
+    private genId;
+    private nowIso;
+    seedBusinessType(row: BusinessTypeRow): void;
+    seedVersion(row: BusinessTypeVersionRow): void;
+    clear(): void;
+    list(filter: BusinessTypeListFilter): Promise<BusinessTypeRow[]>;
+    findById(businessTypeId: string): Promise<BusinessTypeRow | null>;
+    findByKey(projectKey: string, businessTypeKey: string): Promise<BusinessTypeRow | null>;
+    create(data: CreateBusinessTypeData): Promise<BusinessTypeRow>;
+    update(businessTypeId: string, data: UpdateBusinessTypeData): Promise<BusinessTypeRow>;
+    softDelete(businessTypeId: string): Promise<void>;
+    listVersions(businessTypeId: string): Promise<BusinessTypeVersionRow[]>;
+    findVersionById(versionId: string): Promise<BusinessTypeVersionRow | null>;
+    findCurrentDraft(businessTypeId: string): Promise<BusinessTypeVersionRow | null>;
+    findLatestLive(businessTypeId: string): Promise<BusinessTypeVersionRow | null>;
+    createDraft(data: CreateBusinessTypeVersionDraftData): Promise<BusinessTypeVersionRow>;
+    updateDraft(versionId: string, data: UpdateBusinessTypeVersionDraftData): Promise<BusinessTypeVersionRow>;
+    publishDraft(versionId: string, publishMeta: {
+        publishedByUserId: string | null;
+        publishedChanges: VersionChange[];
+        nonRegressive: boolean;
+    }): Promise<BusinessTypeVersionRow>;
+}
+/**
+ * In-memory implementation of `MarketingProjectionRepository`. Enforces
+ * uniqueness over (`targetType`, `targetVersionId`, `locale`) like the
+ * DB schema.
+ */
+declare class FakeMarketingProjectionRepository implements MarketingProjectionRepository {
+    private readonly rows;
+    private nextId;
+    private genId;
+    private nowIso;
+    seed(row: MarketingProjectionRow): void;
+    clear(): void;
+    list(filter: MarketingProjectionFilter): Promise<MarketingProjectionRow[]>;
+    findById(id: string): Promise<MarketingProjectionRow | null>;
+    findByTarget(targetType: string, targetVersionId: string, locale: string): Promise<MarketingProjectionRow | null>;
+    create(data: CreateMarketingProjectionData): Promise<MarketingProjectionRow>;
+    update(id: string, data: UpdateMarketingProjectionData): Promise<MarketingProjectionRow>;
+    delete(id: string): Promise<void>;
+}
+declare class FakePlanRepository implements PlanRepository {
+    private readonly plans;
+    private readonly versions;
+    private nextId;
+    private nextVersionId;
+    private genId;
+    private genVersionId;
+    private nowIso;
+    seed(row: PlanRow): void;
+    seedVersion(row: PlanVersionRow): void;
+    clear(): void;
+    list(filter: PlanListFilter): Promise<PlanRow[]>;
+    findById(planId: string): Promise<PlanRow | null>;
+    findByKey(projectKey: string, planKey: string): Promise<PlanRow | null>;
+    create(data: CreatePlanData): Promise<PlanRow>;
+    update(planId: string, data: UpdatePlanData): Promise<PlanRow>;
+    softDelete(planId: string): Promise<void>;
+    hardDelete(planId: string): Promise<void>;
+    listVersions(planKey: string): Promise<PlanVersionRow[]>;
+    findVersionById(versionId: string): Promise<PlanVersionRow | null>;
+    findCurrentDraft(planKey: string): Promise<PlanVersionRow | null>;
+    findLatestLivePlanVersion(planKey: string): Promise<PlanVersionRow | null>;
+    findActivePlanVersion(planKey: string, asOf?: Date): Promise<PlanVersionRow | null>;
+    createPlanVersionDraft(data: CreatePlanVersionDraftData): Promise<PlanVersionRow>;
+    updatePlanVersionDraft(versionId: string, data: UpdatePlanVersionDraftData): Promise<PlanVersionRow>;
+    publishPlanVersionDraft(versionId: string, publishMeta: {
+        publishedByUserId: string | null;
+        publishedChanges: VersionChange[];
+        nonRegressive: boolean;
+        validFrom: Date;
+        validUntil: Date | null;
+    }): Promise<PlanVersionRow>;
+    deletePlanVersionDraft(versionId: string): Promise<void>;
+    terminate(versionId: string, endsAt: Date): Promise<PlanVersionRow>;
+}
+
+/** No-op stub for `MfaPort`. */
+declare class StubMfaPort {
+    private secrets;
+    getSecret(userId: string): Promise<string | null>;
+    setSecret(userId: string, secret: string | null): Promise<void>;
+    isEnabled(userId: string): Promise<boolean>;
+}
+/** No-op stub for `AuditPort`. Keeps calls as a list for asserts. */
+declare class StubAuditPort {
+    readonly calls: Array<{
+        actor: unknown;
+        entity: string;
+        entityId: string;
+        action: string;
+        changes?: Record<string, unknown>;
+    }>;
+    write(input: {
+        actor: unknown;
+        entity: string;
+        entityId: string;
+        action: string;
+        changes?: Record<string, unknown>;
+    }): Promise<void>;
+}
+/** No-op stub for `RlsBypassPort` — calls the callback without wrapping. */
+declare class StubRlsBypassPort {
+    runWithBypass<T>(fn: () => Promise<T>): Promise<T>;
+}
+interface CreateSaasPlatformTestModuleOptions {
+    planCatalog: PlanCatalog;
+    /** Default `'starter'` if the catalog has at least one plan. */
+    defaultPlanId?: string;
+    /** QuotaProvider classes for the `EnforceQuotaInterceptor`. */
+    quotaProviders?: Array<Type<QuotaProvider>>;
+    /** Overrides — if the test needs a different adapter. */
+    overrides?: Partial<{
+        mfa: SaasPlatformModuleOptions['adapters']['mfa'];
+        audit: SaasPlatformModuleOptions['adapters']['audit'];
+        rlsBypass: SaasPlatformModuleOptions['adapters']['rlsBypass'];
+    }>;
+}
+/**
+ * Returns a `DynamicModule` that sets up the SaasPlatformModule with stub
+ * adapters + the given PlanCatalog in static entitlement mode.
+ * Tests can drop this into `Test.createTestingModule({ imports: [...] })`.
+ */
+declare function createSaasPlatformTestModule(options: CreateSaasPlatformTestModuleOptions): DynamicModule;
+
+export { type CreateSaasPlatformTestModuleOptions, FakeBundleRepository, FakeBusinessTypeRepository, FakeMarketingProjectionRepository, FakePlanRepository, FakePlanVersionRepository, FakeSubscriptionBundleRepository, FakeSubscriptionContractRepository, FakeSubscriptionRepository, FakeTransactionRunner, StubAuditPort, StubMfaPort, StubRlsBypassPort, createSaasPlatformTestModule };