@design-edito/tools 0.4.3 → 0.4.5

package/node/process/spawner/index.js

@@ -1,16 +1,3 @@
-import {
-  styles
-} from "../../../chunks/chunk-JZ6GM444.js";
-import "../../../chunks/chunk-H4PP6AHP.js";
-import {
-  makeFailure,
-  makeSuccess
-} from "../../../chunks/chunk-LUAYN7VJ.js";
-import {
-  unknownToString
-} from "../../../chunks/chunk-PUQUSA6S.js";
-import "../../../chunks/chunk-WSFCRVEQ.js";
-
 // src/node/process/spawner/index.ts
 import {
   spawn,
@@ -18,6 +5,73 @@ import {
 } 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");

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

@@ -1,9 +1,63 @@
-import {
-  copyDir
-} from "../../../../chunks/chunk-4Q5TKOIG.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// 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}.`);
+        }
+        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));
+  }
+}
 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 moveDir from './move-dir/index.js'
 export * as removeDir from './remove-dir/index.js'
+export * as moveDir from './move-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 moveDir from './move-dir/index.js'
 export * as removeDir from './remove-dir/index.js'
+export * as moveDir from './move-dir/index.js'

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

@@ -1,9 +1,30 @@
-import {
-  list
-} from "../../../../chunks/chunk-2IGP6V77.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// 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/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,9 +1,38 @@
-import {
-  moveDir
-} from "../../../../chunks/chunk-TAXFCVFE.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// 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);
+    }
+    if (!overwrite) {
+      const exists = await sftp.exists(targetDir);
+      if (exists !== false) return makeFailure(`Target ${targetDir} already exists.`);
+    }
+    await sftp.rename(sourceDir, targetDir);
+    return makeSuccess(true);
+  } catch (err) {
+    return makeFailure(unknownToString(err));
+  }
+}
 export {
   moveDir
 };

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

@@ -1,9 +1,45 @@
-import {
-  removeDir
-} from "../../../../chunks/chunk-B6653QJD.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// 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/remove-dir/index.ts
+async function removeDir(sftp, directoryPath, options) {
+  const { ignoreMissing = true } = options ?? {};
+  async function recurse(dir) {
+    const list = await sftp.list(dir);
+    for (const entry of list) {
+      const full = dir.endsWith("/") ? dir + entry.name : `${dir}/${entry.name}`;
+      if (entry.type === "d") {
+        await recurse(full);
+      } else if (entry.type === "-") {
+        await sftp.delete(full);
+      }
+    }
+    await sftp.rmdir(dir);
+  }
+  try {
+    await recurse(directoryPath);
+    return makeSuccess(true);
+  } catch (err) {
+    if (ignoreMissing && (err.code === 2 || err.code === "ENOENT")) {
+      return makeSuccess(true);
+    }
+    return makeFailure(unknownToString(err));
+  }
+}
 export {
   removeDir
 };

package/node/sftp/file/copy/index.js

@@ -1,9 +1,48 @@
-import {
-  copy
-} from "../../../../chunks/chunk-R66GH2MQ.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// src/node/sftp/file/copy/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/file/copy/index.ts
+async function copy(sftp, sourcePath, targetPath, options) {
+  const {
+    overwrite = false,
+    ensureDir = true,
+    ...transferOptions
+  } = options ?? {};
+  try {
+    if (!overwrite) {
+      const exists = await sftp.exists(targetPath);
+      if (exists !== false) return makeFailure(`File already exists at ${targetPath}.`);
+    }
+    if (ensureDir) {
+      const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
+      await sftp.mkdir(dirPath, true);
+    }
+    const pass = new PassThrough();
+    const uploadPromise = sftp.put(pass, targetPath, transferOptions);
+    await sftp.get(sourcePath, pass, transferOptions);
+    await uploadPromise;
+    return makeSuccess(true);
+  } catch (err) {
+    return makeFailure(unknownToString(err));
+  }
+}
 export {
   copy
 };

package/node/sftp/file/download/index.js

@@ -1,9 +1,33 @@
-import {
-  download
-} from "../../../../chunks/chunk-AG4VERYN.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// 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/agnostic/misc/outcome/index.ts
+function makeSuccess(payload) {
+  return { success: true, payload };
+}
+function makeFailure(error) {
+  return { success: false, error };
+}
+
+// src/node/sftp/file/download/index.ts
+async function download(sftp, sourcePath, options) {
+  try {
+    const stream = sftp.createReadStream(sourcePath, options);
+    stream.on("error", (err) => {
+      throw err;
+    });
+    return makeSuccess(stream);
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return makeFailure(errStr);
+  }
+}
 export {
   download
 };

package/node/sftp/file/exists/index.js

@@ -1,9 +1,30 @@
-import {
-  exists
-} from "../../../../chunks/chunk-JB27MAKY.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// 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/agnostic/misc/outcome/index.ts
+function makeSuccess(payload) {
+  return { success: true, payload };
+}
+function makeFailure(error) {
+  return { success: false, error };
+}
+
+// src/node/sftp/file/exists/index.ts
+async function exists(sftp, sourcePath) {
+  try {
+    const res = await sftp.exists(sourcePath);
+    const isFile = res === "-" || res === "l";
+    return makeSuccess(isFile);
+  } catch (err) {
+    return makeFailure(unknownToString(err));
+  }
+}
 export {
   exists
 };

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

