just-bash 2.9.7 → 2.10.0

package/README.md

@@ -26,6 +26,7 @@ Supports optional network access via `curl` with secure-by-default URL filtering
 - [Default Layout](#default-layout)
 - [Network Access](#network-access)
 - [Execution Protection](#execution-protection)
+- [AST Transform Plugins](#ast-transform-plugins)
 - [Development](#development)
 
 ## Security model
@@ -435,6 +436,30 @@ const env = new Bash({
 
 All limits have sensible defaults. Error messages include hints on which limit to increase. Feel free to increase if your scripts intentionally go beyond them.
 
+## AST Transform Plugins
+
+Parse bash scripts into an AST, run transform plugins, and serialize back to executable bash. Useful for instrumenting scripts (e.g., capturing per-command stdout/stderr) or analyzing them (e.g., extracting command names) before execution.
+
+```typescript
+import { Bash, BashTransformPipeline, TeePlugin, CommandCollectorPlugin } from "just-bash";
+
+// Standalone pipeline — output can be run by any shell
+const pipeline = new BashTransformPipeline()
+  .use(new TeePlugin({ outputDir: "/tmp/logs" }))
+  .use(new CommandCollectorPlugin());
+const result = pipeline.transform("echo hello | grep hello");
+result.script;             // transformed bash string
+result.metadata.commands;  // ["echo", "grep", "tee"]
+
+// Integrated API — exec() auto-applies transforms and returns metadata
+const bash = new Bash();
+bash.registerTransformPlugin(new CommandCollectorPlugin());
+const execResult = await bash.exec("echo hello | grep hello");
+execResult.metadata?.commands; // ["echo", "grep"]
+```
+
+See [src/transform/README.md](src/transform/README.md) for the full API, built-in plugins, and how to write custom plugins.
+
 ## Development
 
 ```bash

package/dist/Bash.d.ts

@@ -13,6 +13,7 @@ import type { IFileSystem, InitialFiles } from "./fs/interface.js";
 import { type ExecutionLimits } from "./limits.js";
 import { type NetworkConfig } from "./network/index.js";
 import type { DefenseInDepthConfig } from "./security/types.js";
+import type { BashTransformResult, TransformPlugin } from "./transform/types.js";
 import type { BashExecResult, Command, FeatureCoverageWriter, TraceCallback } from "./types.js";
 export type { ExecutionLimits } from "./limits.js";
 /**
@@ -167,6 +168,7 @@ export declare class Bash {
     private logger?;
     private defenseInDepthConfig?;
     private coverageWriter?;
+    private transformPlugins;
     private state;
     constructor(options?: BashOptions);
     registerCommand(command: Command): void;
@@ -176,4 +178,6 @@ export declare class Bash {
     writeFile(path: string, content: string): Promise<void>;
     getCwd(): string;
     getEnv(): Record<string, string>;
+    registerTransformPlugin(plugin: TransformPlugin<any>): void;
+    transform(commandLine: string): BashTransformResult;
 }

package/dist/bin/chunks/worker.js

@@ -6,6 +6,8 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/commands/python3/worker.ts
+import { createRequire } from "node:module";
+import { dirname } from "node:path";
 import { parentPort, workerData } from "node:worker_threads";
 import { loadPyodide } from "pyodide";
 
@@ -208,9 +210,9 @@ var IS_BROWSER = typeof __BROWSER__ !== "undefined" && __BROWSER__;
 var AsyncLocalStorageClass = null;
 if (!IS_BROWSER) {
   try {
-    const { createRequire } = await import("node:module");
-    const require2 = createRequire(import.meta.url);
-    const asyncHooks = require2("node:async_hooks");
+    const { createRequire: createRequire2 } = await import("node:module");
+    const require3 = createRequire2(import.meta.url);
+    const asyncHooks = require3("node:async_hooks");
     AsyncLocalStorageClass = asyncHooks.AsyncLocalStorage;
   } catch (e) {
     console.debug(
@@ -1314,6 +1316,8 @@ var SyncFsBackend = class {
 // src/commands/python3/worker.ts
 var pyodideInstance = null;
 var pyodideLoading = null;
+var require2 = createRequire(import.meta.url);
+var pyodideIndexURL = `${dirname(require2.resolve("pyodide/pyodide.mjs"))}/`;
 async function getPyodide() {
   if (pyodideInstance) {
     return pyodideInstance;
@@ -1321,7 +1325,7 @@ async function getPyodide() {
   if (pyodideLoading) {
     return pyodideLoading;
   }
-  pyodideLoading = loadPyodide();
+  pyodideLoading = loadPyodide({ indexURL: pyodideIndexURL });
   pyodideInstance = await pyodideLoading;
   return pyodideInstance;
 }