@design-edito/tools 0.2.41 → 1.0.1

package/node/encryption/key/index.d.ts

@@ -1,16 +0,0 @@
-export type GenerateOptions = {
-    saltLength?: number;
-    iterations?: number;
-};
-/**
- * Generates an encryption key from a passphrase using PBKDF2.
- *
- * @param {string} passphrase - The passphrase to derive the key from.
- * @param {number} outputByteLength - The length of the output encryption key in bytes.
- * @param {GenerateOptions} [options] - Optional options.
- * @param {number} [options.saltLength=16] - The length of the salt in bytes. Defaults to 16 bytes.
- * @param {number} [options.iterations=100000] - The number of PBKDF2 iterations. Defaults to 100,000 iterations.
- *
- * @returns {string} The derived encryption key and salt, concatenated as a string in the format `salt:encryptionKey`.
- */
-export declare function generate(passphrase: string, outputByteLength: number, options?: GenerateOptions): string;

package/node/encryption/key/index.js

@@ -1,15 +0,0 @@
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/node/encryption/key/index.ts
-import { pbkdf2Sync, randomBytes } from "node:crypto";
-function generate(passphrase, outputByteLength, options) {
-  const { saltLength = 16, iterations = 1e5 } = options ?? {};
-  const salt = randomBytes(saltLength);
-  const key = pbkdf2Sync(passphrase, salt, iterations, outputByteLength, "sha256");
-  const saltString = salt.toString("hex");
-  const keyString = key.toString("hex");
-  return `${saltString}:${keyString}`;
-}
-export {
-  generate
-};

package/node/files/is-in-directory/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Checks whether a child path is contained within a parent directory.
- *
- * @param childPath  - The path to check if it's within the parent.
- * @param parentPath - The parent directory path.
- * @returns `true` if `childPath` is within `parentPath`, `false` otherwise.
- */
-export declare function isInDirectory(childPath: string, parentPath: string): boolean;

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

@@ -1,11 +0,0 @@
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/node/files/is-in-directory/index.ts
-import path from "node:path";
-function isInDirectory(childPath, parentPath) {
-  const rel = path.relative(parentPath, childPath);
-  return rel !== "" && !rel.startsWith("..");
-}
-export {
-  isInDirectory
-};

package/node/files/read-write/index.d.ts

@@ -1,53 +0,0 @@
-import { promises as fs } from 'node:fs';
-type Path = Parameters<typeof fs.writeFile>[0];
-type ReadFileData = Awaited<ReturnType<typeof fs.readFile>>;
-type WriteFileData = Parameters<typeof fs.writeFile>[1];
-export type Options = {
-    /** Additional parameters forwarded to the underlying `fs.readFile`. */
-    readOptions?: Parameters<typeof fs.readFile>[1];
-    /** Additional parameters forwarded to the underlying `fs.writeFile`. */
-    writeOptions?: Parameters<typeof fs.writeFile>[2];
-    /** Output path for the edited file. If not provided, the file is written back to the original `path`. */
-    output?: Path;
-    /** If `true`, the file is not written to disk, only the edited content is returned. @default false */
-    dryRun?: boolean;
-};
-/** Function that takes the current file content and returns the edited content. */
-export type EditorFunc<T extends WriteFileData = WriteFileData> = (curr: ReadFileData) => T;
-/** Object mapping strings to replace (keys) with their replacements (values). */
-export type Replacements = Record<string, string>;
-/**
- * Reads a file, applies edits, and optionally writes it back.
- *
- * The function supports two editing modes:
- * - **Replacements mode**: Pass an object with string replacements.
- * - **Function mode**: Pass a function that transforms the file content.
- *
- * @param {Path} path                    - The path to the file to read and edit.
- * @param {Replacements} editor          - Object mapping strings to replace with their replacements.
- * @param {Options} [opts]               - Optional configuration.
- * @param {Parameters<typeof fs.readFile>[1]} [opts.readOptions]  - Extra `readFile` params.
- * @param {Parameters<typeof fs.writeFile>[2]} [opts.writeOptions] - Extra `writeFile` params.
- * @param {Path} [opts.output]           - Output path (defaults to `path`).
- * @param {boolean} [opts.dryRun=false]  - If `true`, skip writing to disk.
- * @returns {Promise<string>} The edited file content as a string.
- */
-export declare function readWrite(path: Path, editor: Replacements, opts?: Options): Promise<string>;
-/**
- * Reads a file, applies edits, and optionally writes it back.
- *
- * The function supports two editing modes:
- * - **Replacements mode**: Pass an object with string replacements.
- * - **Function mode**: Pass a function that transforms the file content.
- *
- * @param {Path} path                    - The path to the file to read and edit.
- * @param {EditorFunc<T>} editor         - Function that transforms the file content.
- * @param {Options} [opts]               - Optional configuration.
- * @param {Parameters<typeof fs.readFile>[1]} [opts.readOptions]  - Extra `readFile` params.
- * @param {Parameters<typeof fs.writeFile>[2]} [opts.writeOptions] - Extra `writeFile` params.
- * @param {Path} [opts.output]           - Output path (defaults to `path`).
- * @param {boolean} [opts.dryRun=false]  - If `true`, skip writing to disk.
- * @returns {Promise<T>} The edited file content of type `T`.
- */
-export declare function readWrite<T extends WriteFileData>(path: Path, editor: EditorFunc<T>, opts?: Options): Promise<T>;
-export {};

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

