@design-edito/tools 0.3.9 → 0.3.11

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

@@ -17,7 +17,7 @@ async function copy(ftpClient, sourcePath, targetPath, options) {
     }
     if (ensureDir) {
       const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
-      if (dirPath) await ftpClient.ensureDir(dirPath);
+      await ftpClient.ensureDir(dirPath);
     }
     const pass = new PassThrough();
     const uploadPromise = ftpClient.uploadFrom(pass, targetPath);

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

@@ -1,5 +1,5 @@
-import { Readable } from 'node:stream';
-import { Client } from 'basic-ftp';
+import { type Readable } from 'node:stream';
+import { type Client } from 'basic-ftp';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type DownloadOptions = {
     startAt?: number;

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

@@ -1,4 +1,4 @@
-import { Client } from 'basic-ftp';
+import { type 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.
@@ -15,7 +15,7 @@ import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
  * @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.
+ * - 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

@@ -9,7 +9,7 @@ async function exists(ftpClient, sourcePath) {
     const baseName = lastSlash === -1 ? sourcePath : sourcePath.slice(lastSlash + 1);
     const list = await ftpClient.list(parentDir);
     const entry = list.find((e) => e.name === baseName);
-    const isFile = entry ? entry.type === FileType.File || entry.type === FileType.SymbolicLink : false;
+    const isFile = entry !== void 0 ? entry.type === FileType.File || entry.type === FileType.SymbolicLink : false;
     return Outcome.makeSuccess(isFile);
   } catch (err) {
     return Outcome.makeFailure(unknownToString(err));

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

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

package/node/ftps/file/index.js

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

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

@@ -1,4 +1,4 @@
-import { Client } from 'basic-ftp';
+import { type Client } from 'basic-ftp';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type MoveOptions = {
     /**
@@ -20,9 +20,9 @@ export type MoveOptions = {
  * 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`
+ * 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
+ * 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.

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

@@ -9,7 +9,7 @@ async function move(ftpClient, sourcePath, targetPath, options) {
   try {
     if (ensureDir) {
       const dirPath = targetPath.substring(0, targetPath.lastIndexOf("/"));
-      if (dirPath) await ftpClient.ensureDir(dirPath);
+      await ftpClient.ensureDir(dirPath);
     }
     if (!overwrite) {
       try {

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

@@ -1,4 +1,4 @@
-import { Client } from 'basic-ftp';
+import { type Client } from 'basic-ftp';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type RemoveOptions = {
     ignoreMissing?: boolean;

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

@@ -1,4 +1,4 @@
-import { Client as FtpClient, FileInfo } from 'basic-ftp';
+import { type Client as FtpClient, type FileInfo } from 'basic-ftp';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export interface Stat {
     size?: number;

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

@@ -8,11 +8,11 @@ async function stat(ftp, path) {
     const name = slash === -1 ? path : path.slice(slash + 1);
     const list = await ftp.list(dir);
     const entry = list.find((e) => e.name === name && e.isFile);
-    if (!entry) return Outcome.makeFailure(`File not found: ${path}`);
+    if (entry === void 0) return Outcome.makeFailure(`File not found: ${path}`);
     return Outcome.makeSuccess({
       size: entry.size,
       modifiedAt: entry.modifiedAt ?? void 0,
-      permissions: entry.rawModifiedAt ? entry.rawModifiedAt.toString() : void 0,
+      permissions: entry.rawModifiedAt.toString(),
       raw: entry
     });
   } catch (err) {

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

@@ -1,5 +1,5 @@
-import { Readable } from 'node:stream';
-import { Client, UploadOptions as BasicFtpUploadOptions } from 'basic-ftp';
+import { type Readable } from 'node:stream';
+import { type Client, type UploadOptions as BasicFtpUploadOptions } from 'basic-ftp';
 import * as Outcome from '../../../../agnostic/misc/outcome/index.js';
 export type UploadOptions = BasicFtpUploadOptions & {
     ensureDir?: boolean;

package/node/images/format/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 { FormatCommonOptions, FormatJpgOptions, FormatPngOptions, FormatWebpOptions, FormatAvifOptions, FormatTiffOptions, FormatHeifOptions, FormatOptions, ImageLike } from '../types.js';
 /** Type guard to check if options match FormatCommonOptions. */

package/node/images/format/index.js

@@ -115,7 +115,7 @@ var toSharpResizeOptions = (options) => {
     height: options.height,
     fit: options.fit,
     position: options.position,
-    background: options.background ? toSharpColor(options.background) : void 0,
+    background: options.background !== void 0 ? toSharpColor(options.background) : void 0,
     kernel: options.kernel,
     withoutEnlargement: options.withoutEnlargement,
     withoutReduction: options.withoutReduction,
@@ -216,14 +216,14 @@ async function format(input, options) {
   if (isFormatHeifOptions(options)) return Outcome.makeSuccess(await resizedInstance.heif(toSharpHeifOptions(options)).toBuffer());
   return Outcome.makeSuccess(await resizedInstance.toBuffer());
 }
-var toWidth = async (input, width) => (await toSharpInstance(input)).resize({ width }).toBuffer();
-var toHeight = async (input, height) => (await toSharpInstance(input)).resize({ height }).toBuffer();
-var toJpg = async (input, quality) => (await toSharpInstance(input)).jpeg({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
-var toPng = async (input, quality, compressionLevel) => (await toSharpInstance(input)).png({ quality: clamp(quality ?? 100, 1, 100), compressionLevel }).toBuffer();
-var toWebp = async (input, quality) => (await toSharpInstance(input)).webp({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
-var toAvif = async (input, quality) => (await toSharpInstance(input)).avif({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
-var toTiff = async (input, quality, compression) => (await toSharpInstance(input)).tiff({ quality: clamp(quality ?? 100, 1, 100), compression }).toBuffer();
-var toHeif = async (input, quality) => (await toSharpInstance(input)).heif({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
+var toWidth = async (input, width) => await (await toSharpInstance(input)).resize({ width }).toBuffer();
+var toHeight = async (input, height) => await (await toSharpInstance(input)).resize({ height }).toBuffer();
+var toJpg = async (input, quality) => await (await toSharpInstance(input)).jpeg({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
+var toPng = async (input, quality, compressionLevel) => await (await toSharpInstance(input)).png({ quality: clamp(quality ?? 100, 1, 100), compressionLevel }).toBuffer();
+var toWebp = async (input, quality) => await (await toSharpInstance(input)).webp({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
+var toAvif = async (input, quality) => await (await toSharpInstance(input)).avif({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
+var toTiff = async (input, quality, compression) => await (await toSharpInstance(input)).tiff({ quality: clamp(quality ?? 100, 1, 100), compression }).toBuffer();
+var toHeif = async (input, quality) => await (await toSharpInstance(input)).heif({ quality: clamp(quality ?? 100, 1, 100) }).toBuffer();
 export {
   format,
   isFormatAvifOptions,

package/node/images/index.d.ts

@@ -1,5 +1,5 @@
 export * as create from './create/index.js'
 export * as format from './format/index.js'
+export * as utils from './utils/index.js'
 export * as transform from './transform/index.js'
 export * as metadata from './metadata/index.js'
-export * as utils from './utils/index.js'

package/node/images/index.js

@@ -1,5 +1,5 @@
 export * as create from './create/index.js'
 export * as format from './format/index.js'
+export * as utils from './utils/index.js'
 export * as transform from './transform/index.js'
 export * as metadata from './metadata/index.js'
-export * as utils from './utils/index.js'

package/node/images/metadata/index.d.ts

@@ -1,4 +1,4 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import type { ImageLike } from '../types.js';
 /**
  * Retrieves metadata from an image.

package/node/images/metadata/index.js

@@ -2,7 +2,7 @@
 import { toSharpInstance } from "../utils/index.js";
 async function metadata(imageInput) {
   const sharpInstance = await toSharpInstance(imageInput);
-  return sharpInstance.metadata();
+  return await sharpInstance.metadata();
 }
 export {
   metadata

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

@@ -1,6 +1,6 @@
-import sharp from 'sharp';
+import type sharp from 'sharp';
 import * as Outcome from '../../../agnostic/misc/outcome/index.js';
-import { OperationDescriptor, TransformLimits, TransformErr, ImageLike } from '../types.js';
+import { type OperationDescriptor, type TransformLimits, type TransformErr, type ImageLike } from '../types.js';
 /**
  * Validates and checks if an object is a valid operation descriptor.
  *

package/node/images/transform/index.js

@@ -43,13 +43,18 @@ function isOperationDescriptor(obj) {
   const name = obj.name;
   const validateOperation = (validatorFn) => {
     const result = validatorFn(obj);
-    if (result.success) return Outcome.makeSuccess({ name: obj.name, ...result.payload });
+    if (result.success) return Outcome.makeSuccess({
+      name: obj.name,
+      ...result.payload
+    });
     return Outcome.makeFailure(result.error);
   };
   const simpleOperations = /* @__PURE__ */ new Set([OpName.FLIP, OpName.FLOP]);
-  if (simpleOperations.has(name)) return Outcome.makeSuccess({ name });
+  if (simpleOperations.has(name)) return Outcome.makeSuccess({
+    name
+  });
   const validator = validators[name];
-  if (validator) return validateOperation(validator);
+  if (validator !== void 0) return validateOperation(validator);
   return Outcome.makeFailure("Invalid operation descriptor");
 }
 async function transform(input, operationsSequence, limits) {
@@ -57,7 +62,7 @@ async function transform(input, operationsSequence, limits) {
   const start = Date.now();
   const deadline = limits?.timeoutMs !== void 0 ? start + limits.timeoutMs : void 0;
   const runWithOpTimeout = async (op) => {
-    return limits?.opTimeoutMs === void 0 ? op() : Promise.race([op(), new Promise(
+    return limits?.opTimeoutMs === void 0 ? await op() : await Promise.race([op(), new Promise(
       (resolve) => setTimeout(
         () => resolve(TransformErrCodes.OP_TIMEOUT),
         limits.opTimeoutMs
@@ -74,35 +79,35 @@ async function transform(input, operationsSequence, limits) {
       result = await runWithOpTimeout(async () => {
         switch (operation.name) {
           case OpName.BLUR:
-            return blur(sharpInstance, operation);
+            return await blur(sharpInstance, operation);
           case OpName.BRIGHTEN:
-            return brighten(sharpInstance, operation);
+            return await brighten(sharpInstance, operation);
           case OpName.EXTEND:
-            return extend(sharpInstance, operation);
+            return await extend(sharpInstance, operation);
           case OpName.EXTRACT:
-            return extract(sharpInstance, operation);
+            return await extract(sharpInstance, operation);
           case OpName.FLATTEN:
-            return flatten(sharpInstance, operation);
+            return await flatten(sharpInstance, operation);
           case OpName.FLIP:
-            return flip(sharpInstance);
+            return await flip(sharpInstance);
           case OpName.FLOP:
-            return flop(sharpInstance);
+            return await flop(sharpInstance);
           case OpName.HUE:
-            return hue(sharpInstance, operation);
+            return await hue(sharpInstance, operation);
           case OpName.LEVEL:
-            return level(sharpInstance, operation);
+            return await level(sharpInstance, operation);
           case OpName.LIGHTEN:
-            return lighten(sharpInstance, operation);
+            return await lighten(sharpInstance, operation);
           case OpName.NORMALIZE:
-            return normalize(sharpInstance, operation);
+            return await normalize(sharpInstance, operation);
           case OpName.OVERLAY:
-            return overlay(sharpInstance, operation);
+            return await overlay(sharpInstance, operation);
           case OpName.RESIZE:
-            return resize(sharpInstance, operation);
+            return await resize(sharpInstance, operation);
           case OpName.ROTATE:
-            return rotate(sharpInstance, operation);
+            return await rotate(sharpInstance, operation);
           case OpName.SATURATE:
-            return saturate(sharpInstance, operation);
+            return await saturate(sharpInstance, operation);
           default:
             return sharpInstance;
         }
@@ -124,11 +129,11 @@ async function transform(input, operationsSequence, limits) {
     if (operation.name === OpName.RESIZE || operation.name === OpName.EXTEND || operation.name === OpName.EXTRACT || operation.name === OpName.ROTATE) {
       try {
         const meta = await sharpInstance.metadata();
-        if (limits.width !== void 0 && meta.width && meta.width > limits.width) return Outcome.makeFailure({
+        if (limits.width !== void 0 && meta.width > limits.width) return Outcome.makeFailure({
           code: TransformErrCodes.WIDTH_LIMIT_EXCEEDED,
           details: `Image width exceeded the limit (${meta.width}px)`
         });
-        if (limits.height !== void 0 && meta.height && meta.height > limits.height) return Outcome.makeFailure({
+        if (limits.height !== void 0 && meta.height > limits.height) return Outcome.makeFailure({
           code: TransformErrCodes.HEIGHT_LIMIT_EXCEEDED,
           details: `Image height exceeded the limit (${meta.height}px)`
         });

package/node/images/transform/operations/blur/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 { BlurOperationParams } from '../../../types.js';
 export declare function isBlurOperationParams(obj: unknown): Outcome.Either<BlurOperationParams, string>;

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 flatten from './flatten/index.js'
+export * as blur from './blur/index.js'
 export * as flip from './flip/index.js'
-export * as flop from './flop/index.js'
+export * as flatten from './flatten/index.js'
 export * as hue from './hue/index.js'
+export * as flop from './flop/index.js'
 export * as level from './level/index.js'
+export * as lighten from './lighten/index.js'
 export * as normalize from './normalize/index.js'
-export * as resize from './resize/index.js'
 export * as overlay from './overlay/index.js'
-export * as lighten from './lighten/index.js'
+export * as resize from './resize/index.js'
 export * as rotate from './rotate/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 flatten from './flatten/index.js'
+export * as blur from './blur/index.js'
 export * as flip from './flip/index.js'
-export * as flop from './flop/index.js'
+export * as flatten from './flatten/index.js'
 export * as hue from './hue/index.js'
+export * as flop from './flop/index.js'
 export * as level from './level/index.js'
+export * as lighten from './lighten/index.js'
 export * as normalize from './normalize/index.js'
-export * as resize from './resize/index.js'
 export * as overlay from './overlay/index.js'
-export * as lighten from './lighten/index.js'
+export * as resize from './resize/index.js'
 export * as rotate from './rotate/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 express from './@express/index.js'
 export * as awsS3 from './@aws-s3/index.js'
 export * as designEdito from './@design-edito/index.js'
-export * as express from './@express/index.js'
 export * as googleCloud from './@google-cloud/index.js'
 export * as cloudStorage from './cloud-storage/index.js'
 export * as encryption from './encryption/index.js'
-export * as files from './files/index.js'
 export * as ftps from './ftps/index.js'
 export * as images from './images/index.js'
+export * as files from './files/index.js'
 export * as sftp from './sftp/index.js'
 export * as process from './process/index.js'

package/node/index.js

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

@@ -5,14 +5,65 @@ type Output = {
     stderr: string;
     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;
-}>;
+type ThisOptions = {
+    argsPrintFormat?: (args: string[]) => string[];
+    throwOnError?: boolean;
+};
+/**
+ * Options for the asynchronous `spawner` function.
+ *
+ * Extends Node.js `SpawnOptions` with additional behaviors specific to this utility.
+ *
+ * - `argsPrintFormat`: Optional function used to transform the command arguments
+ *   before they are printed to the console (does not affect execution).
+ * - `throwOnError`: If `true`, the function throws when the spawned process exits
+ *   with a non-zero status instead of returning a failure outcome.
+ */
+export type Options = SpawnOptions & ThisOptions;
+/**
+ * Options for the synchronous `spawnerSync` function.
+ *
+ * Extends Node.js `SpawnSyncOptions` with additional behaviors specific to this utility.
+ *
+ * - `argsPrintFormat`: Optional function used to transform the command arguments
+ *   before they are printed to the console (does not affect execution).
+ * - `throwOnError`: If `true`, the function throws when the spawned process exits
+ *   with a non-zero status instead of returning a failure outcome.
+ */
+export type SyncOptions = SpawnSyncOptions & ThisOptions;
+/**
+ * Spawns a child process asynchronously and logs its execution and output.
+ *
+ * Stdout and stderr are streamed, logged in real time, and collected.
+ * The result is returned as an `Outcome.Either`, representing success or failure.
+ *
+ * @param label - Optional label printed before execution to visually group logs.
+ * @param command - The command to execute.
+ * @param args - Arguments passed to the command.
+ * @param options - Optional spawn configuration and utility-specific options:
+ *   - `argsPrintFormat`: Function to format arguments for logging.
+ *   - `throwOnError`: If `true`, rejects on non-zero exit code instead of resolving a failure.
+ * @returns A promise resolving to an `Outcome.Either`:
+ *   - success: `{ stdout, stderr, err }` when the command exits with code `0`
+ *   - failure: `{ stdout, stderr, err }` when the command exits with a non-zero code
+ */
+export declare function spawner(label: string | null, command: string, args: string[], options?: Options): Promise<Outcome.Either<Output, Output>>;
+/**
+ * Spawns a child process synchronously and logs its execution and output.
+ *
+ * Stdout, stderr, and execution errors are logged after the process completes.
+ * The result is returned as an `Outcome.Either`, representing success or failure.
+ *
+ * @param label - Optional label printed before execution to visually group logs.
+ * @param command - The command to execute.
+ * @param args - Arguments passed to the command.
+ * @param options - Optional spawn configuration and utility-specific options:
+ *   - `argsPrintFormat`: Function to format arguments for logging.
+ *   - `throwOnError`: If `true`, throws on non-zero exit code instead of returning a failure.
+ * @returns An `Outcome.Either`:
+ *   - success: `{ stdout, stderr, err }` when the command exits with code `0`
+ *   - failure: `{ stdout, stderr, err }` when the command exits with a non-zero code
+ * @throws Error if `throwOnError` is `true` and the process exits with a non-zero status
+ */
+export declare function spawnerSync(label: string | null, command: string, args: string[], options?: SyncOptions): Outcome.Either<Output, Output>;
 export {};