@@ -1,7 +1,7 @@
-export * as copy from './copy/index.js'
 export * as download from './download/index.js'
+export * as copy from './copy/index.js'
 export * as exists from './exists/index.js'
-export * as move from './move/index.js'
 export * as remove from './remove/index.js'
 export * as stat from './stat/index.js'
 export * as upload from './upload/index.js'
+export * as move from './move/index.js'

package/node/sftp/file/index.js

@@ -1,7 +1,7 @@
-export * as copy from './copy/index.js'
 export * as download from './download/index.js'
+export * as copy from './copy/index.js'
 export * as exists from './exists/index.js'
-export * as move from './move/index.js'
 export * as remove from './remove/index.js'
 export * as stat from './stat/index.js'
 export * as upload from './upload/index.js'
+export * as move from './move/index.js'

package/node/sftp/file/move/index.js

@@ -1,9 +1,41 @@
-import {
-  move
-} from "../../../../chunks/chunk-EYYNCLVR.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// 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/agnostic/misc/outcome/index.ts
+function makeSuccess(payload) {
+  return { success: true, payload };
+}
+function makeFailure(error) {
+  return { success: false, error };
+}
+
+// src/node/sftp/file/move/index.ts
+async function move(sftp, sourcePath, targetPath, options) {
+  const {
+    ensureDir = true,
+    overwrite = false
+  } = options ?? {};
+  try {
+    if (ensureDir) {
+      const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
+      await sftp.mkdir(dirPath, true);
+    }
+    if (!overwrite) {
+      const exists = await sftp.exists(targetPath) !== false;
+      if (exists) return makeFailure(`File already exists at ${targetPath}.`);
+    }
+    await sftp.rename(sourcePath, targetPath);
+    return makeSuccess(true);
+  } catch (err) {
+    return makeFailure(unknownToString(err));
+  }
+}
 export {
   move
 };

package/node/sftp/file/remove/index.js

@@ -1,9 +1,36 @@
-import {
-  remove
-} from "../../../../chunks/chunk-SYH5LYQC.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// 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/agnostic/misc/outcome/index.ts
+function makeSuccess(payload) {
+  return { success: true, payload };
+}
+function makeFailure(error) {
+  return { success: false, error };
+}
+
+// src/node/sftp/file/remove/index.ts
+async function remove(sftp, targetPath, options) {
+  const { ignoreMissing = true } = options ?? {};
+  try {
+    const exists = await sftp.exists(targetPath) !== false;
+    if (!exists) {
+      if (ignoreMissing) return makeSuccess(true);
+      return makeFailure(`File not found at ${targetPath}.`);
+    }
+    await sftp.delete(targetPath);
+    return makeSuccess(true);
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return makeFailure(errStr);
+  }
+}
 export {
   remove
 };

package/node/sftp/file/stat/index.js

@@ -1,9 +1,39 @@
-import {
-  stat
-} from "../../../../chunks/chunk-S2UZ3HZR.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// 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/file/stat/index.ts
+async function stat(sftp, path) {
+  try {
+    const info = await sftp.stat(path);
+    return makeSuccess({
+      size: info.size,
+      modifiedAt: new Date(info.modifyTime * 1e3),
+      mode: info.mode,
+      uid: info.uid,
+      gid: info.gid,
+      raw: info
+    });
+  } catch (err) {
+    if (err.code === 2 || err.code === "ENOENT") {
+      return makeFailure(`File not found: ${path}`);
+    }
+    return makeFailure(unknownToString(err));
+  }
+}
 export {
   stat
 };

package/node/sftp/file/upload/index.js

@@ -1,9 +1,40 @@
-import {
-  upload
-} from "../../../../chunks/chunk-H3HRQ52T.js";
-import "../../../../chunks/chunk-LUAYN7VJ.js";
-import "../../../../chunks/chunk-PUQUSA6S.js";
-import "../../../../chunks/chunk-WSFCRVEQ.js";
+// 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/agnostic/misc/outcome/index.ts
+function makeSuccess(payload) {
+  return { success: true, payload };
+}
+function makeFailure(error) {
+  return { success: false, error };
+}
+
+// src/node/sftp/file/upload/index.ts
+async function upload(sftp, targetPath, fileStream, options) {
+  const {
+    ensureDir = true,
+    overwrite = false
+  } = options ?? {};
+  try {
+    const exists = await sftp.exists(targetPath) !== false;
+    if (exists && !overwrite) return makeFailure(`File already exists at ${targetPath}.`);
+    if (ensureDir) {
+      const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
+      await sftp.mkdir(dirPath, true);
+    }
+    await sftp.put(fileStream, targetPath, options);
+    return makeSuccess(true);
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return makeFailure(errStr);
+  }
+}
 export {
   upload
 };