@cosmicdrift/kumiko-dev-server 0.4.1 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @cosmicdrift/kumiko-dev-server
 
+## 0.5.0
+
+### Minor Changes
+
+- 7ff69ab: feat(es-ops): Phase 1 — file-based seed-migrations
+
+  Neues first-class Operations-Pattern fürs Framework. Liefert `seed-migrations`
+  als drizzle-migrate-equivalent für Event-Sourcing-Aggregate-Updates die
+  idempotent-Seeder nicht erfassen können (z.B. „Member hat schon eine
+  Rolle, aber jetzt soll noch eine dazukommen").
+
+  Public-API:
+
+  - `runProdApp({ seedsDir })` — Auto-apply pending Migrations beim Boot
+  - `SeedMigration`-Interface (default-Export einer `seeds/<id>.ts`-File)
+  - `SeedMigrationContext` mit `systemWriteAs` (ruft existing write-handler
+    als System-User) + Read-Helpers (`findUserByEmail`,
+    `findMembershipsOfUser`, `findTenants`)
+  - CLI: `bunx kumiko ops seed:new|status|apply`
+  - Tracking-Table `kumiko_es_operations` mit `operation_type`-Discriminator
+    (vorbereitet auf Phase 2+ Operations: projection-rebuild, event-replay,
+    stream-migration, ...)
+  - Env-Flags: `KUMIKO_SKIP_ES_OPS=1` (alle skippen für Recovery),
+    `KUMIKO_SKIP_ES_OPS_<ID>=1` (einzelne kaputte skippen)
+
+  Garantien: single-run via tracking, atomic via per-migration-Tx,
+  chronological order via filename-prefix, fail-stop bei Failure (kein
+  Partial-Apply), ES-konform via Handler-Dispatch.
+
+  Sub-path-Export: `@cosmicdrift/kumiko-framework/es-ops`
+
+  Plan-Doc: `kumiko-platform/docs/plans/features/es-ops.md`
+  Recipe: `samples/recipes/seed-migration/`
+  Driver-Use-Case: publicstatus admin-roles-drift (parallel-Branch
+  `feat/es-ops-driver-admin-roles`).
+
+  Phase 2+ skizziert + offen markiert — Implementation pro Use-Case.
+
+### Patch Changes
+
+- Updated dependencies [7ff69ab]
+  - @cosmicdrift/kumiko-framework@0.5.0
+  - @cosmicdrift/kumiko-bundled-features@0.5.0
+
 ## 0.4.1
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Development server bootstrap for Kumiko apps. Bundles the client, mints dev-JWTs, injects the resolved AppSchema, and seeds an admin. Not for production.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -48,8 +48,8 @@
     "kumiko-dev": "./bin/kumiko-dev.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.4.1",
-    "@cosmicdrift/kumiko-framework": "0.4.1"
+    "@cosmicdrift/kumiko-bundled-features": "0.5.0",
+    "@cosmicdrift/kumiko-framework": "0.5.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",

package/src/run-prod-app.ts

@@ -42,7 +42,7 @@ import { createSessionCallbacks } from "@cosmicdrift/kumiko-bundled-features/ses
 import { TenantQueries } from "@cosmicdrift/kumiko-bundled-features/tenant";
 import { UserQueries } from "@cosmicdrift/kumiko-bundled-features/user";
 import { createSseBroker, type SseBroker } from "@cosmicdrift/kumiko-framework/api";
-import { createDbConnection } from "@cosmicdrift/kumiko-framework/db";
+import { createDbConnection, type DbRunner } from "@cosmicdrift/kumiko-framework/db";
 import {
   buildAppSchema,
   createRegistry,
@@ -58,8 +58,14 @@ import {
   type ApiEntrypointOptions,
   createApiEntrypoint,
 } from "@cosmicdrift/kumiko-framework/entrypoint";
+import {
+  createEsOperationsTable,
+  createSeedMigrationContext,
+  runPendingSeedMigrations,
+} from "@cosmicdrift/kumiko-framework/es-ops";
 import { assertSchemaCurrent, SchemaDriftError } from "@cosmicdrift/kumiko-framework/migrations";
 import {
+  createDispatcher,
   createEntityCache,
   createEventDedup,
   createIdempotencyGuard,
@@ -275,6 +281,12 @@ export type RunProdAppOptions = {
   readonly auth?: RunProdAppAuthOptions;
   /** Custom seed functions, run after the admin seed (when auth-mode). */
   readonly seeds?: readonly ProdSeedFn[];
+  /** Pfad zum seeds-Directory für ES-Operations / Seed-Migrations
+   *  (file-basiert wie drizzle-migrate). Wenn gesetzt + KUMIKO_SKIP_ES_OPS
+   *  != "1": runProdApp scannt das Verzeichnis nach `<id>.ts` Files,
+   *  diff vs kumiko_es_operations-Table, läuft pending in Tx.
+   *  Plan: kumiko-platform/docs/plans/features/es-ops.md */
+  readonly seedsDir?: string;
   /** Anonymous-access for public endpoints (same shape as runDevApp).
    *  Akzeptiert entweder einen statischen Config-Object ODER eine
    *  Factory `({db, redis, registry}) => Config` — die Factory wird
@@ -603,6 +615,29 @@ export async function runProdApp(options: RunProdAppOptions): Promise<ProdAppHan
     await seed({ db });
   }
 
+  // ES-Operations / Seed-Migrations (Phase 1). Läuft NACH applyBootSeeds +
+  // existing seeds-array — die deklarativen Seeds sind die "always-insert-
+  // if-missing"-Schicht; seed-migrations sind die "diff-and-update"-
+  // Schicht für Drift den existing Seeds nicht erfassen können (z.B.
+  // Membership-Roles-Change nach initialer Seed-Erstellung).
+  if (options.seedsDir !== undefined && process.env["KUMIKO_SKIP_ES_OPS"] !== "1") {
+    await createEsOperationsTable(db);
+    const seedDispatcher = createDispatcher(registry, {
+      db,
+      redis,
+      entityCache,
+      registry,
+      ...extraContext,
+    });
+    await runPendingSeedMigrations({
+      db,
+      seedsDir: options.seedsDir,
+      appliedBy: "boot",
+      createContext: (dbRunner: DbRunner) =>
+        createSeedMigrationContext({ dispatcher: seedDispatcher, dbRunner }),
+    });
+  }
+
   await entrypoint.start();
 
   // 10. App-eigene HTTP-Routes mounten — vor dem static-fallback. Hono