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

package/README.md

@@ -27,10 +27,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 +59,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', 'appliedSettings'],
 });
 ```
 

package/dist/.build-stamp

@@ -1 +1 @@
-d80f6a5ad7093fb33efd6de61d9d05aef2bf14e64f83b6d4c8756ec27c02cb42
+fe1ab043363d0764aaf580f2167335fcb0c2659c445bcc9540708782cb751a27

package/dist/index.cjs

@@ -38,12 +38,133 @@ module.exports = __toCommonJS(index_exports);
 var import_strict = __toESM(require("node:assert/strict"), 1);
 var import_node_test = require("node:test");
 var LOCK_HOLD_MS = 150;
+var CONTRACT_GAPS = {
+  atomicPlanBinding: {
+    reason: "adapter does not expose atomic plan-binding writes",
+    present: ({ adapter }) => Boolean(adapter.tenantSubscriptionWrite)
+  },
+  atomicOnboarding: {
+    reason: "adapter does not expose atomic onboarding writes",
+    present: ({ adapter }) => Boolean(adapter.tenantSubscriptionWrite?.applyOnboardingSelection)
+  },
+  promoCodes: {
+    reason: "adapter provides no PromoCodeRepository",
+    present: ({ adapter }) => Boolean(adapter.promoCodeRepository)
+  },
+  promoCodeRedemptions: {
+    reason: "adapter provides no PromoCodeRedemptionRepository",
+    present: ({ adapter }) => Boolean(adapter.promoCodeRedemptionRepository)
+  },
+  promoSubscriptionLookup: {
+    reason: "adapter provides no PromoSubscriptionLookup",
+    present: ({ adapter }) => Boolean(adapter.promoSubscriptionLookup)
+  },
+  planRepository: {
+    reason: "adapter provides no PlanRepository",
+    present: ({ adapter }) => Boolean(adapter.planRepository)
+  },
+  planLifecycle: {
+    reason: "adapter provides no time-aware PlanRepository lifecycle",
+    present: ({ adapter }) => {
+      const repository = adapter.planRepository;
+      return Boolean(
+        repository?.createPlanVersionDraft && repository.publishPlanVersionDraft && repository.findVersionById && repository.findActivePlanVersion
+      );
+    }
+  },
+  planRetirement: {
+    reason: "adapter provides no PlanRepository that retires and finds plans by key",
+    present: ({ adapter }) => Boolean(adapter.planRepository?.softDelete && adapter.planRepository.findByKey)
+  },
+  planVersionReads: {
+    reason: "adapter provides no PlanRepository that reads versions by plan key",
+    present: ({ adapter }) => {
+      const repository = adapter.planRepository;
+      return Boolean(
+        repository?.listVersions && repository.findCurrentDraft && repository.findLatestLivePlanVersion
+      );
+    }
+  },
+  planVersionRetirement: {
+    reason: "adapter provides no PlanRepository that reads versions and retires plans",
+    present: ({ adapter }) => {
+      const repository = adapter.planRepository;
+      return Boolean(
+        repository?.createPlanVersionDraft && repository.publishPlanVersionDraft && repository.listVersions && repository.findCurrentDraft && repository.findLatestLivePlanVersion && repository.softDelete
+      );
+    }
+  },
+  bundleRepository: {
+    reason: "adapter provides no BundleRepository",
+    present: ({ adapter }) => Boolean(adapter.bundleRepository)
+  },
+  bundleValidity: {
+    reason: "adapter provides no time-aware BundleRepository",
+    present: ({ adapter }) => Boolean(adapter.bundleRepository?.findActiveBundleVersion)
+  },
+  bundleDraftDiscard: {
+    reason: "adapter provides no BundleRepository that discards drafts",
+    present: ({ adapter }) => Boolean(adapter.bundleRepository?.deleteDraft)
+  },
+  bundleDraftPublish: {
+    reason: "adapter provides no BundleRepository that publishes drafts",
+    present: ({ adapter }) => Boolean(adapter.bundleRepository?.publishDraft)
+  },
+  bundleRetirement: {
+    reason: "adapter provides no BundleRepository that retires and finds bundles by key",
+    present: ({ adapter }) => Boolean(adapter.bundleRepository?.softDelete && adapter.bundleRepository.findByKey)
+  },
+  bundleBookings: {
+    reason: "adapter provides no SubscriptionBundleRepository or bundle catalog",
+    present: ({ adapter, seed }) => Boolean(adapter.subscriptionBundleRepository && seed.createBundleVersion)
+  },
+  halfCancelledBookingSeed: {
+    reason: "adapter harness cannot write the half-cancelled shape",
+    present: ({ seed }) => Boolean(seed.clearBookingRequestDate)
+  },
+  countByPlanVersionId: {
+    reason: "adapter does not implement countByPlanVersionId (fail-closed fallback)",
+    present: ({ adapter }) => Boolean(adapter.subscriptionRepository.countByPlanVersionId)
+  },
+  audit: {
+    reason: "adapter provides no AuditPort/AuditQueryPort pair",
+    present: ({ adapter }) => Boolean(adapter.audit && adapter.auditQuery)
+  },
+  mfa: {
+    reason: "adapter provides no MfaPort",
+    present: ({ adapter }) => Boolean(adapter.mfa)
+  },
+  subscriptionContracts: {
+    reason: "adapter provides no SubscriptionContractRepository",
+    present: ({ adapter }) => Boolean(adapter.subscriptionContractRepository)
+  },
+  appliedSettings: {
+    reason: "adapter provides no AppliedSettingsPort",
+    present: ({ adapter }) => Boolean(adapter.appliedSettings)
+  }
+};
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 function persistenceAdapterContract(options) {
+  const declaredGaps = new Set(options.gaps ?? []);
+  let harness;
+  function missing(t, gap) {
+    const { reason, present } = CONTRACT_GAPS[gap];
+    if (present(harness)) {
+      import_strict.default.fail(
+        `'${gap}' counts as provided, yet this scenario found a member it needs missing or not callable. Check that the harness wires the port itself; if it does, the contract's check for '${gap}' and this scenario disagree, which is a defect in @saasicat/persistence-testing.`
+      );
+    }
+    if (declaredGaps.has(gap)) {
+      t.skip(reason);
+      return;
+    }
+    import_strict.default.fail(
+      `${reason}. Wire it into the harness, or declare \`gaps: ['${gap}']\` in persistenceAdapterContract if the adapter deliberately does not provide it.`
+    );
+  }
   (0, import_node_test.describe)(`persistence adapter contract: ${options.name}`, () => {
-    let harness;
     (0, import_node_test.before)(async () => {
       harness = await options.create();
     });
@@ -53,6 +174,20 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.beforeEach)(async () => {
       await harness.reset();
     });
+    (0, import_node_test.test)("the declared gaps are exactly the parts the harness does not provide", () => {
+      const gaps = Object.keys(CONTRACT_GAPS);
+      const absent = gaps.filter((gap) => !CONTRACT_GAPS[gap].present(harness));
+      const known = (gap) => Object.prototype.hasOwnProperty.call(CONTRACT_GAPS, gap);
+      const unknown = [...declaredGaps].filter((gap) => !known(gap));
+      const stale = [...declaredGaps].filter((gap) => known(gap) && !absent.includes(gap));
+      const undeclared = absent.filter((gap) => !declaredGaps.has(gap));
+      const problems = [
+        unknown.length > 0 && `declared as gaps but not parts of the contract: ${unknown.join(", ")} (ContractGap lists the names)`,
+        stale.length > 0 && `declared as gaps but wired into the harness: ${stale.join(", ")}`,
+        undeclared.length > 0 && `not wired into the harness and not declared as gaps: ${undeclared.join(", ")}`
+      ].filter(Boolean);
+      import_strict.default.deepEqual(problems, [], problems.join("; "));
+    });
     (0, import_node_test.test)("findByTenantId returns the tenant subscription with plan-version limits", async () => {
       const { seed, adapter } = harness;
       const { planVersionId } = await seed.createPlanVersion({
@@ -127,7 +262,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("immediate plan change binds plan and active PlanVersion consistently", async (t) => {
       const { seed, adapter } = harness;
       if (!adapter.tenantSubscriptionWrite) {
-        t.skip("adapter does not expose atomic plan-binding writes");
+        missing(t, "atomicPlanBinding");
         return;
       }
       const oldVersion = await seed.createPlanVersion({
@@ -172,12 +307,12 @@ function persistenceAdapterContract(options) {
       const { seed, adapter } = harness;
       const writer = adapter.tenantSubscriptionWrite;
       if (!writer?.applyOnboardingSelection) {
-        t.skip("adapter does not expose atomic onboarding writes");
+        missing(t, "atomicOnboarding");
         return;
       }
       const redemptions = adapter.promoCodeRedemptionRepository;
       if (!redemptions) {
-        t.skip("adapter provides no PromoCodeRedemptionRepository");
+        missing(t, "promoCodeRedemptions");
         return;
       }
       const oldVersion = await seed.createPlanVersion({
@@ -256,7 +391,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("plan lifecycle keeps semantic identity and auto-succeeds validity windows", async (t) => {
       const repository = harness.adapter.planRepository;
       if (!repository?.createPlanVersionDraft || !repository.publishPlanVersionDraft || !repository.findVersionById || !repository.findActivePlanVersion) {
-        t.skip("adapter provides no time-aware PlanRepository lifecycle");
+        missing(t, "planLifecycle");
         return;
       }
       const plan = await repository.create({
@@ -320,7 +455,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("bundle lifecycle roundtrips validity and auto-succeeds atomically", async (t) => {
       const repository = harness.adapter.bundleRepository;
       if (!repository?.findActiveBundleVersion) {
-        t.skip("adapter provides no time-aware BundleRepository");
+        missing(t, "bundleValidity");
         return;
       }
       const bundle = await repository.create({
@@ -379,7 +514,7 @@ function persistenceAdapterContract(options) {
       const repository = harness.adapter.subscriptionBundleRepository;
       const { seed } = harness;
       if (!repository || !seed.createBundleVersion) {
-        t.skip("adapter provides no SubscriptionBundleRepository or bundle catalog");
+        missing(t, "bundleBookings");
         return;
       }
       const { planVersionId } = await seed.createPlanVersion({
@@ -434,7 +569,7 @@ function persistenceAdapterContract(options) {
       const repository = harness.adapter.subscriptionBundleRepository;
       const { seed } = harness;
       if (!repository || !seed.createBundleVersion) {
-        t.skip("adapter provides no SubscriptionBundleRepository or bundle catalog");
+        missing(t, "bundleBookings");
         return;
       }
       const { planVersionId } = await seed.createPlanVersion({
@@ -488,7 +623,7 @@ function persistenceAdapterContract(options) {
       const repository = harness.adapter.subscriptionBundleRepository;
       const { seed } = harness;
       if (!repository || !seed.createBundleVersion) {
-        t.skip("adapter provides no SubscriptionBundleRepository or bundle catalog");
+        missing(t, "bundleBookings");
         return;
       }
       const { planVersionId } = await seed.createPlanVersion({
@@ -533,7 +668,7 @@ function persistenceAdapterContract(options) {
       const repository = harness.adapter.subscriptionBundleRepository;
       const { seed } = harness;
       if (!repository || !seed.createBundleVersion) {
-        t.skip("adapter provides no SubscriptionBundleRepository or bundle catalog");
+        missing(t, "bundleBookings");
         return;
       }
       const { planVersionId } = await seed.createPlanVersion({
@@ -564,7 +699,7 @@ function persistenceAdapterContract(options) {
       });
       const clearRequestDate = harness.seed.clearBookingRequestDate;
       if (!clearRequestDate) {
-        t.skip("adapter harness cannot write the half-cancelled shape");
+        missing(t, "halfCancelledBookingSeed");
         return;
       }
       await clearRequestDate(booking.id);
@@ -585,7 +720,7 @@ function persistenceAdapterContract(options) {
       const catalog = harness.adapter.bundleRepository;
       const discardDraft = catalog?.deleteDraft?.bind(catalog);
       if (!catalog || !discardDraft) {
-        t.skip("adapter provides no BundleRepository");
+        missing(t, "bundleDraftDiscard");
         return;
       }
       const bundle = await catalog.create({
@@ -617,7 +752,7 @@ function persistenceAdapterContract(options) {
       const catalog = harness.adapter.bundleRepository;
       const publish = catalog?.publishDraft?.bind(catalog);
       if (!catalog || !publish) {
-        t.skip("adapter provides no BundleRepository");
+        missing(t, "bundleDraftPublish");
         return;
       }
       const bundle = await catalog.create({
@@ -680,7 +815,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("a plan key names one plan for the whole installation", async (t) => {
       const repository = harness.adapter.planRepository;
       if (!repository) {
-        t.skip("adapter provides no PlanRepository");
+        missing(t, "planRepository");
         return;
       }
       await repository.create({ planKey: "DOUBLE", label: "First" });
@@ -692,7 +827,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("a bundle key names one bundle for the whole installation", async (t) => {
       const catalog = harness.adapter.bundleRepository;
       if (!catalog) {
-        t.skip("adapter provides no BundleRepository");
+        missing(t, "bundleRepository");
         return;
       }
       await catalog.create({ bundleKey: "DOUBLE", label: "First" });
@@ -706,7 +841,7 @@ function persistenceAdapterContract(options) {
       const retire = repository?.softDelete?.bind(repository);
       const byKey = repository?.findByKey?.bind(repository);
       if (!repository || !retire || !byKey) {
-        t.skip("adapter provides no PlanRepository");
+        missing(t, "planRetirement");
         return;
       }
       const plan = await repository.create({ planKey: "RETIRED_PLAN", label: "Retired" });
@@ -720,12 +855,90 @@ function persistenceAdapterContract(options) {
         "a retired plan is not in the catalogue an operator browses"
       );
     });
+    (0, import_node_test.test)("a plan key no plan has finds no versions, rather than failing", async (t) => {
+      const repository = harness.adapter.planRepository;
+      if (!repository?.listVersions || !repository.findCurrentDraft || !repository.findLatestLivePlanVersion) {
+        missing(t, "planVersionReads");
+        return;
+      }
+      const entitlementVersions = harness.adapter.planVersionRepository;
+      import_strict.default.deepEqual(await repository.listVersions("NO_SUCH_PLAN"), []);
+      import_strict.default.equal(await repository.findCurrentDraft("NO_SUCH_PLAN"), null);
+      import_strict.default.equal(await repository.findLatestLivePlanVersion("NO_SUCH_PLAN"), null);
+      if (repository.findActivePlanVersion) {
+        import_strict.default.equal(
+          await repository.findActivePlanVersion("NO_SUCH_PLAN", /* @__PURE__ */ new Date()),
+          null
+        );
+      }
+      import_strict.default.equal(await entitlementVersions.findLatestLive("NO_SUCH_PLAN"), null);
+      if (entitlementVersions.findActive) {
+        import_strict.default.equal(
+          await entitlementVersions.findActive("NO_SUCH_PLAN", /* @__PURE__ */ new Date()),
+          null
+        );
+      }
+    });
+    (0, import_node_test.test)("retiring a plan hides none of its versions", async (t) => {
+      const repository = harness.adapter.planRepository;
+      if (!repository?.createPlanVersionDraft || !repository.publishPlanVersionDraft || !repository.listVersions || !repository.findCurrentDraft || !repository.findLatestLivePlanVersion || !repository.softDelete) {
+        missing(t, "planVersionRetirement");
+        return;
+      }
+      const listVersions = repository.listVersions.bind(repository);
+      const findCurrentDraft = repository.findCurrentDraft.bind(repository);
+      const findLatestLive = repository.findLatestLivePlanVersion.bind(repository);
+      const entitlementVersions = harness.adapter.planVersionRepository;
+      const plan = await repository.create({ planKey: "RETIRING", label: "Retiring" });
+      const firstDraft = await repository.createPlanVersionDraft({
+        planId: "RETIRING",
+        features: ["CORE"],
+        quotas: { users: 5 },
+        monthlyNet: "10.00",
+        yearlyNet: "100.00",
+        validFrom: "2026-01-01"
+      });
+      const live = await repository.publishPlanVersionDraft(firstDraft.id, {
+        publishedByUserId: null,
+        publishedChanges: [],
+        nonRegressive: true,
+        validFrom: /* @__PURE__ */ new Date("2026-01-01T00:00:00.000Z"),
+        validUntil: null
+      });
+      const openDraft = await repository.createPlanVersionDraft({
+        planId: "RETIRING",
+        baseVersionId: live.id,
+        features: ["CORE", "PLUS"],
+        quotas: { users: 10 },
+        monthlyNet: "15.00",
+        yearlyNet: "150.00",
+        validFrom: "2026-06-01"
+      });
+      const reads = async () => ({
+        versions: (await listVersions("RETIRING")).map((row) => row.id),
+        draft: (await findCurrentDraft("RETIRING"))?.id ?? null,
+        latestLive: (await findLatestLive("RETIRING"))?.id ?? null,
+        entitlementFeatures: (await entitlementVersions.findLatestLive("RETIRING"))?.features ?? null
+      });
+      const beforeRetiring = await reads();
+      import_strict.default.deepEqual(
+        {
+          versions: beforeRetiring.versions,
+          draft: beforeRetiring.draft,
+          latestLive: beforeRetiring.latestLive
+        },
+        { versions: [live.id, openDraft.id], draft: openDraft.id, latestLive: live.id },
+        "a live plan reads its versions, so the comparison below has a subject"
+      );
+      await repository.softDelete(plan.id);
+      import_strict.default.deepEqual(await reads(), beforeRetiring, "retiring the plan hid its versions");
+    });
     (0, import_node_test.test)("a retired bundle still occupies its key", async (t) => {
       const catalog = harness.adapter.bundleRepository;
       const retire = catalog?.softDelete?.bind(catalog);
       const byKey = catalog?.findByKey?.bind(catalog);
       if (!catalog || !retire || !byKey) {
-        t.skip("adapter provides no BundleRepository");
+        missing(t, "bundleRetirement");
         return;
       }
       const bundle = await catalog.create({
@@ -747,7 +960,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("countByPlanVersionId counts current AND pending bindings in one query", async (t) => {
       const { seed, adapter } = harness;
       if (!adapter.subscriptionRepository.countByPlanVersionId) {
-        t.skip("adapter does not implement countByPlanVersionId (fail-closed fallback)");
+        missing(t, "countByPlanVersionId");
         return;
       }
       const v1 = await seed.createPlanVersion({
@@ -787,9 +1000,7 @@ function persistenceAdapterContract(options) {
         return;
       }
       if (!adapter.promoCodeRedemptionRepository) {
-        t.skip(
-          "adapter provides no PromoCodeRedemptionRepository (needed as tx write probe)"
-        );
+        missing(t, "promoCodeRedemptions");
         return;
       }
       const redemptions = adapter.promoCodeRedemptionRepository;
@@ -872,7 +1083,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("concurrent claimSlot grants exactly maxRedemptions slots", async (t) => {
       const { seed, adapter } = harness;
       if (!adapter.promoCodeRepository) {
-        t.skip("adapter provides no PromoCodeRepository");
+        missing(t, "promoCodes");
         return;
       }
       const promoCodes = adapter.promoCodeRepository;
@@ -893,7 +1104,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("claimSlot / markExhaustedIfFull / releaseSlot lifecycle", async (t) => {
       const { seed, adapter } = harness;
       if (!adapter.promoCodeRepository) {
-        t.skip("adapter provides no PromoCodeRepository");
+        missing(t, "promoCodes");
         return;
       }
       const promoCodes = adapter.promoCodeRepository;
@@ -913,7 +1124,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("a subscription cannot redeem twice (unique guard)", async (t) => {
       const { seed, adapter } = harness;
       if (!adapter.promoCodeRedemptionRepository) {
-        t.skip("adapter provides no PromoCodeRedemptionRepository");
+        missing(t, "promoCodeRedemptions");
         return;
       }
       const redemptions = adapter.promoCodeRedemptionRepository;
@@ -953,7 +1164,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("audit write \u2192 query roundtrip with actorTag filters", async (t) => {
       const { adapter } = harness;
       if (!adapter.audit || !adapter.auditQuery) {
-        t.skip("adapter provides no AuditPort/AuditQueryPort pair");
+        missing(t, "audit");
         return;
       }
       await adapter.audit.write({
@@ -993,7 +1204,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("MFA secret roundtrip", async (t) => {
       const { adapter } = harness;
       if (!adapter.mfa) {
-        t.skip("adapter provides no MfaPort");
+        missing(t, "mfa");
         return;
       }
       import_strict.default.equal(await adapter.mfa.getSecret("admin-1"), null);
@@ -1008,7 +1219,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("finds the subscription the id names, not merely a subscription", async (t) => {
       const { adapter, seed } = harness;
       if (!adapter.promoSubscriptionLookup) {
-        t.skip("adapter provides no PromoSubscriptionLookup");
+        missing(t, "promoSubscriptionLookup");
         return;
       }
       const { planVersionId } = await seed.createPlanVersion({
@@ -1037,7 +1248,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("returns null for an id that does not exist", async (t) => {
       const { adapter, seed } = harness;
       if (!adapter.promoSubscriptionLookup) {
-        t.skip("adapter provides no PromoSubscriptionLookup");
+        missing(t, "promoSubscriptionLookup");
         return;
       }
       const { planVersionId } = await seed.createPlanVersion({
@@ -1058,7 +1269,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("carries the fields a promo rule reads: cycle and start date", async (t) => {
       const { adapter, seed } = harness;
       if (!adapter.promoSubscriptionLookup) {
-        t.skip("adapter provides no PromoSubscriptionLookup");
+        missing(t, "promoSubscriptionLookup");
         return;
       }
       const { planVersionId } = await seed.createPlanVersion({
@@ -1093,7 +1304,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("reads inside a transaction, so validation and redemption agree", async (t) => {
       const { adapter, seed } = harness;
       if (!adapter.promoSubscriptionLookup) {
-        t.skip("adapter provides no PromoSubscriptionLookup");
+        missing(t, "promoSubscriptionLookup");
         return;
       }
       const { planVersionId } = await seed.createPlanVersion({
@@ -1117,7 +1328,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("a contract keeps what was agreed, and ending it does not rewrite it", async (t) => {
       const contracts = harness.adapter.subscriptionContractRepository;
       if (!contracts) {
-        t.skip("adapter provides no SubscriptionContractRepository");
+        missing(t, "subscriptionContracts");
         return;
       }
       const tenantId = "tenant-contract-lifecycle";
@@ -1273,7 +1484,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("a successor takes over without erasing the contract it replaces", async (t) => {
       const contracts = harness.adapter.subscriptionContractRepository;
       if (!contracts) {
-        t.skip("adapter provides no SubscriptionContractRepository");
+        missing(t, "subscriptionContracts");
         return;
       }
       const tenantId = "tenant-contract-succession";
@@ -1375,7 +1586,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("a line keeps the currency and the tax it was booked with", async (t) => {
       const contracts = harness.adapter.subscriptionContractRepository;
       if (!contracts) {
-        t.skip("adapter provides no SubscriptionContractRepository");
+        missing(t, "subscriptionContracts");
         return;
       }
       const tenantId = "tenant-contract-money-facts";
@@ -1473,7 +1684,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("no record before the first boot that could write one", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       import_strict.default.equal(await port.readApplied(), null);
@@ -1482,7 +1693,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("the record comes back as it was written \u2014 values, source and moment", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       import_strict.default.equal(await port.writeApplied(applied("sha256-a", FIRST_START), null), true);
@@ -1496,7 +1707,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("writing again replaces the one row rather than adding a second", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       await port.writeApplied(applied("sha256-a", FIRST_START), null);
@@ -1512,7 +1723,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("the first record is written once: a second writer that read none is refused", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       import_strict.default.equal(await port.writeApplied(applied("sha256-a", FIRST_START), null), true);
@@ -1522,7 +1733,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("a write guarded on a fingerprint the row no longer carries is refused", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       await port.writeApplied(applied("sha256-a", FIRST_START), null);
@@ -1545,7 +1756,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("a change lands with the record it supersedes, and is listed newest first", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       await port.writeApplied(applied("sha256-a", FIRST_START), null);
@@ -1583,7 +1794,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("a change whose record has moved on is refused whole: no change, and the record as it was", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       await port.writeApplied(applied("sha256-a", FIRST_START), null);
@@ -1601,7 +1812,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("starts noticing the same difference at once record it once", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       await port.writeApplied(applied("sha256-a", FIRST_START), null);
@@ -1625,7 +1836,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("several first starts write the record once", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       const written = await Promise.all(
@@ -1637,7 +1848,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("changes are listed in the order they were recorded, latest first \u2014 not by the moment they carry", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       await port.writeApplied(applied("sha256-0", FIRST_START, {}), null);
@@ -1669,7 +1880,7 @@ function persistenceAdapterContract(options) {
     (0, import_node_test.test)("acknowledging a change is recorded once, and filters it out of what is owed", async (t) => {
       const port = harness.adapter.appliedSettings;
       if (!port) {
-        t.skip("adapter provides no AppliedSettingsPort");
+        missing(t, "appliedSettings");
         return;
       }
       await port.writeApplied(applied("sha256-a", FIRST_START), null);