@design-edito/tools 0.1.52 → 0.1.54

package/node/encryption/uint8-array/index.d.ts

@@ -0,0 +1,57 @@
+import { Readable } from 'node:stream';
+import { Outcome } from '~/agnostic/misc/outcome';
+export type EncryptDecryptOptions = {
+    ivLength?: number;
+};
+/**
+ * Encrypts a `Uint8Array` using the specified algorithm and encryption key.
+ *
+ * @param {Uint8Array} fileArray - The input data to encrypt.
+ * @param {string} encryptionKey - The encryption key to use.
+ * @param {string} [algorithm='aes-256-gcm'] - The encryption algorithm to use. Defaults to 'aes-256-gcm'.
+ * @param {EncryptDecryptOptions} [options] - Optional options.
+ * @param {number} [options.ivLength=16] - The length of the initialization vector (IV). Defaults to 16 bytes.
+ *
+ * @returns {Outcome.Either<Uint8Array, string>} The result of the encryption. Success returns the encrypted data as a `Uint8Array` (with IV prepended), or failure returns an error message.
+ */
+export declare function encryptUint8Array(fileArray: Uint8Array, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Uint8Array, string>;
+/**
+ * Decrypts an encrypted `Uint8Array` using the specified algorithm and encryption key.
+ *
+ * @param {Uint8Array} encryptedFile - The encrypted data to decrypt.
+ * @param {string} encryptionKey - The encryption key to use.
+ * @param {string} [algorithm='aes-256-gcm'] - The encryption algorithm to use. Defaults to 'aes-256-gcm'.
+ * @param {EncryptDecryptOptions} [options] - Optional options.
+ * @param {number} [options.ivLength=16] - The length of the initialization vector (IV). Defaults to 16 bytes.
+ *
+ * @returns {Outcome.Either<Uint8Array, string>} The result of the decryption. Success returns the decrypted data as a `Uint8Array`, or failure returns an error message.
+ */
+export declare function decryptUint8Array(encryptedFile: Uint8Array, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Uint8Array, string>;
+/**
+ * Encrypts a `Uint8Array` using streams and returns a `Readable` stream containing the encrypted data.
+ * The `Readable` stream will emit encrypted data in chunks.
+ *
+ * @param {Uint8Array} fileArray - The input data to be encrypted.
+ * @param {string} encryptionKey - The encryption key to use for encryption.
+ * @param {string} [algorithm='aes-256-gcm'] - The encryption algorithm to use (default: 'aes-256-gcm').
+ * @param {EncryptDecryptOptions} [options] - Optional parameters for encryption, such as `ivLength`.
+ * @param {number} [options.ivLength=16] - The length of the initialization vector (IV) to use (default: 16).
+ *
+ * @returns {Outcome.Either<Readable, string>} - An `Outcome` containing either the `Readable` stream on success,
+ * or an error message on failure.
+ */
+export declare function encryptUint8ArrayWithStream(fileArray: Uint8Array, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Readable, string>;
+/**
+ * Decrypts an encrypted `Uint8Array` using streams and returns a `Readable` stream containing the decrypted data.
+ * The `Readable` stream will emit decrypted data in chunks.
+ *
+ * @param {Uint8Array} encryptedFile - The encrypted data to be decrypted.
+ * @param {string} encryptionKey - The encryption key to use for decryption.
+ * @param {string} [algorithm='aes-256-gcm'] - The decryption algorithm to use (default: 'aes-256-gcm').
+ * @param {EncryptDecryptOptions} [options] - Optional parameters for decryption, such as `ivLength`.
+ * @param {number} [options.ivLength=16] - The length of the initialization vector (IV) to use (default: 16).
+ *
+ * @returns {Outcome.Either<Readable, string>} - An `Outcome` containing either the `Readable` stream on success,
+ * or an error message on failure.
+ */
+export declare function decryptUint8ArrayWithStream(encryptedFile: Uint8Array, encryptionKey: string, algorithm?: string, options?: EncryptDecryptOptions): Outcome.Either<Readable, string>;

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

@@ -0,0 +1,15 @@
+import {
+  decryptUint8Array,
+  decryptUint8ArrayWithStream,
+  encryptUint8Array,
+  encryptUint8ArrayWithStream
+} from "../../../chunks/chunk-5QVKJGTN.js";
+import "../../../chunks/chunk-JMU5PDBD.js";
+import "../../../chunks/chunk-FENXVJYO.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  decryptUint8Array,
+  decryptUint8ArrayWithStream,
+  encryptUint8Array,
+  encryptUint8ArrayWithStream
+};

package/node/files/index.d.ts

@@ -1,9 +1,7 @@
 import { isInDirectory as isInDirectoryFunc } from './is-in-directory';
 import { ReadWriteEditorFunc as ReadWriteEditorFuncType, readWrite as readWriteFunc } from './read-write';
 import { Subpaths as SubpathsNamespace } from './subpaths';
-export declare namespace Files {
-    const isInDirectory: typeof isInDirectoryFunc;
-    type ReadWriteEditorFunc = ReadWriteEditorFuncType;
-    const readWrite: typeof readWriteFunc;
-    export import Subpaths = SubpathsNamespace;
-}
+export declare const isInDirectory: typeof isInDirectoryFunc;
+export type ReadWriteEditorFunc = ReadWriteEditorFuncType;
+export declare const readWrite: typeof readWriteFunc;
+export import Subpaths = SubpathsNamespace;

package/node/files/index.js

@@ -1,21 +1,21 @@
 import {
-  Subpaths
-} from "../../chunks/chunk-HGCG2J77.js";
+  isInDirectory
+} from "../../chunks/chunk-NRITRUZW.js";
 import {
   readWrite
 } from "../../chunks/chunk-7DBNMU6N.js";
 import {
-  isInDirectory
-} from "../../chunks/chunk-NRITRUZW.js";
+  Subpaths
+} from "../../chunks/chunk-HGCG2J77.js";
 import "../../chunks/chunk-LQFKUNVQ.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
 
 // src/node/files/index.ts
