@design-edito/tools 0.1.53 → 0.1.55

package/node/cloud-storage/operations/download/index.js

@@ -0,0 +1,15 @@
+import {
+  download
+} from "../../../../chunks/chunk-HQGZVWBB.js";
+import "../../../../chunks/chunk-7N7BJA6C.js";
+import "../../../../chunks/chunk-6WVNJVBE.js";
+import "../../../../chunks/chunk-UJN2WZGO.js";
+import "../../../../chunks/chunk-OD33BN4K.js";
+import "../../../../chunks/chunk-P3QFJTAE.js";
+import "../../../../chunks/chunk-CMWR77VW.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  download
+};

package/node/cloud-storage/operations/index.d.ts

@@ -0,0 +1,3 @@
+import * as Download from './download';
+import * as Upload from './upload';
+export { Download, Upload };

package/node/cloud-storage/operations/index.js

@@ -0,0 +1,24 @@
+import "../../../chunks/chunk-UT75PSLP.js";
+import {
+  upload_exports
+} from "../../../chunks/chunk-EHVYR4OU.js";
+import "../../../chunks/chunk-N5QAGJXV.js";
+import "../../../chunks/chunk-KH5JTC2N.js";
+import "../../../chunks/chunk-AIESW26U.js";
+import "../../../chunks/chunk-AZLVQV5A.js";
+import {
+  download_exports
+} from "../../../chunks/chunk-HQGZVWBB.js";
+import "../../../chunks/chunk-7N7BJA6C.js";
+import "../../../chunks/chunk-6WVNJVBE.js";
+import "../../../chunks/chunk-UJN2WZGO.js";
+import "../../../chunks/chunk-OD33BN4K.js";
+import "../../../chunks/chunk-P3QFJTAE.js";
+import "../../../chunks/chunk-CMWR77VW.js";
+import "../../../chunks/chunk-JMU5PDBD.js";
+import "../../../chunks/chunk-FENXVJYO.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  download_exports as Download,
+  upload_exports as Upload
+};

package/node/cloud-storage/operations/upload/index.d.ts

@@ -0,0 +1,6 @@
+import { Readable } from 'node:stream';
+import { Outcome } from '~/agnostic/misc/outcome';
+import { Client } from '../../client';
+import { Credentials } from '../../credentials';
+import { Type, Endpoint } from '../../endpoint';
+export declare function upload<T extends Type>(fileReadable: Readable, targetPath: string, endpointType: T, endpointIdentifier: Endpoint<T>['identifier'], credentials: Credentials<T>, client?: Client<T>): Promise<Outcome.Either<true, string>>;

package/node/cloud-storage/operations/upload/index.js

@@ -0,0 +1,15 @@
+import {
+  upload
+} from "../../../../chunks/chunk-EHVYR4OU.js";
+import "../../../../chunks/chunk-N5QAGJXV.js";
+import "../../../../chunks/chunk-KH5JTC2N.js";
+import "../../../../chunks/chunk-AIESW26U.js";
+import "../../../../chunks/chunk-AZLVQV5A.js";
+import "../../../../chunks/chunk-P3QFJTAE.js";
+import "../../../../chunks/chunk-CMWR77VW.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  upload
+};

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

@@ -1,3 +1,4 @@
+import { Buffer } from 'node:buffer';
 import { Readable } from 'node:stream';
 import { Outcome } from '~/agnostic/misc/outcome';
 import { EncryptDecryptOptions } from '../uint8-array';
@@ -12,7 +13,7 @@ import { EncryptDecryptOptions } from '../uint8-array';
  *
  * @returns {Outcome.Either<Buffer, string>} The result of the encryption. Success returns the encrypted data as a `Buffer` (with IV prepended), or failure returns an error message.
  */
