ai-evaluate 2.1.4 → 2.1.6

package/src/node.js

@@ -0,0 +1,168 @@
+/**
+ * Evaluate code in a sandboxed environment (Node.js version)
+ *
+ * Uses Cloudflare worker_loaders when available, falls back to Miniflare for local dev.
+ * For Workers-only builds, import from 'ai-evaluate' instead.
+ */
+import { generateWorkerCode, generateDevWorkerCode } from './worker-template.js';
+/**
+ * Check if code contains JSX syntax that needs transformation
+ */
+function containsJSX(code) {
+    if (!code)
+        return false;
+    const jsxPattern = /<[A-Z][a-zA-Z0-9]*[\s/>]|<[a-z][a-z0-9-]*[\s/>]|<>|<\/>/;
+    const jsxReturnPattern = /return\s*\(\s*<|return\s+<[A-Za-z]/;
+    return jsxPattern.test(code) || jsxReturnPattern.test(code);
+}
+/**
+ * Transform JSX in code using esbuild
+ */
+async function transformJSX(code) {
+    if (!code || !containsJSX(code))
+        return code;
+    try {
+        const { transform } = await import('esbuild');
+        const result = await transform(code, {
+            loader: 'tsx',
+            jsxFactory: 'h',
+            jsxFragment: 'Fragment',
+            target: 'esnext',
+            format: 'esm',
+        });
+        return result.code;
+    }
+    catch (error) {
+        console.error('JSX transform failed:', error);
+        return code;
+    }
+}
+/**
+ * Evaluate code in a sandboxed worker (Node.js version with Miniflare fallback)
+ */
+export async function evaluate(options, env) {
+    const start = Date.now();
+    try {
+        // Transform JSX in module, tests, and script before evaluation
+        const transformedModule = options.module ? await transformJSX(options.module) : undefined;
+        const transformedTests = options.tests ? await transformJSX(options.tests) : undefined;
+        const transformedScript = options.script ? await transformJSX(options.script) : undefined;
+        const transformedOptions = {
+            ...options,
+            module: transformedModule,
+            tests: transformedTests,
+            script: transformedScript,
+        };
+        // Use worker_loaders if available (Cloudflare Workers)
+        if (env?.LOADER && env?.TEST) {
+            return await evaluateWithWorkerLoader(transformedOptions, env.LOADER, env.TEST, start);
+        }
+        // Fall back to Miniflare (Node.js/local development)
+        return await evaluateWithMiniflare(transformedOptions, start);
+    }
+    catch (error) {
+        return {
+            success: false,
+            logs: [],
+            error: error instanceof Error ? error.message : String(error),
+            duration: Date.now() - start,
+        };
+    }
+}
+/**
+ * Evaluate using Cloudflare worker_loaders binding
+ */
+async function evaluateWithWorkerLoader(options, loader, testService, start) {
+    const workerCode = generateWorkerCode({
+        module: options.module,
+        tests: options.tests,
+        script: options.script,
+        sdk: options.sdk,
+        imports: options.imports,
+    });
+    const id = `sandbox-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    const worker = loader.get(id, async () => ({
+        mainModule: 'worker.js',
+        modules: {
+            'worker.js': workerCode,
+        },
+        compatibilityDate: '2026-01-01',
+        globalOutbound: options.fetch === null ? null : undefined,
+        bindings: {
+            TEST: testService,
+        },
+    }));
+    const entrypoint = worker.getEntrypoint();
+    const response = await entrypoint.fetch(new Request('http://sandbox/execute'));
+    const result = (await response.json());
+    return {
+        ...result,
+        duration: Date.now() - start,
+    };
+}
+/**
+ * Evaluate using Miniflare (for Node.js/development)
+ */
+async function evaluateWithMiniflare(options, start) {
+    const { Miniflare } = await import('miniflare');
+    const workerCode = generateDevWorkerCode({
+        module: options.module,
+        tests: options.tests,
+        script: options.script,
+        sdk: options.sdk,
+        imports: options.imports,
+        fetch: options.fetch, // Pass fetch option to worker template
+    });
+    // Block outbound network requests at Miniflare level when fetch: null
+    // This complements the globalThis.fetch override in the worker template
+    const blockNetwork = options.fetch === null;
+    const mf = new Miniflare({
+        modules: true,
+        script: workerCode,
+        compatibilityDate: '2026-01-01',
+        // Block all outbound fetch/connect when network is disabled
+        ...(blockNetwork && {
+            outboundService: () => {
+                throw new Error('Network access blocked: fetch is disabled in this sandbox');
+            },
+        }),
+    });
+    try {
+        const timeout = options.timeout || 5000;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await mf.dispatchFetch('http://sandbox/execute', {
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            const result = (await response.json());
+            return {
+                ...result,
+                duration: Date.now() - start,
+            };
+        }
+        catch (err) {
+            clearTimeout(timeoutId);
+            if (err.name === 'AbortError') {
+                return {
+                    success: false,
+                    logs: [],
+                    error: `Timeout: Script execution exceeded ${timeout}ms`,
+                    duration: Date.now() - start,
+                };
+            }
+            throw err;
+        }
+    }
+    finally {
+        await mf.dispose();
+    }
+}
+/**
+ * Create an evaluate function bound to a specific environment
+ */
+export function createEvaluator(env) {
+    return (options) => evaluate(options, env);
+}
+//# sourceMappingURL=node.js.map

package/src/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["node.ts"],"names":[],"mappings":"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"}

package/src/node.ts

@@ -0,0 +1,200 @@
+/**
+ * Evaluate code in a sandboxed environment (Node.js version)
+ *
+ * Uses Cloudflare worker_loaders when available, falls back to Miniflare for local dev.
+ * For Workers-only builds, import from 'ai-evaluate' instead.
+ */
+
+import type { EvaluateOptions, EvaluateResult, WorkerLoader, SandboxEnv } from './types.js'
+import { generateWorkerCode, generateDevWorkerCode } from './worker-template.js'
+
+/**
+ * Check if code contains JSX syntax that needs transformation
+ */
+function containsJSX(code: string): boolean {
+  if (!code) return false
+  const jsxPattern = /<[A-Z][a-zA-Z0-9]*[\s/>]|<[a-z][a-z0-9-]*[\s/>]|<>|<\/>/
+  const jsxReturnPattern = /return\s*\(\s*<|return\s+<[A-Za-z]/
+  return jsxPattern.test(code) || jsxReturnPattern.test(code)
+}
+
+/**
+ * Transform JSX in code using esbuild
+ */
+async function transformJSX(code: string): Promise<string> {
+  if (!code || !containsJSX(code)) return code
+
+  try {
+    const { transform } = await import('esbuild')
+    const result = await transform(code, {
+      loader: 'tsx',
+      jsxFactory: 'h',
+      jsxFragment: 'Fragment',
+      target: 'esnext',
+      format: 'esm',
+    })
+    return result.code
+  } catch (error) {
+    console.error('JSX transform failed:', error)
+    return code
+  }
+}
+
+/**
+ * Evaluate code in a sandboxed worker (Node.js version with Miniflare fallback)
+ */
+export async function evaluate(
+  options: EvaluateOptions,
+  env?: SandboxEnv
+): Promise<EvaluateResult> {
+  const start = Date.now()
+
+  try {
+    // Transform JSX in module, tests, and script before evaluation
+    const transformedModule = options.module ? await transformJSX(options.module) : undefined
+    const transformedTests = options.tests ? await transformJSX(options.tests) : undefined
+    const transformedScript = options.script ? await transformJSX(options.script) : undefined
+
+    const transformedOptions: EvaluateOptions = {
+      ...options,
+      module: transformedModule,
+      tests: transformedTests,
+      script: transformedScript,
+    }
+
+    // Use worker_loaders if available (Cloudflare Workers)
+    // Check lowercase first (preferred), then legacy uppercase
+    const loader = env?.loader || env?.LOADER
+    const testService = env?.test || env?.TEST
+    if (loader && testService) {
+      return await evaluateWithWorkerLoader(transformedOptions, loader, testService, start)
+    }
+
+    // Fall back to Miniflare (Node.js/local development)
+    return await evaluateWithMiniflare(transformedOptions, start)
+  } catch (error) {
+    return {
+      success: false,
+      logs: [],
+      error: error instanceof Error ? error.message : String(error),
+      duration: Date.now() - start,
+    }
+  }
+}
+
+/**
+ * Evaluate using Cloudflare worker_loaders binding
+ */
+async function evaluateWithWorkerLoader(
+  options: EvaluateOptions,
+  loader: WorkerLoader,
+  testService: unknown,
+  start: number
+): Promise<EvaluateResult> {
+  const workerCode = generateWorkerCode({
+    module: options.module,
+    tests: options.tests,
+    script: options.script,
+    sdk: options.sdk,
+    imports: options.imports,
+  })
+  const id = `sandbox-${Date.now()}-${Math.random().toString(36).slice(2)}`
+
+  const worker = loader.get(id, async () => ({
+    mainModule: 'worker.js',
+    modules: {
+      'worker.js': workerCode,
+    },
+    compatibilityDate: '2026-01-01',
+    globalOutbound: options.fetch === null ? null : undefined,
+    bindings: {
+      TEST: testService,
+    },
+  }))
+
+  const entrypoint = worker.getEntrypoint()
+  const response = await entrypoint.fetch(new Request('http://sandbox/execute'))
+  const result = (await response.json()) as EvaluateResult
+
+  return {
+    ...result,
+    duration: Date.now() - start,
+  }
+}
+
+/**
+ * Evaluate using Miniflare (for Node.js/development)
+ */
+async function evaluateWithMiniflare(
+  options: EvaluateOptions,
+  start: number
+): Promise<EvaluateResult> {
+  const { Miniflare } = await import('miniflare')
+
+  const workerCode = generateDevWorkerCode({
+    module: options.module,
+    tests: options.tests,
+    script: options.script,
+    sdk: options.sdk,
+    imports: options.imports,
+    fetch: options.fetch, // Pass fetch option to worker template
+  })
+
+  // Block outbound network requests at Miniflare level when fetch: null
+  // This complements the globalThis.fetch override in the worker template
+  const blockNetwork = options.fetch === null
+
+  const mf = new Miniflare({
+    modules: true,
+    script: workerCode,
+    compatibilityDate: '2026-01-01',
+    // Block all outbound fetch/connect when network is disabled
+    ...(blockNetwork && {
+      outboundService: () => {
+        throw new Error('Network access blocked: fetch is disabled in this sandbox')
+      },
+    }),
+  })
+
+  try {
+    const timeout = options.timeout || 5000
+    const controller = new AbortController()
+    const timeoutId = setTimeout(() => controller.abort(), timeout)
+
+    try {
+      const response = await mf.dispatchFetch('http://sandbox/execute', {
+        signal: controller.signal,
+      })
+      clearTimeout(timeoutId)
+      const result = (await response.json()) as EvaluateResult
+
+      return {
+        ...result,
+        duration: Date.now() - start,
+      }
+    } catch (err) {
+      clearTimeout(timeoutId)
+      if ((err as Error).name === 'AbortError') {
+        return {
+          success: false,
+          logs: [],
+          error: `Timeout: Script execution exceeded ${timeout}ms`,
+          duration: Date.now() - start,
+        }
+      }
+      throw err
+    }
+  } finally {
+    await mf.dispose()
+  }
+}
+
+/**
+ * Create an evaluate function bound to a specific environment
+ */
+export function createEvaluator(env?: SandboxEnv) {
+  return (options: EvaluateOptions) => evaluate(options, env)
+}
+
+// Re-export types
+export type { EvaluateOptions, EvaluateResult, SandboxEnv } from './types.js'

package/src/repl.ts

@@ -0,0 +1,228 @@
+/**
+ * REPL session support for ai-evaluate
+ *
+ * Provides persistent evaluation sessions with context preservation.
+ */
+
+import type { EvaluateOptions, EvaluateResult, SandboxEnv, SDKConfig } from './types.js'
+
+/**
+ * REPL session configuration
+ */
+export interface ReplSessionConfig {
+  /** Use local Miniflare instead of remote workers */
+  local?: boolean
+  /** Authentication token for remote execution */
+  auth?: string
+  /** SDK configuration for platform primitives */
+  sdk?: SDKConfig | boolean
+  /** Code to run when session starts (defines globals, imports) */
+  prelude?: string
+  /** Timeout for each evaluation in milliseconds */
+  timeout?: number
+  /** Allow network access */
+  allowNetwork?: boolean
+}
+
+/**
+ * Result from a REPL evaluation
+ */
+export interface ReplEvalResult extends EvaluateResult {
+  /** Variables exported during evaluation */
+  exports?: Record<string, unknown>
+}
+
+/**
+ * REPL session with persistent context
+ */
+export interface ReplSession {
+  /** Evaluate code in the session context */
+  eval(code: string): Promise<ReplEvalResult>
+
+  /** Get current session context (accumulated exports) */
+  getContext(): Record<string, unknown>
+
+  /** Set a value in the session context */
+  setContext(key: string, value: unknown): void
+
+  /** Clear the session context */
+  clearContext(): void
+
+  /** Run prelude code (called automatically on first eval) */
+  runPrelude(): Promise<void>
+
+  /** Close the session and release resources */
+  close(): Promise<void>
+}
+
+/**
+ * Create a REPL session for interactive code evaluation
+ *
+ * @example
+ * ```ts
+ * import { createReplSession } from 'ai-evaluate/repl'
+ *
+ * const session = await createReplSession({ local: true })
+ *
+ * await session.eval('const sum = (a, b) => a + b')
+ * const result = await session.eval('sum(1, 2)')
+ * console.log(result.value) // 3
+ *
+ * await session.close()
+ * ```
+ */
+export async function createReplSession(
+  config?: ReplSessionConfig,
+  env?: SandboxEnv
+): Promise<ReplSession> {
+  // Context accumulates across evaluations
+  let context: Record<string, unknown> = {}
+  let preludeRun = false
+  let miniflare: unknown = null
+
+  // Build module code from accumulated context
+  function buildContextModule(): string {
+    const entries = Object.entries(context)
+    if (entries.length === 0) return ''
+
+    return entries
+      .map(([key, value]) => {
+        if (typeof value === 'function') {
+          return `export const ${key} = ${value.toString()}`
+        }
+        return `export const ${key} = ${JSON.stringify(value)}`
+      })
+      .join('\n')
+  }
+
+  // Get the evaluate function (local or remote)
+  async function getEvaluate(): Promise<
+    (options: EvaluateOptions, env?: SandboxEnv) => Promise<EvaluateResult>
+  > {
+    if (config?.local) {
+      // Use local Miniflare via node.ts
+      const { evaluate } = await import('./node.js')
+      return evaluate
+    } else if (env) {
+      // Use remote worker loaders
+      const { evaluate } = await import('./evaluate.js')
+      return (options) => evaluate(options, env)
+    } else {
+      // Default to local if no env
+      const { evaluate } = await import('./node.js')
+      return evaluate
+    }
+  }
+
+  const evaluate = await getEvaluate()
+
+  async function runPrelude(): Promise<void> {
+    if (preludeRun || !config?.prelude) return
+    preludeRun = true
+
+    const result = await evaluate(
+      {
+        module: config.prelude,
+        script: 'return Object.keys(module)',
+        sdk: config.sdk,
+        timeout: config.timeout,
+        fetch: config.allowNetwork === false ? null : undefined,
+      },
+      env
+    )
+
+    if (result.success && Array.isArray(result.value)) {
+      // Store exported names in context
+      for (const key of result.value) {
+        context[key] = `__prelude_${key}__`
+      }
+    }
+  }
+
+  return {
+    async eval(code: string): Promise<ReplEvalResult> {
+      await runPrelude()
+
+      // Wrap code to capture any declared variables
+      const contextModule = buildContextModule()
+      const preludeModule = config?.prelude || ''
+
+      // Try to parse as expression first, then as statement
+      const isExpression =
+        !code.includes('const ') &&
+        !code.includes('let ') &&
+        !code.includes('function ') &&
+        !code.includes('class ') &&
+        !code.includes('export ')
+
+      const script = isExpression
+        ? `return (${code})`
+        : code.includes('return ')
+        ? code
+        : `${code}\nreturn undefined`
+
+      const result = await evaluate(
+        {
+          module: preludeModule + '\n' + contextModule,
+          script,
+          sdk: config?.sdk,
+          timeout: config?.timeout,
+          fetch: config?.allowNetwork === false ? null : undefined,
+        },
+        env
+      )
+
+      return result
+    },
+
+    getContext(): Record<string, unknown> {
+      return { ...context }
+    },
+
+    setContext(key: string, value: unknown): void {
+      context[key] = value
+    },
+
+    clearContext(): void {
+      context = {}
+    },
+
+    runPrelude,
+
+    async close(): Promise<void> {
+      context = {}
+      preludeRun = false
+      if (
+        miniflare &&
+        typeof (miniflare as { dispose?: () => Promise<void> }).dispose === 'function'
+      ) {
+        await (miniflare as { dispose: () => Promise<void> }).dispose()
+        miniflare = null
+      }
+    },
+  }
+}
+
+/**
+ * Quick evaluation helper for one-off evaluations
+ *
+ * @example
+ * ```ts
+ * import { quickEval } from 'ai-evaluate/repl'
+ *
+ * const result = await quickEval('1 + 2 * 3')
+ * console.log(result.value) // 7
+ * ```
+ */
+export async function quickEval(
+  code: string,
+  config?: ReplSessionConfig,
+  env?: SandboxEnv
+): Promise<ReplEvalResult> {
+  const session = await createReplSession(config, env)
+  try {
+    return await session.eval(code)
+  } finally {
+    await session.close()
+  }
+}