@cosmicdrift/kumiko-dev-server 0.328.1 → 0.330.0

package/src/build-server-bundle.ts

@@ -1,346 +0,0 @@
-// buildServerBundle — Production-Server-Bundle für Kumiko-Apps. Pendant zu
-// buildProdBundle (Client). Convention-Driven Discovery liest bin/main.ts
-// (+ optional <repo>/bin/kumiko.ts) und produziert ein runtime-self-contained
-// dist-server/ aus dem ein Bun-Alpine-Container ohne Monorepo bootet.
-//
-// Convention:
-//
-//   bin/main.ts            →  dist-server/server.js   (App-Boot, ruft runProdApp)
-//   <repo>/bin/kumiko.ts   →  dist-server/kumiko.js   (Migrate-CLI: `schema apply`,
-//                             gefunden via walk-up bis bin/kumiko.ts)
-//   dist-server/package.json → runtime-deps mit gepinnten Versionen
-//
-// Beide Entries werden in EINEM Bun.build-Call mit `splitting` gebaut: das
-// Framework landet als geteilte chunk-*.js, server.js + kumiko.js sind schlanke
-// Entries die sie importieren — statt das Framework pro Entry neu zu inlinen
-// (vorher ~14 MB × N separate Bundles).
-//
-// Output:
-//
-//   dist-server/
-//     server.js            ← App-Boot-Entry
-//     kumiko.js            ← Migrate-CLI-Entry (wenn bin/kumiko.ts gefunden)
-//     chunk-*.js           ← geteilte Framework-Chunks
-//     package.json         ← runtime-deps mit gepinnten Versionen
-//
-// Externals — Pakete die NICHT ins Bundle gebakt werden, sondern via
-// `bun install` im Runtime-Container nachgeholt werden:
-//
-//   RUNTIME_EXTERNALS — wird zur Laufzeit gebraucht (native bindings,
-//                       worker-threads, dynamic-require). Landet in
-//                       dist-server/package.json#dependencies.
-//
-//   BUILD_ONLY_EXTERNALS — referenziert nur transitiv im Framework, vom
-//                          App-Code aber nie. Tree-Shake wirft sie aus dem
-//                          Bundle, der external-Marker schaltet nur das
-//                          resolution-during-build ab. NICHT in runtime-deps.
-
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
-import { dirname, join, resolve } from "node:path";
-import { parseJsonOrThrow, parseJsonSafe } from "@cosmicdrift/kumiko-framework/utils";
-
-const hasBun = typeof (globalThis as { Bun?: unknown }).Bun !== "undefined";
-
-// Pakete die das Bundle zur Laufzeit weiter referenziert (`from "<pkg>"` nach
-// Tree-Shake). Native bindings (argon2), worker-thread-Loader (bullmq,
-// ioredis), dynamic-require (postgres, temporal-polyfill) — alles was unter
-// Bun-bundling bricht. (drizzle-kit/drizzle-orm sind raus: der Migrate-Pfad
-// nutzt jetzt den framework-eigenen runMigrationsFromDir, kein drizzle-kit.)
-// meilisearch: deliberately here, not in BUILD_ONLY_EXTERNALS below — apps
-// that import createMeilisearchAdapter (kumiko-framework/search/meilisearch)
-// reference the package at runtime (no native binding, plain HTTP client,
-// but a real runtime import). Found 2026-07-19: money-horse prod crash
-// "Cannot find package 'meilisearch'" because it used to sit in
-// BUILD_ONLY_EXTERNALS instead.
-const RUNTIME_EXTERNALS = [
-  "@node-rs/argon2",
-  "sharp",
-  "bullmq",
-  "ioredis",
-  "postgres",
-  "temporal-polyfill",
-  "pino",
-  "pino-pretty",
-  "meilisearch",
-] as const;
-
-// Pakete die nur im Build-Stack erscheinen (transitive Imports im Framework),
-// aber vom App-Code nicht referenziert werden. Ohne external-Markierung
-// scheitert bun build an dynamic-imports. Tree-Shake wirft sie eh aus dem
-// Bundle — der Marker schaltet nur das resolution-during-build ab. NICHT in
-// runtime-deps.
-const BUILD_ONLY_EXTERNALS = [
-  "@planetscale/database",
-  "@libsql/client",
-  "better-sqlite3",
-  "@neondatabase/serverless",
-  "@vercel/postgres",
-  "mysql2",
-  // ink (kumiko-tui) hat react-devtools-core als dev-only transitive import.
-  "react-devtools-core",
-] as const;
-
-export type BuildServerBundleOptions = {
-  /** App-Root. Default: process.cwd(). */
-  readonly cwd?: string;
-  /** Output-Folder relativ zu cwd. Default: "dist-server". */
-  readonly outDir?: string;
-  /** Zusätzliche Pakete die zur Laufzeit installiert sein müssen
-   *  (beyond RUNTIME_EXTERNALS). App-spezifisch — Default leer. */
-  readonly extraRuntimeExternals?: readonly string[];
-  /** Zusätzliche Build-only-Externals. App-spezifisch — Default leer. */
-  readonly extraBuildOnlyExternals?: readonly string[];
-};
-
-export type BuildServerBundleEntry = {
-  readonly file: string;
-  readonly sizeBytes: number;
-};
-
-export type BuildServerBundleResult = {
-  readonly outDir: string;
-  /** Benannte Entry-Files (server.js, ggf. kumiko.js). */
-  readonly entries: readonly BuildServerBundleEntry[];
-  /** Geteilte Framework-Chunks (von splitting). */
-  readonly chunks: readonly BuildServerBundleEntry[];
-  /** Gesamt-Größe aller Outputs (entries + chunks) in Bytes. */
-  readonly totalBytes: number;
-  readonly runtimeDeps: Readonly<Record<string, string>>;
-};
-
-// Bun benennt Entries nach Source-Basename (bin/main.ts → main.js). server.js
-// ist die Runtime-Convention; der Entry wird von nichts importiert (nur die
-// chunks werden referenziert, per relativem Pfad), darum ist der Rename sicher.
-const ENTRY_RENAMES: Readonly<Record<string, string>> = { "main.js": "server.js" };
-
-export async function buildServerBundle(
-  options: BuildServerBundleOptions = {},
-): Promise<BuildServerBundleResult> {
-  if (!hasBun) {
-    throw new Error("buildServerBundle requires Bun runtime (Bun.build is missing).");
-  }
-
-  const cwd = options.cwd ?? process.cwd();
-  const outDir = resolve(cwd, options.outDir ?? "dist-server");
-
-  const serverEntry = discoverServerEntry(cwd);
-  if (!serverEntry) {
-    throw new Error(
-      `[buildServerBundle] Kein bin/main.ts in ${cwd}.\n  Convention: bin/main.ts ist der Server-Bootstrap.`,
-    );
-  }
-
-  const repoRoot = findRepoRoot(cwd);
-  const kumikoCli = repoRoot ? join(repoRoot, "bin/kumiko.ts") : undefined;
-  if (kumikoCli && !existsSync(kumikoCli)) {
-    throw new Error(
-      `[buildServerBundle] Repo-Root erkannt (${repoRoot}), aber bin/kumiko.ts fehlt — kann Migrate-CLI nicht bündeln.`,
-    );
-  }
-
-  const externals = [
-    ...RUNTIME_EXTERNALS,
-    ...BUILD_ONLY_EXTERNALS,
-    ...(options.extraRuntimeExternals ?? []),
-    ...(options.extraBuildOnlyExternals ?? []),
-  ];
-
-  await rm(outDir, { recursive: true, force: true });
-  await mkdir(outDir, { recursive: true });
-
-  // Ein Bun.build-Call mit allen Entries + splitting → das Framework wird
-  // einmal als shared chunk abgelegt statt pro Entry inlined.
-  const entrypoints = kumikoCli ? [serverEntry, kumikoCli] : [serverEntry];
-  const result = await Bun.build({
-    entrypoints,
-    outdir: outDir,
-    target: "bun",
-    external: externals as string[],
-    splitting: true,
-    sourcemap: "none",
-    naming: { entry: "[name].js", chunk: "chunk-[hash].js" },
-    minify: false,
-  });
-  if (!result.success) {
-    const logs = result.logs.map(String).join("\n");
-    throw new Error(`[buildServerBundle] build FAILED:\n${logs}`);
-  }
-
-  // Größe von Disk lesen, nicht aus out.size — letzteres ist für gesplittete
-  // Entry-Points unzuverlässig (meldet teils ~0 für den Entry-Stub).
-  const entries: BuildServerBundleEntry[] = [];
-  const chunks: BuildServerBundleEntry[] = [];
-  for (const out of result.outputs) {
-    const base = out.path.split("/").pop() ?? out.path;
-    if (out.kind === "entry-point") {
-      const desired = ENTRY_RENAMES[base] ?? base;
-      if (desired !== base) {
-        await rename(join(outDir, base), join(outDir, desired));
-      }
-      entries.push({ file: desired, sizeBytes: statSync(join(outDir, desired)).size });
-    } else if (out.kind === "chunk") {
-      chunks.push({ file: base, sizeBytes: statSync(join(outDir, base)).size });
-    }
-  }
-  entries.sort((a, b) => a.file.localeCompare(b.file));
-  const totalBytes = [...entries, ...chunks].reduce((sum, e) => sum + e.sizeBytes, 0);
-
-  const runtimeDeps = await resolveRuntimeDepsVersions(cwd, repoRoot, [
-    ...RUNTIME_EXTERNALS,
-    ...(options.extraRuntimeExternals ?? []),
-  ]);
-
-  const runtimePkg = {
-    name: derivePkgName(cwd),
-    private: true,
-    type: "module",
-    scripts: { start: "bun run server.js" },
-    dependencies: runtimeDeps,
-  };
-  await writeFile(join(outDir, "package.json"), `${JSON.stringify(runtimePkg, null, 2)}\n`);
-
-  return { outDir, entries, chunks, totalBytes, runtimeDeps };
-}
-
-export function discoverServerEntry(cwd: string): string | undefined {
-  const tsEntry = join(cwd, "bin/main.ts");
-  if (existsSync(tsEntry)) return tsEntry;
-  const jsEntry = join(cwd, "bin/main.js");
-  if (existsSync(jsEntry)) return jsEntry;
-  return undefined;
-}
-
-// Walking up vom App-cwd bis ein Verzeichnis mit `bin/kumiko.ts` gefunden wird.
-// Failsafe: nach 8 Levels aufgeben — nichts gefunden, kein Repo-Root, dann
-// liefert die Funktion undefined und der Caller skippt das CLI-Bundle.
-function findRepoRoot(start: string): string | undefined {
-  let cur = start;
-  for (let i = 0; i < 8; i++) {
-    if (existsSync(join(cur, "bin/kumiko.ts"))) return cur;
-    const parent = dirname(cur);
-    if (parent === cur) return undefined;
-    cur = parent;
-  }
-  return undefined;
-}
-
-/** Read `package.json#kumiko.extraRuntimeExternals` for kumiko-build (#1484).
- *  Invalid / missing shapes → empty list (CLI stays convention-driven). */
-export function readExtraRuntimeExternals(cwd: string): readonly string[] {
-  const pkgJson = join(cwd, "package.json");
-  if (!existsSync(pkgJson)) return [];
-  let raw: string;
-  try {
-    raw = readFileSync(pkgJson, "utf-8");
-  } catch {
-    return [];
-  }
-  const parsed = parseJsonSafe<{
-    kumiko?: { extraRuntimeExternals?: unknown };
-  }>(raw, {});
-  const list = parsed.kumiko?.extraRuntimeExternals;
-  if (!Array.isArray(list)) return [];
-  return list.filter((x): x is string => typeof x === "string" && x.trim().length > 0);
-}
-
-// Versionen für RUNTIME_EXTERNALS auflösen: erst aus den installierten
-// node_modules/@cosmicdrift/*-Packages (relativ zu cwd — funktioniert für
-// jede Consumer-App), dann als Zusatz aus packages/framework + bundled-
-// features (Workspace-Checkout des Frameworks selbst). Fallback auf "*"
-// wenn keine Quelle den Namen kennt.
-async function resolveRuntimeDepsVersions(
-  cwd: string,
-  repoRoot: string | undefined,
-  packages: readonly string[],
-): Promise<Record<string, string>> {
-  const out: Record<string, string> = {};
-
-  const pinSources = [
-    ...(repoRoot
-      ? [
-          join(repoRoot, "packages/framework/package.json"),
-          join(repoRoot, "packages/bundled-features/package.json"),
-        ]
-      : []),
-    // node_modules applied last among framework sources so installed versions
-    // win over the repo-root fallback (#1217).
-    join(cwd, "node_modules/@cosmicdrift/kumiko-framework/package.json"),
-    join(cwd, "node_modules/@cosmicdrift/kumiko-bundled-features/package.json"),
-  ];
-  const allDeps: Record<string, string> = {};
-  for (const path of pinSources) {
-    if (!existsSync(path)) continue;
-    const raw = await readFile(path, "utf-8");
-    const parsed = parseJsonOrThrow<{
-      dependencies?: Record<string, string>;
-      optionalDependencies?: Record<string, string>;
-    }>(raw, path);
-    Object.assign(allDeps, parsed.dependencies ?? {}, parsed.optionalDependencies ?? {});
-  }
-  // App package.json fills gaps only — pins extraRuntimeExternals without
-  // overriding framework-native pins the app may also list (#1484 / review).
-  const appPkg = join(cwd, "package.json");
-  if (existsSync(appPkg)) {
-    const raw = await readFile(appPkg, "utf-8");
-    const parsed = parseJsonOrThrow<{
-      dependencies?: Record<string, string>;
-      optionalDependencies?: Record<string, string>;
-    }>(raw, appPkg);
-    for (const [name, ver] of Object.entries({
-      ...(parsed.dependencies ?? {}),
-      ...(parsed.optionalDependencies ?? {}),
-    })) {
-      if (allDeps[name] === undefined) allDeps[name] = ver;
-    }
-  }
-  for (const pkg of packages) {
-    out[pkg] = allDeps[pkg] ?? "*";
-  }
-  return out;
-}
-
-function derivePkgName(cwd: string): string {
-  const pkgJson = join(cwd, "package.json");
-  if (!existsSync(pkgJson)) return "kumiko-app-runtime";
-  // existsSync/readFileSync race (deleted between the two calls) or a
-  // permission error must fall back like a missing file, not crash the
-  // build — read here too, not just the JSON.parse below.
-  let raw: string;
-  try {
-    raw = readFileSync(pkgJson, "utf-8");
-  } catch {
-    return "kumiko-app-runtime";
-  }
-  const parsed = parseJsonSafe<{ name?: string }>(raw, {});
-  return parsed.name ? `${parsed.name}-runtime` : "kumiko-app-runtime";
-}
-
-export function formatServerBuildResult(
-  result: BuildServerBundleResult,
-  durationMs: number,
-): string {
-  const cyan = "\x1b[36m";
-  const dim = "\x1b[2m";
-  const green = "\x1b[32m";
-  const reset = "\x1b[0m";
-  // @wrapper-known semantic-alias
-  const mb = (bytes: number): string => (bytes / 1024 / 1024).toFixed(2);
-  const lines: string[] = [];
-  lines.push("");
-  lines.push(`  ${green}✓${reset} server bundle ${dim}(${durationMs}ms)${reset}`);
-  for (const entry of result.entries) {
-    lines.push(`    ${cyan}→${reset} ${entry.file}  ${mb(entry.sizeBytes)} MB`);
-  }
-  if (result.chunks.length > 0) {
-    const chunkBytes = result.chunks.reduce((sum, c) => sum + c.sizeBytes, 0);
-    lines.push(
-      `    ${cyan}→${reset} ${result.chunks.length} shared chunk(s)  ${mb(chunkBytes)} MB`,
-    );
-  }
-  const depCount = Object.keys(result.runtimeDeps).length;
-  lines.push(
-    `    ${dim}total: ${mb(result.totalBytes)} MB · runtime-deps: ${depCount} packages${reset}`,
-  );
-  return lines.join("\n");
-}

