@design-edito/tools 0.1.70 → 0.1.72

package/node/images/transform/index.js

@@ -2,52 +2,52 @@ import {
   apply,
   isOperation,
   transform
-} from "../../../chunks/chunk-FZJUZYTP.js";
+} from "../../../chunks/chunk-XDTFPTMG.js";
+import "../../../chunks/chunk-AWVQJNGX.js";
 import "../../../chunks/chunk-JRYI4VBX.js";
-import "../../../chunks/chunk-RCWLMVSZ.js";
-import "../../../chunks/chunk-7Z7CKAOH.js";
+import "../../../chunks/chunk-XFMKYZKH.js";
+import "../../../chunks/chunk-OCM3RLO6.js";
+import "../../../chunks/chunk-SY65O2JU.js";
 import "../../../chunks/chunk-ZRWVPWQC.js";
-import "../../../chunks/chunk-LNSDOGTR.js";
+import "../../../chunks/chunk-C4Q4PC53.js";
 import "../../../chunks/chunk-CP454IJD.js";
-import "../../../chunks/chunk-X244JGZD.js";
-import "../../../chunks/chunk-YCSC7QNV.js";
-import "../../../chunks/chunk-E3GK7YZ7.js";
-import "../../../chunks/chunk-AWVQJNGX.js";
-import "../../../chunks/chunk-OCM3RLO6.js";
-import "../../../chunks/chunk-6IZ5HUJJ.js";
-import "../../../chunks/chunk-662SOZWA.js";
-import "../../../chunks/chunk-6EIF24H5.js";
-import "../../../chunks/chunk-LSOHLSF5.js";
-import "../../../chunks/chunk-D33KC6NN.js";
-import "../../../chunks/chunk-ZMMNN3QA.js";
-import "../../../chunks/chunk-NAP2XNYN.js";
-import "../../../chunks/chunk-G3HAKMUB.js";
-import "../../../chunks/chunk-D47ZPEUU.js";
-import "../../../chunks/chunk-WRRA3BN4.js";
-import "../../../chunks/chunk-C3ZKLONL.js";
-import "../../../chunks/chunk-Z4PVE6SR.js";
-import "../../../chunks/chunk-U7R6TPHR.js";
-import "../../../chunks/chunk-T2T5BYTW.js";
-import "../../../chunks/chunk-UNHNZAVP.js";
-import "../../../chunks/chunk-YEYXAV23.js";
-import "../../../chunks/chunk-W6JPRXQ4.js";
-import "../../../chunks/chunk-3UM5CZA5.js";
-import "../../../chunks/chunk-CM6AHRTS.js";
+import "../../../chunks/chunk-O4AEYNFT.js";
+import "../../../chunks/chunk-IY44AG73.js";
+import "../../../chunks/chunk-N7FA7QJK.js";
+import "../../../chunks/chunk-FTGHUU73.js";
+import "../../../chunks/chunk-YVUJ4WBL.js";
+import "../../../chunks/chunk-5HW7QLTB.js";
+import "../../../chunks/chunk-7647NLB2.js";
+import "../../../chunks/chunk-MQ4Y3GBI.js";
+import "../../../chunks/chunk-N4EJZLME.js";
+import "../../../chunks/chunk-XKMSDS3Z.js";
+import "../../../chunks/chunk-NQNEYA4Z.js";
+import "../../../chunks/chunk-EZW6DNPL.js";
+import "../../../chunks/chunk-2YGNPA2R.js";
+import "../../../chunks/chunk-HNFSETMT.js";
+import "../../../chunks/chunk-BVCNQIKY.js";
+import "../../../chunks/chunk-WHGU2Q46.js";
+import "../../../chunks/chunk-34C35EX6.js";
+import "../../../chunks/chunk-S4FNXSMM.js";
+import "../../../chunks/chunk-JFWEEBSR.js";
+import "../../../chunks/chunk-TLYXVMR5.js";
+import "../../../chunks/chunk-45S766KF.js";
+import "../../../chunks/chunk-YMPNQJ4Z.js";
 import "../../../chunks/chunk-MOVLLUDL.js";
-import "../../../chunks/chunk-YE67BQQN.js";
+import "../../../chunks/chunk-T4KFB6QN.js";
 import "../../../chunks/chunk-ENMBK6H7.js";
 import "../../../chunks/chunk-JMU5PDBD.js";
 import "../../../chunks/chunk-4CIS3R7T.js";
 import "../../../chunks/chunk-OSAXBA7G.js";
 import "../../../chunks/chunk-D3ERTRDW.js";