@@ -1,18 +0,0 @@
-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 = {}) {
-  const readData = await fs.readFile(path, opts.readOptions);
-  const edited = typeof editor === "function" ? editor(readData) : Object.entries(editor).reduce(
-    (acc, [from, to]) => acc.replaceAll(from, to),
-    readData.toString()
-  );
-  const actualWriteOptions = opts.writeOptions ?? opts.readOptions;
-  const targetOutput = opts.output === void 0 ? path : opts.output;
-  if (opts.dryRun !== true) await fs.writeFile(targetOutput, edited, actualWriteOptions);
-  return edited;
-}
-export {
-  readWrite
-};

package/node/files/subpaths/index.d.ts

@@ -1,63 +0,0 @@
-import { Stats } from 'node:fs';
-/** Type of child entry in a directory. */
-export type ChildType = 'file' | 'directory' | 'symlink';
-export type ChildDetails = {
-    /** The type of the child entry. */ type: ChildType;
-    /** Whether the child entry is hidden (starts with '.'). */ hidden: boolean;
-    /** The real path of the child entry (resolved if it's a symlink). */ realPath: string;
-};
-export type ListContext = {
-    /** Current recursion depth. */ depth?: number;
-    /** Cached lstat result for the current path. */ lstats?: Stats | null;
-    /** Root path from which the listing started. */ rootPath?: string | null;
-};
-export declare const defaultListContext: Required<ListContext>;
-/**
- * Fills missing properties in a list context with default values.
- *
- * @param {ListContext} input - The partial list context to fill.
- * @returns {Required<ListContext>} A complete list context with all properties set.
- */
-export declare const fillListContext: (input: ListContext) => Required<ListContext>;
-export type ListOptions = {
-    /** Whether to include directories in the results. @default true */ directories?: boolean;
-    /** Whether to include files in the results. @default true */ files?: boolean;
-    /** Whether to include symlinks in the results. @default true */ symlinks?: boolean;
-    /** Whether to include hidden files/directories (starting with '.'). @default true */ hidden?: boolean;
-    /** Whether to follow symlinks and include their contents. @default false */ followSimlinks?: boolean;
-    /** Whether to deduplicate paths when following symlinks. @default false */ dedupeSimlinksContents?: boolean;
-    /** Maximum recursion depth. @default Infinity */ maxDepth?: number;
-    /** Whether to return relative paths instead of absolute paths. @default false */ returnRelative?: boolean;
-    /** Patterns to exclude from the results. */ exclude?: RegExp | string | (RegExp | string)[] | null;
-    /** Patterns to include in the results (takes precedence over exclude). */ include?: RegExp | string | (RegExp | string)[] | null;
-    /** Custom filter function to further refine results. */ filter?: ((path: string, details: ChildDetails) => boolean | Promise<boolean>);
-};
-export declare const defaultListOptions: Required<ListOptions>;
-/**
- * Fills missing properties in list options with default values.
- *
- * @param {ListOptions} input - The partial list options to fill.
- * @returns {Required<ListOptions>} A complete list options object with all properties set.
- */
-export declare const fillOptions: (input: ListOptions) => Required<ListOptions>;
-/**
- * Lists all subpaths under a given directory path.
- *
- * The function recursively traverses the directory tree and returns all matching
- * files, directories, and symlinks based on the provided options.
- *
- * @param inputPath - The root directory path to list subpaths from.
- * @param [options] - Optional configuration for filtering and behavior. See `ListOptions` for details.
- * @returns Array of subpaths (absolute or relative based on `returnRelative` option).
- */
-export declare function list(...args: Parameters<typeof listAbsoluteSubpaths>): Promise<string[]>;
-/**
- * Internal function that lists absolute subpaths recursively.
- *
- * @param {string} inputPath              - The directory path to list.
- * @param {ListOptions} [_options]        - Optional configuration.
- * @param {ListContext} [__private_context] - Internal recursion context.
- * @returns {Promise<string[]>} Array of absolute subpaths.
- */
-declare function listAbsoluteSubpaths(inputPath: string, _options?: ListOptions, __private_context?: ListContext): Promise<string[]>;
-export {};

