feat: Create Node.js wrapper for proot

.npmignore

@@ -0,0 +1,25 @@
+# CI/CD and project config
+.github/
+.gitlab-ci.yml
+.dockerignore
+sonar-project.properties
+.mailmap
+AUTHORS
+HACKING.rst
+ISSUE_TEMPLATE
+
+# Documentation
+doc/
+
+# Test files
+test/
+
+# Source build artifacts (the src/proot binary IS needed)
+src/**/*.o
+src/loader/loader
+src/loader/loader-m32
+src/cli/care
+src/cli/care.o
+
+# Vagrant config
+vagrant/

example.js

@@ -0,0 +1,30 @@
+const proot = require('./index');
+const fs = require('fs');
+const path = require('path');
+
+const testFile = 'test-file.txt';
+const absoluteTestFile = path.resolve(__dirname, testFile);
+const boundPath = '/tmp/bound-file.txt'; // Using /tmp directory
+
+// 1. Create a dummy file.
+fs.writeFileSync(testFile, 'This is a test file.');
+console.log(`Created a temporary file: ${absoluteTestFile}`);
+
+
+console.log(`\n--- Running proot to bind '${absoluteTestFile}' to '${boundPath}' and list it ---`);
+const args = ['-b', `${absoluteTestFile}:${boundPath}`, 'ls', '-l', boundPath];
+const prootProcess = proot(args);
+
+prootProcess.on('exit', (code) => {
+  console.log(`\nProot process exited with code ${code}.`);
+
+  // Clean up the dummy file.
+  fs.unlinkSync(testFile);
+  console.log(`Cleaned up temporary file: ${testFile}`);
+
+  if (code === 0) {
+    console.log('\n✅ Example ran successfully!');
+  } else {
+    console.error('\n❌ Example failed. The proot command returned a non-zero exit code.');
+  }
+});

index.js

@@ -0,0 +1,28 @@
+const { spawn } = require('child_process');
+const path = require('path');
+
+// Resolve the path to the proot executable, which should be in src/ after compilation.
+const prootExecutable = path.resolve(__dirname, 'src', 'proot');
+
+/**
+ * Executes a command within the proot environment.
+ * @param {string[]} args - An array of arguments to pass to proot.
+ * @returns {import('child_process').ChildProcess} The spawned child process.
+ */
+function proot(args) {
+  if (!Array.isArray(args)) {
+    throw new Error('Arguments must be provided as an array of strings.');
+  }
+
+  const child = spawn(prootExecutable, args, {
+    stdio: 'inherit' // Pipe stdin, stdout, stderr to the parent process
+  });
+
+  child.on('error', (err) => {
+    console.error('Failed to start proot process:', err);
+  });
+
+  return child;
+}
+
+module.exports = proot;

package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@soymaycol/proot",
+  "version": "1.0.0",
+  "description": "A Node.js wrapper for proot, allowing chroot, mount --bind, and binfmt_misc without privilege/setup.",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "example.js",
+    "README.rst",
+    "CHANGELOG.rst",
+    "COPYING",
+    "src/"
+  ],
+  "scripts": {
+    "install": "make -C src proot",
+    "test": "node example.js"
+  },
+  "author": {
+    "name": "SoyMaycol",
+    "url": "https://github.com/SoySapo6"
+  },
+  "license": "GPL-2.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SoySapo6/proot.git"
+  },
+  "keywords": [
+    "proot",
+    "chroot",
+    "mount",
+    "binfmt_misc",
+    "sandbox",
+    "jail"
+  ]
+}

src/tracee/tracee.c

@@ -35,6 +35,7 @@
 
 #include "tracee/tracee.h"
 #include "tracee/reg.h"
+#include "tracee/mem.h"
 #include "path/binding.h"
 #include "syscall/sysnum.h"
 #include "tracee/event.h"