@mastra/deployer 1.76.0-alpha.0 → 1.76.0-alpha.2

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-deployer
 description: Documentation for @mastra/deployer. Use when working with @mastra/deployer APIs, configuration, or implementation.
 metadata:
   package: "@mastra/deployer"
-  version: "1.76.0-alpha.0"
+  version: "1.76.0-alpha.2"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.76.0-alpha.0",
+  "version": "1.76.0-alpha.2",
   "package": "@mastra/deployer",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-deployer.md

@@ -44,7 +44,7 @@ class CustomDeployer extends Deployer {
 
 ## Methods
 
-**getEnvFiles** (`() => Promise<string[]>`): Returns a list of environment files to be used during deployment. By default, it looks for '.env.production' and '.env' files.
+**getEnvFiles** (`() => Promise<string[]>`): Returns the environment files to be used during deployment. By default, it returns every existing file among '.env', '.env.local', and '.env.production', in that order (lowest to highest precedence).
 
 **deploy** (`(outputDirectory: string) => Promise<void>`): Abstract method that must be implemented by subclasses. Handles the deployment process to the specified output directory.
 
@@ -65,7 +65,7 @@ The Deployer class inherits the following key methods from the Bundler class:
 The Deployer abstract class implements a structured deployment lifecycle:
 
 1. **Initialization**: The deployer is initialized with a name and creates a Deps instance for dependency management.
-2. **Environment Setup**: The `getEnvFiles` method identifies environment files (.env.production, .env) to be used during deployment.
+2. **Environment Setup**: The `getEnvFiles` method identifies the environment files (`.env`, `.env.local`, `.env.production`) to be used during deployment.
 3. **Preparation**: The `prepare` method (inherited from Bundler) cleans the output directory and creates necessary subdirectories.
 4. **Bundling**: The `_bundle` method (inherited from Bundler) packages the application code and its dependencies.
 5. **Deployment**: The abstract `deploy` method is implemented by subclasses to handle the actual deployment process.
@@ -74,23 +74,16 @@ The Deployer abstract class implements a structured deployment lifecycle:
 
 The Deployer class includes built-in support for environment file management through the `getEnvFiles` method. This method:
 
-- Looks for environment files in a predefined order (.env.production, .env)
-- Uses the FileService to find the first existing file
-- Returns an array of found environment files
+- Looks for environment files in a predefined order, from lowest to highest precedence: `.env`, `.env.local`, `.env.production`
+- Returns every file that exists, in that order, so values in later files override earlier ones
 - Returns an empty array if no environment files are found
 
 ```typescript
 getEnvFiles(): Promise<string[]> {
-  const possibleFiles = ['.env.production', '.env.local', '.env'];
+  const possibleFiles = ['.env', '.env.local', '.env.production'];
+  const fileService = new FileService();
 
-  try {
-    const fileService = new FileService();
-    const envFile = fileService.getFirstExistingFile(possibleFiles);
-
-    return Promise.resolve([envFile]);
-  } catch {}
-
-  return Promise.resolve([]);
+  return Promise.resolve(fileService.getExistingFiles(possibleFiles));
 }
 ```
 

package/dist/server/index.cjs

@@ -36,13 +36,161 @@ require("hono/utils/handler");
 require("hono/validator");
 let hono_http_exception = require("hono/http-exception");
 //#endregion
-//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@hono/node-server/2.0.10/6be43c83777d669b036e653a8b7e871f80da198738a293161ba1a45b77e87eb5/node_modules/@hono/node-server/dist/index.mjs
+//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@hono/node-server/2.1.3/19d7f8738ee0bdda5c921e6b78e7282a61a457f5cbca86ce0e563f0efa4986d3/node_modules/@hono/node-server/dist/index.mjs
 var RequestError = class extends Error {
 	constructor(message, options) {
 		super(message, options);
 		this.name = "RequestError";
 	}
 };
+const nonJoinedHeaders = /* @__PURE__ */ new Set([
+	"age",
+	"authorization",
+	"content-length",
+	"content-type",
+	"etag",
+	"expires",
+	"from",
+	"host",
+	"if-modified-since",
+	"if-unmodified-since",
+	"last-modified",
+	"location",
+	"max-forwards",
+	"proxy-authorization",
+	"referer",
+	"retry-after",
+	"server",
+	"user-agent"
+]);
+const validHeaderName = /^[!#$%&'*+\-.^_`|~\dA-Za-z]+$/;
+const isHttpWhitespace = (code) => code === 9 || code === 10 || code === 13 || code === 32;
+const normalizeHeaderValue = (value) => {
+	if (!isHttpWhitespace(value.charCodeAt(0)) && !isHttpWhitespace(value.charCodeAt(value.length - 1))) return value;
+	let start = 0;
+	let end = value.length;
+	while (start < end && isHttpWhitespace(value.charCodeAt(start))) start++;
+	while (end > start && isHttpWhitespace(value.charCodeAt(end - 1))) end--;
+	return value.slice(start, end);
+};
+const forbiddenHeaderValue = /[\0\r\n]/;
+const GlobalHeaders = globalThis.Headers;
+const materializeHeaders = (rawHeaders, HeadersCtor = GlobalHeaders) => {
+	const headers = new HeadersCtor();
+	for (let i = 0; i < rawHeaders.length; i += 2) {
+		const name = rawHeaders[i];
+		if (!name.startsWith(":")) headers.append(name, rawHeaders[i + 1]);
+	}
+	return headers;
+};
+var RequestHeaders = class {
+	#incoming;
+	#rawHeaders;
+	#headers;
+	#invalidValue;
+	constructor(incoming) {
+		this.#incoming = incoming;
+		if (incoming instanceof http2.Http2ServerRequest) this.#rawHeaders = incoming.rawHeaders.slice();
+	}
+	get #lazyRawHeaders() {
+		return this.#rawHeaders ??= this.#incoming.rawHeaders.slice();
+	}
+	get #native() {
+		if (!this.#headers) {
+			this.#headers = materializeHeaders(this.#lazyRawHeaders);
+			this.#rawHeaders = void 0;
+		}
+		return this.#headers;
+	}
+	#normalizedName(name) {
+		if (typeof name !== "string") return;
+		if (!validHeaderName.test(name)) throw new TypeError(`Invalid header name: ${name}`);
+		return name.toLowerCase();
+	}
+	#lookupHttp1(lowerName) {
+		const headers = this.#incoming instanceof http2.Http2ServerRequest ? void 0 : this.#incoming.headers;
+		if (!headers || nonJoinedHeaders.has(lowerName) || lowerName === "set-cookie" || lowerName === "__proto__") return;
+		if (!Object.hasOwn(headers, lowerName)) return null;
+		const rawValue = headers[lowerName];
+		if (typeof rawValue === "string") {
+			const value = normalizeHeaderValue(rawValue);
+			return forbiddenHeaderValue.test(value) ? void 0 : value;
+		}
+	}
+	#lookup(rawHeaders, lowerName) {
+		const separator = lowerName === "cookie" ? "; " : ", ";
+		let value = null;
+		for (let i = 0; i < rawHeaders.length; i += 2) {
+			const rawName = rawHeaders[i];
+			if (rawName.length === lowerName.length && rawName.toLowerCase() === lowerName) {
+				const rawValue = normalizeHeaderValue(rawHeaders[i + 1]);
+				if (forbiddenHeaderValue.test(rawValue)) {
+					this.#invalidValue = true;
+					return;
+				}
+				value = value === null ? rawValue : value + separator + rawValue;
+			}
+		}
+		return value;
+	}
+	append(name, value) {
+		this.#native.append(name, value);
+	}
+	delete(name) {
+		this.#native.delete(name);
+	}
+	get(name) {
+		const lowerName = this.#normalizedName(name);
+		if (lowerName && !this.#headers && !this.#invalidValue) {
+			const http1Value = this.#lookupHttp1(lowerName);
+			if (http1Value !== void 0) return http1Value;
+			const value = this.#lookup(this.#lazyRawHeaders, lowerName);
+			if (value !== void 0) return value;
+		}
+		return this.#native.get(name);
+	}
+	has(name) {
+		const lowerName = this.#normalizedName(name);
+		if (lowerName && !this.#headers && !this.#invalidValue) {
+			const http1Value = this.#lookupHttp1(lowerName);
+			if (http1Value !== void 0) return http1Value !== null;
+			const value = this.#lookup(this.#lazyRawHeaders, lowerName);
+			if (value !== void 0) return value !== null;
+		}
+		return this.#native.has(name);
+	}
+	set(name, value) {
+		this.#native.set(name, value);
+	}
+	getSetCookie() {
+		return this.#native.getSetCookie();
+	}
+	keys() {
+		return this.#native.keys();
+	}
+	values() {
+		return this.#native.values();
+	}
+	entries() {
+		return this.#native.entries();
+	}
+	forEach(callback, thisArg) {
+		this.#native.forEach((value, key) => {
+			callback.call(thisArg, value, key, this);
+		});
+	}
+	[Symbol.iterator]() {
+		return this.entries();
+	}
+};
+Object.defineProperty(RequestHeaders.prototype, Symbol.for("nodejs.util.inspect.custom"), { value: function(depth, options, inspectFn) {
+	return `Headers (lightweight) ${inspectFn(Object.fromEntries(this), {
+		...options,
+		depth: depth == null ? null : depth - 1
+	})}`;
+} });
+Object.setPrototypeOf(RequestHeaders.prototype, GlobalHeaders.prototype);
+const newHeadersFromIncoming = (incoming) => globalThis.Headers === GlobalHeaders ? new RequestHeaders(incoming) : materializeHeaders(incoming.rawHeaders, globalThis.Headers);
 const reValidRequestUrl = /^\/[!#$&-;=?-\[\]_a-z~]*$/;
 const reDotSegment = /\/\.\.?(?:[/?#]|$)/;
 const reValidHost = /^[a-z0-9._-]+(?::(?:[1-5]\d{3,4}|[6-9]\d{3}))?$/;
@@ -75,15 +223,6 @@ var Request$1 = class extends GlobalRequest {
 		super(input, options);
 	}
 };
-const newHeadersFromIncoming = (incoming) => {
-	const headerRecord = [];
-	const rawHeaders = incoming.rawHeaders;
-	for (let i = 0, len = rawHeaders.length; i < len; i += 2) {
-		const key = rawHeaders[i];
-		if (key.charCodeAt(0) !== 58) headerRecord.push([key, rawHeaders[i + 1]]);
-	}
-	return new Headers(headerRecord);
-};
 const wrapBodyStream = Symbol("wrapBodyStream");
 const byteExactEncodings = /* @__PURE__ */ new Set([
 	"latin1",
@@ -218,8 +357,10 @@ const normalizeIncomingMethod = (method) => {
 		case "GET":
 		case "HEAD":
 		case "OPTIONS":
+		case "PATCH":
 		case "POST":
-		case "PUT": return method;
+		case "PUT":
+		case "QUERY": return method;
 	}
 	const upper = method.toUpperCase();
 	switch (upper) {
@@ -513,16 +654,15 @@ var Response$1 = class Response$1 {
 	constructor(body, init) {
 		let headers;
 		this.#body = body;
-		if (init instanceof Response$1) {
+		if (init instanceof GlobalResponse) {
 			const cachedGlobalResponse = init[responseCache];
 			if (cachedGlobalResponse) {
 				this.#init = cachedGlobalResponse;
 				this[getResponseCache]();
 				return;
-			} else {
-				this.#init = init.#init;
-				headers = new Headers(init.headers);
 			}
+			this.#init = init instanceof Response$1 ? init.#init : init;
+			headers = new Headers(init.headers);
 		} else this.#init = init;
 		if (body == null || typeof body === "string" || typeof body?.getReader !== "undefined" || body instanceof Blob || body instanceof Uint8Array) this[cacheKey] = [
 			init?.status || 200,
@@ -698,7 +838,10 @@ const drainIncoming = (incoming) => {
 	const forceClose = () => {
 		cleanup();
 		const socket = incoming.socket;
-		if (socket && !socket.destroyed) socket.destroySoon();
+		if (socket && !socket.destroyed) {
+			if (typeof socket.destroySoon === "function") socket.destroySoon();
+			else if (typeof socket.destroy === "function") socket.destroy();
+		}
 	};
 	const timer = setTimeout(forceClose, DRAIN_TIMEOUT_MS);
 	timer.unref?.();
@@ -737,7 +880,10 @@ const handleResponseError = (e, outgoing) => {
 	if (err.code === "ERR_STREAM_PREMATURE_CLOSE") console.info("The user aborted a request.");
 	else {
 		console.error(e);
-		if (!outgoing.headersSent) outgoing.writeHead(500, { "Content-Type": "text/plain" });
+		if (!outgoing.headersSent) {
+			if (outgoing instanceof http.ServerResponse) outgoing._contentLength = null;
+			outgoing.writeHead(500, { "Content-Type": "text/plain" });
+		}
 		outgoing.end(`Error: ${err.message}`);
 		outgoing.destroy(err);
 	}
@@ -745,6 +891,21 @@ const handleResponseError = (e, outgoing) => {
 const flushHeaders = (outgoing) => {
 	if ("flushHeaders" in outgoing && outgoing.writable) outgoing.flushHeaders();
 };
+const trySetContentLength = (outgoing, status, length) => {
+	const http1 = outgoing;
+	if (http1._contentLength === null && http1._hasBody && http1.useChunkedEncodingByDefault && !http1._removedContLen && status >= 200 && status !== 204 && status !== 304 && !outgoing.hasHeader("content-length") && !outgoing.hasHeader("transfer-encoding") && !outgoing.hasHeader("trailer")) {
+		http1._contentLength = length;
+		return true;
+	}
+	return false;
+};
+const writeDefaultHeaders = (outgoing, status, length) => {
+	if (trySetContentLength(outgoing, status, length)) outgoing.writeHead(status, { "Content-Type": defaultContentType });
+	else outgoing.writeHead(status, {
+		"Content-Type": defaultContentType,
+		"Content-Length": length
+	});
+};
 const responseViaCache = async (res, outgoing) => {
 	let [status, body, header] = res[cacheKey];
 	if (!header) {
@@ -752,22 +913,13 @@ const responseViaCache = async (res, outgoing) => {
 			outgoing.writeHead(status);
 			outgoing.end();
 		} else if (typeof body === "string") {
-			outgoing.writeHead(status, {
-				"Content-Type": defaultContentType,
-				"Content-Length": Buffer.byteLength(body)
-			});
+			writeDefaultHeaders(outgoing, status, Buffer.byteLength(body));
 			outgoing.end(body);
 		} else if (body instanceof Uint8Array) {
-			outgoing.writeHead(status, {
-				"Content-Type": defaultContentType,
-				"Content-Length": body.byteLength
-			});
+			writeDefaultHeaders(outgoing, status, body.byteLength);
 			outgoing.end(body);
 		} else if (body instanceof Blob) {
-			outgoing.writeHead(status, {
-				"Content-Type": defaultContentType,
-				"Content-Length": body.size
-			});
+			writeDefaultHeaders(outgoing, status, body.size);
 			outgoing.end(new Uint8Array(await body.arrayBuffer()));
 		} else {
 			outgoing.writeHead(status, { "Content-Type": defaultContentType });
@@ -778,6 +930,8 @@ const responseViaCache = async (res, outgoing) => {
 		return;
 	}
 	let hasContentLength = false;
+	let plainHeaders = false;
+	let canAutoLength = true;
 	if (header instanceof Headers) {
 		hasContentLength = header.has("content-length");
 		header = buildOutgoingHttpHeaders(header, body === null ? void 0 : defaultContentType);
@@ -785,14 +939,25 @@ const responseViaCache = async (res, outgoing) => {
 		const headerObj = new Headers(header);
 		hasContentLength = headerObj.has("content-length");
 		header = buildOutgoingHttpHeaders(headerObj, body === null ? void 0 : defaultContentType);
-	} else for (const key in header) if (key.length === 14 && key.toLowerCase() === "content-length") {
-		hasContentLength = true;
-		break;
+	} else {
+		plainHeaders = true;
+		for (const key in header) {
+			if (key.length === 14 && key.toLowerCase() === "content-length") {
+				hasContentLength = true;
+				break;
+			}
+			if (key.length === 17 && key.toLowerCase() === "transfer-encoding" || key.length === 7 && key.toLowerCase() === "trailer") canAutoLength = false;
+		}
 	}
 	if (!hasContentLength) {
-		if (typeof body === "string") header["Content-Length"] = Buffer.byteLength(body);
-		else if (body instanceof Uint8Array) header["Content-Length"] = body.byteLength;
-		else if (body instanceof Blob) header["Content-Length"] = body.size;
+		let length;
+		if (typeof body === "string") length = Buffer.byteLength(body);
+		else if (body instanceof Uint8Array) length = body.byteLength;
+		else if (body instanceof Blob) length = body.size;
+		if (length !== void 0 && (!plainHeaders || !canAutoLength || !trySetContentLength(outgoing, status, length))) {
+			if (plainHeaders) header = { ...header };
+			header["Content-Length"] = length;
+		}
 	}
 	outgoing.writeHead(status, header);
 	if (body == null) outgoing.end();
@@ -1173,7 +1338,7 @@ const serve = (options, listeningListener) => {
 	return server;
 };
 //#endregion
-//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@hono/node-server/2.0.10/6be43c83777d669b036e653a8b7e871f80da198738a293161ba1a45b77e87eb5/node_modules/@hono/node-server/dist/utils/stream.mjs
+//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@hono/node-server/2.1.3/19d7f8738ee0bdda5c921e6b78e7282a61a457f5cbca86ce0e563f0efa4986d3/node_modules/@hono/node-server/dist/utils/stream.mjs
 const pr54206Applied = () => {
 	const [major, minor] = process$1.versions.node.split(".").map((component) => parseInt(component));
 	return major >= 23 || major === 22 && minor >= 7 || major === 20 && minor >= 18;
@@ -1232,7 +1397,7 @@ const createStreamBody = (stream$2, useNativeReadableToWeb = useReadableToWeb) =
 	});
 };
 //#endregion
-//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@hono/node-server/2.0.10/6be43c83777d669b036e653a8b7e871f80da198738a293161ba1a45b77e87eb5/node_modules/@hono/node-server/dist/serve-static.mjs
+//#region ../../../../../setup-pnpm/node_modules/.bin/store/v11/links/@hono/node-server/2.1.3/19d7f8738ee0bdda5c921e6b78e7282a61a457f5cbca86ce0e563f0efa4986d3/node_modules/@hono/node-server/dist/serve-static.mjs
 const COMPRESSIBLE_CONTENT_TYPE_REGEX = /^\s*(?:text\/[^;\s]+|application\/(?:javascript|json|xml|xml-dtd|ecmascript|dart|postscript|rtf|tar|toml|vnd\.dart|vnd\.ms-fontobject|vnd\.ms-opentype|wasm|x-httpd-php|x-javascript|x-ns-proxy-autoconfig|x-sh|x-tar|x-virtualbox-hdd|x-virtualbox-ova|x-virtualbox-ovf|x-virtualbox-vbox|x-virtualbox-vdi|x-virtualbox-vhd|x-virtualbox-vmdk|x-www-form-urlencoded)|font\/(?:otf|ttf)|image\/(?:bmp|vnd\.adobe\.photoshop|vnd\.microsoft\.icon|vnd\.ms-dds|x-icon|x-ms-bmp)|message\/rfc822|model\/gltf-binary|x-shader\/x-fragment|x-shader\/x-vertex|[^;\s]+?\+(?:json|text|xml|yaml))(?:[;\s]|$)/i;
 const ENCODINGS = {
 	br: ".br",
@@ -1305,6 +1470,7 @@ const serveStatic = (options = { root: "" }) => {
 		let filename;
 		if (optionPath) filename = optionPath;
 		else try {
+			if (!options.allowPercentInPath && c.req.path.includes("%")) throw new Error();
 			filename = tryDecodeURI(c.req.path);
 			if (/(?:^|[\/\\])\.{1,2}(?:$|[\/\\])|[\/\\]{2,}|\\/.test(filename)) throw new Error();
 		} catch {