ai-evaluate 2.1.5 → 2.1.7

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()
+  }
+}

package/src/types.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Types for ai-sandbox
+ */
+/**
+ * SDK configuration for the sandbox environment
+ */
+export interface SDKConfig {
+    /** Execution context: local (in-memory) or remote (RPC) */
+    context?: 'local' | 'remote';
+    /** RPC endpoint URL for all services (default: https://rpc.do) */
+    rpcUrl?: string;
+    /** Database RPC URL (default: https://db.do/rpc) */
+    dbUrl?: string;
+    /** AI RPC URL (default: https://ai.do/rpc) */
+    aiUrl?: string;
+    /** Authentication token */
+    token?: string;
+    /** Default namespace for database operations */
+    ns?: string;
+    /** Cloudflare AI Gateway URL (e.g., https://gateway.ai.cloudflare.com/v1/{account}/{gateway}) */
+    aiGatewayUrl?: string;
+    /** Cloudflare AI Gateway authentication token */
+    aiGatewayToken?: string;
+}
+/**
+ * Options for evaluate()
+ */
+export interface EvaluateOptions {
+    /** Module code with exports */
+    module?: string | undefined;
+    /** Test code using vitest (describe, expect, it in global scope) */
+    tests?: string | undefined;
+    /** Script code to run immediately (module exports in scope) */
+    script?: string | undefined;
+    /** Timeout in milliseconds (default: 5000) */
+    timeout?: number | undefined;
+    /** Environment variables to pass to the sandbox */
+    env?: Record<string, string> | undefined;
+    /** Fetch configuration. Set to null to block network access. Default: allowed */
+    fetch?: null | undefined;
+    /** RPC services to expose via capnweb (URL -> handler) */
+    rpc?: Record<string, unknown> | undefined;
+    /** Outbound RPC interceptor - intercepts fetch calls to RPC URLs */
+    outboundRpc?: ((url: string, request: Request) => Promise<Response> | Response | null) | undefined;
+    /** SDK configuration - enables $, db, ai, api, on, send globals */
+    sdk?: SDKConfig | boolean | undefined;
+    /** Top-level imports to hoist (for MDX test files with external imports) */
+    imports?: string[] | undefined;
+}
+/**
+ * Result from evaluate()
+ */
+export interface EvaluateResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Return value from script (if any) */
+    value?: unknown;
+    /** Console output */
+    logs: LogEntry[];
+    /** Test results (if tests were provided) */
+    testResults?: TestResults;
+    /** Error message if execution failed */
+    error?: string;
+    /** Execution time in milliseconds */
+    duration: number;
+}
+/**
+ * A log entry from console.log/warn/error
+ */
+export interface LogEntry {
+    level: 'log' | 'warn' | 'error' | 'info' | 'debug';
+    message: string;
+    timestamp: number;
+}
+/**
+ * Test results from vitest-style tests
+ */
+export interface TestResults {
+    /** Total number of tests */
+    total: number;
+    /** Number of passed tests */
+    passed: number;
+    /** Number of failed tests */
+    failed: number;
+    /** Number of skipped tests */
+    skipped: number;
+    /** Individual test results */
+    tests: TestResult[];
+    /** Total duration in milliseconds */
+    duration: number;
+}
+/**
+ * Individual test result
+ */
+export interface TestResult {
+    /** Test name (describe > it) */
+    name: string;
+    /** Whether the test passed */
+    passed: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Test duration in milliseconds */
+    duration: number;
+}
+/**
+ * Worker loader binding type (Cloudflare)
+ */
+export interface WorkerLoader {
+    get(id: string, loader: () => Promise<WorkerCode>): WorkerStub;
+}
+/**
+ * Worker code configuration
+ */
+export interface WorkerCode {
+    mainModule: string;
+    modules: Record<string, string | {
+        js?: string;
+        cjs?: string;
+        text?: string;
+        json?: unknown;
+    }>;
+    compatibilityDate?: string;
+    env?: Record<string, unknown>;
+    globalOutbound?: null | unknown;
+}
+/**
+ * Worker entrypoint with fetch method
+ */
+export interface WorkerEntrypoint {
+    fetch(request: Request): Promise<Response>;
+}
+/**
+ * Worker stub returned by loader
+ */
+export interface WorkerStub {
+    getEntrypoint(): WorkerEntrypoint;
+}
+/**
+ * Test service core - returned by connect() (from ai-tests)
+ */
+export interface TestServiceCore {
+    expect(value: unknown, message?: string): unknown;
+    should(value: unknown): unknown;
+    assert: unknown;
+    describe(name: string, fn: () => void): void;
+    it(name: string, fn: () => void | Promise<void>): void;
+    test(name: string, fn: () => void | Promise<void>): void;
+    skip(name: string, fn?: () => void | Promise<void>): void;
+    only(name: string, fn: () => void | Promise<void>): void;
+    beforeEach(fn: () => void | Promise<void>): void;
+    afterEach(fn: () => void | Promise<void>): void;
+    beforeAll(fn: () => void | Promise<void>): void;
+    afterAll(fn: () => void | Promise<void>): void;
+    run(): Promise<TestResults>;
+    reset(): void;
+}
+/**
+ * Test service binding type - WorkerEntrypoint (from ai-tests)
+ */
+export interface TestServiceBinding {
+    /** Get a test service instance via RPC */
+    connect(): Promise<TestServiceCore>;
+}
+/**
+ * Environment with worker loader binding
+ */
+export interface SandboxEnv {
+    loader?: WorkerLoader;
+    LOADER?: WorkerLoader;
+    TEST?: TestServiceBinding;
+}
+//# sourceMappingURL=types.d.ts.map