-export declare function encryptBuffer(inputBuffer: Buffer, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Buffer, string>;
+export declare function encrypt(inputBuffer: Buffer, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Buffer, string>;
 /**
  * Encrypts a `Buffer` using streams and returns a `Readable` stream containing the encrypted data.
  * The `Readable` stream will emit encrypted data in chunks.
@@ -26,7 +27,7 @@ export declare function encryptBuffer(inputBuffer: Buffer, encryptionKey: string
  * @returns {Outcome.Either<Readable, string>} - An `Outcome` containing either the `Readable` stream on success,
  * or an error message on failure.
  */
-export declare function encryptBufferWithStream(inputBuffer: Buffer, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Readable, string>;
+export declare function encryptWithStream(inputBuffer: Buffer, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Readable, string>;
 /**
  * Decrypts an encrypted `Buffer` by converting it to a `Uint8Array`, performing decryption, and then returning the result as a `Buffer`.
  *
@@ -38,7 +39,7 @@ export declare function encryptBufferWithStream(inputBuffer: Buffer, encryptionK
  *
  * @returns {Outcome.Either<Buffer, string>} The result of the decryption. Success returns the decrypted data as a `Buffer`, or failure returns an error message.
  */
-export declare function decryptBuffer(encryptedBuffer: Buffer, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Buffer, string>;
+export declare function decrypt(encryptedBuffer: Buffer, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Buffer, string>;
 /**
  * Decrypts an encrypted `Buffer` using streams and returns a `Readable` stream containing the decrypted data.
  * The `Readable` stream will emit decrypted data in chunks.
@@ -52,4 +53,4 @@ export declare function decryptBuffer(encryptedBuffer: Buffer, encryptionKey: st
  * @returns {Outcome.Either<Readable, string>} - An `Outcome` containing either the `Readable` stream on success,
  * or an error message on failure.
  */
-export declare function decryptBufferWithStream(encryptedBuffer: Buffer, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Readable, string>;
+export declare function decryptWithStream(encryptedBuffer: Buffer, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Readable, string>;

package/node/encryption/buffer/index.js

@@ -1,16 +1,16 @@
 import {
-  decryptBuffer,
-  decryptBufferWithStream,
-  encryptBuffer,
-  encryptBufferWithStream
-} from "../../../chunks/chunk-IUFAHY2R.js";
-import "../../../chunks/chunk-5QVKJGTN.js";
+  decrypt,
+  decryptWithStream,
+  encrypt,
+  encryptWithStream
+} from "../../../chunks/chunk-MUZGZ3ZF.js";
+import "../../../chunks/chunk-IJ7SOXLA.js";
 import "../../../chunks/chunk-JMU5PDBD.js";
 import "../../../chunks/chunk-FENXVJYO.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
 export {
-  decryptBuffer,
-  decryptBufferWithStream,
-  encryptBuffer,
-  encryptBufferWithStream
+  decrypt,
+  decryptWithStream,
+  encrypt,
+  encryptWithStream
 };

package/node/encryption/generate-key/index.js

@@ -1,7 +1,7 @@
 import {
   generateEncryptionKey
 } from "../../../chunks/chunk-GNZY3ZTH.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
 export {
   generateEncryptionKey
 };

package/node/encryption/index.d.ts

@@ -1,5 +1,4 @@
-import { encryptBuffer, decryptBuffer, encryptBufferWithStream, decryptBufferWithStream } from './buffer';
-import { generateEncryptionKey, GenerateEncryptionKeyOptions } from './generate-key';
-import { EncryptDecryptOptions, encryptUint8Array, decryptUint8Array, encryptUint8ArrayWithStream, decryptUint8ArrayWithStream } from './uint8-array';
-export { encryptBuffer, decryptBuffer, encryptBufferWithStream, decryptBufferWithStream, generateEncryptionKey, encryptUint8Array, decryptUint8Array, encryptUint8ArrayWithStream, decryptUint8ArrayWithStream };
-export type { EncryptDecryptOptions, GenerateEncryptionKeyOptions };
+import * as Buffer from './buffer';
+import * as Key from './key';
+import * as Uint8Array from './uint8-array';
+export { Buffer, Key, Uint8Array };

package/node/encryption/index.js

@@ -1,29 +1,17 @@
 import {
-  generateEncryptionKey
-} from "../../chunks/chunk-GNZY3ZTH.js";
+  key_exports
+} from "../../chunks/chunk-HKTNK262.js";
 import {
-  decryptBuffer,
-  decryptBufferWithStream,
-  encryptBuffer,
-  encryptBufferWithStream
-} from "../../chunks/chunk-IUFAHY2R.js";
+  buffer_exports
+} from "../../chunks/chunk-MUZGZ3ZF.js";
 import {
-  decryptUint8Array,
-  decryptUint8ArrayWithStream,
-  encryptUint8Array,
-  encryptUint8ArrayWithStream
-} from "../../chunks/chunk-5QVKJGTN.js";
+  uint8_array_exports
+} from "../../chunks/chunk-IJ7SOXLA.js";
 import "../../chunks/chunk-JMU5PDBD.js";
 import "../../chunks/chunk-FENXVJYO.js";
-import "../../chunks/chunk-XCBH6NLF.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
 export {
-  decryptBuffer,
-  decryptBufferWithStream,
-  decryptUint8Array,
-  decryptUint8ArrayWithStream,
-  encryptBuffer,
-  encryptBufferWithStream,
-  encryptUint8Array,
-  encryptUint8ArrayWithStream,
-  generateEncryptionKey
+  buffer_exports as Buffer,
+  key_exports as Key,
+  uint8_array_exports as Uint8Array
 };

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

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

package/node/encryption/key/index.js

@@ -0,0 +1,7 @@
+import {
+  generate
+} from "../../../chunks/chunk-HKTNK262.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  generate
+};

package/node/encryption/uint8-array/index.js

@@ -3,10 +3,10 @@ import {
   decryptUint8ArrayWithStream,
   encryptUint8Array,
   encryptUint8ArrayWithStream
-} from "../../../chunks/chunk-5QVKJGTN.js";
+} from "../../../chunks/chunk-IJ7SOXLA.js";
 import "../../../chunks/chunk-JMU5PDBD.js";
 import "../../../chunks/chunk-FENXVJYO.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
 export {
   decryptUint8Array,
   decryptUint8ArrayWithStream,

package/node/files/index.js

@@ -1,14 +1,14 @@
-import {
-  isInDirectory
-} from "../../chunks/chunk-NRITRUZW.js";
 import {
   Subpaths
 } from "../../chunks/chunk-HGCG2J77.js";
+import {
+  isInDirectory
+} from "../../chunks/chunk-NRITRUZW.js";
 import {
   readWrite
 } from "../../chunks/chunk-7DBNMU6N.js";
 import "../../chunks/chunk-LQFKUNVQ.js";
-import "../../chunks/chunk-XCBH6NLF.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
 
 // src/node/files/index.ts
 var isInDirectory2 = isInDirectory;

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

@@ -1,7 +1,7 @@
 import {
   isInDirectory
 } from "../../../chunks/chunk-NRITRUZW.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
 export {
   isInDirectory
 };

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

@@ -1,7 +1,7 @@
 import {
   readWrite
 } from "../../../chunks/chunk-7DBNMU6N.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
 export {
   readWrite
 };

package/node/files/subpaths/index.js

@@ -2,7 +2,7 @@ import {
   Subpaths
 } from "../../../chunks/chunk-HGCG2J77.js";
 import "../../../chunks/chunk-LQFKUNVQ.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
 export {
   Subpaths
 };

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

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

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

@@ -0,0 +1,9 @@
+import {
+  download
+} from "../../../../chunks/chunk-UJN2WZGO.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  download
+};

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

@@ -0,0 +1,3 @@
+import * as Download from './download';
+import * as Upload from './upload';
+export { Download, Upload };

package/node/ftps/file/index.js

@@ -0,0 +1,14 @@
+import "../../../chunks/chunk-WO2R3QFK.js";
+import {
+  upload_exports
+} from "../../../chunks/chunk-AIESW26U.js";
+import {
+  download_exports
+} from "../../../chunks/chunk-UJN2WZGO.js";
+import "../../../chunks/chunk-JMU5PDBD.js";
+import "../../../chunks/chunk-FENXVJYO.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  download_exports as Download,
+  upload_exports as Upload
+};

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

@@ -0,0 +1,24 @@
+import { Readable } from 'node:stream';
+import { Client, UploadOptions as BasicFtpUploadOptions } from 'basic-ftp';
+import { Outcome } from '~/agnostic/misc/outcome';
+export type UploadOptions = BasicFtpUploadOptions & {
+    ensureDir?: boolean;
+    overwrite?: boolean;
+};
+/**
+ * Uploads a file stream to a specified FTP server.
+ *
+ * This function uploads the provided file stream to the given FTP server at the specified target path.
+ * The upload process can be customized using optional upload options.
+ * If the `ensureDir` option is true, it ensures that the target directory exists before uploading.
+ * If the `overwrite` option is false, it prevents overwriting an existing file.
+ *
+ * @param {Readable} fileStream - The file content to be uploaded.
+ * @param {string} targetPath - The target path where the file will be stored on the FTP server.
+ * @param {Client} ftpClient - The basic-ftp client instance used to interact with the FTP server.
+ * @param {UploadOptions} [options] - Optional settings for configuring the upload process.
+ * @returns {Promise<Outcome.Either<true, string>>} 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.
+ */
+export declare function upload(fileStream: Readable, targetPath: string, ftpClient: Client, options?: UploadOptions): Promise<Outcome.Either<true, string>>;

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

@@ -0,0 +1,9 @@
+import {
+  upload
+} from "../../../../chunks/chunk-AIESW26U.js";
+import "../../../../chunks/chunk-JMU5PDBD.js";
+import "../../../../chunks/chunk-FENXVJYO.js";
+import "../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  upload
+};

