@cosmicdrift/kumiko-framework 0.20.0 → 0.21.0

package/LICENSE

@@ -21,7 +21,7 @@ managed offering of the Licensed Work.
 This restriction does not apply to the Licensor, any entity controlled by, 
 controlling, or under common control with the Licensor ("Affiliates"), or 
 contractors acting on their behalf. The Licensor remains free to use the 
-Licensed Work for any purpose, including for the operation of kumiko.so.
+Licensed Work for any purpose, including for the operation of kumiko.rocks.
 
 Change Date:          2030-05-05
 Change License:       Apache License, Version 2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-framework",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "Framework core — engine, pipeline, API, DB, and every other bit that makes Kumiko go.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -12,7 +12,7 @@
   "bugs": {
     "url": "https://github.com/CosmicDriftGameStudio/kumiko-framework/issues"
   },
-  "homepage": "https://kumiko.so",
+  "homepage": "https://kumiko.rocks",
   "keywords": [
     "framework",
     "multi-tenant",

package/src/compliance/sub-processors.ts

@@ -4,7 +4,7 @@
 // Plattform-Betrieb einsetzt. Wird oeffentlich exposed unter
 //   /api/compliance/sub-processors        (JSON, Sprint 1)
 //   /api/compliance/sub-processors.rss    (RSS, Sprint 1)
-//   kumiko.so/subprocessors               (HTML, Marketing-Repo)
+//   kumiko.rocks/subprocessors               (HTML, Marketing-Repo)
 //
 // Tenant-Admins muessen ueber Add/Change/Remove informiert werden mit
 // Lead-Time aus dem Compliance-Profile (typisch 30d). Cron-Job kommt

package/src/engine/types/handlers.ts

@@ -614,7 +614,7 @@ export type TypedAppendEventArgs<TMap extends object, K extends keyof TMap> = {
 //   We pick the first option and force the wrong path to fail visibly.
 //
 // How this is wired in practice:
-//   - Apps run `yarn kumiko codegen`, which writes `.kumiko/define.ts`
+//   - Apps run `bun kumiko codegen`, which writes `.kumiko/define.ts`
 //     with locally-bound `defineWriteHandler<TName, TSchema, TData,
 //     KumikoEventTypeMap>(...)` wrappers. Handlers inside those wrappers
 //     get a strict ctx.appendEvent.

package/src/errors/__tests__/classes.test.ts

@@ -30,22 +30,22 @@ describe("KumikoError: abstract base", () => {
   describe("docsUrl getter — Self-Service-Link", () => {
     test("uses details.reason when set (NotFoundError sets entity-specific reason)", () => {
       const err = new NotFoundError("order", 42);
-      expect(err.docsUrl).toBe("https://docs.kumiko.so/errors/order_not_found");
+      expect(err.docsUrl).toBe("https://docs.kumiko.rocks/errors/order_not_found");
     });
 
     test("uses details.reason when explicitly set (ConflictError-style)", () => {
       const err = new ConflictError({ details: { reason: "stale_state" } });
-      expect(err.docsUrl).toBe("https://docs.kumiko.so/errors/stale_state");
+      expect(err.docsUrl).toBe("https://docs.kumiko.rocks/errors/stale_state");
     });
 
     test("falls back to code when details has no reason field", () => {
       const err = new ConflictError({ details: { foo: "bar" } });
-      expect(err.docsUrl).toBe("https://docs.kumiko.so/errors/conflict");
+      expect(err.docsUrl).toBe("https://docs.kumiko.rocks/errors/conflict");
     });
 
     test("falls back to code when details is undefined", () => {
       const err = new ConflictError();
-      expect(err.docsUrl).toBe("https://docs.kumiko.so/errors/conflict");
+      expect(err.docsUrl).toBe("https://docs.kumiko.rocks/errors/conflict");
     });
 
     test("respects KUMIKO_DOCS_URL env override (Self-Hosted-Kunden)", () => {
@@ -63,7 +63,7 @@ describe("KumikoError: abstract base", () => {
     test("serializeError exposes docsUrl in the wire response", () => {
       const err = new ConflictError({ details: { reason: "stale_state" } });
       const body = serializeError(err);
-      expect(body.error.docsUrl).toBe("https://docs.kumiko.so/errors/stale_state");
+      expect(body.error.docsUrl).toBe("https://docs.kumiko.rocks/errors/stale_state");
     });
   });
 });

package/src/errors/kumiko-error.ts

@@ -22,7 +22,7 @@ export type ErrorCtorInput = {
 // Default-Doku-URL für Self-Service-Errors. Kann via env-var
 // `KUMIKO_DOCS_URL` überschrieben werden — z.B. für Self-Hosted-Kunden
 // die ihre eigene Doku-Instanz hosten.
-const DEFAULT_DOCS_BASE_URL = "https://docs.kumiko.so";
+const DEFAULT_DOCS_BASE_URL = "https://docs.kumiko.rocks";
 
 function docsBaseUrl(): string {
   return process.env["KUMIKO_DOCS_URL"] ?? DEFAULT_DOCS_BASE_URL;

package/src/migrations/index.ts

@@ -1,6 +1,4 @@
 // Drizzle-free gate (kumiko/migrations system) — the canonical boot-gate.
-// `SchemaDriftError` is re-exported from here; the legacy drizzle gate above
-// keeps its own internal error until Phase 3 removes schema-drift.ts.
 export {
   assertKumikoSchemaCurrent,
   type ChecksumMismatch,
@@ -9,30 +7,5 @@ export {
   type KumikoDriftReport,
   SchemaDriftError,
 } from "./kumiko-drift";
-export {
-  buildProjectionTableIndex,
-  type ChangedTable,
-  compareSnapshots,
-  detectProjectionsToRebuild,
-  latestMigrationTag,
-  projectionsFromChanges,
-} from "./projection-detection";
-export { type RebuildMarker, readRebuildMarker, writeRebuildMarker } from "./rebuild-marker";
-export {
-  type AppliedMigration,
-  assertSchemaCurrent,
-  type ColumnIssue,
-  type ColumnSpec,
-  type DriftReport,
-  detectDrift,
-  formatDriftReport,
-  type Journal,
-  type JournalEntry,
-  loadAppliedMigrations,
-  loadJournal,
-  loadLatestSnapshot,
-  loadPreviousSnapshot,
-  loadSnapshot,
-  type Snapshot,
-  type SnapshotTable,
-} from "./schema-drift";
+// tableName → projection-name, für den app-seitigen Projection-Rebuild.
+export { buildProjectionTableIndex } from "./projection-table-index";

package/src/migrations/projection-table-index.ts

@@ -0,0 +1,35 @@
+// Index `tableName → projection-name` aus der Registry. Genutzt vom
+// app-seitigen Projection-Rebuild (`kumiko schema apply` liest die
+// rebuild-Marker → mappt Tabellen auf Projektionen → rebuildProjection).
+//
+// Drizzle-frei: der Tabellen-Name kommt aus dem kumiko-Symbol das
+// buildEntityTable/buildEntityTableMeta an die Table-Definition hängt.
+
+import type { Registry } from "../engine/types/feature";
+
+const KUMIKO_NAME_SYMBOL = Symbol.for("kumiko:schema:Name");
+
+function getTableName(table: unknown): string {
+  if (typeof table !== "object" || table === null) {
+    throw new Error("projection-table-index: table is not a table object");
+  }
+  const name = (table as Record<symbol, unknown>)[KUMIKO_NAME_SYMBOL];
+  if (typeof name !== "string") {
+    throw new Error("projection-table-index: table missing kumiko name symbol");
+  }
+  return name;
+}
+
+/** Index `tableName → projection-name` aus der Registry. Nur Projections mit
+ *  table-Definition (single-stream + multi-stream-with-table) zählen.
+ *  Side-effect-only MSPs (table omitted) haben keinen Rebuild-Sinn. */
+export function buildProjectionTableIndex(registry: Registry): ReadonlyMap<string, string> {
+  const index = new Map<string, string>();
+  for (const [name, def] of registry.getAllProjections()) {
+    index.set(getTableName(def.table), name);
+  }
+  for (const [name, def] of registry.getAllMultiStreamProjections()) {
+    if (def.table) index.set(getTableName(def.table), name);
+  }
+  return index;
+}

package/src/pipeline/msp-rebuild.ts

@@ -99,7 +99,7 @@ export async function rebuildMultiStreamProjection(
   }
   if (!msp.table) {
     throw new Error(
-      `MultiStreamProjection "${mspName}" has no backing table — it is a pure side-effect consumer (webhooks, notifications, external sync). Rebuild would re-invoke those side-effects by replaying the log. For poison events use yarn kumiko consumer skip / restart; there is no analogous "rebuild" concept for side-effect sinks.`,
+      `MultiStreamProjection "${mspName}" has no backing table — it is a pure side-effect consumer (webhooks, notifications, external sync). Rebuild would re-invoke those side-effects by replaying the log. For poison events use bun kumiko consumer skip / restart; there is no analogous "rebuild" concept for side-effect sinks.`,
     );
   }
 

package/src/db/queries/schema-drift.ts

@@ -1,35 +0,0 @@
-import type { AnyDb } from "../query";
-import { asRawClient } from "../query";
-
-export type AppliedMigrationRow = {
-  readonly hash: string;
-  readonly created_at: bigint | number | null;
-};
-
-export type DbColumnInfoRow = {
-  readonly column_name: string;
-  readonly data_type: string;
-  readonly is_nullable: "YES" | "NO";
-};
-
-/** tableRef must be `drizzle.__drizzle_migrations` or `public.__drizzle_migrations`. */
-export async function selectAppliedMigrations(
-  db: AnyDb,
-  tableRef: "drizzle.__drizzle_migrations" | "public.__drizzle_migrations",
-): Promise<readonly AppliedMigrationRow[]> {
-  return (await asRawClient(db).unsafe(
-    `SELECT hash, created_at FROM ${tableRef} ORDER BY id`,
-  )) as readonly AppliedMigrationRow[];
-}
-
-export async function selectPublicTableColumns(
-  db: AnyDb,
-  tableName: string,
-): Promise<readonly DbColumnInfoRow[]> {
-  return (await asRawClient(db).unsafe(
-    `SELECT column_name, data_type, is_nullable
-     FROM information_schema.columns
-     WHERE table_schema = 'public' AND table_name = $1`,
-    [tableName],
-  )) as readonly DbColumnInfoRow[];
-}

package/src/migrations/__tests__/compare-snapshots.test.ts

@@ -1,150 +0,0 @@
-// Unit-Tests für compareSnapshots — der Diff-Algorithmus zwischen zwei
-// Drizzle-Snapshots. Production-Behavior: bei Schema-Drift einer
-// Projection-Tabelle muss der Detector die richtigen Tabellen-Namen
-// melden, damit migrate apply den richtigen Rebuild triggert.
-
-import { describe, expect, test } from "bun:test";
-import { compareSnapshots } from "../projection-detection";
-import type { Snapshot, SnapshotTable } from "../schema-drift";
-
-function snapshot(tables: Record<string, Partial<SnapshotTable>>): Snapshot {
-  const out: Record<string, SnapshotTable> = {};
-  for (const [key, partial] of Object.entries(tables)) {
-    out[key] = {
-      schema: partial.schema ?? "",
-      name: partial.name ?? key.replace(/^public\./, ""),
-      columns: partial.columns ?? {},
-    };
-  }
-  return { tables: out };
-}
-
-const userTable: SnapshotTable = {
-  schema: "",
-  name: "users",
-  columns: {
-    id: { name: "id", type: "uuid", primaryKey: true, notNull: true },
-    email: { name: "email", type: "text", notNull: true },
-  },
-};
-
-describe("compareSnapshots", () => {
-  test("prev=null → all current tables marked as added", () => {
-    const current = snapshot({ "public.users": userTable });
-    const changes = compareSnapshots(null, current);
-    expect(changes).toHaveLength(1);
-    expect(changes[0]).toMatchObject({ tableName: "users", kind: "added" });
-  });
-
-  test("identical snapshots → no changes", () => {
-    const s = snapshot({ "public.users": userTable });
-    expect(compareSnapshots(s, s)).toHaveLength(0);
-  });
-
-  test("table appears in current → kind=added", () => {
-    const prev = snapshot({});
-    const current = snapshot({ "public.users": userTable });
-    const changes = compareSnapshots(prev, current);
-    expect(changes).toEqual([{ fullName: "users", tableName: "users", kind: "added" }]);
-  });
-
-  test("table missing in current → kind=removed", () => {
-    const prev = snapshot({ "public.users": userTable });
-    const current = snapshot({});
-    const changes = compareSnapshots(prev, current);
-    expect(changes).toEqual([{ fullName: "users", tableName: "users", kind: "removed" }]);
-  });
-
-  test("column added → kind=modified", () => {
-    const prev = snapshot({ "public.users": userTable });
-    const current = snapshot({
-      "public.users": {
-        ...userTable,
-        columns: { ...userTable.columns, name: { name: "name", type: "text" } },
-      },
-    });
-    const changes = compareSnapshots(prev, current);
-    expect(changes).toEqual([{ fullName: "users", tableName: "users", kind: "modified" }]);
-  });
-
-  test("column type changed → kind=modified", () => {
-    const prev = snapshot({ "public.users": userTable });
-    const current = snapshot({
-      "public.users": {
-        ...userTable,
-        columns: {
-          ...userTable.columns,
-          email: { name: "email", type: "varchar(255)", notNull: true },
-        },
-      },
-    });
-    expect(compareSnapshots(prev, current)).toEqual([
-      { fullName: "users", tableName: "users", kind: "modified" },
-    ]);
-  });
-
-  test("notNull flipped → kind=modified", () => {
-    const prev = snapshot({ "public.users": userTable });
-    const current = snapshot({
-      "public.users": {
-        ...userTable,
-        columns: { ...userTable.columns, email: { name: "email", type: "text", notNull: false } },
-      },
-    });
-    expect(compareSnapshots(prev, current)).toEqual([
-      { fullName: "users", tableName: "users", kind: "modified" },
-    ]);
-  });
-
-  test("default value changed → kind=modified", () => {
-    const prev = snapshot({
-      "public.users": {
-        ...userTable,
-        columns: {
-          ...userTable.columns,
-          status: { name: "status", type: "text", default: "'active'" },
-        },
-      },
-    });
-    const current = snapshot({
-      "public.users": {
-        ...userTable,
-        columns: {
-          ...userTable.columns,
-          status: { name: "status", type: "text", default: "'pending'" },
-        },
-      },
-    });
-    expect(compareSnapshots(prev, current)).toEqual([
-      { fullName: "users", tableName: "users", kind: "modified" },
-    ]);
-  });
-
-  test("schema-prefix in fullName when set", () => {
-    const prev = snapshot({});
-    const current = snapshot({
-      "auth.users": { ...userTable, schema: "auth" },
-    });
-    const changes = compareSnapshots(prev, current);
-    expect(changes[0]?.fullName).toBe("auth.users");
-  });
-
-  test("multiple changes preserved with stable kind classification", () => {
-    const tableA: SnapshotTable = { ...userTable, name: "a" };
-    const tableB: SnapshotTable = { ...userTable, name: "b" };
-    const tableC: SnapshotTable = { ...userTable, name: "c" };
-    const prev = snapshot({
-      "public.a": tableA,
-      "public.b": tableB,
-    });
-    const current = snapshot({
-      "public.a": tableA, // unchanged
-      "public.c": tableC, // added
-      // b removed
-    });
-    const changes = compareSnapshots(prev, current);
-    expect(changes).toHaveLength(2);
-    expect(changes.find((c) => c.tableName === "c")?.kind).toBe("added");
-    expect(changes.find((c) => c.tableName === "b")?.kind).toBe("removed");
-  });
-});