fix(build): auto-filter non-Linux platform-specific native binaries (#1117)

* fix(build): auto-filter non-Linux platform-specific native binaries from Lambda bundles

Native packages like @swc/core-darwin-arm64 (~22MB) are included by
Next.js output file tracing when building on macOS but are never needed
on Lambda (Linux). This adds automatic detection and exclusion of
darwin/win32/freebsd/android platform binaries during the traced files
copy step, reducing bundle size significantly.

* fix(build): auto-externalize .node native binary imports in esbuild

Add empty loader for .node files in both esbuildSync and esbuildAsync,
preventing build crashes when packages like @swc/core include
platform-specific native binaries that esbuild cannot bundle.

Uses loader: { ".node": "empty" } approach which works for both sync
and async builds, replacing .node imports with empty modules.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix(build): address review feedback — remove android, add bypass env, split esbuild change

- Remove android from platform filter list
- Add OPEN_NEXT_SKIP_PLATFORM_FILTER env variable to bypass the filter
- Revert esbuild .node loader change (to be addressed in a separate PR)

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Author: clichedmoog

.changeset/filter-native-platform-binaries.md

@@ -0,0 +1,5 @@
+---
+"@opennextjs/aws": patch
+---
+
+Auto-filter non-Linux platform-specific native binaries (e.g. @swc/core-darwin-arm64) from Lambda bundles during traced files copy

packages/open-next/src/build/copyTracedFiles.ts

@@ -73,6 +73,18 @@ export function isExcluded(srcPath: string): boolean {
   );
 }
 
+const NON_LINUX_PLATFORMS = ["darwin", "win32", "freebsd"];
+
+const platformPattern = NON_LINUX_PLATFORMS.join("|");
+const nonLinuxPlatformRegex = getCrossPlatformPathRegex(
+  `/node_modules/(?:@[^/]+/)?(?:[^/]+-)?(${platformPattern})-[^/]+/`,
+  { escape: false },
+);
+
+export function isNonLinuxPlatformPackage(srcPath: string): boolean {
+  return nonLinuxPlatformRegex.test(srcPath);
+}
+
 function copyPatchFile(outputDir: string) {
   const patchFile = path.join(__dirname, "patch", "patchedAsyncStorage.js");
   const outputPatchFile = path.join(outputDir, "patchedAsyncStorage.cjs");
@@ -278,11 +290,26 @@ File ${serverPath} does not exist
   const tracedFiles: string[] = [];
   const erroredFiles: string[] = [];
   //Actually copy the files
+  const skippedPlatformPackages = new Set<string>();
   filesToCopy.forEach((to, from) => {
     // We don't want to copy excluded packages (e.g. sharp)
     if (isExcluded(from)) {
       return;
     }
+    // Skip non-Linux platform-specific native binaries (e.g. @swc/core-darwin-arm64)
+    // Set OPEN_NEXT_SKIP_PLATFORM_FILTER=true to bypass this check
+    if (
+      !process.env.OPEN_NEXT_SKIP_PLATFORM_FILTER &&
+      isNonLinuxPlatformPackage(from)
+    ) {
+      const match = from.match(
+        /node_modules\/(?:\.pnpm\/.*\/node_modules\/)?((?:@[^/]+\/)?[^/]+)/,
+      );
+      if (match) {
+        skippedPlatformPackages.add(match[1]);
+      }
+      return;
+    }
     tracedFiles.push(to);
     mkdirSync(path.dirname(to), { recursive: true });
     let symlink = null;
@@ -314,6 +341,13 @@ File ${serverPath} does not exist
     }
   });
 
+  if (skippedPlatformPackages.size > 0) {
+    logger.debug(
+      "Skipped non-Linux platform packages:",
+      [...skippedPlatformPackages].join(", "),
+    );
+  }
+
   readdirSync(standaloneNextDir)
     .filter(
       (fileOrDir) =>

packages/tests-unit/tests/build/copyTracedFiles.test.ts

@@ -1,4 +1,7 @@
-import { isExcluded } from "@opennextjs/aws/build/copyTracedFiles.js";
+import {
+  isExcluded,
+  isNonLinuxPlatformPackage,
+} from "@opennextjs/aws/build/copyTracedFiles.js";
 
 describe("isExcluded", () => {
   test("should exclude sharp", () => {
@@ -40,3 +43,89 @@ describe("isExcluded", () => {
     ).toBe(false);
   });
 });
+
+describe("isNonLinuxPlatformPackage", () => {
+  test("should exclude darwin packages", () => {
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/@swc/core-darwin-arm64/swc.darwin-arm64.node",
+      ),
+    ).toBe(true);
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/@esbuild/darwin-x64/bin/esbuild",
+      ),
+    ).toBe(true);
+  });
+
+  test("should exclude win32 packages", () => {
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/@swc/core-win32-x64-msvc/swc.win32-x64-msvc.node",
+      ),
+    ).toBe(true);
+  });
+
+  test("should exclude freebsd packages", () => {
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/@rollup/rollup-freebsd-x64/rollup.freebsd-x64.node",
+      ),
+    ).toBe(true);
+  });
+
+  test("should keep linux packages", () => {
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/@swc/core-linux-x64-gnu/swc.linux-x64-gnu.node",
+      ),
+    ).toBe(false);
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/@swc/core-linux-arm64-gnu/swc.linux-arm64-gnu.node",
+      ),
+    ).toBe(false);
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/@esbuild/linux-x64/bin/esbuild",
+      ),
+    ).toBe(false);
+  });
+
+  test("should keep non-platform packages", () => {
+    expect(
+      isNonLinuxPlatformPackage("/project/node_modules/@swc/core/index.js"),
+    ).toBe(false);
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/next/dist/server/next-server.js",
+      ),
+    ).toBe(false);
+  });
+
+  test("should work with pnpm store paths", () => {
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/.pnpm/@swc+core-darwin-arm64@1.3.0/node_modules/@swc/core-darwin-arm64/swc.node",
+      ),
+    ).toBe(true);
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/.pnpm/@swc+core-linux-x64-gnu@1.3.0/node_modules/@swc/core-linux-x64-gnu/swc.node",
+      ),
+    ).toBe(false);
+  });
+
+  test("should handle unscoped platform packages", () => {
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/turbo-darwin-arm64/bin/turbo",
+      ),
+    ).toBe(true);
+    expect(
+      isNonLinuxPlatformPackage(
+        "/project/node_modules/turbo-linux-x64/bin/turbo",
+      ),
+    ).toBe(false);
+  });
+});