-import "../../../chunks/chunk-U57Q62IN.js";
-import "../../../chunks/chunk-MB7HWF22.js";
+import "../../../chunks/chunk-PXRLKO5Y.js";
 import "../../../chunks/chunk-2POD3TAX.js";
-import "../../../chunks/chunk-QLC3A6PC.js";
+import "../../../chunks/chunk-3LAWRHHB.js";
 import "../../../chunks/chunk-YVLJKJV2.js";
-import "../../../chunks/chunk-FENXVJYO.js";
+import "../../../chunks/chunk-QLC3A6PC.js";
 import "../../../chunks/chunk-VJJIYJMY.js";
-import "../../../chunks/chunk-NZLE2WMY.js";
+import "../../../chunks/chunk-FENXVJYO.js";
+import "../../../chunks/chunk-KH45J4DC.js";
 export {
   apply,
   isOperation,

package/node/images/transform/lighten/index.js

@@ -1,9 +1,9 @@
 import {
   lightenSchema
-} from "../../../../chunks/chunk-W6JPRXQ4.js";
+} from "../../../../chunks/chunk-7647NLB2.js";
 import "../../../../chunks/chunk-MOVLLUDL.js";
-import "../../../../chunks/chunk-YE67BQQN.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-T4KFB6QN.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
 export {
   lightenSchema
 };

package/node/images/transform/lineate-levels/index.js

@@ -1,9 +1,9 @@
 import {
   lineateLevelsSchema
-} from "../../../../chunks/chunk-6EIF24H5.js";
+} from "../../../../chunks/chunk-5HW7QLTB.js";
 import "../../../../chunks/chunk-MOVLLUDL.js";
-import "../../../../chunks/chunk-YE67BQQN.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-T4KFB6QN.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
 export {
   lineateLevelsSchema
 };

package/node/images/transform/modulate/index.js

@@ -1,9 +1,9 @@
 import {
   modulateSchema
-} from "../../../../chunks/chunk-6IZ5HUJJ.js";
+} from "../../../../chunks/chunk-N4EJZLME.js";
 import "../../../../chunks/chunk-MOVLLUDL.js";
-import "../../../../chunks/chunk-YE67BQQN.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-T4KFB6QN.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
 export {
   modulateSchema
 };

package/node/images/transform/normalize/index.js

@@ -1,9 +1,9 @@
 import {
   normalizeSchema
-} from "../../../../chunks/chunk-662SOZWA.js";
+} from "../../../../chunks/chunk-MQ4Y3GBI.js";
 import "../../../../chunks/chunk-MOVLLUDL.js";
-import "../../../../chunks/chunk-YE67BQQN.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-T4KFB6QN.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
 export {
   normalizeSchema
 };

package/node/images/transform/operations/_utils/compose/index.js

@@ -2,7 +2,7 @@ import {
   compose
 } from "../../../../../../chunks/chunk-AWVQJNGX.js";
 import "../../../../../../chunks/chunk-OCM3RLO6.js";
-import "../../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../../chunks/chunk-KH45J4DC.js";
 export {
   compose
 };

package/node/images/transform/operations/_utils/frame/backgrounds/create-line-background/index.js

@@ -1,12 +1,12 @@
 import {
   createLineBackground
-} from "../../../../../../../../chunks/chunk-LNSDOGTR.js";
-import "../../../../../../../../chunks/chunk-U57Q62IN.js";
-import "../../../../../../../../chunks/chunk-MB7HWF22.js";
+} from "../../../../../../../../chunks/chunk-C4Q4PC53.js";
+import "../../../../../../../../chunks/chunk-PXRLKO5Y.js";
 import "../../../../../../../../chunks/chunk-2POD3TAX.js";
-import "../../../../../../../../chunks/chunk-QLC3A6PC.js";
+import "../../../../../../../../chunks/chunk-3LAWRHHB.js";
 import "../../../../../../../../chunks/chunk-YVLJKJV2.js";
-import "../../../../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../../../../chunks/chunk-QLC3A6PC.js";
+import "../../../../../../../../chunks/chunk-KH45J4DC.js";
 export {
   createLineBackground
 };

package/node/images/transform/operations/_utils/frame/backgrounds/create-tile-background/index.js

@@ -7,7 +7,7 @@ import "../../../../../../../../chunks/chunk-4CIS3R7T.js";
 import "../../../../../../../../chunks/chunk-OSAXBA7G.js";
 import "../../../../../../../../chunks/chunk-D3ERTRDW.js";
 import "../../../../../../../../chunks/chunk-VJJIYJMY.js";