package/src/types.d.ts.map

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

package/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/src/types.ts

@@ -29,25 +29,25 @@ export interface SDKConfig {
  */
 export interface EvaluateOptions {
   /** Module code with exports */
-  module?: string
+  module?: string | undefined
   /** Test code using vitest (describe, expect, it in global scope) */
-  tests?: string
+  tests?: string | undefined
   /** Script code to run immediately (module exports in scope) */
-  script?: string
+  script?: string | undefined
   /** Timeout in milliseconds (default: 5000) */
-  timeout?: number
+  timeout?: number | undefined
   /** Environment variables to pass to the sandbox */
-  env?: Record<string, string>
+  env?: Record<string, string> | undefined
   /** Fetch configuration. Set to null to block network access. Default: allowed */
-  fetch?: null
+  fetch?: null | undefined
   /** RPC services to expose via capnweb (URL -> handler) */
-  rpc?: Record<string, unknown>
+  rpc?: Record<string, unknown> | undefined
   /** Outbound RPC interceptor - intercepts fetch calls to RPC URLs */
-  outboundRpc?: (url: string, request: Request) => Promise<Response> | Response | null
+  outboundRpc?: ((url: string, request: Request) => Promise<Response> | Response | null) | undefined
   /** SDK configuration - enables $, db, ai, api, on, send globals */
-  sdk?: SDKConfig | boolean
+  sdk?: SDKConfig | boolean | undefined
   /** Top-level imports to hoist (for MDX test files with external imports) */
-  imports?: string[]
+  imports?: string[] | undefined
 }
 
 /**
@@ -113,10 +113,7 @@ export interface TestResult {
  * Worker loader binding type (Cloudflare)
  */
 export interface WorkerLoader {
-  get(
-    id: string,
-    loader: () => Promise<WorkerCode>
-  ): WorkerStub
+  get(id: string, loader: () => Promise<WorkerCode>): WorkerStub
 }
 
 /**
@@ -176,6 +173,8 @@ export interface TestServiceBinding {
  * Environment with worker loader binding
  */
 export interface SandboxEnv {
-  LOADER?: WorkerLoader
-  TEST?: TestServiceBinding
+  loader?: WorkerLoader
+  LOADER?: WorkerLoader // Legacy - prefer lowercase
+  test?: TestServiceBinding
+  TEST?: TestServiceBinding // Legacy - prefer lowercase
 }