@mastra/deployer 1.50.2-alpha.1 → 1.51.0-alpha.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/deployer
 
+## 1.51.0-alpha.2
+
+### Patch Changes
+
+- Fixed a false-positive LOCAL_STORAGE_PATH preflight error that flagged storage paths like `file:./data.db` that don't exist in your project. The deploy bundler's local-storage detector now excludes everything under `.mastra/.build/` (deployer-generated intermediate chunks), not just `@mastra__*` shim files. Those chunks can carry JSDoc examples from library code (for example `LibSQLStore({ url: 'file:./data.db' })` from `@mastra/core`), which previously blocked `mastra server deploy` and forced `--skip-preflight` even though the user's code had no local storage paths. Local storage paths in your own source files are still detected. ([#19071](https://github.com/mastra-ai/mastra/pull/19071))
+
+- Fixed deploy preflight false positives for env-guarded storage fallbacks. The build now records when a local storage path like `file:./.mastra-demo.db` is only used as a fallback behind an environment variable (for example `process.env.TURSO_DATABASE_URL || "file:./.mastra-demo.db"`), and which environment variables your own code reads, so the deploy preflight can tell dead fallbacks and library-internal variables apart from real problems. ([#19071](https://github.com/mastra-ai/mastra/pull/19071))
+
+  Also fixed another source of false `LOCAL_STORAGE_PATH` errors: dependencies installed via symlinks (pnpm `link:`/`file:`) resolve to paths outside `node_modules` and are no longer treated as your code.
+
+- Updated dependencies [[`e955965`](https://github.com/mastra-ai/mastra/commit/e955965dce575a903e37cf054d28ea99aa48785e), [`860ef7e`](https://github.com/mastra-ai/mastra/commit/860ef7e77d92b63469cbe5857aa1e626197e43e9), [`17e818c`](https://github.com/mastra-ai/mastra/commit/17e818c51a958ba90641b1a959dc38faf8c034e9), [`4451dfe`](https://github.com/mastra-ai/mastra/commit/4451dfe857428e7abcc0261a507a2e186dae6d47), [`1d39058`](https://github.com/mastra-ai/mastra/commit/1d39058e548efd691799985d5c8af2737f1c3bd2)]:
+  - @mastra/core@1.51.0-alpha.2
+  - @mastra/server@1.51.0-alpha.2
+
 ## 1.50.2-alpha.1
 
 ### Patch Changes

package/dist/build/analyze.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkR7M4BT5P_cjs = require('../chunk-R7M4BT5P.cjs');
+var chunkETXDK7YK_cjs = require('../chunk-ETXDK7YK.cjs');
 
 
 
 Object.defineProperty(exports, "analyzeBundle", {
   enumerable: true,
-  get: function () { return chunkR7M4BT5P_cjs.analyzeBundle; }
+  get: function () { return chunkETXDK7YK_cjs.analyzeBundle; }
 });
 //# sourceMappingURL=analyze.cjs.map
 //# sourceMappingURL=analyze.cjs.map

package/dist/build/analyze.js

@@ -1,3 +1,3 @@
-export { analyzeBundle } from '../chunk-WIOL4WMZ.js';
+export { analyzeBundle } from '../chunk-2P62SP4K.js';
 //# sourceMappingURL=analyze.js.map
 //# sourceMappingURL=analyze.js.map

package/dist/build/bundler.cjs

@@ -1,24 +1,24 @@
 'use strict';
 
-var chunk2GJY6H6M_cjs = require('../chunk-2GJY6H6M.cjs');
+var chunkRVRIXED5_cjs = require('../chunk-RVRIXED5.cjs');
 
 
 
 Object.defineProperty(exports, "createBundler", {
   enumerable: true,
-  get: function () { return chunk2GJY6H6M_cjs.createBundler; }
+  get: function () { return chunkRVRIXED5_cjs.createBundler; }
 });
 Object.defineProperty(exports, "getInputOptions", {
   enumerable: true,
-  get: function () { return chunk2GJY6H6M_cjs.getInputOptions; }
+  get: function () { return chunkRVRIXED5_cjs.getInputOptions; }
 });
 Object.defineProperty(exports, "mastraInternalAliasPlugin", {
   enumerable: true,
-  get: function () { return chunk2GJY6H6M_cjs.mastraInternalAliasPlugin; }
+  get: function () { return chunkRVRIXED5_cjs.mastraInternalAliasPlugin; }
 });
 Object.defineProperty(exports, "mastraToolsAliasPlugin", {
   enumerable: true,
-  get: function () { return chunk2GJY6H6M_cjs.mastraToolsAliasPlugin; }
+  get: function () { return chunkRVRIXED5_cjs.mastraToolsAliasPlugin; }
 });
 //# sourceMappingURL=bundler.cjs.map
 //# sourceMappingURL=bundler.cjs.map

package/dist/build/bundler.js

@@ -1,3 +1,3 @@
-export { createBundler, getInputOptions, mastraInternalAliasPlugin, mastraToolsAliasPlugin } from '../chunk-6ARGMWNC.js';
+export { createBundler, getInputOptions, mastraInternalAliasPlugin, mastraToolsAliasPlugin } from '../chunk-B3NI3FBK.js';
 //# sourceMappingURL=bundler.js.map
 //# sourceMappingURL=bundler.js.map

package/dist/build/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkYODVBOD3_cjs = require('../chunk-YODVBOD3.cjs');
-var chunkILNCPWNL_cjs = require('../chunk-ILNCPWNL.cjs');
-var chunkR7M4BT5P_cjs = require('../chunk-R7M4BT5P.cjs');
-var chunk2GJY6H6M_cjs = require('../chunk-2GJY6H6M.cjs');
+var chunkJQLVR7F7_cjs = require('../chunk-JQLVR7F7.cjs');
+var chunkICEWJMSM_cjs = require('../chunk-ICEWJMSM.cjs');
+var chunkETXDK7YK_cjs = require('../chunk-ETXDK7YK.cjs');
+var chunkRVRIXED5_cjs = require('../chunk-RVRIXED5.cjs');
 var chunkVKAFARW6_cjs = require('../chunk-VKAFARW6.cjs');
 var chunkJZRFRUGM_cjs = require('../chunk-JZRFRUGM.cjs');
 
@@ -11,63 +11,63 @@ var chunkJZRFRUGM_cjs = require('../chunk-JZRFRUGM.cjs');
 
 Object.defineProperty(exports, "createWatcher", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.createWatcher; }
+  get: function () { return chunkJQLVR7F7_cjs.createWatcher; }
 });
 Object.defineProperty(exports, "discoverFsAgents", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.discoverFsAgents; }
+  get: function () { return chunkJQLVR7F7_cjs.discoverFsAgents; }
 });
 Object.defineProperty(exports, "discoverFsSingleton", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.discoverFsSingleton; }
