vortez 4.1.1

package/build/Server/WebSocket/Chunk.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Añade la forma de WebSockets a `Vortez`.
+ * @license Apache-2.0
+ */
+export declare class Chunk implements Chunk.Info {
+    fin: Boolean;
+    rsv: number;
+    opCode: number;
+    mask: Boolean;
+    size: number | bigint;
+    maskKeys: Buffer | null;
+    infoSize: number;
+    chunkSize: number;
+    chunk: Buffer;
+    surplus: Buffer;
+    constructor(chunk: Buffer);
+    pushData(data: Buffer): void;
+    getChunk(): Buffer;
+    isWaiting(): boolean;
+    decode(): Buffer;
+    static getInfo(chunk: Buffer): Chunk.Info;
+    static decode(chunk: Buffer, bytesInfo: number, maskKeys: Buffer | undefined): Buffer<ArrayBuffer>;
+}
+export declare namespace Chunk {
+    interface Info {
+        fin: Boolean;
+        rsv: number;
+        opCode: number;
+        mask: Boolean;
+        size: number | bigint;
+        maskKeys: Buffer | null;
+        infoSize: number;
+    }
+}
+export default Chunk;

package/build/Server/WebSocket/Chunk.js

@@ -0,0 +1,81 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Añade la forma de WebSockets a `Vortez`.
+ * @license Apache-2.0
+ */
+export class Chunk {
+    fin;
+    rsv;
+    opCode;
+    mask;
+    size;
+    maskKeys;
+    infoSize;
+    chunkSize;
+    chunk;
+    surplus;
+    constructor(chunk) {
+        const { fin, rsv, opCode, mask, size, maskKeys, infoSize: infoSize } = Chunk.getInfo(chunk);
+        this.fin = fin;
+        this.rsv = rsv;
+        this.opCode = opCode;
+        this.mask = mask;
+        this.size = size;
+        this.maskKeys = maskKeys;
+        this.infoSize = infoSize;
+        this.chunkSize = Number(size) + infoSize;
+        if (chunk.length > (BigInt(size) + BigInt(infoSize))) {
+            this.surplus = chunk.subarray(this.chunkSize);
+            this.chunk = chunk.subarray(0, this.chunkSize);
+        }
+        else {
+            this.surplus = Buffer.alloc(0);
+            this.chunk = chunk;
+        }
+    }
+    pushData(data) {
+        this.chunk = Buffer.concat([this.chunk, data]);
+        if (this.chunk.length > this.chunkSize) {
+            this.surplus = this.chunk.subarray(this.chunkSize);
+            this.chunk = this.chunk.subarray(0, this.chunkSize);
+        }
+    }
+    getChunk() { return this.chunk; }
+    isWaiting() { return this.chunk.length < this.chunkSize; }
+    decode() {
+        return Chunk.decode(this.chunk, this.infoSize, this.maskKeys ?? undefined);
+    }
+    static getInfo(chunk) {
+        const fin = Boolean(((chunk[0] >>> 0x7) & 0x01));
+        const rsv = ((chunk[0] >>> 0x4) & 0x07);
+        const opCode = (chunk[0] & 0x0f);
+        const mask = Boolean(((chunk[1] >>> 0x7) & 0x01));
+        let size = (chunk[1] & 0x7f);
+        let maskKeys = null;
+        let bytesInfo = null;
+        if (size == 0x7f) {
+            size = chunk.readBigUint64BE(2);
+            maskKeys = mask ? chunk.subarray(10, 14) : null;
+            bytesInfo = mask ? 14 : 10;
+        }
+        else if (size == 0x7e) {
+            size = chunk.readUint16BE(2);
+            maskKeys = mask ? chunk.subarray(4, 8) : null;
+            bytesInfo = mask ? 8 : 4;
+        }
+        else {
+            maskKeys = mask ? chunk.subarray(2, 6) : null;
+            bytesInfo = mask ? 6 : 2;
+        }
+        return { fin, rsv, opCode, mask, size, maskKeys, infoSize: bytesInfo };
+    }
+    static decode(chunk, bytesInfo, maskKeys) {
+        const decoded = [];
+        for (let index = bytesInfo, indexMask = 0; index < chunk.length; index++, indexMask++) {
+            decoded.push(chunk[index] ^ (maskKeys ? maskKeys[indexMask % 4] : 0));
+        }
+        return Buffer.from(decoded);
+    }
+}
+export default Chunk;
+//# sourceMappingURL=Chunk.js.map

