@noverax/courier-build 0.4.0 → 0.5.0

package/lib/metro/index.js

@@ -1,5 +1,5 @@
 import "../routes-module-id-CnUjQjYF.js";
-import { t as routesFile } from "../routes-file-DcpgxYb1.js";
+import { t as routesFile } from "../routes-file-DRoqUZ0S.js";
 import { basename, isAbsolute, join, relative, resolve } from "node:path";
 import { realpathSync } from "node:fs";
 // src/metro/routes-resolver.ts

package/lib/read-limits-DUuUaEQM.js

@@ -0,0 +1,41 @@
+// src/config/definitions-phase.ts
+/**
+* The signal a project's code reads to tell that Courier is reading its
+* definitions rather than serving requests: `COURIER_PHASE` holds
+* `definitions` in every process Courier starts to read them — the
+* `courier-cli routes` command, `courier-mcp --list`, Studio, the process a
+* bundler plugin reads the routes in — after the fashion of `NEXT_PHASE`.
+* Code that checks the environment as it is imported can skip the check
+* then, as `@t3-oss/env-core` does with `skipValidation`; Courier guesses
+* nothing for it. Where the application runs — `courier-server`,
+* `courier-mcp` serving an agent, `attachRuntime()`, the app itself — the
+* variable is not set.
+*/
+/** The variable a project's code reads the phase from. */
+const COURIER_PHASE = "COURIER_PHASE";
+/** Its value while Courier reads the project's definitions. */
+const DEFINITIONS_PHASE = "definitions";
+/**
+* Mark the process as one that reads the project's definitions, before the
+* project's code runs in it.
+*
+* @param env - The environment to mark (default: the process's)
+* @example
+* ```ts
+* enterDefinitionsPhase();
+* process.env.COURIER_PHASE; // "definitions"
+* ```
+*/
+function enterDefinitionsPhase(env = process.env) {
+	env[COURIER_PHASE] = DEFINITIONS_PHASE;
+}
+// src/config/read-limits.ts
+/**
+* How long one reading of a project's config may take before it is given
+* up, in milliseconds: a config that waits on the network, or on a timer,
+* never ends. The routes plugin's process and `courier-cli routes` hold to
+* it; Studio, which keeps running what it loaded last, has its own,
+* `COURIER_CONFIG_LOAD_TIMEOUT_MS`.
+*/
+const CONFIG_READ_LIMIT_MS = 6e4;
+export { enterDefinitionsPhase as i, COURIER_PHASE as n, DEFINITIONS_PHASE as r, CONFIG_READ_LIMIT_MS as t };

package/lib/rollup/index.js

@@ -1,8 +1,8 @@
 import { t as RoutesReadError } from "../routes-read-error-DQhKIE2F.js";
-import { n as routesModuleCode } from "../routes-module-code-DO3aII6v.js";
+import { n as routesModuleCode } from "../routes-module-code-DYtP7uj1.js";
 import { t as configInPageMessage } from "../config-in-page-message-DLd3f0Jd.js";
-import { t as sharedEngine } from "../shared-engine-CCu7vP_0.js";
-import { t as configFileOf } from "../config-file-of-Zkwyi9zf.js";
+import { t as sharedEngine } from "../shared-engine-D0j7uXg8.js";
+import { t as configFileOf } from "../config-file-of-Clf_dWUQ.js";
 import { t as ROUTES_MODULE_ID } from "../routes-module-id-CnUjQjYF.js";
 // src/rollup/load-routes-module.ts
 /**

package/lib/{routes-file-DcpgxYb1.js → routes-file-DRoqUZ0S.js}

@@ -1,8 +1,8 @@
 import { t as RoutesReadError } from "./routes-read-error-DQhKIE2F.js";
-import { n as routesModuleCode, r as unreadRoutesModuleCode } from "./routes-module-code-DO3aII6v.js";
+import { n as routesModuleCode, r as unreadRoutesModuleCode } from "./routes-module-code-DYtP7uj1.js";
 import { t as errnoCode } from "./errno-code-CNx_E80R.js";
-import { t as sharedEngine } from "./shared-engine-CCu7vP_0.js";
-import { t as configFileOf } from "./config-file-of-Zkwyi9zf.js";
+import { t as sharedEngine } from "./shared-engine-D0j7uXg8.js";
+import { t as configFileOf } from "./config-file-of-Clf_dWUQ.js";
 import { dirname, join, sep } from "node:path";
 import { mkdirSync, readFileSync, renameSync, rmSync, watch, writeFileSync } from "node:fs";
 // src/routes-file/follow-routes-inputs.ts

package/lib/{routes-module-code-DO3aII6v.js → routes-module-code-DYtP7uj1.js}

@@ -1,3 +1,4 @@
+import { n as COURIER_PHASE, r as DEFINITIONS_PHASE, t as CONFIG_READ_LIMIT_MS } from "./read-limits-DUuUaEQM.js";
 import { t as packageFile } from "./package-file-CVAKY_Nu.js";
 import { t as RoutesReadError } from "./routes-read-error-DQhKIE2F.js";
 import { n as isRecord, t as errnoCode } from "./errno-code-CNx_E80R.js";
@@ -51,8 +52,6 @@ function isRunning(child) {
 	return child.exitCode === null && child.signalCode === null;
 }
 // src/engine/evaluate-in-child.ts
-/** How long a reading may take before it is given up: a config that waits on the network never ends. */
-const READ_LIMIT_MS = 6e4;
 /** The package this module ships in, by the name its manifest gives. */
 const PACKAGE_NAME = "@noverax/courier-build";
 /**
@@ -70,7 +69,7 @@ const PACKAGE_NAME = "@noverax/courier-build";
 * const snapshot = await evaluateInChild({ root: "/app", envFiles: [] });
 * ```
 */
