@skuba-lib/api 2.1.2 → 2.2.0-add-cdk-NodejsFunction-20260613135656

package/cdk/nodejsFunction/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "main": "../../lib/cdk/nodejsFunction/index.cjs",
+  "module": "../../lib/cdk/nodejsFunction/index.mjs",
+  "types": "../../lib/cdk/nodejsFunction/index.d.cts"
+}

package/cdk/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "main": "../lib/cdk/index.cjs",
+  "module": "../lib/cdk/index.mjs",
+  "types": "../lib/cdk/index.d.cts"
+}

package/lib/buildkite/index.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_buildkite = require("../buildkite-EYIbmVQ4.cjs");
+const require_buildkite = require("../buildkite-Dyd__LF3.cjs");
 exports.annotate = require_buildkite.annotate;
 exports.md = require_buildkite.md;

package/lib/buildkite/index.d.cts

@@ -1,2 +1,2 @@
-import { i as annotate, n as md, r as AnnotationStyle } from "../index-BHREYHx-.cjs";
-export { AnnotationStyle, annotate, md };
+import { i as annotate, n as md, r as AnnotationStyle } from "../index-CNxgBJm_.cjs";
+export { type AnnotationStyle, annotate, md };

package/lib/buildkite/index.d.mts

@@ -1,2 +1,2 @@
-import { i as annotate, n as md, r as AnnotationStyle } from "../index-B-uDtu2-.mjs";
-export { AnnotationStyle, annotate, md };
+import { i as annotate, n as md, r as AnnotationStyle } from "../index-CNxgBJm_.mjs";
+export { type AnnotationStyle, annotate, md };

package/lib/buildkite/index.mjs

@@ -1,2 +1,2 @@
-import { n as md, r as annotate } from "../buildkite-D8p6SH33.mjs";
+import { n as md, r as annotate } from "../buildkite-CJ4a_6Cv.mjs";
 export { annotate, md };

package/lib/{buildkite-D8p6SH33.mjs → buildkite-CJ4a_6Cv.mjs}

@@ -1,6 +1,6 @@
-import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
-import { n as log } from "./error-CTBQVZXj.mjs";
-import { n as exec, r as hasCommand } from "./exec-DuOGnPmx.mjs";
+import { t as __exportAll } from "./chunk-D7D4PA-g.mjs";
+import { n as log } from "./error-BYLsj5YU.mjs";
+import { n as exec, r as hasCommand } from "./exec-CbhqWxN4.mjs";
 //#region src/buildkite/annotate.ts
 const isAnnotationEnabled = async () => Boolean(process.env.BUILDKITE && process.env.BUILDKITE_AGENT_ACCESS_TOKEN && process.env.BUILDKITE_JOB_ID && await hasCommand("buildkite-agent"));
 const MAX_SIZE = 1024 * 1024;

package/lib/{buildkite-EYIbmVQ4.cjs → buildkite-Dyd__LF3.cjs}

@@ -1,5 +1,6 @@
-const require_error = require("./error-DJ-upcVW.cjs");
-const require_exec = require("./exec-DHKlT34S.cjs");
+const require_chunk = require("./chunk-DakpK96I.cjs");
+const require_error = require("./error-DwkbVu3p.cjs");
+const require_exec = require("./exec-BsoJ4pFc.cjs");
 //#region src/buildkite/annotate.ts
 const isAnnotationEnabled = async () => Boolean(process.env.BUILDKITE && process.env.BUILDKITE_AGENT_ACCESS_TOKEN && process.env.BUILDKITE_JOB_ID && await require_exec.hasCommand("buildkite-agent"));
 const MAX_SIZE = 1024 * 1024;
@@ -36,7 +37,7 @@ const annotate = async (markdown, opts = {}) => {
 const md = { terminal: (code) => `\`\`\`term\n${code.replace(/```/g, "\\`\\`\\`")}\n\`\`\`` };
 //#endregion
 //#region src/buildkite/index.ts
