neon 2.38.5 → 2.39.0

package/README.md

@@ -1,6 +1,6 @@
 # Neon CLI
 
-The `neon` package is a command-line interface that lets you manage [Neon Serverless Postgres](https://neon.tech/) directly from the terminal. For the complete documentation, see [Neon CLI](https://neon.tech/docs/reference/neon-cli).
+The `neon` package is a command-line interface that lets you manage [Neon](https://neon.tech/) — Lakebase Postgres, Object Storage, Functions, Managed Better Auth, and the AI Gateway — directly from the terminal. For the complete documentation, see [Neon CLI](https://neon.tech/docs/reference/neon-cli).
 
 The legacy `neonctl` package is a lightweight compatibility package that depends
 on this package and invokes the same CLI entry point. The implementation and
@@ -529,6 +529,8 @@ neon deploy --branch my-feature --update-existing
 
 Function deploys declared under `preview.functions` are bundled by neon's own esbuild helper and uploaded as part of `apply`, so the policy stays declarative and the packaged CLI never has to embed esbuild's native binary.
 
+When a package cannot be bundled — a native addon with no esbuild loader, or an optional peer dependency a library references on an untaken code path — list it in that function's `externalPackages` and the bundler leaves the import alone. `neon dev` honours the same list. It does not make the package resolvable in the deployed archive (there is no `node_modules` next to the bundle), so it only unblocks an import that is never evaluated — a dependency the handler actually calls has to be bundled, and a natively-backed one cannot be. See [`@neon/config`](../config/README.md#unbundleable-dependencies-externalpackages).
+
 ## Scaffold a project (`bootstrap`)
 
 `neon bootstrap` copies a Neon starter template into a new (or current) directory — conceptually like `degit`, but it only pulls from a small set of templates we maintain in the public [`neondatabase/examples`](https://github.com/neondatabase/examples) repo. It requires no Neon login: it just downloads files from GitHub.

package/dist/commands/config.js

@@ -24,7 +24,11 @@ import { autoPullEnvAfterPin } from "./env.js";
  * out of config-runtime's static module graph — and therefore out of the packaged
  * neonctl snapshot, which resolves esbuild dynamically at deploy time.
  */
-const neonctlBundler = async (fn) => zipBundle(await bundleEntry(fn.source));
+const neonctlBundler = async (fn) => zipBundle(await bundleEntry(fn.source, {
+    ...(fn.externalPackages
+        ? { externalPackages: fn.externalPackages }
+        : {}),
+}));
 const INSPECT_FIELDS = ["project", "branch", "config"];
 /**
  * Shared `--env` flag for `config plan|apply` and `deploy`. Loads a `.env` into

package/dist/commands/dev.js

@@ -182,10 +182,14 @@ const plannedToUnit = (fn, branchEnv, searchBase) => {
         // base) so reconcile can tell a real change from a no-op save. A search-mode function
         // re-planned with a different base must hash identically, or it would be needlessly
         // restarted — see reconcile().
+        ...(fn.externalPackages
+            ? { externalPackages: fn.externalPackages }
+            : {}),
         configKey: JSON.stringify({
             source: fn.source,
             port: fn.port ?? null,
             env: fn.env,
+            externalPackages: fn.externalPackages ?? null,
         }),
     };
 };
@@ -229,7 +233,7 @@ const runSupervisor = async (units, options = {}) => {
     const bundleAndStart = async (r) => {
         let bundlePath;
         try {
-            bundlePath = await writeBundle(r.unit.source, r.unit.bundleDir);
+            bundlePath = await writeBundle(r.unit.source, r.unit.bundleDir, r.unit.externalPackages);
         }
         catch (err) {
             r.status = "error";
@@ -477,8 +481,10 @@ const spawnChild = (unit, runtimePath, bundlePath) => {
         detached: true,
     });
 };
-const writeBundle = async (source, bundleDir) => {
-    const files = await bundleEntry(source);
+const writeBundle = async (source, bundleDir, externalPackages) => {
+    const files = await bundleEntry(source, {
+        ...(externalPackages ? { externalPackages } : {}),
+    });
     mkdirSync(bundleDir, { recursive: true });
     // bundleEntry emits a single `index.mjs` (no source map). The `.mjs` extension makes Node
     // load it as ESM directly, so no `package.json` `"type": "module"` marker is needed.

package/dist/dev/functions.js

@@ -36,6 +36,9 @@ export const resolveFunctionsFromConfig = async (cwd, branchName) => {
                 ? { port: devPort(fn.dev) }
                 : {}),
             env: { ...fn.env },
+            ...(fn.externalPackages
+                ? { externalPackages: [...fn.externalPackages] }
+                : {}),
         };
     });
     return { configPath, functions: planned };

package/dist/utils/esbuild.js

@@ -29,7 +29,7 @@ const toFilesByBasename = (files) => {
         out[basename(f.path)] = f.contents;
     return out;
 };
-const bundleViaModule = async (source, loadEsbuild) => {
+const bundleViaModule = async (source, loadEsbuild, externalPackages) => {
     // esbuild is resolved by a COMPUTED specifier, never the literal string
     // 'esbuild'. Both rollup (bundle step) and @yao-pkg/pkg (binary step)
     // statically scan for literal import()/require() calls and would otherwise
@@ -66,6 +66,8 @@ const bundleViaModule = async (source, loadEsbuild) => {
         // Functions runtime has no node_modules). Node built-ins stay external on
         // platform:'node'. The banner re-creates require/__filename/__dirname for bundled CJS.
         banner: { js: ESM_CJS_INTEROP_BANNER },
+        // Only what the policy declared unbundleable; everything else is still inlined.
+        external: [...externalPackages],
         logLevel: "silent",
     })
         .catch((err) => {
@@ -113,7 +115,7 @@ const runEsbuild = (bin, args) => new Promise((resolve, reject) => {
         resolve({ code, stderr });
     });
 });
-const bundleViaBinary = async (source) => {
+const bundleViaBinary = async (source, externalPackages) => {
     const bin = resolveEsbuild();
     const outDir = mkdtempSync(join(tmpdir(), "neon-fn-bundle-"));
     const outfile = join(outDir, "index.mjs");
@@ -126,6 +128,8 @@ const bundleViaBinary = async (source) => {
             "--format=esm",
             "--platform=node",
             `--banner:js=${ESM_CJS_INTEROP_BANNER}`,
+            // One flag per package, mirroring the module path's `external` array.
+            ...externalPackages.map((pkg) => `--external:${pkg}`),
             "--log-level=error",
         ]);
         if (code !== 0) {
@@ -144,15 +148,18 @@ const bundleViaBinary = async (source) => {
 // Bundle `source` into the files the Functions archive expects, keyed by
 // basename. npm installs bundle in-process via the esbuild module; the packaged
 // binary (and platforms esbuild can't run on) shell out to an esbuild binary.
-export const bundleEntry = async (source, deps = defaultDeps) => {
-    if (deps.isPackaged())
-        return bundleViaBinary(source);
+export const bundleEntry = async (source, options = {}) => {
+    const isPackaged = options.isPackaged ?? defaultDeps.isPackaged;
+    const loadEsbuild = options.loadEsbuild ?? defaultDeps.loadEsbuild;
+    const externalPackages = options.externalPackages ?? [];
+    if (isPackaged())
+        return bundleViaBinary(source, externalPackages);
     try {
-        return await bundleViaModule(source, deps.loadEsbuild);
+        return await bundleViaModule(source, loadEsbuild, externalPackages);
     }
     catch (err) {
         if (err instanceof ModuleNotAvailable)
-            return bundleViaBinary(source);
+            return bundleViaBinary(source, externalPackages);
         throw err;
     }
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "neon",
-  "version": "2.38.5",
-  "description": "CLI tool for Neon Serverless Postgres",
+  "version": "2.39.0",
+  "description": "CLI tool for Neon, the cloud backend primitives built around Lakebase Postgres",
   "keywords": [
     "neon",
     "neonctl",
@@ -47,7 +47,7 @@
     "cliui": "8.0.1",
     "diff": "5.2.0",
     "fflate": "^0.8.3",
-    "neon-init": "0.20.4",
+    "neon-init": "0.20.5",
     "open": "^10.2.0",
     "openid-client": "6.8.1",
     "pg-protocol": "^1.14.0",
@@ -57,9 +57,9 @@
     "yaml": "^2.9.0",
     "yargs": "17.7.2",
     "@neon/sdk": "1.4.0",
-    "@neon/config": "0.10.1",
-    "@neon/config-runtime": "0.10.1",
-    "@neon/env": "0.12.1"
+    "@neon/config": "0.11.0",
+    "@neon/config-runtime": "0.11.0",
+    "@neon/env": "0.12.2"
   },
   "optionalDependencies": {
     "esbuild": "0.28.1"