sandlot 0.1.3 → 0.2.0

package/dist/node/preset.d.ts

@@ -0,0 +1,62 @@
+import { type EsmTypesResolverOptions } from "../core/esm-types-resolver";
+import type { Sandlot, SandlotOptions } from "../types";
+import { type EsbuildNativeBundlerOptions } from "./bundler";
+import { type TypecheckerOptions } from "../core/typechecker";
+import { type NodeExecutorOptions } from "./executor";
+export interface CreateNodeSandlotOptions extends Omit<SandlotOptions, "bundler" | "typechecker" | "typesResolver" | "executor"> {
+    /**
+     * Custom bundler options, or a pre-configured bundler instance.
+     */
+    bundler?: EsbuildNativeBundlerOptions | SandlotOptions["bundler"];
+    /**
+     * Custom typechecker options, or a pre-configured typechecker instance.
+     * Set to `false` to disable type checking.
+     */
+    typechecker?: TypecheckerOptions | SandlotOptions["typechecker"] | false;
+    /**
+     * Custom types resolver options, or a pre-configured resolver instance.
+     * Set to `false` to disable type resolution.
+     */
+    typesResolver?: EsmTypesResolverOptions | SandlotOptions["typesResolver"] | false;
+    /**
+     * Custom executor options, or a pre-configured executor instance.
+     * Set to `false` to disable execution (sandbox.run() will throw).
+     * Defaults to NodeExecutor.
+     */
+    executor?: NodeExecutorOptions | SandlotOptions["executor"] | false;
+}
+/**
+ * Create a Sandlot instance pre-configured for Node.js/Bun/Deno environments.
+ *
+ * This is a convenience function that sets up sensible defaults:
+ * - EsbuildNativeBundler for bundling (uses native esbuild)
+ * - Typechecker for type checking (fetches libs from CDN)
+ * - EsmTypesResolver for npm type resolution
+ * - NodeExecutor for code execution
+ *
+ * @example Basic usage
+ * ```ts
+ * const sandlot = await createNodeSandlot();
+ * const sandbox = await sandlot.createSandbox();
+ * ```
+ *
+ * @example With shared modules
+ * ```ts
+ * import express from "express";
+ *
+ * const sandlot = await createNodeSandlot({
+ *   sharedModules: {
+ *     express,
+ *   },
+ * });
+ * ```
+ *
+ * @example Disable type checking for faster builds
+ * ```ts
+ * const sandlot = await createNodeSandlot({
+ *   typechecker: false,
+ * });
+ * ```
+ */
+export declare function createNodeSandlot(options?: CreateNodeSandlotOptions): Promise<Sandlot>;
+//# sourceMappingURL=preset.d.ts.map

package/dist/node/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../src/node/preset.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAwB,KAAK,2BAA2B,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,wBACf,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,GAAG,aAAa,GAAG,eAAe,GAAG,UAAU,CAAC;IACtF;;OAEG;IACH,OAAO,CAAC,EAAE,2BAA2B,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAElE;;;OAGG;IACH,WAAW,CAAC,EACV,kBAAkB,GAClB,cAAc,CAAC,aAAa,CAAC,GAC7B,KAAK,CAAC;IAER;;;OAGG;IACH,aAAa,CAAC,EACZ,uBAAuB,GACvB,cAAc,CAAC,eAAe,CAAC,GAC/B,KAAK,CAAC;IAER;;;;OAIG;IACH,QAAQ,CAAC,EACP,mBAAmB,GACnB,cAAc,CAAC,UAAU,CAAC,GAC1B,KAAK,CAAC;CACT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,OAAO,CAAC,CAgDlB"}

package/dist/types.d.ts

