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

package/README.md

@@ -16,6 +16,9 @@ Verified scenarios:
 - PlanVersion and BundleVersion validity windows with auto-succession
 - `countByPlanVersionId` counts current AND pending bindings in one query
 - transaction rollback discards writes
+- a contract written on a transaction is undone with it, and found by the offer it came from
+- a checkout offer is consumed once, whoever asks first, and a consume on a rolled-back transaction
+  leaves it open
 - `findByTenantIdLocked` serializes concurrent transactions (row lock)
 - concurrent `claimSlot` grants exactly `maxRedemptions` slots
 - claim / exhaust / release lifecycle
@@ -27,10 +30,20 @@ Verified scenarios:
   concurrently — with the change and the record it supersedes landing together;
   changes listed in the order they were recorded, acknowledged once
 
-Scenario groups gate on declared capabilities and provided slices; a
-gated-off group reports as **skipped with reason** — coverage gaps stay
-visible, never silent. Roadmap scenarios (subscription contracts, reference
-migrations N→N+1) are registered as visible skips until the slices ship.
+Scenario groups gate on declared capabilities and provided slices. A group the
+capabilities rule out, such as the lock scenarios with `pessimisticLocking:
+false`, reports as **skipped with reason**. A group whose port or seed writer
+the harness does not provide **fails**, unless the adapter names it in `gaps` —
+then it reports as skipped. A gap named there that the harness does provide
+fails the suite, so the list stays true. A skipped scenario is easy to read
+past in a green run; a harness that forgot to wire a port would otherwise pass
+without checking it.
+
+The list describes the harness as it is built, not the adapter package. Where a
+port adds a member only under an option — `@saasicat/adapter-prisma`'s
+`validityWindows` and `atomicOnboardingSelection`, off by default for a 0.6
+schema — compute `gaps` from the same option rather than writing a constant, so
+the declaration moves when the schema does.
 
 ## What this is not
 
@@ -49,26 +62,39 @@ find one.
 import { persistenceAdapterContract } from '@saasicat/persistence-testing';
 
 persistenceAdapterContract({
-    name: 'adapter-drizzle @ postgres',
+    name: 'my-adapter @ postgres',
     create: async () => ({
         adapter: {
             capabilities: { transactions: true, pessimisticLocking: true /* … */ },
             transactionRunner,
             subscriptionRepository,
             planVersionRepository,
-            promoCodeRepository, // optional slices activate more scenarios
+            planRepository,
+            bundleRepository,
+            subscriptionBundleRepository,
+            tenantSubscriptionWrite,
+            promoCodeRepository,
             promoCodeRedemptionRepository,
+            promoSubscriptionLookup,
             mfa,
             audit,
             auditQuery,
-            tenantSubscriptionWrite, // optional: enables atomic plan-binding scenarios
-            planRepository, // optional: enables plan lifecycle scenarios
-            bundleRepository, // optional: enables bundle validity scenarios
+            // Leave a part out and name it in `gaps` below; left out and not
+            // named, its scenarios fail.
+        },
+        seed: {
+            createPlanVersion,
+            createSubscription,
+            createBundleVersion,
+            clearBookingRequestDate,
+            createPromoCode,
         },
-        seed: { createPlanVersion, createSubscription, createPromoCode },
         reset: () => truncatePlatformTables(),
         close: () => pool.end(),
     }),
+    // The parts this adapter deliberately does not provide. A part named here
+    // that the harness does provide fails the suite as well.
+    gaps: ['subscriptionContracts', 'checkoutOffers', 'appliedSettings'],
 });
 ```
 

package/dist/.build-stamp

@@ -1 +1 @@
-d80f6a5ad7093fb33efd6de61d9d05aef2bf14e64f83b6d4c8756ec27c02cb42
+8fdc45ae34c5869710281576820410215b122b89385485ab7973ebfc8359157b