package/node/files/subpaths/index.js

@@ -1,122 +0,0 @@
-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";
-var defaultListContext = {
-  depth: 0,
-  lstats: null,
-  rootPath: null
-};
-var fillListContext = (input) => {
-  return {
-    ...defaultListContext,
-    ...input
-  };
-};
-var defaultListOptions = {
-  directories: true,
-  files: true,
-  symlinks: true,
-  hidden: true,
-  followSimlinks: false,
-  dedupeSimlinksContents: false,
-  maxDepth: Infinity,
-  returnRelative: false,
-  exclude: null,
-  include: null,
-  filter: () => true
-};
-var fillOptions = (input) => {
-  return {
-    ...defaultListOptions,
-    ...input
-  };
-};
-async function list(...args) {
-  const [inputPath, _options] = args;
-  const options = fillOptions(_options ?? {});
-  const subpaths = await listAbsoluteSubpaths(...args);
-  return options.returnRelative ? subpaths.map((subpath) => path.relative(inputPath, subpath)) : subpaths;
-}
-async function listAbsoluteSubpaths(inputPath, _options = {}, __private_context = {}) {
-  const options = fillOptions(_options);
-  const _private_context = fillListContext(__private_context);
-  if (_private_context.rootPath === null) {
-    _private_context.rootPath = inputPath;
-  }
-  const subpaths = [];
-  if (_private_context.depth > options.maxDepth) return subpaths;
-  try {
-    const pathStat = _private_context.lstats ?? await fs.lstat(inputPath);
-    if (!pathStat.isDirectory()) return subpaths;
-  } catch (err) {
-    return subpaths;
-  }
-  const childrenRelPaths = await fs.readdir(inputPath);
-  await Promise.all(childrenRelPaths.map(async (childRelPath) => {
-    const childAbsPath = path.join(inputPath, childRelPath);
-    const childRelFromRootPath = path.relative(_private_context.rootPath ?? inputPath, childAbsPath);
-    const childLstats = await fs.lstat(childAbsPath);
-    try {
-      const isDirectory = childLstats.isDirectory();
-      const isSymlink = childLstats.isSymbolicLink();
-      const isFile = !isDirectory && !isSymlink;
-      const isHidden = path.basename(childAbsPath).startsWith(".");
-      const type = isDirectory ? "directory" : isSymlink ? "symlink" : "file";
-      if (isDirectory && options.directories === false) throw true;
-      if (isSymlink && options.symlinks === false) throw false;
-      if (isFile && options.files === false) throw false;
-      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 ?? []);
-      if (isInExclude && !isInInclude) throw false;
-      const isInFilter = await options.filter(childPathForFilters, { type, hidden: isHidden, realPath });
-      if (!isInFilter) throw true;
-      if (isSymlink) {
-        if (options.followSimlinks === false) subpaths.push(childAbsPath);
-        else {
-          const childSubpaths = await listAbsoluteSubpaths(realPath, options, {
-            ..._private_context,
-            depth: _private_context.depth + 1
-          });
-          subpaths.push(realPath, ...childSubpaths);
-        }
-      } else {
-        if (isDirectory) {
-          const childSubpaths = await listAbsoluteSubpaths(childAbsPath, options, {
-            ..._private_context,
-            depth: _private_context.depth + 1,
-            lstats: childLstats
-          });
-          subpaths.push(childAbsPath, ...childSubpaths);
-        } else {
-          subpaths.push(childAbsPath);
-        }
-      }
-    } catch (err) {
-      if (typeof err !== "boolean") throw new Error(`This try/catch block should only throw booleans`);
-      const shouldDiveDeeper = err;
-      if (!shouldDiveDeeper) return [];
-      const childSubpaths = await listAbsoluteSubpaths(childAbsPath, options, {
-        ..._private_context,
-        depth: _private_context.depth + 1,
-        lstats: childLstats
-      });
-      subpaths.push(...childSubpaths);
-    }
-  }));
-  return options.dedupeSimlinksContents ? Array.from(new Set(subpaths)) : subpaths;
-}
-export {
-  defaultListContext,
-  defaultListOptions,
-  fillListContext,
-  fillOptions,
-  list
-};