@@ -0,0 +1,525 @@
+import type { Filesystem } from "./core/fs";
+export type { IFileSystem, FsEntry, FsStat } from "just-bash/browser";
+export type { Filesystem } from "./core/fs";
+/**
+ * Bundler interface - transforms source files into executable JavaScript.
+ *
+ * Implementations handle their own initialization and caching (e.g., WASM loading).
+ */
+export interface IBundler {
+    /**
+     * Bundle source files from a filesystem into a single output
+     */
+    bundle(options: BundleOptions): Promise<BundleResult>;
+}
+export interface BundleOptions {
+    fs: Filesystem;
+    entryPoint: string;
+    /**
+     * Map of installed package names to versions.
+     * Used by the bundler to resolve imports to specific versions.
+     *
+     * @example { "lodash": "4.17.21", "react": "18.2.0" }
+     */
+    installedPackages?: Record<string, string>;
+    /**
+     * Module IDs that resolve to shared modules instead of bundling.
+     * These are provided by the host environment at runtime.
+     */
+    sharedModules?: string[];
+    /** Shared module registry for resolving shared imports */
+    sharedModuleRegistry?: ISharedModuleRegistry;
+    /** Modules to treat as external (don't bundle or rewrite) */
+    external?: string[];
+    format?: "esm" | "iife" | "cjs";
+    minify?: boolean;
+    sourcemap?: boolean;
+    target?: string[];
+}
+/**
+ * Bundle result - success or failure with structured errors.
+ */
+export type BundleResult = BundleSuccess | BundleFailure;
+export interface BundleSuccess {
+    success: true;
+    code: string;
+    warnings: BundleWarning[];
+    includedFiles: string[];
+}
+export interface BundleFailure {
+    success: false;
+    errors: BundleError[];
+    warnings: BundleWarning[];
+}
+export interface BundleWarning {
+    text: string;
+    location?: BundleLocation;
+}
+export interface BundleError {
+    text: string;
+    location?: BundleLocation;
+}
+export interface BundleLocation {
+    file: string;
+    line: number;
+    column?: number;
+    /** The source line text (if available from esbuild) */
+    lineText?: string;
+}
+/**
+ * Typechecker interface - validates TypeScript code.
+ *
+ * Implementations handle their own lib file loading and caching.
+ */
+export interface ITypechecker {
+    /**
+     * Type check files against a virtual filesystem
+     */
+    typecheck(options: TypecheckOptions): Promise<TypecheckResult>;
+}
+export interface TypecheckOptions {
+    /** Sync filesystem to read source files from */
+    fs: Filesystem;
+    /** Entry point path (absolute path in the filesystem) */
+    entryPoint: string;
+    /** Path to tsconfig.json (default: "/tsconfig.json") */
+    tsconfigPath?: string;
+}
+export interface TypecheckResult {
+    success: boolean;
+    diagnostics: Diagnostic[];
+}
+export interface Diagnostic {
+    file?: string;
+    line?: number;
+    column?: number;
+    message: string;
+    severity: "error" | "warning" | "info";
+}
+/**
+ * Types resolver interface - fetches type definitions for npm packages.
+ *
+ * Implementations handle their own caching (in-memory, KV, R2, etc.).
+ */
+export interface ITypesResolver {
+    /**
+     * Fetch type definitions for a package.
+     * Returns a map of file paths to content for .d.ts files.
+     */
+    resolveTypes(packageName: string, version?: string): Promise<Record<string, string>>;
+}
+/**
+ * Shared module registry interface - provides host modules to bundled code.
+ *
+ * This allows dynamic code to use the same React/library instances as the host,
+ * avoiding the "multiple React instances" problem.
+ *
+ * Each registry instance has a unique key for global exposure, allowing multiple
+ * Sandlot instances to coexist without sharing module state.
+ */
+export interface ISharedModuleRegistry {
+    /**
+     * The unique global key where this registry is exposed.
+     * Bundled code accesses the registry via `globalThis[registryKey]`.
+     */
+    readonly registryKey: string;
+    /**
+     * Get a registered module by ID
+     */
+    get(moduleId: string): unknown;
+    /**
+     * Check if a module is registered
+     */
+    has(moduleId: string): boolean;
+    /**
+     * Get export names for a module (for generating re-exports)
+     */
+    getExportNames(moduleId: string): string[];
+    /**
+     * List all registered module IDs
+     */
+    list(): string[];
+}
+/**
+ * Executor interface - runs bundled code in an isolated context.
+ *
+ * Different implementations provide different isolation levels:
+ * - MainThreadExecutor: Runs in the main thread (no isolation, for trusted code)
+ * - WorkerExecutor: Runs in a Web Worker (memory isolation, can be terminated)
+ * - IframeExecutor: Runs in a sandboxed iframe (DOM isolation, CSP control)
+ *
+ * The executor receives a code string (bundled JavaScript) and options,
+ * and returns the execution result including captured logs and return value.
+ */
+export interface IExecutor {
+    /**
+     * Execute bundled code and return the result.
+     *
+     * @param code - The bundled JavaScript code to execute
+     * @param options - Execution options (entry export, context, timeout)
+     * @returns Execution result with logs, return value, and any error
+     */
+    execute(code: string, options?: ExecuteOptions): Promise<ExecuteResult>;
+}
+/**
+ * Options for code execution.
+ */
+export interface ExecuteOptions {
+    /**
+     * Which export to call:
+     * - 'main': Calls `main(context)` export with the provided context
+     * - 'default': Calls the default export (no arguments)
+     *
+     * If neither export exists, top-level code still runs on import.
+     * @default 'main'
+     */
+    entryExport?: "main" | "default";
+    /**
+     * Context object passed to `main(context)` when entryExport is 'main'.
+     * Typically includes things like args, env, logging functions.
+     */
+    context?: Record<string, unknown>;
+    /**
+     * Execution timeout in milliseconds.
+     * Set to 0 to disable timeout.
+     * @default 30000
+     */
+    timeout?: number;
+}
+/**
+ * Result of code execution.
+ */
+export interface ExecuteResult {
+    /** Whether execution completed successfully */
+    success: boolean;
+    /** Captured console output (log, warn, error, info, debug) */
+    logs: string[];
+    /** Return value from the executed function (if any) */
+    returnValue?: unknown;
+    /** Error message if execution failed */
+    error?: string;
+    /** Execution time in milliseconds */
+    executionTimeMs?: number;
+}
+export interface SandlotOptions {
+    /**
+     * Bundler implementation.
+     * Handles its own initialization and WASM loading.
+     */
+    bundler: IBundler;
+    /**
+     * Executor implementation (optional).
+     * Handles running bundled code in an appropriate context.
+     * If not provided, sandbox.run() will throw an error.
+     */
+    executor?: IExecutor;
+    /**
+     * Typechecker implementation (optional - skip type checking if not provided).
+     * Handles its own TypeScript lib file loading and caching.
+     */
+    typechecker?: ITypechecker;
+    /**
+     * Types resolver for npm packages (optional).
+     * Handles its own caching. If not provided, `install` command won't fetch types.
+     */
+    typesResolver?: ITypesResolver;
+    /**
+     * Shared modules - host modules to share with sandboxed code.
+     * Keys are import specifiers, values are the actual module objects.
+     *
+     * @example { 'react': React, 'react-dom/client': ReactDOM }
+     */
+    sharedModules?: Record<string, unknown>;
+    /**
+     * Default options for sandboxes created from this instance
+     */
+    sandboxDefaults?: {
+        maxFilesystemSize?: number;
+    };
+}
+export interface SandboxOptions {
+    /**
+     * Initial files to populate the filesystem with.
+     *
+     * If `/package.json` is not provided, a default one will be created with:
+     * ```json
+     * { "main": "./index.ts", "dependencies": {} }
+     * ```
+     *
+     * If `/tsconfig.json` is not provided, sensible defaults will be created.
+     *
+     * The `main` field in package.json determines the entry point for build/typecheck.
+     */
+    initialFiles?: Record<string, string>;
+    /**
+     * Maximum filesystem size in bytes
+     */
+    maxFilesystemSize?: number;
+    /**
+     * Callback invoked when a build succeeds
+     */
+    onBuild?: (result: BuildSuccess) => void | Promise<void>;
+}
+/**
+ * Build phases that can fail.
+ */
+export type BuildPhase = "entry" | "typecheck" | "bundle";
+/**
+ * Build result - success or failure with structured errors.
+ *
+ * On success, contains the bundled code string.
+ * On failure, contains the phase that failed and structured error information.
+ *
+ * Note: Build does NOT load or execute the module. Use an executor to run the code.
+ * This keeps the build phase pure (no code execution) and allows different execution
+ * contexts (main thread, web worker, iframe, remote server).
+ */
+export type BuildResult = BuildSuccess | BuildFailure;
+export interface BuildSuccess {
+    success: true;
+    /** The bundled JavaScript code */
+    code: string;
+    /** Files that were included in the bundle */
+    includedFiles: string[];
+    /** Any warnings from the bundler */
+    warnings: BundleWarning[];
+}
+export interface BuildFailure {
+    success: false;
+    /** Which phase of the build failed */
+    phase: BuildPhase;
+    /** Error message (for entry failures) */
+    message?: string;
+    /** Type check diagnostics (for typecheck failures) */
+    diagnostics?: Diagnostic[];
+    /** Bundle errors (for bundle failures) */
+    bundleErrors?: BundleError[];
+    /** Bundle warnings (may be present even on failure) */
+    bundleWarnings?: BundleWarning[];
+}
+export interface InstallResult {
+    /** Package name */
+    name: string;
+    /** Resolved version */
+    version: string;
+    /** Whether type definitions were installed */
+    typesInstalled: boolean;
+    /** Number of .d.ts files written */
+    typeFilesCount: number;
+    /** Whether types came from cache */
+    fromCache?: boolean;
+    /** Error message if types failed to install */
+    typesError?: string;
+}
+export interface UninstallResult {
+    /** Package name */
+    name: string;
+    /** Whether the package was installed (and thus removed) */
+    removed: boolean;
+}
+export interface SandboxBuildOptions {
+    /**
+     * Entry point to build.
+     * If not specified, reads from `main` field in /package.json.
+     * Falls back to "./index.ts" if not found.
+     */
+    entryPoint?: string;
+    /**
+     * Skip type checking before bundling.
+     * @default false
+     */
+    skipTypecheck?: boolean;
+    /**
+     * Minify the output.
+     * @default false
+     */
+    minify?: boolean;
+    /**
+     * Output format.
+     * @default "esm"
+     */
+    format?: "esm" | "iife" | "cjs";
+}
+export interface SandboxTypecheckOptions {
+    /**
+     * Entry point to typecheck.
+     * If not specified, reads from `main` field in /package.json.
+     * Falls back to "./index.ts" if not found.
+     */
+    entryPoint?: string;
+}
+/**
+ * Options for running code in the sandbox.
+ */
+export interface RunOptions {
+    /**
+     * Entry point to build and run.
+     * If not specified, reads from `main` field in /package.json.
+     * Falls back to "./index.ts" if not found.
+     */
+    entryPoint?: string;
+    /**
+     * Skip type checking before building.
+     * @default false
+     */
+    skipTypecheck?: boolean;
+    /**
+     * Which export to call:
+     * - 'main': Calls `main(context)` export with the provided context
+     * - 'default': Calls the default export (no arguments)
+     * @default 'main'
+     */
+    entryExport?: "main" | "default";
+    /**
+     * Context object passed to `main(context)` when entryExport is 'main'.
+     */
+    context?: Record<string, unknown>;
+    /**
+     * Execution timeout in milliseconds.
+     * Set to 0 to disable timeout.
+     * @default 30000
+     */
+    timeout?: number;
+}
+/**
+ * Result of running code in the sandbox.
+ *
+ * Extends ExecuteResult with build failure information.
+ * If `buildFailure` is present, the build failed before execution.
+ */
+export interface RunResult extends ExecuteResult {
+    /** If build failed, contains failure details */
+    buildFailure?: {
+        phase: BuildPhase;
+        message?: string;
+    };
+}
+export interface Sandbox {
+    /**
+     * The virtual filesystem (sync)
+     */
+    readonly fs: Filesystem;
+    /**
+     * Execute a shell command
+     */
+    exec(command: string): Promise<ExecResult>;
+    /**
+     * The last successful build result (code string + metadata)
+     */
+    readonly lastBuild: BuildSuccess | null;
+    /**
+     * Get the current sandbox state for persistence
+     */
+    getState(): SandboxState;
+    /**
+     * Read a file from the virtual filesystem.
+     *
+     * @param path - Absolute path to the file (e.g., "/src/app.ts")
+     * @returns File contents as a string
+     * @throws If the file does not exist
+     */
+    readFile(path: string): string;
+    /**
+     * Write a file to the virtual filesystem.
+     * Creates parent directories automatically if they don't exist.
+     *
+     * @param path - Absolute path to the file (e.g., "/src/app.ts")
+     * @param content - File contents to write
+     */
+    writeFile(path: string, content: string): void;
+    /**
+     * Subscribe to build events
+     */
+    onBuild(callback: (result: BuildSuccess) => void | Promise<void>): () => void;
+    /**
+     * Install a package from npm.
+     * Updates /package.json and fetches type definitions if typesResolver is configured.
+     *
+     * @param packageSpec - Package specifier (e.g., "lodash", "lodash@4.17.21", "@types/node@20")
+     * @returns Installation result with version and types info
+     *
+     * @example
+     * await sandbox.install("lodash@4.17.21");
+     * await sandbox.install("@tanstack/react-query");
+     */
+    install(packageSpec: string): Promise<InstallResult>;
+    /**
+     * Uninstall a package.
+     * Removes from /package.json and deletes type definition files.
+     *
+     * @param packageName - Package name (e.g., "lodash", "@tanstack/react-query")
+     * @returns Whether the package was removed
+     */
+    uninstall(packageName: string): Promise<UninstallResult>;
+    /**
+     * Build the project.
+     * Reads dependencies from /package.json, optionally typechecks, and bundles.
+     * Returns the bundled code string (does NOT execute it).
+     *
+     * @param options - Build options
+     * @returns Build result - check `success` field to determine outcome
+     */
+    build(options?: SandboxBuildOptions): Promise<BuildResult>;
+    /**
+     * Type check the project.
+     * Reads tsconfig from filesystem and runs the typechecker.
+     *
+     * @param options - Typecheck options
+     * @returns Typecheck result with diagnostics
+     */
+    typecheck(options?: SandboxTypecheckOptions): Promise<TypecheckResult>;
+    /**
+     * Build and run code using the configured executor.
+     *
+     * This is a convenience method that:
+     * 1. Builds the code (typecheck + bundle)
+     * 2. Passes the bundled code to the executor
+     * 3. Returns the execution result
+     *
+     * Requires an executor to be configured when creating Sandlot.
+     *
+     * @param options - Run options (entry point, context, timeout, etc.)
+     * @returns Run result with logs, return value, and any error
+     * @throws If no executor was configured
+     *
+     * @example
+     * ```ts
+     * // Script style - top-level code runs on import
+     * sandbox.writeFile('/index.ts', 'console.log("Hello!")');
+     * const result = await sandbox.run();
+     * console.log(result.logs); // ['Hello!']
+     *
+     * // Main function style - gets context
+     * sandbox.writeFile('/index.ts', `
+     *   export function main(ctx) {
+     *     ctx.log("Args:", ctx.args);
+     *     return { success: true };
+     *   }
+     * `);
+     * const result = await sandbox.run({
+     *   context: { args: ['--verbose'] }
+     * });
+     * console.log(result.returnValue); // { success: true }
+     * ```
+     */
+    run(options?: RunOptions): Promise<RunResult>;
+}
+export interface ExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface SandboxState {
+    files: Record<string, string>;
+}
+export interface Sandlot {
+    /**
+     * Create a new sandbox environment
+     */
+    createSandbox(options?: SandboxOptions): Promise<Sandbox>;
+    /**
+     * The shared module registry (if shared modules were provided)
+     */
+    readonly sharedModules: ISharedModuleRegistry | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "sandlot",
-  "version": "0.1.3",
-  "description": "Browser-based TypeScript sandbox with esbuild bundling and type checking",
+  "version": "0.2.0",
+  "description": "TypeScript sandbox with esbuild bundling and type checking for browser and server",
   "author": "blindmansion",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blindmansion/sandlot.git",
+    "directory": "packages/sandlot"
+  },
   "license": "MIT",
   "keywords": [
     "sandbox",
@@ -22,10 +27,15 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./internal": {
-      "types": "./dist/internal.d.ts",
-      "import": "./dist/internal.js",
-      "default": "./dist/internal.js"
+    "./browser": {
+      "types": "./dist/browser/index.d.ts",
+      "import": "./dist/browser/index.js",
+      "default": "./dist/browser/index.js"
+    },
+    "./node": {
+      "types": "./dist/node/index.d.ts",
+      "import": "./dist/node/index.js",
+      "default": "./dist/node/index.js"
     }
   },
   "files": [
@@ -34,7 +44,7 @@
   ],
   "scripts": {
     "build": "bun run build:js && bun run build:types",
-    "build:js": "bun build ./src/index.ts ./src/internal.ts --outdir ./dist --format esm --packages external",
+    "build:js": "bun build ./src/index.ts ./src/browser/index.ts ./src/node/index.ts --outdir ./dist --format esm --packages external",
     "build:types": "tsc --emitDeclarationOnly",
     "prepublishOnly": "bun run build"
   },
@@ -43,8 +53,17 @@
     "just-bash": "^2.6.0",
     "typescript": "^5.9.3"
   },
+  "peerDependencies": {
+    "esbuild": ">=0.20.0"
+  },
+  "peerDependenciesMeta": {
+    "esbuild": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/bun": "latest",
-    "@types/react": "^19"
+    "@types/react": "^19",
+    "esbuild": "^0.27.2"
   }
 }