@design-edito/tools 0.4.22 → 0.5.0

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

@@ -1,13 +1,14 @@
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 import { unknownToString } from '../../../../agnostic/errors/unknown-to-string/index.js';
+import { deepGetProperty } from '../../../../agnostic/objects/deep-get-property/index.js';
 /**
  * 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>>}
+ * @param  sftp           - The SFTP client instance.
+ * @param  directoryPath  - The path of the directory to delete.
+ * @param [options] - Optional configuration.
+ * @param [options.ignoreMissing=true] - Whether to ignore a missing directory.
+ * @returns
  * - 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
@@ -33,10 +34,10 @@ export async function removeDir(sftp, directoryPath, options) {
         return Outcome.makeSuccess(true);
     }
     catch (err) {
+        const code = deepGetProperty(err, 'code');
         // ssh2-sftp-client uses code 2 / ENOENT for “No such file or directory”
-        if (ignoreMissing && (err.code === 2 || err.code === 'ENOENT')) {
+        if (ignoreMissing && (code === 2 || code === 'ENOENT'))
             return Outcome.makeSuccess(true);
-        }
         return Outcome.makeFailure(unknownToString(err));
     }
 }

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

@@ -1,4 +1,4 @@
-import { type TransferOptions } from 'ssh2-sftp-client';
+import type { TransferOptions } from 'ssh2-sftp-client';
 import type Client from 'ssh2-sftp-client';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type CopyOptions = TransferOptions & {
@@ -18,11 +18,11 @@ export type CopyOptions = TransferOptions & {
  * 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>>}
+ * @param  sftp       - The ssh2‑sftp‑client instance.
+ * @param  sourcePath - The path of the source file.
+ * @param  targetPath - The destination path.
+ * @param [options] - Optional copy configuration.
+ * @returns
  * - On success:  `Outcome.makeSuccess(true)`.
  * - On failure:  `Outcome.makeFailure(errStr)`.
  */

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

@@ -5,11 +5,11 @@ import { unknownToString } from '../../../../agnostic/errors/unknown-to-string/i
  * 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>>}
+ * @param  sftp       - The ssh2‑sftp‑client instance.
+ * @param  sourcePath - The path of the source file.
+ * @param  targetPath - The destination path.
+ * @param [options] - Optional copy configuration.
+ * @returns
  * - On success:  `Outcome.makeSuccess(true)`.
  * - On failure:  `Outcome.makeFailure(errStr)`.
  */

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

@@ -1,5 +1,5 @@
-import { type Readable } from 'node:stream';
-import { type ReadStreamOptions } from 'ssh2';
+import type { Readable } from 'node:stream';
+import type { ReadStreamOptions } from 'ssh2';
 import type Client from 'ssh2-sftp-client';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type DownloadOptions = ReadStreamOptions;
