manageos 1.0.0 → 1.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +142 -0
  2. package/package.json +1 -1
package/README.md ADDED
@@ -0,0 +1,142 @@
1
+ # ManageOS
2
+
3
+ **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.
4
+
5
+ ---
6
+
7
+ ## 📦 Installation
8
+
9
+ Install via npm:
10
+
11
+ ```bash
12
+ npm install manageos
13
+ ```
14
+
15
+ or with Yarn:
16
+
17
+ ```bash
18
+ yarn add manageos
19
+ ```
20
+
21
+ ---
22
+
23
+ ## 🛠 Usage
24
+
25
+ ### Import the package
26
+
27
+ ```ts
28
+ import ManageOS from "manageos";
29
+ ```
30
+
31
+ ---
32
+
33
+ ### File System
34
+
35
+ ```ts
36
+ // Synchronous usage
37
+ const files = ManageOS.FileSystem.sync.listDirectory("C:\\Path\\To\\Folder");
38
+
39
+ // Asynchronous usage
40
+ const filesAsync = await ManageOS.FileSystem.async.listDirectory(
41
+ "C:\\Path\\To\\Folder"
42
+ );
43
+ ```
44
+
45
+ ---
46
+
47
+ ### Registry Editor
48
+
49
+ ```ts
50
+ await ManageOS.Regedit.createKey("HKCU\\Software\\MyApp");
51
+ await ManageOS.Regedit.setValue(
52
+ "HKCU\\Software\\MyApp",
53
+ "TestValue",
54
+ "REG_SZ",
55
+ "Hello World"
56
+ );
57
+ const registryData = await ManageOS.Regedit.listKey("HKCU\\Software\\MyApp");
58
+ await ManageOS.Regedit.deleteKey("HKCU\\Software\\MyApp");
59
+ ```
60
+
61
+ ---
62
+
63
+ ### Process Manager
64
+
65
+ ```ts
66
+ const processes = ManageOS.Taskmgr.sync.listProcesses();
67
+ const processCount = ManageOS.Taskmgr.sync.getProcessCount();
68
+
69
+ ManageOS.Taskmgr.sync.killByName("notepad.exe", true);
70
+ ```
71
+
72
+ ---
73
+
74
+ ### System Information
75
+
76
+ ```ts
77
+ const sysInfo = ManageOS.SystemInfo();
78
+ console.log(sysInfo.platform, sysInfo.architecture, sysInfo.cpus);
79
+ ```
80
+
81
+ ---
82
+
83
+ ### User Management
84
+
85
+ ```ts
86
+ const users = ManageOS.UserManager.listUsers();
87
+ const userInfo = ManageOS.UserManager.getUserInfo("Administrator");
88
+
89
+ ManageOS.UserManager.createUser("newuser", "password123");
90
+ ManageOS.UserManager.deleteUser("newuser");
91
+ ```
92
+
93
+ ---
94
+
95
+ ## 📚 API Overview
96
+
97
+ - **`ManageOS.FileSystem`** – File and directory operations (sync & async versions).
98
+ - **`ManageOS.Regedit`** – Create, delete, read, and modify Windows Registry keys and values.
99
+ - **`ManageOS.Taskmgr`** – Process listing, monitoring, and termination.
100
+ - **`ManageOS.SystemInfo`** – Retrieve system details such as OS version, CPU info, memory, and uptime.
101
+ - **`ManageOS.UserManager`** – Manage Windows user accounts and groups.
102
+
103
+ ---
104
+
105
+ ## ⚙ Requirements
106
+
107
+ - Node.js v18 or higher
108
+ - Windows operating system (registry and process management are Windows-specific)
109
+ - Administrative privileges for some operations
110
+
111
+ ---
112
+
113
+ ## 💡 Notes
114
+
115
+ - Many operations require elevated privileges (Administrator mode).
116
+ - Registry changes can affect system stability. Use with caution.
117
+ - This library wraps built-in Windows commands, so all outputs depend on system configuration.
118
+
119
+ ---
120
+
121
+ ## 🔧 Development
122
+
123
+ Clone the repository and install dependencies:
124
+
125
+ ```bash
126
+ git clone https://github.com/yourusername/manageos.git
127
+ cd manageos
128
+ npm install
129
+ npm run build
130
+ ```
131
+
132
+ Run in development mode:
133
+
134
+ ```bash
135
+ npm run dev
136
+ ```
137
+
138
+ ---
139
+
140
+ ## 📄 License
141
+
142
+ MIT License © Tiziano Tomas Luzi Ramos
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "manageos",
3
- "version": "1.0.0",
3
+ "version": "1.0.1",
4
4
  "description": "ManageOS",
5
5
  "main": "dist/index.cjs",
6
6
  "module": "dist/index.js",