just-bash 2.9.8 → 2.10.1

package/dist/fs/in-memory-fs/in-memory-fs.d.ts

@@ -1,5 +1,5 @@
-import type { BufferEncoding, CpOptions, DirectoryEntry, DirentEntry, FileContent, FileEntry, FsEntry, FsStat, IFileSystem, InitialFiles, MkdirOptions, ReadFileOptions, RmOptions, SymlinkEntry, WriteFileOptions } from "../interface.js";
-export type { BufferEncoding, FileContent, FileEntry, DirectoryEntry, SymlinkEntry, FsEntry, FsStat, IFileSystem, };
+import type { BufferEncoding, CpOptions, DirectoryEntry, DirentEntry, FileContent, FileEntry, FsEntry, FsStat, IFileSystem, InitialFiles, LazyFileEntry, MkdirOptions, ReadFileOptions, RmOptions, SymlinkEntry, WriteFileOptions } from "../interface.js";
+export type { BufferEncoding, FileContent, FileEntry, LazyFileEntry, DirectoryEntry, SymlinkEntry, FsEntry, FsStat, IFileSystem, };
 export interface FsData {
     [path: string]: FsEntry;
 }
@@ -13,6 +13,19 @@ export declare class InMemoryFs implements IFileSystem {
         mode?: number;
         mtime?: Date;
     }): void;
+    /**
+     * Store a lazy file entry whose content is provided by a function on first read.
+     * Writing to the path replaces the lazy entry, so the function is never called.
+     */
+    writeFileLazy(path: string, lazy: () => string | Uint8Array | Promise<string | Uint8Array>, metadata?: {
+        mode?: number;
+        mtime?: Date;
+    }): void;
+    /**
+     * Materialize a lazy file entry, replacing it with a concrete FileEntry.
+     * Returns the materialized FileEntry.
+     */
+    private materializeLazy;
     readFile(path: string, options?: ReadFileOptions | BufferEncoding): Promise<string>;
     readFileBuffer(path: string): Promise<Uint8Array>;
     writeFile(path: string, content: FileContent, options?: WriteFileOptions | BufferEncoding): Promise<void>;

package/dist/fs/interface.d.ts

@@ -38,7 +38,13 @@ export interface SymlinkEntry {
     mode: number;
     mtime: Date;
 }
-export type FsEntry = FileEntry | DirectoryEntry | SymlinkEntry;
+export interface LazyFileEntry {
+    type: "file";
+    lazy: () => string | Uint8Array | Promise<string | Uint8Array>;
+    mode: number;
+    mtime: Date;
+}
+export type FsEntry = FileEntry | LazyFileEntry | DirectoryEntry | SymlinkEntry;
 /**
  * Directory entry with type information (similar to Node's Dirent)
  * Used by readdirWithFileTypes for efficient directory listing without stat calls
@@ -210,9 +216,13 @@ export interface FileInit {
     mtime?: Date;
 }
 /**
- * Initial files can be simple content or extended options with metadata
+ * Lazy file provider - a function whose return value becomes the file content on first read
+ */
+export type LazyFileProvider = () => string | Uint8Array | Promise<string | Uint8Array>;
+/**
+ * Initial files can be simple content, extended options with metadata, or lazy providers
  */
-export type InitialFiles = Record<string, FileContent | FileInit>;
+export type InitialFiles = Record<string, FileContent | FileInit | LazyFileProvider>;
 /**
  * Factory function type for creating filesystem instances
  */

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export type { CommandNode, PipelineNode, ScriptNode, SimpleCommandNode, StatementNode, WordNode, } from "./ast/types.js";
 export type { BashLogger, BashOptions, ExecOptions } from "./Bash.js";
 export { Bash } from "./Bash.js";
 export type { AllCommandName, CommandName, NetworkCommandName, PythonCommandName, } from "./commands/registry.js";
@@ -5,14 +6,22 @@ export { getCommandNames, getNetworkCommandNames, getPythonCommandNames, } from
 export type { CustomCommand, LazyCommand } from "./custom-commands.js";
 export { defineCommand } from "./custom-commands.js";
 export { InMemoryFs } from "./fs/in-memory-fs/index.js";
-export type { BufferEncoding, CpOptions, DirectoryEntry, FileContent, FileEntry, FileInit, FileSystemFactory, FsEntry, FsStat, InitialFiles, MkdirOptions, RmOptions, SymlinkEntry, } from "./fs/interface.js";
+export type { BufferEncoding, CpOptions, DirectoryEntry, FileContent, FileEntry, FileInit, FileSystemFactory, FsEntry, FsStat, InitialFiles, LazyFileEntry, LazyFileProvider, MkdirOptions, RmOptions, SymlinkEntry, } from "./fs/interface.js";
 export { MountableFs, type MountableFsOptions, type MountConfig, } from "./fs/mountable-fs/index.js";
 export { OverlayFs, type OverlayFsOptions } from "./fs/overlay-fs/index.js";
 export { ReadWriteFs, type ReadWriteFsOptions, } from "./fs/read-write-fs/index.js";
 export type { NetworkConfig } from "./network/index.js";
 export { NetworkAccessDeniedError, RedirectNotAllowedError, TooManyRedirectsError, } from "./network/index.js";
+export { parse } from "./parser/parser.js";
 export type { CommandFinished as SandboxCommandFinished, OutputMessage, SandboxOptions, WriteFilesInput, } from "./sandbox/index.js";
 export { Command as SandboxCommand, Sandbox } from "./sandbox/index.js";
 export type { DefenseInDepthConfig, DefenseInDepthHandle, DefenseInDepthStats, SecurityViolation, SecurityViolationType, } from "./security/index.js";
 export { createConsoleViolationCallback, DefenseInDepthBox, SecurityViolationError, SecurityViolationLogger, } from "./security/index.js";
+export { BashTransformPipeline } from "./transform/pipeline.js";
+export type { CommandCollectorMetadata } from "./transform/plugins/command-collector.js";
+export { CommandCollectorPlugin } from "./transform/plugins/command-collector.js";
+export type { TeeFileInfo, TeePluginMetadata, TeePluginOptions, } from "./transform/plugins/tee-plugin.js";
+export { TeePlugin } from "./transform/plugins/tee-plugin.js";
+export { serialize } from "./transform/serialize.js";
+export type { BashTransformResult, TransformContext, TransformPlugin, TransformResult, } from "./transform/types.js";
 export type { BashExecResult, Command, CommandContext, ExecResult, IFileSystem, } from "./types.js";

package/dist/types.d.ts

@@ -18,6 +18,7 @@ export interface ExecResult {
 /** Result from BashEnv.exec() - always includes env */
 export interface BashExecResult extends ExecResult {
     env: Record<string, string>;
+    metadata?: Record<string, unknown>;
 }
 /** Options for exec calls within commands (internal API) */
 export interface CommandExecOptions {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "just-bash",
-  "version": "2.9.8",
+  "version": "2.10.1",
   "description": "A simulated bash environment with virtual filesystem",
   "repository": {
     "type": "git",