@cosmicdrift/kumiko-dev-server 0.353.0 → 0.354.0

package/bin/kumiko-build.ts

@@ -33,18 +33,34 @@ import {
 
 if (process.argv.slice(2).some((arg) => arg === "--help" || arg === "-h")) {
   process.stdout.write(
-    "Usage: kumiko-build [app-dir]   build client (dist/) and server (dist-server/) bundles\n",
+    "Usage: kumiko-build [--check] [app-dir]   build client (dist/) and server (dist-server/) bundles;\n" +
+      "       --check only verifies .kumiko/ is up to date (exit 1 on drift, writes nothing)\n",
   );
   process.exit(0);
 }
 
-const explicit = process.argv[2];
+const checkCodegenOnly = process.argv.includes("--check");
+const explicit = process.argv.slice(2).find((arg) => !arg.startsWith("-"));
 const cwd = explicit ? resolve(process.cwd(), explicit) : process.cwd();
 
 const red = "\x1b[31m";
 const yellow = "\x1b[33m";
 const reset = "\x1b[0m";
 
+if (checkCodegenOnly) {
+  const drift = runCodegen({ appRoot: cwd, checkOnly: true });
+  for (const w of drift.warnings) {
+    process.stderr.write(`${yellow}!${reset} [codegen] ${formatScanWarning(w)}\n`);
+  }
+  if (drift.didWriteTypes || drift.didWriteDefine || drift.didWriteSchemas) {
+    process.stderr.write(
+      `\n  ${red}✗${reset} .kumiko/ is stale; run kumiko-build or the dev-server and commit.\n\n`,
+    );
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
 try {
   // Read once up front — resolveClientEntries can throw (mutual exclusion,
   // malformed declaration, unmigrated legacy client-*.tsx files) and that

package/dist/codegen/run-codegen.d.ts

@@ -7,6 +7,9 @@ export type CodegenOptions = {
      *  Die Dev-Server-Integration übergibt die QNs direkt aus der gebooteten
      *  Registry — CLI ruft sie aus dem Manifest. */
     readonly handlerQns?: readonly string[];
+    /** Drift check for CI: nothing is written or removed; the `didWrite*` flags
+     *  report which files would have changed. */
+    readonly checkOnly?: boolean;
 };
 export type CodegenResult = {
     readonly outputDir: string;

package/dist/codegen/run-codegen.js

@@ -44,7 +44,9 @@ export function runCodegen(opts) {
             skipped: true,
         };
     }
-    mkdirSync(outputDir, { recursive: true });
+    const checkOnly = opts.checkOnly === true;
+    if (!checkOnly)
+        mkdirSync(outputDir, { recursive: true });
     const typesContent = renderTypesAugmentation(scan.events, outputDir);
     // `opts.handlerQns` undefined means the caller (kumiko-build) has no
     // live feature registry to draw from and relies on the manifest
@@ -82,12 +84,12 @@ export function runCodegen(opts) {
     const finalDefineContent = shouldPreserveStaleBlock
         ? withPreservedBlock(defineContent, definePath, TYPED_DISPATCHER_MARKER, LEGACY_TYPED_DISPATCHER_ANCHOR)
         : defineContent;
-    const didWriteTypes = writeIfChanged(typesPath, finalTypesContent);
-    const didWriteDefine = writeIfChanged(definePath, finalDefineContent);
-    writeIfChanged(packageJsonPath, packageJsonContent);
+    const didWriteTypes = writeIfChanged(typesPath, finalTypesContent, checkOnly);
+    const didWriteDefine = writeIfChanged(definePath, finalDefineContent, checkOnly);
+    writeIfChanged(packageJsonPath, packageJsonContent, checkOnly);
     const didWriteSchemas = schemasContent !== undefined
-        ? writeIfChanged(schemasPath, schemasContent)
-        : removeIfExists(schemasPath);
+        ? writeIfChanged(schemasPath, schemasContent, checkOnly)
+        : removeIfExists(schemasPath, checkOnly);
     const warnings = shouldPreserveStaleBlock
         ? [
             ...scan.warnings,
@@ -144,11 +146,12 @@ function renderKumikoPackageJson() {
  * must NOT trigger a full TS-language-server rebuild (which would
  * happen on every mtime change).
  */
-function writeIfChanged(path, content) {
+function writeIfChanged(path, content, checkOnly) {
     const existing = readExistingOrUndefined(path);
     if (existing === content)
         return false;
-    writeFileSync(path, content, "utf-8");
+    if (!checkOnly)
+        writeFileSync(path, content, "utf-8");
     return true;
 }
 function readExistingOrUndefined(path) {
@@ -192,10 +195,11 @@ function extractBlock(content, anchor) {
  * produces it (e.g. the last inline-schema was refactored to a named
  * export). Returns true when an actual unlink happened.
  */
-function removeIfExists(path) {
+function removeIfExists(path, checkOnly) {
     if (!existsSync(path))
         return false;
-    rmSync(path, { force: true });
+    if (!checkOnly)
+        rmSync(path, { force: true });
     return true;
 }
 const featureManifestSchema = z.object({

package/dist/create-kumiko-server.d.ts

@@ -201,6 +201,7 @@ export type KumikoServerHandle = {
 };
 export declare const STYLESHEET_WATCH_ENV = "KUMIKO_DEV_STYLESHEET_WATCH";
 export declare const PROD_BUNDLES_ENV = "KUMIKO_DEV_PROD_BUNDLES";
+export declare const DEFAULT_HTML = "<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width,initial-scale=1,interactive-widget=resizes-content\" />\n    <title>Kumiko</title>\n  </head>\n  <body>\n    <div id=\"root\"></div>\n    <script type=\"module\" src=\"/client.js\"></script>\n  </body>\n</html>\n";
 type DirectoryWatchEvents = (dir: string, options: {
     readonly recursive: true;
     readonly signal: AbortSignal;

package/dist/create-kumiko-server.js

@@ -93,7 +93,7 @@ const RELOAD_SNIPPET = `
 // keyboard shrinks only the visual viewport, not the layout viewport that
 // `position: fixed` anchors to — a fixed bottom action bar would stay
 // pinned behind the keyboard instead of above it.
-const DEFAULT_HTML = `<!doctype html>
+export const DEFAULT_HTML = `<!doctype html>
 <html lang="en">
   <head>
     <meta charset="utf-8" />
@@ -755,6 +755,7 @@ export async function createKumikoServer(options) {
                 path: url.pathname,
                 host,
                 systemQuery: buildDevSystemQuery(req, socketAddress),
+                requestSignal: req.signal,
             });
         }
         return new Response(html, { status, headers });

package/dist/run-dev-app.js

@@ -165,6 +165,7 @@ export async function runDevApp(options) {
             registry: deps.registry,
             hasAuth: false,
             sseBroker: deps.sseBroker,
+            redis: deps.redis,
             crypto: bootCrypto,
             ...(bootLogger && { log: bootLogger }),
         });

package/dist/scaffold-feature.js

@@ -155,7 +155,7 @@ function starterPatterns() {
             entityName: "item",
             definition: {
                 fields: {
-                    title: { type: "text", required: true },
+                    title: { type: "text", required: true, allowPlaintext: "is_business_data" },
                 },
             },
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.353.0",
+  "version": "0.354.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.353.0",
-    "@cosmicdrift/kumiko-framework": "0.353.0",
-    "@cosmicdrift/kumiko-headless": "0.353.0",
-    "@cosmicdrift/kumiko-renderer-web": "0.353.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.353.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.354.0",
+    "@cosmicdrift/kumiko-framework": "0.354.0",
+    "@cosmicdrift/kumiko-headless": "0.354.0",
+    "@cosmicdrift/kumiko-renderer-web": "0.354.0",
+    "@cosmicdrift/kumiko-server-runtime": "0.354.0",
     "bun-types": "^1.3.13",
     "ts-morph": "^28.0.0",
     "zod": "^4.4.3"

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.354.0",
+    "type": "fix",
+    "title": "Dev boot passes Redis to the delivery service so notify idempotencyKey dedupes",
+    "migration": "No action needed."
+  },
   {
     "version": "0.353.0",
     "type": "fix",