+  get: function () { return chunkJQLVR7F7_cjs.discoverFsSingleton; }
 });
 Object.defineProperty(exports, "discoverFsWorkflows", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.discoverFsWorkflows; }
+  get: function () { return chunkJQLVR7F7_cjs.discoverFsWorkflows; }
 });
 Object.defineProperty(exports, "generateFsAgentsModule", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.generateFsAgentsModule; }
+  get: function () { return chunkJQLVR7F7_cjs.generateFsAgentsModule; }
 });
 Object.defineProperty(exports, "generateFsWorkflowsCodegen", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.generateFsWorkflowsCodegen; }
+  get: function () { return chunkJQLVR7F7_cjs.generateFsWorkflowsCodegen; }
 });
 Object.defineProperty(exports, "getServerOptions", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.getServerOptions; }
+  get: function () { return chunkJQLVR7F7_cjs.getServerOptions; }
 });
 Object.defineProperty(exports, "getWatcherInputOptions", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.getInputOptions; }
+  get: function () { return chunkJQLVR7F7_cjs.getInputOptions; }
 });
 Object.defineProperty(exports, "mirrorFsAgentWorkspaces", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.mirrorFsAgentWorkspaces; }
+  get: function () { return chunkJQLVR7F7_cjs.mirrorFsAgentWorkspaces; }
 });
 Object.defineProperty(exports, "prepareFsAgentsEntry", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.prepareFsAgentsEntry; }