-var Files;
-((Files2) => {
-  Files2.isInDirectory = isInDirectory;
-  Files2.readWrite = readWrite;
-  Files2.Subpaths = Subpaths;
-})(Files || (Files = {}));
+var isInDirectory2 = isInDirectory;
+var readWrite2 = readWrite;
+var Subpaths2 = Subpaths;
 export {
-  Files
+  Subpaths2 as Subpaths,
+  isInDirectory2 as isInDirectory,
+  readWrite2 as readWrite
 };

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

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

package/node/files/read-write/index.d.ts

@@ -5,5 +5,5 @@ type WriteFileData = Parameters<typeof fs.writeFile>[1];
 type ReadOptions = Parameters<typeof fs.readFile>[1];
 type WriteOptions = Parameters<typeof fs.writeFile>[2];
 export type ReadWriteEditorFunc = (curr: ReadFileData) => WriteFileData;
-export declare function readWrite(path: Path, editor: ReadWriteEditorFunc, ...options: [ReadOptions?, WriteOptions?]): Promise<string | NodeJS.ArrayBufferView<ArrayBufferLike> | Iterable<string | NodeJS.ArrayBufferView<ArrayBufferLike>> | AsyncIterable<string | NodeJS.ArrayBufferView<ArrayBufferLike>> | import("stream")>;
+export declare function readWrite(path: Path, editor: ReadWriteEditorFunc, ...options: [ReadOptions?, WriteOptions?]): Promise<string | import("stream") | NodeJS.ArrayBufferView<ArrayBufferLike> | Iterable<string | NodeJS.ArrayBufferView<ArrayBufferLike>> | AsyncIterable<string | NodeJS.ArrayBufferView<ArrayBufferLike>>>;
 export {};

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

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

package/node/files/subpaths/index.js

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

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

