@afora/core 0.0.8 → 0.0.11

package/dist/testing/memory-publisher.js

@@ -0,0 +1,12 @@
+export function memoryPublisher() {
+  const published = [];
+  return {
+    published,
+    publish(topic, event) {
+      published.push({ topic, event });
+    },
+    clear() {
+      published.length = 0;
+    }
+  };
+}

package/dist/testing/provider-contract.d.ts

@@ -1,4 +1,4 @@
-import { type IRepositoryProvider } from "../index.js";
+import { type IRepositoryProvider } from "../adapters.js";
 /** The parts of a test runner the kit uses; `bun:test`, vitest and jest fit. */
 export interface ContractRunner {
     describe(name: string, body: () => void): void;
@@ -8,6 +8,11 @@ export interface ContractRunner {
         toEqual(expected: unknown): unknown;
     };
 }
+/**
+ * What {@link providerContract} takes: which optional groups of cases to run,
+ * each defaulting to what the provider advertises in `capabilities`, except the
+ * schema evolution ones.
+ */
 export interface ProviderContractOptions {
     /**
      * Run the transaction cases. Defaults to `provider.capabilities?.transactions`.
@@ -32,6 +37,26 @@ export interface ProviderContractOptions {
     readonly atomic?: boolean;
     /** Run the cases of expired records. Defaults to `provider.capabilities?.expiry`. */
     readonly expiry?: boolean;
+    /**
+     * Run the cases of schema evolution, through repositories and
+     * `app.migrate` over the basic methods: an old row read back upgraded,
+     * the backfill in check and apply, rows moved from a previous name.
+     * Their entities are named `Accounts` (and `One`, the
+     * previous name), with the keys of the other cases; `createdAt` and
+     * `updatedAt` are never written.
+     *
+     * @default true
+     */
+    readonly schemaEvolution?: boolean;
+    /**
+     * Run the schema evolution cases that store the version key
+     * (`SCHEMA_VERSION_KEY`, `"$v"`) in rows, for an entity declared with
+     * `schemaVersion`. A provider with a fixed set of columns needs one for
+     * it (or maps `context.schema.key` to its own).
+     *
+     * @default true
+     */
+    readonly schemaVersionKey?: boolean;
 }
 /**
  * Registers the behavior every `IRepositoryProvider` v2 must have. Pass the