package/src/build.ts

@@ -1,28 +0,0 @@
-// Build-Toolchain Public-API. Eigener Sub-Path-Export `@cosmicdrift/kumiko-dev-server/build`
-// damit der Main-Barrel kein Bun-Toolchain-Bundle in Production-Reads zieht
-// (z.B. wenn drizzle-kit die App-Config unter Node lädt).
-
-export {
-  ASSETS_DIR,
-  type BuildManifest,
-  type BuildProdBundleOptions,
-  type BuildResult,
-  buildProdBundle,
-  type ClientEntry,
-  type ClientEntryDeclaration,
-  discoverHtmlTemplate,
-  formatBuildResult,
-  injectAssetTags,
-  readClientEntriesConfig,
-  resolveClientEntries,
-} from "@cosmicdrift/kumiko-server-runtime/build-prod-bundle";
-
-export {
-  type BuildServerBundleEntry,
-  type BuildServerBundleOptions,
-  type BuildServerBundleResult,
-  buildServerBundle,
-  discoverServerEntry,
-  formatServerBuildResult,
-  readExtraRuntimeExternals,
-} from "./build-server-bundle";

package/src/codegen/__tests__/render-codegen.test.ts

@@ -1,100 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import {
-  renderDefineFile,
-  renderInlineSchemasFile,
-  renderTypesAugmentation,
-  renderWriteHandlerTypes,
-} from "../render";
-import type { ScannedEvent } from "../scan-events";
-
-describe("renderTypesAugmentation", () => {
-  test("emits empty augmentation when no events", () => {
-    const out = renderTypesAugmentation([], "/tmp/app/.kumiko");
-    expect(out).toContain("interface KumikoEventTypeMap");
-    expect(out).toContain("no r.defineEvent calls discovered yet");
-  });
-});
-
-describe("renderInlineSchemasFile", () => {
-  test("returns undefined when no inline schemas", () => {
-    expect(renderInlineSchemasFile([], "/tmp/app")).toBeUndefined();
-  });
-
-  test("uses app-root-relative paths in source comments", () => {
-    const appRoot = mkdtempSync(join(tmpdir(), "kumiko-codegen-"));
-    const featurePath = join(appRoot, "src", "feature.ts");
-    mkdirSync(join(appRoot, "src"), { recursive: true });
-    writeFileSync(featurePath, "// stub", "utf-8");
-    const events: ScannedEvent[] = [
-      {
-        qualifiedName: "inventory:event:product-archived",
-        schemaSource: {
-          kind: "inline",
-          schemaSource: "z.object({ reason: z.string() })",
-          generatedConstName: "_kg_inventory__productArchived",
-        },
-        featureFilePath: featurePath,
-        source: { file: featurePath, line: 92 },
-      },
-    ];
-    const out = renderInlineSchemasFile(events, appRoot);
-    expect(out).toContain("// inventory:event:product-archived — from src/feature.ts:92");
-    expect(out).not.toContain(appRoot);
-  });
-
-  test("falls back to the bare filename when a feature file is outside the app root", () => {
-    // A bundled-feature file lives in node_modules, outside the app root —
-    // relative() would emit `../../..`. The comment falls back to basename.
-    const appRoot = join(tmpdir(), "kumiko-codegen-app");
-    const featurePath = join(tmpdir(), "node_modules", "pkg", "dist", "feature.ts");
-    const events: ScannedEvent[] = [
-      {
-        qualifiedName: "bundled:event:thing-happened",
-        schemaSource: {
-          kind: "inline",
-          schemaSource: "z.object({ id: z.string() })",
-          generatedConstName: "_kg_bundled__thingHappened",
-        },
-        featureFilePath: featurePath,
-        source: { file: featurePath, line: 7 },
-      },
-    ];
-    const out = renderInlineSchemasFile(events, appRoot);
-    expect(out).toContain("// bundled:event:thing-happened — from feature.ts:7");
-    expect(out).not.toContain("..");
-  });
-});
-
-describe("renderDefineFile", () => {
-  test("emits defineWriteHandler wrapper with type reference", () => {
-    const out = renderDefineFile();
-    expect(out).toContain("defineWriteHandler");
-    expect(out).toContain("types.generated.d.ts");
-  });
-
-  test("emits createTypedDispatcher when handler QNs provided", () => {
-    const out = renderDefineFile(["tenant:write:create", "tenant:write:update"]);
-    expect(out).toContain("export type TypedDispatcher");
-    expect(out).toContain("export function createTypedDispatcher");
-    expect(out).toContain('import type { WriteHandlerQn } from "./types.generated"');
-    expect(out).toContain("export type { WriteHandlerQn };");
-  });
-});
-
-describe("renderWriteHandlerTypes", () => {
-  test("emits union type lines", () => {
-    const out = renderWriteHandlerTypes(["tenant:write:create"]);
-    expect(out).toContain("export type WriteHandlerQn =");
-    expect(out).toContain('| "tenant:write:create"');
-  });
-
-  test("output does not depend on input order", () => {
-    const out = renderWriteHandlerTypes(["a:write:x", "b:write:y"]);
-
-    expect(renderWriteHandlerTypes(["b:write:y", "a:write:x"])).toBe(out);
-    expect(out.indexOf('| "a:write:x"')).toBeLessThan(out.indexOf('| "b:write:y"'));
-  });
-});