package/build/Server/WebSocket/Chunk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chunk.js","sourceRoot":"","sources":["../../../src/Server/WebSocket/Chunk.ts"],"names":[],"mappings":"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"}

package/build/Server/WebSocket/WebSocket.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Añade la forma de WebSockets a `Vortez`.
+ * @license Apache-2.0
+ */
+import EVENTS from 'events';
+import { Duplex } from 'stream';
+import Cookie from '../Cookie.js';
+export declare class WebSocket extends EVENTS {
+    /**Contiene la conexión con el cliente. */
+    private connection;
+    /**
+     * Crea una conexión WebSocket.
+     * @param client La conexión Duplex con el cliente.
+     */
+    constructor(client: Duplex);
+    /**
+     * Acepta la conexión del cliente.
+     * @param acceptKey La llave de conexión `sec-websocket-key`.
+     */
+    acceptConnection(acceptKey: string, cookies?: Cookie): void;
+    /** Finaliza la conexión esperando a que se terminen de enviar/recibir los datos pendientes. */
+    end(): void;
+    /** Finaliza la conexión de forma abrupta. */
+    destroy(): void;
+    /**
+     * Envía un dato como respuesta.
+     * @param data El dato que se enviara.
+     */
+    send(data: String | Buffer): void;
+    /**
+     * Envía un JSON como respuesta.
+     * @param data los datos que enviaras como JSON.
+     */
+    SendJson(data: any): void;
+    /**
+     * Codifica los datos para enviar por el WebSocket.
+     * @param data Los datos que se van a codificar.
+     * @param Text indica si el contenido es texto o no.
+     */
+    private encode;
+    /**
+     * Convierte un string en un Buffer.
+     * @param message El string a transformar.
+     */
+    private stringToBuffer;
+    /**Añade los disparadores de evento.*/
+    private initEvents;
+    on(event: 'close', listener: WebSocket.listener.close): this;
+    on(event: 'error', listener: WebSocket.listener.error): this;
+    on(event: 'finish', listener: WebSocket.listener.finish): this;
+    on(event: 'message', listener: WebSocket.listener.message): this;
+    off(event: 'close', listener: WebSocket.listener.close): this;
+    off(event: 'error', listener: WebSocket.listener.error): this;
+    off(event: 'finish', listener: WebSocket.listener.finish): this;
+    off(event: 'message', listener: WebSocket.listener.message): this;
+}
+export declare namespace WebSocket {
+    namespace listener {
+        type close = () => void;
+        type error = (error: Error) => void;
+        type finish = () => void;
+        type message = (datos: Buffer, info: dataInfo) => void;
+    }
+    interface dataInfo {
+        opCode: number;
+        size: number | bigint;
+    }
+}
+export default WebSocket;

package/build/Server/WebSocket/WebSocket.js

