sandboxedjs 0.1.19 → 0.1.21

package/dist/index.d.cts

@@ -1289,51 +1289,50 @@ declare class Shell {
 }
 
 /**
- * The Python runtime: MicroPython compiled to WebAssembly, wired to the
- * container's filesystem, argv, environment and standard streams.
+ * The CPython runtime: Pyodide, wired to the container the same way
+ * the other runtimes are — filesystem, argv, environment and standard streams.
  *
- * A fresh interpreter is created per process, which is both correct (no state
- * leaks between runs) and cheap — the WASM module is compiled once and reused,
- * so subsequent instantiations take single-digit milliseconds.
- */
-
-declare const PYTHON_VERSION = "3.4.0";
-/**
- * Which interpreter `python3` is.
+ * This is real CPython, so `sqlite3`, `dataclasses`, `decimal`, `typing` and
+ * the rest of the standard library are present, and `micropip` can install
+ * pure-Python wheels.
+ *
+ * CPython keeps its own library inside the Emscripten filesystem, so:
  *
- * `auto` prefers CPython and falls back to MicroPython, so a host that has not
- * installed Pyodide keeps working exactly as it did before.
+ *  - the container is mounted subtree by subtree rather than over `/`, so
+ *    Pyodide's standard-library files survive;
+ *  - an interpreter costs roughly a second and a half to start, so one is kept
+ *    per container and each program is run in a fresh namespace instead.
  */