@@ -0,0 +1,15 @@
+import sharp from "sharp";
+export type OutputFormat = 'jpeg' | 'png' | 'webp' | 'avif' | keyof (sharp.FormatEnum);
+export type OutputOptions = {
+    format: OutputFormat;
+    width: number;
+    height: number;
+    quality: number;
+};
+export type ExportZipSource = {
+    buffer: Buffer;
+    name: string;
+};
+export type ExportZipSources = ExportZipSource[];
+export declare function prepareExport(imageBuffer: Buffer, outputOptions: OutputOptions): Promise<Buffer<ArrayBufferLike>>;
+export declare function exportZipBuffer(zipSources: ExportZipSources, zipDirectoryName?: string): Promise<Buffer<ArrayBufferLike> | undefined>;

package/node/images/exports/index.js

@@ -0,0 +1,9 @@
+import {
+  exportZipBuffer,
+  prepareExport
+} from "../../../chunks/chunk-5RGHYFQH.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  exportZipBuffer,
+  prepareExport
+};

package/node/images/index.d.ts

@@ -0,0 +1,4 @@
+import * as Exports from './exports';
+import * as Transform from './transform';
+import * as Prepare from './prepare';
+export { Prepare, Exports, Transform };

package/node/images/index.js

@@ -0,0 +1,22 @@
+import {
+  prepare_exports
+} from "../../chunks/chunk-VQEP2EQF.js";
+import {
+  transform_exports
+} from "../../chunks/chunk-VV72XGJJ.js";
+import "../../chunks/chunk-422KBDRV.js";
+import "../../chunks/chunk-L7EUEQZP.js";
+import "../../chunks/chunk-UVSTFYSD.js";
+import "../../chunks/chunk-X5FAZBWL.js";
+import "../../chunks/chunk-BONBND7I.js";
+import "../../chunks/chunk-7DDXALPH.js";
+import "../../chunks/chunk-JJWKHBXD.js";
+import {
+  exports_exports
+} from "../../chunks/chunk-5RGHYFQH.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
+export {
+  exports_exports as Exports,
+  prepare_exports as Prepare,
+  transform_exports as Transform
+};

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

@@ -0,0 +1,17 @@
+import { OutputFormat } from "../exports";
+import { Operations } from "../transform";
+export type Quality = number;
+export type Ratio = [number, number];
+export type PrepareImageOptions = {
+    name?: string | undefined;
+    inputOperations?: Operations;
+    formats?: OutputFormat[];
+    center?: [number, number];
+    qualities?: Quality[];
+    ratios?: Ratio[];
+    widths?: number[];
+    heights?: number[];
+};
+export declare const MAX_NB_OUTPUTS = 50;
+export declare const OUTPUT_ZIP_FOLDER = "./output-zips";
+export declare function prepareImage(imageBuffer: Buffer, customOptions?: PrepareImageOptions): Promise<Buffer<ArrayBufferLike> | undefined>;

package/node/images/prepare/index.js

@@ -0,0 +1,20 @@
+import {
+  MAX_NB_OUTPUTS,
+  OUTPUT_ZIP_FOLDER,
+  prepareImage
+} from "../../../chunks/chunk-VQEP2EQF.js";
+import "../../../chunks/chunk-VV72XGJJ.js";
+import "../../../chunks/chunk-422KBDRV.js";
+import "../../../chunks/chunk-L7EUEQZP.js";
+import "../../../chunks/chunk-UVSTFYSD.js";
+import "../../../chunks/chunk-X5FAZBWL.js";
+import "../../../chunks/chunk-BONBND7I.js";
+import "../../../chunks/chunk-7DDXALPH.js";
+import "../../../chunks/chunk-JJWKHBXD.js";
+import "../../../chunks/chunk-5RGHYFQH.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  MAX_NB_OUTPUTS,
+  OUTPUT_ZIP_FOLDER,
+  prepareImage
+};

package/node/images/transform/area-composition/index.d.ts

