@cosmicdrift/kumiko-testing 0.379.0 → 0.380.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-testing",
-  "version": "0.379.0",
+  "version": "0.380.0",
   "description": "Test template for Kumiko apps: per-flow seedTenant, app test stack, canonical test preloads, bunfig generator and integration runner.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -99,9 +99,9 @@
     "kumiko-testing": "./bin/kumiko-testing.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.379.0",
-    "@cosmicdrift/kumiko-guards": "0.379.0",
-    "@cosmicdrift/kumiko-types": "0.379.0",
+    "@cosmicdrift/kumiko-framework": "0.380.0",
+    "@cosmicdrift/kumiko-guards": "0.380.0",
+    "@cosmicdrift/kumiko-types": "0.380.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
@@ -125,8 +125,8 @@
     }
   },
   "devDependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.379.0",
-    "@cosmicdrift/kumiko-dev-server": "0.379.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.380.0",
+    "@cosmicdrift/kumiko-dev-server": "0.380.0",
     "@happy-dom/global-registrator": "^20.11.2",
     "@playwright/test": "^1.62.1",
     "@testing-library/dom": "^10.4.1",

package/src/helpers/db-cleanup.ts

@@ -1,5 +1,5 @@
 import type { EntityTableMeta } from "@cosmicdrift/kumiko-framework/db";
-import { deleteMany } from "@cosmicdrift/kumiko-framework/db";
+import { deleteMany, requireEntityTableMeta } from "@cosmicdrift/kumiko-framework/db";
 import type { AnyDb } from "@cosmicdrift/kumiko-framework/internal/stack-support";
 import { withExecutorManagedWritesForTests } from "@cosmicdrift/kumiko-framework/internal/testing";
 
@@ -13,30 +13,16 @@ function tableFromName(name: string): EntityTableMeta {
   return { tableName: name, columns: [], indexes: [], source: "unmanaged" };
 }
 
-function resolveClearableTable(table: ClearableTable): unknown {
+function resolveClearableTable(table: ClearableTable): EntityTableMeta {
   if (typeof table === "string") return tableFromName(table);
-  if (
-    typeof table === "object" &&
-    table !== null &&
-    "tableName" in table &&
-    typeof table.tableName === "string"
-  ) {
-    return table;
-  }
-  return table;
+  return requireEntityTableMeta(table, "clearTables");
 }
 
 /** Delete all rows from each table (order preserved — FK-sensitive callers order explicitly). */
 export async function clearTables(db: AnyDb, tables: readonly ClearableTable[]): Promise<void> {
   for (const table of tables) {
-    // Test-teardown truncate: resolveClearableTable returns `unknown` (string
-    // name or table object). The brand-strip cast is the sanctioned bypass —
-    // clearing a managed projection between tests is not a production write.
-    await deleteMany(
-      withExecutorManagedWritesForTests(db),
-      resolveClearableTable(table) as EntityTableMeta,
-      {},
-    );
+    // Test teardown: clearing a managed projection between tests is not a production write.
+    await deleteMany(withExecutorManagedWritesForTests(db), resolveClearableTable(table), {});
   }
 }
 

package/src/helpers/seed.ts

@@ -1,11 +1,10 @@
 // Test-only ES-bypass: seed / mutate a managed projection directly, skipping
-// the event log. Production code CANNOT do this — the write helpers reject a
-// branded EntityTable at compile time (#742). Tests seed read-model state to
-// arrange a scenario without driving the full event path; a projection rebuild
-// is not part of the test lifecycle, so eventless writes are safe here. The
-// `as EntityTableMeta` strips the executor-only brand at this single sanctioned
-// seam — the signatures mirror the query helpers so a call-site migration is a
-// plain identifier rename.
+// the event log. Production code cannot do this: the write helpers only accept
+// a runner carrying the executor capability or a Writable table. Tests seed
+// read-model state to arrange a scenario without driving the full event path;
+// a projection rebuild is not part of the test lifecycle, so eventless writes
+// are safe here. The signatures mirror the query helpers so a call-site
+// migration is a plain identifier rename.
 
 import type { EntityTable, EntityTableMeta } from "@cosmicdrift/kumiko-framework/db";
 import {
@@ -25,7 +24,7 @@ export function seedRow<TRow = unknown>(
   table: SeedTable,
   values: Record<string, unknown>,
 ): Promise<TRow | undefined> {
-  return insertOne<TRow>(withExecutorManagedWritesForTests(db), table as EntityTableMeta, values);
+  return insertOne<TRow>(withExecutorManagedWritesForTests(db), table, values);
 }
 
 export function seedRows<TRow = unknown>(
@@ -33,7 +32,7 @@ export function seedRows<TRow = unknown>(
   table: SeedTable,
   rows: ReadonlyArray<Record<string, unknown>>,
 ): Promise<readonly TRow[]> {
-  return insertMany<TRow>(withExecutorManagedWritesForTests(db), table as EntityTableMeta, rows);
+  return insertMany<TRow>(withExecutorManagedWritesForTests(db), table, rows);
 }
 
 export function updateRows<TRow = unknown>(
@@ -42,14 +41,9 @@ export function updateRows<TRow = unknown>(
   set: Record<string, unknown>,
   where: WhereObject,
 ): Promise<readonly TRow[]> {
-  return updateMany<TRow>(
-    withExecutorManagedWritesForTests(db),
-    table as EntityTableMeta,
-    set,
-    where,
-  );
+  return updateMany<TRow>(withExecutorManagedWritesForTests(db), table, set, where);
 }
 
 export function deleteRows(db: AnyDb, table: SeedTable, where: WhereObject): Promise<number> {
-  return deleteMany(withExecutorManagedWritesForTests(db), table as EntityTableMeta, where);
+  return deleteMany(withExecutorManagedWritesForTests(db), table, where);
 }