-import "../../../../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../../../../chunks/chunk-KH45J4DC.js";
 export {
   DEFAULT_CREATE_BACKGROUND_TILE_PARAMS,
   createTileBackground

package/node/images/transform/operations/_utils/frame/create-color-palette/index.js

@@ -1,16 +1,16 @@
 import {
   createColorPalette,
   densifyPalette
-} from "../../../../../../../chunks/chunk-7Z7CKAOH.js";
+} from "../../../../../../../chunks/chunk-SY65O2JU.js";
 import "../../../../../../../chunks/chunk-ZRWVPWQC.js";
 import "../../../../../../../chunks/chunk-OSAXBA7G.js";
-import "../../../../../../../chunks/chunk-U57Q62IN.js";
-import "../../../../../../../chunks/chunk-MB7HWF22.js";
+import "../../../../../../../chunks/chunk-PXRLKO5Y.js";
 import "../../../../../../../chunks/chunk-2POD3TAX.js";
-import "../../../../../../../chunks/chunk-QLC3A6PC.js";
+import "../../../../../../../chunks/chunk-3LAWRHHB.js";
 import "../../../../../../../chunks/chunk-YVLJKJV2.js";
+import "../../../../../../../chunks/chunk-QLC3A6PC.js";
 import "../../../../../../../chunks/chunk-VJJIYJMY.js";
-import "../../../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../../../chunks/chunk-KH45J4DC.js";
 export {
   createColorPalette,
   densifyPalette

package/node/images/transform/operations/_utils/frame/extract-colors-from-image/index.js

@@ -3,7 +3,7 @@ import {
   getPixel,
   getPixels
 } from "../../../../../../../chunks/chunk-ZRWVPWQC.js";
-import "../../../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../../../chunks/chunk-KH45J4DC.js";
 export {
   extractColorsFromImage,
   getPixel,

package/node/images/transform/operations/_utils/frame/index.js

@@ -1,23 +1,23 @@
 import {
   frame,
   getContainedRatios
-} from "../../../../../../chunks/chunk-RCWLMVSZ.js";
-import "../../../../../../chunks/chunk-7Z7CKAOH.js";
+} from "../../../../../../chunks/chunk-XFMKYZKH.js";
+import "../../../../../../chunks/chunk-OCM3RLO6.js";
+import "../../../../../../chunks/chunk-SY65O2JU.js";
 import "../../../../../../chunks/chunk-ZRWVPWQC.js";
-import "../../../../../../chunks/chunk-LNSDOGTR.js";
+import "../../../../../../chunks/chunk-C4Q4PC53.js";
 import "../../../../../../chunks/chunk-CP454IJD.js";
-import "../../../../../../chunks/chunk-OCM3RLO6.js";
 import "../../../../../../chunks/chunk-ENMBK6H7.js";
 import "../../../../../../chunks/chunk-4CIS3R7T.js";
 import "../../../../../../chunks/chunk-OSAXBA7G.js";
 import "../../../../../../chunks/chunk-D3ERTRDW.js";
-import "../../../../../../chunks/chunk-U57Q62IN.js";
-import "../../../../../../chunks/chunk-MB7HWF22.js";
+import "../../../../../../chunks/chunk-PXRLKO5Y.js";
 import "../../../../../../chunks/chunk-2POD3TAX.js";
-import "../../../../../../chunks/chunk-QLC3A6PC.js";
+import "../../../../../../chunks/chunk-3LAWRHHB.js";
 import "../../../../../../chunks/chunk-YVLJKJV2.js";
+import "../../../../../../chunks/chunk-QLC3A6PC.js";
 import "../../../../../../chunks/chunk-VJJIYJMY.js";
-import "../../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../../chunks/chunk-KH45J4DC.js";
 export {
   frame,
   getContainedRatios

package/node/images/transform/operations/_utils/positions/index.js

@@ -3,7 +3,7 @@ import {
   getRelativePxPositionsInWrapperFor,
   interpretPosition
 } from "../../../../../../chunks/chunk-OCM3RLO6.js";
-import "../../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../../chunks/chunk-KH45J4DC.js";
 export {
   calcPosition,
   getRelativePxPositionsInWrapperFor,

package/node/images/transform/operations/_utils/scale/index.js

@@ -1,7 +1,7 @@
 import {
   scale
 } from "../../../../../../chunks/chunk-JRYI4VBX.js";
-import "../../../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../../../chunks/chunk-KH45J4DC.js";
 export {
   scale
 };

package/node/images/transform/resize/index.js

@@ -1,10 +1,10 @@
 import {
   resizeSchema
-} from "../../../../chunks/chunk-LSOHLSF5.js";
-import "../../../../chunks/chunk-U7R6TPHR.js";
+} from "../../../../chunks/chunk-NQNEYA4Z.js";
+import "../../../../chunks/chunk-45S766KF.js";
 import "../../../../chunks/chunk-MOVLLUDL.js";
-import "../../../../chunks/chunk-YE67BQQN.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-T4KFB6QN.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
 export {
   resizeSchema
 };

package/node/images/transform/rotate/index.js

@@ -1,9 +1,9 @@
 import {
   rotateSchema
-} from "../../../../chunks/chunk-D33KC6NN.js";
+} from "../../../../chunks/chunk-XKMSDS3Z.js";
 import "../../../../chunks/chunk-MOVLLUDL.js";
-import "../../../../chunks/chunk-YE67BQQN.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-T4KFB6QN.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
 export {
   rotateSchema
 };

package/node/images/transform/saturate/index.js

@@ -1,9 +1,9 @@
 import {
   saturateSchema
-} from "../../../../chunks/chunk-ZMMNN3QA.js";
+} from "../../../../chunks/chunk-O4AEYNFT.js";
 import "../../../../chunks/chunk-MOVLLUDL.js";
