@cosmicdrift/kumiko-dev-server 0.290.0 → 0.292.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.290.0",
+  "version": "0.292.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>",
@@ -59,10 +59,10 @@
     "kumiko-upgrade": "./bin/kumiko-upgrade.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.290.0",
-    "@cosmicdrift/kumiko-framework": "0.290.0",
-    "@cosmicdrift/kumiko-headless": "0.290.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.290.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.292.0",
+    "@cosmicdrift/kumiko-framework": "0.292.0",
+    "@cosmicdrift/kumiko-headless": "0.292.0",
+    "@cosmicdrift/kumiko-server-runtime": "0.292.0",
     "ts-morph": "^28.0.0"
   },
   "publishConfig": {

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.291.0",
+    "type": "fix",
+    "title": "renderWriteHandlerTypes emits the WriteHandlerQn union in stable order",
+    "detail": "`renderWriteHandlerTypes` now sorts `handlerQns` before rendering, like its sibling renderers in the same file. The dev-server passes registration order (`collectWriteHandlerQns`) while the CLI/build path passes manifest order, so the same feature set produced a differently ordered `WriteHandlerQn` union in `.kumiko/define.ts` and `.kumiko/types.generated.d.ts` depending on which one ran last. Consumer apps that commit those generated files no longer get order-only diffs after a local `bun dev`."
+  },
   {
     "version": "0.289.0",
     "type": "improvement",

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

@@ -90,4 +90,11 @@ describe("renderWriteHandlerTypes", () => {
     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"'));
+  });
 });

package/src/codegen/render.ts

@@ -296,7 +296,9 @@ export function renderDefineFile(handlerQns: readonly string[] = []): string {
 export function renderWriteHandlerTypes(handlerQns: readonly string[]): string {
   if (handlerQns.length === 0) return "";
 
-  const lines = handlerQns.map((qn) => `  | "${qn}"`);
+  // Stable order — callers pass registration order (dev-server) or manifest
+  // order (CLI); bare sort keeps both byte-identical.
+  const lines = [...handlerQns].sort().map((qn) => `  | "${qn}"`);
   return ["", WRITE_HANDLER_QN_MARKER, `export type WriteHandlerQn =`, ...lines, ";", ""].join(
     "\n",
   );

package/src/run-dev-app.ts

@@ -58,11 +58,14 @@ import {
   createRegistry,
   type EffectiveFeaturesResolver,
   type FeatureDefinition,
+  FILE_STORAGE_PROVIDER_BOOT_SENTINEL,
+  FILE_STORAGE_PROVIDER_ENV,
   findTierResolverUsage,
   type Registry,
   type SessionUser,
   type TenantId,
   type TierResolverPlugin,
+  type ValidateBootOptions,
   validateAppCustomScreenWriteQns,
   validateBoot,
 } from "@cosmicdrift/kumiko-framework/engine";
@@ -171,6 +174,8 @@ export type RunDevAppOptions = {
    *  auth-email-password automatisch dazu gemischt — KEIN doppeltes
    *  manuelles Hinzufügen nötig. */
   readonly features: readonly FeatureDefinition[];
+  /** Opt-in boot-validator warnings — see ValidateBootOptions. */
+  readonly validateBootOptions?: ValidateBootOptions;
   /** Pfad zum Browser-Entry-Modul. Bun.build bündelt es zu /client.js.
    *  Mutually exclusive mit `clientEntries`. */
   readonly clientEntry?: string;
@@ -286,9 +291,9 @@ export async function runDevApp(options: RunDevAppOptions): Promise<KumikoServer
   // permanent process.env mutation, so a second runDevApp call in the same
   // process (no files this time) doesn't fall through the gate falsely.
   const setFileStorageProviderEnv =
-    options.files !== undefined && process.env["FILE_STORAGE_PROVIDER"] === undefined;
+    options.files !== undefined && process.env[FILE_STORAGE_PROVIDER_ENV] === undefined;
   if (setFileStorageProviderEnv) {
-    process.env["FILE_STORAGE_PROVIDER"] = "configured";
+    process.env[FILE_STORAGE_PROVIDER_ENV] = FILE_STORAGE_PROVIDER_BOOT_SENTINEL;
   }
 
   // Boot-Validation als allererstes — vor fs-Watcher und Server. Dieselbe
@@ -297,9 +302,9 @@ export async function runDevApp(options: RunDevAppOptions): Promise<KumikoServer
   // CrashLoopBackOff sterben ließ (#359). Wirft synchron, bevor ein
   // Socket oder Watcher (codegen-Write) aufgeht.
   try {
-    validateBoot(features);
+    validateBoot(features, options.validateBootOptions);
   } finally {
-    if (setFileStorageProviderEnv) delete process.env["FILE_STORAGE_PROVIDER"];
+    if (setFileStorageProviderEnv) delete process.env[FILE_STORAGE_PROVIDER_ENV];
   }
   warnIfNonUtcServerTimeZone();
   validateAppCustomScreenWriteQns(process.cwd(), collectWriteHandlerQns(features));