@cosmicdrift/kumiko-dev-server 1.0.0 → 2.0.0

package/src/scaffold-demo-tasks.ts

@@ -0,0 +1,233 @@
+// Demo `tasks` feature + seed for scaffolded apps — wasp-like starter UX.
+// `createDemoTasksFeature()` feeds init-migration generation; the render*
+// functions emit the same shape into the user's repo.
+
+import {
+  createBooleanField,
+  createEntity,
+  createNumberField,
+  createTextField,
+  defineEntityCreateHandler,
+  defineEntityDeleteHandler,
+  defineEntityDetailHandler,
+  defineEntityListHandler,
+  defineEntityUpdateHandler,
+  defineFeature,
+  type FeatureDefinition,
+} from "@cosmicdrift/kumiko-framework/engine";
+import type {
+  EntityEditScreenDefinition,
+  EntityListScreenDefinition,
+} from "@cosmicdrift/kumiko-framework/ui-types";
+
+const taskEntity = createEntity({
+  fields: {
+    title: createTextField({ required: true, sortable: true }),
+    status: createTextField({ sortable: true }),
+    priority: createNumberField(),
+    isUrgent: createBooleanField({ default: false }),
+  },
+});
+
+const listScreen: EntityListScreenDefinition = {
+  id: "task-list",
+  type: "entityList",
+  entity: "task",
+  columns: ["title", "status", "isUrgent", "priority"],
+  defaultSort: { field: "title", dir: "asc" },
+  rowActions: [{ kind: "navigate", id: "edit", label: "Edit", screen: "task-edit" }],
+};
+
+const editScreen: EntityEditScreenDefinition = {
+  id: "task-edit",
+  type: "entityEdit",
+  entity: "task",
+  layout: {
+    sections: [{ title: "Task", fields: ["title", "status", "priority", "isUrgent"] }],
+  },
+};
+
+const open = { access: { openToAll: true } } as const;
+
+const TASKS_I18N = {
+  "screen:task-list.title": { de: "Aufgaben", en: "Tasks" },
+  "screen:task-edit.title": { de: "Aufgabe", en: "Task" },
+  "tasks:entity:task:field:title": { de: "Titel", en: "Title" },
+  "tasks:entity:task:field:status": { de: "Status", en: "Status" },
+  "tasks:entity:task:field:priority": { de: "Priorität", en: "Priority" },
+  "tasks:entity:task:field:isUrgent": { de: "Dringend", en: "Urgent" },
+} as const;
+
+/** Canonical demo feature — keep in sync with `renderDemoTasksFeatureFile()`. */
+export function createDemoTasksFeature(): FeatureDefinition {
+  return defineFeature("tasks", (r) => {
+    r.translations({ keys: TASKS_I18N });
+    r.entity("task", taskEntity);
+    r.writeHandler(defineEntityCreateHandler("task", taskEntity, open));
+    r.writeHandler(defineEntityUpdateHandler("task", taskEntity, open));
+    r.writeHandler(defineEntityDeleteHandler("task", taskEntity, open));
+    r.queryHandler(defineEntityListHandler("task", taskEntity, open));
+    r.queryHandler(defineEntityDetailHandler("task", taskEntity, open));
+    r.screen(listScreen);
+    r.screen(editScreen);
+    r.nav({ id: "tasks", label: "Tasks", order: 10, screen: "tasks:screen:task-list" });
+    r.nav({
+      id: "task-new",
+      label: "New task",
+      parent: "tasks:nav:tasks",
+      screen: "tasks:screen:task-edit",
+      order: 10,
+    });
+  });
+}
+
+export function renderDemoTasksFeatureFile(): string {
+  return `// Demo tasks feature — scaffolded by \`kumiko new app\`. Edit or replace.
+// Entity + CRUD handlers + list/edit screens + sidebar nav.
+
+import {
+  createBooleanField,
+  createEntity,
+  createNumberField,
+  createTextField,
+  defineEntityCreateHandler,
+  defineEntityDeleteHandler,
+  defineEntityDetailHandler,
+  defineEntityListHandler,
+  defineEntityUpdateHandler,
+  defineFeature,
+} from "@cosmicdrift/kumiko-framework/engine";
+import type {
+  EntityEditScreenDefinition,
+  EntityListScreenDefinition,
+} from "@cosmicdrift/kumiko-framework/ui-types";
+import { tasksTranslationKeys } from "./i18n";
+
+const taskEntity = createEntity({
+  fields: {
+    title: createTextField({ required: true, sortable: true }),
+    status: createTextField({ sortable: true }),
+    priority: createNumberField(),
+    isUrgent: createBooleanField({ default: false }),
+  },
+});
+
+const listScreen: EntityListScreenDefinition = {
+  id: "task-list",
+  type: "entityList",
+  entity: "task",
+  columns: ["title", "status", "isUrgent", "priority"],
+  defaultSort: { field: "title", dir: "asc" },
+  rowActions: [{ kind: "navigate", id: "edit", label: "Edit", screen: "task-edit" }],
+};
+
+const editScreen: EntityEditScreenDefinition = {
+  id: "task-edit",
+  type: "entityEdit",
+  entity: "task",
+  layout: {
+    sections: [{ title: "Task", fields: ["title", "status", "priority", "isUrgent"] }],
+  },
+};
+
+const open = { access: { openToAll: true } } as const;
+
+export const tasksFeature = defineFeature("tasks", (r) => {
+  r.translations({ keys: tasksTranslationKeys });
+  r.entity("task", taskEntity);
+  r.writeHandler(defineEntityCreateHandler("task", taskEntity, open));
+  r.writeHandler(defineEntityUpdateHandler("task", taskEntity, open));
+  r.writeHandler(defineEntityDeleteHandler("task", taskEntity, open));
+  r.queryHandler(defineEntityListHandler("task", taskEntity, open));
+  r.queryHandler(defineEntityDetailHandler("task", taskEntity, open));
+  r.screen(listScreen);
+  r.screen(editScreen);
+  r.nav({ id: "tasks", label: "Tasks", order: 10, screen: "tasks:screen:task-list" });
+  r.nav({
+    id: "task-new",
+    label: "New task",
+    parent: "tasks:nav:tasks",
+    screen: "tasks:screen:task-edit",
+    order: 10,
+  });
+});
+`;
+}
+
+export function renderDemoTasksI18n(): string {
+  return `// Server-side translation keys for the demo tasks feature.
+
+import type { TranslationsByLocale } from "@cosmicdrift/kumiko-renderer";
+
+export const tasksTranslationKeys = {
+  "screen:task-list.title": { de: "Aufgaben", en: "Tasks" },
+  "screen:task-edit.title": { de: "Aufgabe", en: "Task" },
+  "tasks:entity:task:field:title": { de: "Titel", en: "Title" },
+  "tasks:entity:task:field:status": { de: "Status", en: "Status" },
+  "tasks:entity:task:field:priority": { de: "Priorität", en: "Priority" },
+  "tasks:entity:task:field:isUrgent": { de: "Dringend", en: "Urgent" },
+} as const;
+
+export const tasksTranslations: TranslationsByLocale = {
+  de: {
+    "screen:task-list.title": "Aufgaben",
+    "screen:task-edit.title": "Aufgabe",
+    "tasks:entity:task:field:title": "Titel",
+    "tasks:entity:task:field:status": "Status",
+    "tasks:entity:task:field:priority": "Priorität",
+    "tasks:entity:task:field:isUrgent": "Dringend",
+  },
+  en: {
+    "screen:task-list.title": "Tasks",
+    "screen:task-edit.title": "Task",
+    "tasks:entity:task:field:title": "Title",
+    "tasks:entity:task:field:status": "Status",
+    "tasks:entity:task:field:priority": "Priority",
+    "tasks:entity:task:field:isUrgent": "Urgent",
+  },
+};
+`;
+}
+
+export function renderDemoTasksWebIndex(): string {
+  return `import type { ClientFeatureDefinition } from "@cosmicdrift/kumiko-renderer-web";
+import { tasksTranslations } from "../i18n";
+
+export const tasksClient: ClientFeatureDefinition = {
+  name: "tasks",
+  translations: tasksTranslations,
+};
+`;
+}
+
+export function renderDemoTasksIndex(): string {
+  return `export { tasksFeature } from "./feature";
+`;
+}
+
+export function renderDemoSeedFile(): string {
+  return `// Demo seed — a few tasks so \`bun dev\` shows a non-empty list.
+// Idempotent: skips when the tenant already has tasks (persistent dev DB).
+
+import type { SeedFn } from "@cosmicdrift/kumiko-dev-server";
+import { TestUsers } from "@cosmicdrift/kumiko-framework/stack";
+
+const DEMO_TASKS = [
+  { title: "Welcome to Kumiko", status: "todo", priority: 1, isUrgent: false },
+  { title: "Try editing me", status: "in progress", priority: 2, isUrgent: true },
+] as const;
+
+export const seedDemoTasks: SeedFn = async (stack) => {
+  const admin = TestUsers.admin;
+  const existing = await stack.http.queryOk<{ rows: unknown[] }>(
+    "tasks:query:task:list",
+    {},
+    admin,
+  );
+  if (existing.rows.length > 0) return;
+  for (const task of DEMO_TASKS) {
+    await stack.http.write("tasks:write:task:create", task, admin);
+  }
+};
+`;
+}