package/node/ftps/directory/copy-dir/index.d.ts

@@ -1,28 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type CopyDirOptions = {
-    /**
-     * If `false` and a destination file already exists, copying aborts.
-     * @default false
-     */
-    overwrite?: boolean;
-    /**
-     * When `true`, creates any missing directories in the destination path
-     * (`ftpClient.ensureDir`) before writing files.
-     * @default true
-     */
-    ensureDir?: boolean;
-};
-/**
- * Recursively copies every file under `sourceDir` to the same relative path
- * beneath `targetDir` on an FTP server, streaming data to avoid buffering.
- *
- * @param {Client}  ftpClient  - The FTP 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>>}
- * - Success: `Outcome.makeSuccess(true)` if the copy succeeds.
- * - Failure: `Outcome.makeFailure(errStr)` if an error occurs.
- */
-export declare function copyDir(ftpClient: Client, sourceDir: string, targetDir: string, options?: CopyDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +0,0 @@
-import {
-  copyDir
-} from "../../../../chunks/chunk-RGQNRTBI.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  copyDir
-};

package/node/ftps/directory/list/index.d.ts

@@ -1,12 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-/**
- * Lists all direct children files under a given directory on an FTP server.
- *
- * This function returns only the immediate files (not recursive) under the specified directory.
- *
- * @param {Client} ftpClient - The basic-ftp client instance used to interact with the FTP 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 declare function list(ftpClient: Client, directoryPath: string): Promise<Outcome.Either<string[], string>>;

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

@@ -1,9 +0,0 @@
-import {
-  list
-} from "../../../../chunks/chunk-DBNCEHTT.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  list
-};

package/node/ftps/directory/move-dir/index.d.ts

@@ -1,26 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type MoveDirOptions = {
-    /** If false and `targetDir` exists, the operation is aborted. Defaults to false. */
-    overwrite?: boolean;
-    /** If true, ensures the parent directory of `targetDir` exists before moving. Defaults to true. */
-    ensureDir?: boolean;
-};
-/**
- * Renames (moves) a directory on an FTP server.
- * Most FTP servers allow `RNFR /path/old` + `RNTO /path/new` to move a tree
- * atomically. Falling back to manual copy/delete would be expensive, so this
- * util simply performs `rename`.
- *
- * If `ensureDir` is true (default), the parent directory of `targetDir` is
- * created if it does not exist.
- *
- * @param {Client} ftpClient - The FTP 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.
- * @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 declare function moveDir(ftpClient: Client, sourceDir: string, targetDir: string, options?: MoveDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +0,0 @@
-import {
-  moveDir
-} from "../../../../chunks/chunk-PTN2V757.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  moveDir
-};

package/node/ftps/directory/remove-dir/index.d.ts

@@ -1,25 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type RemoveDirOptions = {
-    /**
-     * If **true** (default) the function ignores the case where `directoryPath`
-     * does not exist and simply returns success.
-     * If **false** and the path is missing, the function returns a failure.
-     * @default true
-     */
-    ignoreMissing?: boolean;
-};
-/**
- * Recursively deletes a directory (and all contents) on an FTP server.
- *
- * @param {Client} ftpClient            - The FTP client instance.
- * @param {string} directoryPath        - The path of the directory to delete.
- * @param {RemoveDirOptions} [options]  - Optional configuration.
- * @param {boolean} [options.ignoreMissing=true] - Whether to ignore a missing directory.
- * @returns {Promise<Outcome.Either<true, string>>}
- * - On success: `Outcome.makeSuccess(true)` – deletion succeeded, or directory
- *   was absent and `ignoreMissing` is true.
- * - On failure: `Outcome.makeFailure(errStr)` if deletion fails, or directory
- *   absent and `ignoreMissing` is false.
- */
-export declare function removeDir(ftpClient: Client, directoryPath: string, options?: RemoveDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +0,0 @@
-import {
-  removeDir
-} from "../../../../chunks/chunk-W5VY535B.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  removeDir
-};

