@design-edito/tools 0.3.2 → 0.3.4

package/node/encryption/@aes-256-gcm/buffer/index.js

@@ -1,26 +1,21 @@
-import {
-  decryptUint8Array,
-  encryptUint8Array
-} from "../../../../chunks/chunk-6652JQFX.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import {
-  makeSuccess
-} from "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/encryption/@aes-256-gcm/buffer/index.ts
 import { Buffer } from "node:buffer";
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+import {
+  encryptUint8Array,
+  decryptUint8Array
+} from "../uint8-array/index.js";
 function encrypt(inputBuffer, encryptionKey) {
   const fileArray = new Uint8Array(inputBuffer);
   const encryptionOutcome = encryptUint8Array(fileArray, encryptionKey);
   if (!encryptionOutcome.success) return encryptionOutcome;
-  return makeSuccess(Buffer.from(encryptionOutcome.payload));
+  return Outcome.makeSuccess(Buffer.from(encryptionOutcome.payload));
 }
 function decrypt(encryptedBuffer, encryptionKey) {
   const encryptedArray = new Uint8Array(encryptedBuffer);
   const decryptionOutcome = decryptUint8Array(encryptedArray, encryptionKey);
   if (!decryptionOutcome.success) return decryptionOutcome;
-  return makeSuccess(Buffer.from(decryptionOutcome.payload));
+  return Outcome.makeSuccess(Buffer.from(decryptionOutcome.payload));
 }
 export {
   decrypt,

package/node/encryption/@aes-256-gcm/uint8-array/index.js

@@ -1,10 +1,39 @@
-import {
-  decryptUint8Array,
-  encryptUint8Array
-} from "../../../../chunks/chunk-6652JQFX.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/encryption/@aes-256-gcm/uint8-array/index.ts
+import { Buffer } from "node:buffer";
+import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+function encryptUint8Array(fileArray, encryptionKey) {
+  const ivLength = 12;
+  const keyBuffer = Buffer.from(encryptionKey, "utf-8");
+  if (keyBuffer.length !== 32) return Outcome.makeFailure("Encryption key must be 32 bytes for AES-256-GCM.");
+  try {
+    const iv = randomBytes(ivLength);
+    const cipher = createCipheriv("aes-256-gcm", keyBuffer, iv);
+    let encrypted = cipher.update(fileArray);
+    encrypted = Buffer.concat([encrypted, cipher.final()]);
+    return Outcome.makeSuccess(new Uint8Array(Buffer.concat([iv, encrypted])));
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return Outcome.makeFailure(errStr);
+  }
+}
+function decryptUint8Array(encryptedFile, encryptionKey) {
+  const ivLength = 12;
+  const iv = encryptedFile.subarray(0, ivLength);
+  const keyBuffer = Buffer.from(encryptionKey, "utf-8");
+  if (keyBuffer.length !== 32) return Outcome.makeFailure("Encryption key must be 32 bytes for AES-256-GCM.");
+  try {
+    const encryptedData = encryptedFile.subarray(ivLength);
+    const decipher = createDecipheriv("aes-256-gcm", keyBuffer, iv);
+    let decrypted = decipher.update(encryptedData);
+    decrypted = Buffer.concat([decrypted, decipher.final()]);
+    return Outcome.makeSuccess(new Uint8Array(decrypted));
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return Outcome.makeFailure(errStr);
+  }
+}
 export {
   decryptUint8Array,
   encryptUint8Array

package/node/encryption/key/index.js

@@ -1,5 +1,3 @@
-import "../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/encryption/key/index.ts
 import { pbkdf2Sync, randomBytes } from "node:crypto";
 function generate(passphrase, outputByteLength, options) {

package/node/files/is-in-directory/index.js

@@ -1,5 +1,3 @@
-import "../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/files/is-in-directory/index.ts
 import path from "node:path";
 function isInDirectory(childPath, parentPath) {

package/node/files/read-write/index.js

@@ -1,5 +1,3 @@
-import "../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/files/read-write/index.ts
 import { promises as fs } from "node:fs";
 async function readWrite(path, editor, opts = {}) {

package/node/files/subpaths/index.js

@@ -1,11 +1,7 @@
-import {
-  matchesSome
-} from "../../../chunks/chunk-R3AWQXMY.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/files/subpaths/index.ts
 import { promises as fs } from "node:fs";
 import path from "node:path";
+import { matchesSome as stringMatchesSome } from "../../../agnostic/strings/matches/index.js";
 var defaultListContext = {
   depth: 0,
   lstats: null,
@@ -73,8 +69,8 @@ async function listAbsoluteSubpaths(inputPath, _options = {}, __private_context
       if (isHidden && options.hidden === false) throw false;
       const realPath = isSymlink ? await fs.realpath(childAbsPath) : childAbsPath;
       const childPathForFilters = options.returnRelative ? childRelFromRootPath : childAbsPath;
-      const isInExclude = matchesSome(childPathForFilters, options.exclude ?? []);
-      const isInInclude = matchesSome(childPathForFilters, options.include ?? []);
+      const isInExclude = stringMatchesSome(childPathForFilters, options.exclude ?? []);
+      const isInInclude = stringMatchesSome(childPathForFilters, options.include ?? []);
       if (isInExclude && !isInInclude) throw false;
       const isInFilter = await options.filter(childPathForFilters, { type, hidden: isHidden, realPath });
       if (!isInFilter) throw true;

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

@@ -1,9 +1,48 @@
-import {
-  copyDir
-} from "../../../../chunks/chunk-KEGTGEAM.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/directory/copy-dir/index.ts
+import { PassThrough } from "node:stream";
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+async function copyDir(ftpClient, sourceDir, targetDir, options) {
+  const {
+    overwrite = false,
+    ensureDir = true
+  } = options ?? {};
+  async function recurse(dir) {
+    const list = await ftpClient.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.isDirectory) {
+        if (ensureDir) await ftpClient.ensureDir(dst);
+        await recurse(src);
+      } else if (entry.isFile) {
+        if (!overwrite) {
+          try {
+            await ftpClient.size(dst);
+            throw new Error(`File already exists at ${dst}.`);
+          } catch {
+          }
+        }
+        if (ensureDir) {
+          const dirPath = dst.substring(0, dst.lastIndexOf("/"));
+          if (dirPath) await ftpClient.ensureDir(dirPath);
+        }
+        const pass = new PassThrough();
+        const upload = ftpClient.uploadFrom(pass, dst);
+        await ftpClient.downloadTo(pass, src);
+        await upload;
+      }
+    }
+  }
+  try {
+    if (ensureDir) await ftpClient.ensureDir(targetDir);
+    await recurse(sourceDir);
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   copyDir
 };

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

@@ -1,9 +1,15 @@
-import {
-  list
-} from "../../../../chunks/chunk-GOKDRSAD.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/directory/list/index.ts
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+async function list(ftpClient, directoryPath) {
+  try {
+    const list2 = await ftpClient.list(directoryPath);
+    const files = list2.filter((entry) => entry.isFile).map((entry) => directoryPath.endsWith("/") ? `${directoryPath}${entry.name}` : `${directoryPath}/${entry.name}`);
+    return Outcome.makeSuccess(files);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   list
 };

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

@@ -1,9 +1,28 @@
-import {
-  moveDir
-} from "../../../../chunks/chunk-FBWBGFRA.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/directory/move-dir/index.ts
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+async function moveDir(ftpClient, sourceDir, targetDir, options) {
+  const { overwrite = false, ensureDir = true } = options ?? {};
+  try {
+    if (ensureDir) {
+      const parentDir = targetDir.substring(0, targetDir.lastIndexOf("/"));
+      if (parentDir) {
+        await ftpClient.ensureDir(parentDir);
+      }
+    }
+    if (!overwrite) {
+      try {
+        await ftpClient.size(targetDir);
+        return Outcome.makeFailure(`Target ${targetDir} already exists.`);
+      } catch {
+      }
+    }
+    await ftpClient.rename(sourceDir, targetDir);
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   moveDir
 };

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

@@ -1,9 +1,30 @@
-import {
-  removeDir
-} from "../../../../chunks/chunk-ZE5QOQM6.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/directory/remove-dir/index.ts
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+async function removeDir(ftpClient, directoryPath, options) {
+  const { ignoreMissing = true } = options ?? {};
+  async function recurse(dir) {
+    const list = await ftpClient.list(dir);
+    for (const entry of list) {
+      const full = dir.endsWith("/") ? dir + entry.name : `${dir}/${entry.name}`;
+      if (entry.isDirectory) {
+        await recurse(full);
+      } else if (entry.isFile) {
+        await ftpClient.remove(full);
+      }
+    }
+    await ftpClient.removeDir(dir);
+  }
+  try {
+    await recurse(directoryPath);
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    if (ignoreMissing && err.code === 550) {
+      return Outcome.makeSuccess(true);
+    }
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   removeDir
 };

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

@@ -1,9 +1,33 @@
-import {
-  copy
-} from "../../../../chunks/chunk-5LCPENF6.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/file/copy/index.ts
+import { PassThrough } from "node:stream";
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+async function copy(ftpClient, sourcePath, targetPath, options) {
+  const {
+    overwrite = false,
+    ensureDir = true
+  } = options ?? {};
+  try {
+    if (!overwrite) {
+      try {
+        await ftpClient.size(targetPath);
+        return Outcome.makeFailure(`File already exists at ${targetPath}.`);
+      } catch {
+      }
+    }
+    if (ensureDir) {
+      const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
+      if (dirPath) await ftpClient.ensureDir(dirPath);
+    }
+    const pass = new PassThrough();
+    const uploadPromise = ftpClient.uploadFrom(pass, targetPath);
+    await ftpClient.downloadTo(pass, sourcePath);
+    await uploadPromise;
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   copy
 };

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

@@ -1,9 +1,18 @@
-import {
-  download
-} from "../../../../chunks/chunk-IV6JXJNW.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/file/download/index.ts
+import { PassThrough } from "node:stream";
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+async function download(ftpClient, sourcePath, options) {
+  const { startAt } = options ?? {};
+  const stream = new PassThrough();
+  try {
+    await ftpClient.downloadTo(stream, sourcePath, startAt);
+    return Outcome.makeSuccess(stream);
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return Outcome.makeFailure(errStr);
+  }
+}
 export {
   download
 };

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

@@ -1,9 +1,20 @@
-import {
-  exists
-} from "../../../../chunks/chunk-Q6Y27PHJ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/file/exists/index.ts
+import { FileType } from "basic-ftp";
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+async function exists(ftpClient, sourcePath) {
+  try {
+    const lastSlash = sourcePath.lastIndexOf("/");
+    const parentDir = lastSlash === -1 ? "." : sourcePath.slice(0, lastSlash) || "/";
+    const baseName = lastSlash === -1 ? sourcePath : sourcePath.slice(lastSlash + 1);
+    const list = await ftpClient.list(parentDir);
+    const entry = list.find((e) => e.name === baseName);
+    const isFile = entry ? entry.type === FileType.File || entry.type === FileType.SymbolicLink : false;
+    return Outcome.makeSuccess(isFile);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   exists
 };

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

@@ -1,9 +1,32 @@
-import {
-  move
-} from "../../../../chunks/chunk-J45Y3CWM.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/file/move/index.ts
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+async function move(ftpClient, sourcePath, targetPath, options) {
+  const {
+    ensureDir = true,
+    overwrite = false
+  } = options ?? {};
+  try {
+    if (ensureDir) {
+      const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
+      if (dirPath) await ftpClient.ensureDir(dirPath);
+    }
+    if (!overwrite) {
+      try {
+        await ftpClient.size(targetPath);
+        return Outcome.makeFailure(`File already exists at ${targetPath}.`);
+      } catch (err) {
+        if (err.code !== 550) {
+          return Outcome.makeFailure(unknownToString(err));
+        }
+      }
+    }
+    await ftpClient.rename(sourcePath, targetPath);
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   move
 };

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

@@ -1,9 +1,28 @@
-import {
-  remove
-} from "../../../../chunks/chunk-T3F3S6XV.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/file/remove/index.ts
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+async function remove(ftpClient, targetPath, options) {
+  const { ignoreMissing = true } = options ?? {};
+  try {
+    let fileExists = true;
+    try {
+      await ftpClient.size(targetPath);
+    } catch {
+      fileExists = false;
+    }
+    if (!fileExists) {
+      if (ignoreMissing) {
+        return Outcome.makeSuccess(true);
+      }
+      return Outcome.makeFailure(`File not found at ${targetPath}.`);
+    }
+    await ftpClient.remove(targetPath);
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return Outcome.makeFailure(errStr);
+  }
+}
 export {
   remove
 };

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

@@ -1,9 +1,24 @@
-import {
-  stat
-} from "../../../../chunks/chunk-D3J6JAJW.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/file/stat/index.ts
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+async function stat(ftp, path) {
+  try {
+    const slash = path.lastIndexOf("/");
+    const dir = slash === -1 ? "." : path.slice(0, slash) || "/";
+    const name = slash === -1 ? path : path.slice(slash + 1);
+    const list = await ftp.list(dir);
+    const entry = list.find((e) => e.name === name && e.isFile);
+    if (!entry) return Outcome.makeFailure(`File not found: ${path}`);
+    return Outcome.makeSuccess({
+      size: entry.size,
+      modifiedAt: entry.modifiedAt ?? void 0,
+      permissions: entry.rawModifiedAt ? entry.rawModifiedAt.toString() : void 0,
+      raw: entry
+    });
+  } catch (err) {
+    return Outcome.makeFailure(unknownToString(err));
+  }
+}
 export {
   stat
 };

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

@@ -1,9 +1,33 @@
-import {
-  upload
-} from "../../../../chunks/chunk-CDIXAYVL.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+// src/node/ftps/file/upload/index.ts
+import { unknownToString } from "../../../../agnostic/errors/unknown-to-string/index.js";
+import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
+async function upload(ftpClient, targetPath, fileStream, options) {
+  const {
+    ensureDir = true,
+    overwrite = false
+  } = options ?? {};
+  try {
+    if (ensureDir) {
+      const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
+      await ftpClient.ensureDir(dirPath);
+    }
+    let fileExists = false;
+    try {
+      await ftpClient.size(targetPath);
+      fileExists = true;
+    } catch {
+      fileExists = false;
+    }
+    if (fileExists && !overwrite) {
+      return Outcome.makeFailure(`File already exists at ${targetPath}.`);
+    }
+    await ftpClient.uploadFrom(fileStream, targetPath, options);
+    return Outcome.makeSuccess(true);
+  } catch (err) {
+    const errStr = unknownToString(err);
+    return Outcome.makeFailure(errStr);
+  }
+}
 export {
   upload
 };

package/node/images/create/index.js

@@ -1,16 +1,6 @@
-import {
-  toCreateOptions
-} from "../../../chunks/chunk-6KOJFWH3.js";
-import "../../../chunks/chunk-RNXRHCHQ.js";
-import "../../../chunks/chunk-DNIOWD7K.js";
-import "../../../chunks/chunk-OSAXBA7G.js";
-import "../../../chunks/chunk-JDINERKY.js";
-import "../../../chunks/chunk-HQLRJ7XW.js";
-import "../../../chunks/chunk-KRYJVBO5.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
 // src/node/images/create/index.ts
 import sharp from "sharp";
+import { toCreateOptions } from "../utils/index.js";
 async function create(options) {
   return sharp({ create: toCreateOptions(options) });
 }