-function evaluateInChild(request, limitMs = READ_LIMIT_MS) {
+function evaluateInChild(request, limitMs = CONFIG_READ_LIMIT_MS) {
 	return new Promise((resolve, reject) => {
 		const unread = (message) => new RoutesReadError("ROUTES_NOT_READ", message, {
 			root: request.root,
@@ -83,6 +82,10 @@ function evaluateInChild(request, limitMs = READ_LIMIT_MS) {
 		}
 		const child = fork(worker, [], {
 			execArgv: [],
+			env: {
+				...process.env,
+				[COURIER_PHASE]: DEFINITIONS_PHASE
+			},
 			stdio: [
 				"ignore",
 				"inherit",

package/lib/{routes-rule-CjzX6NS5.js → routes-rule-Pu1Tz8Xm.js}

@@ -1,6 +1,6 @@
 import { t as packageFile } from "./package-file-CVAKY_Nu.js";
 import { t as RoutesReadError } from "./routes-read-error-DQhKIE2F.js";
-import { t as configFileOf } from "./config-file-of-Zkwyi9zf.js";
+import { t as configFileOf } from "./config-file-of-Clf_dWUQ.js";
 import { createRequire } from "node:module";
 import { join, resolve } from "node:path";
 import { realpathSync } from "node:fs";

package/lib/rsbuild/index.js

@@ -1,4 +1,4 @@
-import { n as routesProject, r as configInPageRule, t as routesRule } from "../routes-rule-CjzX6NS5.js";
+import { n as routesProject, r as configInPageRule, t as routesRule } from "../routes-rule-Pu1Tz8Xm.js";
 // src/rsbuild/courier-routes.ts
 /**
 * The Rsbuild plugin that builds the routes a page's proxy client may call

package/lib/rspack/index.js

@@ -1 +1 @@
-export { t as CourierRoutesPlugin } from "../webpack-B0v9i8lk.js";
+export { t as CourierRoutesPlugin } from "../webpack-BPxhBYGV.js";

package/lib/{shared-engine-CCu7vP_0.js → shared-engine-D0j7uXg8.js}

@@ -1,4 +1,4 @@
-import { i as createRoutesEngine } from "./routes-module-code-DO3aII6v.js";
+import { i as createRoutesEngine } from "./routes-module-code-DYtP7uj1.js";
 // src/engine/shared-engine.ts
 const engines = /* @__PURE__ */ new Map();
 /**

package/lib/vite/index.js

@@ -1,12 +1,12 @@
 import { t as RoutesReadError } from "../routes-read-error-DQhKIE2F.js";
-import { n as routesModuleCode, r as unreadRoutesModuleCode } from "../routes-module-code-DO3aII6v.js";
+import { n as routesModuleCode, r as unreadRoutesModuleCode } from "../routes-module-code-DYtP7uj1.js";
 import { n as isRecord } from "../errno-code-CNx_E80R.js";
 import { t as configInPageMessage } from "../config-in-page-message-DLd3f0Jd.js";
-import { f as configCandidates } from "../load-config-BeedbpkN.js";
-import { t as sharedEngine } from "../shared-engine-CCu7vP_0.js";
-import { t as configFileOf } from "../config-file-of-Zkwyi9zf.js";
+import { T as configCandidates, h as localPath } from "../load-config-barNPfXN.js";
+import { t as sharedEngine } from "../shared-engine-D0j7uXg8.js";
+import { t as configFileOf } from "../config-file-of-Clf_dWUQ.js";
 import { n as ROUTES_PATTERN, r as ROUTES_SPECIFIER, t as ROUTES_MODULE_ID } from "../routes-module-id-CnUjQjYF.js";
-import { dirname, isAbsolute, join, resolve, sep } from "node:path";
+import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";
 import { existsSync, statSync } from "node:fs";
 import { loadEnv } from "vite";
 // src/vite/config-in-page.ts
@@ -41,9 +41,14 @@ function withSlashes(path) {
 // src/vite/watch-once.ts
 const given = /* @__PURE__ */ new WeakMap();
 /**
-* Hand a dev server's watcher the paths it was not given yet. The routes
+* Hand a dev server's watcher each path it does not follow yet. The routes
 * module is loaded again on every edit, and follows the same paths each
-* time: each is given to each server once.
+* time: each is given to each server once. A path the watcher follows
+* already, as it follows Vite's root, is not given at all: chokidar reads a
+* folder it is handed as one just added, and an entry made since the routes
+* were read would pass for one that was there, with no notice of it. A
+* watcher that stops at a depth lists the folders below it unread: it is
+* handed every path.
 *
 * @param server - The dev server
 * @param paths - The paths to watch, there or not
@@ -60,7 +65,13 @@ function watchOnce(server, paths) {
 	}
 	const fresh = [...paths].filter((path) => !seen.has(path));
 	for (const path of fresh) seen.add(path);
-	if (fresh.length > 0) server.watcher.add(fresh);
+	if (fresh.length === 0) return;
+	const watched = server.watcher.options.depth === void 0 ? server.watcher.getWatched() : {};
+	const unfollowed = fresh.filter((path) => {
+		const local = localPath(path);
+		return !watched[dirname(local)]?.includes(basename(local));
+	});
+	if (unfollowed.length > 0) server.watcher.add(unfollowed);
 }
 // src/vite/follow-routes-inputs.ts
 /**

package/lib/webpack/index.js

@@ -1,3 +1,3 @@
-import { i as routesLoaderFile, n as routesProject, r as configInPageRule, t as routesRule } from "../routes-rule-CjzX6NS5.js";
-import { t as CourierRoutesPlugin } from "../webpack-B0v9i8lk.js";
+import { i as routesLoaderFile, n as routesProject, r as configInPageRule, t as routesRule } from "../routes-rule-Pu1Tz8Xm.js";
+import { t as CourierRoutesPlugin } from "../webpack-BPxhBYGV.js";
 export { CourierRoutesPlugin, configInPageRule, routesLoaderFile, routesProject, routesRule };

package/lib/webpack/run-routes-loader.js

@@ -1,8 +1,8 @@
 import { t as RoutesReadError } from "../routes-read-error-DQhKIE2F.js";
-import { n as routesModuleCode } from "../routes-module-code-DO3aII6v.js";
+import { n as routesModuleCode } from "../routes-module-code-DYtP7uj1.js";
 import { n as isRecord } from "../errno-code-CNx_E80R.js";
 import { t as configInPageMessage } from "../config-in-page-message-DLd3f0Jd.js";
-import { t as sharedEngine } from "../shared-engine-CCu7vP_0.js";
+import { t as sharedEngine } from "../shared-engine-D0j7uXg8.js";
 import { statSync } from "node:fs";
 // src/webpack/follow-loader-inputs.ts
 /**

package/lib/{webpack-B0v9i8lk.js → webpack-BPxhBYGV.js}

@@ -1,4 +1,4 @@
-import { n as routesProject, r as configInPageRule, t as routesRule } from "./routes-rule-CjzX6NS5.js";
+import { n as routesProject, r as configInPageRule, t as routesRule } from "./routes-rule-Pu1Tz8Xm.js";
 // src/webpack/courier-routes-plugin.ts
 const SERVER_TARGET = /^(async-)?node|^electron-(main|preload)|^nwjs/;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noverax/courier-build",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Courier at build time: loads courier.config the way every Courier tool does, and hands a page's bundle the routes its proxy client may call through a plugin for the app's bundler, with no routes file to generate",
   "keywords": [
     "courier",
@@ -154,7 +154,7 @@
     "jiti": "^2.7.0"
   },
   "peerDependencies": {
-    "@noverax/courier": "^0.4.0",
+    "@noverax/courier": "^0.5.0",
     "@rsbuild/core": ">=1.0.0",
     "@rspack/core": ">=1.0.0",
     "esbuild": ">=0.17.0",