@@ -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 {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.
+ * @param sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
+ * @param sourcePath - The path of the file to be downloaded from the SFTP server.
+ * @param [options] - Optional settings for configuring the download process.
+ * @returns 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(sftp: Client, sourcePath: string, options?: DownloadOptions): Promise<Outcome.Either<Readable, string>>;
+export declare function download(sftp: Client, sourcePath: string, options?: DownloadOptions): Outcome.Either<Readable, string>;

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

@@ -7,14 +7,14 @@ import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
  * returning the file content as a Readable stream. The download process can be customized
  * using optional download options.
  *
- * @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.
+ * @param sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
+ * @param sourcePath - The path of the file to be downloaded from the SFTP server.
+ * @param [options] - Optional settings for configuring the download process.
+ * @returns 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 async function download(sftp, sourcePath, options) {
+export function download(sftp, sourcePath, options) {
     try {
         const stream = sftp.createReadStream(sourcePath, options);
         stream.on('error', (err) => { throw err; });

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

@@ -12,9 +12,9 @@ import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
  * 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>>}
+ * @param sftp        - The ssh2‑sftp‑client instance.
+ * @param sourcePath  - The path to check.
+ * @returns
  * - Success: `Outcome.makeSuccess(true | false)` indicating file existence.
  * - Failure: `Outcome.makeFailure(errStr)` if an error occurs.
  */

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

@@ -12,9 +12,9 @@ import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
  * 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>>}
+ * @param sftp        - The ssh2‑sftp‑client instance.
+ * @param sourcePath  - The path to check.
+ * @returns
  * - Success: `Outcome.makeSuccess(true | false)` indicating file existence.
  * - Failure: `Outcome.makeFailure(errStr)` if an error occurs.
  */

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

@@ -25,13 +25,13 @@ export type MoveOptions = {
  * 2. **overwrite** – If disabled (default) the function first checks whether
  *    something already exists at `targetPath`; if so, it aborts.
  *
- * @param {Client} sftp          - The ssh2‑sftp‑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>>}
+ * @param sftp          - The ssh2‑sftp‑client instance.
+ * @param sourcePath    - The full path of the source file.
+ * @param targetPath    - The full destination path.
+ * @param [options] - Optional move configuration.
+ * @param [options.ensureDir=true]  - Whether to create missing parent directories.
+ * @param [options.overwrite=false] - Whether to overwrite an existing destination.
+ * @returns
  * - On success:  `Outcome.makeSuccess(true)`.
  * - On failure:  `Outcome.makeFailure(errStr)`.
  */

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

@@ -11,13 +11,13 @@ import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
  * 2. **overwrite** – If disabled (default) the function first checks whether
  *    something already exists at `targetPath`; if so, it aborts.
  *
- * @param {Client} sftp          - The ssh2‑sftp‑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>>}
+ * @param sftp          - The ssh2‑sftp‑client instance.
+ * @param sourcePath    - The full path of the source file.
+ * @param targetPath    - The full destination path.
+ * @param [options] - Optional move configuration.
+ * @param [options.ensureDir=true]  - Whether to create missing parent directories.
+ * @param [options.overwrite=false] - Whether to overwrite an existing destination.
+ * @returns
  * - On success:  `Outcome.makeSuccess(true)`.
  * - On failure:  `Outcome.makeFailure(errStr)`.
  */

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

@@ -10,10 +10,10 @@ export type RemoveOptions = {
  * 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 {SftpClient} sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
- * @param {string} targetPath - The path of the file to delete on the SFTP 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.
+ * @param sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
+ * @param targetPath - The path of the file to delete on the SFTP server.
+ * @param [options] - Optional settings for configuring the deletion process.
+ * @returns 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.
  */

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

@@ -7,10 +7,10 @@ import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
  * 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 {SftpClient} sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
- * @param {string} targetPath - The path of the file to delete on the SFTP 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.
+ * @param sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
+ * @param targetPath - The path of the file to delete on the SFTP server.
+ * @param [options] - Optional settings for configuring the deletion process.
+ * @returns 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.
  */

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

@@ -11,8 +11,8 @@ export interface Stat {
 /**
  * Retrieves metadata for a file on an SFTP server.
  *
- * @param {SftpClient} sftp – ssh2-sftp-client.
- * @param {string} path     – Remote file path.
- * @returns {Promise<Outcome.Either<Stat, string>>}
+ * @param sftp – ssh2-sftp-client.
+ * @param path     – Remote file path.
+ * @returns
  */
 export declare function stat(sftp: SftpClient, path: string): Promise<Outcome.Either<Stat, string>>;

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

@@ -1,11 +1,12 @@
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 import { unknownToString } from '../../../../agnostic/errors/unknown-to-string/index.js';
+import { deepGetProperty } from '../../../../agnostic/objects/deep-get-property/index.js';
 /**
  * Retrieves metadata for a file on an SFTP server.
  *
- * @param {SftpClient} sftp – ssh2-sftp-client.
- * @param {string} path     – Remote file path.
- * @returns {Promise<Outcome.Either<Stat, string>>}
+ * @param sftp – ssh2-sftp-client.
+ * @param path     – Remote file path.
+ * @returns
  */
 export async function stat(sftp, path) {
     try {
@@ -20,9 +21,9 @@ export async function stat(sftp, path) {
         });
     }
     catch (err) {
-        if (err.code === 2 || err.code === 'ENOENT') {
+        const code = deepGetProperty(err, 'code');
+        if (code === 2 || code === 'ENOENT')
             return Outcome.makeFailure(`File not found: ${path}`);
-        }
         return Outcome.makeFailure(unknownToString(err));
     }
 }

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

@@ -1,6 +1,6 @@
 import type { Readable } from 'node:stream';
 import type Client from 'ssh2-sftp-client';
-import { type TransferOptions } from 'ssh2-sftp-client';
+import type { TransferOptions } from 'ssh2-sftp-client';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type UploadOptions = TransferOptions & {
     ensureDir?: boolean;
@@ -14,11 +14,11 @@ export type UploadOptions = TransferOptions & {
  * If the `ensureDir` option is true, it ensures that the target directory exists before uploading.
  * If the `overwrite` option is false and a file already exists at the target path, the upload is aborted.
  *
- * @param {Client} sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
- * @param {string} targetPath - The target path where the file will be stored on the SFTP server.
- * @param {Readable} fileStream - The file content to be uploaded.
- * @param {UploadOptions} [options] - Optional settings for configuring the upload process.
- * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an Outcome.Either.
+ * @param sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
+ * @param targetPath - The target path where the file will be stored on the SFTP server.
+ * @param fileStream - The file content to be uploaded.
+ * @param [options] - Optional settings for configuring the upload process.
+ * @returns A promise that resolves to an Outcome.Either.
  * - On success: Outcome.makeSuccess(true) indicating the upload was successful.
  * - On failure: Outcome.makeFailure(errStr) with an error message if the upload fails.
  */

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

@@ -8,11 +8,11 @@ import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
  * If the `ensureDir` option is true, it ensures that the target directory exists before uploading.
  * If the `overwrite` option is false and a file already exists at the target path, the upload is aborted.
  *
- * @param {Client} sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
- * @param {string} targetPath - The target path where the file will be stored on the SFTP server.
- * @param {Readable} fileStream - The file content to be uploaded.
- * @param {UploadOptions} [options] - Optional settings for configuring the upload process.
- * @returns {Promise<Outcome.Either<true, string>>} A promise that resolves to an Outcome.Either.
+ * @param sftp - The ssh2-sftp-client instance used to interact with the SFTP server.
+ * @param targetPath - The target path where the file will be stored on the SFTP server.
+ * @param fileStream - The file content to be uploaded.
+ * @param [options] - Optional settings for configuring the upload process.
+ * @returns A promise that resolves to an Outcome.Either.
  * - On success: Outcome.makeSuccess(true) indicating the upload was successful.
  * - On failure: Outcome.makeFailure(errStr) with an error message if the upload fails.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design-edito/tools",
-  "version": "0.4.22",
+  "version": "0.5.0",
   "description": "",
   "author": "Maxime Fabas",
   "license": "ISC",
@@ -1293,6 +1293,17 @@
     "./agnostic/time/dates/index.js": {
       "import": "./agnostic/time/dates/index.js"
     },
+    "./agnostic/time/dates/to-french-republican": {
+      "import": "./agnostic/time/dates/to-french-republican/index.js",
+      "types": "./agnostic/time/dates/to-french-republican/index.d.ts"
+    },
+    "./agnostic/time/dates/to-french-republican/index.js": {
+      "import": "./agnostic/time/dates/to-french-republican/index.js"
+    },
+    "./agnostic/time/dates/to-french-republican/types.js": {
+      "import": "./agnostic/time/dates/to-french-republican/types.js",
+      "types": "./agnostic/time/dates/to-french-republican/types.d.ts"
+    },
     "./agnostic/time/duration": {
       "import": "./agnostic/time/duration/index.js",
       "types": "./agnostic/time/duration/index.d.ts"
@@ -2381,65 +2392,55 @@
     }
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.1066.0",
-    "@aws-sdk/lib-storage": "^3.1066.0",
-    "@google-cloud/storage": "^7.19.0",
-    "@inquirer/prompts": "^8.5.2",
-    "ansi-regex": "^6.2.2",
-    "archiver": "^7.0.1",
-    "basic-ftp": "^5.1.0",
-    "chalk": "^5.6.2",
+    "@aws-sdk/client-s3": "^3.1117.0",
+    "@aws-sdk/lib-storage": "^3.1117.0",
+    "@google-cloud/storage": "^8.0.1",
+    "@inquirer/prompts": "^8.6.0",
+    "ansi-regex": "^6.3.0",
+    "basic-ftp": "^6.2.0",
+    "chalk": "^6.0.0",
     "express": "^5.2.1",
-    "i": "^0.3.7",
     "multer": "^2.0.0",
-    "npm": "^11.16.0",
     "preact-render-to-string": "^6.7.0",
     "quantize": "^1.0.2",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
-    "sharp": "^0.34.5",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "sharp": "^0.35.3",
     "ssh2": "^1.17.0",
     "ssh2-sftp-client": "^12.1.1",
     "xss": "^1.0.15",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@preact/preset-vite": "^2.10.3",
-    "@testing-library/jest-dom": "^6.9.1",
+    "@preact/preset-vite": "^2.10.6",
+    "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/preact": "^3.2.4",
     "@testing-library/react": "^16.3.2",
-    "@types/archiver": "^7.0.0",
     "@types/express": "^5.0.6",
-    "@types/jsdom": "^28.0.3",
-    "@types/multer": "^2.1.0",
-    "@types/node": "^25.9.3",
+    "@types/jsdom": "^30.0.0",
+    "@types/multer": "^2.2.0",
+    "@types/node": "^26.3.0",
     "@types/prompts": "^2.4.9",
     "@types/quantize": "^1.0.2",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "@types/semver": "^7.7.1",
-    "@types/sharp": "^0.31.1",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
+    "@types/semver": "^7.8.0",
     "@types/ssh2-sftp-client": "^9.0.6",
-    "@typescript-eslint/eslint-plugin": "^6.21.0",
-    "@typescript-eslint/parser": "^6.21.0",
-    "@vitejs/plugin-react": "^5.1.3",
+    "@vitejs/plugin-react": "^5.2.0",
     "change-case": "^5.4.4",
     "chokidar-cli": "^3.0.0",
     "concurrently": "^10.0.3",
-    "esbuild": "^0.28.0",
-    "eslint": "^8.44.0",
-    "eslint-config-standard-with-typescript": "^43.0.1",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-n": "^16.2.0",
-    "eslint-plugin-promise": "^6.1.1",
+    "esbuild": "^0.28.2",
+    "eslint": "^9.39.5",
+    "eslint-config-love": "^154.1.0",
+    "globals": "^17.11.0",
     "jsdom": "^29.1.1",
     "prompts": "^2.4.2",
-    "puppeteer": "^25.1.0",
-    "semver": "^7.8.4",
+    "puppeteer": "^25.9.0",
+    "semver": "^7.8.5",
     "simple-git": "^3.33.0",
-    "standard": "^17.1.2",
-    "typescript": "^5.3.3",
-    "vite": "^6.4.1",
-    "vitest": "^4.1.8"
+    "typescript": "^5.9.3",
+    "vite": "^8.2.2",
+    "vitest": "^4.1.11"
   }
 }