@@ -0,0 +1,60 @@
+import sharp from "sharp";
+import { Thumbnails } from "~/node/@design-edito";
+export type Dimensions = {
+    w: number;
+    h: number;
+};
+export type Options = {
+    formats: string[];
+    nbOutputs: number;
+    dimensions: Dimensions;
+    imagePosition: 'top-left' | 'top-center' | 'top-right' | 'left-center' | 'center' | 'right-center' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+    imageOccupation: number;
+    palette: ('default' | 'default-lighten' | 'default-saturate' | 'complementary' | 'complementary-lighten' | 'complementary-saturate')[];
+    colors?: (string | {
+        r: number;
+        g: number;
+        b: number;
+    })[];
+    maxPaletteDensity: number;
+    extractPaletteDensity: number;
+    lightenIntensity: number;
+    saturateIntensity: number;
+    colorFilter?: string;
+    colorFilterApply?: 'all' | 'input-only' | 'shapes-only';
+    tileCoverage: number;
+    tileDensityA: {
+        min: number;
+        max: number;
+    };
+    tileDensityB: {
+        min: number;
+        max: number;
+    };
+    tileFormat: 'random' | 'default' | 'portrait' | 'landscape';
+    tileXEasing: string;
+    tileYEasing: string;
+};
+export type SharpShape = {
+    width: number;
+    height: number;
+    channels: 3 | 4;
+    background: {
+        r: number;
+        g: number;
+        b: number;
+        alpha: number;
+    };
+};
+export type SharpInput = {
+    top: number;
+    left: number;
+    input: sharp.Sharp;
+};
+export declare function areaCompose(inputSharp: sharp.Sharp, customOptions?: Partial<Options>): Promise<sharp.Sharp>;
+export declare function getSharpTilesInputs(tiles: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}[], palette: Thumbnails.Colors.Palette): Array<SharpInput>;

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

@@ -0,0 +1,15 @@
+import {
+  areaCompose,
+  getSharpTilesInputs
+} from "../../../../chunks/chunk-422KBDRV.js";
+import "../../../../chunks/chunk-L7EUEQZP.js";
+import "../../../../chunks/chunk-UVSTFYSD.js";
+import "../../../../chunks/chunk-X5FAZBWL.js";
+import "../../../../chunks/chunk-BONBND7I.js";
+import "../../../../chunks/chunk-7DDXALPH.js";
+import "../../../../chunks/chunk-JJWKHBXD.js";
+import "../../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  areaCompose,
+  getSharpTilesInputs
+};

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

@@ -0,0 +1,30 @@
+import sharp from "sharp";
+export type RotateOperationParams = {
+    angle: number;
+};
+export type RotateOperation = {
+    name: 'rotate';
+    params: RotateOperationParams;
+};
+export type ResizeOperationParams = {
+    width: number;
+    height: number;
+    fit?: keyof sharp.FitEnum;
+};
+export type ResizeOperation = {
+    name: 'resize';
+    params: ResizeOperationParams;
+};
+export type AreaCompositionOperationParams = Partial<{}>;
+export type AreaCompositionOperation = {
+    name: 'area-composition';
+    params: AreaCompositionOperationParams;
+};
+export type Operation = RotateOperation | ResizeOperation | AreaCompositionOperation;
+export type Operations = Operation[];
+export type Dimensions = {
+    width: number;
+    height: number;
+};
+export declare function transformImage(imageBuffer: Buffer, operations: Operations, maxDimensions: Dimensions): Promise<Buffer<ArrayBufferLike>>;
+export declare function isOperation(operation: any): boolean;

package/node/images/transform/index.js

@@ -0,0 +1,16 @@
+import {
+  isOperation,
+  transformImage
+} from "../../../chunks/chunk-VV72XGJJ.js";
+import "../../../chunks/chunk-422KBDRV.js";
+import "../../../chunks/chunk-L7EUEQZP.js";
+import "../../../chunks/chunk-UVSTFYSD.js";
+import "../../../chunks/chunk-X5FAZBWL.js";
+import "../../../chunks/chunk-BONBND7I.js";
+import "../../../chunks/chunk-7DDXALPH.js";
+import "../../../chunks/chunk-JJWKHBXD.js";
+import "../../../chunks/chunk-WSFCRVEQ.js";
+export {
+  isOperation,
+  transformImage
+};

