@design-edito/tools 0.3.8 → 0.3.10

package/node/images/transform/operations/brighten/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { BrightenOperationParams } from '../../../types.js';
 export declare function isBrightenOperationParams(obj: unknown): Outcome.Either<BrightenOperationParams, string>;

package/node/images/transform/operations/extend/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { ExtendOperationParams } from '../../../types.js';
 export declare function isExtendOperationParams(obj: unknown): Outcome.Either<ExtendOperationParams, string>;

package/node/images/transform/operations/extract/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { ExtractOperationParams } from '../../../types.js';
 export declare function isExtractOperationParams(obj: unknown): Outcome.Either<ExtractOperationParams, string>;

package/node/images/transform/operations/flatten/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { FlattenOperationParams } from '../../../types.js';
 export declare function isFlattenOperationParams(obj: unknown): Outcome.Either<FlattenOperationParams, string>;

package/node/images/transform/operations/flatten/index.js

@@ -14,7 +14,7 @@ function isFlattenOperationParams(obj) {
 async function flatten(sharpInstance, params) {
   const inputBg = params.background;
   const rgbBackground = inputBg !== void 0 ? toSharpColor(inputBg) : void 0;
-  const background = rgbBackground !== void 0 ? rgbBackground : void 0;
+  const background = rgbBackground ?? rgbBackground;
   return sharpInstance.flatten({ background });
 }
 export {

package/node/images/transform/operations/flip/index.d.ts

@@ -1,2 +1,2 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 export declare function flip(sharpInstance: sharp.Sharp): Promise<sharp.Sharp>;

package/node/images/transform/operations/flop/index.d.ts

@@ -1,2 +1,2 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 export declare function flop(sharpInstance: sharp.Sharp): Promise<sharp.Sharp>;

package/node/images/transform/operations/hue/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { HueOperationParams } from '../../../types.js';
 export declare function isHueOperationParams(obj: unknown): Outcome.Either<HueOperationParams, string>;

package/node/images/transform/operations/index.d.ts

@@ -1,15 +1,15 @@
 export * as blur from './blur/index.js'
 export * as brighten from './brighten/index.js'
-export * as extend from './extend/index.js'
 export * as extract from './extract/index.js'
+export * as extend from './extend/index.js'
 export * as flatten from './flatten/index.js'
-export * as flip from './flip/index.js'
+export * as flop from './flop/index.js'
 export * as hue from './hue/index.js'
 export * as level from './level/index.js'
 export * as lighten from './lighten/index.js'
-export * as flop from './flop/index.js'
+export * as flip from './flip/index.js'
 export * as overlay from './overlay/index.js'
-export * as resize from './resize/index.js'
 export * as rotate from './rotate/index.js'
-export * as saturate from './saturate/index.js'
+export * as resize from './resize/index.js'
 export * as normalize from './normalize/index.js'
+export * as saturate from './saturate/index.js'

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

@@ -1,15 +1,15 @@
 export * as blur from './blur/index.js'
 export * as brighten from './brighten/index.js'
-export * as extend from './extend/index.js'
 export * as extract from './extract/index.js'
+export * as extend from './extend/index.js'
 export * as flatten from './flatten/index.js'
-export * as flip from './flip/index.js'
+export * as flop from './flop/index.js'
 export * as hue from './hue/index.js'
 export * as level from './level/index.js'
 export * as lighten from './lighten/index.js'
-export * as flop from './flop/index.js'
+export * as flip from './flip/index.js'
 export * as overlay from './overlay/index.js'
-export * as resize from './resize/index.js'
 export * as rotate from './rotate/index.js'
-export * as saturate from './saturate/index.js'
+export * as resize from './resize/index.js'
 export * as normalize from './normalize/index.js'
+export * as saturate from './saturate/index.js'

package/node/images/transform/operations/level/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { LevelOperationParams } from '../../../types.js';
 export declare function isLevelOperationParams(obj: unknown): Outcome.Either<LevelOperationParams, string>;

package/node/images/transform/operations/lighten/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { LightenOperationParams } from '../../../types.js';
 export declare function isLightenOperationParams(obj: unknown): Outcome.Either<LightenOperationParams, string>;

package/node/images/transform/operations/normalize/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { NormalizeOperationParams } from '../../../types.js';
 export declare function isNormalizeOperationParams(obj: unknown): Outcome.Either<NormalizeOperationParams, string>;

package/node/images/transform/operations/overlay/index.js

@@ -8,7 +8,7 @@ function isOverlayOperationParams(obj) {
   const schema = z.object({
     input: z.union([
       z.custom(isDuckTypedSharpInstance),
-      z.custom(Buffer.isBuffer),
+      z.custom((data) => Buffer.isBuffer(data)),
       z.string(),
       z.object({
         width: z.number().optional(),

package/node/images/transform/operations/resize/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { ResizeOperationParams } from '../../../types.js';
 export declare function isResizeOperationParams(obj: unknown): Outcome.Either<ResizeOperationParams, string>;

package/node/images/transform/operations/rotate/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { RotateOperationParams } from '../../../types.js';
 export declare function isRotateOperationParams(obj: unknown): Outcome.Either<RotateOperationParams, string>;

package/node/images/transform/operations/saturate/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../../../agnostic/misc/outcome/index.js';
 import type { SaturateOperationParams } from '../../../types.js';
 export declare function isSaturateOperationParams(obj: unknown): Outcome.Either<SaturateOperationParams, string>;

package/node/index.d.ts

@@ -1,11 +1,11 @@
 export * as awsS3 from './@aws-s3/index.js'
-export * as express from './@express/index.js'
+export * as designEdito from './@design-edito/index.js'
 export * as googleCloud from './@google-cloud/index.js'
-export * as cloudStorage from './cloud-storage/index.js'
+export * as express from './@express/index.js'
 export * as encryption from './encryption/index.js'
+export * as cloudStorage from './cloud-storage/index.js'
 export * as files from './files/index.js'
-export * as process from './process/index.js'
-export * as images from './images/index.js'
 export * as ftps from './ftps/index.js'
+export * as images from './images/index.js'
+export * as process from './process/index.js'
 export * as sftp from './sftp/index.js'
-export * as designEdito from './@design-edito/index.js'

package/node/index.js

@@ -1,11 +1,11 @@
 export * as awsS3 from './@aws-s3/index.js'
-export * as express from './@express/index.js'
+export * as designEdito from './@design-edito/index.js'
 export * as googleCloud from './@google-cloud/index.js'
-export * as cloudStorage from './cloud-storage/index.js'
+export * as express from './@express/index.js'
 export * as encryption from './encryption/index.js'
+export * as cloudStorage from './cloud-storage/index.js'
 export * as files from './files/index.js'
-export * as process from './process/index.js'
-export * as images from './images/index.js'
 export * as ftps from './ftps/index.js'
+export * as images from './images/index.js'
+export * as process from './process/index.js'
 export * as sftp from './sftp/index.js'
-export * as designEdito from './@design-edito/index.js'

package/node/process/prompt-continue/index.js

@@ -6,7 +6,7 @@ async function promptContinue(message, throws = false) {
     message: message ?? "Continue?",
     default: false
   });
-  if (answer === true) return true;
+  if (answer) return true;
   if (throws) throw new Error("Aborted");
   return false;
 }

package/node/process/spawner/index.d.ts

@@ -6,13 +6,5 @@ type Output = {
     err: unknown;
 };
 export declare function spawner(label: string | null, command: string, args: string[], argsPrintFormat?: (args: string[]) => string[], throwOnError?: boolean, options?: SpawnOptions): Promise<Outcome.Either<Output, Output>>;
-export declare function spawnerSync(label: string | null, command: string, args: string[], argsPrintFormat?: (args: string[]) => string[], throwOnError?: boolean, options?: SpawnSyncOptions): Outcome.Failure<{
-    stdout: string;
-    stderr: string;
-    err: Error | undefined;
-}> | Outcome.Success<{
-    stdout: string;
-    stderr: string;
-    err: Error | undefined;
-}>;
+export declare function spawnerSync(label: string | null, command: string, args: string[], argsPrintFormat?: (args: string[]) => string[], throwOnError?: boolean, options?: SpawnSyncOptions): Outcome.Either<Output, Output>;
 export {};

package/node/process/spawner/index.js

@@ -9,7 +9,7 @@ import * as Outcome from "../../../agnostic/misc/outcome/index.js";
 import { styles } from "../../../agnostic/misc/logs/styles/index.js";
 import { unknownToString } from "../../../agnostic/errors/unknown-to-string/index.js";
 async function spawner(label, command, args, argsPrintFormat, throwOnError, options) {
-  return new Promise((resolve, reject) => {
+  return await new Promise((resolve, reject) => {
     if (label !== null) console.log("\n" + styles.info(label) + "\n");
     const printableArgs = argsPrintFormat !== void 0 ? argsPrintFormat(args) : args;
     console.log(styles.light(`> ${command} ${printableArgs.join(" ")}
@@ -19,19 +19,21 @@ async function spawner(label, command, args, argsPrintFormat, throwOnError, opti
     let stderr = "";
     let err = null;
     prcss.stdout?.on("data", (data) => {
-      stdout += data.toString();
-      console.log(styles.light(data.toString().replace(ansiRegex(), "").trim()));
+      const strData = unknownToString(data);
+      stdout += strData;
+      console.log(styles.light(strData.replace(ansiRegex(), "").trim()));
     });
     prcss.stderr?.on("data", (data) => {
-      stderr += data.toString();
-      console.log(styles.warning(data.toString().replace(ansiRegex(), "").trim()));
+      const strData = unknownToString(data);
+      stderr += strData;
+      console.log(styles.warning(strData.replace(ansiRegex(), "").trim()));
     });
     prcss.on("error", (e) => {
       err = e;
       console.log(styles.error(unknownToString(err).replace(ansiRegex(), "").trim()));
     });
     prcss.on("close", (code) => {
-      if (code !== 0 && throwOnError === true) reject(stderr + "\n" + stdout);
+      if (code !== 0 && throwOnError === true) reject(new Error(stderr + "\n" + stdout));
       else if (code !== 0) return resolve(Outcome.makeFailure({ stdout, stderr, err }));
       else return resolve(Outcome.makeSuccess({ stdout, stderr, err }));
     });
@@ -51,12 +53,12 @@ function spawnerSync(label, command, args, argsPrintFormat, throwOnError, option
     console.log(styles.error(unknownToString(err).replace(ansiRegex(), "")));
     console.log("");
   }
-  if (stderr) {
+  if (stderr !== "") {
     console.log(styles.light(chalk.italic("stderr:\n")));
     console.log(styles.warning(stderr.replace(ansiRegex(), "")));
     console.log("");
   }
-  if (stdout) {
+  if (stdout !== "") {
     console.log(styles.light(chalk.italic("stdout:\n")));
     console.log(styles.light(stdout.replace(ansiRegex(), "")));
     console.log("");

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

@@ -1,4 +1,5 @@
-import Client, { 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 CopyDirOptions = TransferOptions & {
     /**

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

@@ -20,11 +20,11 @@ async function copyDir(sftp, sourceDir, targetDir, options) {
       } else if (entry.type === "-") {
         if (!overwrite) {
           const exists = await sftp.exists(dst);
-          if (exists) throw new Error(`File already exists at ${dst}.`);
+          if (exists !== false) throw new Error(`File already exists at ${dst}.`);
         }
         if (ensureDir) {
           const dirPath = dst.substring(0, dst.lastIndexOf("/"));
-          if (dirPath) await sftp.mkdir(dirPath, true);
+          await sftp.mkdir(dirPath, true);
         }
         const pass = new PassThrough();
         const upload = sftp.put(pass, dst, transferOptions);

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

@@ -1,4 +1,4 @@
-import Client from 'ssh2-sftp-client';
+import type Client from 'ssh2-sftp-client';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 /**
  * Lists all direct children files under a given directory on an SFTP server.

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

@@ -1,4 +1,4 @@
-import Client from 'ssh2-sftp-client';
+import type Client from 'ssh2-sftp-client';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type MoveDirOptions = {
     /** If false and `targetDir` exists, the operation is aborted. Defaults to false. */

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

@@ -6,13 +6,11 @@ async function moveDir(sftp, sourceDir, targetDir, options) {
   try {
     if (ensureDir) {
       const parentDir = targetDir.substring(0, targetDir.lastIndexOf("/"));
-      if (parentDir) {
-        await sftp.mkdir(parentDir, true);
-      }
+      await sftp.mkdir(parentDir, true);
     }
     if (!overwrite) {
       const exists = await sftp.exists(targetDir);
-      if (exists) return Outcome.makeFailure(`Target ${targetDir} already exists.`);
+      if (exists !== false) return Outcome.makeFailure(`Target ${targetDir} already exists.`);
     }
     await sftp.rename(sourceDir, targetDir);
     return Outcome.makeSuccess(true);

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

@@ -1,4 +1,4 @@
-import Client from 'ssh2-sftp-client';
+import type Client from 'ssh2-sftp-client';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type RemoveDirOptions = {
     /**
@@ -17,7 +17,7 @@ export type RemoveDirOptions = {
  * @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
+ * - 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.

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

@@ -1,4 +1,5 @@
-import Client, { 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 & {
     /**

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

@@ -11,11 +11,11 @@ async function copy(sftp, sourcePath, targetPath, options) {
   try {
     if (!overwrite) {
       const exists = await sftp.exists(targetPath);
-      if (exists) return Outcome.makeFailure(`File already exists at ${targetPath}.`);
+      if (exists !== false) return Outcome.makeFailure(`File already exists at ${targetPath}.`);
     }
     if (ensureDir) {
       const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
-      if (dirPath) await sftp.mkdir(dirPath, true);
+      await sftp.mkdir(dirPath, true);
     }
     const pass = new PassThrough();
     const uploadPromise = sftp.put(pass, targetPath, transferOptions);

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

@@ -1,6 +1,6 @@
-import { Readable } from 'node:stream';
-import { ReadStreamOptions } from 'ssh2';
-import Client from 'ssh2-sftp-client';
+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;
 /**

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

@@ -1,4 +1,4 @@
-import Client from 'ssh2-sftp-client';
+import type Client from 'ssh2-sftp-client';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 /**
  * Checks if a *file* (not a directory) exists on a specified SFTP server.

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

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

package/node/sftp/file/index.js

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

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

@@ -1,4 +1,4 @@
-import Client from 'ssh2-sftp-client';
+import type Client from 'ssh2-sftp-client';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type MoveOptions = {
     /**
@@ -20,9 +20,9 @@ export type MoveOptions = {
  * The function uses `rename`, which atomically moves the file from
  * `sourcePath` to `targetPath`.  It supports two safety features:
  *
- * 1. **ensureDir** – If enabled, the parent directory of `targetPath`
+ * 1. **ensureDir** – If enabled, the parent directory of `targetPath`
  *    is created with `mkdir -p` semantics before the rename.
- * 2. **overwrite** – If disabled (default) the function first checks whether
+ * 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.

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

@@ -9,13 +9,11 @@ async function move(sftp, sourcePath, targetPath, options) {
   try {
     if (ensureDir) {
       const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
-      if (dirPath) await sftp.mkdir(dirPath, true);
+      await sftp.mkdir(dirPath, true);
     }
     if (!overwrite) {
-      const exists = await sftp.exists(targetPath);
-      if (exists) {
-        return Outcome.makeFailure(`File already exists at ${targetPath}.`);
-      }
+      const exists = await sftp.exists(targetPath) !== false;
+      if (exists) return Outcome.makeFailure(`File already exists at ${targetPath}.`);
     }
     await sftp.rename(sourcePath, targetPath);
     return Outcome.makeSuccess(true);

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

@@ -1,4 +1,4 @@
-import SftpClient from 'ssh2-sftp-client';
+import type SftpClient from 'ssh2-sftp-client';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type RemoveOptions = {
     ignoreMissing?: boolean;

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

@@ -4,7 +4,7 @@ import * as Outcome from "../../../../agnostic/misc/outcome/index.js";
 async function remove(sftp, targetPath, options) {
   const { ignoreMissing = true } = options ?? {};
   try {
-    const exists = await sftp.exists(targetPath);
+    const exists = await sftp.exists(targetPath) !== false;
     if (!exists) {
       if (ignoreMissing) return Outcome.makeSuccess(true);
       return Outcome.makeFailure(`File not found at ${targetPath}.`);

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

@@ -1,4 +1,4 @@
-import SftpClient from 'ssh2-sftp-client';
+import type SftpClient from 'ssh2-sftp-client';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export interface Stat {
     size?: number;

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

@@ -6,7 +6,7 @@ async function stat(sftp, path) {
     const info = await sftp.stat(path);
     return Outcome.makeSuccess({
       size: info.size,
-      modifiedAt: info.modifyTime ? new Date(info.modifyTime * 1e3) : void 0,
+      modifiedAt: new Date(info.modifyTime * 1e3),
       mode: info.mode,
       uid: info.uid,
       gid: info.gid,

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

@@ -1,5 +1,6 @@
-import { Readable } from 'node:stream';
-import Client, { TransferOptions } from 'ssh2-sftp-client';
+import type { Readable } from 'node:stream';
+import type Client 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;

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

@@ -7,7 +7,7 @@ async function upload(sftp, targetPath, fileStream, options) {
     overwrite = false
   } = options ?? {};
   try {
-    const exists = await sftp.exists(targetPath);
+    const exists = await sftp.exists(targetPath) !== false;
     if (exists && !overwrite) return Outcome.makeFailure(`File already exists at ${targetPath}.`);
     if (ensureDir) {
       const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));