package/node/ftps/file/copy/index.d.ts

@@ -1,28 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type CopyOptions = {
-    /**
-     * If `false` and the target already exists, the operation is aborted.
-     * @default false
-     */
-    overwrite?: boolean;
-    /**
-     * If `true`, ensures that the target directory hierarchy exists before the
-     * upload starts (creates missing folders with `ensureDir`).
-     * @default true
-     */
-    ensureDir?: boolean;
-};
-/**
- * Copies a file from one path to another on the same FTP server, streaming the
- * data instead of buffering it in memory.
- *
- * @param {Client}  ftpClient  - The basic‑ftp client instance.
- * @param {string}  sourcePath - The path of the source file.
- * @param {string}  targetPath - The destination path.
- * @param {CopyOptions} [options] - Optional copy configuration.
- * @returns {Promise<Outcome.Either<true, string>>}
- * - On success:  `Outcome.makeSuccess(true)`.
- * - On failure:  `Outcome.makeFailure(errStr)`.
- */
-export declare function copy(ftpClient: Client, sourcePath: string, targetPath: string, options?: CopyOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +0,0 @@
-import {
-  copy
-} from "../../../../chunks/chunk-7B2E2NGH.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  copy
-};

package/node/ftps/file/download/index.d.ts

@@ -1,22 +0,0 @@
-import { Readable } from 'node:stream';
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type DownloadOptions = {
-    startAt?: number;
-};
-/**
- * Downloads a file from a specified FTP server.
- *
- * This function downloads a file from the given FTP server at the specified source path,
- * returning the file content as a Readable stream. The download process can be customized
- * using optional download options.
- *
- * @param {Client} ftpClient - The basic-ftp client instance used to interact with the FTP server.
- * @param {string} sourcePath - The path of the file to be downloaded from the FTP server.
- * @param {DownloadOptions} [options] - Optional settings for configuring the download process.
- * @param {number} [options.startAt] - The byte offset at which to start downloading the file.
- * @returns {Promise<Outcome.Either<Readable, string>>} A promise that resolves to an Outcome.Either.
- * - On success: Outcome.makeSuccess(stream) containing the downloaded file's content as a Readable stream.
- * - On failure: Outcome.makeFailure(errStr) with an error message if the download fails.
- */
-export declare function download(ftpClient: Client, sourcePath: string, options?: DownloadOptions): Promise<Outcome.Either<Readable, string>>;

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

@@ -1,9 +0,0 @@
-import {
-  download
-} from "../../../../chunks/chunk-54KPQCVI.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  download
-};

package/node/ftps/file/exists/index.d.ts