@@ -0,0 +1,184 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Añade la forma de WebSockets a `Vortez`.
+ * @license Apache-2.0
+ */
+import EVENTS from 'events';
+import CRYPTO from 'crypto';
+import Chunk from './Chunk.js';
+export class WebSocket extends EVENTS {
+    /**Contiene la conexión con el cliente. */
+    connection;
+    /**
+     * Crea una conexión WebSocket.
+     * @param client La conexión Duplex con el cliente.
+     */
+    constructor(client) {
+        super();
+        this.connection = client;
+        this.initEvents();
+    }
+    /**
+     * Acepta la conexión del cliente.
+     * @param acceptKey La llave de conexión `sec-websocket-key`.
+     */
+    acceptConnection(acceptKey, cookies) {
+        const cookieSetters = cookies
+            ? cookies.getSetters().map((setter) => `Set-Cookie: ${setter}`)
+            : [];
+        const acceptToken = CRYPTO.createHash('SHA1').update(acceptKey + '258EAFA5-E914-47DA-95CA-C5AB0DC85B11').digest('base64');
+        const headers = [
+            'HTTP/1.1 101 Switching Protocols',
+            'Upgrade: websocket',
+            'Connection: Upgrade',
+            `Sec-WebSocket-Accept: ${acceptToken}`,
+            ...cookieSetters, '\r\n'
+        ].join('\r\n');
+        this.connection.write(headers);
+    }
+    /** Finaliza la conexión esperando a que se terminen de enviar/recibir los datos pendientes. */
+    end() { this.connection.end(); }
+    /** Finaliza la conexión de forma abrupta. */
+    destroy() { this.connection.destroy(); }
+    /**
+     * Envía un dato como respuesta.
+     * @param data El dato que se enviara.
+     */
+    send(data) {
+        const [buffer, isText] = typeof data == 'string'
+            ? [this.stringToBuffer(data), true]
+            : data instanceof Buffer
+                ? [data, false]
+                : [this.stringToBuffer('[Error]: Dato enviado no soportado por NetFeez-Labs/WebSocket'), true];
+        const message = this.encode(buffer, isText);
+        this.connection.write(message);
+    }
+    /**
+     * Envía un JSON como respuesta.
+     * @param data los datos que enviaras como JSON.
+     */
+    SendJson(data) {
+        const message = JSON.stringify(data);
+        this.send(message);
+    }
+    /**
+     * Codifica los datos para enviar por el WebSocket.
+     * @param data Los datos que se van a codificar.
+     * @param Text indica si el contenido es texto o no.
+     */
+    encode(data, isText = false) {
+        const encoded = isText ? [129] : [130];
+        if (data.length <= 125) {
+            encoded[1] = data.length;
+        }
+        else if (data.length >= 126 && data.length <= 65535) {
+            encoded[1] = 126;
+            encoded[2] = (data.length >> 8) & 255;
+            encoded[3] = (data.length) & 255;
+        }
+        else {
+            encoded[1] = 127;
+            encoded[2] = (data.length >> 56) & 255;
+            encoded[3] = (data.length >> 48) & 255;
+            encoded[4] = (data.length >> 40) & 255;
+            encoded[5] = (data.length >> 32) & 255;
+            encoded[6] = (data.length >> 24) & 255;
+            encoded[7] = (data.length >> 16) & 255;
+            encoded[8] = (data.length >> 8) & 255;
+            encoded[9] = (data.length) & 255;
+        }
+        /* for (let index = 0; index < data.length; index ++) {
+            encoded.push(data[index]);
+        } */
+        encoded.push(...data);
+        return Buffer.from(encoded);
+    }
+    /**
+     * Convierte un string en un Buffer.
+     * @param message El string a transformar.
+     */
+    stringToBuffer(message) {
+        return Buffer.from(message, 'utf-8');
+    }
+    /**Añade los disparadores de evento.*/
+    initEvents() {
+        let surplus = Buffer.alloc(0);
+        let currentChunk = null;
+        let chunks = [];
+        this.connection.on('data', (data) => {
+            if (surplus) {
+                data = Buffer.concat([surplus, data]);
+                surplus = Buffer.alloc(0);
+            }
+            if (!currentChunk)
+                currentChunk = new Chunk(data);
+            else if (currentChunk.isWaiting())
+                currentChunk.pushData(data);
+            if (!currentChunk.isWaiting()) {
+                chunks.push(currentChunk);
+                surplus = currentChunk.surplus;
+                if (currentChunk.fin) {
+                    const decoded = Buffer.concat(chunks.map(chunk => chunk.decode()));
+                    this.emit('message', decoded, {
+                        opCode: chunks[0].opCode,
+                        size: chunks[0].size
+                    });
+                    chunks = [];
+                }
+                currentChunk = null;
+            }
+        });
+        this.connection.on('close', () => this.emit('close'));
+        this.connection.on('end', () => this.emit('finish'));
+        this.connection.on('error', (error) => this.emit('error', error));
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+}
+export default WebSocket;
+/* Para aceptar las peticiones de conexión a WebSocket
+ *
+ * HTTP/1.1 101 Switching Protocols
+ * Upgrade: websocket
+ * Connection: Upgrade
+ * Sec-WebSocket-Accept: Sec-Websocket-key + '258EAFA5-E914-47DA-95CA-C5AB0DC85B11'
+ *                                            en HASH SHA-1 Codificado en Base64
+ *
+ ** Formato del intercambio de datos
+ *  0               1               2               3
+ *  0                   1                   2                   3
+ *  0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+ * +-+-+-+-+-------+-+-------------+-------------------------------+
+ * |F|R|R|R| opcode|M| Payload len |    Extended payload length    |
+ * |I|S|S|S|  (4)  |A|     (7)     |             (16/64)           |
+ * |N|V|V|V|       |S|             |   (if payload len==126/127)   |
+ * | |1|2|3|       |K|             |                               |
+ * +-+-+-+-+-------+-+-------------+ - - - - - - - - - - - - - - - +
+ * |     Extended payload length continued, if payload len == 127  |
+ * + - - - - - - - - - - - - - - - +-------------------------------+
+ * |                               |Masking-key, if MASK set to 1  |
+ * +-------------------------------+-------------------------------+
+ * | Masking-key (continued)       |          Payload Data         |
+ * +-------------------------------- - - - - - - - - - - - - - - - +
+ * :                     Payload Data continued ...                :
+ * + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +
+ * |                     Payload Data continued ...                |
+ * +---------------------------------------------------------------+
+ *
+ *
+ * FIN y OPCODE funcionan juntos para entregar mensajes con marco separado
+ * Solo esta disponible en OPCODE 0x0 a 0x2
+ *
+ * OPCODES:
+ * Continuación = 0x0
+ * Texto = 0x1
+ * Binario = 0x2
+ * Cierre = 0x8
+ * Ping = 0x9
+ * Pong = 0xa
+ */ 
+//# sourceMappingURL=WebSocket.js.map

package/build/Server/WebSocket/WebSocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocket.js","sourceRoot":"","sources":["../../../src/Server/WebSocket/WebSocket.ts"],"names":[],"mappings":"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"}

package/build/Template.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Add the HNetFeez-Labs template engine to the Vortez.
+ * @license Apache-2.0
+ */
+export declare class Template {
+    /** Regular expressions used to compile the template */
+    private static expressions;
+    /**
+     * Load and compile a template.
+     * @param path - The path to the template file.
+     * @param data - The data used to compile the template.
+     * @returns The compiled template.
+     * @throws Error if the path is not a file.
+     * @throws Error if the file does not exist.
+     */
+    static load(path: string, data: Template.dataObject): Promise<string>;
+    /**
+     * Compile a template.
+     * @param Content - The content of the template.
+     * @param data - The data used to compile the template.
+     * @returns The compiled template.
+     * @throws Error if key and value names are equal in object blocks.
+     */
+    private static compile;
+}
+export declare namespace Template {
+    interface dataObject {
+        [key: string]: any;
+    }
+}
+export default Template;

package/build/Template.js

@@ -0,0 +1,69 @@
+/**
+ * @author NetFeez <codefeez.dev@gmail.com>
+ * @description Add the HNetFeez-Labs template engine to the Vortez.
+ * @license Apache-2.0
+ */
+import FS from 'fs';
+import Utilities from './Utilities/Utilities.js';
+export class Template {
+    /** Regular expressions used to compile the template */
+    static expressions = {
+        variable: /\$\{(.+?)\}/ig,
+        object: {
+            block: /\$ ?\((.+)\) ?\{([^]+?)\}/g,
+            replaces: /\%(.+?)%/g
+        }
+    };
+    /**
+     * Load and compile a template.
+     * @param path - The path to the template file.
+     * @param data - The data used to compile the template.
+     * @returns The compiled template.
+     * @throws Error if the path is not a file.
+     * @throws Error if the file does not exist.
+     */
+    static async load(path, data) {
+        path = Utilities.Path.normalize(path);
+        const details = await FS.promises.stat(path);
+        if (!details.isFile())
+            throw new Error('the path is not a template file');
+        const template = await FS.promises.readFile(path);
+        return this.compile(template.toString('utf-8'), data);
+    }
+    /**
+     * Compile a template.
+     * @param Content - The content of the template.
+     * @param data - The data used to compile the template.
+     * @returns The compiled template.
+     * @throws Error if key and value names are equal in object blocks.
+     */
+    static compile(Content, data) {
+        Content = Content.replace(this.expressions.variable, (text, name) => {
+            return name && name in data ? data[name] : text;
+        });
+        Content = Content.replace(this.expressions.object.block, (block, sentence, loop) => {
+            const [name, keyName = 'key', valueName = 'value'] = sentence.split(/, ?/gi);
+            if (keyName === valueName)
+                throw new Error('the key and value names must be different in block: ' + block);
+            return name && name in data && data[name] instanceof Object ? Object.keys(data[name]).map((key) => {
+                return loop.replace(this.expressions.object.replaces, (SubText, varName) => {
+                    if (keyName == varName)
+                        return key;
+                    else if (valueName == varName)
+                        return data[name][key];
+                });
+            }).join('') : block;
+        });
+        return Content;
+    }
+}
+export default Template;
+/*
+Variables:      ${name}
+Objects/Arrays: $(name, keyName, valueName) { the key is $keyName and value $valueName }
+Objects/Arrays: $(name) { the key is %key% and value %value% }
+Objects/Arrays: $(name, customKeyName, customValueName) {
+    the key is %customKeyName% and value %customValueName%
+}
+*/ 
+//# sourceMappingURL=Template.js.map

package/build/Template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Template.js","sourceRoot":"","sources":["../src/Template.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,SAAS,MAAM,0BAA0B,CAAC;AAEjD,MAAM,OAAO,QAAQ;IACpB,uDAAuD;IAC/C,MAAM,CAAC,WAAW,GAAG;QAC5B,QAAQ,EAAE,eAAe;QACzB,MAAM,EAAE;YACP,KAAK,EAAE,4BAA4B;YACnC,QAAQ,EAAE,WAAW;SACrB;KACD,CAAC;IACF;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAY,EAAE,IAAyB;QAC/D,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC;IAED;;;;;;OAMG;IACK,MAAM,CAAC,OAAO,CAAC,OAAe,EAAE,IAAyB;QAChE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;YACnE,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAa,EAAE,QAAgB,EAAE,IAAY,EAAE,EAAE;YAC1G,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7E,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,GAAG,KAAK,CAAC,CAAC;YAC3G,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACjG,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE;oBAC1E,IAAI,OAAO,IAAI,OAAO;wBAAE,OAAO,GAAG,CAAA;yBAC7B,IAAI,SAAS,IAAI,OAAO;wBAAE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;gBACvD,CAAC,CAAC,CAAC;YACJ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACrB,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IAChB,CAAC;;AASF,eAAe,QAAQ,CAAC;AACxB;;;;;;;EAOE"}

package/build/Utilities/Env.d.ts

@@ -0,0 +1,75 @@
+export declare class Env {
+    static get variables(): Env.EnvList;
+    /**
+     * Check if a file exists
+     * @param path - The path to the file
+     * @returns A promise that resolves to true if the file exists, false otherwise
+     */
+    static fileExists(path: string): Promise<boolean>;
+    /**
+     * Load the environment variables from the given path
+     * @param path - The path to the environment variables file
+     * @param options - Options to load the environment variables
+     * @returns The loaded environment variables as an object
+     * @throws Error if the environment variables file does not exist and cannot be created
+     * @throws Error if the environment variables file is not readable
+     */
+    static load(path: string, options?: Env.LoadOptions): Promise<Env.EnvList>;
+    static loadSync(path: string, options?: Env.LoadOptions): Env.EnvList;
+    /**
+     * Extract the environment variables from the given content
+     * @param content - The content to extract the environment variables from
+     * @param defaultEnv - The default environment variables to use if none are found
+     * @returns The extracted environment variables as an object
+     */
+    private static extractEnv;
+    /**
+     * Get the value of an environment variable
+     * @param key - The environment variable key
+     * @param options - Options to get the environment variable
+     * @param options.default - The default value to return if the environment variable is not set
+     * @param options.warning - Whether to show a warning if the environment variable is not set
+     * @returns The value of the environment variable or undefined if not set
+     */
+    static get(key: string, options: Env.getOptionsGranted): string;
+    static get(key: string, options: Env.getOptions): string | undefined;
+    /**
+     * Set an environment variable
+     * @param key - The environment variable key
+     * @param value - The value to set
+     */
+    static set(key: string, value: string): void;
+    /**
+     * Set multiple environment variables at once
+     * @param env - An object containing key-value pairs of environment variables
+     */
+    static setMany(env: Env.EnvList): void;
+    /**
+     * Delete an environment variable
+     * @param key - The environment variable key to delete
+     */
+    static delete(key: string): void;
+    /**
+     * Convert an EnvList to a .env-formatted string
+     * @param env - The environment variables object
+     * @returns A string in .env format
+     */
+    static toEnv(env: Env.EnvList): string;
+}
+export declare namespace Env {
+    interface EnvList {
+        [key: string]: string | undefined;
+    }
+    interface LoadOptions {
+        setEnv?: boolean;
+        defaultEnv?: EnvList;
+    }
+    interface getOptions {
+        default?: string;
+        warning?: boolean;
+    }
+    type getOptionsGranted = getOptions & {
+        default: string;
+    };
+}
+export default Env;