-type PythonEngine = "auto" | "cpython" | "micropython";
-interface PythonOptions {
-    /** Interpreter to run. Defaults to `auto`. */
-    engine?: PythonEngine;
-    /** Where Pyodide's assets live; only a browser needs to say. */
-    indexURL?: string;
-    /** URL of the Pyodide ES module, for a browser with no bundler. */
-    pyodideURL?: string;
+
+interface CPythonOptions {
     /**
-     * Absolute URL of `micropython.wasm`.
-     *
-     * Emscripten resolves the binary against the script's own directory, which
-     * is right in Node and wrong in a browser: a bundler rewrites the loader to
-     * a hashed chunk, the guess lands on a path the dev server answers with
-     * `index.html`, and instantiation dies on `expected magic word 00 61 73 6d,
-     * found 3c 21 64 6f` — the first four bytes of `<!doctype`.
-     *
-     * Every bundler spells "give me the URL of this asset" differently, so the
-     * host supplies it rather than this module trying to detect one:
+     * Where Pyodide's own assets live.
      *
-     * ```ts
-     * import wasm from "@micropython/micropython-webassembly-pyscript/micropython.wasm?url";
-     * await createContainer({ pod, python: { wasmUrl: wasm } });
-     * ```
+     * Node resolves them from the installed package, so this is only needed in a
+     * browser, where they are served or taken from a CDN.
      */
-    wasmUrl?: string;
+    indexURL?: string;
+    /**
+     * URL of the Pyodide ES module, for hosts that cannot resolve the package by
+     * name — a browser without a bundler, typically.
+     */
+    moduleURL?: string;
+}
+declare function configureCPython(options?: CPythonOptions): void;
+/** True when this host can start CPython at all. */
+declare function isCPythonAvailable(): Promise<boolean>;
+
+/** The existing Python CLI surface, backed exclusively by CPython/Pyodide. */
+
+declare const PYTHON_VERSION = "3.13";
+interface PythonOptions {
+    /** Where Pyodide's assets live; only a browser normally needs this. */
+    indexURL?: string;
+    /** URL of pyodide.mjs, for browsers without package resolution. */
+    pyodideURL?: string;
 }
 declare function configurePython(options?: PythonOptions): void;
-/** True when a Python interpreter can be started in this process. */
-declare function isPythonAvailable(): Promise<boolean>;
+declare const isPythonAvailable: typeof isCPythonAvailable;
 
 /**
  * A promise-based filesystem façade for host code, shaped like `fs/promises`
@@ -2016,42 +2015,6 @@ declare function buildRootfs(vfs: Vfs, opts?: RootfsOptions): void;
 
 declare const NODE_VERSION = "v22.12.0";
 
-/**
- * The CPython runtime: Pyodide, wired to the container the same way
- * MicroPython is — filesystem, argv, environment and standard streams.
- *
- * This is real CPython, so `sqlite3`, `dataclasses`, `decimal`, `typing` and
- * the rest of the standard library are present, and `micropip` can install
- * pure-Python wheels. MicroPython remains for hosts that do not want a 13 MB
- * interpreter: see `configurePython`.
- *
- * Two things differ from the MicroPython path, and both are forced by CPython
- * keeping its own library inside the Emscripten filesystem:
- *
- *  - the container is mounted subtree by subtree rather than over `/`, so
- *    `/lib/python314.zip` survives;
- *  - an interpreter costs roughly a second and a half to start, so one is kept
- *    per container and each program is run in a fresh namespace instead.
- */
-
-interface CPythonOptions {
-    /**
-     * Where Pyodide's own assets live.
-     *
-     * Node resolves them from the installed package, so this is only needed in a
-     * browser, where they are served or taken from a CDN.
-     */
-    indexURL?: string;
-    /**
-     * URL of the Pyodide ES module, for hosts that cannot resolve the package by
-     * name — a browser without a bundler, typically.
-     */
-    moduleURL?: string;
-}
-declare function configureCPython(options?: CPythonOptions): void;
-/** True when this host can start CPython at all. */
-declare function isCPythonAvailable(): Promise<boolean>;
-
 /**
  * Package managers: `npm`/`npx`/`yarn`/`pnpm` on top of Nodepod's installer,
  * and an `apt`-shaped front end for the things a container image would ship.
@@ -2077,4 +2040,4 @@ declare const NPM_VERSION = "10.9.0";
  * ```
  */
 
-export { ArithError, BufferSink, type CPythonOptions, CallbackSink, type Command, CommandRegistry, Container, ContainerFs, type ContainerOptions, type ContextInit, type Cred, type DirEntry, ERRNO, type Env, type ErrnoCode, type ExecContext, type ExecOptions, type ExecResult, type FileData, FileInput, FileOutput, type GroupEntry, type HttpResponse, IncompleteInputError, type InputStream, type Job, KERNEL_NAME, KERNEL_RELEASE, Kernel, type KernelOptions, type ListeningPort, type MountEntry, NODE_VERSION, NPM_VERSION, type NetInterface, type NetworkOptions, NetworkStack, NullInput, NullOutput, OS_RELEASE, type OutputStream, PYTHON_VERSION, type PasswdEntry, Pipe, Process, type ProcessKind, type ProcessOptions, type ProcessState, ProcessTable, type PythonEngine, type PythonOptions, ROOT_CRED, type ResolvedExecutable, type RootfsOptions, type RunOptions, type RunResult, SIGNALS, SIGNAL_NAMES, Session, type SessionInit, type SessionResult, type SessionRunOptions, Shell, ShellExit, type ShellIO, type ShellInit, Lexer as ShellLexer, type ShellOptions, ShellSyntaxError, type SpawnHandle, Stats, type Stdio, SysError, TeeOutput, Terminal, type TerminalOptions, UserDatabase, Variables, Vfs, type VirtualNode, type VirtualProvider, type WriteOptions, allCommands, applyChmod, braceExpand, buildRootfs, builtinNames, captureStdio, configureCPython, configurePython, createContainer, createContext, createContainer as default, defineCommand, evalArith, exitCodeForSignal, expandPrompt, expandWord, expandWords, fnmatch, formatMode, getBuiltin, glob, globToRegex, hasMagic, installUserland, isBuiltinName, isCPythonAvailable, isPythonAvailable, isSysError, makeCred, normalizeSignal, octalMode, parse as parseShell, parseUmask, path as posixPath, resetPidCounter, shellQuote, strerror, unameInfo };
+export { ArithError, BufferSink, type CPythonOptions, CallbackSink, type Command, CommandRegistry, Container, ContainerFs, type ContainerOptions, type ContextInit, type Cred, type DirEntry, ERRNO, type Env, type ErrnoCode, type ExecContext, type ExecOptions, type ExecResult, type FileData, FileInput, FileOutput, type GroupEntry, type HttpResponse, IncompleteInputError, type InputStream, type Job, KERNEL_NAME, KERNEL_RELEASE, Kernel, type KernelOptions, type ListeningPort, type MountEntry, NODE_VERSION, NPM_VERSION, type NetInterface, type NetworkOptions, NetworkStack, NullInput, NullOutput, OS_RELEASE, type OutputStream, PYTHON_VERSION, type PasswdEntry, Pipe, Process, type ProcessKind, type ProcessOptions, type ProcessState, ProcessTable, type PythonOptions, ROOT_CRED, type ResolvedExecutable, type RootfsOptions, type RunOptions, type RunResult, SIGNALS, SIGNAL_NAMES, Session, type SessionInit, type SessionResult, type SessionRunOptions, Shell, ShellExit, type ShellIO, type ShellInit, Lexer as ShellLexer, type ShellOptions, ShellSyntaxError, type SpawnHandle, Stats, type Stdio, SysError, TeeOutput, Terminal, type TerminalOptions, UserDatabase, Variables, Vfs, type VirtualNode, type VirtualProvider, type WriteOptions, allCommands, applyChmod, braceExpand, buildRootfs, builtinNames, captureStdio, configureCPython, configurePython, createContainer, createContext, createContainer as default, defineCommand, evalArith, exitCodeForSignal, expandPrompt, expandWord, expandWords, fnmatch, formatMode, getBuiltin, glob, globToRegex, hasMagic, installUserland, isBuiltinName, isCPythonAvailable, isPythonAvailable, isSysError, makeCred, normalizeSignal, octalMode, parse as parseShell, parseUmask, path as posixPath, resetPidCounter, shellQuote, strerror, unameInfo };

package/dist/index.d.ts

@@ -1289,51 +1289,50 @@ declare class Shell {
 }
 
 /**
- * The Python runtime: MicroPython compiled to WebAssembly, wired to the
- * container's filesystem, argv, environment and standard streams.
+ * The CPython runtime: Pyodide, wired to the container the same way
+ * the other runtimes are — filesystem, argv, environment and standard streams.
  *
- * A fresh interpreter is created per process, which is both correct (no state
- * leaks between runs) and cheap — the WASM module is compiled once and reused,
- * so subsequent instantiations take single-digit milliseconds.
- */
-
-declare const PYTHON_VERSION = "3.4.0";
-/**
- * Which interpreter `python3` is.
+ * This is real CPython, so `sqlite3`, `dataclasses`, `decimal`, `typing` and
+ * the rest of the standard library are present, and `micropip` can install
+ * pure-Python wheels.
+ *
+ * CPython keeps its own library inside the Emscripten filesystem, so:
  *
- * `auto` prefers CPython and falls back to MicroPython, so a host that has not
- * installed Pyodide keeps working exactly as it did before.
+ *  - the container is mounted subtree by subtree rather than over `/`, so
+ *    Pyodide's standard-library files survive;
+ *  - an interpreter costs roughly a second and a half to start, so one is kept
+ *    per container and each program is run in a fresh namespace instead.
  */
-type PythonEngine = "auto" | "cpython" | "micropython";
-interface PythonOptions {
-    /** Interpreter to run. Defaults to `auto`. */
-    engine?: PythonEngine;
-    /** Where Pyodide's assets live; only a browser needs to say. */
-    indexURL?: string;
-    /** URL of the Pyodide ES module, for a browser with no bundler. */
-    pyodideURL?: string;
+
+interface CPythonOptions {
     /**
-     * Absolute URL of `micropython.wasm`.
-     *
-     * Emscripten resolves the binary against the script's own directory, which
-     * is right in Node and wrong in a browser: a bundler rewrites the loader to
-     * a hashed chunk, the guess lands on a path the dev server answers with
-     * `index.html`, and instantiation dies on `expected magic word 00 61 73 6d,
-     * found 3c 21 64 6f` — the first four bytes of `<!doctype`.
-     *
-     * Every bundler spells "give me the URL of this asset" differently, so the
-     * host supplies it rather than this module trying to detect one:
+     * Where Pyodide's own assets live.
      *
-     * ```ts
-     * import wasm from "@micropython/micropython-webassembly-pyscript/micropython.wasm?url";
-     * await createContainer({ pod, python: { wasmUrl: wasm } });
-     * ```
+     * Node resolves them from the installed package, so this is only needed in a
+     * browser, where they are served or taken from a CDN.
      */
-    wasmUrl?: string;
+    indexURL?: string;
+    /**
+     * URL of the Pyodide ES module, for hosts that cannot resolve the package by
+     * name — a browser without a bundler, typically.
+     */
+    moduleURL?: string;
+}
+declare function configureCPython(options?: CPythonOptions): void;
+/** True when this host can start CPython at all. */
+declare function isCPythonAvailable(): Promise<boolean>;
+
+/** The existing Python CLI surface, backed exclusively by CPython/Pyodide. */
+
+declare const PYTHON_VERSION = "3.13";
+interface PythonOptions {
+    /** Where Pyodide's assets live; only a browser normally needs this. */
+    indexURL?: string;
+    /** URL of pyodide.mjs, for browsers without package resolution. */
+    pyodideURL?: string;
 }
 declare function configurePython(options?: PythonOptions): void;
-/** True when a Python interpreter can be started in this process. */
-declare function isPythonAvailable(): Promise<boolean>;
+declare const isPythonAvailable: typeof isCPythonAvailable;
 
 /**
  * A promise-based filesystem façade for host code, shaped like `fs/promises`
@@ -2016,42 +2015,6 @@ declare function buildRootfs(vfs: Vfs, opts?: RootfsOptions): void;
 
 declare const NODE_VERSION = "v22.12.0";
 
-/**
- * The CPython runtime: Pyodide, wired to the container the same way
- * MicroPython is — filesystem, argv, environment and standard streams.
- *
- * This is real CPython, so `sqlite3`, `dataclasses`, `decimal`, `typing` and
- * the rest of the standard library are present, and `micropip` can install
- * pure-Python wheels. MicroPython remains for hosts that do not want a 13 MB
- * interpreter: see `configurePython`.
- *
- * Two things differ from the MicroPython path, and both are forced by CPython
- * keeping its own library inside the Emscripten filesystem:
- *
- *  - the container is mounted subtree by subtree rather than over `/`, so
- *    `/lib/python314.zip` survives;
- *  - an interpreter costs roughly a second and a half to start, so one is kept
- *    per container and each program is run in a fresh namespace instead.
- */
-
-interface CPythonOptions {
-    /**
-     * Where Pyodide's own assets live.
-     *
-     * Node resolves them from the installed package, so this is only needed in a
-     * browser, where they are served or taken from a CDN.
-     */
-    indexURL?: string;
-    /**
-     * URL of the Pyodide ES module, for hosts that cannot resolve the package by
-     * name — a browser without a bundler, typically.
-     */
-    moduleURL?: string;
-}
-declare function configureCPython(options?: CPythonOptions): void;
-/** True when this host can start CPython at all. */
-declare function isCPythonAvailable(): Promise<boolean>;
-
 /**
  * Package managers: `npm`/`npx`/`yarn`/`pnpm` on top of Nodepod's installer,
  * and an `apt`-shaped front end for the things a container image would ship.
@@ -2077,4 +2040,4 @@ declare const NPM_VERSION = "10.9.0";
  * ```
  */
 
-export { ArithError, BufferSink, type CPythonOptions, CallbackSink, type Command, CommandRegistry, Container, ContainerFs, type ContainerOptions, type ContextInit, type Cred, type DirEntry, ERRNO, type Env, type ErrnoCode, type ExecContext, type ExecOptions, type ExecResult, type FileData, FileInput, FileOutput, type GroupEntry, type HttpResponse, IncompleteInputError, type InputStream, type Job, KERNEL_NAME, KERNEL_RELEASE, Kernel, type KernelOptions, type ListeningPort, type MountEntry, NODE_VERSION, NPM_VERSION, type NetInterface, type NetworkOptions, NetworkStack, NullInput, NullOutput, OS_RELEASE, type OutputStream, PYTHON_VERSION, type PasswdEntry, Pipe, Process, type ProcessKind, type ProcessOptions, type ProcessState, ProcessTable, type PythonEngine, type PythonOptions, ROOT_CRED, type ResolvedExecutable, type RootfsOptions, type RunOptions, type RunResult, SIGNALS, SIGNAL_NAMES, Session, type SessionInit, type SessionResult, type SessionRunOptions, Shell, ShellExit, type ShellIO, type ShellInit, Lexer as ShellLexer, type ShellOptions, ShellSyntaxError, type SpawnHandle, Stats, type Stdio, SysError, TeeOutput, Terminal, type TerminalOptions, UserDatabase, Variables, Vfs, type VirtualNode, type VirtualProvider, type WriteOptions, allCommands, applyChmod, braceExpand, buildRootfs, builtinNames, captureStdio, configureCPython, configurePython, createContainer, createContext, createContainer as default, defineCommand, evalArith, exitCodeForSignal, expandPrompt, expandWord, expandWords, fnmatch, formatMode, getBuiltin, glob, globToRegex, hasMagic, installUserland, isBuiltinName, isCPythonAvailable, isPythonAvailable, isSysError, makeCred, normalizeSignal, octalMode, parse as parseShell, parseUmask, path as posixPath, resetPidCounter, shellQuote, strerror, unameInfo };
+export { ArithError, BufferSink, type CPythonOptions, CallbackSink, type Command, CommandRegistry, Container, ContainerFs, type ContainerOptions, type ContextInit, type Cred, type DirEntry, ERRNO, type Env, type ErrnoCode, type ExecContext, type ExecOptions, type ExecResult, type FileData, FileInput, FileOutput, type GroupEntry, type HttpResponse, IncompleteInputError, type InputStream, type Job, KERNEL_NAME, KERNEL_RELEASE, Kernel, type KernelOptions, type ListeningPort, type MountEntry, NODE_VERSION, NPM_VERSION, type NetInterface, type NetworkOptions, NetworkStack, NullInput, NullOutput, OS_RELEASE, type OutputStream, PYTHON_VERSION, type PasswdEntry, Pipe, Process, type ProcessKind, type ProcessOptions, type ProcessState, ProcessTable, type PythonOptions, ROOT_CRED, type ResolvedExecutable, type RootfsOptions, type RunOptions, type RunResult, SIGNALS, SIGNAL_NAMES, Session, type SessionInit, type SessionResult, type SessionRunOptions, Shell, ShellExit, type ShellIO, type ShellInit, Lexer as ShellLexer, type ShellOptions, ShellSyntaxError, type SpawnHandle, Stats, type Stdio, SysError, TeeOutput, Terminal, type TerminalOptions, UserDatabase, Variables, Vfs, type VirtualNode, type VirtualProvider, type WriteOptions, allCommands, applyChmod, braceExpand, buildRootfs, builtinNames, captureStdio, configureCPython, configurePython, createContainer, createContext, createContainer as default, defineCommand, evalArith, exitCodeForSignal, expandPrompt, expandWord, expandWords, fnmatch, formatMode, getBuiltin, glob, globToRegex, hasMagic, installUserland, isBuiltinName, isCPythonAvailable, isPythonAvailable, isSysError, makeCred, normalizeSignal, octalMode, parse as parseShell, parseUmask, path as posixPath, resetPidCounter, shellQuote, strerror, unameInfo };