@cosmicdrift/kumiko-dev-server 0.339.0 → 0.341.0

package/dist/build-server-bundle.d.ts

@@ -15,7 +15,7 @@ export type BuildServerBundleEntry = {
 };
 export type BuildServerBundleResult = {
     readonly outDir: string;
-    /** Benannte Entry-Files (server.js, ggf. kumiko.js). */
+    /** Named entry files (server.js, plus kumiko.js, worker.js and bootstrap.js when present). */
     readonly entries: readonly BuildServerBundleEntry[];
     /** Geteilte Framework-Chunks (von splitting). */
     readonly chunks: readonly BuildServerBundleEntry[];

package/dist/build-server-bundle.js

@@ -8,18 +8,23 @@
 //   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)
+//   bin/worker.ts          →  dist-server/worker.js   (optional, next to bin/main.ts:
+//                             background worker as its own process from the same image)
+//   bin/bootstrap.ts       →  dist-server/bootstrap.js (optional, next to bin/main.ts:
+//                             one-shot runBootstrap provisioning, run as a k8s Job)
 //   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).
+// All entries are built in ONE Bun.build call with `splitting`: the framework
+// lands once as shared chunk-*.js and server.js, kumiko.js, worker.js and
+// bootstrap.js are thin entries importing it. Separate bundles would inline ~14 MB per entry.
 //
 // Output:
 //
 //   dist-server/
 //     server.js            ← App-Boot-Entry
 //     kumiko.js            ← Migrate-CLI-Entry (wenn bin/kumiko.ts gefunden)
+//     worker.js            ← worker entry (if bin/worker.ts sits next to main.ts)
+//     bootstrap.js         ← provisioning entry (if bin/bootstrap.ts sits next to main.ts)
 //     chunk-*.js           ← geteilte Framework-Chunks
 //     package.json         ← runtime-deps mit gepinnten Versionen
 //
@@ -105,7 +110,10 @@ export async function buildServerBundle(options = {}) {
     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 optionalSiblingEntries = ["worker.ts", "bootstrap.ts"]
+        .map((file) => join(dirname(serverEntry), file))
+        .filter((path) => existsSync(path));
+    const entrypoints = [serverEntry, ...(kumikoCli ? [kumikoCli] : []), ...optionalSiblingEntries];
     const result = await Bun.build({
         entrypoints,
         outdir: outDir,

package/dist/codegen/watch.d.ts

@@ -25,6 +25,11 @@ export type WatchHandle = {
     /** Beendet den Watcher. Idempotent — mehrfacher Aufruf ist no-op. */
     readonly close: () => void;
 };
+/** Whether a change to `filename` (relative to `src/`, posix or windows
+ *  separators) can affect codegen output: production .ts/.tsx sources
+ *  outside the skipped dirs, excluding .d.ts (mostly written by codegen
+ *  itself) and test files. */
+export declare function isCodegenRelevantChange(filename: string): boolean;
 /**
  * Startet den Watcher. Beim Boot fährt einmalig `runCodegen` (sodass
  * die generated Files sofort frisch sind), dann hängt sich an `fs.watch`

package/dist/codegen/watch.js

@@ -19,6 +19,20 @@ import { runCodegen } from "./run-codegen.js";
 import { formatScanWarning } from "./scan-events.js";
 const SKIP_SUBSTRINGS = ["/node_modules/", "/.kumiko/", "/dist/", "/dist-server/", "/__tests__/"];
 const DEFAULT_DEBOUNCE_MS = 50;
+/** Whether a change to `filename` (relative to `src/`, posix or windows
+ *  separators) can affect codegen output: production .ts/.tsx sources
+ *  outside the skipped dirs, excluding .d.ts (mostly written by codegen
+ *  itself) and test files. */
+export function isCodegenRelevantChange(filename) {
+    const normalised = `/${filename.replace(/\\/g, "/")}`;
+    if (SKIP_SUBSTRINGS.some((seg) => normalised.includes(seg)))
+        return false;
+    if (!normalised.endsWith(".ts") && !normalised.endsWith(".tsx"))
+        return false;
+    if (normalised.endsWith(".d.ts"))
+        return false;
+    return !normalised.endsWith(".test.ts") && !normalised.endsWith(".test.tsx");
+}
 /**
  * Startet den Watcher. Beim Boot fährt einmalig `runCodegen` (sodass
  * die generated Files sofort frisch sind), dann hängt sich an `fs.watch`
@@ -65,22 +79,8 @@ export function watchAndRegenerate(opts) {
             // skip: watcher closed or no filename reported, nothing to act on
             if (closed || !filename)
                 return;
-            // node liefert filename relativ zu srcDir, kann aber posix oder
-            // windows-style separators haben. Wir prüfen substring-tolerant.
-            const normalised = `/${filename.toString().replace(/\\/g, "/")}`;
-            // skip: path matches an excluded segment (node_modules/dist/etc.)
-            if (SKIP_SUBSTRINGS.some((seg) => normalised.includes(seg)))
-                return;
-            // skip: Nur .ts/.tsx interessieren — alles andere (CSS, MD, JSON) hat
-            // keinen Einfluss auf r.defineEvent-Calls.
-            if (!normalised.endsWith(".ts") && !normalised.endsWith(".tsx"))
-                return;
-            // skip: .d.ts ausgenommen — die kommen meistens vom codegen selbst.
-            if (normalised.endsWith(".d.ts"))
-                return;
-            // skip: .test.ts/.test.tsx ausgenommen — Tests definieren keine
-            // Production-Features.
-            if (normalised.endsWith(".test.ts") || normalised.endsWith(".test.tsx"))
+            // skip: change cannot affect r.defineEvent calls
+            if (!isCodegenRelevantChange(filename.toString()))
                 return;
             if (timer)
                 clearTimeout(timer);

package/dist/run-dev-app.js

@@ -312,6 +312,7 @@ export async function runDevApp(options) {
                 tierResolverHolder.resolver = await plugin.build({
                     db: stack.db,
                     registry: stack.registry,
+                    cacheSync: stack.cacheSync,
                 });
             }
             if (effectiveAuth && stack.registry.getExtensionUsages(EXT_SESSION_STORE).length > 0) {

package/dist/scaffold-deploy.d.ts

@@ -41,11 +41,6 @@ export type ScaffoldDeployDetected = {
      *  `package.json#kumiko.deploy.dbUser`, default = appName. The db name
      *  always stays appName regardless of this value. */
     readonly dbUser: string;
-    /** How migrate-step.sh locates the compose `_stack` network — from
-     *  `package.json#kumiko.deploy.stackNetwork`. "discover" (default):
-     *  today's `docker network ls` heuristic. "directory": the exact name
-     *  `$(basename "$PWD")_stack`, checked via `docker network inspect`. */
-    readonly stackNetwork: "discover" | "directory";
 };
 export type ScaffoldedFile = {
     readonly path: string;

package/dist/scaffold-deploy.js

@@ -60,8 +60,6 @@ export function renderDeployFiles(options) {
         hasPrivateGhPackages: detected.hasPrivateGhPackages,
         installFromFullTree: detected.installFromFullTree,
         installFromManifests: !detected.installFromFullTree,
-        stackNetworkDiscover: detected.stackNetwork === "discover",
-        stackNetworkDirectory: detected.stackNetwork === "directory",
         customDbUser: detected.dbUser !== options.appName,
     };
     const dir = templatesDir();
@@ -140,7 +138,14 @@ const DB_USER_RE = /^[a-zA-Z0-9_][a-zA-Z0-9_-]{0,62}$/;
 const kumikoDeployConfigSchema = z
     .object({
     dbUser: z.string().regex(DB_USER_RE).optional(),
-    stackNetwork: z.enum(["discover", "directory"]).optional(),
+    // "directory" is the only behaviour left; the key stays valid so existing
+    // package.json files keep scaffolding.
+    stackNetwork: z
+        .string()
+        .refine((value) => value === "directory", {
+        message: 'the stackNetwork option was removed: migrate-step.sh always uses the exact "<dirname>_stack" network (COMPOSE_PROJECT_NAME or directory name). Delete the option or set it to "directory"',
+    })
+        .optional(),
 })
     .strict();
 /** `package.json#kumiko.deploy` must be well-formed — silently falling back
@@ -175,7 +180,7 @@ function resolveDeployConfig(deployConfigRaw, appName) {
         }
         throw new Error(`scaffoldDeploy: invalid package.json#kumiko.deploy.dbUser — effective value "${dbUser}" (defaulted from appName) does not match ${DB_USER_RE}`);
     }
-    return { dbUser, stackNetwork: config.stackNetwork ?? "discover" };
+    return { dbUser };
 }
 function detectOptionalSurfaces(sourceDir, appName) {
     const hasSeeds = existsSync(join(sourceDir, "seeds"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.339.0",
+  "version": "0.341.0",
   "description": "Dev-tooling for Kumiko apps: local dev-server bootstrap (runDevApp), scaffolding, codegen. Its compose-stacks/env-schema subpaths are consumed at prod boot too — see @cosmicdrift/kumiko-server-runtime for the prod runner itself.",
   "license": "BUSL-1.1",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -64,11 +64,11 @@
     "kumiko-upgrade": "./bin/kumiko-upgrade.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.339.0",
-    "@cosmicdrift/kumiko-framework": "0.339.0",
-    "@cosmicdrift/kumiko-headless": "0.339.0",
-    "@cosmicdrift/kumiko-renderer-web": "0.339.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.339.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.341.0",
+    "@cosmicdrift/kumiko-framework": "0.341.0",
+    "@cosmicdrift/kumiko-headless": "0.341.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.341.0",
+    "@cosmicdrift/kumiko-server-runtime": "0.341.0",
     "bun-types": "^1.3.13",
     "ts-morph": "^28.0.0",
     "zod": "^4.4.3"

package/src/changes.json

@@ -1,4 +1,27 @@
 [
+  {
+    "version": "0.341.0",
+    "type": "improvement",
+    "title": "buildServerBundle bundles bin/bootstrap.ts to dist-server/bootstrap.js when present"
+  },
+  {
+    "version": "0.341.0",
+    "type": "fix",
+    "title": "Codegen watcher change filter is a tested pure predicate"
+  },
+  {
+    "version": "0.341.0",
+    "type": "breaking",
+    "title": "Deploy migrate-step.sh always uses the exact stack network",
+    "detail": "The discover variant (docker network ls | head -1) could pick another compose project's network on a shared host. The script now uses COMPOSE_PROJECT_NAME or the directory name plus _stack.",
+    "migration": "Remove package.json kumiko.deploy.stackNetwork (or set it to \"directory\"), then re-run scaffoldDeploy. If the deploy directory name differs from the compose project, set COMPOSE_PROJECT_NAME for migrate-step.sh."
+  },
+  {
+    "version": "0.340.0",
+    "type": "improvement",
+    "title": "Server bundle includes an optional worker entry",
+    "detail": "When `bin/worker.ts` sits next to `bin/main.ts`, `buildServerBundle` builds it in the same split build as `dist-server/worker.js`. Start a separate worker process from the same image with `exec bun run worker.js`."
+  },
   {
     "version": "0.338.0",
     "type": "fix",

package/templates/deploy/migrate-step.sh.template

@@ -10,29 +10,11 @@
 # changes BEFORE the app container starts — runProdApp's boot gate would
 # otherwise abort with SchemaDriftError.
 #
-{{#stackNetworkDiscover}}
-# Network discovery: the _stack network is named `<dirname>_stack`
-# (compose convention). We discover it via `docker network ls` instead
-# of hard-coding.
-{{/stackNetworkDiscover}}
-{{#stackNetworkDirectory}}
 # Network: the exact `<dirname>_stack` name of the compose project this
-# script runs in (package.json#kumiko.deploy.stackNetwork = "directory").
-{{/stackNetworkDirectory}}
+# script runs in — never another project's network on a shared host.
 
 set -euo pipefail
 
-{{#stackNetworkDiscover}}
-# `|| true` keeps `set -e`/`pipefail` from aborting the script when `grep`
-# finds no match (exit 1) — the empty-check below owns that case and prints
-# the actionable hint instead of a bare pipefail abort.
-STACK_NETWORK=$(docker network ls --format "{{.Name}}" | grep -E "_stack$" | head -1 || true)
-if [ -z "$STACK_NETWORK" ]; then
-  echo "No _stack network found — compose project not running?" >&2
-  exit 1
-fi
-{{/stackNetworkDiscover}}
-{{#stackNetworkDirectory}}
 # Compose lowercases the project name and drops characters outside [a-z0-9_-].
 COMPOSE_PROJECT="${COMPOSE_PROJECT_NAME:-$(basename "$PWD" | tr '[:upper:]' '[:lower:]' | tr -cd 'a-z0-9_-')}"
 STACK_NETWORK="${COMPOSE_PROJECT}_stack"
@@ -40,7 +22,6 @@ if ! docker network inspect "$STACK_NETWORK" >/dev/null 2>&1; then
   echo "Stack network '$STACK_NETWORK' not found (derived from COMPOSE_PROJECT_NAME or the directory name '$(basename "$PWD")') — compose project not running?" >&2
   exit 1
 fi
-{{/stackNetworkDirectory}}
 
 # Import .env as bash env. `set -a` marks subsequent variable assignments
 # as auto-export. Bash's built-in parser respects quotes/escapes like