@gjsify/vm 0.1.0

package/README.md

@@ -0,0 +1,26 @@
+# @gjsify/vm
+
+GJS stub implementation of the Node.js `vm` module. Provides runInThisContext via eval and Script.
+
+Part of the [gjsify](https://github.com/gjsify/gjsify) project — Node.js and Web APIs for GJS (GNOME JavaScript).
+
+## Installation
+
+```bash
+npm install @gjsify/vm
+# or
+yarn add @gjsify/vm
+```
+
+## Usage
+
+```typescript
+import { runInThisContext, Script } from '@gjsify/vm';
+
+const result = runInThisContext('1 + 2');
+console.log(result); // 3
+```
+
+## License
+
+MIT

package/lib/esm/index.js

@@ -0,0 +1,68 @@
+const contextSymbol = /* @__PURE__ */ Symbol("vm.context");
+function runInThisContext(code, _options) {
+  return eval(code);
+}
+function runInNewContext(code2, context, _options2) {
+  const sandbox = context || {};
+  const keys = Object.keys(sandbox);
+  const values = keys.map((k) => sandbox[k]);
+  const fn = new Function(...keys, `return eval(${JSON.stringify(code2)})`);
+  return fn(...values);
+}
+function runInContext(code2, context, _options2) {
+  return runInNewContext(code2, context);
+}
+function createContext(context) {
+  const ctx = context || {};
+  Object.defineProperty(ctx, contextSymbol, { value: true, enumerable: false });
+  return ctx;
+}
+function isContext(context) {
+  if (typeof context !== "object" || context === null) {
+    throw new TypeError(
+      `The "object" argument must be of type object. Received ${context === null ? "null" : `type ${typeof context}`}`
+    );
+  }
+  return context[contextSymbol] === true;
+}
+function compileFunction(code2, params, _options2) {
+  const paramNames = params || [];
+  return new Function(...paramNames, code2);
+}
+class Script {
+  _code;
+  constructor(code2, _options2) {
+    this._code = code2;
+  }
+  runInThisContext(_options) {
+    return eval(this._code);
+  }
+  runInNewContext(context, _options2) {
+    return runInNewContext(this._code, context);
+  }
+  runInContext(context, _options2) {
+    return runInNewContext(this._code, context);
+  }
+  createCachedData() {
+    return new Uint8Array(0);
+  }
+}
+var index_default = {
+  runInThisContext,
+  runInNewContext,
+  runInContext,
+  createContext,
+  isContext,
+  compileFunction,
+  Script
+};
+export {
+  Script,
+  compileFunction,
+  createContext,
+  index_default as default,
+  isContext,
+  runInContext,
+  runInNewContext,
+  runInThisContext
+};

package/lib/types/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Run code in the current V8/SpiderMonkey context.
+ * Equivalent to eval() but matches Node.js vm.runInThisContext() API.
+ */
+export declare function runInThisContext(code: string, _options?: Record<string, unknown>): unknown;
+/**
+ * Run code with a sandbox object providing global-like variables.
+ * Uses Function constructor to inject sandbox properties as local variables.
+ * NOTE: This is NOT a security sandbox — code can still access globalThis.
+ * This matches Node.js vm module behavior which also does not provide true isolation.
+ */
+export declare function runInNewContext(code: string, context?: Record<string, unknown>, _options?: Record<string, unknown>): unknown;
+/**
+ * Run code in a previously created context.
+ * Since we don't have real VM contexts, this delegates to runInNewContext.
+ */
+export declare function runInContext(code: string, context: Record<string, unknown>, _options?: Record<string, unknown>): unknown;
+/**
+ * Create a "context" object. Marks it with a symbol so isContext() works.
+ * In real Node.js, this creates a V8 Context. Here it just marks an object.
+ */
+export declare function createContext(context?: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Check if an object was created by createContext().
+ * Throws TypeError for non-object arguments, matching Node.js behavior.
+ */
+export declare function isContext(context: unknown): boolean;
+/**
+ * Compile a function from source code with optional parameters and context.
+ * Matches Node.js vm.compileFunction() API surface.
+ * eslint-disable-next-line no-new-func — intentional: vm module implements code evaluation
+ */
+export declare function compileFunction(code: string, params?: string[], _options?: {
+    parsingContext?: Record<string, unknown>;
+    contextExtensions?: object[];
+}): Function;
+/**
+ * Script class — compiles code for repeated execution.
+ */
+export declare class Script {
+    private _code;
+    constructor(code: string, _options?: Record<string, unknown>);
+    runInThisContext(_options?: Record<string, unknown>): unknown;
+    runInNewContext(context?: Record<string, unknown>, _options?: Record<string, unknown>): unknown;
+    runInContext(context: Record<string, unknown>, _options?: Record<string, unknown>): unknown;
+    createCachedData(): Uint8Array;
+}
+declare const _default: {
+    runInThisContext: typeof runInThisContext;
+    runInNewContext: typeof runInNewContext;
+    runInContext: typeof runInContext;
+    createContext: typeof createContext;
+    isContext: typeof isContext;
+    compileFunction: typeof compileFunction;
+    Script: typeof Script;
+};
+export default _default;

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@gjsify/vm",
+  "version": "0.1.0",
+  "description": "Node.js vm module for Gjs",
+  "type": "module",
+  "module": "lib/esm/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/esm/index.js"
+    }
+  },
+  "scripts": {
+    "clear": "rm -rf lib tsconfig.tsbuildinfo tsconfig.types.tsbuildinfo test.gjs.mjs test.node.mjs || exit 0",
+    "check": "tsc --noEmit",
+    "build": "yarn build:gjsify && yarn build:types",
+    "build:gjsify": "gjsify build --library 'src/**/*.{ts,js}' --exclude 'src/**/*.spec.{mts,ts}' 'src/test.{mts,ts}'",
+    "build:types": "tsc",
+    "build:test": "yarn build:test:gjs && yarn build:test:node",
+    "build:test:gjs": "gjsify build src/test.mts --app gjs --outfile test.gjs.mjs",
+    "build:test:node": "gjsify build src/test.mts --app node --outfile test.node.mjs",
+    "test": "yarn build:gjsify && yarn build:test && yarn test:node && yarn test:gjs",
+    "test:gjs": "gjs -m test.gjs.mjs",
+    "test:node": "node test.node.mjs"
+  },
+  "keywords": [
+    "gjs",
+    "node",
+    "vm"
+  ],
+  "devDependencies": {
+    "@gjsify/cli": "^0.1.0",
+    "@gjsify/unit": "^0.1.0",
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  }
+}