@saasicat/persistence-testing 1.0.0-rc.15 → 1.0.0-rc.17

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { PersistenceCapabilities, TransactionRunner, SubscriptionRepository, PlanVersionRepository, PromoCodeRepository, PromoCodeRedemptionRepository, MfaPort, AuditPort, AuditQueryPort, SubscriptionContractRepository, CheckoutOfferRepository, TenantSubscriptionWritePort, BundleRepository, SubscriptionBundleRepository, PlanRepository, PromoSubscriptionLookup, AppliedSettingsPort } from '@saasicat/core';
+import { PersistenceCapabilities, TransactionRunner, SubscriptionRepository, PlanVersionRepository, PromoCodeRepository, PromoCodeRedemptionRepository, MfaPort, AuditPort, AuditQueryPort, SubscriptionContractRepository, SubscriberRepository, PaymentEventLog, SubscriberPaymentMethodRepository, CheckoutOfferRepository, TenantSubscriptionWritePort, BundleRepository, SubscriptionBundleRepository, PlanRepository, PromoSubscriptionLookup, AppliedSettingsPort } from '@saasicat/core';
 
 /**
  * Port instances under test. Required members define the minimum an adapter
@@ -18,6 +18,27 @@ interface ContractAdapterInstances {
     audit?: AuditPort;
     auditQuery?: AuditQueryPort;
     subscriptionContractRepository?: SubscriptionContractRepository;
+    /**
+     * Enables the subscriber scenarios: a customer number the database
+     * counts, one live subscriber per tenant however many callers create one
+     * at once, and a correction that records the values it replaced. A
+     * contract names its subscriber, so the contract scenarios write theirs
+     * through `seed.createSubscriber` rather than through this port.
+     */
+    subscriberRepository?: SubscriberRepository;
+    /**
+     * Enables the gateway event scenarios: an event is claimed once per
+     * account, a duplicate leaves the caller's transaction usable, and a claim
+     * rolled back with its transaction is free for the gateway's retry.
+     */
+    paymentEventLog?: PaymentEventLog;
+    /**
+     * Enables the payment method scenarios: one payment method in use per
+     * subscriber however many confirmations arrive at once, the one it
+     * replaced kept as history, and a confirmation recorded twice recognised.
+     * Its subscribers come from `seed.createSubscriber`.
+     */
+    subscriberPaymentMethodRepository?: SubscriberPaymentMethodRepository;
     /**
      * Enables the checkout offer scenarios: an offer is consumed once, and a
      * consume on a transaction that rolls back leaves it open. Neither shipped
@@ -124,6 +145,19 @@ interface ContractSeed {
     }): Promise<{
         promoCodeId: string;
     }>;
+    /**
+     * A subscriber row for a contract scenario to name, linked to no tenant.
+     *
+     * A fixture writer for the reason `createBundleVersion` is one: the
+     * subscriber repository is a subject of its own scenarios, and a contract
+     * scenario that failed because of it would say the wrong thing. Optional
+     * like the port it stands beside; the contract scenarios report it missing.
+     */
+    createSubscriber?(input: {
+        legalName: string;
+    }): Promise<{
+        subscriberId: string;
+    }>;
 }
 interface PersistenceContractHarness {
     adapter: ContractAdapterInstances;
@@ -139,7 +173,7 @@ interface PersistenceContractHarness {
  * Each names the members its scenarios need; `contract.ts` holds the list with
  * what each one checks.
  */
-type ContractGap = 'atomicPlanBinding' | 'atomicOnboarding' | 'promoCodes' | 'promoCodeRedemptions' | 'promoSubscriptionLookup' | 'planRepository' | 'planLifecycle' | 'planRetirement' | 'planVersionReads' | 'planVersionRetirement' | 'bundleRepository' | 'bundleValidity' | 'bundleDraftDiscard' | 'bundleDraftPublish' | 'bundleRetirement' | 'bundleBookings' | 'halfCancelledBookingSeed' | 'countByPlanVersionId' | 'audit' | 'mfa' | 'subscriptionContracts' | 'checkoutOffers' | 'appliedSettings';
+type ContractGap = 'atomicPlanBinding' | 'atomicOnboarding' | 'promoCodes' | 'promoCodeRedemptions' | 'promoSubscriptionLookup' | 'planRepository' | 'planLifecycle' | 'planRetirement' | 'planVersionReads' | 'planVersionRetirement' | 'bundleRepository' | 'bundleValidity' | 'bundleDraftDiscard' | 'bundleDraftPublish' | 'bundleRetirement' | 'bundleBookings' | 'halfCancelledBookingSeed' | 'countByPlanVersionId' | 'audit' | 'mfa' | 'subscriptionContracts' | 'subscribers' | 'paymentEventLog' | 'subscriberPaymentMethods' | 'checkoutOffers' | 'appliedSettings';
 interface PersistenceAdapterContractOptions {
     /** Display name in the test output, e.g. `'adapter-prisma @ postgres16'`. */
     name: string;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PersistenceCapabilities, TransactionRunner, SubscriptionRepository, PlanVersionRepository, PromoCodeRepository, PromoCodeRedemptionRepository, MfaPort, AuditPort, AuditQueryPort, SubscriptionContractRepository, CheckoutOfferRepository, TenantSubscriptionWritePort, BundleRepository, SubscriptionBundleRepository, PlanRepository, PromoSubscriptionLookup, AppliedSettingsPort } from '@saasicat/core';
+import { PersistenceCapabilities, TransactionRunner, SubscriptionRepository, PlanVersionRepository, PromoCodeRepository, PromoCodeRedemptionRepository, MfaPort, AuditPort, AuditQueryPort, SubscriptionContractRepository, SubscriberRepository, PaymentEventLog, SubscriberPaymentMethodRepository, CheckoutOfferRepository, TenantSubscriptionWritePort, BundleRepository, SubscriptionBundleRepository, PlanRepository, PromoSubscriptionLookup, AppliedSettingsPort } from '@saasicat/core';
 
 /**
  * Port instances under test. Required members define the minimum an adapter
@@ -18,6 +18,27 @@ interface ContractAdapterInstances {
     audit?: AuditPort;
     auditQuery?: AuditQueryPort;
     subscriptionContractRepository?: SubscriptionContractRepository;
+    /**
+     * Enables the subscriber scenarios: a customer number the database
+     * counts, one live subscriber per tenant however many callers create one
+     * at once, and a correction that records the values it replaced. A
+     * contract names its subscriber, so the contract scenarios write theirs
+     * through `seed.createSubscriber` rather than through this port.
+     */
+    subscriberRepository?: SubscriberRepository;
+    /**
+     * Enables the gateway event scenarios: an event is claimed once per
+     * account, a duplicate leaves the caller's transaction usable, and a claim
+     * rolled back with its transaction is free for the gateway's retry.
+     */
+    paymentEventLog?: PaymentEventLog;
+    /**
+     * Enables the payment method scenarios: one payment method in use per
+     * subscriber however many confirmations arrive at once, the one it
+     * replaced kept as history, and a confirmation recorded twice recognised.
+     * Its subscribers come from `seed.createSubscriber`.
+     */
+    subscriberPaymentMethodRepository?: SubscriberPaymentMethodRepository;
     /**
      * Enables the checkout offer scenarios: an offer is consumed once, and a
      * consume on a transaction that rolls back leaves it open. Neither shipped
@@ -124,6 +145,19 @@ interface ContractSeed {
     }): Promise<{
         promoCodeId: string;
     }>;
+    /**
+     * A subscriber row for a contract scenario to name, linked to no tenant.
+     *
+     * A fixture writer for the reason `createBundleVersion` is one: the
+     * subscriber repository is a subject of its own scenarios, and a contract
+     * scenario that failed because of it would say the wrong thing. Optional
+     * like the port it stands beside; the contract scenarios report it missing.
+     */
+    createSubscriber?(input: {
+        legalName: string;
+    }): Promise<{
+        subscriberId: string;
+    }>;
 }
 interface PersistenceContractHarness {
     adapter: ContractAdapterInstances;
@@ -139,7 +173,7 @@ interface PersistenceContractHarness {
  * Each names the members its scenarios need; `contract.ts` holds the list with
  * what each one checks.
  */
-type ContractGap = 'atomicPlanBinding' | 'atomicOnboarding' | 'promoCodes' | 'promoCodeRedemptions' | 'promoSubscriptionLookup' | 'planRepository' | 'planLifecycle' | 'planRetirement' | 'planVersionReads' | 'planVersionRetirement' | 'bundleRepository' | 'bundleValidity' | 'bundleDraftDiscard' | 'bundleDraftPublish' | 'bundleRetirement' | 'bundleBookings' | 'halfCancelledBookingSeed' | 'countByPlanVersionId' | 'audit' | 'mfa' | 'subscriptionContracts' | 'checkoutOffers' | 'appliedSettings';
+type ContractGap = 'atomicPlanBinding' | 'atomicOnboarding' | 'promoCodes' | 'promoCodeRedemptions' | 'promoSubscriptionLookup' | 'planRepository' | 'planLifecycle' | 'planRetirement' | 'planVersionReads' | 'planVersionRetirement' | 'bundleRepository' | 'bundleValidity' | 'bundleDraftDiscard' | 'bundleDraftPublish' | 'bundleRetirement' | 'bundleBookings' | 'halfCancelledBookingSeed' | 'countByPlanVersionId' | 'audit' | 'mfa' | 'subscriptionContracts' | 'subscribers' | 'paymentEventLog' | 'subscriberPaymentMethods' | 'checkoutOffers' | 'appliedSettings';
 interface PersistenceAdapterContractOptions {
     /** Display name in the test output, e.g. `'adapter-prisma @ postgres16'`. */
     name: string;