actinium-nodevm/README.md

🔒 Secure Node.js virtual machine for the Gary8D ACTINIUM platform - enhanced security and performance

# @actiniumai/nodevm

<div align="center">
  <h3>🔒 Secure Node.js Virtual Machine</h3>
  <p>A secure Node.js virtual machine for the Gary8D ACTINIUM platform</p>
  <p>
    <img src="https://img.shields.io/badge/Gary8D-ACTINIUM-3B82F6?style=flat-square&logo=javascript" alt="Gary8D ACTINIUM" />
    <img src="https://img.shields.io/npm/v/@actiniumai/nodevm?style=flat-square&color=10B981" alt="npm version" />
    <img src="https://img.shields.io/badge/security-enhanced-10B981?style=flat-square" alt="Security Enhanced" />
  </p>
</div>

## 🚀 Installation

```bash
npm install @actiniumai/nodevm
# or
yarn add @actiniumai/nodevm
```

## 📖 Usage

### Basic Usage

```javascript
import { NodeVM, VM } from '@actiniumai/nodevm'

// Create a NodeVM instance
const vm = new NodeVM({
    console: 'inherit',
    sandbox: {},
    require: {
        external: false,
        builtin: ['fs', 'path']
    }
})

// Run code
const result = vm.run('module.exports = 1 + 1')
console.log(result) // 2
```

### 🛡️ ACTINIUM Secure VM

```javascript
import { ActiniumVM, ActiniumSecureVM } from '@actiniumai/nodevm'

// Use ACTINIUM's pre-configured secure VM
const vm = new ActiniumVM({
    timeout: 5000 // Override default timeout
})

// For simple code execution
const secureVm = new ActiniumSecureVM()
const result = secureVm.run('1 + 1')
console.log(result) // 2
```

## ✨ Features

- 🔒 **Secure Sandboxing**: Advanced isolation for code execution
- ⏱️ **Timeout Protection**: Built-in execution time limits
- 🎯 **ACTINIUM Optimized**: Pre-configured for Gary8D platform needs
- 🔗 **Full Compatibility**: Drop-in replacement for vm2
- 📘 **TypeScript Ready**: Complete type definitions included
- 🚀 **High Performance**: Optimized for production workloads

## 🏗️ Built for Gary8D

This package is specifically designed for the Gary8D ACTINIUM AI platform, providing:

- Enhanced security configurations
- Platform-specific optimizations  
- Seamless integration with ACTINIUM workflows
- Production-ready defaults

## 📜 License

See LICENSE.md in the root of the Gary8D project.

---

<div align="center">
  <p>Made with ❤️ for the Gary8D ACTINIUM platform</p>
  <p><strong>🔵 Primary: #3B82F6 • 🟢 Accent: #10B981 • ⚫ Secondary: #6B7280</strong></p>
</div>