@design-edito/tools 0.4.5 → 0.4.6

package/node/process/on-exit/index.js

@@ -1,30 +1,49 @@
-// src/node/process/on-exit/index.ts
-var forceExitEvents = ["SIGINT", "SIGTERM", "uncaughtException"];
-function beforeForcedExit(callback) {
-  forceExitEvents.forEach((ev) => process.on(ev, callback));
+/** Events that trigger a forced exit of the process. */
+export const forceExitEvents = ['SIGINT', 'SIGTERM', 'uncaughtException'];
+/**
+ * Registers a callback to run before forced exit events (SIGINT, SIGTERM, uncaughtException).
+ *
+ * @param callback - Function to execute before forced exit. Can be async.
+ */
+export function beforeForcedExit(callback) {
+    // eslint-disable-next-line @typescript-eslint/no-misused-promises
+    forceExitEvents.forEach(ev => process.on(ev, callback));
 }
-function beforeExit(callback) {
-  process.on("beforeExit", callback);
+/**
+ * Registers a callback to run before the process exits normally.
+ *
+ * @param callback - Function to execute before exit. Can be async.
+ */
+export function beforeExit(callback) {
+    // eslint-disable-next-line @typescript-eslint/no-misused-promises
+    process.on('beforeExit', callback);
 }
-function onExit(callback) {
-  process.on("exit", callback);
+/**
+ * Registers a callback to run when the process exits.
+ *
+ * @param callback - Function to execute on exit. Can be async.
+ */
+export function onExit(callback) {
+    // eslint-disable-next-line @typescript-eslint/no-misused-promises
+    process.on('exit', callback);
 }
-function onAllExits(callback) {
-  let alreadyCalled = false;
-  const actualCallback = () => {
-    if (!alreadyCalled) {
-      alreadyCalled = true;
-      callback();
-    }
-  };
-  beforeForcedExit(actualCallback);
-  beforeExit(actualCallback);
-  onExit(actualCallback);
+/**
+ * Registers a callback to run on all exit scenarios (forced exit, before exit, and exit).
+ *
+ * The callback is guaranteed to be called only once, even if multiple exit events occur.
+ *
+ * @param callback - Function to execute on any exit. Can be async.
+ */
+export function onAllExits(callback) {
+    let alreadyCalled = false;
+    const actualCallback = () => {
+        if (!alreadyCalled) {
+            alreadyCalled = true;
+            // eslint-disable-next-line @typescript-eslint/no-misused-promises, @typescript-eslint/no-floating-promises
+            callback();
+        }
+    };
+    beforeForcedExit(actualCallback);
+    beforeExit(actualCallback);
+    onExit(actualCallback);
 }
-export {
-  beforeExit,
-  beforeForcedExit,
-  forceExitEvents,
-  onAllExits,
-  onExit
-};

package/node/process/prompt-continue/index.js

@@ -1,15 +1,30 @@
-// src/node/process/prompt-continue/index.ts
-import * as inquirer from "@inquirer/prompts";
-async function promptContinue(message, throws = false) {
-  console.log("");
-  const answer = await inquirer.confirm({
-    message: message ?? "Continue?",
-    default: false
-  });
-  if (answer) return true;
-  if (throws) throw new Error("Aborted");
-  return false;
+import * as inquirer from '@inquirer/prompts';
+/**
+ * Prompts the user with a yes/no confirmation in the terminal.
+ *
+ * @param {string} [message] - The message to display in the prompt. Defaults to "Continue?" if not provided.
+ * @param {boolean} [throws=false] - If true, the function will throw an error when the user declines.
+ * @returns {Promise<boolean>} - Resolves to `true` if the user confirms, `false` if the user declines and `throws` is false.
+ *
+ * @throws {Error} - Throws an error with message 'Aborted' if the user declines and `throws` is true.
+ *
+ * @example
+ * const result = await promptContinue('Do you want to proceed?');
+ * if (result) {
+ *   console.log('User confirmed');
+ * } else {
+ *   console.log('User declined');
+ * }
+ */
+export async function promptContinue(message, throws = false) {
+    console.log('');
+    const answer = await inquirer.confirm({
+        message: message ?? 'Continue?',
+        default: false
+    });
+    if (answer)
+        return true;
+    if (throws)
+        throw new Error('Aborted');
+    return false;
 }
-export {
-  promptContinue
-};

package/node/process/spawner/index.js

@@ -1,137 +1,107 @@
-// src/node/process/spawner/index.ts
-import {
-  spawn,
-  spawnSync
-} from "node:child_process";
-import ansiRegex from "ansi-regex";
-import chalk from "chalk";
-
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/agnostic/misc/logs/make-text-block/index.ts
-function makeTextBlock(text, vPadding = 1, hPadding = vPadding) {
-  const lines = text.split("\n");
-  const longestLine = Math.max(...lines.map((line) => line.length));
-  const textBlockArr = new Array(lines.length + 2 * vPadding).fill(null).map(() => new Array(longestLine + hPadding * 2).fill(" "));
-  lines.forEach((line, linePos) => {
-    const chars = line.split("");
-    textBlockArr[linePos + vPadding]?.splice(hPadding, chars.length, ...chars);
-  });
-  return textBlockArr.map((lineArr) => lineArr.join("")).join("\n");
-}
-
-// src/agnostic/misc/logs/styles/index.ts
-var ansi = {
-  reset: "\x1B[0m",
-  bold: "\x1B[1m",
-  italic: "\x1B[3m",
-  underline: "\x1B[4m",
-  fg: {
-    red: "\x1B[31m",
-    green: "\x1B[32m",
-    yellow: "\x1B[33m",
-    blue: "\x1B[34m",
-    gray: "\x1B[90m",
-    whiteBright: "\x1B[97m"
-  },
-  bg: {
-    red: "\x1B[41m"
-  }
-};
-var wrap = (...ansiCodes) => (text) => `${ansiCodes.join("")}${text}${ansi.reset}`;
-var styles = {
-  regular: (text) => text,
-  light: wrap(ansi.fg.gray),
-  danger: (text) => wrap(ansi.bold, ansi.bg.red, ansi.fg.whiteBright)(makeTextBlock(`/!\\
-
-${text}
-`, 2, 6)),
-  important: wrap(ansi.bold),
-  title: (text) => `# ${wrap(ansi.bold, ansi.underline)(`${text}
-`)}`,
-  info: wrap(ansi.fg.blue),
-  success: wrap(ansi.fg.green),
-  error: wrap(ansi.fg.red),
-  warning: wrap(ansi.fg.yellow),
-  italic: wrap(ansi.italic)
-};
-
-// src/agnostic/errors/unknown-to-string/index.ts
-function unknownToString(unk, encoding) {
-  if (unk instanceof Error) return unk.message;
-  if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
-  if (typeof unk === "string") return unk;
-  if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
-  return `${unk}`;
-}
-
-// src/node/process/spawner/index.ts
-async function spawner(label, command, args, options) {
-  return await new Promise((resolve, reject) => {
-    if (label !== null) console.log("\n" + styles.info(label) + "\n");
-    const printableArgs = options?.argsPrintFormat !== void 0 ? options.argsPrintFormat(args) : args;
-    console.log(styles.light(`> ${command} ${printableArgs.join(" ")}
-`));
-    const prcss = spawn(command, args, { stdio: "pipe", ...options });
-    let stdout = "";
-    let stderr = "";
-    let err = null;
-    prcss.stdout?.on("data", (data) => {
-      const strData = unknownToString(data);
-      stdout += strData;
-      console.log(styles.light(strData.replace(ansiRegex(), "").trim()));
-    });
-    prcss.stderr?.on("data", (data) => {
-      const strData = unknownToString(data);
-      stderr += strData;
-      console.log(styles.warning(strData.replace(ansiRegex(), "").trim()));
-    });
-    prcss.on("error", (e) => {
-      err = e;
-      console.log(styles.error(unknownToString(err).replace(ansiRegex(), "").trim()));
-    });
-    prcss.on("close", (code) => {
-      if (code !== 0 && options?.throwOnError === true) reject(new Error(stderr + "\n" + stdout));
-      else if (code !== 0) return resolve(makeFailure({ stdout, stderr, err }));
-      else return resolve(makeSuccess({ stdout, stderr, err }));
+import { spawn, spawnSync } from 'node:child_process';
+import ansiRegex from 'ansi-regex';
+import chalk from 'chalk';
+import * as Outcome from '../../../agnostic/misc/outcome/index.js';
+import { styles } from '../../../agnostic/misc/logs/styles/index.js';
+import { unknownToString } from '../../../agnostic/errors/unknown-to-string/index.js';
+/**
+ * Spawns a child process asynchronously and logs its execution and output.
+ *
+ * Stdout and stderr are streamed, logged in real time, and collected.
+ * The result is returned as an `Outcome.Either`, representing success or failure.
+ *
+ * @param label - Optional label printed before execution to visually group logs.
+ * @param command - The command to execute.
+ * @param args - Arguments passed to the command.
+ * @param options - Optional spawn configuration and utility-specific options:
+ *   - `argsPrintFormat`: Function to format arguments for logging.
+ *   - `throwOnError`: If `true`, rejects on non-zero exit code instead of resolving a failure.
+ * @returns A promise resolving to an `Outcome.Either`:
+ *   - success: `{ stdout, stderr, err }` when the command exits with code `0`
+ *   - failure: `{ stdout, stderr, err }` when the command exits with a non-zero code
+ */
+export async function spawner(label, command, args, options) {
+    return await new Promise((resolve, reject) => {
+        if (label !== null)
+            console.log('\n' + styles.info(label) + '\n');
+        const printableArgs = options?.argsPrintFormat !== undefined
+            ? options.argsPrintFormat(args)
+            : args;
+        console.log(styles.light(`> ${command} ${printableArgs.join(' ')}\n`));
+        const prcss = spawn(command, args, { stdio: 'pipe', ...options });
+        let stdout = '';
+        let stderr = '';
+        let err = null;
+        prcss.stdout?.on('data', data => {
+            const strData = unknownToString(data);
+            stdout += strData;
+            console.log(styles.light(strData.replace(ansiRegex(), '').trim()));
+        });
+        prcss.stderr?.on('data', data => {
+            const strData = unknownToString(data);
+            stderr += strData;
+            console.log(styles.warning(strData.replace(ansiRegex(), '').trim()));
+        });
+        prcss.on('error', e => {
+            err = e;
+            console.log(styles.error(unknownToString(err).replace(ansiRegex(), '').trim()));
+        });
+        prcss.on('close', code => {
+            if (code !== 0 && options?.throwOnError === true)
+                reject(new Error(stderr + '\n' + stdout));
+            else if (code !== 0)
+                return resolve(Outcome.makeFailure({ stdout, stderr, err }));
+            else
+                return resolve(Outcome.makeSuccess({ stdout, stderr, err }));
+        });
     });
-  });
 }
-function spawnerSync(label, command, args, options) {
-  if (label !== null) console.log("\n" + styles.info(label) + "\n");
-  const printableArgs = options?.argsPrintFormat !== void 0 ? options.argsPrintFormat(args) : args;
-  console.log(styles.light(`> ${command} ${printableArgs.join(" ")}
-`));
-  const result = spawnSync(command, args, { stdio: "pipe", encoding: "utf8", ...options });
-  const stderr = result.stderr?.toString().trim();
-  const stdout = result.stdout?.toString().trim();
-  const err = result.error;
-  if (err !== void 0) {
-    console.log(styles.light(chalk.italic("err:\n")));
-    console.log(styles.error(unknownToString(err).replace(ansiRegex(), "")));
-    console.log("");
-  }
-  if (stderr !== "") {
-    console.log(styles.light(chalk.italic("stderr:\n")));
-    console.log(styles.warning(stderr.replace(ansiRegex(), "")));
-    console.log("");
-  }
-  if (stdout !== "") {
-    console.log(styles.light(chalk.italic("stdout:\n")));
-    console.log(styles.light(stdout.replace(ansiRegex(), "")));
-    console.log("");
-  }
-  if (result.status !== 0 && options?.throwOnError === true) throw new Error(stderr + "\n" + stdout);
-  else if (result.status !== 0) return makeFailure({ stdout, stderr, err });
-  return makeSuccess({ stdout, stderr, err });
+/**
+ * Spawns a child process synchronously and logs its execution and output.
+ *
+ * Stdout, stderr, and execution errors are logged after the process completes.
+ * The result is returned as an `Outcome.Either`, representing success or failure.
+ *
+ * @param label - Optional label printed before execution to visually group logs.
+ * @param command - The command to execute.
+ * @param args - Arguments passed to the command.
+ * @param options - Optional spawn configuration and utility-specific options:
+ *   - `argsPrintFormat`: Function to format arguments for logging.
+ *   - `throwOnError`: If `true`, throws on non-zero exit code instead of returning a failure.
+ * @returns An `Outcome.Either`:
+ *   - success: `{ stdout, stderr, err }` when the command exits with code `0`
+ *   - failure: `{ stdout, stderr, err }` when the command exits with a non-zero code
+ * @throws Error if `throwOnError` is `true` and the process exits with a non-zero status
+ */
+export function spawnerSync(label, command, args, options) {
+    if (label !== null)
+        console.log('\n' + styles.info(label) + '\n');
+    const printableArgs = options?.argsPrintFormat !== undefined
+        ? options.argsPrintFormat(args)
+        : args;
+    console.log(styles.light(`> ${command} ${printableArgs.join(' ')}\n`));
+    const result = spawnSync(command, args, { stdio: 'pipe', encoding: 'utf8', ...options });
+    const stderr = result.stderr?.toString().trim();
+    const stdout = result.stdout?.toString().trim();
+    const err = result.error;
+    if (err !== undefined) {
+        console.log(styles.light(chalk.italic('err:\n')));
+        console.log(styles.error(unknownToString(err).replace(ansiRegex(), '')));
+        console.log('');
+    }
+    if (stderr !== '') {
+        console.log(styles.light(chalk.italic('stderr:\n')));
+        console.log(styles.warning(stderr.replace(ansiRegex(), '')));
+        console.log('');
+    }
+    if (stdout !== '') {
+        console.log(styles.light(chalk.italic('stdout:\n')));
+        console.log(styles.light(stdout.replace(ansiRegex(), '')));
+        console.log('');
+    }
+    if (result.status !== 0 && options?.throwOnError === true)
+        throw new Error(stderr + '\n' + stdout);
+    else if (result.status !== 0)
+        return Outcome.makeFailure({ stdout, stderr, err });
+    return Outcome.makeSuccess({ stdout, stderr, err });
 }
-export {
-  spawner,
-  spawnerSync
-};

package/node/sftp/directory/copy-dir/index.js

@@ -1,63 +1,55 @@
-// src/node/sftp/directory/copy-dir/index.ts
-import { PassThrough } from "node:stream";
-
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/agnostic/errors/unknown-to-string/index.ts
-function unknownToString(unk, encoding) {
-  if (unk instanceof Error) return unk.message;
-  if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
-  if (typeof unk === "string") return unk;
-  if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
-  return `${unk}`;
-}
-
-// src/node/sftp/directory/copy-dir/index.ts
-async function copyDir(sftp, sourceDir, targetDir, options) {
-  const {
-    overwrite = false,
-    ensureDir = true,
-    ...transferOptions
-  } = options ?? {};
-  async function recurse(dir) {
-    const list = await sftp.list(dir);
-    for (const entry of list) {
-      const src = dir.endsWith("/") ? dir + entry.name : dir + "/" + entry.name;
-      const rel = src.substring(sourceDir.length + (sourceDir.endsWith("/") ? 0 : 1));
-      const dst = targetDir.endsWith("/") ? targetDir + rel : `${targetDir}/${rel}`;
-      if (entry.type === "d") {
-        if (ensureDir) await sftp.mkdir(dst, true);
-        await recurse(src);
-      } else if (entry.type === "-") {
-        if (!overwrite) {
-          const exists = await sftp.exists(dst);
-          if (exists !== false) throw new Error(`File already exists at ${dst}.`);
+import { PassThrough } from 'node:stream';
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
+import { unknownToString } from '../../../../agnostic/errors/unknown-to-string/index.js';
+/**
+ * Recursively copies every file under `sourceDir` to the same relative path
+ * beneath `targetDir` on an SFTP server, streaming data to minimize memory usage.
+ *
+ * @param {Client} sftp - The SFTP client instance.
+ * @param {string} sourceDir - The source directory path to copy from.
+ * @param {string} targetDir - The target directory path to copy to.
+ * @param {CopyDirOptions} [options] - Optional parameters for the operation.
+ * @returns {Promise<Outcome.Either<true, string>>}
+ * - On success: `Outcome.makeSuccess(true)` indicating the copy was successful.
+ * - On failure: `Outcome.makeFailure(errStr)` with an error message if the copy fails.
+ */
+export async function copyDir(sftp, sourceDir, targetDir, options) {
+    const { overwrite = false, ensureDir = true, ...transferOptions } = options ?? {};
+    async function recurse(dir) {
+        const list = await sftp.list(dir);
+        for (const entry of list) {
+            const src = dir.endsWith('/') ? dir + entry.name : dir + '/' + entry.name;
+            const rel = src.substring(sourceDir.length + (sourceDir.endsWith('/') ? 0 : 1));
+            const dst = targetDir.endsWith('/') ? targetDir + rel : `${targetDir}/${rel}`;
+            if (entry.type === 'd') {
+                if (ensureDir)
+                    await sftp.mkdir(dst, true);
+                await recurse(src);
+            }
+            else if (entry.type === '-') {
+                if (!overwrite) {
+                    const exists = await sftp.exists(dst);
+                    if (exists !== false)
+                        throw new Error(`File already exists at ${dst}.`);
+                }
+                if (ensureDir) {
+                    const dirPath = dst.substring(0, dst.lastIndexOf('/'));
+                    await sftp.mkdir(dirPath, true);
+                }
+                const pass = new PassThrough();
+                const upload = sftp.put(pass, dst, transferOptions);
+                await sftp.get(src, pass, transferOptions);
+                await upload;
+            }
         }
-        if (ensureDir) {
-          const dirPath = dst.substring(0, dst.lastIndexOf("/"));
-          await sftp.mkdir(dirPath, true);
-        }
-        const pass = new PassThrough();
-        const upload = sftp.put(pass, dst, transferOptions);
-        await sftp.get(src, pass, transferOptions);
-        await upload;
-      }
     }
-  }
-  try {
-    if (ensureDir) await sftp.mkdir(targetDir, true);
-    await recurse(sourceDir);
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
+    try {
+        if (ensureDir)
+            await sftp.mkdir(targetDir, true);
+        await recurse(sourceDir);
+        return Outcome.makeSuccess(true);
+    }
+    catch (err) {
+        return Outcome.makeFailure(unknownToString(err));
+    }
 }
-export {
-  copyDir
-};

package/node/sftp/directory/index.d.ts

@@ -1,4 +1,4 @@
 export * as copyDir from './copy-dir/index.js'
 export * as list from './list/index.js'
-export * as removeDir from './remove-dir/index.js'
 export * as moveDir from './move-dir/index.js'
+export * as removeDir from './remove-dir/index.js'

package/node/sftp/directory/index.js

@@ -1,4 +1,4 @@
 export * as copyDir from './copy-dir/index.js'
 export * as list from './list/index.js'
-export * as removeDir from './remove-dir/index.js'
 export * as moveDir from './move-dir/index.js'
+export * as removeDir from './remove-dir/index.js'

package/node/sftp/directory/list/index.js

@@ -1,30 +1,23 @@
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
+import { unknownToString } from '../../../../agnostic/errors/unknown-to-string/index.js';
+/**
+ * Lists all direct children files under a given directory on an SFTP server.
+ *
+ * This function returns only the immediate files (not recursive) under the specified directory.
+ *
+ * @param {Client} sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
+ * @param {string} directoryPath - The directory path to list files under.
+ * @returns {Promise<Outcome.Either<string[], string>>} Returns either a success with an array of file paths, or a failure with an error message.
+ */
+export async function list(sftp, directoryPath) {
+    try {
+        const list = await sftp.list(directoryPath);
+        const files = list
+            .filter(entry => entry.type === '-')
+            .map(entry => (directoryPath.endsWith('/') ? directoryPath + entry.name : directoryPath + '/' + entry.name));
+        return Outcome.makeSuccess(files);
+    }
+    catch (err) {
+        return Outcome.makeFailure(unknownToString(err));
+    }
 }
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/agnostic/errors/unknown-to-string/index.ts
-function unknownToString(unk, encoding) {
-  if (unk instanceof Error) return unk.message;
-  if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
-  if (typeof unk === "string") return unk;
-  if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
-  return `${unk}`;
-}
-
-// src/node/sftp/directory/list/index.ts
-async function list(sftp, directoryPath) {
-  try {
-    const list2 = await sftp.list(directoryPath);
-    const files = list2.filter((entry) => entry.type === "-").map((entry) => directoryPath.endsWith("/") ? directoryPath + entry.name : directoryPath + "/" + entry.name);
-    return makeSuccess(files);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
-}
-export {
-  list
-};

package/node/sftp/directory/move-dir/index.js

@@ -1,38 +1,38 @@
-// src/agnostic/misc/outcome/index.ts
-function makeSuccess(payload) {
-  return { success: true, payload };
-}
-function makeFailure(error) {
-  return { success: false, error };
-}
-
-// src/agnostic/errors/unknown-to-string/index.ts
-function unknownToString(unk, encoding) {
-  if (unk instanceof Error) return unk.message;
-  if (unk instanceof Buffer) return unk.toString(encoding ?? "utf-8");
-  if (typeof unk === "string") return unk;
-  if (typeof unk === "object" && unk !== null) return JSON.stringify(unk);
-  return `${unk}`;
-}
-
-// src/node/sftp/directory/move-dir/index.ts
-async function moveDir(sftp, sourceDir, targetDir, options) {
-  const { overwrite = false, ensureDir = true } = options ?? {};
-  try {
-    if (ensureDir) {
-      const parentDir = targetDir.substring(0, targetDir.lastIndexOf("/"));
-      await sftp.mkdir(parentDir, true);
+import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
+import { unknownToString } from '../../../../agnostic/errors/unknown-to-string/index.js';
+/**
+ * Renames (moves) a directory on an SFTP server using `rename`, which moves
+ * the entire tree in one operation when supported by the server.
+ *
+ * If `ensureDir` is true (default), the parent directory of `targetDir` is
+ * created if it does not exist.
+ *
+ * @param {Client} sftp - The SFTP client instance.
+ * @param {string} sourceDir - The source directory path to move from.
+ * @param {string} targetDir - The target directory path to move to.
+ * @param {MoveDirOptions} [options] - Optional parameters for the operation.
+ * @param {boolean} [options.overwrite=false] - If false and `targetDir` exists, abort.
+ * @param {boolean} [options.ensureDir=true] - Whether to create the parent directory of `targetDir`.
+ * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an `Outcome.Either`:
+ * - On success: `Outcome.makeSuccess(true)` indicating the move was successful.
+ * - On failure: `Outcome.makeFailure(errStr)` with an error message if the move fails.
+ */
+export async function moveDir(sftp, sourceDir, targetDir, options) {
+    const { overwrite = false, ensureDir = true } = options ?? {};
+    try {
+        if (ensureDir) {
+            const parentDir = targetDir.substring(0, targetDir.lastIndexOf('/'));
+            await sftp.mkdir(parentDir, true);
+        }
+        if (!overwrite) {
+            const exists = await sftp.exists(targetDir);
+            if (exists !== false)
+                return Outcome.makeFailure(`Target ${targetDir} already exists.`);
+        }
+        await sftp.rename(sourceDir, targetDir);
+        return Outcome.makeSuccess(true);
     }
-    if (!overwrite) {
-      const exists = await sftp.exists(targetDir);
-      if (exists !== false) return makeFailure(`Target ${targetDir} already exists.`);
+    catch (err) {
+        return Outcome.makeFailure(unknownToString(err));
     }
-    await sftp.rename(sourceDir, targetDir);
-    return makeSuccess(true);
-  } catch (err) {
-    return makeFailure(unknownToString(err));
-  }
 }
-export {
-  moveDir
-};