@cosmicdrift/kumiko-dev-server 0.394.0 → 0.395.0

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

@@ -1,4 +1,5 @@
 /// <reference types="bun-types" preserve="true" />
+import type { RedisSseBroker } from "@cosmicdrift/kumiko-framework/api";
 import type { TestStack } from "@cosmicdrift/kumiko-testing/stack";
 import type { DevDbMode, DevJobRunners } from "./create-kumiko-server-stack.ts";
 import { type BunServer } from "./dev-server-runtime.ts";
@@ -9,6 +10,7 @@ export type DevServerStopDeps = {
     readonly stack: TestStack;
     readonly devJobRunners: DevJobRunners;
     readonly dbMode: DevDbMode;
+    readonly ownedRedisSseBroker: RedisSseBroker | undefined;
 };
 export declare function createDevServerStop(deps: DevServerStopDeps): () => Promise<void>;
 export declare function installDevSignalHandlers(stop: () => Promise<void>): void;

package/dist/create-kumiko-server-shutdown.js

@@ -23,7 +23,7 @@ async function deleteEphemeralJobQueues(raw, jobQueueNamePrefix) {
     }
 }
 export function createDevServerStop(deps) {
-    const { watcherAbort, killTailwind, server, stack, devJobRunners, dbMode } = deps;
+    const { watcherAbort, killTailwind, server, stack, devJobRunners, dbMode, ownedRedisSseBroker } = deps;
     return async () => {
         // Stop the watcher first so no onChange callback runs during teardown;
         // otherwise removing the temporary directory could trigger process.exit(75).
@@ -37,6 +37,7 @@ export function createDevServerStop(deps) {
             await stack.eventDispatcher.stop();
         }
         await devJobRunners.stop();
+        await ownedRedisSseBroker?.close();
         const rawRedis = dbMode.persistentDb
             ? undefined
             : stack.redis.redis.duplicate({ keyPrefix: "" });

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

@@ -1,3 +1,4 @@
+import { type RedisSseBroker } from "@cosmicdrift/kumiko-framework/api";
 import { startDevJobRunners } from "@cosmicdrift/kumiko-server-runtime/boot/job-run-logger";
 import { type TestStack } from "@cosmicdrift/kumiko-testing/stack";
 import type { CreateKumikoServerOptions } from "./create-kumiko-server.ts";
@@ -5,8 +6,13 @@ export type DevDbMode = {
     readonly devDbName: string | undefined;
     readonly persistentDb: boolean;
     readonly jobQueueNamePrefix: string;
+    readonly sseChannelPrefix: string;
 };
 export type DevJobRunners = Awaited<ReturnType<typeof startDevJobRunners>>;
 export declare function resolveDevDbMode(processEnv: Record<string, string | undefined>): DevDbMode;
-export declare function bootDevStack(options: CreateKumikoServerOptions, dbMode: DevDbMode): Promise<TestStack>;
+export type DevStackBoot = {
+    readonly stack: TestStack;
+    readonly ownedRedisSseBroker: RedisSseBroker | undefined;
+};
+export declare function bootDevStack(options: CreateKumikoServerOptions, dbMode: DevDbMode): Promise<DevStackBoot>;
 export declare function startDevBackgroundRunners(stack: TestStack, jobQueueNamePrefix: string): Promise<DevJobRunners>;

package/dist/create-kumiko-server-stack.js

@@ -1,4 +1,5 @@
 import { resolveAnonymousAccessFromRegistry } from "@cosmicdrift/kumiko-bundled-features/auth-foundation";
+import { createDefaultSseBroker, } from "@cosmicdrift/kumiko-framework/api";
 import { createEventsTable } from "@cosmicdrift/kumiko-framework/event-store";
 import { createMetricsForFactory } from "@cosmicdrift/kumiko-framework/observability";
 import { startDevJobRunners } from "@cosmicdrift/kumiko-server-runtime/boot/job-run-logger";
@@ -22,11 +23,15 @@ export function resolveDevDbMode(processEnv) {
     const jobQueueNamePrefix = persistentDb
         ? `kumiko-dev-${devDbName}`
         : `kumiko-dev-${crypto.randomUUID()}`;
-    return { devDbName, persistentDb, jobQueueNamePrefix };
+    // Pub/Sub ignores the DB index, so the SSE channels need the same per-boot
+    // isolation as the queues; an explicit env value wins so a worker can be pointed at it.
+    const sseChannelPrefix = processEnv["KUMIKO_REDIS_CHANNEL_PREFIX"]?.trim() || jobQueueNamePrefix;
+    return { devDbName, persistentDb, jobQueueNamePrefix, sseChannelPrefix };
 }
-function buildDevStackOptions(options, dbMode) {
+function buildDevStackOptions(options, dbMode, sseBroker) {
     return {
         features: options.features,
+        sseBroker,
         ...(dbMode.persistentDb && { dbName: dbMode.devDbName, persistentDb: true }),
         ...(options.auth !== undefined && { authConfig: options.auth }),
         ...(options.extraContext !== undefined && { extraContext: options.extraContext }),
@@ -48,9 +53,23 @@ function buildDevStackOptions(options, dbMode) {
 }
 export async function bootDevStack(options, dbMode) {
     logInfo(`[kumiko-server] booting Kumiko stack${dbMode.persistentDb ? ` — persistent DB "${dbMode.devDbName}"` : " — ephemeral test DB"}…`);
-    const stack = await setupTestStack(buildDevStackOptions(options, dbMode));
-    await createEventsTable(stack.unscopedDb);
-    await pushEntityProjectionTables(stack, stack.registry);
+    // setupTestStack defaults to an in-memory broker, which would make this
+    // process ignore Redis: live signals published by a separate worker process
+    // would then never reach the browsers connected here.
+    const { sseBroker, ownedRedisSseBroker } = createDefaultSseBroker({
+        ...process.env,
+        KUMIKO_REDIS_CHANNEL_PREFIX: dbMode.sseChannelPrefix,
+    });
+    let stack;
+    try {
+        stack = await setupTestStack(buildDevStackOptions(options, dbMode, sseBroker));
+        await createEventsTable(stack.unscopedDb);
+        await pushEntityProjectionTables(stack, stack.registry);
+    }
+    catch (err) {
+        await ownedRedisSseBroker?.close();
+        throw err;
+    }
     // `extraRoutes` is already mounted by setupTestStack's buildServer();
     // `wire` is for co-running components that need the system-write
     // dispatcher but don't declare a route.
@@ -73,7 +92,7 @@ export async function bootDevStack(options, dbMode) {
     if (options.onAfterSetup !== undefined) {
         await options.onAfterSetup(stack);
     }
-    return stack;
+    return { stack, ownedRedisSseBroker };
 }
 // setupTestStack configures but does not start the event dispatcher so
 // integration tests can drain it deterministically with runOnce(). The dev

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

@@ -203,5 +203,8 @@ export type KumikoServerHandle = {
     /** BullMQ queue-name prefix of this boot: per-boot in ephemeral mode, so
      *  its `bull:<prefix>-*` keys belong to this server alone on a shared Redis. */
     readonly jobQueueNamePrefix: string;
+    /** KUMIKO_REDIS_CHANNEL_PREFIX value of this boot's SSE broker; a separate worker
+     *  must set the same value for its live signals to reach this server. */
+    readonly sseChannelPrefix: string;
 };
 export declare function createKumikoServer(options: CreateKumikoServerOptions): Promise<KumikoServerHandle>;

package/dist/create-kumiko-server.js

@@ -47,7 +47,7 @@ export async function createKumikoServer(options) {
     const stylesheet = await startDevStylesheet(options);
     const templates = await loadHtmlTemplates(entries, options.htmlPath);
     const dbMode = resolveDevDbMode(process.env);
-    const stack = await bootDevStack(options, dbMode);
+    const { stack, ownedRedisSseBroker } = await bootDevStack(options, dbMode);
     const devJobRunners = await startDevBackgroundRunners(stack, dbMode.jobQueueNamePrefix);
     // Built once purely to surface authoring warnings (settings-hub placement
     // etc.) at the same point prod would; clients fetch the schema themselves
@@ -75,6 +75,7 @@ export async function createKumikoServer(options) {
         stack,
         devJobRunners,
         dbMode,
+        ownedRedisSseBroker,
     });
     startDevFileWatchers({
         entries,
@@ -94,5 +95,12 @@ export async function createKumikoServer(options) {
                 ? ` (hot reload on ${entries.length === 1 ? "client entry" : `${entries.length} entries`})`
                 : ""));
     }
-    return { fetch: handleFetch, server, stack, stop, jobQueueNamePrefix: dbMode.jobQueueNamePrefix };
+    return {
+        fetch: handleFetch,
+        server,
+        stack,
+        stop,
+        jobQueueNamePrefix: dbMode.jobQueueNamePrefix,
+        sseChannelPrefix: dbMode.sseChannelPrefix,
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-dev-server",
-  "version": "0.394.0",
+  "version": "0.395.0",
   "description": "Dev-tooling for Kumiko apps: local dev-server bootstrap (runDevApp), scaffolding. Its compose-stacks/env-schema subpaths are consumed at prod boot too — see @cosmicdrift/kumiko-server-runtime for the prod runner itself.",
   "license": "MIT",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -77,15 +77,15 @@
     "kumiko-upgrade": "./bin/kumiko-upgrade.ts"
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-bundled-features": "0.394.0",
-    "@cosmicdrift/kumiko-feature-ast": "0.394.0",
-    "@cosmicdrift/kumiko-framework": "0.394.0",
-    "@cosmicdrift/kumiko-renderer": "0.394.0",
-    "@cosmicdrift/kumiko-renderer-mail-html": "0.394.0",
-    "@cosmicdrift/kumiko-guards": "0.394.0",
-    "@cosmicdrift/kumiko-server-runtime": "0.394.0",
-    "@cosmicdrift/kumiko-testing": "0.394.0",
-    "@cosmicdrift/kumiko-types": "0.394.0",
+    "@cosmicdrift/kumiko-bundled-features": "0.395.0",
+    "@cosmicdrift/kumiko-feature-ast": "0.395.0",
+    "@cosmicdrift/kumiko-framework": "0.395.0",
+    "@cosmicdrift/kumiko-renderer": "0.395.0",
+    "@cosmicdrift/kumiko-renderer-mail-html": "0.395.0",
+    "@cosmicdrift/kumiko-guards": "0.395.0",
+    "@cosmicdrift/kumiko-server-runtime": "0.395.0",
+    "@cosmicdrift/kumiko-testing": "0.395.0",
+    "@cosmicdrift/kumiko-types": "0.395.0",
     "ts-morph": "^28.0.0",
     "zod": "^4.6.7"
   },

package/src/changes.json

@@ -1,4 +1,10 @@
 [
+  {
+    "version": "0.395.0",
+    "type": "fix",
+    "title": "Live updates from a separate worker process reach the dev-server browser",
+    "detail": "The dev server always used an in-memory SSE broker, so it never subscribed to Redis. When a separate worker process won the shared event cursor it published live signals to Redis, and they never reached the browser. The dev server now uses the Redis-backed broker when REDIS_URL is set, and setupTestStack accepts an optional sseBroker. Its channels are prefixed per boot (KUMIKO_REDIS_CHANNEL_PREFIX if set, otherwise derived from the dev DB mode), so parallel dev servers on one Redis stay apart; a separate worker must set the same KUMIKO_REDIS_CHANNEL_PREFIX (the handle exposes it as sseChannelPrefix)."
+  },
   {
     "version": "0.394.0",
     "type": "improvement",