@jxsuite/server 4.5.0 → 4.5.1

package/src/site-output.ts

@@ -29,6 +29,8 @@
 
 import { existsSync, readFileSync, statSync } from "node:fs";
 import { join, resolve } from "node:path";
+import { isJsonObject, isString } from "@jxsuite/schema/guards";
+import type { JsonValue } from "@jxsuite/schema/types";
 
 import { serveContained } from "./net-guard.ts";
 
@@ -60,11 +62,15 @@ export function siteOutDir(projectRoot: string): string | null {
   }
   let outDir: string | null = null;
   try {
-    const config = JSON.parse(readFileSync(configPath, "utf8")) as {
-      build?: { outDir?: unknown };
-    };
-    const declared = config.build?.outDir;
-    outDir = resolve(projectRoot, typeof declared === "string" && declared ? declared : "dist");
+    // SAFETY: JSON.parse without a reviver only ever yields a JSON value; its `any` says no more.
+    const config = JSON.parse(readFileSync(configPath, "utf8")) as JsonValue;
+    const build = isJsonObject(config) ? config.build : undefined;
+    const declared = isJsonObject(build) ? build.outDir : undefined;
+    // A `null` document has no settings to read at all, so it declines like an unparseable one.
+    outDir =
+      config === null
+        ? null
+        : resolve(projectRoot, isString(declared) && declared ? declared : "dist");
   } catch {
     // An unparseable project.json is the editor's problem to report, not this server's to guess
     // At. No output directory means this fallback simply declines, and the request 404s as before.

package/src/sse.ts

@@ -21,6 +21,9 @@
  * open, dropped on cancel — so a broadcast after a tab closes reaches nobody rather than throwing.
  */
 
+import type { JsonValue } from "@jxsuite/schema/types";
+import type { FsEventPayload } from "./refactor/fs-events.ts";
+
 /**
  * Reconnection time advertised on the stream, in milliseconds (HTML Standard, `retry:`).
  *
@@ -32,6 +35,17 @@ export const RECONNECT_MS = 500;
 /** How often a comment frame is sent to keep an idle connection from being reaped. */
 const HEARTBEAT_MS = 15_000;
 
+/** The `fs` event's data: one debounced batch of filesystem changes for the studio sidebar. */
+export interface FsEventBatch {
+  events: FsEventPayload[];
+}
+
+/**
+ * What a named event carries on its `data:` line, serialized as JSON. The `fs` batch is named
+ * because its changes are typed as an interface, which TypeScript never treats as a `JsonValue`.
+ */
+export type SseEventData = JsonValue | FsEventBatch;
+
 /** A broadcast hub for one stream. */
 export interface SseHub {
   /** Send the default (unnamed) `reload` message, stamped with the next `id:`. */
@@ -43,7 +57,7 @@ export interface SseHub {
    * listener that asked for it without triggering everyone else's reload. That is what lets the
    * studio shell subscribe to `fs` on the same connection the preview reloads on.
    */
-  broadcastEvent: (event: string, payload: unknown) => void;
+  broadcastEvent: (event: string, payload: SseEventData) => void;
   /** Open the stream. Pass the request so `Last-Event-ID` can be read. */
   handleSSE: (request?: Request) => Response;
   /** How many clients are connected right now. */
@@ -75,7 +89,7 @@ export function createSseHub(): SseHub {
     }
   }
 
-  function broadcastEvent(event: string, payload: unknown) {
+  function broadcastEvent(event: string, payload: SseEventData) {
     const frame = `event: ${event}\ndata: ${JSON.stringify(payload)}\n\n`;
     for (const send of clients) {
       send(frame);