package/node/ftps/index.d.ts

@@ -0,0 +1,2 @@
+import * as File from './file';
+export { File };

package/node/ftps/index.js

@@ -0,0 +1,11 @@
+import {
+  file_exports
+} from "../../chunks/chunk-WO2R3QFK.js";
+import "../../chunks/chunk-AIESW26U.js";
+import "../../chunks/chunk-UJN2WZGO.js";
+import "../../chunks/chunk-JMU5PDBD.js";
+import "../../chunks/chunk-FENXVJYO.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
+export {
+  file_exports as File
+};

package/node/images/exports/index.js

@@ -1,10 +1,8 @@
 import {
   exportZipBuffer,
   prepareExport
-} from "../../../chunks/chunk-NGYJGQT3.js";
-import "../../../chunks/chunk-53MBV4TG.js";
-import "../../../chunks/chunk-VP3Y6EMX.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
+} from "../../../chunks/chunk-5RGHYFQH.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
 export {
   exportZipBuffer,
   prepareExport

package/node/images/index.js

@@ -1,22 +1,20 @@
 import {
   prepare_exports
-} from "../../chunks/chunk-2KCKWG7R.js";
+} from "../../chunks/chunk-KUIQRVIC.js";
 import {
   transform_exports
-} from "../../chunks/chunk-TXOUGP37.js";
-import "../../chunks/chunk-4LCL2RIC.js";
-import "../../chunks/chunk-L7EUEQZP.js";
-import "../../chunks/chunk-IOWZMFCU.js";
-import "../../chunks/chunk-L5JWJRZ7.js";
-import "../../chunks/chunk-QPBY235R.js";
-import "../../chunks/chunk-YRSNU7IX.js";
-import "../../chunks/chunk-UXM54YBI.js";
+} from "../../chunks/chunk-D2NTUAFE.js";
+import "../../chunks/chunk-XC2YGMNJ.js";
 import {
   exports_exports
-} from "../../chunks/chunk-NGYJGQT3.js";
-import "../../chunks/chunk-53MBV4TG.js";
-import "../../chunks/chunk-VP3Y6EMX.js";
-import "../../chunks/chunk-XCBH6NLF.js";
+} from "../../chunks/chunk-5RGHYFQH.js";
+import "../../chunks/chunk-L7EUEQZP.js";
+import "../../chunks/chunk-OPO25SDO.js";
+import "../../chunks/chunk-X5FAZBWL.js";
+import "../../chunks/chunk-454MZ5UE.js";
+import "../../chunks/chunk-JJWKHBXD.js";
+import "../../chunks/chunk-7DDXALPH.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
 export {
   exports_exports as Exports,
   prepare_exports as Prepare,

package/node/images/prepare/index.js

@@ -2,19 +2,17 @@ import {
   MAX_NB_OUTPUTS,
   OUTPUT_ZIP_FOLDER,
   prepareImage
-} from "../../../chunks/chunk-2KCKWG7R.js";
-import "../../../chunks/chunk-TXOUGP37.js";
-import "../../../chunks/chunk-4LCL2RIC.js";
+} from "../../../chunks/chunk-KUIQRVIC.js";
+import "../../../chunks/chunk-D2NTUAFE.js";
+import "../../../chunks/chunk-XC2YGMNJ.js";
+import "../../../chunks/chunk-5RGHYFQH.js";
 import "../../../chunks/chunk-L7EUEQZP.js";