package/node/index.d.ts

@@ -1,6 +1,8 @@
-import { Files as FilesNamespace } from './files';
-import { Process as ProcessNamespace } from './process';
-export declare namespace Node {
-    export import Files = FilesNamespace;
-    export import Process = ProcessNamespace;
-}
+import * as DesignEdito from './@design-edito';
+import * as Express from './@express';
+import * as GoogleCloud from './@google-cloud';
+import * as Encryption from './encryption';
+import * as Files from './files';
+import * as Images from './images';
+import * as Process from './process';
+export { DesignEdito, Express, GoogleCloud, Encryption, Files, Images, Process };

package/node/process/index.d.ts

@@ -1,8 +1,6 @@
 import { beforeForcedExit as beforeForcedExitFunc, beforeExit as beforeExitFunc, onExit as onExitFunc, onAllExits as onAllExitsFunc } from './on-exit';
-export declare namespace Process {
-    const forceExitEvents: string[];
-    const beforeForcedExit: typeof beforeForcedExitFunc;
-    const beforeExit: typeof beforeExitFunc;
-    const onExit: typeof onExitFunc;
-    const onAllExits: typeof onAllExitsFunc;
-}
+export declare const forceExitEvents: string[];
+export declare const beforeForcedExit: typeof beforeForcedExitFunc;
+export declare const beforeExit: typeof beforeExitFunc;
+export declare const onExit: typeof onExitFunc;
+export declare const onAllExits: typeof onAllExitsFunc;

package/node/process/index.js

@@ -5,16 +5,18 @@ import {
   onAllExits,
   onExit
 } from "../../chunks/chunk-LEXQ6E6L.js";
+import "../../chunks/chunk-WSFCRVEQ.js";
 
 // src/node/process/index.ts
-var Process;
-((Process2) => {
-  Process2.forceExitEvents = forceExitEvents;
-  Process2.beforeForcedExit = beforeForcedExit;
-  Process2.beforeExit = beforeExit;
-  Process2.onExit = onExit;
-  Process2.onAllExits = onAllExits;
-})(Process || (Process = {}));
+var forceExitEvents2 = forceExitEvents;
+var beforeForcedExit2 = beforeForcedExit;
+var beforeExit2 = beforeExit;
+var onExit2 = onExit;
+var onAllExits2 = onAllExits;
 export {
-  Process
+  beforeExit2 as beforeExit,
+  beforeForcedExit2 as beforeForcedExit,
+  forceExitEvents2 as forceExitEvents,
+  onAllExits2 as onAllExits,
+  onExit2 as onExit
 };

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@design-edito/tools",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "description": "",
   "author": "Maxime Fabas",
   "license": "ISC",
@@ -12,16 +12,27 @@
   "main": "index.js",
   "module": "index.js",
   "peerDependencies": {
+    "@google-cloud/storage": "^7.15.2",
+    "archiver": "^7.0.1",
     "chalk": "^5.4.1",
+    "express": "^4.21.2",
+    "multer": "^1.4.5-lts.2",
+    "quantize": "^1.0.2",
     "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "react-dom": "^19.0.0",
+    "sharp": "^0.33.5"
   },
   "devDependencies": {
+    "@types/archiver": "^6.0.3",
+    "@types/express": "^5.0.1",
+    "@types/multer": "^1.4.12",
     "@types/node": "^22.13.10",
     "@types/prompts": "^2.4.9",
+    "@types/quantize": "^1.0.2",
     "@types/react": "^19.0.11",
     "@types/react-dom": "^19.0.4",
     "@types/semver": "^7.5.8",
+    "@types/sharp": "^0.31.1",
     "chokidar-cli": "^3.0.0",
     "concurrently": "^9.1.2",
     "esbuild": "^0.25.1",