-var buildkite_exports = /* @__PURE__ */ require_error.__exportAll({
+var buildkite_exports = /* @__PURE__ */ require_chunk.__exportAll({
 	annotate: () => annotate,
 	md: () => md
 });

package/lib/cdk/bridges/rolldown.mjs

@@ -0,0 +1,49 @@
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { rolldown } from "rolldown";
+//#region src/cdk/nodejsFunction/util.ts
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const BUNDLE_META_FILENAME = ".lambda-bundle-meta";
+const ESM_FORMATS = new Set([
+	"es",
+	"esm",
+	"module"
+]);
+const isEsmFormat = (format) => ESM_FORMATS.has(format ?? "");
+//#endregion
+//#region src/cdk/nodejsFunction/bridges/rolldown.mts
+const [configPath, entry, outputDir] = process.argv.slice(2, 5);
+if (!configPath || !entry || !outputDir) throw new Error("Expected arguments: <configPath> <entry> <outputDir>");
+const asRecord = (value) => isRecord(value) ? value : void 0;
+const asString = (value) => typeof value === "string" ? value : void 0;
+const userConfig = asRecord(asRecord(await import(pathToFileURL(configPath).href))?.default);
+if (!userConfig) throw new Error(`Config file must export a default config object: ${configPath}`);
+const rawOutput = userConfig.output;
+if (Array.isArray(rawOutput) && rawOutput.length !== 1) throw new Error("`output` must be a single output object: NodejsFunction emits a single index.js/index.mjs handler.");
+const baseRaw = asRecord(Array.isArray(rawOutput) ? rawOutput[0] : rawOutput) ?? {};
+if (baseRaw.preserveModules) throw new Error("`output.preserveModules` is not supported: NodejsFunction emits a single index.js/index.mjs handler.");
+if (baseRaw.entryFileNames !== void 0) throw new Error("`output.entryFileNames` is not supported: NodejsFunction names the handler index.js/index.mjs itself.");
+if (userConfig.input !== void 0) throw new Error("`input` is not supported: NodejsFunction sets the bundle entry itself.");
+const format = asString(baseRaw.format) ?? "es";
+const { file: _file, ...baseRest } = baseRaw;
+const { output: _output, ...userConfigRest } = userConfig;
+const inputOptions = {
+	...userConfigRest,
+	input: entry
+};
+const outputOptions = {
+	...baseRest,
+	format,
+	dir: outputDir,
+	entryFileNames: isEsmFormat(format) ? "index.mjs" : "index.js"
+};
+const bundle = await rolldown(inputOptions);
+try {
+	await bundle.write(outputOptions);
+} finally {
+	await bundle.close();
+}
+writeFileSync(join(outputDir, BUNDLE_META_FILENAME), JSON.stringify({ format }));
+//#endregion
+export {};

package/lib/cdk/index.cjs

@@ -0,0 +1,6 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/cdk/normaliseTemplate/index.ts
+const normaliseTemplateJsonString = (json) => json.replace(/"S3Key":"([0-9a-f]+)\.zip"/g, (_, hash) => `"S3Key":"${"x".repeat(hash.length)}.zip"`).replace(/workerCurrentVersion([0-9a-zA-Z]+)"/g, (_, hash) => `workerCurrentVersion${"x".repeat(hash.length)}"`).replaceAll(/"Value":"\d+\.\d+\.\d+-([^"]+)"/g, (_, hash) => `"Value": "x.x.x-${"x".repeat(hash.length)}"`).replaceAll(/"Value":"v\d+\.\d+\.\d+"/g, (_) => "\"Value\": \"vx.x.x\"").replace(/"DD_TAGS":"git.commit.sha:([0-9a-f]+),git.repository_url:([^\"]+)",/g, "").replaceAll(/(layer:Datadog-[^-]+-.+?:)\d+/g, (_, layer) => `${layer}x`);
+const normaliseTemplate = (template) => JSON.parse(normaliseTemplateJsonString(JSON.stringify(template)));
+//#endregion
+exports.normaliseTemplate = normaliseTemplate;

package/lib/cdk/index.d.cts

@@ -0,0 +1,4 @@
+//#region src/cdk/normaliseTemplate/index.d.ts
+declare const normaliseTemplate: (template: object) => unknown;
+//#endregion
+export { normaliseTemplate };

package/lib/cdk/index.d.mts

@@ -0,0 +1,4 @@
+//#region src/cdk/normaliseTemplate/index.d.ts
+declare const normaliseTemplate: (template: object) => unknown;
+//#endregion
+export { normaliseTemplate };

package/lib/cdk/index.mjs

@@ -0,0 +1,5 @@
+//#region src/cdk/normaliseTemplate/index.ts
+const normaliseTemplateJsonString = (json) => json.replace(/"S3Key":"([0-9a-f]+)\.zip"/g, (_, hash) => `"S3Key":"${"x".repeat(hash.length)}.zip"`).replace(/workerCurrentVersion([0-9a-zA-Z]+)"/g, (_, hash) => `workerCurrentVersion${"x".repeat(hash.length)}"`).replaceAll(/"Value":"\d+\.\d+\.\d+-([^"]+)"/g, (_, hash) => `"Value": "x.x.x-${"x".repeat(hash.length)}"`).replaceAll(/"Value":"v\d+\.\d+\.\d+"/g, (_) => "\"Value\": \"vx.x.x\"").replace(/"DD_TAGS":"git.commit.sha:([0-9a-f]+),git.repository_url:([^\"]+)",/g, "").replaceAll(/(layer:Datadog-[^-]+-.+?:)\d+/g, (_, layer) => `${layer}x`);
+const normaliseTemplate = (template) => JSON.parse(normaliseTemplateJsonString(JSON.stringify(template)));
+//#endregion
+export { normaliseTemplate };

package/lib/cdk/nodejsFunction/index.cjs

@@ -0,0 +1,371 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_chunk = require("../../chunk-DakpK96I.cjs");
+let node_fs = require("node:fs");
+node_fs = require_chunk.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_chunk.__toESM(node_path, 1);
+let aws_cdk_lib_aws_lambda = require("aws-cdk-lib/aws-lambda");
+aws_cdk_lib_aws_lambda = require_chunk.__toESM(aws_cdk_lib_aws_lambda, 1);
+let node_child_process = require("node:child_process");
+let aws_cdk_lib = require("aws-cdk-lib");
+aws_cdk_lib = require_chunk.__toESM(aws_cdk_lib, 1);
+let node_url = require("node:url");
+let yaml = require("yaml");
+let node_module = require("node:module");
+//#region src/cdk/nodejsFunction/errors.ts
+var ValidationError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "ValidationError";
+	}
+};
+//#endregion
+//#region src/cdk/nodejsFunction/bridge-path.ts
+const findPackageRoot = (moduleUrl) => {
+	let dir = node_path.dirname((0, node_url.fileURLToPath)(moduleUrl));
+	for (;;) {
+		if (node_fs.existsSync(node_path.join(dir, "package.json"))) return dir;
+		const parent = node_path.dirname(dir);
+		if (parent === dir) throw new ValidationError("Unable to locate the package root to resolve the bundler bridge script.");
+		dir = parent;
+	}
+};
+const BRIDGE_OUTPUT_SEGMENTS = [
+	"lib",
+	"cdk",
+	"bridges",
+	"rolldown.mjs"
+];
+let bridgePath;
+const resolveRolldownBridge = () => bridgePath ??= node_path.join(findPackageRoot(require("url").pathToFileURL(__filename).href), ...BRIDGE_OUTPUT_SEGMENTS);
+//#endregion
+//#region src/cdk/nodejsFunction/util.ts
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const BUNDLE_META_FILENAME = ".lambda-bundle-meta";
+const ESM_FORMATS = new Set([
+	"es",
+	"esm",
+	"module"
+]);
+const isEsmFormat = (format) => ESM_FORMATS.has(format ?? "");
+const parseJsonFile = (filePath) => {
+	try {
+		return JSON.parse(node_fs.readFileSync(filePath, "utf-8"));
+	} catch (err) {
+		throw new ValidationError(`Failed to parse ${filePath} as JSON: ${err.message}`);
+	}
+};
+const findUp = (name, directory = process.cwd()) => {
+	const absoluteDirectory = node_path.resolve(directory);
+	const file = node_path.join(absoluteDirectory, name);
+	if (node_fs.existsSync(file)) return file;
+	const { root } = node_path.parse(absoluteDirectory);
+	if (absoluteDirectory === root) return;
+	return findUp(name, node_path.dirname(absoluteDirectory));
+};
+const extractDependencies = (pkgPath, modules) => {
+	const result = {};
+	const base = (0, node_url.pathToFileURL)(pkgPath);
+	for (const mod of modules) {
+		let modPkgPath;
+		try {
+			modPkgPath = (0, node_module.findPackageJSON)(mod, base);
+		} catch {
+			modPkgPath = void 0;
+		}
+		const parsed = modPkgPath ? parseJsonFile(modPkgPath) : void 0;
+		const version = isRecord(parsed) && typeof parsed.version === "string" ? parsed.version.trim() : void 0;
+		if (!version) throw new ValidationError(`Cannot extract version for module '${mod}'. Check that it's referenced in your package.json or installed.`);
+		result[mod] = version;
+	}
+	return result;
+};
+//#endregion
+//#region src/cdk/nodejsFunction/package-manager.ts
+const PNPM_LOCK = "pnpm-lock.yaml";
+const PNPM_WORKSPACE_FILES = [
+	"pnpm-workspace.yaml",
+	".npmrc",
+	".pnpmfile.cjs",
+	".pnpmfile.mjs"
+];
+const PNPM_INSTALL_COMMAND = [
+	"pnpm",
+	"install",
+	"--config.node-linker=hoisted",
+	"--config.package-import-method=clone-or-copy",
+	"--no-frozen-lockfile"
+];
+const isInside = (parent, child) => {
+	const rel = node_path.relative(node_path.resolve(parent), node_path.resolve(child));
+	return rel === "" || !rel.startsWith("..") && !node_path.isAbsolute(rel);
+};
+const assertPnpm = (name, source, pkgPath) => {
+	if (name !== "pnpm") throw new ValidationError(`Unsupported package manager '${name}' declared in ${source} of ${pkgPath}. NodejsFunction only supports pnpm.`);
+};
+const readPackageManagerMeta = (projectRoot) => {
+	const pkgPath = node_path.join(projectRoot, "package.json");
+	const nearestPackageJson = node_fs.existsSync(pkgPath) ? pkgPath : void 0;
+	if (!nearestPackageJson) return {
+		nearestPackageJson,
+		packageManagerField: void 0
+	};
+	const parsed = parseJsonFile(pkgPath);
+	if (!isRecord(parsed)) return {
+		nearestPackageJson,
+		packageManagerField: void 0
+	};
+	if (isRecord(parsed.devEngines)) {
+		const devEnginesPm = parsed.devEngines.packageManager;
+		if (isRecord(devEnginesPm) && typeof devEnginesPm.name === "string") assertPnpm(devEnginesPm.name, "the `devEngines.packageManager` field", pkgPath);
+	}
+	if (typeof parsed.packageManager === "string") {
+		const m = /^([^@\s]+)@/.exec(parsed.packageManager);
+		if (m) {
+			assertPnpm(m[1], "the `packageManager` field", pkgPath);
+			return {
+				nearestPackageJson,
+				packageManagerField: parsed.packageManager
+			};
+		}
+	}
+	return {
+		nearestPackageJson,
+		packageManagerField: void 0
+	};
+};
+const injectIgnoreScripts = (outputDir) => {
+	const target = node_path.join(outputDir, ".npmrc");
+	const existing = node_fs.existsSync(target) ? node_fs.readFileSync(target, "utf8") : "";
+	if (/^ignore-scripts\s*=/m.test(existing)) return;
+	const sep = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+	node_fs.writeFileSync(target, `${existing}${sep}ignore-scripts=true\n`);
+};
+const copyPatchFile = (relativePath, projectRoot, outputDir, copiedFiles) => {
+	const src = node_path.join(projectRoot, relativePath);
+	const dest = node_path.join(outputDir, relativePath);
+	if (!isInside(projectRoot, src) || !isInside(outputDir, dest)) throw new ValidationError(`Refusing to copy pnpm patch '${relativePath}': it resolves outside the project root or output directory.`);
+	if (!node_fs.existsSync(src)) return;
+	const realSrc = node_fs.realpathSync(src);
+	if (!isInside(node_fs.realpathSync(projectRoot), realSrc)) throw new ValidationError(`Refusing to copy pnpm patch '${relativePath}': it resolves (via symlink) outside the project root.`);
+	node_fs.mkdirSync(node_path.dirname(dest), { recursive: true });
+	node_fs.copyFileSync(realSrc, dest);
+	copiedFiles.push(dest);
+};
+const filterPnpmWorkspaceYaml = (content, nodeModules, projectRoot, outputDir) => {
+	let doc;
+	try {
+		doc = (0, yaml.parse)(content);
+	} catch (err) {
+		throw new ValidationError(`Failed to parse pnpm-workspace.yaml: ${err.message}`);
+	}
+	if (!isRecord(doc) || !("patchedDependencies" in doc)) return {
+		content,
+		copiedFiles: []
+	};
+	const patched = doc.patchedDependencies;
+	const copiedFiles = [];
+	if (isRecord(patched)) for (const [key, value] of Object.entries(patched)) {
+		const pkgName = key.replace(/(?<=.)@[^@]+$/, "");
+		if (!nodeModules.includes(pkgName)) delete patched[key];
+		else if (typeof value === "string" && value) copyPatchFile(value, projectRoot, outputDir, copiedFiles);
+	}
+	if (!isRecord(patched) || Object.keys(patched).length === 0) delete doc.patchedDependencies;
+	return {
+		content: (0, yaml.stringify)(doc),
+		copiedFiles
+	};
+};
+const copyWorkspaceFiles = (projectRoot, outputDir, nodeModules = [], ignoreScripts = false) => {
+	const stagedFiles = [];
+	for (const file of PNPM_WORKSPACE_FILES) {
+		const src = node_path.join(projectRoot, file);
+		if (!node_fs.existsSync(src)) continue;
+		const dest = node_path.join(outputDir, file);
+		if (file === "pnpm-workspace.yaml") {
+			const filtered = filterPnpmWorkspaceYaml(node_fs.readFileSync(src, "utf8"), nodeModules, projectRoot, outputDir);
+			node_fs.writeFileSync(dest, filtered.content);
+			stagedFiles.push(...filtered.copiedFiles);
+		} else node_fs.copyFileSync(src, dest);
+	}
+	if (ignoreScripts) injectIgnoreScripts(outputDir);
+	return stagedFiles;
+};
+//#endregion
+//#region src/cdk/nodejsFunction/bundling.ts
+const SPAWN_MAX_BUFFER = 256 * 1024 * 1024;
+const describeExit = (result) => result.signal != null ? `killed by signal ${result.signal}` : `exited with status ${result.status}`;
+const stderrTail = (stderr) => {
+	if (!stderr) return "";
+	const text = typeof stderr === "string" ? stderr : stderr.toString("utf-8");
+	if (!text) return "";
+	const tail = text.trimEnd().split("\n").slice(-20).join("\n");
+	return tail ? `\n\n${tail}` : "";
+};
+const checkSpawnResult = (result, prefix) => {
+	if (result.error) {
+		if (result.error.code === "ETIMEDOUT") throw new ValidationError(`${prefix} timed out.${stderrTail(result.stderr)}`);
+		throw result.error;
+	}
+	if (result.status !== 0) throw new ValidationError(`${prefix} ${describeExit(result)}.${stderrTail(result.stderr)}`);
+	if (result.stderr) process.stderr.write(result.stderr);
+};
+const writeOutputPackageJson = (outputDir, fields) => {
+	const pkg = {};
+	if (fields.dependencies) pkg.dependencies = fields.dependencies;
+	if (fields.isEsm) pkg.type = "module";
+	if (fields.packageManager) pkg.packageManager = fields.packageManager;
+	if (Object.keys(pkg).length === 0) return;
+	node_fs.writeFileSync(node_path.join(outputDir, "package.json"), JSON.stringify(pkg, null, 2));
+};
+const removeEmptyParentDirs = (startDir, outputDir) => {
+	let dir = startDir;
+	while (dir.startsWith(outputDir + node_path.sep)) {
+		try {
+			node_fs.rmdirSync(dir);
+		} catch {
+			return;
+		}
+		dir = node_path.dirname(dir);
+	}
+};
+var Bundling = class Bundling {
+	props;
+	static bundle(props) {
+		return aws_cdk_lib_aws_lambda.Code.fromAsset(props.projectRoot, {
+			assetHash: props.assetHash,
+			assetHashType: props.assetHash ? aws_cdk_lib.AssetHashType.CUSTOM : aws_cdk_lib.AssetHashType.OUTPUT,
+			bundling: new Bundling(props)
+		});
+	}
+	image;
+	local;
+	constructor(props) {
+		this.props = props;
+		this.image = aws_cdk_lib.DockerImage.fromRegistry("dummy");
+		this.local = this.buildLocalBundling();
+	}
+	buildLocalBundling() {
+		return { tryBundle: (outputDir) => {
+			this.runHooks(this.props.commandHooks?.beforeBundling(this.props.projectRoot, outputDir) ?? [], this.props.projectRoot);
+			this.runBundler(outputDir);
+			const isEsm = this.readBundleMeta(outputDir);
+			const { nodeModules } = this.props;
+			if (nodeModules?.length) this.installNodeModules(outputDir, isEsm, nodeModules);
+			else writeOutputPackageJson(outputDir, { isEsm });
+			this.runHooks(this.props.commandHooks?.afterBundling(this.props.projectRoot, outputDir) ?? [], this.props.projectRoot);
+			return true;
+		} };
+	}
+	runHooks(commands, cwd) {
+		for (const cmd of commands) this.spawn(cmd, [], cwd, `Command hook '${cmd}'`, { shell: true });
+	}
+	runBundler(outputDir) {
+		this.spawn("node", [
+			resolveRolldownBridge(),
+			this.props.bundlerConfig,
+			this.props.entry,
+			outputDir
+		], this.props.projectRoot, "Bundler 'rolldown'");
+	}
+	readBundleMeta(outputDir) {
+		const metaPath = node_path.join(outputDir, BUNDLE_META_FILENAME);
+		if (!node_fs.existsSync(metaPath)) return false;
+		try {
+			const parsed = parseJsonFile(metaPath);
+			return isEsmFormat(isRecord(parsed) && typeof parsed.format === "string" ? parsed.format : void 0);
+		} finally {
+			node_fs.unlinkSync(metaPath);
+		}
+	}
+	installNodeModules(outputDir, isEsm, nodeModules) {
+		const { nearestPackageJson, packageManagerField } = readPackageManagerMeta(this.props.projectRoot);
+		if (!nearestPackageJson) throw new ValidationError("Cannot find a package.json. Using nodeModules requires a package.json.");
+		this.runHooks(this.props.commandHooks?.beforeInstall(this.props.projectRoot, outputDir) ?? [], this.props.projectRoot);
+		writeOutputPackageJson(outputDir, {
+			dependencies: extractDependencies(nearestPackageJson, nodeModules),
+			isEsm,
+			packageManager: packageManagerField
+		});
+		let stagedFiles = [];
+		try {
+			stagedFiles = copyWorkspaceFiles(this.props.projectRoot, outputDir, nodeModules, this.props.ignoreScripts);
+			if (node_fs.existsSync(this.props.depsLockFilePath)) node_fs.copyFileSync(this.props.depsLockFilePath, node_path.join(outputDir, PNPM_LOCK));
+			const [installBin, ...installArgs] = PNPM_INSTALL_COMMAND;
+			this.spawn(installBin, installArgs, outputDir, "Package manager 'pnpm' install");
+		} finally {
+			node_fs.rmSync(node_path.join(outputDir, PNPM_LOCK), { force: true });
+			for (const file of PNPM_WORKSPACE_FILES) node_fs.rmSync(node_path.join(outputDir, file), { force: true });
+			for (const file of stagedFiles) {
+				node_fs.rmSync(file, { force: true });
+				removeEmptyParentDirs(node_path.dirname(file), outputDir);
+			}
+		}
+	}
+	spawn(bin, args, cwd, prefix, opts) {
+		checkSpawnResult((0, node_child_process.spawnSync)(bin, args, {
+			env: process.env,
+			stdio: [
+				"ignore",
+				"inherit",
+				"pipe"
+			],
+			cwd,
+			timeout: this.props.timeout,
+			encoding: "utf-8",
+			maxBuffer: SPAWN_MAX_BUFFER,
+			shell: opts?.shell
+		}), prefix);
+	}
+};
+//#endregion
+//#region src/cdk/nodejsFunction/function.ts
+var NodejsFunction = class extends aws_cdk_lib_aws_lambda.Function {
+	constructor(scope, id, props) {
+		if (props.runtime && props.runtime.family !== aws_cdk_lib_aws_lambda.RuntimeFamily.NODEJS) throw new ValidationError("Only NODEJS runtimes are supported.");
+		const runtime = props.runtime ?? aws_cdk_lib_aws_lambda.Runtime.NODEJS_LATEST;
+		const entry = validateEntry(props.entry);
+		const depsLockFilePath = findLockFile(props.depsLockFilePath);
+		const projectRoot = node_path.resolve(props.projectRoot ?? node_path.dirname(depsLockFilePath));
+		const bundlerConfig = findBundlerConfig(props.bundling.bundlerConfig, projectRoot);
+		const handlerFn = resolveHandlerFn(props.handler);
+		const { entry: _entry, bundling, depsLockFilePath: _depsLockFilePath, projectRoot: _projectRoot, handler: _handler, runtime: _runtime, ...functionOptions } = props;
+		super(scope, id, {
+			...functionOptions,
+			runtime,
+			code: Bundling.bundle({
+				...bundling,
+				bundlerConfig,
+				entry,
+				runtime,
+				depsLockFilePath,
+				projectRoot
+			}),
+			handler: `index.${handlerFn}`
+		});
+	}
+};
+const resolveHandlerFn = (handler) => {
+	const handlerName = (handler ?? "handler").trim();
+	const handlerFn = handlerName.slice(handlerName.lastIndexOf(".") + 1);
+	if (!/^[A-Za-z_$][\w$]*$/.test(handlerFn)) throw new ValidationError(`Invalid handler '${handler}'. Expected an exported function name, optionally prefixed with a file part (e.g. 'handler' or 'index.handler').`);
+	return handlerFn;
+};
+const validateEntry = (entry) => {
+	const base = node_path.basename(entry);
+	if (/\.d\.(c|m)?ts$/i.test(base) || !/\.(js|ts|mjs|mts|cts|cjs)$/i.test(base)) throw new ValidationError("Only JavaScript or TypeScript entry files are supported.");
+	return node_path.resolve(entry);
+};
+const findBundlerConfig = (bundlerConfig, projectRoot) => node_path.isAbsolute(bundlerConfig) ? bundlerConfig : node_path.resolve(projectRoot, bundlerConfig);
+const findLockFile = (depsLockFilePath) => {
+	if (depsLockFilePath) {
+		const resolved = node_path.resolve(depsLockFilePath);
+		if (!node_fs.existsSync(resolved)) throw new ValidationError(`Cannot find a pnpm-lock.yaml file at '${depsLockFilePath}'.`);
+		return resolved;
+	}
+	const lockFile = findUp(PNPM_LOCK);
+	if (!lockFile) throw new ValidationError("Cannot find a pnpm-lock.yaml file. Please specify it with `depsLockFilePath`.");
+	return lockFile;
+};
+//#endregion
+exports.NodejsFunction = NodejsFunction;

package/lib/cdk/nodejsFunction/index.d.cts

@@ -0,0 +1,32 @@
+import * as lambda from "aws-cdk-lib/aws-lambda";
+import { Construct } from "constructs";
+
+//#region src/cdk/nodejsFunction/types.d.ts
+interface ICommandHooks {
+  beforeBundling(inputDir: string, outputDir: string): string[];
+  afterBundling(inputDir: string, outputDir: string): string[];
+  beforeInstall(inputDir: string, outputDir: string): string[];
+}
+interface BundlingOptions {
+  bundlerConfig: string;
+  nodeModules?: string[];
+  commandHooks?: ICommandHooks;
+  assetHash?: string;
+  timeout?: number;
+  ignoreScripts?: boolean;
+}
+//#endregion
+//#region src/cdk/nodejsFunction/function.d.ts
+interface NodejsFunctionProps extends lambda.FunctionOptions {
+  readonly entry: string;
+  readonly handler?: string;
+  readonly runtime?: lambda.Runtime;
+  readonly depsLockFilePath?: string;
+  readonly projectRoot?: string;
+  readonly bundling: BundlingOptions;
+}
+declare class NodejsFunction extends lambda.Function {
+  constructor(scope: Construct, id: string, props: NodejsFunctionProps);
+}
+//#endregion
+export { type BundlingOptions, type ICommandHooks, NodejsFunction, type NodejsFunctionProps };

package/lib/cdk/nodejsFunction/index.d.mts

@@ -0,0 +1,32 @@
+import * as lambda from "aws-cdk-lib/aws-lambda";
+import { Construct } from "constructs";
+
+//#region src/cdk/nodejsFunction/types.d.ts
+interface ICommandHooks {
+  beforeBundling(inputDir: string, outputDir: string): string[];
+  afterBundling(inputDir: string, outputDir: string): string[];
+  beforeInstall(inputDir: string, outputDir: string): string[];
+}
+interface BundlingOptions {
+  bundlerConfig: string;
+  nodeModules?: string[];
+  commandHooks?: ICommandHooks;
+  assetHash?: string;
+  timeout?: number;
+  ignoreScripts?: boolean;
+}
+//#endregion
+//#region src/cdk/nodejsFunction/function.d.ts
+interface NodejsFunctionProps extends lambda.FunctionOptions {
+  readonly entry: string;
+  readonly handler?: string;
+  readonly runtime?: lambda.Runtime;
+  readonly depsLockFilePath?: string;
+  readonly projectRoot?: string;
+  readonly bundling: BundlingOptions;
+}
+declare class NodejsFunction extends lambda.Function {
+  constructor(scope: Construct, id: string, props: NodejsFunctionProps);
+}
+//#endregion
+export { type BundlingOptions, type ICommandHooks, NodejsFunction, type NodejsFunctionProps };