-import "../../../chunks/chunk-IOWZMFCU.js";
-import "../../../chunks/chunk-L5JWJRZ7.js";
-import "../../../chunks/chunk-QPBY235R.js";
-import "../../../chunks/chunk-YRSNU7IX.js";
-import "../../../chunks/chunk-UXM54YBI.js";
-import "../../../chunks/chunk-NGYJGQT3.js";
-import "../../../chunks/chunk-53MBV4TG.js";
-import "../../../chunks/chunk-VP3Y6EMX.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
+import "../../../chunks/chunk-OPO25SDO.js";
+import "../../../chunks/chunk-X5FAZBWL.js";
+import "../../../chunks/chunk-454MZ5UE.js";
+import "../../../chunks/chunk-JJWKHBXD.js";
+import "../../../chunks/chunk-7DDXALPH.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
 export {
   MAX_NB_OUTPUTS,
   OUTPUT_ZIP_FOLDER,

package/node/images/transform/area-composition/index.js

@@ -1,15 +1,14 @@
 import {
   areaCompose,
   getSharpTilesInputs
-} from "../../../../chunks/chunk-4LCL2RIC.js";
+} from "../../../../chunks/chunk-XC2YGMNJ.js";
 import "../../../../chunks/chunk-L7EUEQZP.js";
-import "../../../../chunks/chunk-IOWZMFCU.js";
-import "../../../../chunks/chunk-L5JWJRZ7.js";
-import "../../../../chunks/chunk-QPBY235R.js";
-import "../../../../chunks/chunk-YRSNU7IX.js";
-import "../../../../chunks/chunk-UXM54YBI.js";
-import "../../../../chunks/chunk-53MBV4TG.js";
-import "../../../../chunks/chunk-XCBH6NLF.js";
+import "../../../../chunks/chunk-OPO25SDO.js";
+import "../../../../chunks/chunk-X5FAZBWL.js";
+import "../../../../chunks/chunk-454MZ5UE.js";
+import "../../../../chunks/chunk-JJWKHBXD.js";
+import "../../../../chunks/chunk-7DDXALPH.js";
+import "../../../../chunks/chunk-WSFCRVEQ.js";
 export {
   areaCompose,
   getSharpTilesInputs