package/src/schema-apply.ts

@@ -22,7 +22,10 @@ import {
   createProjectionStateTable,
   rebuildProjection,
 } from "@cosmicdrift/kumiko-framework/pipeline";
-import { type ComposeFeaturesOptions, composeFeatures } from "./compose-features";
+import {
+  type ComposeFeaturesOptions,
+  composeFeatures,
+} from "@cosmicdrift/kumiko-server-runtime/compose-features";
 
 export type SchemaApplyOptions = ComposeFeaturesOptions & {
   /** App-Features (z.B. APP_FEATURES aus run-config) — composed mit den
@@ -100,8 +103,18 @@ async function rebuildAffectedProjections(
   const projections = new Set<string>();
   for (const table of changedTables) {
     const name = tableToProjection.get(table);
-    if (name) projections.add(name);
+    if (name) {
+      projections.add(name);
+    } else {
+      // 522/3: a table in a .rebuild.json marker that no longer matches any
+      // registered projection would otherwise rebuild nothing and exit 0 —
+      // indistinguishable from "nothing needed a rebuild".
+      console.warn(
+        `  ⚠ Table "${table}" is in a rebuild marker but matches no registered projection — skipped.`,
+      );
+    }
   }
+  // skip: no projections matched the changed tables, nothing to rebuild
   if (projections.size === 0) return;
 
   console.log(`  Rebuild ${projections.size} Projection(s)…`);

package/src/schema-check-core.ts

@@ -4,7 +4,7 @@
 
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { composeFeatures } from "./compose-features";
+import { composeFeatures } from "@cosmicdrift/kumiko-server-runtime/compose-features";
 
 // The generate-script lives under different roots across apps: publicstatus
 // uses `drizzle/generate.ts`, the framework's own sample-apps use

package/src/setup-test-stack-from-features.ts

@@ -0,0 +1,61 @@
+// Test helper: composeFeatures + setupTestStack in one call.
+// Apps pass the same feature list as run-config (APP_FEATURES / buildAppFeatures).
+
+import { createConfigResolver } from "@cosmicdrift/kumiko-bundled-features/config";
+import { createTextContentApi } from "@cosmicdrift/kumiko-bundled-features/text-content";
+import type { FeatureDefinition } from "@cosmicdrift/kumiko-framework/engine";
+import {
+  setupTestStack,
+  type TestStack,
+  type TestStackOptions,
+} from "@cosmicdrift/kumiko-framework/stack";
+import {
+  type ComposeFeaturesOptions,
+  composeFeatures,
+} from "@cosmicdrift/kumiko-server-runtime/compose-features";
+
+export type TestStackPreset = "config" | "text-content";
+
+export type SetupTestStackFromFeaturesOptions = Omit<TestStackOptions, "features"> & {
+  readonly includeBundled?: boolean;
+  readonly authOptions?: ComposeFeaturesOptions["authOptions"];
+  readonly presets?: readonly TestStackPreset[];
+};
+
+export function mergeExtraContext(
+  base: TestStackOptions["extraContext"],
+  presets: readonly TestStackPreset[],
+): TestStackOptions["extraContext"] {
+  if (presets.length === 0) return base;
+
+  return (deps) => {
+    const fromBase =
+      typeof base === "function" ? base(deps) : base !== undefined ? { ...base } : {};
+    const merged: Record<string, unknown> = { ...fromBase };
+
+    if (presets.includes("config")) {
+      const configResolver = createConfigResolver();
+      merged["configResolver"] = configResolver;
+    }
+    if (presets.includes("text-content")) {
+      merged["textContent"] = createTextContentApi(deps.db);
+    }
+
+    return merged;
+  };
+}
+
+export async function setupTestStackFromFeatures(
+  appFeatures: readonly FeatureDefinition[],
+  options: SetupTestStackFromFeaturesOptions = {},
+): Promise<TestStack> {
+  const { includeBundled = false, authOptions, presets = [], ...stackOptions } = options;
+  const features = composeFeatures(appFeatures, { includeBundled, authOptions });
+  const extraContext = mergeExtraContext(stackOptions.extraContext, presets);
+
+  return setupTestStack({
+    ...stackOptions,
+    features,
+    ...(extraContext !== undefined && { extraContext }),
+  });
+}

package/src/welcome-banner.ts

@@ -37,10 +37,7 @@ export function renderWelcomeBanner(input: WelcomeBannerInput): string {
   return [top, ...padded, bottom].join("\n");
 }
 
-// Plain monospace-cell width — counts each codepoint as one cell. Good
-// enough for ASCII + the small set of arrows/checkmarks used above; if a
-// real wide-char ever lands in the banner the row alignment will drift,
-// caught visually by the snapshot test.
+// ponytail: codepoint width; ok for ASCII + arrows, add a width-lib if CJK ever lands here.
 function stringWidth(s: string): number {
   return [...s].length;
 }

package/src/__tests__/boot-extra-context.test.ts

@@ -1,140 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { createDeliveryFeature } from "@cosmicdrift/kumiko-bundled-features/delivery";
-import { createSecretsFeature } from "@cosmicdrift/kumiko-bundled-features/secrets";
-import type { DbConnection } from "@cosmicdrift/kumiko-framework/db";
-import { createRegistry, defineFeature } from "@cosmicdrift/kumiko-framework/engine";
-import type { MasterKeyProvider } from "@cosmicdrift/kumiko-framework/secrets";
-import { buildBootExtraContext } from "../run-prod-app";
-
-// Pins runProdApp's framework-default-provider autowire (buildBootExtraContext):
-// textContent unconditional, secrets feature-gated, KEK-env trap avoided, the
-// money-horse regression (no secrets feature → no forced KEK → no throw), and
-// the delivery _notifyFactory wiring that makes ctx.notify work in prod (only
-// test-wired before — runProdApp/runDevApp call THIS, not createDeliveryTestContext).
-
-// db is never touched at construction time — createTextContentApi /
-// createSecretsContext only store the handle and query lazily. A bare stub
-// keeps this a fast unit test (no Postgres) instead of a full boot.
-const fakeDb = {} as unknown as DbConnection;
-const registry = createRegistry([]);
-const KEK = Buffer.alloc(32, 7).toString("base64");
-
-const otherFeature = defineFeature("widgets", () => {});
-
-describe("buildBootExtraContext — framework-default provider autowire", () => {
-  test("textContent is wired unconditionally (no secrets feature, no auth)", () => {
-    const ctx = buildBootExtraContext({
-      db: fakeDb,
-      features: [otherFeature],
-      envSource: {},
-      registry,
-      hasAuth: false,
-    });
-    expect(typeof (ctx["textContent"] as { getBlock?: unknown }).getBlock).toBe("function");
-    expect(ctx["secrets"]).toBeUndefined();
-    expect(ctx["configResolver"]).toBeUndefined();
-    expect(ctx["_notifyFactory"]).toBeUndefined();
-  });
-
-  test("delivery feature mounted → _notifyFactory wired (ctx.notify works in prod)", () => {
-    const ctx = buildBootExtraContext({
-      db: fakeDb,
-      features: [createDeliveryFeature()],
-      envSource: {},
-      registry,
-      hasAuth: false,
-    });
-    expect(typeof ctx["_notifyFactory"]).toBe("function");
-  });
-
-  test("no delivery feature → _notifyFactory not wired", () => {
-    const ctx = buildBootExtraContext({
-      db: fakeDb,
-      features: [otherFeature],
-      envSource: {},
-      registry,
-      hasAuth: false,
-    });
-    expect(ctx["_notifyFactory"]).toBeUndefined();
-  });
-
-  test("secrets feature mounted + valid KEK env → ctx.secrets wired", () => {
-    const ctx = buildBootExtraContext({
-      db: fakeDb,
-      features: [createSecretsFeature()],
-      envSource: {
-        KUMIKO_SECRETS_MASTER_KEY_V1: KEK,
-        KUMIKO_SECRETS_MASTER_KEY_CURRENT_VERSION: "1",
-      },
-      registry,
-      hasAuth: false,
-    });
-    const secrets = ctx["secrets"] as {
-      get?: unknown;
-      set?: unknown;
-      has?: unknown;
-      delete?: unknown;
-    };
-    expect(typeof secrets.get).toBe("function");
-    expect(typeof secrets.set).toBe("function");
-  });
-
-  test("secrets feature mounted, only V1 set (no CURRENT_VERSION) → wired (default '1')", () => {
-    const ctx = buildBootExtraContext({
-      db: fakeDb,
-      features: [createSecretsFeature()],
-      envSource: { KUMIKO_SECRETS_MASTER_KEY_V1: KEK },
-      registry,
-      hasAuth: false,
-    });
-    expect(ctx["secrets"]).toBeDefined();
-  });
-
-  test("secrets feature mounted but NO KEK + no override → skipped, no throw (dev DEV_KEY path)", () => {
-    // dev wires its own DEV_KEY secrets explicitly; the auto-wire must not
-    // eagerly construct an env-provider and crash the boot when no env KEK
-    // exists. ctx.secrets stays unset so the app's explicit wiring wins.
-    let ctx: Record<string, unknown> | undefined;
-    expect(() => {
-      ctx = buildBootExtraContext({
-        db: fakeDb,
-        features: [createSecretsFeature()],
-        envSource: {},
-        registry,
-        hasAuth: false,
-      });
-    }).not.toThrow();
-    expect(ctx?.["secrets"]).toBeUndefined();
-  });
-
-  test("no secrets feature → no KEK ever read, boots green (money-horse regression)", () => {
-    const ctx = buildBootExtraContext({
-      db: fakeDb,
-      features: [otherFeature],
-      envSource: {}, // no KEK — must NOT matter when secrets isn't mounted
-      registry,
-      hasAuth: false,
-    });
-    expect(ctx["secrets"]).toBeUndefined();
-  });
-
-  test("masterKey override is used verbatim — no env-provider built", () => {
-    const override: MasterKeyProvider = {
-      wrapDek: async () => ({ encryptedDek: Buffer.alloc(0), kekVersion: 1 }),
-      unwrapDek: async () => Buffer.alloc(0),
-      currentVersion: () => 1,
-      isAvailable: async () => true,
-    };
-    // envSource is empty: if the override weren't honoured, createEnvMasterKeyProvider
-    // would throw "no KEK". It doesn't → the override path is taken.
-    const ctx = buildBootExtraContext({
-      db: fakeDb,
-      features: [createSecretsFeature()],
-      envSource: {},
-      registry,
-      hasAuth: false,
-      masterKey: override,
-    });
-    expect(ctx["secrets"]).toBeDefined();
-  });
-});