manageos 2.3.1 → 2.3.4

package/README.md

@@ -0,0 +1,147 @@
+# 🧠 ManageOS
+
+**ManageOS** is a module for **Node.js**, **TypeScript**, and
+**JavaScript** that allows you to **manage, audit, and automate
+operating system tasks** on Windows (and other environments like
+Android) through a simple and powerful API.
+
+📘 **Official Documentation:** [https://tizianoluziramos.github.io/ManageOS](https://tizianoluziramos.github.io/ManageOS)
+
+---
+
+## 🚀 Main Features
+
+- 🪟 Advanced Windows OS management.
+- 🔒 Control of **BitLocker**, **Antivirus**, and **Audit Policies**.
+- 🧾 Administration of **event logs** and **certificates**.
+- 🔉 Control of **audio**, **camera**, **clipboard**, and more.
+- 🧠 Unified API for both **Synchronous (Sync)** and **Asynchronous
+  (Async)** functions.
+- 🤖 Extended support for **Android** (ADB and Fastboot).
+- 🔐 Built-in **encryption and hashing** tools.
+- 🪶 Fully written in **TypeScript** with strong typing.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install manageos
+# or
+yarn add manageos
+```
+
+---
+
+## 🧰 Basic Usage Example
+
+### Synchronous
+
+```ts
+import { BitLocker } from "manageos";
+
+BitLocker.Sync.lockDrive("C:");
+console.log("Drive C locked with BitLocker.");
+```
+
+### Asynchronous
+
+```ts
+import { AuditPolicy } from "manageos";
+
+await AuditPolicy.Async.enable("Logon/Logoff");
+console.log("Audit policy enabled.");
+```
+
+---
+
+## 📚 Available Modules
+
+Module Description
+
+---
+
+`Antivirus` Controls and verifies Windows antivirus status.
+`Audio` Manages volume, devices, and audio drivers.
+`AuditPolicy` Manages system audit policies.
+`BitLocker` Controls drive encryption via BitLocker.
+`Camera` Accesses and manages system camera availability.
+`Certificates` Manages system certificates.
+`Clipboard` Reads and writes from/to the system clipboard.
+`Encryption` Encrypts, decrypts, generates, and stores keys.
+`EventLogs` Reads and exports Event Viewer logs.
+`Android` Executes ADB and Fastboot commands for Android devices.
+
+---
+
+## 🔐 Encryption Example
+
+```ts
+import { Encryption } from "manageos";
+
+// Initialize a key
+Encryption.init("my_secret_key");
+
+// Encrypt text
+const { encryptedData, iv } = Encryption.encrypt("Hello world");
+
+// Decrypt text
+const text = Encryption.decrypt(encryptedData, iv);
+console.log(text); // "Hello world"
+```
+
+---
+
+## 🧩 Consistent API
+
+All modules follow the same structure:
+
+```ts
+<Module>.Sync.<function>()
+<Module>.Async.<function>()
+```
+
+This makes **ManageOS** easy to integrate into any workflow without
+worrying about promise or blocking execution compatibility.
+
+---
+
+## 🛠️ Requirements
+
+- Windows 10 / 11 or higher
+- Node.js \>= 18
+- Administrative privileges for certain functions
+
+---
+
+## 📖 Documentation
+
+Check out the full documentation on the official repository:
+
+👉 [GitHub -
+tizianoluziramos/ManageOS](https://github.com/tizianoluziramos/ManageOS)
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome!\
+Fork the project, create a branch with your changes, and submit a pull
+request.
+
+```bash
+git clone https://github.com/tizianoluziramos/ManageOS.git
+cd ManageOS
+npm install
+npm run build
+```
+
+---
+
+## 🧾 License
+
+This project is licensed under the **MIT License**.
+
+---
+
+### ✨ Developed by [Tiziano Luzi Ramos](https://github.com/tizianoluziramos)

package/package.json

@@ -1,46 +1,26 @@
-{
-  "name": "manageos",
-  "version": "2.3.1",
-  "description": "ManageOS",
-  "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "build": "set PATH=C:\\MinGW\\bin;%PATH% && gcc -m32 src/Mouse/mouse.c -o src/Mouse/mouse.exe -mwindows && tsc && xcopy src\\*.exe dist /S /Y /I && xcopy src\\*.dll dist /S /Y /I && del src\\Mouse\\mouse.exe && npx typedoc --options typedoc.json",
-    "clean": "rmdir /S /Q dist && rmdir /S /Q docs"
-  },
-  "keywords": [],
-  "author": "Tiziano Tomas Luzi Ramos",
-  "license": "MIT",
-  "type": "module",
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "devDependencies": {
-    "@types/node": "^24.6.1",
-    "typedoc": "^0.28.13",
-    "typedoc-plugin-extras": "^4.0.1",
-    "typedoc-umlclass": "^0.10.2",
-    "typescript": "^5.6.3"
-  },
-  "dependencies": {
-    "@types/deasync": "^0.1.5",
-    "@types/node-notifier": "^8.0.5",
-    "@types/node-webcam": "^0.8.3",
-    "@types/node-windows": "^0.1.6",
-    "@types/screenshot-desktop": "^1.15.0",
-    "@types/systeminformation": "^3.23.1",
-    "deasync": "^0.1.30",
-    "loudness": "^0.4.2",
-    "node-mic": "^1.0.1",
-    "node-notifier": "^10.0.1",
-    "node-webcam": "^0.8.2",
-    "node-windows": "^1.0.0-beta.8",
-    "screenshot-desktop": "^1.15.2",
-    "systeminformation": "^5.27.10",
-    "typedoc-material-theme": "^1.4.0",
-    "win-screen-resolution": "^3.0.2"
-  }
-}
+{
+  "name": "manageos",
+  "version": "2.3.4",
+  "description": "ManageOS",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "workspaces": [
+    "packages/*"
+  ],
+  "keywords": [
+    "manageos",
+    "windows",
+    "linux",
+    "mac",
+    "system"
+  ],
+  "author": "Tiziano Tomas Luzi Ramos",
+  "license": "MIT",
+  "scripts": {
+    "publish": "npm run build --workspaces && npm publish --access=public --workspaces && npm publish --access=public",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "dependencies": {},
+  "devDependencies": {}
+}

package/packages/windows/BUILD_TOOLS/build.bat

@@ -0,0 +1,55 @@
+@echo off
+setlocal enabledelayedexpansion
+
+REM -----------------------
+REM Functional build from cmd.exe using new syntax
+REM -----------------------
+
+REM Configure PATH
+set "PATH=C:\MinGW\bin;%PATH%"
+
+REM Save build.bat directory path
+set "BUILD_DIR=%~dp0"
+cd /d "%BUILD_DIR%\.."
+
+REM Absolute path to commands.json
+set "JSON_PATH=%BUILD_DIR%commands.json"
+
+REM Temporary file for commands
+set "TEMP_FILE=%TEMP%\build_commands.txt"
+if exist "%TEMP_FILE%" del "%TEMP_FILE%"
+
+REM Create PowerShell script on a single line
+powershell -NoProfile -Command ^
+  "$commands = (Get-Content '%JSON_PATH%' | ConvertFrom-Json).commands; $commands | ForEach-Object { Write-Output ($_.pre + '§' + $_.command + '§' + $_.after) }" ^
+  > "%TEMP_FILE%"
+
+REM Build command chain with && ^
+set "CMD_CHAIN="
+
+for /f "usebackq tokens=1,2,3 delims=§" %%A in ("%TEMP_FILE%") do (
+    if defined CMD_CHAIN (
+        set "CMD_CHAIN=!CMD_CHAIN! && ^ echo %%A && %%B && echo %%C"
+    ) else (
+        set "CMD_CHAIN=echo %%A && %%B && echo %%C"
+    )
+)
+
+REM Show final command
+echo Command to execute:
+echo !CMD_CHAIN!
+echo.
+
+REM Execute everything
+cmd /v:on /c "!CMD_CHAIN!"
+
+REM Check exit code
+if errorlevel 1 (
+    echo.
+    echo BUILD FAILED (exit code %ERRORLEVEL%)
+    exit /b %ERRORLEVEL%
+)
+
+echo.
+echo BUILD SUCCESSFUL
+pause

package/packages/windows/BUILD_TOOLS/clean.bat

@@ -0,0 +1,14 @@
+@echo off
+REM =============================
+REM Clean Script
+REM =============================
+
+echo Deleting dist folder...
+if exist dist rmdir /S /Q dist
+
+echo Deleting docs folder...
+if exist docs rmdir /S /Q docs
+
+echo.
+echo CLEANUP COMPLETED
+pause

package/packages/windows/BUILD_TOOLS/commands.json

@@ -0,0 +1,54 @@
+{
+  "commands": [
+    {
+      "pre": "Compiling Mouse Controller...",
+      "command": "gcc -m32 src\\Mouse\\mouse.c -o src\\Mouse\\mouse.exe -mwindows",
+      "after": "Mouse Controller compiled."
+    },
+    {
+      "pre": "Compiling Keyboard Controller...",
+      "command": "gcc -m32 src\\Keyboard\\keyboard.c -o src\\Keyboard\\keyboard.exe -mwindows",
+      "after": "Keyboard Controller compiled."
+    },
+    {
+      "pre": "Compiling HTTP Server...",
+      "command": "gcc src\\Server\\HTTP\\http.c -o src\\Server\\HTTP\\http.exe -lws2_32",
+      "after": "HTTP Server compiled."
+    },
+    {
+      "pre": "Compiling TypeScript...",
+      "command": "tsc",
+      "after": "TypeScript compiled."
+    },
+    {
+      "pre": "Copying executables...",
+      "command": "xcopy src\\*.exe dist /S /Y /I",
+      "after": "Executables copied."
+    },
+    {
+      "pre": "Copying libraries...",
+      "command": "xcopy src\\*.dll dist /S /Y /I",
+      "after": "Libraries copied."
+    },
+    {
+      "pre": "Deleting temporary mouse.exe...",
+      "command": "del /Q src\\Mouse\\mouse.exe",
+      "after": "mouse.exe deleted."
+    },
+    {
+      "pre": "Deleting temporary keyboard.exe...",
+      "command": "del /Q src\\Keyboard\\keyboard.exe",
+      "after": "keyboard.exe deleted."
+    },
+    {
+      "pre": "Deleting temporary http.exe...",
+      "command": "del /Q src\\Server\\HTTP\\http.exe",
+      "after": "http.exe deleted."
+    },
+    {
+      "pre": "Generating documentation with Typedoc...",
+      "command": "npx typedoc --options typedoc.json --json docs/openapi.json",
+      "after": "Documentation generated."
+    }
+  ]
+}

package/packages/windows/dist/Keyboard/index.d.ts

@@ -0,0 +1,24 @@
+declare class Async {
+    static press(key: string): Promise<boolean>;
+    static release(key: string): Promise<boolean>;
+    static type(text: string): Promise<boolean>;
+    static repeat(key: string, count: number): Promise<boolean>;
+    static isKeyDown(key: string): Promise<boolean>;
+    static block(): Promise<boolean>;
+    static unblock(): Promise<boolean>;
+}
+declare class Sync {
+    static press(key: string): boolean;
+    static release(key: string): boolean;
+    static type(text: string): boolean;
+    static repeat(key: string, count: number): boolean;
+    static isKeyDown(key: string): boolean;
+    static block(): boolean;
+    static unblock(): boolean;
+}
+export default class Keyboard {
+    static readonly Async: typeof Async;
+    static readonly Sync: typeof Sync;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

package/packages/windows/dist/Keyboard/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Keyboard/index.ts"],"names":[],"mappings":"AAiBA,cAAM,KAAK;IACT,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU3C,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU7C,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU3C,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU3D,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/C,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAUhC,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CASnC;AAED,cAAM,IAAI;IACR,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMlC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMpC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAMlC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAQlD,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMtC,MAAM,CAAC,KAAK,IAAI,OAAO;IAMvB,MAAM,CAAC,OAAO,IAAI,OAAO;CAK1B;AAED,MAAM,CAAC,OAAO,OAAO,QAAQ;IAC3B,gBAAuB,KAAK,eAAS;IACrC,gBAAuB,IAAI,cAAQ;CACpC"}

package/packages/windows/dist/Keyboard/index.js

@@ -0,0 +1,128 @@
+import { exec, execSync } from "child_process";
+import path from "path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const keyboardExe = path.join(__dirname, "keyboard.exe");
+function parseJSON(stdout) {
+    try {
+        return JSON.parse(stdout.trim());
+    }
+    catch (e) {
+        throw new Error("Invalid JSON from keyboard.exe: " + stdout);
+    }
+}
+class Async {
+    static press(key) {
+        return new Promise((resolve, reject) => {
+            exec(`"${keyboardExe}" press ${key}`, (error, stdout) => {
+                if (error)
+                    return reject(error);
+                const result = parseJSON(stdout);
+                resolve(result.success || false);
+            });
+        });
+    }
+    static release(key) {
+        return new Promise((resolve, reject) => {
+            exec(`"${keyboardExe}" release ${key}`, (error, stdout) => {
+                if (error)
+                    return reject(error);
+                const result = parseJSON(stdout);
+                resolve(result.success || false);
+            });
+        });
+    }
+    static type(text) {
+        return new Promise((resolve, reject) => {
+            exec(`"${keyboardExe}" type "${text}"`, (error, stdout) => {
+                if (error)
+                    return reject(error);
+                const result = parseJSON(stdout);
+                resolve(result.success || false);
+            });
+        });
+    }
+    static repeat(key, count) {
+        return new Promise((resolve, reject) => {
+            exec(`"${keyboardExe}" repeat ${key} ${count}`, (error, stdout) => {
+                if (error)
+                    return reject(error);
+                const result = parseJSON(stdout);
+                resolve(result.success || false);
+            });
+        });
+    }
+    static isKeyDown(key) {
+        return new Promise((resolve, reject) => {
+            exec(`"${keyboardExe}" iskeydown ${key}`, (error, stdout) => {
+                if (error)
+                    return reject(error);
+                const result = parseJSON(stdout);
+                resolve(result.keydown || false);
+            });
+        });
+    }
+    static block() {
+        return new Promise((resolve, reject) => {
+            exec(`"${keyboardExe}" block`, (error, stdout) => {
+                if (error)
+                    return reject(error);
+                const result = parseJSON(stdout);
+                resolve(result.success || false);
+            });
+        });
+    }
+    static unblock() {
+        return new Promise((resolve, reject) => {
+            exec(`"${keyboardExe}" unblock`, (error, stdout) => {
+                if (error)
+                    return reject(error);
+                const result = parseJSON(stdout);
+                resolve(result.success || false);
+            });
+        });
+    }
+}
+class Sync {
+    static press(key) {
+        const stdout = execSync(`"${keyboardExe}" press ${key}`).toString();
+        const result = parseJSON(stdout);
+        return result.success || false;
+    }
+    static release(key) {
+        const stdout = execSync(`"${keyboardExe}" release ${key}`).toString();
+        const result = parseJSON(stdout);
+        return result.success || false;
+    }
+    static type(text) {
+        const stdout = execSync(`"${keyboardExe}" type "${text}"`).toString();
+        const result = parseJSON(stdout);
+        return result.success || false;
+    }
+    static repeat(key, count) {
+        const stdout = execSync(`"${keyboardExe}" repeat ${key} ${count}`).toString();
+        const result = parseJSON(stdout);
+        return result.success || false;
+    }
+    static isKeyDown(key) {
+        const stdout = execSync(`"${keyboardExe}" iskeydown ${key}`).toString();
+        const result = parseJSON(stdout);
+        return result.keydown || false;
+    }
+    static block() {
+        const stdout = execSync(`"${keyboardExe}" block`).toString();
+        const result = parseJSON(stdout);
+        return result.success || false;
+    }
+    static unblock() {
+        const stdout = execSync(`"${keyboardExe}" unblock`).toString();
+        const result = parseJSON(stdout);
+        return result.success || false;
+    }
+}
+export default class Keyboard {
+    static Async = Async;
+    static Sync = Sync;
+}
+//# sourceMappingURL=index.js.map

package/packages/windows/dist/Keyboard/index.js.map

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

package/packages/windows/dist/Server/FTP.d.ts

@@ -0,0 +1,28 @@
+import FtpServer, { FtpServerOptions } from "ftp-srv";
+export interface FTPOptions {
+    url?: string;
+    port?: number;
+    host?: string;
+    folder: string;
+    username?: string;
+    password?: string;
+    pasvUrl?: string;
+    anonymous?: boolean;
+    onLogin?: (username: string, password: string) => boolean | Promise<boolean>;
+    onStart?: (server: FtpServer) => void;
+    onError?: (error: Error) => void;
+    onConnection?: (username: string, address: string) => void;
+    ftpOptions?: Partial<FtpServerOptions>;
+}
+declare class Async {
+    static start(options: FTPOptions): Promise<FtpServer>;
+}
+declare class Sync {
+    static start(options: FTPOptions): FtpServer | null;
+}
+export default class FTP {
+    static readonly Async: typeof Async;
+    static readonly Sync: typeof Sync;
+}
+export {};
+//# sourceMappingURL=FTP.d.ts.map

package/packages/windows/dist/Server/FTP.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FTP.d.ts","sourceRoot":"","sources":["../../src/Server/FTP.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEtD,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IAGpB,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7E,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAG3D,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACxC;AAQD,cAAM,KAAK;IACT,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;CAkEtD;AAED,cAAM,IAAI;IACR,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI;CA6DpD;AAED,MAAM,CAAC,OAAO,OAAO,GAAG;IACtB,gBAAuB,KAAK,eAAS;IACrC,gBAAuB,IAAI,cAAQ;CACpC"}

package/packages/windows/dist/Server/FTP.js

@@ -0,0 +1,119 @@
+import FtpServer from "ftp-srv";
+class Async {
+    static start(options) {
+        return new Promise((resolve, reject) => {
+            try {
+                const url = options.url ??
+                    `ftp://${options.host ?? "0.0.0.0"}:${options.port ?? 21}`;
+                const server = new FtpServer({
+                    url,
+                    anonymous: options.anonymous ?? false,
+                    pasv_url: options.pasvUrl ?? options.host ?? "127.0.0.1",
+                    ...options.ftpOptions,
+                });
+                server.on("login", async (data, resolveLogin, rejectLogin) => {
+                    try {
+                        let authorized = false;
+                        if (typeof options.onLogin === "function") {
+                            authorized = await options.onLogin(data.username, data.password);
+                        }
+                        else {
+                            authorized =
+                                data.username === options.username &&
+                                    data.password === options.password;
+                        }
+                        if (authorized) {
+                            resolveLogin({ root: options.folder });
+                        }
+                        else {
+                            rejectLogin(new Error("Invalid credentials"));
+                        }
+                    }
+                    catch (err) {
+                        rejectLogin(err);
+                    }
+                });
+                server.on("login", (connection) => {
+                    if (options.onConnection) {
+                        options.onConnection(connection.username ?? "unknown", connection.connection.ip);
+                    }
+                });
+                server
+                    .listen()
+                    .then(() => {
+                    if (options.onStart)
+                        options.onStart(server);
+                    resolve(server);
+                })
+                    .catch((err) => {
+                    if (options.onError)
+                        options.onError(err);
+                    reject(err);
+                });
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+    }
+}
+class Sync {
+    static start(options) {
+        try {
+            const url = options.url ??
+                `ftp://${options.host ?? "0.0.0.0"}:${options.port ?? 21}`;
+            const server = new FtpServer({
+                url,
+                anonymous: options.anonymous ?? false,
+                pasv_url: options.pasvUrl ?? options.host ?? "127.0.0.1",
+                ...options.ftpOptions,
+            });
+            server.on("login", async (data, resolveLogin, rejectLogin) => {
+                try {
+                    let authorized = false;
+                    if (typeof options.onLogin === "function") {
+                        authorized = await options.onLogin(data.username, data.password);
+                    }
+                    else {
+                        authorized =
+                            data.username === options.username &&
+                                data.password === options.password;
+                    }
+                    if (authorized) {
+                        resolveLogin({ root: options.folder });
+                    }
+                    else {
+                        rejectLogin(new Error("Invalid credentials"));
+                    }
+                }
+                catch (err) {
+                    rejectLogin(err);
+                }
+            });
+            server.on("login", (connection) => {
+                if (options.onConnection) {
+                    options.onConnection(connection.username ?? "unknown", connection.connection.ip);
+                }
+            });
+            server
+                .listen()
+                .then(() => {
+                if (options.onStart)
+                    options.onStart(server);
+            })
+                .catch((err) => {
+                if (options.onError)
+                    options.onError(err);
+            });
+            return server;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+export default class FTP {
+    static Async = Async;
+    static Sync = Sync;
+}
+//# sourceMappingURL=FTP.js.map