@@ -1,21 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-/**
- * Checks if a *file* (not a directory) exists on a specified FTP server.
- *
- * `ftpClient.list(parentDir)` returns an array of `FileInfo` objects:
- *   • `type === FileType.File`          → regular file
- *   • `type === FileType.Directory`     → directory
- *   • `type === FileType.SymbolicLink`  → symlink
- *
- * The function reports **true** only for `FileType.File` or
- * `FileType.SymbolicLink`, mirroring the SFTP behaviour where `'-'` and `'l'`
- * are considered files.
- *
- * @param {Client} ftpClient  - The basic‑ftp client instance.
- * @param {string} sourcePath - The full path to check on the FTP server.
- * @returns {Promise<Outcome.Either<boolean, string>>}
- * - Success: `Outcome.makeSuccess(true | false)` – true only if a file exists.
- * - Failure: `Outcome.makeFailure(errStr)` if an error occurs.
- */
-export declare function exists(ftpClient: Client, sourcePath: string): Promise<Outcome.Either<boolean, string>>;

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

@@ -1,9 +0,0 @@
-import {
-  exists
-} from "../../../../chunks/chunk-J5D4OQ5U.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  exists
-};

package/node/ftps/file/move/index.d.ts

@@ -1,38 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type MoveOptions = {
-    /**
-     * When `true`, ensures that the parent directory of `targetPath` exists
-     * before attempting the rename (`ftpClient.ensureDir`).
-     * @default true
-     */
-    ensureDir?: boolean;
-    /**
-     * When `false` (default) and `targetPath` already exists, the move is aborted
-     * and a failure is returned.
-     * @default false
-     */
-    overwrite?: boolean;
-};
-/**
- * Moves (renames) a file on an FTP server.
- *
- * The function performs a simple `rename` operation, which moves the file from
- * `sourcePath` to `targetPath`.  It supports two safety features:
- *
- * 1. **ensureDir** – If enabled, the parent directory of `targetPath`
- *    is created with `ftpClient.ensureDir` before the rename.
- * 2. **overwrite** – If disabled (default) the function first checks whether
- *    an object already exists at `targetPath`; if so, it aborts.
- *
- * @param {Client} ftpClient  - The basic‑ftp client instance.
- * @param {string} sourcePath - The full path of the source file.
- * @param {string} targetPath - The full destination path.
- * @param {MoveOptions} [options] - Optional move configuration.
- * @param {boolean} [options.ensureDir=true]  - Whether to create missing parent directories.
- * @param {boolean} [options.overwrite=false] - Whether to overwrite an existing destination.
- * @returns {Promise<Outcome.Either<true, string>>}
- * - On success: `Outcome.makeSuccess(true)`.
- * - On failure: `Outcome.makeFailure(errStr)`.
- */
-export declare function move(ftpClient: Client, sourcePath: string, targetPath: string, options?: MoveOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +0,0 @@
-import {
-  move
-} from "../../../../chunks/chunk-DBZAJJUF.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  move
-};

package/node/ftps/file/remove/index.d.ts

@@ -1,20 +0,0 @@
-import { Client } from 'basic-ftp';
-import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
-export type RemoveOptions = {
-    ignoreMissing?: boolean;
-};
-/**
- * Removes a file from a specified FTP server.
- *
- * This function removes the file located at the given path on the FTP server.
- * The deletion process can be customized using optional delete options.
- * If the `ignoreMissing` option is true, it does not treat a missing file as an error.
- *
- * @param {Client} ftpClient - The basic-ftp client instance used to interact with the FTP server.
- * @param {string} targetPath - The path of the file to delete on the FTP server.
- * @param {RemoveOptions} [options] - Optional settings for configuring the deletion process.
- * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an Outcome.Either.
- * - On success: Outcome.makeSuccess(true) indicating the deletion was successful.
- * - On failure: Outcome.makeFailure(errStr) with an error message if the deletion fails.
- */
-export declare function remove(ftpClient: Client, targetPath: string, options?: RemoveOptions): Promise<Outcome.Either<true, string>>;

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

@@ -1,9 +0,0 @@
-import {
-  remove
-} from "../../../../chunks/chunk-S2I77NEE.js";
-import "../../../../chunks/chunk-QEKI6WGQ.js";
-import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
-export {
-  remove
-};