@noverax/courier-build 0.0.0-stage → 0.5.0

package/lib/config/index.js

@@ -0,0 +1,75 @@
+import { i as enterDefinitionsPhase, n as COURIER_PHASE, r as DEFINITIONS_PHASE, t as CONFIG_READ_LIMIT_MS } from "../read-limits-DUuUaEQM.js";
+import { n as isRecord } from "../errno-code-CNx_E80R.js";
+import { C as projectFramework, S as detectFramework, T as configCandidates, _ as createConfigJiti, a as projectTransformCache, b as readPathAliases, c as UntrustedConfigError, d as configLoadError, f as loadTimedOut, g as ConfigLoadError, i as loadCourierConfigFile, l as importProjectFile, m as withoutSecrets, n as findConfigFileAt, o as findTransformCacheDirectory, p as maskedError, r as loadCourierConfig, s as createTransformCache, t as findConfigFile, u as settledDefault, v as profileOf, w as CONFIG_BASENAMES, x as FRAMEWORK_MARKERS, y as RefusedModuleError } from "../load-config-barNPfXN.js";
+// src/config/unknown-config-keys.ts
+const TOP_LEVEL = {
+	sources: true,
+	imports: true,
+	studio: true,
+	server: true,
+	runtime: true,
+	agents: true
+};
+const BLOCKS = /* @__PURE__ */ new Map([
+	["studio", {
+		port: true,
+		host: true,
+		mockBasePort: true,
+		open: true,
+		allowedSpecHosts: true,
+		routes: true
+	}],
+	["server", {
+		port: true,
+		host: true,
+		allowedOrigins: true,
+		allowedHosts: true,
+		maxBodyBytes: true,
+		maxUploadBytes: true,
+		uploadMode: true,
+		uploadMemoryBytes: true,
+		totalUploadMemoryBytes: true,
+		totalUploadDiskBytes: true,
+		uploadDirectory: true,
+		maxUploadParts: true,
+		bodyIdleTimeoutMs: true,
+		bodyTimeoutMs: true,
+		rateLimit: true,
+		browsersOnly: true
+	}],
+	["runtime", { appOrigin: true }],
+	["agents", {
+		offer: true,
+		allow: true,
+		deny: true,
+		access: true,
+		confirm: true
+	}]
+]);
+/**
+* The keys of a courier.config that Courier does not read, at the top and
+* in its `studio`, `server`, `runtime` and `agents` blocks — a misspelt `studo:` say
+* — so a load can name them rather than ignore them in silence.
+*
+* @param config - The config, as its module exported it
+* @returns Each such key, dotted under its block
+* @example
+* ```ts
+* unknownConfigKeys({ sources: {}, studo: {}, server: { prot: 3001 } }); // → ["studo", "server.prot"]
+* ```
+*/
+function unknownConfigKeys(config) {
+	if (!isRecord(config)) return [];
+	const unknown = [];
+	for (const [key, value] of Object.entries(config)) {
+		if (!Object.hasOwn(TOP_LEVEL, key)) {
+			unknown.push(key);
+			continue;
+		}
+		const known = BLOCKS.get(key);
+		if (!known || !isRecord(value)) continue;
+		for (const inner of Object.keys(value)) if (!Object.hasOwn(known, inner)) unknown.push(`${key}.${inner}`);
+	}
+	return unknown;
+}
+export { CONFIG_BASENAMES, CONFIG_READ_LIMIT_MS, COURIER_PHASE, ConfigLoadError, DEFINITIONS_PHASE, FRAMEWORK_MARKERS, RefusedModuleError, UntrustedConfigError, configCandidates, configLoadError, createConfigJiti, createTransformCache, detectFramework, enterDefinitionsPhase, findConfigFile, findConfigFileAt, findTransformCacheDirectory, importProjectFile, loadCourierConfig, loadCourierConfigFile, loadTimedOut, maskedError, profileOf, projectFramework, projectTransformCache, readPathAliases, settledDefault, unknownConfigKeys, withoutSecrets };

package/lib/config-file-of-Clf_dWUQ.js

@@ -0,0 +1,28 @@
+import { t as errnoCode } from "./errno-code-CNx_E80R.js";
+import { c as UntrustedConfigError, t as findConfigFile } from "./load-config-barNPfXN.js";
+import { resolve } from "node:path";
+import { realpathSync } from "node:fs";
+// src/util/config-file-of.ts
+/**
+* The config file the routes are read from, as a bundler names a module:
+* its real path. One that is not there yet, or that is not run, gives none
+* here; the engine reports why when the routes are read.
+*
+* @param root - The project's root, where the config is looked for and above
+* @param named - The config, from the root or absolute, when it is not the one found
+* @returns The config file, absolute and real; none when there is no config to read
+* @example
+* ```ts
+* configFileOf("/app"); // "/app/courier.config.ts"
+* ```
+*/
+function configFileOf(root, named) {
+	try {
+		const file = named === void 0 ? findConfigFile(root) : resolve(root, named);
+		return file === null ? void 0 : realpathSync(file);
+	} catch (error) {
+		if (error instanceof UntrustedConfigError || errnoCode(error) === "ENOENT") return void 0;
+		throw error;
+	}
+}
+export { configFileOf as t };

package/lib/config-in-page-message-DLd3f0Jd.js

@@ -0,0 +1,20 @@
+import { basename } from "node:path";
+// src/util/config-in-page-message.ts
+/**
+* Why the project's config cannot be a module of a page, and what to write
+* instead. It holds the server's settings and the definition of every API —
+* their addresses, their middleware, what reads their secrets — and imported
+* as a value it ships all of them to the browser. A page needs its type
+* alone, which an `import type` gives without a byte of it.
+*
+* @param configFile - The project's config
+* @returns The message a build fails with
+* @example
+* ```ts
+* configInPageMessage("/app/courier.config.ts"); // "[courier] courier.config.ts is imported into a page as a value, …"
+* ```
+*/
+function configInPageMessage(configFile) {
+	return `[courier] ${basename(configFile)} is imported into a page as a value, which would ship the server's settings and every API's definition to the browser. Import its type alone: write \`import type config from\` where the page writes \`import config from\`.`;
+}
+export { configInPageMessage as t };

package/lib/courier-routes-options-BYF7Sfdf.d.cts

@@ -0,0 +1,13 @@
+/**
+ * Options of the routes plugins that need to know only where the config is:
+ * those of webpack, Rspack, Rsbuild, esbuild, Rollup and Jest, and of the
+ * frameworks built on them.
+ */
+interface CourierRoutesOptions {
+  /**
+   * The config file, from the project's root or absolute, when it is not
+   * the `courier.config.*` in the root or the nearest folder above it.
+   */
+  config?: string | undefined;
+}
+export { CourierRoutesOptions as t };

package/lib/courier-routes-options-BYF7Sfdf.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Options of the routes plugins that need to know only where the config is:
+ * those of webpack, Rspack, Rsbuild, esbuild, Rollup and Jest, and of the
+ * frameworks built on them.
+ */
+interface CourierRoutesOptions {
+  /**
+   * The config file, from the project's root or absolute, when it is not
+   * the `courier.config.*` in the root or the nearest folder above it.
+   */
+  config?: string | undefined;
+}
+export { CourierRoutesOptions as t };

package/lib/engine/worker.d.ts

@@ -0,0 +1 @@
+export {}