+  get: function () { return chunkJQLVR7F7_cjs.prepareFsAgentsEntry; }
 });
 Object.defineProperty(exports, "writeFsAgentsEntry", {
   enumerable: true,
-  get: function () { return chunkYODVBOD3_cjs.writeFsAgentsEntry; }
+  get: function () { return chunkJQLVR7F7_cjs.writeFsAgentsEntry; }
 });
 Object.defineProperty(exports, "getBundlerOptions", {
   enumerable: true,
-  get: function () { return chunkILNCPWNL_cjs.getBundlerOptions; }
+  get: function () { return chunkICEWJMSM_cjs.getBundlerOptions; }
 });
 Object.defineProperty(exports, "analyzeBundle", {
   enumerable: true,
-  get: function () { return chunkR7M4BT5P_cjs.analyzeBundle; }
+  get: function () { return chunkETXDK7YK_cjs.analyzeBundle; }
 });
 Object.defineProperty(exports, "createBundler", {
   enumerable: true,
-  get: function () { return chunk2GJY6H6M_cjs.createBundler; }
+  get: function () { return chunkRVRIXED5_cjs.createBundler; }
 });
 Object.defineProperty(exports, "getBundlerInputOptions", {
   enumerable: true,
-  get: function () { return chunk2GJY6H6M_cjs.getInputOptions; }
+  get: function () { return chunkRVRIXED5_cjs.getInputOptions; }
 });
 Object.defineProperty(exports, "Deps", {
   enumerable: true,

package/dist/build/index.js

@@ -1,7 +1,7 @@
-export { createWatcher, discoverFsAgents, discoverFsSingleton, discoverFsWorkflows, generateFsAgentsModule, generateFsWorkflowsCodegen, getServerOptions, getInputOptions as getWatcherInputOptions, mirrorFsAgentWorkspaces, prepareFsAgentsEntry, writeFsAgentsEntry } from '../chunk-GGNUZ2A6.js';
-export { getBundlerOptions } from '../chunk-UA2DJWFT.js';
-export { analyzeBundle } from '../chunk-WIOL4WMZ.js';
-export { createBundler, getInputOptions as getBundlerInputOptions } from '../chunk-6ARGMWNC.js';
+export { createWatcher, discoverFsAgents, discoverFsSingleton, discoverFsWorkflows, generateFsAgentsModule, generateFsWorkflowsCodegen, getServerOptions, getInputOptions as getWatcherInputOptions, mirrorFsAgentWorkspaces, prepareFsAgentsEntry, writeFsAgentsEntry } from '../chunk-OAWAFG4V.js';
+export { getBundlerOptions } from '../chunk-WCHVXVD5.js';
+export { analyzeBundle } from '../chunk-2P62SP4K.js';
+export { createBundler, getInputOptions as getBundlerInputOptions } from '../chunk-B3NI3FBK.js';
 export { Deps, FileService } from '../chunk-ZL66GDLP.js';
 export { detectRuntime, escapeStudioHtmlValue, injectStudioHtmlConfig, normalizeStudioBase } from '../chunk-WP65JQAT.js';
 //# sourceMappingURL=index.js.map

package/dist/build/plugins/local-storage-detector.d.ts

@@ -3,20 +3,48 @@ export interface LocalStorageDetection {
     value: string;
     hint: string;
     module: string;
+    /**
+     * Name of the env var that guards this literal at runtime, when the
+     * literal is the fallback arm of a `process.env.X || literal` (or `??`)
+     * expression. The CLI preflight uses this to suppress or soften the
+     * error when the guarding var is present in the deploy env.
+     */
+    guardedBy?: string;
+}
+/**
+ * Unified preflight metadata emitted as `preflight-metadata.json`.
+ * Superset of the legacy `preflight-local-paths.json` (which stays emitted
+ * for one release so older CLIs keep working with newer deployers).
+ */
+export interface PreflightMetadata {
+    version: 1;
+    localPaths: LocalStorageDetection[];
+    userEnvRefs: string[];
 }
 /**
  * Rollup plugin that detects host-local storage URLs (e.g. `file:./mastra.db`,
- * `postgres://localhost`) in **user source modules** during bundling.
+ * `postgres://localhost`) in **user source modules** during bundling, and
+ * collects the env vars user code reads via `process.env.X`.
  *
  * Only modules outside `node_modules` (and the deployer's own
- * `.mastra/.build/@mastra__*` shim files) are inspected, so library code
+ * `.mastra/.build/` pre-bundled files) are inspected, so library code
  * (like Agent Builder prompt templates or JSDoc examples in `@mastra/core`)
- * is naturally excluded.  Tree-shaken modules are excluded via
+ * is naturally excluded.  When `rootDir` is given, modules outside it are
+ * also excluded — symlinked dependencies (pnpm `link:`/`file:`) resolve to
+ * real paths that never contain `node_modules`.  Tree-shaken modules are
+ * excluded via
  * `generateBundle` — only modules that actually contribute rendered code to
  * the output are reported.
  *
- * Detected paths are emitted as `preflight-local-paths.json` in the output
- * directory for the CLI preflight check to consume.
+ * When a detected literal is the fallback arm of a `process.env.X || literal`
+ * expression, `guardedBy: "X"` is recorded so the CLI preflight can apply
+ * deploy-time env context instead of hard-erroring on a dead fallback.
+ *
+ * Two assets are emitted into the output directory for the CLI preflight:
+ * - `preflight-metadata.json` — unified metadata (local paths + user env refs)
+ * - `preflight-local-paths.json` — legacy shape, kept for one release so an
+ *   older globally-installed CLI paired with a newer project-local deployer
+ *   doesn't lose the LOCAL_STORAGE_PATH check.
  */
-export declare function localStorageDetector(): Plugin;
+export declare function localStorageDetector(rootDir?: string): Plugin;
 //# sourceMappingURL=local-storage-detector.d.ts.map

package/dist/build/plugins/local-storage-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-storage-detector.d.ts","sourceRoot":"","sources":["../../../src/build/plugins/local-storage-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAqBrC,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAuD7C"}
+{"version":3,"file":"local-storage-detector.d.ts","sourceRoot":"","sources":["../../../src/build/plugins/local-storage-detector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAqBrC,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,qBAAqB,EAAE,CAAC;IACpC,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAgID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAuG7D"}

package/dist/bundler/index.cjs

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunkVQGZXTOJ_cjs = require('../chunk-VQGZXTOJ.cjs');
+var chunkTPS3GZO7_cjs = require('../chunk-TPS3GZO7.cjs');
 
 
 
 Object.defineProperty(exports, "Bundler", {
   enumerable: true,
-  get: function () { return chunkVQGZXTOJ_cjs.Bundler; }
+  get: function () { return chunkTPS3GZO7_cjs.Bundler; }
 });
 Object.defineProperty(exports, "IS_DEFAULT", {
   enumerable: true,
-  get: function () { return chunkVQGZXTOJ_cjs.IS_DEFAULT; }
+  get: function () { return chunkTPS3GZO7_cjs.IS_DEFAULT; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/bundler/index.js

@@ -1,3 +1,3 @@
-export { Bundler, IS_DEFAULT } from '../chunk-JODIXW4D.js';
+export { Bundler, IS_DEFAULT } from '../chunk-RJWPICH3.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{chunk-WIOL4WMZ.js → chunk-2P62SP4K.js}

@@ -1,4 +1,4 @@
-import { getPackageMetadata, protocolExternalResolver, mastraInternalAliasPlugin, mastraToolsAliasPlugin, tsConfigPaths, esbuild, removeDeployer, getPackageRootPath, subpathExternalsResolver, esmShim } from './chunk-6ARGMWNC.js';
+import { getPackageMetadata, protocolExternalResolver, mastraInternalAliasPlugin, mastraToolsAliasPlugin, tsConfigPaths, esbuild, removeDeployer, getPackageRootPath, subpathExternalsResolver, esmShim } from './chunk-B3NI3FBK.js';
 import { slash, isDependencyPartOfPackage, getPackageName, isBuiltinModule, isBareModuleSpecifier, isExternalProtocolImport, getCompiledDepCachePath, rollupSafeName, getNodeResolveOptions } from './chunk-WP65JQAT.js';
 import { existsSync } from 'fs';
 import { readFile, writeFile } from 'fs/promises';
@@ -1504,5 +1504,5 @@ async function analyzeBundle(entries, mastraEntry, {
 }
 
 export { aliasHono, analyzeBundle, getWorkspaceInformation };
-//# sourceMappingURL=chunk-WIOL4WMZ.js.map
-//# sourceMappingURL=chunk-WIOL4WMZ.js.map
+//# sourceMappingURL=chunk-2P62SP4K.js.map
+//# sourceMappingURL=chunk-2P62SP4K.js.map