@c9up/ream 0.2.24 → 0.2.25

package/dist/dev/hotGlob.js

@@ -7,9 +7,16 @@
  * what they need is to be right, not fast.
  *
  * The dialect is the one those files already use:
- *   *   any run of characters inside one path segment
- *   **  any number of segments, including none
- *   ?   exactly one character inside a segment
+ *   *      any run of characters inside one path segment
+ *   **     any number of segments, including none
+ *   ?      exactly one character inside a segment
+ *   {a,b}  either alternative
+ *
+ * The brace form is the one a `metaFiles` entry uses —
+ * `resources/lang/**\/*.{json,yaml,yml}` — and it has to be understood on this
+ * side too: the CLI matches the same pattern when it copies those files into
+ * the build, and a dialect that differed between the two would let an entry
+ * copy at build time and never fire in development, or the reverse.
  *
  * A leading `./` is optional, and matching is done on POSIX-shaped paths
  * relative to the project root, so a Windows checkout and a Linux one read the
@@ -42,6 +49,24 @@ export function globToRegExp(pattern) {
             out += '[^/]';
             continue;
         }
+        if (char === '{') {
+            const close = cleaned.indexOf('}', i);
+            if (close !== -1) {
+                // Alternatives are literal text, never nested globs: that is the whole
+                // of the form these patterns use, and a recursive reading would accept
+                // shapes the CLI's matcher does not.
+                const options = cleaned
+                    .slice(i + 1, close)
+                    .split(',')
+                    .map((option) => option.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+                out += `(?:${options.join('|')})`;
+                i = close;
+                continue;
+            }
+            // Unclosed: read literally rather than throwing. A pattern is a string in
+            // a config file, and a malformed one should match nothing, not take the
+            // dev server down at boot.
+        }
         // Everything else is literal, including the characters a regular
         // expression would otherwise read as syntax.
         out += (char ?? '').replace(/[.+^${}()|[\]\\]/g, '\\$&');

package/dist/dev/hotGlob.js.map

@@ -1 +1 @@
-{"version":3,"file":"hotGlob.js","sourceRoot":"","sources":["../../src/dev/hotGlob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAC5C,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3B,oEAAoE;gBACpE,2CAA2C;gBAC3C,CAAC,IAAI,CAAC,CAAA;gBACN,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC3B,CAAC,IAAI,CAAC,CAAA;oBACN,GAAG,IAAI,aAAa,CAAA;gBACtB,CAAC;qBAAM,CAAC;oBACN,GAAG,IAAI,IAAI,CAAA;gBACb,CAAC;gBACD,SAAQ;YACV,CAAC;YACD,GAAG,IAAI,OAAO,CAAA;YACd,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,GAAG,IAAI,MAAM,CAAA;YACb,SAAQ;QACV,CAAC;QACD,iEAAiE;QACjE,6CAA6C;QAC7C,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,CAAA;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,QAA2B;IACrD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC9C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,EAAE,CAAC,KAAK,CAAA;IAChD,OAAO,CAAC,IAAY,EAAE,EAAE;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAChE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAA;IACtE,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"hotGlob.js","sourceRoot":"","sources":["../../src/dev/hotGlob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,yDAAyD;AACzD,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAC5C,IAAI,GAAG,GAAG,EAAE,CAAA;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;QACvB,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBAC3B,oEAAoE;gBACpE,2CAA2C;gBAC3C,CAAC,IAAI,CAAC,CAAA;gBACN,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBAC3B,CAAC,IAAI,CAAC,CAAA;oBACN,GAAG,IAAI,aAAa,CAAA;gBACtB,CAAC;qBAAM,CAAC;oBACN,GAAG,IAAI,IAAI,CAAA;gBACb,CAAC;gBACD,SAAQ;YACV,CAAC;YACD,GAAG,IAAI,OAAO,CAAA;YACd,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,GAAG,IAAI,MAAM,CAAA;YACb,SAAQ;QACV,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;YACrC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,uEAAuE;gBACvE,uEAAuE;gBACvE,qCAAqC;gBACrC,MAAM,OAAO,GAAG,OAAO;qBACpB,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;qBACnB,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAA;gBACjE,GAAG,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;gBACjC,CAAC,GAAG,KAAK,CAAA;gBACT,SAAQ;YACV,CAAC;YACD,0EAA0E;YAC1E,wEAAwE;YACxE,2BAA2B;QAC7B,CAAC;QACD,iEAAiE;QACjE,6CAA6C;QAC7C,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAA;IAC1D,CAAC;IACD,OAAO,IAAI,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC,CAAA;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,QAA2B;IACrD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;IAC9C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,EAAE,CAAC,KAAK,CAAA;IAChD,OAAO,CAAC,IAAY,EAAE,EAAE;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAChE,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAA;IACtE,CAAC,CAAA;AACH,CAAC"}

package/dist/hot.js

@@ -26,7 +26,7 @@ import { existsSync, writeSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { registerHooks } from 'node:module';
 import { dirname, relative, resolve as resolvePath } from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import { fullReloadNotice } from './dev/fullReload.js';
 import { hotReloadHappened } from './dev/hmr.js';
 import { readHotHookConfig } from './dev/hotConfig.js';
@@ -57,9 +57,57 @@ const { boundaries = [], restart = [] } = config;
 const restartFiles = new Set(envFileNames()
     .map((name) => resolvePath(root, name))
     .filter((file) => existsSync(file)));
+/**
+ * `metaFiles` entries that asked for a restart.
+ *
+ * Non-module files the application owns — translations, view templates — live
+ * in `reamrc.ts` because the BUILD has to copy them. A change to one is
+ * invisible to the import graph, so the only way it can do anything in
+ * development is by being named here.
+ *
+ * `reloadServer: false` is the interesting default, and the one upstream picks
+ * for translations: the entry exists so the file ships, and an edit does NOT
+ * restart. NAMED DEVIATION — upstream still logs such a change, because its
+ * watcher covers the whole project anyway. This one watches a fixed list of
+ * directories on purpose (`resources/` belongs to the asset watcher, and a
+ * stylesheet edit must not restart the server), so a `false` entry is simply
+ * not watched. The observable behaviour is the same: nothing happens.
+ */
+async function readReloadPatterns() {
+    try {
+        const rc = (await import(pathToFileURL(resolvePath(root, 'reamrc.ts')).href));
+        return (rc.default?.metaFiles ?? [])
+            .filter((entry) => entry.reloadServer === true && typeof entry.pattern === 'string')
+            .map((entry) => String(entry.pattern));
+    }
+    catch {
+        // No rc file, or one that does not load. The server itself reports a broken
+        // rc far more clearly than the loader could, and a dev server that refuses
+        // to start because of a watch list helps nobody.
+        return [];
+    }
+}
+const reloadPatterns = await readReloadPatterns();
+/**
+ * The directory a pattern lives under — everything before its first wildcard.
+ *
+ * `resources/lang/**\/*.json` is watched as `resources/lang`. Watching the
+ * project root instead would pull in `node_modules` and the build output.
+ */
+function watchRootOf(pattern) {
+    const segments = pattern.replace(/^\.\//, '').split('/');
+    const fixed = [];
+    for (const segment of segments) {
+        if (/[*?{[]/.test(segment))
+            break;
+        fixed.push(segment);
+    }
+    // A pattern that is a bare glob has no directory to narrow to.
+    return fixed.slice(0, -1).join('/') || fixed.join('/');
+}
 const relativeToRoot = (file) => relative(root, file).replace(/\\/g, '/');
 const matchesBoundary = globMatcher(boundaries);
-const matchesRestartGlob = globMatcher(restart);
+const matchesRestartGlob = globMatcher([...restart, ...reloadPatterns]);
 const graph = new HotGraph({
     isBoundary: (file) => matchesBoundary(relativeToRoot(file)),
     isRestart: (file) => restartFiles.has(file) || matchesRestartGlob(relativeToRoot(file)),
@@ -113,7 +161,12 @@ function sayNow(line) {
 }
 watchProject({
     root,
-    directories: WATCH_DIRS,
+    directories: [
+        ...WATCH_DIRS,
+        // Whatever a `reloadServer: true` entry named, and nothing else: the
+        // directories above are the ones the graph can reason about.
+        ...reloadPatterns.map(watchRootOf).filter((dir) => dir !== ''),
+    ],
     files: [...restartFiles].map((file) => relative(root, file)),
     onChange: (file) => {
         const decision = graph.decide(file);

package/dist/hot.js.map

@@ -1 +1 @@
-{"version":3,"file":"hot.js","sourceRoot":"","sources":["../src/hot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hot.js","sourceRoot":"","sources":["../src/hot.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -121,5 +121,5 @@ export { BaseEvent, Emitter, type EmitterResolver, type ListenerClass, } from '.
 export { type BufferedEvent, type BufferedEventName, type EventFinder, EventsBuffer, } from './events/EventsBuffer.js';
 export type { ErrorReporter, LockBackend, LockBackendFactory, LockRedisClient, LockRedisResolver, RunTaskOutcome, ScheduleEvent, ScheduleEventSink, ScheduleInvocation, ScheduleMetadata, ScheduleProviderOptions, SchedulerConfig, SchedulerOptions, ScheduleTaskCompletedEvent, ScheduleTaskFailedEvent, ScheduleTaskSkippedEvent, ScheduleTaskStartedEvent, TaskInfo, TaskStats, } from './scheduler/index.js';
 export { defineSchedulerConfig, getScheduleMetadata, locks, MemoryLockBackend, RedisLockBackend, SCHEDULE_METADATA_KEY, Schedule, ScheduleProvider, Scheduler, StatsTracker, } from './scheduler/index.js';
-export declare const VERSION = "0.2.24";
+export declare const VERSION = "0.2.25";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -92,5 +92,5 @@ export { defineConfig as defineEventsConfig } from './events/config.js';
 export { BaseEvent, Emitter, } from './events/Emitter.js';
 export { EventsBuffer, } from './events/EventsBuffer.js';
 export { defineSchedulerConfig, getScheduleMetadata, locks, MemoryLockBackend, RedisLockBackend, SCHEDULE_METADATA_KEY, Schedule, ScheduleProvider, Scheduler, StatsTracker, } from './scheduler/index.js';
-export const VERSION = '0.2.24';
+export const VERSION = '0.2.25';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c9up/ream",
-  "version": "0.2.24",
+  "version": "0.2.25",
   "description": "Ream — Rust-powered Node.js application framework",
   "license": "MIT",
   "type": "module",

package/src/Codemods.ts

@@ -3,6 +3,7 @@ import * as path from 'node:path'
 
 export interface Codemods {
   addProvider(importPath: string): Promise<void>
+  addMetaFile(pattern: string, reloadServer?: boolean): Promise<void>
   addEnvVars(vars: Record<string, string>): Promise<void>
   writeFile(filePath: string, content: string, options?: { force?: boolean }): Promise<void>
   registerCommand(importPath: string): Promise<void>
@@ -120,6 +121,58 @@ export function createCodemods(options?: { force?: boolean; cwd?: string }): Cod
       fs.writeFileSync(rcPath, content)
     },
 
+    /**
+     * Record a non-module file the application owns.
+     *
+     * A package calls this from `configure()` so its files reach the build:
+     * `addMetaFile('resources/lang/**\/*.json', false)`. The second argument
+     * is DELIBERATELY explicit at every call site — whether an edit costs a
+     * development restart is the decision the entry exists to record.
+     *
+     * Same regex codemod as `addProvider`, and the same limits: a `metaFiles`
+     * assembled by a spread or extracted into a `const` above the config is not
+     * rewritten. The block is created when absent, which `addProvider` cannot
+     * do — `providers` is always there, `metaFiles` usually is not.
+     */
+    async addMetaFile(pattern: string, reloadServer = false): Promise<void> {
+      const rcPath = path.join(root, 'reamrc.ts')
+      if (!fs.existsSync(rcPath)) {
+        throw new Error(
+          `[configure] reamrc.ts not found — cannot register meta file ${pattern}. Run 'ream new' first.`,
+        )
+      }
+      assertCanonicallyInside(root, rcPath, 'reamrc.ts')
+
+      let content = fs.readFileSync(rcPath, 'utf8')
+      // Dedup on the PATTERN alone: the same glob registered twice with
+      // different flags is a contradiction, and the first one wins rather than
+      // both being written.
+      if (content.includes(`'${pattern}'`) || content.includes(`"${pattern}"`)) return
+
+      const eol = detectLineEnding(content)
+      const entry = `    { pattern: '${pattern}', reloadServer: ${reloadServer} },`
+
+      const existing = /metaFiles\s*:\s*(?:\/\*[\s\S]*?\*\/\s*)?\[/.exec(content)
+      if (existing !== null) {
+        const insertAt = existing.index + existing[0].length
+        content = `${content.slice(0, insertAt)}${eol}${entry}${content.slice(insertAt)}`
+        fs.writeFileSync(rcPath, content)
+        return
+      }
+
+      // No block yet — open one beside `providers`, which every rc file has.
+      const providers = /providers\s*:\s*(?:\/\*[\s\S]*?\*\/\s*)?\[/.exec(content)
+      if (providers === null) {
+        throw new Error(
+          `[configure] Could not find 'providers: [' in reamrc.ts — meta file ${pattern} not added. Check your reamrc.ts format.`,
+        )
+      }
+      const blockAt = providers.index
+      const block = `metaFiles: [${eol}${entry}${eol}  ],${eol}  `
+      content = `${content.slice(0, blockAt)}${block}${content.slice(blockAt)}`
+      fs.writeFileSync(rcPath, content)
+    },
+
     async addEnvVars(vars: Record<string, string>): Promise<void> {
       const envPath = path.join(root, '.env')
       // A symlinked .env must not redirect the write outside the root.

package/src/Ignitor.ts

@@ -17,7 +17,7 @@ import { Application } from './Application.js'
 import type { Console } from './console/Console.js'
 import type { CommandLoader, Kernel as ConsoleKernelInstance } from './console/Kernel.js'
 import { type CommandClass, isCommandClass } from './console/types.js'
-import { HMR_PATH, hmrClientScript, hmrToken } from './dev/hmr.js'
+import { hmrClientScript, hmrEndpoint } from './dev/hmr.js'
 import type { DirectoriesNode } from './directories.js'
 import type { ErrorEvent } from './ErrorBoundary.js'
 import { ErrorBoundary } from './ErrorBoundary.js'
@@ -137,6 +137,35 @@ export interface ReamrcConfig {
    * `defineConfig`, which is a strange way to learn that the option exists.
    */
   assets?: AssetsConfig
+  /**
+   * Files that are not modules but belong to the application.
+   *
+   * Translations, view templates, a mail signature: the build has no reason to
+   * know about them, and without being told it ships a `dist/` that boots and
+   * then cannot find them. Every pattern here is copied into the build output,
+   * keeping its path relative to the project root.
+   *
+   * `reloadServer` decides what a change does in DEVELOPMENT, and the default
+   * is the interesting half. Upstream registers translations with `false` —
+   * the files are watched so the build copies them, and an edit does NOT
+   * restart the server. A package that genuinely needs a restart asks for one
+   * by passing `true`.
+   */
+  metaFiles?: MetaFileConfig[]
+}
+
+/**
+ * One `metaFiles` entry.
+ *
+ * `reloadServer` is required rather than defaulted: whether an edit costs a
+ * restart is the whole decision this entry exists to record, and a default
+ * would let it be made by accident.
+ */
+export interface MetaFileConfig {
+  /** Glob, relative to the project root — `resources/lang/**\/*.json`. */
+  pattern: string
+  /** Restart the development server when a matching file changes. */
+  reloadServer: boolean
 }
 
 /** One test suite, as declared in the rc file (AdonisJS `tests.suites[]`). */
@@ -709,7 +738,6 @@ export class Ignitor {
     // anything. Registered in `ready()` it came up after the server was already
     // serving, so a page loaded in that window polled a route that did not
     // exist yet.
-    this.#registerDevReloadRoute()
 
     // Providers start BEFORE the preload files, matching upstream's warm-up
     // order (`providers.start()` → `starting` hooks → preloads). A preload is
@@ -797,7 +825,10 @@ export class Ignitor {
         container: this.#app.container,
         exceptionHandler:
           this.#server.getErrorHandler() ?? new ExceptionHandler(!this.#app.inProduction),
-        serverMiddleware: this.#server.getServerMiddleware(),
+        serverMiddleware: [
+          ...this.#frameworkServerMiddleware(),
+          ...this.#server.getServerMiddleware(),
+        ],
         routerMiddleware: this.#router.getRouterMiddleware(),
         devReloadScript: this.#devReloadScript(),
         onError: (error, ctx) => {
@@ -1288,19 +1319,18 @@ export class Ignitor {
   }
 
   /**
-   * Serve the token the injected script polls.
+   * The server middleware the framework itself contributes, ahead of the
+   * application's.
    *
-   * Registered on the router in development, next to the application's own
-   * routes, so it goes through the same server as everything else. Plain text
-   * and uncached: it is read once a second and its whole content is the answer.
+   * Only the hot-reload token, and only in development. It answers first
+   * because the poll arrives once a second per open tab and its content
+   * depends on nothing — no user, no session, no body. Behind an application's
+   * middleware it paid for the whole stack each time, which for anything that
+   * resolves a user from a cookie meant a `SELECT` per second for a string
+   * holding a process id and a counter.
    */
-  #registerDevReloadRoute(): void {
-    if (!this.isDevMode()) return
-    this.#router.get(HMR_PATH, ({ response }) => {
-      response.header('cache-control', 'no-store')
-      response.header('content-type', 'text/plain; charset=utf-8')
-      response.send(hmrToken())
-    })
+  #frameworkServerMiddleware(): MiddlewareFunction[] {
+    return this.isDevMode() ? [hmrEndpoint()] : []
   }
 
   getPhase(): string {

package/src/dev/hmr.ts

@@ -45,6 +45,90 @@ function holder(): CounterHolder {
 export function hotReloadHappened(): void {
   const store = holder()
   store[COUNTER] = (store[COUNTER] ?? 0) + 1
+  notifyClients()
+}
+
+/**
+ * The dev clients currently listening.
+ *
+ * A `Set` and not a count: each entry is pushed to on a swap, and dropped when
+ * the tab closes. `unknown`-typed on purpose — this module must not import the
+ * HTTP layer, which imports it back.
+ */
+interface DevClient {
+  send: (event: string, data: unknown) => Promise<boolean>
+  onClose: (callback: () => void) => void
+}
+
+const clients = new Set<DevClient>()
+
+/** The event name the injected script listens for. */
+const HMR_EVENT = 'ream:hmr'
+
+/**
+ * Answer the dev client BEFORE any application middleware runs, and PUSH.
+ *
+ * Two problems, one change.
+ *
+ * It used to be an ordinary route polled once a second, per open tab, and a
+ * route runs the whole middleware stack. An application that resolves a user
+ * from a session cookie therefore ran `SELECT * FROM users` once a second for
+ * a response whose entire content is a process id and a counter, and which
+ * depends on no user, no session and no body.
+ *
+ * It is a stream now, so the cost is paid ONCE per tab instead of once a
+ * second, and a change reaches the browser immediately rather than up to a
+ * second later. Upstream gets the same thing from Vite's websocket; this needs
+ * no bundler, because the server already speaks SSE.
+ *
+ * Registered FIRST rather than merely outside the router: middleware that
+ * authenticates lives at either tier, and an application is free to put it in
+ * `server.use([...])` — many do, because it must run before routing.
+ *
+ * Development only. In production nothing injects the script and nothing
+ * registers this.
+ */
+export function hmrEndpoint(): (
+  ctx: {
+    request: { url: () => string }
+    response: { sse: () => Promise<DevClient> }
+  },
+  next: () => Promise<void>,
+) => Promise<void> {
+  return async (ctx, next) => {
+    // `url()` carries the query string; a client may append a cache-buster.
+    const path = ctx.request.url().split('?')[0]
+    if (path !== HMR_PATH) {
+      await next()
+      return
+    }
+
+    let stream: DevClient
+    try {
+      stream = await ctx.response.sse()
+    } catch {
+      // A host without the streaming NAPI — a mock server in a test, say.
+      // Losing the reload is fine; failing the request is not.
+      await next()
+      return
+    }
+
+    clients.add(stream)
+    stream.onClose(() => clients.delete(stream))
+    // Immediately, so a tab that connects after a restart compares against the
+    // CURRENT token rather than waiting for the next swap to learn anything.
+    await stream.send(HMR_EVENT, hmrToken())
+  }
+}
+
+/** Tell every open tab the token moved. */
+function notifyClients(): void {
+  const token = hmrToken()
+  for (const client of clients) {
+    // Detached: a swap must not wait on a socket, and a dead one is dropped by
+    // its own close handler.
+    void client.send(HMR_EVENT, token).catch(() => clients.delete(client))
+  }
 }
 
 /** How many hot swaps this process has seen. */
@@ -63,10 +147,15 @@ export function hmrToken(): string {
 /**
  * The script injected into HTML pages in dev.
  *
- * It reloads when the token changes, NOT when the request fails: a server that
- * is restarting is unreachable for a moment, and reloading then would only show
- * the browser's error page. It waits for an answer, and the answer carries a
- * new boot id.
+ * An `EventSource`, not a poll. The server pushes the token, so a change
+ * reaches the page immediately and an idle tab costs one open connection
+ * rather than a request per second through the whole middleware stack.
+ *
+ * It reloads when the token CHANGES, never when the connection fails: a
+ * restarting server is unreachable for a moment, and reloading then would only
+ * show the browser's error page. `EventSource` reconnects on its own, and the
+ * server greets the new connection with its token — which after a restart is a
+ * different boot id, so the reload happens then, once the server can serve it.
  */
 export function hmrClientScript(nonce?: string): string {
   // A nonce-based CSP — which the scaffold ships, via `@c9up/blackhole` —
@@ -75,9 +164,13 @@ export function hmrClientScript(nonce?: string): string {
   // are escaped because a nonce is generated, not user input, but a broken
   // attribute would silently disable the tag rather than fail loudly.
   const attribute = nonce === undefined ? '' : ` nonce="${nonce.replace(/"/g, '&quot;')}"`
-  // A failed poll RETRIES. Returning on `!r.ok` stopped the loop for good, so a
-  // page opened in the window before the endpoint is mounted — or during any
-  // blip — never reloaded again for the life of that tab, which looks exactly
-  // like the feature not working.
-  return `<script${attribute}>(()=>{let t=null;const p=${JSON.stringify(HMR_PATH)};const tick=async()=>{try{const r=await fetch(p,{cache:'no-store'});if(r.ok){const n=(await r.text()).trim();if(t===null){t=n}else if(n!==t){location.reload();return}}}catch(e){}setTimeout(tick,1000)};tick()})()</script>`
+  // `addEventListener(HMR_EVENT)`, NOT `onmessage`: the stream names its
+  // events, and `onmessage` fires only for unnamed ones — a client wired that
+  // way receives nothing at all, silently, which is a mistake this codebase
+  // has already made once with relay.
+  return `<script${attribute}>(()=>{let t=null;const s=new EventSource(${JSON.stringify(
+    HMR_PATH,
+  )});s.addEventListener(${JSON.stringify(
+    HMR_EVENT,
+  )},e=>{let n;try{n=JSON.parse(e.data)}catch(_){n=e.data}if(t===null){t=n}else if(n!==t){s.close();location.reload()}})})()</script>`
 }

package/src/dev/hotGlob.ts

@@ -7,9 +7,16 @@
  * what they need is to be right, not fast.
  *
  * The dialect is the one those files already use:
- *   *   any run of characters inside one path segment
- *   **  any number of segments, including none
- *   ?   exactly one character inside a segment
+ *   *      any run of characters inside one path segment
+ *   **     any number of segments, including none
+ *   ?      exactly one character inside a segment
+ *   {a,b}  either alternative
+ *
+ * The brace form is the one a `metaFiles` entry uses —
+ * `resources/lang/**\/*.{json,yaml,yml}` — and it has to be understood on this
+ * side too: the CLI matches the same pattern when it copies those files into
+ * the build, and a dialect that differed between the two would let an entry
+ * copy at build time and never fire in development, or the reverse.
  *
  * A leading `./` is optional, and matching is done on POSIX-shaped paths
  * relative to the project root, so a Windows checkout and a Linux one read the
@@ -42,6 +49,24 @@ export function globToRegExp(pattern: string): RegExp {
       out += '[^/]'
       continue
     }
+    if (char === '{') {
+      const close = cleaned.indexOf('}', i)
+      if (close !== -1) {
+        // Alternatives are literal text, never nested globs: that is the whole
+        // of the form these patterns use, and a recursive reading would accept
+        // shapes the CLI's matcher does not.
+        const options = cleaned
+          .slice(i + 1, close)
+          .split(',')
+          .map((option) => option.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'))
+        out += `(?:${options.join('|')})`
+        i = close
+        continue
+      }
+      // Unclosed: read literally rather than throwing. A pattern is a string in
+      // a config file, and a malformed one should match nothing, not take the
+      // dev server down at boot.
+    }
     // Everything else is literal, including the characters a regular
     // expression would otherwise read as syntax.
     out += (char ?? '').replace(/[.+^${}()|[\]\\]/g, '\\$&')

package/src/hot.ts

@@ -27,7 +27,7 @@ import { existsSync, writeSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { registerHooks } from 'node:module'
 import { dirname, relative, resolve as resolvePath } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { fileURLToPath, pathToFileURL } from 'node:url'
 import { fullReloadNotice } from './dev/fullReload.js'
 import { hotReloadHappened } from './dev/hmr.js'
 import { readHotHookConfig } from './dev/hotConfig.js'
@@ -66,9 +66,60 @@ const restartFiles = new Set(
     .filter((file) => existsSync(file)),
 )
 
+/**
+ * `metaFiles` entries that asked for a restart.
+ *
+ * Non-module files the application owns — translations, view templates — live
+ * in `reamrc.ts` because the BUILD has to copy them. A change to one is
+ * invisible to the import graph, so the only way it can do anything in
+ * development is by being named here.
+ *
+ * `reloadServer: false` is the interesting default, and the one upstream picks
+ * for translations: the entry exists so the file ships, and an edit does NOT
+ * restart. NAMED DEVIATION — upstream still logs such a change, because its
+ * watcher covers the whole project anyway. This one watches a fixed list of
+ * directories on purpose (`resources/` belongs to the asset watcher, and a
+ * stylesheet edit must not restart the server), so a `false` entry is simply
+ * not watched. The observable behaviour is the same: nothing happens.
+ */
+async function readReloadPatterns(): Promise<string[]> {
+  try {
+    const rc = (await import(pathToFileURL(resolvePath(root, 'reamrc.ts')).href)) as {
+      default?: { metaFiles?: Array<{ pattern?: unknown; reloadServer?: unknown }> }
+    }
+    return (rc.default?.metaFiles ?? [])
+      .filter((entry) => entry.reloadServer === true && typeof entry.pattern === 'string')
+      .map((entry) => String(entry.pattern))
+  } catch {
+    // No rc file, or one that does not load. The server itself reports a broken
+    // rc far more clearly than the loader could, and a dev server that refuses
+    // to start because of a watch list helps nobody.
+    return []
+  }
+}
+
+const reloadPatterns = await readReloadPatterns()
+
+/**
+ * The directory a pattern lives under — everything before its first wildcard.
+ *
+ * `resources/lang/**\/*.json` is watched as `resources/lang`. Watching the
+ * project root instead would pull in `node_modules` and the build output.
+ */
+function watchRootOf(pattern: string): string {
+  const segments = pattern.replace(/^\.\//, '').split('/')
+  const fixed: string[] = []
+  for (const segment of segments) {
+    if (/[*?{[]/.test(segment)) break
+    fixed.push(segment)
+  }
+  // A pattern that is a bare glob has no directory to narrow to.
+  return fixed.slice(0, -1).join('/') || fixed.join('/')
+}
+
 const relativeToRoot = (file: string): string => relative(root, file).replace(/\\/g, '/')
 const matchesBoundary = globMatcher(boundaries)
-const matchesRestartGlob = globMatcher(restart)
+const matchesRestartGlob = globMatcher([...restart, ...reloadPatterns])
 
 const graph = new HotGraph({
   isBoundary: (file) => matchesBoundary(relativeToRoot(file)),
@@ -126,7 +177,12 @@ function sayNow(line: string): void {
 
 watchProject({
   root,
-  directories: WATCH_DIRS,
+  directories: [
+    ...WATCH_DIRS,
+    // Whatever a `reloadServer: true` entry named, and nothing else: the
+    // directories above are the ones the graph can reason about.
+    ...reloadPatterns.map(watchRootOf).filter((dir) => dir !== ''),
+  ],
   files: [...restartFiles].map((file) => relative(root, file)),
   onChange: (file) => {
     const decision = graph.decide(file)

package/src/index.ts

@@ -385,4 +385,4 @@ export {
   StatsTracker,
 } from './scheduler/index.js'
 
-export const VERSION = '0.2.24'
+export const VERSION = '0.2.25'