@joai/warps-vm-node 1.0.0-beta.10

package/README.md

@@ -0,0 +1,59 @@
+# @joai/warps-vm-node
+
+Node.js VM runtime for Warps SDK output transformations. Safely executes transformation code using vm2 in a sandboxed environment.
+
+## Installation
+
+```bash
+npm install @joai/warps-vm-node
+```
+
+**Note:** This package requires `vm2` as an optional dependency. Install it separately:
+
+```bash
+npm install vm2
+```
+
+## Usage
+
+```typescript
+import { createNodeTransformRunner } from '@joai/warps-vm-node'
+import { WarpClient } from '@joai/warps'
+
+const config = {
+  env: 'mainnet',
+  transform: {
+    runner: createNodeTransformRunner(),
+  },
+  // ... rest of config
+}
+
+const client = new WarpClient(config, { chains: [...] })
+```
+
+## Features
+
+- Safe code execution using vm2
+- Sandboxed environment
+- Supports arrow functions, regular functions, and expressions
+- Error handling and timeout protection
+
+## How It Works
+
+The Node.js VM uses vm2 to execute transformation code in an isolated sandbox, preventing access to Node.js globals and ensuring security.
+
+## Example Transformation
+
+```typescript
+// Warp output transformation
+const transform = (results) => {
+  return {
+    value: results.amount * 2,
+    formatted: `$${results.amount.toFixed(2)}`
+  }
+}
+```
+
+## Security
+
+The vm2 sandbox provides isolation from the Node.js runtime, preventing unauthorized access to system resources.

package/dist/runInVm.d.cts

@@ -0,0 +1,6 @@
+import { TransformRunner } from '@joai/warps';
+
+declare const runInVm: (code: string, results: any) => Promise<any>;
+declare const createNodeTransformRunner: () => TransformRunner;
+
+export { createNodeTransformRunner, runInVm };

package/dist/runInVm.d.ts

@@ -0,0 +1,6 @@
+import { TransformRunner } from '@joai/warps';
+
+declare const runInVm: (code: string, results: any) => Promise<any>;
+declare const createNodeTransformRunner: () => TransformRunner;
+
+export { createNodeTransformRunner, runInVm };

package/dist/runInVm.js

@@ -0,0 +1 @@
+"use strict";var u=Object.create;var o=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var p=Object.getPrototypeOf,c=Object.prototype.hasOwnProperty;var y=(n,t)=>{for(var r in t)o(n,r,{get:t[r],enumerable:!0})},i=(n,t,r,e)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of f(t))!c.call(n,s)&&s!==r&&o(n,s,{get:()=>t[s],enumerable:!(e=l(t,s))||e.enumerable});return n};var d=(n,t,r)=>(r=n!=null?u(p(n)):{},i(t||!n||!n.__esModule?o(r,"default",{value:n,enumerable:!0}):r,n)),w=n=>i(o({},"__esModule",{value:!0}),n);var T={};y(T,{createNodeTransformRunner:()=>v,runInVm:()=>m});module.exports=w(T);var a=null;async function h(){if(a)return a;try{return a=await import("vm2"),a}catch(n){throw n?.code==="MODULE_NOT_FOUND"||n?.message?.includes("Cannot find module")?new Error('The optional dependency "vm2" is not installed. To use runInVm in Node.js, please install vm2: npm install vm2 --save.'):n}}var m=async(n,t)=>{try{let{VM:r}=await h(),e=new r({timeout:2e3,sandbox:{results:t},eval:!1,wasm:!1});return n.trim().startsWith("(")&&n.includes("=>")?e.run(`(${n})(results)`):n.trim().startsWith("function")?e.run(`(${n})(results)`):e.run(`(${n})`)}catch(r){throw r?.message?.includes('The optional dependency "vm2" is not installed')?r:new Error(`Transform error: ${r?.message||String(r)}`)}},v=()=>({run:m});0&&(module.exports={createNodeTransformRunner,runInVm});

package/dist/runInVm.mjs

@@ -0,0 +1 @@
+var t=null;async function o(){if(t)return t;try{return t=await import("vm2"),t}catch(n){throw n?.code==="MODULE_NOT_FOUND"||n?.message?.includes("Cannot find module")?new Error('The optional dependency "vm2" is not installed. To use runInVm in Node.js, please install vm2: npm install vm2 --save.'):n}}var a=async(n,s)=>{try{let{VM:r}=await o(),e=new r({timeout:2e3,sandbox:{results:s},eval:!1,wasm:!1});return n.trim().startsWith("(")&&n.includes("=>")?e.run(`(${n})(results)`):n.trim().startsWith("function")?e.run(`(${n})(results)`):e.run(`(${n})`)}catch(r){throw r?.message?.includes('The optional dependency "vm2" is not installed')?r:new Error(`Transform error: ${r?.message||String(r)}`)}},i=()=>({run:a});export{i as createNodeTransformRunner,a as runInVm};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@joai/warps-vm-node",
+  "version": "1.0.0-beta.10",
+  "type": "module",
+  "types": "dist/runInVm.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@joai/warps": "^3.0.0-beta.198",
+    "vm2": "^3.10.0"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "test": "jest --env=node"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/runInVm.d.ts",
+      "import": "./dist/runInVm.mjs",
+      "require": "./dist/runInVm.js",
+      "default": "./dist/runInVm.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}