@prosopo/config 3.3.1 → 3.3.2

package/.turbo/turbo-build$colon$cjs.log

@@ -1,5 +1,5 @@
 
-> @prosopo/config@3.3.1 build:cjs
+> @prosopo/config@3.3.2 build:cjs
 > NODE_ENV=${NODE_ENV:-production}; vite build --config vite.cjs.config.ts --mode $NODE_ENV
 
 ViteCommonJSConfig: .
@@ -29,4 +29,4 @@ rendering chunks...
 dist/cjs/webpack/webpack.config.cjs                       5.05 kB
 dist/cjs/dependencies.cjs                                 5.22 kB
 dist/cjs/vite/vite.frontend.config.cjs                    7.39 kB
-✓ built in 162ms
+✓ built in 219ms

package/.turbo/turbo-build$colon$tsc.log

@@ -1,11 +1,11 @@
 
-> @prosopo/config@3.3.1 build:tsc
+> @prosopo/config@3.3.2 build:tsc
 > tsc --build --verbose
 
-6:47:19 AM - Projects in this build: 
+1:47:41 PM - Projects in this build: 
     * tsconfig.json
 
-6:47:19 AM - Project 'tsconfig.json' is out of date because output file 'tsconfig.tsbuildinfo' does not exist
+1:47:41 PM - Project 'tsconfig.json' is out of date because output file 'tsconfig.tsbuildinfo' does not exist
 
-6:47:19 AM - Building project '/home/runner/work/captcha/captcha/dev/config/tsconfig.json'...
+1:47:41 PM - Building project '/home/runner/work/captcha/captcha/dev/config/tsconfig.json'...
 

package/.turbo/turbo-build.log

@@ -1,9 +1,9 @@
 
-> @prosopo/config@3.3.1 build
+> @prosopo/config@3.3.2 build
 > npm run build:cross-env -- --mode ${NODE_ENV:-development}
 
 
-> @prosopo/config@3.3.1 build:cross-env
+> @prosopo/config@3.3.2 build:cross-env
 > vite build --config vite.esm.config.ts --mode production
 
 ViteEsmConfig: .
@@ -32,4 +32,4 @@ rendering chunks...
 dist/webpack/webpack.config.js                       3.81 kB
 dist/dependencies.js                                 5.02 kB
 dist/vite/vite.frontend.config.js                    7.27 kB
-✓ built in 230ms
+✓ built in 224ms

package/.turbo/turbo-typecheck.log

@@ -1,4 +1,4 @@
 
-> @prosopo/config@3.3.1 typecheck
+> @prosopo/config@3.3.2 typecheck
 > tsc --project tsconfig.types.json
 

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # @prosopo/config
 
