@qzsy/vinext 0.1.12 → 0.1.81

package/dist/cloudflare/project.js

@@ -0,0 +1,243 @@
+import { findInNodeModules, findViteConfigPath } from "../utils/project.js";
+import { createRequire } from "node:module";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/cloudflare/project.ts
+/** Check whether a wrangler config file exists in the given directory. */
+function hasWranglerConfig(root) {
+	return fs.existsSync(path.join(root, "wrangler.jsonc")) || fs.existsSync(path.join(root, "wrangler.json")) || fs.existsSync(path.join(root, "wrangler.toml")) || fs.existsSync(path.join(root, "cloudflare.config.ts"));
+}
+/**
+* Detect the project structure (router, config, worker entry, package name).
+*
+* `root` is an OS-native filesystem path.
+*/
+function detectProject(root) {
+	const hasApp = resolveProjectDir(root, "app") !== null;
+	const hasPages = resolveProjectDir(root, "pages") !== null;
+	const isAppRouter = hasApp;
+	const isPagesRouter = !hasApp && hasPages;
+	const hasViteConfig = findViteConfigPath(root) !== void 0;
+	const wranglerConfigExists = hasWranglerConfig(root);
+	const hasWorkerEntry = fs.existsSync(path.join(root, "worker", "index.ts")) || fs.existsSync(path.join(root, "worker", "index.js"));
+	const hasCloudflarePlugin = findInNodeModules(root, "@cloudflare/vite-plugin") !== null;
+	const hasRscPlugin = findInNodeModules(root, "@vitejs/plugin-rsc") !== null;
+	const hasWrangler = findInNodeModules(root, ".bin/wrangler") !== null || findInNodeModules(root, ".bin/cf") !== null;
+	const pkgPath = path.join(root, "package.json");
+	let pkg = null;
+	if (fs.existsSync(pkgPath)) try {
+		pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+	} catch {}
+	let projectName = path.basename(root);
+	if (pkg?.name && typeof pkg.name === "string") projectName = pkg.name.replace(/^@[^/]+\//, "").toLowerCase().replace(/[^a-z0-9-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+	const hasTypeModule = pkg?.type === "module";
+	let hasISR = false;
+	let hasMDX = detectMDXFromConfig(root);
+	if (isAppRouter) {
+		const appDir = resolveProjectDir(root, "app");
+		if (appDir) {
+			const found = scanTreeForDetection(appDir, {
+				isr: true,
+				mdx: !hasMDX
+			});
+			hasISR = found.isr;
+			hasMDX = hasMDX || found.mdx;
+		}
+	}
+	if (hasPages) {
+		const pagesDir = resolveProjectDir(root, "pages");
+		if (pagesDir) {
+			const found = scanTreeForDetection(pagesDir, {
+				isr: !hasISR,
+				mdx: !hasMDX
+			});
+			hasISR = hasISR || found.isr;
+			hasMDX = hasMDX || found.mdx;
+		}
+	}
+	hasISR = hasISR || detectCacheComponents(root);
+	const allDeps = {
+		...pkg?.dependencies,
+		...pkg?.devDependencies
+	};
+	const hasCodeHike = "codehike" in allDeps;
+	const nativeModulesToStub = detectNativeModules(allDeps);
+	return {
+		root,
+		isAppRouter,
+		isPagesRouter,
+		hasViteConfig,
+		hasWranglerConfig: wranglerConfigExists,
+		hasWorkerEntry,
+		hasCloudflarePlugin,
+		hasRscPlugin,
+		hasWrangler,
+		projectName,
+		hasISR,
+		hasTypeModule,
+		hasMDX,
+		hasCodeHike,
+		nativeModulesToStub
+	};
+}
+/** Matches App Router revalidation or Pages Router static generation exports. */
+const ISR_PATTERN = /export\s+(?:const\s+revalidate\s*=|(?:async\s+)?function\s+getStaticProps\b|const\s+getStaticProps\s*=|\{[^}]*\bgetStaticProps\b[^}]*\})/;
+/** Source extensions whose contents are scanned for the ISR pattern. */
+const ISR_SCANNABLE_EXTENSION = /\.(ts|tsx|js|jsx)$/;
+/**
+* Resolve a project subdirectory (`app`/`pages`), preferring the root-level
+* location and falling back to the `src/` variant. Returns null when neither
+* exists.
+*/
+function resolveProjectDir(root, name) {
+	const rootDir = path.join(root, name);
+	try {
+		if (fs.statSync(rootDir).isDirectory()) return rootDir;
+	} catch {}
+	const srcDir = path.join(root, "src", name);
+	try {
+		if (fs.statSync(srcDir).isDirectory()) return srcDir;
+	} catch {}
+	return null;
+}
+/**
+* Recursively walk `dir` once, evaluating the requested detection predicates
+* per entry. Each flag short-circuits independently: an `.mdx` file sets `mdx`;
+* a scannable source file containing `export const revalidate` sets `isr`. The
+* walk stops as soon as every requested flag is satisfied, so callers that only
+* want one signal don't pay for the other.
+*
+* Replaces the previous pair of single-purpose recursive walkers
+* (`scanDirForPattern` + `scanDirForExtension`) that traversed the same tree
+* twice. Detection semantics are unchanged: same dirs skipped (dotfiles,
+* node_modules), same extension and content tests.
+*/
+function scanTreeForDetection(dir, want) {
+	const found = {
+		isr: false,
+		mdx: false
+	};
+	const walk = (current) => {
+		let entries;
+		try {
+			entries = fs.readdirSync(current, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) {
+			if ((!want.isr || found.isr) && (!want.mdx || found.mdx)) return;
+			const fullPath = path.join(current, entry.name);
+			if (entry.isDirectory()) {
+				if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
+				walk(fullPath);
+			} else if (entry.isFile()) {
+				if (want.mdx && !found.mdx && entry.name.endsWith(".mdx")) found.mdx = true;
+				if (want.isr && !found.isr && ISR_SCANNABLE_EXTENSION.test(entry.name)) try {
+					if (ISR_PATTERN.test(fs.readFileSync(fullPath, "utf-8"))) found.isr = true;
+				} catch {}
+			}
+		}
+	};
+	walk(dir);
+	return found;
+}
+/**
+* Detect MDX usage declared in next.config (`pageExtensions` including "mdx" or
+* an `@next/mdx` import). Filesystem `.mdx` detection is handled separately by
+* the shared app/pages tree walk in `detectProject`.
+*/
+function detectMDXFromConfig(root) {
+	for (const f of [
+		"next.config.ts",
+		"next.config.mts",
+		"next.config.mjs",
+		"next.config.js",
+		"next.config.cjs"
+	]) {
+		const p = path.join(root, f);
+		if (fs.existsSync(p)) try {
+			const content = fs.readFileSync(p, "utf-8");
+			if (/pageExtensions.*mdx/i.test(content) || /@next\/mdx/.test(content)) return true;
+		} catch {}
+	}
+	return false;
+}
+function detectCacheComponents(root) {
+	for (const fileName of [
+		"next.config.ts",
+		"next.config.mts",
+		"next.config.mjs",
+		"next.config.js",
+		"next.config.cjs"
+	]) {
+		const configPath = path.join(root, fileName);
+		if (!fs.existsSync(configPath)) continue;
+		try {
+			if (/\bcacheComponents\s*:\s*true\b/.test(fs.readFileSync(configPath, "utf-8"))) return true;
+		} catch {}
+	}
+	return false;
+}
+/** Known native Node modules that can't run in Workers */
+const NATIVE_MODULES_TO_STUB = [
+	"@resvg/resvg-js",
+	"satori",
+	"lightningcss",
+	"@napi-rs/canvas",
+	"sharp"
+];
+/**
+* Detect native Node modules in the project's merged dependency map that need
+* stubbing for Workers. Accepts the already-built `allDeps` (dependencies +
+* devDependencies) so package.json is not re-read or re-parsed.
+*/
+function detectNativeModules(allDeps) {
+	return NATIVE_MODULES_TO_STUB.filter((mod) => mod in allDeps);
+}
+/**
+* Check if a package is resolvable from a given root directory using
+* Node's module resolution (createRequire). Handles hoisting, pnpm
+* symlinks, monorepos, and Yarn PnP correctly.
+*/
+function isPackageResolvable(root, packageName) {
+	try {
+		createRequire(path.join(root, "package.json")).resolve(packageName);
+		return true;
+	} catch {
+		return false;
+	}
+}
+function getMissingDeps(info, _isResolvable = isPackageResolvable) {
+	const missing = [];
+	if (!info.hasCloudflarePlugin) missing.push({
+		name: "@cloudflare/vite-plugin",
+		version: "latest"
+	});
+	if (!info.hasWrangler) missing.push({
+		name: "wrangler",
+		version: "latest"
+	});
+	if (!_isResolvable(info.root, "@vitejs/plugin-react")) missing.push({
+		name: "@vitejs/plugin-react",
+		version: "latest"
+	});
+	if (info.isAppRouter && !info.hasRscPlugin) missing.push({
+		name: "@vitejs/plugin-rsc",
+		version: "latest"
+	});
+	if (info.isAppRouter) {
+		if (!_isResolvable(info.root, "react-server-dom-webpack")) missing.push({
+			name: "react-server-dom-webpack",
+			version: "latest"
+		});
+	}
+	if (info.hasMDX) {
+		if (!_isResolvable(info.root, "@mdx-js/rollup")) missing.push({
+			name: "@mdx-js/rollup",
+			version: "latest"
+		});
+	}
+	return missing;
+}
+//#endregion
+export { detectProject, getMissingDeps, hasWranglerConfig, isPackageResolvable };

package/dist/cloudflare/tpr.js

@@ -1,7 +1,7 @@
 import { VINEXT_REVALIDATE_HEADER } from "../server/headers.js";
 import { isrCacheKey } from "../server/isr-cache.js";
 import { buildAppPageCacheTags } from "../server/app-page-cache.js";
-import { ENTRY_PREFIX } from "./src/cache/kv-data-adapter.runtime.js";
+import { ENTRY_PREFIX } from "../packages/cloudflare/src/cache/kv-data-adapter.runtime.js";
 import fs from "node:fs";
 import path from "node:path";
 import { spawn } from "node:child_process";

package/dist/config/config-matchers.js

@@ -1,5 +1,5 @@
-import { VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER } from "../server/headers.js";
-import { buildRequestHeadersFromMiddlewareResponse } from "../server/middleware-request-headers.js";
+import { VINEXT_MW_CTX_HEADER, VINEXT_PRERENDER_ROUTE_PARAMS_HEADER, VINEXT_PRERENDER_SECRET_HEADER } from "../utils/protocol-headers.js";
+import { buildRequestHeadersFromMiddlewareResponse } from "../utils/middleware-request-headers.js";
 import { parseCookieHeader } from "../utils/parse-cookie.js";
 //#region src/config/config-matchers.ts
 /**
@@ -526,11 +526,13 @@ function extractConstraint(str, re) {
 *
 * The root path `"/"` is preserved as-is.
 */
-function stripTrailingSlashForConfigMatch(pathname) {
-	return pathname.length > 1 && pathname.endsWith("/") ? pathname.slice(0, -1) : pathname;
+function stripTrailingSlashForConfigMatch(value) {
+	return value.length > 1 && value.endsWith("/") ? value.slice(0, -1) : value;
 }
 function matchConfigPattern(pathname, pattern) {
+	const pathnameHadTrailingSlash = pathname.length > 1 && pathname.endsWith("/");
 	pathname = stripTrailingSlashForConfigMatch(pathname);
+	if (pathnameHadTrailingSlash) pattern = stripTrailingSlashForConfigMatch(pattern);
 	const catchAllAnchor = /:[\w-]+[*+]/.test(pattern);
 	const namedParamCount = (pattern.match(/:[\w-]+/g) || []).length;
 	if (pattern.includes("(") || pattern.includes("\\") || /:[\w-]+[*+][^/]/.test(pattern) || /:[\w-]+\./.test(pattern) || /[^/]:[\w-]+/.test(pattern) || catchAllAnchor && namedParamCount > 1) try {
@@ -628,12 +630,12 @@ function matchConfigPattern(pathname, pattern) {
 */
 function matchRedirect(pathname, redirects, ctx, basePathState = _BASEPATH_DEFAULT) {
 	if (redirects.length === 0) return null;
-	pathname = stripTrailingSlashForConfigMatch(pathname);
+	const normalizedPathname = stripTrailingSlashForConfigMatch(pathname);
 	const index = _getRedirectIndex(redirects);
 	let localeMatch = null;
 	let localeMatchIndex = Infinity;
 	if (index.localeStatic.size > 0) {
-		const noLocaleBucket = index.localeStatic.get(pathname);
+		const noLocaleBucket = index.localeStatic.get(normalizedPathname);
 		if (noLocaleBucket) for (const entry of noLocaleBucket) {
 			if (!entry.optional) continue;
 			if (entry.originalIndex >= localeMatchIndex) continue;
@@ -651,10 +653,10 @@ function matchRedirect(pathname, redirects, ctx, basePathState = _BASEPATH_DEFAU
 			localeMatchIndex = entry.originalIndex;
 			break;
 		}
-		const slashTwo = pathname.indexOf("/", 1);
+		const slashTwo = normalizedPathname.indexOf("/", 1);
 		if (slashTwo !== -1) {
-			const suffix = pathname.slice(slashTwo);
-			const localePart = pathname.slice(1, slashTwo);
+			const suffix = normalizedPathname.slice(slashTwo);
+			const localePart = normalizedPathname.slice(1, slashTwo);
 			const localeBucket = index.localeStatic.get(suffix);
 			if (localeBucket) for (const entry of localeBucket) {
 				if (entry.originalIndex >= localeMatchIndex) continue;
@@ -956,11 +958,13 @@ async function proxyExternalRequest(request, externalUrl) {
 * when evaluating headers, so this parameter is required.
 */
 function matchHeaders(pathname, headers, ctx, basePathState = _BASEPATH_DEFAULT) {
+	const pathnameHadTrailingSlash = pathname.length > 1 && pathname.endsWith("/");
 	pathname = stripTrailingSlashForConfigMatch(pathname);
 	const result = [];
 	for (const rule of headers) {
 		if (!shouldEvaluateRule(rule.basePath, basePathState)) continue;
-		const sourceRegex = getCachedRegex(_compiledHeaderSourceCache, rule.source, () => safeRegExp("^" + escapeHeaderSource(rule.source) + "$"));
+		const source = pathnameHadTrailingSlash ? stripTrailingSlashForConfigMatch(rule.source) : rule.source;
+		const sourceRegex = getCachedRegex(_compiledHeaderSourceCache, source, () => safeRegExp("^" + escapeHeaderSource(source) + "$"));
 		if (sourceRegex && sourceRegex.test(pathname)) {
 			if (rule.has || rule.missing) {
 				if (!checkHasConditions(rule.has, rule.missing, ctx)) continue;

package/dist/config/next-config.d.ts

@@ -107,7 +107,7 @@ type NextConfig = {
   }; /** Custom response headers */
   headers?: () => Promise<NextHeader[]> | NextHeader[]; /** Image optimization config */
   images?: {
-    remotePatterns?: Array<{
+    remotePatterns?: Array<URL | {
       protocol?: string;
       hostname: string;
       port?: string;
@@ -278,8 +278,11 @@ type ResolvedNextConfig = {
   aliases: Record<string, string>; /** Extra allowed origins for dev server access (from allowedDevOrigins). */
   allowedDevOrigins: string[]; /** Extra allowed origins for server action CSRF validation (from experimental.serverActions.allowedOrigins). */
   serverActionsAllowedOrigins: string[]; /** Packages whose barrel imports should be optimized (from experimental.optimizePackageImports). */
-  optimizePackageImports: string[]; /** Inline app CSS into production HTML (from experimental.inlineCss). */
-  inlineCss: boolean; /** Parsed body size limit for server actions in bytes (from experimental.serverActions.bodySizeLimit). Defaults to 1MB. */
+  optimizePackageImports: string[]; /** Packages explicitly requested for server/client transpilation. */
+  transpilePackages: string[]; /** Packages treated as application code by Turbopack's foreign-code condition. */
+  turbopackTranspilePackages: string[]; /** Inline app CSS into production HTML (from experimental.inlineCss). */
+  inlineCss: boolean; /** Enable standalone route-miss 404 handling (from experimental.globalNotFound). */
+  globalNotFound: boolean; /** Parsed body size limit for server actions in bytes (from experimental.serverActions.bodySizeLimit). Defaults to 1MB. */
   serverActionsBodySizeLimit: number; /** Verbatim body size limit config value (e.g. "2mb") for the "Body exceeded {limit} limit" error. Defaults to "1 MB". */
   serverActionsBodySizeLimitLabel: string; /** Route-level expire fallback in seconds for ISR entries with numeric revalidate. */
   expireTime: number;

package/dist/config/next-config.js

@@ -72,6 +72,7 @@ const CONFIG_FILES = [
 	"next.config.cjs"
 ];
 const DEFAULT_EXPIRE_TIME = 31536e3;
+const DEFAULT_TRANSPILED_PACKAGES = ["geist"];
 /**
 * Default cap for the App Router preload `Link` header length, matching the
 * Next.js `defaultConfig.reactMaxHeadersLength`.
@@ -252,6 +253,31 @@ function findNextConfigPath(root) {
 	}
 	return null;
 }
+function hasConfigProperty(config, propertyPath) {
+	let current = config;
+	for (const property of propertyPath.split(".")) {
+		if (!isUnknownRecord(current) || current[property] === void 0) return false;
+		current = current[property];
+	}
+	return true;
+}
+const emittedConfigWarnings = /* @__PURE__ */ new Set();
+function warnConfigOnce(message) {
+	if (emittedConfigWarnings.has(message)) return;
+	emittedConfigWarnings.add(message);
+	console.warn(message);
+}
+function warnDeprecatedConfigOptions(config, root) {
+	const configFileName = path.basename(findNextConfigPath(root) ?? "next.config.js");
+	const warnings = [
+		["experimental.middlewarePrefetch", `\`experimental.middlewarePrefetch\` is deprecated. Please use \`experimental.proxyPrefetch\` instead in ${configFileName}.`],
+		["experimental.middlewareClientMaxBodySize", `\`experimental.middlewareClientMaxBodySize\` is deprecated. Please use \`experimental.proxyClientMaxBodySize\` instead in ${configFileName}.`],
+		["experimental.externalMiddlewareRewritesResolve", `\`experimental.externalMiddlewareRewritesResolve\` is deprecated. Please use \`experimental.externalProxyRewritesResolve\` instead in ${configFileName}.`],
+		["skipMiddlewareUrlNormalize", `\`skipMiddlewareUrlNormalize\` is deprecated. Please use \`skipProxyUrlNormalize\` instead in ${configFileName}.`],
+		["experimental.instrumentationHook", `\`experimental.instrumentationHook\` is no longer needed, because \`instrumentation.js\` is available by default. You can remove it from ${configFileName}.`]
+	];
+	for (const [propertyPath, warning] of warnings) if (hasConfigProperty(config, propertyPath)) warnConfigOnce(warning);
+}
 async function resolveNextConfigInput(config, phase = PHASE_DEVELOPMENT_SERVER) {
 	return await resolveConfigValue(config, phase);
 }
@@ -585,7 +611,10 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 			allowedDevOrigins: [],
 			serverActionsAllowedOrigins: [],
 			optimizePackageImports: [],
+			transpilePackages: [],
+			turbopackTranspilePackages: [...DEFAULT_TRANSPILED_PACKAGES],
 			inlineCss: false,
+			globalNotFound: false,
 			serverActionsBodySizeLimit: 1 * 1024 * 1024,
 			serverActionsBodySizeLimitLabel: "1 MB",
 			expireTime: DEFAULT_EXPIRE_TIME,
@@ -617,6 +646,7 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 		detectNextIntlConfig(root, resolved);
 		return resolved;
 	}
+	warnDeprecatedConfigOptions(config, root);
 	let redirects = [];
 	if (config.redirects) {
 		const result = await config.redirects();
@@ -668,6 +698,7 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 	const rawOptimize = experimental?.optimizePackageImports;
 	const optimizePackageImports = Array.isArray(rawOptimize) ? rawOptimize.filter((x) => typeof x === "string") : [];
 	const inlineCss = experimental?.inlineCss === true;
+	const globalNotFound = experimental?.globalNotFound === true;
 	const prefetchInlining = experimental?.prefetchInlining === true || isUnknownRecord(experimental?.prefetchInlining);
 	const appShells = experimental?.appShells === true;
 	if (appShells) {
@@ -682,6 +713,8 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 	const topLevelServerExternalPackages = Array.isArray(config.serverExternalPackages) ? readStringArray(config.serverExternalPackages) : void 0;
 	const legacyServerComponentsExternal = readStringArray(experimental?.serverComponentsExternalPackages);
 	const serverExternalPackages = topLevelServerExternalPackages ?? legacyServerComponentsExternal;
+	const transpilePackages = readStringArray(config.transpilePackages);
+	const turbopackTranspilePackages = [...transpilePackages, ...DEFAULT_TRANSPILED_PACKAGES];
 	if (experimental?.swcEnvOptions !== void 0) console.warn("[vinext] next.config option \"experimental.swcEnvOptions\" is not applicable and will be ignored (vinext uses Vite, not SWC). A Vite-compatible polyfill solution may be explored in the future.");
 	if (experimental?.rootParams !== void 0) console.warn("[vinext] `experimental.rootParams` is no longer needed, because `next/root-params` is available by default. You can remove it from next.config.(js|mjs|ts).");
 	const useLightningcss = experimental?.useLightningcss === true;
@@ -720,6 +753,16 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 			fallback: applyLocaleToRoutes(rewrites.fallback, i18n, "rewrite", opts)
 		};
 	}
+	const images = resolveImagesConfig(config.images ? {
+		...config.images,
+		remotePatterns: config.images.remotePatterns?.map((pattern) => pattern instanceof URL ? {
+			protocol: pattern.protocol.slice(0, -1),
+			hostname: pattern.hostname,
+			port: pattern.port,
+			pathname: pattern.pathname,
+			search: pattern.search
+		} : { ...pattern })
+	} : void 0, root);
 	const resolved = {
 		env: config.env ?? {},
 		basePath: config.basePath ?? "",
@@ -737,14 +780,17 @@ async function resolveNextConfig(config, root = process.cwd(), options = {}) {
 		redirects,
 		rewrites,
 		headers,
-		images: resolveImagesConfig(config.images, root),
+		images,
 		i18n,
 		mdx,
 		aliases,
 		allowedDevOrigins,
 		serverActionsAllowedOrigins,
 		optimizePackageImports,
+		transpilePackages,
+		turbopackTranspilePackages,
 		inlineCss,
+		globalNotFound,
 		serverActionsBodySizeLimit,
 		serverActionsBodySizeLimitLabel,
 		expireTime: typeof config.expireTime === "number" ? config.expireTime : DEFAULT_EXPIRE_TIME,

package/dist/config/server-external-packages.d.ts

@@ -0,0 +1,4 @@
+//#region src/config/server-external-packages.d.ts
+declare function mergeServerExternalPackages(userPackages?: readonly string[], transpilePackages?: readonly string[]): string[];
+//#endregion
+export { mergeServerExternalPackages };

package/dist/config/server-external-packages.js

@@ -0,0 +1,91 @@
+//#region src/config/server-external-packages.ts
+const DEFAULT_SERVER_EXTERNAL_PACKAGES = [
+	"@alinea/generated",
+	"@appsignal/nodejs",
+	"@aws-sdk/client-s3",
+	"@aws-sdk/s3-presigned-post",
+	"@blockfrost/blockfrost-js",
+	"@highlight-run/node",
+	"@huggingface/transformers",
+	"@jpg-store/lucid-cardano",
+	"@libsql/client",
+	"@mikro-orm/core",
+	"@mikro-orm/knex",
+	"@node-rs/argon2",
+	"@node-rs/bcrypt",
+	"@prisma/client",
+	"@react-pdf/renderer",
+	"@sentry/profiling-node",
+	"@sparticuz/chromium",
+	"@sparticuz/chromium-min",
+	"@statsig/statsig-node-core",
+	"@swc/core",
+	"@xenova/transformers",
+	"@zenstackhq/runtime",
+	"argon2",
+	"autoprefixer",
+	"aws-crt",
+	"bcrypt",
+	"better-sqlite3",
+	"canvas",
+	"chromadb-default-embed",
+	"config",
+	"cpu-features",
+	"cypress",
+	"dd-trace",
+	"eslint",
+	"express",
+	"firebase-admin",
+	"htmlrewriter",
+	"import-in-the-middle",
+	"isolated-vm",
+	"jest",
+	"jsdom",
+	"keyv",
+	"libsql",
+	"mdx-bundler",
+	"mongodb",
+	"mongoose",
+	"newrelic",
+	"next-mdx-remote",
+	"next-seo",
+	"node-cron",
+	"node-pty",
+	"node-web-audio-api",
+	"onnxruntime-node",
+	"oslo",
+	"pg",
+	"pino",
+	"pino-pretty",
+	"pino-roll",
+	"playwright",
+	"playwright-core",
+	"postcss",
+	"prettier",
+	"prisma",
+	"puppeteer",
+	"puppeteer-core",
+	"ravendb",
+	"require-in-the-middle",
+	"rimraf",
+	"sharp",
+	"shiki",
+	"sqlite3",
+	"thread-stream",
+	"ts-morph",
+	"ts-node",
+	"typescript",
+	"vscode-oniguruma",
+	"webpack",
+	"websocket",
+	"zeromq"
+];
+function mergeServerExternalPackages(userPackages = [], transpilePackages = []) {
+	const transpiled = new Set(transpilePackages);
+	const conflicts = userPackages.filter((name) => transpiled.has(name));
+	if (conflicts.length > 0) throw new Error(`The packages specified in the 'transpilePackages' conflict with the 'serverExternalPackages': ${conflicts.join(", ")}`);
+	const defaults = DEFAULT_SERVER_EXTERNAL_PACKAGES.filter((name) => !transpiled.has(name));
+	return [...new Set([...defaults, ...userPackages])];
+}
+//#endregion
+export { mergeServerExternalPackages };