-import "../../../../chunks/chunk-YE67BQQN.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-T4KFB6QN.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
 export {
   saturateSchema
 };

package/node/images/transform/scale/index.js

@@ -1,10 +1,10 @@
 import {
   scaleSchema
-} from "../../../../chunks/chunk-NAP2XNYN.js";
-import "../../../../chunks/chunk-U7R6TPHR.js";
+} from "../../../../chunks/chunk-EZW6DNPL.js";
+import "../../../../chunks/chunk-45S766KF.js";
 import "../../../../chunks/chunk-MOVLLUDL.js";
-import "../../../../chunks/chunk-YE67BQQN.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-T4KFB6QN.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
 export {
   scaleSchema
 };

package/node/process/index.js

@@ -5,7 +5,7 @@ import {
   onAllExits,
   onExit
 } from "../../chunks/chunk-LEXQ6E6L.js";
-import "../../chunks/chunk-NZLE2WMY.js";
+import "../../chunks/chunk-KH45J4DC.js";
 
 // src/node/process/index.ts
 var forceExitEvents2 = forceExitEvents;

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

@@ -5,7 +5,7 @@ import {
   onAllExits,
   onExit
 } from "../../../chunks/chunk-LEXQ6E6L.js";
-import "../../../chunks/chunk-NZLE2WMY.js";
+import "../../../chunks/chunk-KH45J4DC.js";
 export {
   beforeExit,
   beforeForcedExit,

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

@@ -0,0 +1,28 @@
+import Client, { TransferOptions } from 'ssh2-sftp-client';
+import { Outcome } from '../../../../agnostic/misc/outcome';
+export type CopyDirOptions = TransferOptions & {
+    /**
+     * If `false` and a destination file already exists, copying aborts.
+     * @default false
+     */
+    overwrite?: boolean;
+    /**
+     * When `true`, creates missing directories along the path.
+     * Equivalent to `mkdir -p` using `sftp.mkdir(..., true)`.
+     * @default true
+     */
+    ensureDir?: boolean;
+};
+/**
+ * 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 declare function copyDir(sftp: Client, sourceDir: string, targetDir: string, options?: CopyDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  copyDir
+} from "../../../../chunks/chunk-HGDSHJEX.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
+export {
+  copyDir
+};

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

@@ -0,0 +1,5 @@
+import * as CopyDir from './copy-dir';
+import * as List from './list';
+import * as MoveDir from './move-dir';
+import * as RemoveDir from './remove-dir';
+export { CopyDir, List, MoveDir, RemoveDir };

package/node/sftp/directory/index.js

@@ -0,0 +1,22 @@
+import "../../../chunks/chunk-AVVDAISH.js";
+import {
+  list_exports
+} from "../../../chunks/chunk-7WUVBSIC.js";
+import {
+  remove_dir_exports
+} from "../../../chunks/chunk-FWR7ZA4M.js";
+import {
+  copy_dir_exports
+} from "../../../chunks/chunk-HGDSHJEX.js";
+import {
+  move_dir_exports
+} from "../../../chunks/chunk-GKTDEHC6.js";
+import "../../../chunks/chunk-JMU5PDBD.js";
+import "../../../chunks/chunk-FENXVJYO.js";
+import "../../../chunks/chunk-KH45J4DC.js";
+export {
+  copy_dir_exports as CopyDir,
+  list_exports as List,
+  move_dir_exports as MoveDir,
+  remove_dir_exports as RemoveDir
+};

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

@@ -0,0 +1,12 @@
+import Client from 'ssh2-sftp-client';
+import { Outcome } from '../../../../agnostic/misc/outcome';
+/**
+ * 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 declare function list(sftp: Client, directoryPath: string): Promise<Outcome.Either<string[], string>>;

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

@@ -0,0 +1,9 @@
+import {
+  list
+} from "../../../../chunks/chunk-7WUVBSIC.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
+export {
+  list
+};

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

@@ -0,0 +1,26 @@
+import Client from 'ssh2-sftp-client';
+import { Outcome } from '../../../../agnostic/misc/outcome';
+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 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 declare function moveDir(sftp: Client, sourceDir: string, targetDir: string, options?: MoveDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  moveDir
+} from "../../../../chunks/chunk-GKTDEHC6.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
+export {
+  moveDir
+};

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

@@ -0,0 +1,25 @@
+import Client from 'ssh2-sftp-client';
+import { Outcome } from '../../../../agnostic/misc/outcome';
+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 SFTP server.
+ *
+ * @param {Client}  sftp           - The SFTP 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 the
+ *   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(sftp: Client, directoryPath: string, options?: RemoveDirOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  removeDir
+} from "../../../../chunks/chunk-FWR7ZA4M.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
+export {
+  removeDir
+};

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

@@ -0,0 +1,28 @@
+import Client, { TransferOptions } from 'ssh2-sftp-client';
+import { Outcome } from '../../../../agnostic/misc/outcome';
+export type CopyOptions = TransferOptions & {
+    /**
+     * 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 `mkdir -p` behaviour).
+     * @default true
+     */
+    ensureDir?: boolean;
+};
+/**
+ * Copies a file from one path to another on the same SFTP server using streams
+ * (avoids loading the entire file into memory).
+ *
+ * @param {Client}  sftp       - The ssh2‑sftp‑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(sftp: Client, sourcePath: string, targetPath: string, options?: CopyOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  copy
+} from "../../../../chunks/chunk-SSJ5YQMJ.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
+export {
+  copy
+};

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

@@ -10,11 +10,11 @@ export type DownloadOptions = ReadStreamOptions;
  * returning the file content as a Readable stream. The download process can be customized
  * using optional download options.
  *
- * @param {string} sourcePath - The path of the file to be downloaded from the SFTP server.
  * @param {Client} sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
+ * @param {string} sourcePath - The path of the file to be downloaded from the SFTP server.
  * @param {DownloadOptions} [options] - Optional settings for configuring the download process.
  * @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(sourcePath: string, sftp: Client, options?: DownloadOptions): Promise<Outcome.Either<Readable, string>>;
+export declare function download(sftp: Client, sourcePath: string, options?: DownloadOptions): Promise<Outcome.Either<Readable, string>>;

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

@@ -1,9 +1,9 @@
 import {
   download
-} from "../../../../chunks/chunk-V4S34MIM.js";
+} from "../../../../chunks/chunk-5RA25FYM.js";
 import "../../../../chunks/chunk-JMU5PDBD.js";
 import "../../../../chunks/chunk-FENXVJYO.js";
-import "../../../../chunks/chunk-NZLE2WMY.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
 export {
   download
 };

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

@@ -0,0 +1,21 @@
+import Client from 'ssh2-sftp-client';
+import { Outcome } from '../../../../agnostic/misc/outcome';
+/**
+ * Checks if a *file* (not a directory) exists on a specified SFTP server.
+ *
+ * `sftp.exists(path)` resolves to:
+ *   • `'d'` – the path exists and is a **directory**
+ *   • `'-'` – the path exists and is a **regular file**
+ *   • `'l'` – the path exists and is a **symlink**
+ *   • `false` – the path does **not** exist
+ *
+ * For the purpose of this util we treat a regular file (`'-'`) **or** a
+ * symlink (`'l'`) as a “file”. A directory (`'d'`) returns `false`.
+ *
+ * @param {Client} sftp        - The ssh2‑sftp‑client instance.
+ * @param {string} sourcePath  - The path to check.
+ * @returns {Promise<Outcome.Either<boolean, string>>}
+ * - Success: `Outcome.makeSuccess(true | false)` indicating file existence.
+ * - Failure: `Outcome.makeFailure(errStr)` if an error occurs.
+ */
+export declare function exists(sftp: Client, sourcePath: string): Promise<Outcome.Either<boolean, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  exists
+} from "../../../../chunks/chunk-ZO5FRL3M.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-KH45J4DC.js";
+export {
+  exists
+};