@cosmicdrift/kumiko-framework 0.1.0 → 0.2.0

package/src/files/__tests__/files.integration.ts

@@ -15,12 +15,12 @@ import {
 } from "../../engine";
 import { createEventsTable, loadAggregate } from "../../event-store";
 import {
-  createEntityTable,
   createTestDb,
   createTestUser,
-  pushTables,
   type TestDb,
   TestUsers,
+  unsafeCreateEntityTable,
+  unsafePushTables,
 } from "../../stack";
 import { expectErrorIncludes } from "../../testing";
 import { fileRefsTable } from "../file-ref-table";
@@ -64,8 +64,8 @@ beforeAll(async () => {
   storagePath = await mkdtemp(join(tmpdir(), "kumiko-files-test-"));
 
   // Create tables
-  await pushTables(testDb.db, { fileRefsTable });
-  await createEntityTable(testDb.db, testTenantEntity);
+  await unsafePushTables(testDb.db, { fileRefsTable });
+  await unsafeCreateEntityTable(testDb.db, testTenantEntity);
   // Event-store table: the upload route appends files:event:uploaded in the
   // same tx as the FileRef insert. Without events, upload would 500.
   await createEventsTable(testDb.db);
@@ -402,8 +402,8 @@ describe("custom file access guard", () => {
   ): Promise<void> {
     const { storageProvider: providerOverride, ...routeOptions } = options;
     const isolatedDb = await createTestDb();
-    await pushTables(isolatedDb.db, { fileRefsTable });
-    await createEntityTable(isolatedDb.db, testTenantEntity);
+    await unsafePushTables(isolatedDb.db, { fileRefsTable });
+    await unsafeCreateEntityTable(isolatedDb.db, testTenantEntity);
     const storagePath = await mkdtemp(join(tmpdir(), "kumiko-files-custom-"));
     const provider = providerOverride ?? createLocalProvider(storagePath);
     const isolatedRegistry = createRegistry([tenantFeature]);
@@ -716,8 +716,8 @@ describe("download-url endpoint", () => {
     }) => Promise<void>,
   ): Promise<void> {
     const isolatedDb = await createTestDb();
-    await pushTables(isolatedDb.db, { fileRefsTable });
-    await createEntityTable(isolatedDb.db, testTenantEntity);
+    await unsafePushTables(isolatedDb.db, { fileRefsTable });
+    await unsafeCreateEntityTable(isolatedDb.db, testTenantEntity);
     const isolatedRegistry = createRegistry([tenantFeature]);
     const isolatedServer = buildServer({
       registry: isolatedRegistry,

package/src/observability/__tests__/observability.integration.ts

@@ -6,11 +6,11 @@ import type { AppContext, SaveContext } from "../../engine/types";
 import { createJobRunner } from "../../jobs";
 import { createLogger } from "../../logging/pino-logger";
 import {
-  createEntityTable,
   createTestRedis,
   setupTestStack,
   type TestRedis,
   type TestStack,
+  unsafeCreateEntityTable,
 } from "../../stack";
 import { createRecordingProvider, type RecordingProvider, waitFor } from "../../testing";
 
@@ -194,7 +194,7 @@ describe("Observability (integration) — DB + pipeline hook spans", () => {
       observability: provider,
       systemHooks: [],
     });
-    await createEntityTable(stack.db, todoEntity, "todo");
+    await unsafeCreateEntityTable(stack.db, todoEntity, "todo");
   });
 
   afterEach(async () => {

package/src/pipeline/__tests__/archive-stream.integration.ts

@@ -16,11 +16,11 @@ import {
   loadAggregate as loadAggregateRaw,
 } from "../../event-store";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 
 const itemEntity = createEntity({
@@ -103,7 +103,7 @@ const admin = TestUsers.admin;
 
 beforeAll(async () => {
   stack = await setupTestStack({ features: [archFeature], systemHooks: [] });
-  await createEntityTable(stack.db, itemEntity, "arch-item");
+  await unsafeCreateEntityTable(stack.db, itemEntity, "arch-item");
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/cascade-handler.integration.ts

@@ -11,7 +11,7 @@ import {
   type Registry,
 } from "../../engine";
 import { createEventsTable } from "../../event-store";
-import { createEntityTable, createTestDb, type TestDb, TestUsers } from "../../stack";
+import { createTestDb, type TestDb, TestUsers, unsafeCreateEntityTable } from "../../stack";
 import { createCascadeDeleteHook } from "../cascade-handler";
 
 // biome-ignore lint/suspicious/noExplicitAny: Drizzle dynamic tables
@@ -81,14 +81,14 @@ beforeAll(async () => {
   await createEventsTable(testDb.db);
   tdb = createTenantDb(testDb.db, admin.tenantId);
 
-  await createEntityTable(testDb.db, departmentEntity);
-  await createEntityTable(testDb.db, userEntity);
-  await createEntityTable(testDb.db, sessionEntity);
-  await createEntityTable(testDb.db, groupEntity);
-  await createEntityTable(testDb.db, userGroupRestrictEntity);
-  await createEntityTable(testDb.db, userGroupCascadeEntity);
-  await createEntityTable(testDb.db, teamEntity);
-  await createEntityTable(testDb.db, memberEntity);
+  await unsafeCreateEntityTable(testDb.db, departmentEntity);
+  await unsafeCreateEntityTable(testDb.db, userEntity);
+  await unsafeCreateEntityTable(testDb.db, sessionEntity);
+  await unsafeCreateEntityTable(testDb.db, groupEntity);
+  await unsafeCreateEntityTable(testDb.db, userGroupRestrictEntity);
+  await unsafeCreateEntityTable(testDb.db, userGroupCascadeEntity);
+  await unsafeCreateEntityTable(testDb.db, teamEntity);
+  await unsafeCreateEntityTable(testDb.db, memberEntity);
 
   departmentTable = buildDrizzleTable("department", departmentEntity);
   userTable = buildDrizzleTable("user", userEntity);

package/src/pipeline/__tests__/causation-chain.integration.ts

@@ -23,11 +23,11 @@ import { buildDrizzleTable } from "../../db/table-builder";
 import { createEntity, createTextField, defineFeature } from "../../engine";
 import { eventsTable } from "../../event-store";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 
 // --- Feature ---
@@ -104,7 +104,7 @@ beforeAll(async () => {
     features: [causationFeature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, orderEntity, "causation-order");
+  await unsafeCreateEntityTable(stack.db, orderEntity, "causation-order");
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/ctx-bridge.integration.ts

@@ -11,7 +11,7 @@ import {
   defineFeature,
 } from "../../engine";
 import { UnprocessableError, writeFailure } from "../../errors";
-import { createEntityTable, setupTestStack, type TestStack, TestUsers } from "../../stack";
+import { setupTestStack, type TestStack, TestUsers, unsafeCreateEntityTable } from "../../stack";
 
 // Two entities: `bag` (outer) + `secret` (inner). The outer handler calls
 // the inner via ctx.queryAs / ctx.writeAs. We verify:
@@ -144,8 +144,8 @@ const bridgeFeature = defineFeature("ctxbridge", (r) => {
 
 beforeAll(async () => {
   stack = await setupTestStack({ features: [bridgeFeature] });
-  await createEntityTable(stack.db, bagEntity);
-  await createEntityTable(stack.db, secretEntity);
+  await unsafeCreateEntityTable(stack.db, bagEntity);
+  await unsafeCreateEntityTable(stack.db, secretEntity);
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/domain-events-projections.integration.ts

@@ -24,11 +24,11 @@ import { buildDrizzleTable } from "../../db/table-builder";
 import { createEntity, createTextField, defineFeature } from "../../engine";
 import { loadAggregate } from "../../event-store";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 
 // --- Entity ---
@@ -175,7 +175,7 @@ beforeAll(async () => {
     features: [shippingFeature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, shipmentEntity, "domain-shipment");
+  await unsafeCreateEntityTable(stack.db, shipmentEntity, "domain-shipment");
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/event-dedup.integration.ts

@@ -3,12 +3,12 @@ import { z } from "zod";
 import { createEventStoreExecutor } from "../../db/event-store-executor";
 import { defineFeature, type SaveContext } from "../../engine";
 import {
-  createEntityTable,
   createTestRedis,
   setupTestStack,
   type TestRedis,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 import { sharedItemEntity, sharedItemTable } from "../../testing";
 import { createEventDedup } from "../event-dedup";
@@ -71,7 +71,7 @@ beforeAll(async () => {
     systemHooks: [],
   });
 
-  await createEntityTable(stack.db, sharedItemEntity, "item");
+  await unsafeCreateEntityTable(stack.db, sharedItemEntity, "item");
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/event-define-event-strict.integration.ts

@@ -17,11 +17,11 @@ import { z } from "zod";
 import { defineFeature } from "../../engine";
 import { eventsTable } from "../../event-store";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 import { sharedWidgetEntity } from "../../testing";
 import { generateId } from "../../utils";
@@ -120,7 +120,7 @@ beforeAll(async () => {
     features: [emitterFeature, neighborFeature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, sharedWidgetEntity, "widget");
+  await unsafeCreateEntityTable(stack.db, sharedWidgetEntity, "widget");
 });
 
 afterEach(async () => {

package/src/pipeline/__tests__/event-dispatcher-lifecycle.integration.ts

@@ -25,11 +25,11 @@ import {
   RecordingTracer,
 } from "../../observability";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 import { sharedWidgetEntity, sharedWidgetTable } from "../../testing";
 
@@ -85,7 +85,7 @@ beforeAll(async () => {
     features: [wiringFeature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, sharedWidgetEntity, "widget");
+  await unsafeCreateEntityTable(stack.db, sharedWidgetEntity, "widget");
   tdb = createTenantDb(stack.db, admin.tenantId);
 });
 
@@ -181,7 +181,7 @@ describe("E.1 — consumer-lag metric", () => {
       observability: recordingProvider,
     });
     try {
-      await createEntityTable(recStack.db, sharedWidgetEntity, "widget");
+      await unsafeCreateEntityTable(recStack.db, sharedWidgetEntity, "widget");
       const recTdb = createTenantDb(recStack.db, admin.tenantId);
       await executor.create({ name: "lag-check" }, admin, recTdb);
 

package/src/pipeline/__tests__/event-dispatcher-multi-instance.integration.ts

@@ -30,11 +30,11 @@ import {
   getConsumerState,
 } from "../../pipeline";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 import { sharedWidgetEntity, sharedWidgetTable } from "../../testing";
 import { generateId } from "../../utils";
@@ -63,7 +63,7 @@ beforeAll(async () => {
     features: [multiFeature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, sharedWidgetEntity, "widget");
+  await unsafeCreateEntityTable(stack.db, sharedWidgetEntity, "widget");
   tdb = createTenantDb(stack.db, admin.tenantId);
 });
 

package/src/pipeline/__tests__/event-dispatcher-pg-listen.integration.ts

@@ -15,7 +15,7 @@ import { afterAll, beforeAll, describe, expect, test } from "vitest";
 import { createEventStoreExecutor } from "../../db/event-store-executor";
 import { createTenantDb, type TenantDb } from "../../db/tenant-db";
 import { defineFeature } from "../../engine";
-import { createEntityTable, setupTestStack, type TestStack, TestUsers } from "../../stack";
+import { setupTestStack, type TestStack, TestUsers, unsafeCreateEntityTable } from "../../stack";
 import { sharedWidgetEntity, sharedWidgetTable } from "../../testing";
 
 // --- Fixture ---
@@ -48,7 +48,7 @@ beforeAll(async () => {
     features: [listenFeature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, sharedWidgetEntity, "widget");
+  await unsafeCreateEntityTable(stack.db, sharedWidgetEntity, "widget");
   tdb = createTenantDb(stack.db, admin.tenantId);
 });
 

package/src/pipeline/__tests__/event-dispatcher-recovery.integration.ts

@@ -26,11 +26,11 @@ import {
   skipPoisonEvent,
 } from "../../pipeline";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 import { sharedWidgetEntity, sharedWidgetTable } from "../../testing";
 
@@ -71,7 +71,7 @@ beforeAll(async () => {
     features: [recoveryFeature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, sharedWidgetEntity, "widget");
+  await unsafeCreateEntityTable(stack.db, sharedWidgetEntity, "widget");
   tdb = createTenantDb(stack.db, admin.tenantId);
 });
 

package/src/pipeline/__tests__/event-dispatcher-second-audit.integration.ts

@@ -27,11 +27,11 @@ import {
 } from "../../observability";
 import { ConsumerLagError, eventConsumerStateTable, pruneEvents } from "../../pipeline";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 import { sharedWidgetEntity } from "../../testing";
 import { generateId } from "../../utils";
@@ -62,7 +62,7 @@ beforeAll(async () => {
     features: [auditFeature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, sharedWidgetEntity, "widget");
+  await unsafeCreateEntityTable(stack.db, sharedWidgetEntity, "widget");
 });
 
 afterEach(async () => {
@@ -179,7 +179,7 @@ describe("Second audit — LISTEN gauge", () => {
       observability: recordingProvider,
     });
     try {
-      await createEntityTable(recStack.db, sharedWidgetEntity, "widget");
+      await unsafeCreateEntityTable(recStack.db, sharedWidgetEntity, "widget");
 
       await recStack.eventDispatcher?.start();
       try {
@@ -233,7 +233,7 @@ describe("Second audit — LISTEN gauge", () => {
       observability: recordingProvider,
     });
     try {
-      await createEntityTable(recStack.db, sharedWidgetEntity, "widget");
+      await unsafeCreateEntityTable(recStack.db, sharedWidgetEntity, "widget");
 
       await recStack.eventDispatcher?.start();
       try {

package/src/pipeline/__tests__/event-dispatcher.integration.ts

@@ -26,12 +26,12 @@ import { defineFeature, type FeatureDefinition } from "../../engine";
 import type { StoredEvent } from "../../event-store";
 import { eventConsumerStateTable, getAllConsumerProgress, getConsumerState } from "../../pipeline";
 import {
-  createEntityTable,
-  pushTables,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
+  unsafePushTables,
 } from "../../stack";
 import { sharedWidgetEntity, sharedWidgetTable } from "../../testing";
 
@@ -98,8 +98,8 @@ beforeAll(async () => {
     // hook chain. SSE / search are irrelevant to cursor behaviour.
     systemHooks: [],
   });
-  await createEntityTable(stack.db, sharedWidgetEntity, "widget");
-  await pushTables(stack.db, { subscriberLog: subscriberLogTable });
+  await unsafeCreateEntityTable(stack.db, sharedWidgetEntity, "widget");
+  await unsafePushTables(stack.db, { subscriberLog: subscriberLogTable });
   tdb = createTenantDb(stack.db, admin.tenantId);
 });
 

package/src/pipeline/__tests__/event-retention.integration.ts

@@ -23,11 +23,11 @@ import {
   pruneEvents,
 } from "../../pipeline";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 import { sharedWidgetEntity, sharedWidgetTable } from "../../testing";
 import { generateId } from "../../utils";
@@ -61,7 +61,7 @@ beforeAll(async () => {
     features: [retentionFeature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, sharedWidgetEntity, "widget");
+  await unsafeCreateEntityTable(stack.db, sharedWidgetEntity, "widget");
   tdb = createTenantDb(stack.db, admin.tenantId);
 });
 

package/src/pipeline/__tests__/fetch-for-writing.integration.ts

@@ -15,7 +15,7 @@ import { buildDrizzleTable } from "../../db/table-builder";
 import { createEntity, createTextField, defineFeature } from "../../engine";
 import { UnprocessableError, writeFailure } from "../../errors";
 import { loadAggregate } from "../../event-store";
-import { createEntityTable, setupTestStack, type TestStack, TestUsers } from "../../stack";
+import { setupTestStack, type TestStack, TestUsers, unsafeCreateEntityTable } from "../../stack";
 
 // --- Feature ---
 
@@ -136,7 +136,7 @@ const admin = TestUsers.admin;
 
 beforeAll(async () => {
   stack = await setupTestStack({ features: [cartFeature], systemHooks: [] });
-  await createEntityTable(stack.db, cartEntity, "f4wCart");
+  await unsafeCreateEntityTable(stack.db, cartEntity, "f4wCart");
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/load-aggregate-query.integration.ts

@@ -13,11 +13,11 @@ import { buildDrizzleTable } from "../../db/table-builder";
 import { createEntity, createTextField, defineFeature } from "../../engine";
 import { append, loadAggregate as loadAggregateRaw } from "../../event-store";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 
 // --- Fixture entity ---
@@ -131,7 +131,7 @@ const admin = TestUsers.admin;
 
 beforeAll(async () => {
   stack = await setupTestStack({ features: [asOfFeature], systemHooks: [] });
-  await createEntityTable(stack.db, invoiceEntity, "asof-invoice");
+  await unsafeCreateEntityTable(stack.db, invoiceEntity, "asof-invoice");
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/msp-error-mode.integration.ts

@@ -15,11 +15,11 @@ import { createTenantDb, type TenantDb } from "../../db/tenant-db";
 import { defineFeature } from "../../engine";
 import { getConsumerState } from "../../pipeline";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 import { sharedWidgetEntity, sharedWidgetTable } from "../../testing";
 
@@ -80,7 +80,7 @@ beforeAll(async () => {
     features: [z2Feature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, sharedWidgetEntity, "widget");
+  await unsafeCreateEntityTable(stack.db, sharedWidgetEntity, "widget");
   tdb = createTenantDb(stack.db, admin.tenantId);
 });
 

package/src/pipeline/__tests__/msp-multi-hop.integration.ts

@@ -17,11 +17,11 @@ import { buildDrizzleTable } from "../../db/table-builder";
 import { createEntity, createTextField, defineFeature } from "../../engine";
 import { eventsTable } from "../../event-store";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 
 // --- Feature ---
@@ -109,7 +109,7 @@ const admin = TestUsers.admin;
 
 beforeAll(async () => {
   stack = await setupTestStack({ features: [mmhFeature], systemHooks: [] });
-  await createEntityTable(stack.db, orderEntity, "mmh-order");
+  await unsafeCreateEntityTable(stack.db, orderEntity, "mmh-order");
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/msp-rebuild.integration.ts

@@ -28,11 +28,11 @@ import {
   rebuildMultiStreamProjection,
 } from "../../pipeline";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 
 // --- Fixtures: two aggregates feeding one MSP + two cornered MSPs ---
@@ -211,8 +211,8 @@ beforeAll(async () => {
     features: [feature],
     systemHooks: [],
   });
-  await createEntityTable(stack.db, invoiceEntity, "msp-reb-invoice");
-  await createEntityTable(stack.db, paymentEntity, "msp-reb-payment");
+  await unsafeCreateEntityTable(stack.db, invoiceEntity, "msp-reb-invoice");
+  await unsafeCreateEntityTable(stack.db, paymentEntity, "msp-reb-payment");
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/multi-stream-projection.integration.ts

@@ -14,12 +14,12 @@ import { createEventStoreExecutor } from "../../db/event-store-executor";
 import { buildDrizzleTable } from "../../db/table-builder";
 import { createEntity, createTextField, defineFeature } from "../../engine";
 import {
-  createEntityTable,
   createTestUser,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 
 // --- Two aggregate types that feed one MSP ---
@@ -162,8 +162,8 @@ const admin = TestUsers.admin;
 
 beforeAll(async () => {
   stack = await setupTestStack({ features: [mspFeature], systemHooks: [] });
-  await createEntityTable(stack.db, shipmentEntity, "msp-shipment");
-  await createEntityTable(stack.db, refundEntity, "msp-refund");
+  await unsafeCreateEntityTable(stack.db, shipmentEntity, "msp-shipment");
+  await unsafeCreateEntityTable(stack.db, refundEntity, "msp-refund");
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/perf-rebuild.integration.ts

@@ -24,7 +24,7 @@ import { createEntity, createRegistry, createTextField, defineFeature } from "..
 import type { ProjectionDefinition } from "../../engine/types";
 import { createEventsTable } from "../../event-store";
 import { createProjectionStateTable, rebuildProjection } from "../../pipeline";
-import { createTestDb, pushTables, type TestDb, TestUsers } from "../../stack";
+import { createTestDb, type TestDb, TestUsers, unsafePushTables } from "../../stack";
 import { generateId as uuid } from "../../utils";
 
 // Counter projection: every task.created bumps a counter, every
@@ -77,7 +77,7 @@ beforeAll(async () => {
   testDb = await createTestDb();
   await createEventsTable(testDb.db);
   await createProjectionStateTable(testDb.db);
-  await pushTables(testDb.db, { perf_rebuild_task_count: taskCountTable });
+  await unsafePushTables(testDb.db, { perf_rebuild_task_count: taskCountTable });
 });
 
 afterAll(async () => {

package/src/pipeline/__tests__/projection-rebuild.integration.ts

@@ -36,7 +36,13 @@ import {
   listProjectionsWithState,
   rebuildProjection,
 } from "../../pipeline";
-import { createEntityTable, createTestDb, pushTables, type TestDb, TestUsers } from "../../stack";
+import {
+  createTestDb,
+  type TestDb,
+  TestUsers,
+  unsafeCreateEntityTable,
+  unsafePushTables,
+} from "../../stack";
 
 // --- Test fixtures ---
 
@@ -103,10 +109,10 @@ const executor = createEventStoreExecutor(itemTable, itemEntity, { entityName: "
 
 beforeAll(async () => {
   testDb = await createTestDb();
-  await createEntityTable(testDb.db, itemEntity, "rebuild-item");
+  await unsafeCreateEntityTable(testDb.db, itemEntity, "rebuild-item");
   await createEventsTable(testDb.db);
   await createProjectionStateTable(testDb.db);
-  await pushTables(testDb.db, { rebuildItemsPerGroup: itemsPerGroupTable });
+  await unsafePushTables(testDb.db, { rebuildItemsPerGroup: itemsPerGroupTable });
   tdb = createTenantDb(testDb.db, admin.tenantId);
 });
 

package/src/pipeline/__tests__/query-projection.integration.ts

@@ -15,11 +15,11 @@ import { createEventStoreExecutor } from "../../db/event-store-executor";
 import { buildDrizzleTable } from "../../db/table-builder";
 import { createEntity, createTextField, defineFeature } from "../../engine";
 import {
-  createEntityTable,
   resetEventStore,
   setupTestStack,
   type TestStack,
   TestUsers,
+  unsafeCreateEntityTable,
 } from "../../stack";
 
 const widgetEntity = createEntity({
@@ -121,7 +121,7 @@ const otherTenantAdmin = {
 
 beforeAll(async () => {
   stack = await setupTestStack({ features: [qpFeature], systemHooks: [] });
-  await createEntityTable(stack.db, widgetEntity, "qp-widget");
+  await unsafeCreateEntityTable(stack.db, widgetEntity, "qp-widget");
 });
 
 afterAll(async () => {

package/src/pipeline/event-consumer-state.ts

@@ -2,7 +2,7 @@ import { sql } from "drizzle-orm";
 import type { DbConnection } from "../db/connection";
 import { bigint, index, instant, integer, table as pgTable, primaryKey, text } from "../db/dialect";
 import { tableExists } from "../db/schema-inspection";
-import { pushTables } from "../stack";
+import { unsafePushTables } from "../stack";
 
 // Reserved sentinel used in the instance_id column for consumers whose
 // delivery is "shared" — i.e. one cursor across all dispatcher instances
@@ -104,5 +104,5 @@ export const CONSUMER_STATUSES = [
 export async function createEventConsumerStateTable(db: DbConnection): Promise<void> {
   // skip: table already exists — bootstrap is called from multiple paths
   if (await tableExists(db, "public.kumiko_event_consumers")) return;
-  await pushTables(db, { kumikoEventConsumers: eventConsumerStateTable });
+  await unsafePushTables(db, { kumikoEventConsumers: eventConsumerStateTable });
 }