@w5s/configurator-core 1.0.0-alpha.1

package/dist/index.js

@@ -0,0 +1,433 @@
+import { accessSync, chmodSync, constants, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { access, chmod, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { spawn, spawnSync } from "node:child_process";
+//#region src/__exists.ts
+async function __exists(path) {
+	try {
+		await access(path, constants.F_OK);
+		return true;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+//#region src/__toMode.ts
+function toModeFlag(permissionSet, read, write, execute) {
+	return (permissionSet?.read === true ? read : 0) | (permissionSet?.write === true ? write : 0) | (permissionSet?.execute === true ? execute : 0);
+}
+function __toMode(mode) {
+	return mode == null ? mode : toModeFlag(mode.owner, 256, 128, 64) | toModeFlag(mode.group, 32, 16, 8) | toModeFlag(mode.other, 4, 2, 1);
+}
+//#endregion
+//#region src/__existsSync.ts
+function __existsSync(path) {
+	try {
+		accessSync(path, constants.F_OK);
+		return true;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+//#region src/directory.ts
+/**
+* Ensure directory is present/absent
+*
+* @example
+* ```ts
+* await directory({
+*   path: 'foo/bar',
+*   state: 'present',
+*   mode: {
+*     owner: { read: true, write: true, execute: true },
+*     group: { read: true, write: true, execute: true },
+*     other: { read: true, write: true, execute: true },
+*   },
+* })
+* ```
+*
+* @param options
+*/
+async function directory(options) {
+	const { path, state, mode } = options;
+	const isPresent = await __exists(path);
+	if (state === "present") {
+		const newMode = __toMode(mode);
+		if (!isPresent) await mkdir(path, {
+			recursive: true,
+			mode: newMode
+		});
+		if (newMode != null && isPresent) await chmod(path, newMode);
+	} else if (isPresent) await rm(path, { recursive: true });
+}
+/**
+* Ensure directory is present/absent
+*
+* @example
+* ```ts
+* directorySync({
+*   path: 'foo/bar',
+*   state: 'present',
+*   mode: {
+*     owner: { read: true, write: true, execute: true },
+*     group: { read: true, write: true, execute: true },
+*     other: { read: true, write: true, execute: true },
+*   },
+* })
+* ```
+*
+* @param options
+*/
+function directorySync(options) {
+	const { path, state, mode } = options;
+	const isPresent = __existsSync(path);
+	if (state === "present") {
+		const newMode = __toMode(mode);
+		if (!isPresent) mkdirSync(path, {
+			recursive: true,
+			mode: newMode
+		});
+		if (newMode != null && isPresent) chmodSync(path, newMode);
+	} else if (isPresent) rmSync(path, { recursive: true });
+}
+//#endregion
+//#region src/file.ts
+/**
+* Ensure file is present/absent with content initialized or modified with `update
+*
+* @example
+* ```ts
+* await file({
+*   path: 'foo/bar',
+*   state: 'present',
+*   update: (content) => content + '_test', // This will append '_test' after current content
+*   mode: {
+*     owner: { read: true, write: true, execute: true },
+*     group: { read: true, write: true, execute: true },
+*     other: { read: true, write: true, execute: true },
+*   },
+* })
+* ```
+*
+* @param options
+*/
+async function file(options) {
+	const { path, state, update, encoding = "utf8", mode } = options;
+	if (state === "present") {
+		const isPresent = await __exists(path);
+		const previousContent = isPresent ? await readFile(path, encoding) : "";
+		const newContent = update == null ? isPresent ? void 0 : "" : update(previousContent);
+		const newMode = __toMode(mode);
+		if (newContent != null) await writeFile(path, newContent, {
+			encoding,
+			mode: newMode
+		});
+		if (newMode != null && (isPresent || newContent != null)) await chmod(path, newMode);
+	} else await rm(path, { force: true });
+}
+/**
+* Ensure file is present/absent with content initialized or modified with `update
+*
+* @example
+* ```ts
+* fileSync({
+*   path: 'foo/bar',
+*   state: 'present',
+*   update: (content) => content + '_test', // This will append '_test' after current content
+*   mode: {
+*     owner: { read: true, write: true, execute: true },
+*     group: { read: true, write: true, execute: true },
+*     other: { read: true, write: true, execute: true },
+*   },
+* })
+* ```
+*
+* @param options
+*/
+function fileSync(options) {
+	const { path, state, update, encoding = "utf8", mode } = options;
+	if (state === "present") {
+		const isPresent = __existsSync(path);
+		const previousContent = isPresent ? readFileSync(path, encoding) : "";
+		const newContent = update == null ? isPresent ? void 0 : "" : update(previousContent);
+		const newMode = __toMode(mode);
+		if (newContent != null) writeFileSync(path, newContent, {
+			encoding,
+			mode: newMode
+		});
+		if (newMode != null && (isPresent || newContent != null)) chmodSync(path, newMode);
+	} else rmSync(path, { force: true });
+}
+//#endregion
+//#region src/block.ts
+const EOF = "EndOfFile";
+const BOF = "BeginningOfFile";
+const insertAt = (str, index, toInsert) => str.slice(0, index) + toInsert + str.slice(index);
+const matchLast = (string, regexp) => {
+	const matcher = new RegExp(regexp.source, `${regexp.flags}g`);
+	let firstIndex = -1;
+	let lastIndex = -1;
+	let matches;
+	while (true) {
+		matches = matcher.exec(string);
+		if (matches == null) break;
+		firstIndex = matches.index;
+		lastIndex = matcher.lastIndex;
+	}
+	return {
+		firstIndex,
+		lastIndex
+	};
+};
+function toFileOptions(options) {
+	const { marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`, path, block: blockName, insertPosition = ["after", EOF], state = "present" } = options;
+	const EOL = "\n";
+	const beginBlock = marker("Begin");
+	const endBlock = marker("End");
+	/**
+	* @param content
+	*/
+	function findBlock(content) {
+		const startIndex = content.indexOf(beginBlock);
+		const endIndex = content.indexOf(endBlock) + endBlock.length;
+		return {
+			endIndex,
+			exists: startIndex !== -1 && endIndex >= 0,
+			startIndex
+		};
+	}
+	function apply(fullContent, blockContent) {
+		const found = findBlock(fullContent);
+		const remove = state === "absent";
+		const replaceBlock = remove ? "" : beginBlock + EOL + blockContent + EOL + endBlock;
+		const [positionDirection, positionAnchor] = insertPosition;
+		if (found.exists) return fullContent.slice(0, found.startIndex) + replaceBlock + fullContent.slice(found.endIndex);
+		if (remove) return fullContent;
+		switch (positionDirection) {
+			case "before":
+				if (positionAnchor !== BOF) {
+					const { firstIndex } = matchLast(fullContent, positionAnchor);
+					if (firstIndex >= 0) return insertAt(fullContent, firstIndex, replaceBlock + EOL);
+				}
+				return replaceBlock + EOL + fullContent;
+			case "after":
+				if (positionAnchor !== EOF) {
+					const { lastIndex } = matchLast(fullContent, positionAnchor);
+					if (lastIndex >= 0) return insertAt(fullContent, lastIndex, EOL + replaceBlock);
+				}
+				return fullContent + EOL + replaceBlock;
+			default: throw new Error(`Unsupported position ${String(positionDirection)}`);
+		}
+	}
+	return {
+		path,
+		state: "present",
+		update: (sourceContent) => apply(sourceContent, blockName)
+	};
+}
+/**
+* Replace asynchronously a block in file that follows pattern :
+*
+* marker(markerBegin)
+* ...
+* marker(markerEnd)
+*
+* @param options
+*/
+function block(options) {
+	return file(toFileOptions(options));
+}
+/**
+* Replace synchronously a block in file that follows pattern :
+*
+* marker(markerBegin)
+* ...
+* marker(markerEnd)
+*
+* @param options
+*/
+function blockSync(options) {
+	return fileSync(toFileOptions(options));
+}
+//#endregion
+//#region src/json.ts
+function toFileOption({ update, ...otherOptions }) {
+	return {
+		...otherOptions,
+		update: update == null ? update : (content) => {
+			const jsonValue = content === "" ? void 0 : JSON.parse(content);
+			return JSON.stringify(update(jsonValue));
+		}
+	};
+}
+/**
+* Ensure file is present/absent asynchronously with content value initialized or modified with `update`
+*
+* @param options
+*/
+async function json(options) {
+	return file(toFileOption(options));
+}
+/**
+* Ensure file is present/absent synchronously with content value initialized or modified with `update`
+*
+* @param options
+*/
+function jsonSync(options) {
+	return fileSync(toFileOption(options));
+}
+//#endregion
+//#region src/meta.ts
+const meta = Object.freeze({
+	name: "@w5s/configurator-core",
+	version: "1.0.0-alpha.1",
+	buildNumber: 1
+});
+//#endregion
+//#region src/exec.ts
+/**
+* Runs a command in a shell and returns a promise that resolves with an object
+* containing the stdout and stderr strings.
+*
+* @param command The command to run
+* @param args The arguments to pass to the command
+* @param options
+* @returns A promise that resolves with an object like `{ stdout: string, stderr: string }`
+*/
+function execSync(command, args, options) {
+	const result = spawnSync(command, args, { ...options });
+	const encoding = "utf8";
+	return {
+		stdout: result.stdout.toString(encoding),
+		stderr: result.stderr.toString(encoding)
+	};
+}
+/**
+* Runs a command in a shell and returns a promise that resolves with an object
+* containing the stdout and stderr strings.
+*
+* @param command The command to run
+* @param args The arguments to pass to the command
+* @param options
+*/
+async function exec(command, args, options) {
+	return new Promise((resolve, reject) => {
+		const encoding = "utf8";
+		const child = spawn(command, args, { ...options });
+		let stdout = "";
+		let stderr = "";
+		if (child.stdout != null) child.stdout.on("data", (data) => {
+			stdout += data.toString(encoding);
+		});
+		if (child.stderr != null) child.stderr.on("data", (data) => {
+			stderr += data.toString(encoding);
+		});
+		child.on("close", (_code) => {
+			resolve({
+				stdout,
+				stderr
+			});
+		});
+		child.on("error", reject);
+	});
+}
+//#endregion
+//#region src/yarnConfig.ts
+/**
+* Synchronous version of {@link yarnConfig}
+*
+* @param options
+* @example
+* yarnConfigSync({
+*   key: 'nodeLinker',
+*   state: 'present',
+*   update: (content) => content.replace('node-modules', 'hoisted'),
+* })
+*/
+function yarnConfigSync(options) {
+	const { key, state, update } = options;
+	if (state === "present") {
+		const { stdout } = execSync("yarn", [
+			"config",
+			"get",
+			String(key)
+		]);
+		execSync("yarn", [
+			"config",
+			"set",
+			String(key),
+			`${update == null ? "" : update(stdout)}`
+		]);
+	} else execSync("yarn", ["config", "unset"]);
+}
+/**
+* Set/Unset yarn configuration value
+*
+* @param options
+* @example
+* await yarnConfig({
+*   key: 'nodeLinker',
+*   state: 'present',
+*   update: (content) => content.replace('node-modules', 'hoisted'),
+* })
+*/
+async function yarnConfig(options) {
+	const { key, state, update } = options;
+	if (state === "present") {
+		const { stdout } = await exec("yarn", [
+			"config",
+			"get",
+			String(key)
+		]);
+		await exec("yarn", [
+			"config",
+			"set",
+			String(key),
+			`${update == null ? "" : update(stdout)}`
+		]);
+	} else await exec("yarn", ["config", "unset"]);
+}
+//#endregion
+//#region src/yarnVersion.ts
+/**
+* Synchronous version of {@link yarnVersion}
+*
+* @param options
+* @example
+* yarnVersionSync({
+*   state: 'present',
+*   update: () => 'berry', // or 'classic'
+* })
+*/
+function yarnVersionSync(options) {
+	const { state, update } = options;
+	if (state === "present") execSync("yarn", [
+		"set",
+		"version",
+		`${update == null ? "berry" : update()}`
+	]);
+	else throw new Error("Not implemented");
+}
+/**
+* Set/Unset yarn configuration value
+*
+* @param options
+* @example
+* await yarnVersion({
+*   state: 'present',
+*   update: () => 'berry', // or 'classic'
+* })
+*/
+async function yarnVersion(options) {
+	const { state, update } = options;
+	if (state === "present") await exec("yarn", [
+		"set",
+		"version",
+		`${update == null ? "berry" : update()}`
+	]);
+	else throw new Error("Not implemented");
+}
+//#endregion
+export { block, blockSync, directory, directorySync, file, fileSync, json, jsonSync, meta, yarnConfig, yarnConfigSync, yarnVersion, yarnVersionSync };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/__exists.ts","../src/__toMode.ts","../src/__existsSync.ts","../src/directory.ts","../src/file.ts","../src/block.ts","../src/json.ts","../src/meta.ts","../src/exec.ts","../src/yarnConfig.ts","../src/yarnVersion.ts"],"sourcesContent":["import { access } from 'node:fs/promises';\nimport { constants } from 'node:fs';\n\nexport async function __exists(path: string) {\n  try {\n    await access(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n","import type { FileMode, FilePermissionSet } from './FileMode.js';\n\nfunction toModeFlag(permissionSet: FilePermissionSet | undefined, read: number, write: number, execute: number): number {\n  return (\n    (permissionSet?.read === true ? read : 0)\n    | (permissionSet?.write === true ? write : 0)\n    | (permissionSet?.execute === true ? execute : 0)\n  );\n}\n\nexport function __toMode(mode: FileMode | undefined): number | undefined {\n  return mode == null\n    ? mode\n    : (\n        toModeFlag(mode.owner, 0o400, 0o200, 0o100)\n        | toModeFlag(mode.group, 0o040, 0o020, 0o010)\n        | toModeFlag(mode.other, 0o004, 0o002, 0o001)\n      );\n}\n","import { accessSync, constants } from 'node:fs';\n\nexport function __existsSync(path: string) {\n  try {\n    accessSync(path, constants.F_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n","import { chmodSync, mkdirSync, rmSync } from 'node:fs';\nimport { chmod, mkdir, rm } from 'node:fs/promises';\nimport { __exists } from './__exists.js';\nimport type { FileMode } from './FileMode.js';\nimport { __toMode } from './__toMode.js';\nimport { __existsSync } from './__existsSync.js';\n\nexport interface DirectoryOptions {\n  /**\n   * Directory path\n   */\n  readonly path: string;\n\n  /**\n   * Directory target state\n   */\n  readonly state: 'present' | 'absent';\n\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n}\n\n/**\n * Ensure directory is present/absent\n *\n * @example\n * ```ts\n * await directory({\n *   path: 'foo/bar',\n *   state: 'present',\n *   mode: {\n *     owner: { read: true, write: true, execute: true },\n *     group: { read: true, write: true, execute: true },\n *     other: { read: true, write: true, execute: true },\n *   },\n * })\n * ```\n *\n * @param options\n */\nexport async function directory(options: DirectoryOptions): Promise<void> {\n  const { path, state, mode } = options;\n  const isPresent = await __exists(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      await mkdir(path, { recursive: true, mode: newMode });\n    }\n    if (newMode != null && isPresent) {\n      await chmod(path, newMode);\n    }\n  } else if (isPresent) {\n    await rm(path, { recursive: true });\n  }\n}\n\n/**\n * Ensure directory is present/absent\n *\n * @example\n * ```ts\n * directorySync({\n *   path: 'foo/bar',\n *   state: 'present',\n *   mode: {\n *     owner: { read: true, write: true, execute: true },\n *     group: { read: true, write: true, execute: true },\n *     other: { read: true, write: true, execute: true },\n *   },\n * })\n * ```\n *\n * @param options\n */\nexport function directorySync(options: DirectoryOptions): void {\n  const { path, state, mode } = options;\n  const isPresent = __existsSync(path);\n  if (state === 'present') {\n    const newMode = __toMode(mode);\n    if (!isPresent) {\n      mkdirSync(path, { recursive: true, mode: newMode });\n    }\n    if (newMode != null && isPresent) {\n      chmodSync(path, newMode);\n    }\n  } else if (isPresent) {\n    rmSync(path, { recursive: true });\n  }\n}\n","import { chmod, readFile, rm, writeFile } from 'node:fs/promises';\nimport { chmodSync, readFileSync, rmSync, writeFileSync } from 'node:fs';\nimport { __exists } from './__exists.js';\nimport { __existsSync } from './__existsSync.js';\nimport type { FileMode } from './FileMode.js';\nimport { __toMode } from './__toMode.js';\n\nexport interface FileOptions {\n  /**\n   * File path\n   */\n  readonly path: string;\n\n  /**\n   * File target state\n   */\n  readonly state: 'present' | 'absent';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\n\n  /**\n   * File encoding\n   */\n  readonly encoding?: BufferEncoding;\n\n  /**\n   * File permissions\n   */\n  readonly mode?: FileMode;\n}\n\n/**\n * Ensure file is present/absent with content initialized or modified with `update\n *\n * @example\n * ```ts\n * await file({\n *   path: 'foo/bar',\n *   state: 'present',\n *   update: (content) => content + '_test', // This will append '_test' after current content\n *   mode: {\n *     owner: { read: true, write: true, execute: true },\n *     group: { read: true, write: true, execute: true },\n *     other: { read: true, write: true, execute: true },\n *   },\n * })\n * ```\n *\n * @param options\n */\nexport async function file(options: FileOptions): Promise<void> {\n  const { path, state, update, encoding = 'utf8', mode } = options;\n  if (state === 'present') {\n    const isPresent = await __exists(path);\n    const previousContent = isPresent ? await readFile(path, encoding) : '';\n    const newContent = update == null ? (isPresent ? undefined : '') : update(previousContent);\n    const newMode = __toMode(mode);\n    if (newContent != null) {\n      await writeFile(path, newContent, { encoding, mode: newMode });\n    }\n    if (newMode != null && (isPresent || newContent != null)) {\n      await chmod(path, newMode);\n    }\n  } else {\n    await rm(path, { force: true });\n  }\n}\n\n/**\n * Ensure file is present/absent with content initialized or modified with `update\n *\n * @example\n * ```ts\n * fileSync({\n *   path: 'foo/bar',\n *   state: 'present',\n *   update: (content) => content + '_test', // This will append '_test' after current content\n *   mode: {\n *     owner: { read: true, write: true, execute: true },\n *     group: { read: true, write: true, execute: true },\n *     other: { read: true, write: true, execute: true },\n *   },\n * })\n * ```\n *\n * @param options\n */\nexport function fileSync(options: FileOptions): void {\n  const { path, state, update, encoding = 'utf8', mode } = options;\n  if (state === 'present') {\n    const isPresent = __existsSync(path);\n    const previousContent = isPresent ? readFileSync(path, encoding) : '';\n    const newContent = update == null ? (isPresent ? undefined : '') : update(previousContent);\n    const newMode = __toMode(mode);\n    if (newContent != null) {\n      writeFileSync(path, newContent, { encoding, mode: newMode });\n    }\n    if (newMode != null && (isPresent || newContent != null)) {\n      chmodSync(path, newMode);\n    }\n  } else {\n    rmSync(path, { force: true });\n  }\n}\n","import { type FileOptions, file, fileSync } from './file.js';\n\nexport interface BlockOptions {\n  /**\n   * The marker builder function that will take either `markerBegin` or `markerEnd`\n   *\n   * @default '# ${mark} MANAGED BLOCK'\n   */\n  marker?: (mark: 'Begin' | 'End') => string;\n\n  /**\n   * File path\n   */\n  path: string;\n\n  /**\n   * Block content to insert\n   */\n  block: string;\n\n  /**\n   * Insert position\n   */\n  insertPosition?: ['before', 'BeginningOfFile' | RegExp] | ['after', 'EndOfFile' | RegExp];\n\n  /**\n   * Block target state\n   */\n  state?: 'present' | 'absent';\n}\n\nconst EOF = 'EndOfFile';\nconst BOF = 'BeginningOfFile';\nconst insertAt = (str: string, index: number, toInsert: string) => str.slice(0, index) + toInsert + str.slice(index);\nconst matchLast = (string: string, regexp: RegExp) => {\n  const matcher = new RegExp(regexp.source, `${regexp.flags}g`);\n  let firstIndex = -1;\n  let lastIndex = -1;\n  let matches;\n\n  while (true) {\n    matches = matcher.exec(string);\n    if (matches == null) {\n      break;\n    }\n    firstIndex = matches.index;\n    lastIndex = matcher.lastIndex;\n  }\n  return { firstIndex, lastIndex };\n};\n\nfunction toFileOptions(options: BlockOptions): FileOptions {\n  const {\n    marker = (mark) => `# ${mark.toUpperCase()} MANAGED BLOCK`,\n    path,\n    block: blockName,\n    insertPosition = ['after', EOF],\n    state = 'present',\n  } = options;\n\n  const EOL = '\\n';\n  const beginBlock = marker('Begin');\n  const endBlock = marker('End');\n\n  /**\n   * @param content\n   */\n  function findBlock(content: string) {\n    const startIndex = content.indexOf(beginBlock);\n    const endIndex = content.indexOf(endBlock) + endBlock.length;\n\n    return {\n      endIndex,\n      exists: startIndex !== -1 && endIndex >= 0,\n      startIndex,\n    };\n  }\n\n  function apply(fullContent: string, blockContent: string) {\n    const found = findBlock(fullContent);\n    const remove = state === 'absent';\n    const replaceBlock = remove ? '' : beginBlock + EOL + blockContent + EOL + endBlock;\n    const [positionDirection, positionAnchor] = insertPosition;\n\n    if (found.exists) {\n      return fullContent.slice(0, found.startIndex) + replaceBlock + fullContent.slice(found.endIndex);\n    }\n    if (remove) {\n      return fullContent;\n    }\n    switch (positionDirection) {\n      case 'before': {\n        if (positionAnchor !== BOF) {\n          const { firstIndex } = matchLast(fullContent, positionAnchor);\n          if (firstIndex >= 0) {\n            return insertAt(fullContent, firstIndex, replaceBlock + EOL);\n          }\n        }\n\n        // Beginning of file\n        return replaceBlock + EOL + fullContent;\n      }\n      case 'after': {\n        // insert\n        if (positionAnchor !== EOF) {\n          const { lastIndex } = matchLast(fullContent, positionAnchor);\n          if (lastIndex >= 0) {\n            return insertAt(fullContent, lastIndex, EOL + replaceBlock);\n          }\n        }\n\n        // end of file\n        return fullContent + EOL + replaceBlock;\n      }\n\n      default: {\n        throw new Error(`Unsupported position ${String(positionDirection)}`);\n      }\n    }\n  }\n\n  return {\n    path,\n    state: 'present',\n    update: (sourceContent) => apply(sourceContent, blockName),\n  };\n}\n\n/**\n * Replace asynchronously a block in file that follows pattern :\n *\n * marker(markerBegin)\n * ...\n * marker(markerEnd)\n *\n * @param options\n */\nexport function block(options: BlockOptions) {\n  return file(toFileOptions(options));\n}\n\n/**\n * Replace synchronously a block in file that follows pattern :\n *\n * marker(markerBegin)\n * ...\n * marker(markerEnd)\n *\n * @param options\n */\nexport function blockSync(options: BlockOptions) {\n  return fileSync(toFileOptions(options));\n}\n","import { type FileOptions, file, fileSync } from './file.js';\n\nexport type JSONValue = null | number | string | boolean | JSONValue[] | { [key: string]: JSONValue };\n\nexport interface JSONOption<V = JSONValue> extends Omit<FileOptions, 'update'> {\n  /**\n   * File content mapping function\n   */\n  readonly update?: ((content: V | undefined) => V | undefined) | undefined;\n}\n\nfunction toFileOption<Value>({ update, ...otherOptions }: JSONOption<Value>): FileOptions {\n  return {\n    ...otherOptions,\n\n    update:\n      update == null\n        ? update\n        : (content) => {\n            const jsonValue = content === '' ? undefined : (JSON.parse(content) as Value);\n\n            return JSON.stringify(update(jsonValue));\n          },\n  };\n}\n\n/**\n * Ensure file is present/absent asynchronously with content value initialized or modified with `update`\n *\n * @param options\n */\nexport async function json<Value>(options: JSONOption<Value>): Promise<void> {\n  return file(toFileOption(options));\n}\n\n/**\n * Ensure file is present/absent synchronously with content value initialized or modified with `update`\n *\n * @param options\n */\nexport function jsonSync<Value>(options: JSONOption<Value>): void {\n  return fileSync(toFileOption(options));\n}\n","export const meta = Object.freeze({\n  // @ts-ignore - these variables are injected at build time\n  name: (typeof __PACKAGE_NAME__ === 'undefined' ? '' : __PACKAGE_NAME__) as string,\n  // @ts-ignore - these variables are injected at build time\n  version: (typeof __PACKAGE_VERSION__ === 'undefined' ? '' : __PACKAGE_VERSION__) as string,\n  // @ts-ignore - these variables are injected at build time\n  buildNumber: 1 as number, // (typeof __PACKAGE_BUILD_NUMBER__ === 'undefined' ? 0 : __PACKAGE_BUILD_NUMBER__) as number,\n});\n","import { spawn, spawnSync } from 'node:child_process';\n\nexport interface ExecOptions {\n  /**\n   * Current working directory\n   */\n  cwd?: string;\n\n  /**\n   * Stdio options\n   */\n  stdio?: 'inherit' | 'pipe' | 'ignore';\n}\n\n/**\n * Runs a command in a shell and returns a promise that resolves with an object\n * containing the stdout and stderr strings.\n *\n * @param command The command to run\n * @param args The arguments to pass to the command\n * @param options\n * @returns A promise that resolves with an object like `{ stdout: string, stderr: string }`\n */\nexport function execSync(\n  command: string,\n  args: ReadonlyArray<string>,\n  options?: ExecOptions,\n): { stdout: string; stderr: string } {\n  const result = spawnSync(command, args, { ...options });\n  const encoding = 'utf8';\n\n  return { stdout: result.stdout.toString(encoding), stderr: result.stderr.toString(encoding) };\n}\n\n/**\n * Runs a command in a shell and returns a promise that resolves with an object\n * containing the stdout and stderr strings.\n *\n * @param command The command to run\n * @param args The arguments to pass to the command\n * @param options\n */\nexport async function exec(\n  command: string,\n  args: ReadonlyArray<string>,\n  options?: ExecOptions,\n): Promise<{ stdout: string; stderr: string }> {\n  return new Promise((resolve, reject) => {\n    const encoding = 'utf8';\n    const child = spawn(command, args, { ...options });\n    let stdout = '';\n    let stderr = '';\n\n    // Capture the stdout and stderr streams\n    if (child.stdout != null) {\n      child.stdout.on('data', (data) => {\n        stdout += data.toString(encoding);\n      });\n    }\n    if (child.stderr != null) {\n      child.stderr.on('data', (data) => {\n        stderr += data.toString(encoding);\n      });\n    }\n    // Handle process exit\n    child.on('close', (_code) => {\n      resolve({ stdout, stderr });\n    });\n\n    // Handle errors\n    child.on('error', reject);\n  });\n}\n","import { exec, execSync } from './exec.js';\n\nexport interface YarnConfigOptions {\n  /**\n   * Configuration key\n   */\n  readonly key: string;\n\n  /**\n   * Option target state\n   */\n  readonly state: 'present' | 'absent';\n\n  /**\n   * File content mapping function\n   *\n   */\n  readonly update?: ((content: string) => string | undefined) | undefined;\n}\n\n/**\n * Synchronous version of {@link yarnConfig}\n *\n * @param options\n * @example\n * yarnConfigSync({\n *   key: 'nodeLinker',\n *   state: 'present',\n *   update: (content) => content.replace('node-modules', 'hoisted'),\n * })\n */\nexport function yarnConfigSync(options: YarnConfigOptions) {\n  const { key, state, update } = options;\n  if (state === 'present') {\n    const { stdout } = execSync('yarn', ['config', 'get', String(key)]);\n    execSync('yarn', ['config', 'set', String(key), `${update == null ? '' : update(stdout)}`]);\n  } else {\n    execSync('yarn', ['config', 'unset']);\n  }\n}\n\n/**\n * Set/Unset yarn configuration value\n *\n * @param options\n * @example\n * await yarnConfig({\n *   key: 'nodeLinker',\n *   state: 'present',\n *   update: (content) => content.replace('node-modules', 'hoisted'),\n * })\n */\nexport async function yarnConfig(options: YarnConfigOptions): Promise<void> {\n  const { key, state, update } = options;\n  if (state === 'present') {\n    const { stdout } = await exec('yarn', ['config', 'get', String(key)]);\n    await exec('yarn', ['config', 'set', String(key), `${update == null ? '' : update(stdout)}`]);\n  } else {\n    await exec('yarn', ['config', 'unset']);\n  }\n}\n","import { exec, execSync } from './exec.js';\n\nexport type YarnVersionKind = 'berry' | 'classic';\n\nexport interface YarnVersionOptions {\n  /**\n   * Option target state\n   */\n  readonly state: 'present' | 'absent';\n\n  /**\n   * Version mapping function\n   *\n   */\n  readonly update?: (() => YarnVersionKind | undefined) | undefined;\n}\n\n/**\n * Synchronous version of {@link yarnVersion}\n *\n * @param options\n * @example\n * yarnVersionSync({\n *   state: 'present',\n *   update: () => 'berry', // or 'classic'\n * })\n */\nexport function yarnVersionSync(options: YarnVersionOptions) {\n  const { state, update } = options;\n  if (state === 'present') {\n    execSync('yarn', ['set', 'version', `${update == null ? 'berry' : update()}`]);\n  } else {\n    // TODO: remove yarn.lock\n    throw new Error('Not implemented');\n  }\n}\n\n/**\n * Set/Unset yarn configuration value\n *\n * @param options\n * @example\n * await yarnVersion({\n *   state: 'present',\n *   update: () => 'berry', // or 'classic'\n * })\n */\nexport async function yarnVersion(options: YarnVersionOptions): Promise<void> {\n  const { state, update } = options;\n  if (state === 'present') {\n    await exec('yarn', ['set', 'version', `${update == null ? 'berry' : update()}`]);\n  } else {\n    // TODO: remove yarn.lock\n    throw new Error('Not implemented');\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@w5s/configurator-core",
+  "version": "1.0.0-alpha.1",
+  "description": "Core library for @w5s/configurator-core",
+  "keywords": [
+    "config",
+    "configurator",
+    "file",
+    "json"
+  ],
+  "homepage": "https://github.com/w5s/project-config/blob/main/packages/configurator-core#readme",
+  "bugs": {
+    "url": "https://github.com/w5s/project-config/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:w5s/project-config.git",
+    "directory": "packages/configurator-core"
+  },
+  "license": "MIT",
+  "author": "Julien Polo <julien.polo@gmail.com>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./dist/*": "./dist/*"
+  },
+  "typings": "./index.d.ts",
+  "files": [
+    "dist/",
+    "src/",
+    "index.js",
+    "index.d.ts",
+    "!*.d.ts.map",
+    "!**/*.spec.*",
+    "!**/__tests__/**"
+  ],
+  "scripts": {
+    "postpack": "clean-package restore"
+  },
+  "dependencies": {},
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffect": false,
+  "gitHead": "38cf5f5877af4c8a1c292b9b7039c5a11863fc00"
+}

package/src/FileMode.ts

@@ -0,0 +1,33 @@
+export interface FilePermissionSet {
+  /**
+   * Read permission
+   */
+  readonly read?: boolean;
+
+  /**
+   * Write permission
+   */
+  readonly write?: boolean;
+
+  /**
+   * Execute permission
+   */
+  readonly execute?: boolean;
+}
+
+export interface FileMode {
+  /**
+   * Owner permissions
+   */
+  readonly owner?: FilePermissionSet;
+
+  /**
+   * Group permissions
+   */
+  readonly group?: FilePermissionSet;
+
+  /**
+   * Other permissions
+   */
+  readonly other?: FilePermissionSet;
+}

package/src/__exists.ts

@@ -0,0 +1,11 @@
+import { access } from 'node:fs/promises';
+import { constants } from 'node:fs';
+
+export async function __exists(path: string) {
+  try {
+    await access(path, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/__existsSync.ts

@@ -0,0 +1,10 @@
+import { accessSync, constants } from 'node:fs';
+
+export function __existsSync(path: string) {
+  try {
+    accessSync(path, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/__toMode.ts

@@ -0,0 +1,19 @@
+import type { FileMode, FilePermissionSet } from './FileMode.js';
+
+function toModeFlag(permissionSet: FilePermissionSet | undefined, read: number, write: number, execute: number): number {
+  return (
+    (permissionSet?.read === true ? read : 0)
+    | (permissionSet?.write === true ? write : 0)
+    | (permissionSet?.execute === true ? execute : 0)
+  );
+}
+
+export function __toMode(mode: FileMode | undefined): number | undefined {
+  return mode == null
+    ? mode
+    : (
+        toModeFlag(mode.owner, 0o400, 0o200, 0o100)
+        | toModeFlag(mode.group, 0o040, 0o020, 0o010)
+        | toModeFlag(mode.other, 0o004, 0o002, 0o001)
+      );
+}