manageos 1.0.2 → 2.0.2

package/dist/windowsupdate.js

@@ -0,0 +1,120 @@
+import { exec, execSync } from "child_process";
+// Parser por defecto: intenta parsear a JSON, si falla retorna texto crudo
+function defaultParser(raw) {
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return raw;
+    }
+}
+function ensurePSWindowsUpdate(options = {}) {
+    const { onInstallStart, onInstallSuccess, onInstallError, installCommand = 'powershell -Command "Install-Module -Name PSWindowsUpdate -Force -Confirm:$false"', } = options;
+    return new Promise((resolve, reject) => {
+        exec('powershell -Command "Get-Module -ListAvailable PSWindowsUpdate"', (error, stdout) => {
+            if (error)
+                return reject(error);
+            if (!stdout || !stdout.includes("PSWindowsUpdate")) {
+                if (onInstallStart)
+                    onInstallStart();
+                exec(installCommand, (installError) => {
+                    if (installError) {
+                        if (onInstallError)
+                            onInstallError(installError);
+                        return reject(installError);
+                    }
+                    if (onInstallSuccess)
+                        onInstallSuccess();
+                    resolve();
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+class Async {
+    static async listInstalled(parser = defaultParser) {
+        return new Promise((resolve, reject) => {
+            exec('powershell -Command "Get-HotFix | ConvertTo-Json -Compress"', (error, stdout, stderr) => {
+                if (error)
+                    return reject(error);
+                resolve(parser(stdout || stderr || ""));
+            });
+        });
+    }
+    static async check(ensureOptions, parser = defaultParser) {
+        await ensurePSWindowsUpdate(ensureOptions);
+        return new Promise((resolve, reject) => {
+            exec('powershell -Command "Get-WindowsUpdate | ConvertTo-Json -Compress"', (error, stdout, stderr) => {
+                if (error)
+                    return reject(error);
+                resolve(parser(stdout || stderr || ""));
+            });
+        });
+    }
+    static async install(ensureOptions, parser = defaultParser) {
+        await ensurePSWindowsUpdate(ensureOptions);
+        return new Promise((resolve, reject) => {
+            exec('powershell -Command "Install-WindowsUpdate -AcceptAll -AutoReboot | ConvertTo-Json -Compress"', (error, stdout, stderr) => {
+                if (error)
+                    return reject(error);
+                resolve(parser(stdout || stderr || ""));
+            });
+        });
+    }
+    static async uninstall(updateId, ensureOptions) {
+        await ensurePSWindowsUpdate(ensureOptions);
+        return new Promise((resolve, reject) => {
+            exec(`powershell -Command "wusa /uninstall /kb:${updateId} /quiet /norestart"`, (error, stdout, stderr) => {
+                if (error)
+                    return reject(error);
+                resolve(stdout || stderr);
+            });
+        });
+    }
+}
+class Sync {
+    static listInstalled(parser = defaultParser) {
+        const raw = execSync('powershell -Command "Get-HotFix | ConvertTo-Json -Compress"').toString();
+        return parser(raw);
+    }
+    static ensure(options = {}) {
+        const { onInstallStart, onInstallSuccess, onInstallError, installCommand = 'powershell -Command "Install-Module -Name PSWindowsUpdate -Force -Confirm:$false"', } = options;
+        const result = execSync('powershell -Command "Get-Module -ListAvailable PSWindowsUpdate"').toString();
+        if (!result.includes("PSWindowsUpdate")) {
+            if (onInstallStart)
+                onInstallStart();
+            try {
+                execSync(installCommand);
+                if (onInstallSuccess)
+                    onInstallSuccess();
+            }
+            catch (err) {
+                if (onInstallError)
+                    onInstallError(err);
+                throw err;
+            }
+        }
+    }
+    static check(options, parser = defaultParser) {
+        this.ensure(options);
+        const raw = execSync('powershell -Command "Get-WindowsUpdate | ConvertTo-Json -Compress"').toString();
+        return parser(raw);
+    }
+    static install(options, parser = defaultParser) {
+        this.ensure(options);
+        const raw = execSync('powershell -Command "Install-WindowsUpdate -AcceptAll -AutoReboot | ConvertTo-Json -Compress"').toString();
+        return parser(raw);
+    }
+    static uninstall(updateId, options) {
+        this.ensure(options);
+        return execSync(`powershell -Command "wusa /uninstall /kb:${updateId} /quiet /norestart"`).toString();
+    }
+}
+export default class WindowsUpdate {
+    static Sync = Sync;
+    static Async = Async;
+}
+//# sourceMappingURL=windowsupdate.js.map

package/dist/windowsupdate.js.map

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

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "manageos",
-  "version": "1.0.2",
+  "version": "2.0.2",
   "description": "ManageOS",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "dev": "tsx watch src/index.ts",
-    "build": "tsc"
+    "build": "tsc",
+    "build-doc": "npx typedoc"
   },
   "keywords": [],
   "author": "Tiziano Tomas Luzi Ramos",
@@ -18,16 +19,24 @@
   ],
   "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-windows": "^0.1.6",
+    "@types/screenshot-desktop": "^1.15.0",
+    "@types/systeminformation": "^3.23.1",
     "deasync": "^0.1.30",
     "loudness": "^0.4.2",
     "node-notifier": "^10.0.1",
     "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"
   }
 }

package/README.md

@@ -1,142 +0,0 @@
-# ManageOS
-
-**ManageOS** is a Node.js library that provides a set of tools to manage operating system resources and settings on Windows systems. It offers utilities for registry editing, process management, file system operations, system information retrieval, and user account management.
-
----
-
-## 📦 Installation
-
-Install via npm:
-
-```bash
-npm install manageos
-```
-
-or with Yarn:
-
-```bash
-yarn add manageos
-```
-
----
-
-## 🛠 Usage
-
-### Import the package
-
-```ts
-import ManageOS from "manageos";
-```
-
----
-
-### File System
-
-```ts
-// Synchronous usage
-const files = ManageOS.FileSystem.sync.listDirectory("C:\\Path\\To\\Folder");
-
-// Asynchronous usage
-const filesAsync = await ManageOS.FileSystem.async.listDirectory(
-  "C:\\Path\\To\\Folder"
-);
-```
-
----
-
-### Registry Editor
-
-```ts
-await ManageOS.Regedit.createKey("HKCU\\Software\\MyApp");
-await ManageOS.Regedit.setValue(
-  "HKCU\\Software\\MyApp",
-  "TestValue",
-  "REG_SZ",
-  "Hello World"
-);
-const registryData = await ManageOS.Regedit.listKey("HKCU\\Software\\MyApp");
-await ManageOS.Regedit.deleteKey("HKCU\\Software\\MyApp");
-```
-
----
-
-### Process Manager
-
-```ts
-const processes = ManageOS.Taskmgr.sync.listProcesses();
-const processCount = ManageOS.Taskmgr.sync.getProcessCount();
-
-ManageOS.Taskmgr.sync.killByName("notepad.exe", true);
-```
-
----
-
-### System Information
-
-```ts
-const sysInfo = ManageOS.SystemInfo();
-console.log(sysInfo.platform, sysInfo.architecture, sysInfo.cpus);
-```
-
----
-
-### User Management
-
-```ts
-const users = ManageOS.UserManager.listUsers();
-const userInfo = ManageOS.UserManager.getUserInfo("Administrator");
-
-ManageOS.UserManager.createUser("newuser", "password123");
-ManageOS.UserManager.deleteUser("newuser");
-```
-
----
-
-## 📚 API Overview
-
-- **`ManageOS.FileSystem`** – File and directory operations (sync & async versions).
-- **`ManageOS.Regedit`** – Create, delete, read, and modify Windows Registry keys and values.
-- **`ManageOS.Taskmgr`** – Process listing, monitoring, and termination.
-- **`ManageOS.SystemInfo`** – Retrieve system details such as OS version, CPU info, memory, and uptime.
-- **`ManageOS.UserManager`** – Manage Windows user accounts and groups.
-
----
-
-## ⚙ Requirements
-
-- Node.js v18 or higher
-- Windows operating system (registry and process management are Windows-specific)
-- Administrative privileges for some operations
-
----
-
-## 💡 Notes
-
-- Many operations require elevated privileges (Administrator mode).
-- Registry changes can affect system stability. Use with caution.
-- This library wraps built-in Windows commands, so all outputs depend on system configuration.
-
----
-
-## 🔧 Development
-
-Clone the repository and install dependencies:
-
-```bash
-git clone https://github.com/yourusername/manageos.git
-cd manageos
-npm install
-npm run build
-```
-
-Run in development mode:
-
-```bash
-npm run dev
-```
-
----
-
-## 📄 License
-
-MIT License © Tiziano Tomas Luzi Ramos