+## 3.3.2
+### Patch Changes
+
+- 7a97bba: chore(deps): bump esbuild from 0.25.9 to 0.28.1
+
 ## 3.3.1
 ### Patch Changes
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@prosopo/config",
-	"version": "3.3.1",
+	"version": "3.3.2",
 	"description": "Prosopo config library",
 	"type": "module",
 	"scripts": {
@@ -22,7 +22,7 @@
 		"@rollup/plugin-typescript": "11.1.6",
 		"@rollup/plugin-wasm": "6.2.2",
 		"@vitejs/plugin-react": "5.1.0",
-		"esbuild": "0.25.9",
+		"esbuild": "0.28.1",
 		"fast-glob": "3.3.2",
 		"html-webpack-plugin": "5.6.0",
 		"mini-css-extract-plugin": "2.9.1",
@@ -71,7 +71,8 @@
 	},
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/prosopo/captcha.git"
+		"url": "git+https://github.com/prosopo/captcha.git",
+		"directory": "dev/config"
 	},
 	"bugs": {
 		"url": "https://github.com/prosopo/captcha/issues"

package/src/dependencies.ts

@@ -0,0 +1,246 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import child_process from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import util from "node:util";
+import type { ProjectReference } from "typescript";
+
+const exec = util.promisify(child_process.exec);
+const peerDepsRegex = /UNMET\sOPTIONAL\sDEPENDENCY\s+(@*[\w\-/.]+)@/;
+const depsRegex = /\s+(@*[\w\-/.]+)@/;
+
+const getTsconfigDir = (tsConfigPath: string): string =>
+	".json" === path.extname(tsConfigPath)
+		? path.dirname(tsConfigPath)
+		: tsConfigPath;
+
+async function getPackageDir(packageName: string): Promise<string> {
+	let pkg = packageName;
+	if (packageName && !packageName.startsWith("@prosopo/")) {
+		pkg = `@prosopo/${packageName}`;
+	}
+	const pkgCommand = `npm list ${pkg} -ap`;
+	console.info(`Running command ${pkgCommand}`);
+	// get package directory
+	const { stdout: packageDir, stderr } = await exec(pkgCommand);
+	if (stderr) {
+		if (stderr.includes("ERR!")) {
+			throw new Error("CONFIG.INVALID_PACKAGE_DIR");
+		}
+	}
+	return packageDir.trim() || path.resolve();
+}
+
+/**
+ * Resolve the tsconfig path for a reference using the initial tsconfig path and the reference path. If the reference
+ * does not contain a tsconfig filename, `tsconfig.json` will be appended to the path.
+ * @param initialTsConfigPath
+ * @param reference
+ */
+function getReferenceTsConfigPath(
+	initialTsConfigPath: string,
+	reference: ProjectReference,
+) {
+	// remove tsconfig.*.json from the path and get the path to the new directory via the reference path
+	let refTSConfigPath = path.resolve(
+		getTsconfigDir(initialTsConfigPath),
+		reference.path,
+	);
+	if (!refTSConfigPath.endsWith(".json")) {
+		refTSConfigPath = path.resolve(refTSConfigPath, "tsconfig.json");
+	}
+	return refTSConfigPath;
+}
+
+/**
+ * Get the tsconfig paths for a package
+ * @param tsConfigPath the tsconfig path to start with
+ * @param ignorePatterns the patterns to ignore
+ * @param tsConfigPaths the tsconfig paths to add to
+ * @param includeInitialTsConfig return the initial tsconfig path in the returned array
+ */
+export function getTsConfigs(
+	tsConfigPath: string,
+	ignorePatterns: RegExp[] = [],
+	tsConfigPaths: string[] = [],
+	includeInitialTsConfig = true,
+): string[] {
+	let tsConfigs = [...tsConfigPaths];
+	//TODO use dynamic import with JSON assertion (TS complains that resolveJsonModule is not set)
+	const references = JSON.parse(
+		fs.readFileSync(tsConfigPath).toString(),
+	).references;
+	if (!tsConfigs.includes(tsConfigPath)) {
+		if (references) {
+			const ignore =
+				ignorePatterns && ignorePatterns.length > 0
+					? new RegExp(`${ignorePatterns.join("|")}`)
+					: undefined;
+			if (includeInitialTsConfig) {
+				tsConfigs.push(tsConfigPath);
+			}
+
+			// ignore the packages we don't want to bundle
+			const filteredReferences = references.filter(
+				(reference: ProjectReference) =>
+					ignore ? !ignore.test(reference.path) : false,
+			);
+			// for each reference, get the tsconfig paths - recursively calling this function
+			for (const reference of filteredReferences) {
+				// remove tsconfig.*.json from the path and get the path to the new directory via the reference path
+				const refTSConfigPath = getReferenceTsConfigPath(
+					tsConfigPath,
+					reference,
+				);
+
+				// take the reference TS config path (refTSConfigPath) and get the tsconfig paths for it (newTsConfigs),
+				// adding both to a distinct list, as there may be duplicates
+				const newTsConfigs = getTsConfigs(
+					refTSConfigPath,
+					ignorePatterns,
+					tsConfigs,
+				);
+				if (newTsConfigs.length > 0) {
+					const distinctTsConfigPaths = new Set(tsConfigs.concat(newTsConfigs));
+					tsConfigs = [...distinctTsConfigPaths];
+				}
+			}
+		}
+	}
+	return tsConfigs;
+}
+
+/**
+ * Get the workspace externals for a package
+ * @param tsConfigPath
+ * @param ignorePatterns
+ */
+export async function getExternalsFromReferences(
+	tsConfigPath: string,
+	ignorePatterns: RegExp[] = [],
+): Promise<string[]> {
+	const tsConfigPaths = getTsConfigs(tsConfigPath, ignorePatterns, [], false);
+	console.debug({ tsConfigPaths });
+	const promises: Promise<string>[] = [];
+	for (const refTsConfigPath of tsConfigPaths) {
+		const packageJsonPath = path.resolve(
+			getTsconfigDir(refTsConfigPath),
+			"package.json",
+		);
+		promises.push(
+			new Promise((resolve, reject) => {
+				// if package.json exists, read it and get the package name
+				fs.stat(packageJsonPath, (err) => {
+					if (err) {
+						reject(err);
+					}
+					fs.readFile(packageJsonPath, (err, buffer) => {
+						if (err) {
+							reject(err);
+						} else {
+							const packageJson = JSON.parse(buffer.toString());
+							const pkg = packageJson.name;
+							resolve(pkg);
+						}
+					});
+				});
+			}),
+		);
+	}
+	const externals = await Promise.all(promises);
+	console.debug({ externals });
+	return externals;
+}
+
+/**
+ * Get the dependencies for a package
+ * @param packageName
+ * @param production
+ */
+export async function getDependencies(
+	packageName?: string,
+	production?: boolean,
+): Promise<{ dependencies: string[]; optionalPeerDependencies: string[] }> {
+	let cmd = production
+		? "npm ls -a --silent --omit=dev --package-lock-only"
+		: "npm ls --silent -a --package-lock-only";
+
+	if (packageName) {
+		const packageDir = await getPackageDir(packageName);
+		cmd = `cd ${packageDir.trim()} && ${cmd}`;
+		console.info(`Running command ${cmd} in ${packageDir}`);
+	}
+
+	let concat = "";
+	const { stdout, stderr } = await exec(cmd);
+	concat = stdout + stderr;
+
+	let deps: string[] = [];
+	let peerDeps: string[] = [];
+	// for each line, check if there is an unmet optional dependency
+	for (const line of concat.split("\n")) {
+		if (line.includes("UNMET OPTIONAL DEPENDENCY")) {
+			//  │ │ │   ├── UNMET OPTIONAL DEPENDENCY bufferutil@^4.0.1
+			const parts = line.match(peerDepsRegex);
+			if (parts && parts.length > 1) {
+				peerDeps.push(parts[1] as string);
+			}
+		} else {
+			//  │ │ │ ├─┬ mongodb-memory-server-core@8.15.1
+			const parts = line.match(depsRegex);
+			if (parts && parts.length > 1) {
+				deps.push(parts[1] as string);
+			}
+		}
+	}
+
+	// ensure deps and peerDeps are unique
+	deps = [...new Set(deps)];
+	peerDeps = [...new Set(peerDeps)];
+
+	// dedupe and return deps and peer deps
+	return {
+		dependencies: deps.filter((x, i) => i === deps.indexOf(x)),
+		optionalPeerDependencies: peerDeps.filter(
+			(x, i) => i === peerDeps.indexOf(x),
+		),
+	};
+}
+
+/**
+ * Filter out the dependencies we don't want
+ * @param deps
+ * @param filters
+ */
+export function filterDependencies(
+	deps: string[],
+	filters: string[],
+): { internal: string[]; external: string[] } {
+	const depsDeduped = deps.filter((x, i) => i === deps.indexOf(x));
+	const depsWithLength = depsDeduped.filter((dep) => dep.length > 0).sort();
+	const exclude = new RegExp(`${filters.join("|")}`);
+	// filter out the deps we don't want
+	const internal: string[] = [];
+	const external: string[] = [];
+	for (const dep of depsWithLength) {
+		if (exclude.test(dep)) {
+			external.push(dep);
+		} else {
+			internal.push(dep);
+		}
+	}
+	return { internal, external };
+}

package/src/index.ts

@@ -0,0 +1,16 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export * from "./vite/index.js";
+export * from "./dependencies.js";
+export * from "./webpack/index.js";

package/src/vite/NodejsPolarsDirnamePlugin.ts

@@ -0,0 +1,45 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+export const nodejsPolarsDirnamePlugin = () => {
+	const name = "nodejs-polars-dirname-plugin";
+	return {
+		name,
+		// biome-ignore lint/suspicious/noExplicitAny: TODO not sure of options type
+		resolveId(source: string, importer: string | undefined, options: any) {
+			// aim for the node_modules/nodejs-polars/bin/native-polars.js file
+			if (source.endsWith("nodejs-polars/bin/native-polars.js")) {
+				console.debug(name, "resolves", source, "imported by", importer);
+				// return the source to indicate this plugin can resolve the import
+				return source;
+			}
+			// return null if this plugin can't resolve the import
+			return null;
+		},
+		transform(code: string, id: string) {
+			// aim for the node_modules/nodejs-polars/bin/native-polars.js file
+			if (id.endsWith("nodejs-polars/bin/native-polars.js")) {
+				// replace all instances of __dirname with the path relative to the output bundle
+				console.debug(name, "transform", id);
+				const newCode = code.replaceAll(
+					"__dirname",
+					`new URL(import.meta.url).pathname.split('/').slice(0,-1).join('/')`,
+				);
+				return newCode;
+			}
+			// else return the original code (leave code unrelated to nodejs-polars untouched)
+			return code;
+		},
+	};
+};

package/src/vite/NodejsPolarsNativeFilePlugin.ts

@@ -0,0 +1,83 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import fs from "node:fs";
+import path from "node:path";
+
+export const nodejsPolarsNativeFilePlugin = (
+	nodeFiles: string[],
+	outDir: string,
+) => {
+	const name = "nodejs-polars-native-file-plugin";
+	return {
+		name,
+		// biome-ignore lint/suspicious/noExplicitAny: TODO not sure of options type
+		resolveId(source: string, importer: string | undefined, options: any) {
+			// return the id if this plugin can resolve the import
+			for (const file of nodeFiles) {
+				if (path.basename(source) === path.basename(file)) {
+					console.debug(name, "resolves", source, "imported by", importer);
+					return source;
+				}
+			}
+			return null; // otherwise return null indicating that this plugin can't handle the import
+		},
+		transform(code: string, id: string) {
+			for (const file of nodeFiles) {
+				// rewrite the code to import the .node file
+				if (path.basename(id) === path.basename(file)) {
+					console.debug(name, "transform", id);
+					// https://stackoverflow.com/questions/66378682/nodejs-loading-es-modules-and-native-addons-in-the-same-project
+					// this makes the .node file load at runtime from an esm context. .node files aren't native to esm, so we have to create a custom require function to load them. The custom require function is equivalent to the require function in commonjs, thus allowing the .node file to be loaded.
+					return `
+                        // create a custom require function to load .node files
+                        import { createRequire } from 'module';
+                        const customRequire = createRequire(import.meta.url)
+    
+                        // load the .node file expecting it to be in the same directory as the output bundle
+                        const content = customRequire('./${file}')
+    
+                        // export the content straight back out again
+                        export default content
+                        `;
+				}
+			}
+			return code;
+		},
+		load(id: string) {
+			for (const file of nodeFiles) {
+				if (path.basename(id) === path.basename(file)) {
+					console.debug(name, "load", id);
+					// whenever we encounter an import of the .node file, we return an empty string. This makes it look like the .node file is empty to the bundler. This is because we're going to copy the .node file to the output directory ourselves, so we don't want the bundler to include it in the output bundle (also because the bundler can't handle .node files, it tries to read them as js and then complains that it's invalid js)
+					const newCode = "";
+					return newCode;
+				}
+			}
+			return null;
+		},
+		// biome-ignore lint/suspicious/noExplicitAny: TODO not sure of options/bundle type
+		generateBundle(options: any, bundle: any) {
+			for (const fileAbs of nodeFiles) {
+				const file = path.basename(fileAbs);
+				// copy the .node file to the output directory
+				const out = `${outDir}/${file}`;
+				const src = `${fileAbs}`;
+				console.debug(name, "copy", src, "to", out);
+				const nodeFile = fs.readFileSync(src);
+				fs.mkdirSync(path.dirname(out), { recursive: true });
+				fs.writeFileSync(out, nodeFile);
+			}
+		},
+	};
+};

package/src/vite/TsNoCheckPlugin.ts

@@ -0,0 +1,27 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export function tsNoCheckPlugin() {
+	return {
+		name: "vite-plugin-ts-nocheck",
+		// biome-ignore lint/suspicious/noExplicitAny: TODO not sure of options/bundle type (same as NodejsPolarsNativeFilePlugin)
+		generateBundle(_: any, bundle: any) {
+			for (const fileName in bundle) {
+				const chunk = bundle[fileName];
+				if (chunk.type === "chunk" && chunk.code) {
+					chunk.code = `// @ts-nocheck\n${chunk.code}`;
+				}
+			}
+		},
+	};
+}

package/src/vite/index.ts

@@ -0,0 +1,25 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+export { default as VitePluginCloseAndCopy } from "./vite-plugin-close-and-copy.js";
+export { default as ViteTestConfig } from "./vite.test.config.js";
+export { default as ViteThreadsTestConfig } from "./vite.threads.test.config.js";
+export { default as VitePluginSourceMapExclude } from "./vite-plugin-sourcemap-exclude.js";
+export { default as ViteFrontendConfig } from "./vite.frontend.config.js";
+export { default as ViteBackendConfig } from "./vite.backend.config.js";
+export { default as VitePluginFixAbsoluteImports } from "./vite-plugin-fix-absolute-imports.js";
+export { default as ViteCommonJSConfig } from "./vite.commonjs.config.js";
+export { default as ViteEsmConfig } from "./vite.esm.config.js";
+export { default as VitePluginRemoveUnusedTranslations } from "./vite-plugin-remove-unused-translations.js";
+export * from "./TsNoCheckPlugin.js";
+export { default as VitePluginCopy } from "./vite-plugin-copy.js";

package/src/vite/types.ts

@@ -0,0 +1,13 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.

package/src/vite/vite-plugin-close-and-copy.ts

@@ -0,0 +1,76 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import fs from "node:fs";
+import path from "node:path";
+import type { Plugin } from "vite";
+
+export interface ClosePluginOptions {
+	srcDir: string;
+	destDir: string[];
+}
+
+/**
+ *   description: Closes Vite after the bundle has been build. Optionally copies the bundle to a different directory.
+ *   @param { ClosePluginOptions } options - The options object
+ **/
+export default function VitePluginCloseAndCopy(
+	options?: ClosePluginOptions,
+): Plugin {
+	const __dirname = path.resolve();
+	return {
+		name: "close-plugin", // required, will show up in warnings and errors
+		buildStart() {
+			console.info("Bundle build started");
+		},
+		buildEnd(error) {
+			console.info("Build end");
+			if (error) {
+				console.log(error);
+				console.error(error);
+			}
+		},
+		closeBundle() {
+			if (options) {
+				for (const destDir of options.destDir) {
+					clearOutputDirJS(__dirname, destDir);
+					console.info(`Bundle cleared from ${options.destDir}`);
+					copyBundle(__dirname, options.srcDir, destDir);
+					console.info(`Bundle copied to ${options.destDir}`);
+				}
+				console.info("Bundle closed");
+			}
+		},
+	};
+}
+
+const clearOutputDirJS = (__dirname: string, destDir: string) =>
+	fs
+		.readdirSync(path.resolve(__dirname, destDir))
+		.filter((file) => file.endsWith("js"))
+		.map((file) => {
+			fs.rmSync(path.resolve(__dirname, destDir, file));
+		});
+
+const copyBundle = (__dirname: string, srcDir: string, destDir: string) => {
+	console.info(
+		"Copying",
+		path.resolve(__dirname, srcDir),
+		"to",
+		path.resolve(__dirname, destDir),
+	);
+	fs.cpSync(path.resolve(__dirname, srcDir), path.resolve(__dirname, destDir), {
+		recursive: true,
+	});
+};