just-bash 2.2.0 → 2.3.1

package/dist/commands/browser-excluded.d.ts

@@ -0,0 +1,19 @@
+/**
+ * List of commands that are not available in browser environments.
+ *
+ * These commands are excluded from the browser bundle because they:
+ * - Use Node.js-specific APIs that don't have browser equivalents
+ * - Have dependencies that don't work in browsers
+ *
+ * Note: sqlite3 is opt-in (requires `sqlite: true` option) so it's not
+ * listed here - it will show "command not found" like any other unknown command.
+ *
+ * When a user tries to use one of these commands in a browser environment,
+ * they should get a helpful error message explaining why the command
+ * is not available.
+ */
+export declare const BROWSER_EXCLUDED_COMMANDS: readonly string[];
+/**
+ * Check if a command is browser-excluded
+ */
+export declare function isBrowserExcludedCommand(commandName: string): boolean;

package/dist/commands/registry.d.ts

@@ -1,12 +1,14 @@
 import type { Command } from "../types.js";
-/** All available built-in command names (excludes network commands like curl) */
+/** All available built-in command names (excludes network and sqlite commands) */
 export type CommandName = "echo" | "cat" | "printf" | "ls" | "mkdir" | "touch" | "rm" | "cp" | "mv" | "ln" | "chmod" | "pwd" | "readlink" | "head" | "tail" | "wc" | "stat" | "grep" | "fgrep" | "egrep" | "sed" | "awk" | "sort" | "uniq" | "comm" | "cut" | "paste" | "tr" | "rev" | "nl" | "fold" | "expand" | "unexpand" | "strings" | "split" | "column" | "join" | "tee" | "find" | "basename" | "dirname" | "tree" | "du" | "env" | "printenv" | "alias" | "unalias" | "history" | "xargs" | "true" | "false" | "clear" | "bash" | "sh" | "jq" | "base64" | "diff" | "date" | "sleep" | "timeout" | "seq" | "expr" | "md5sum" | "sha1sum" | "sha256sum" | "file" | "html-to-markdown" | "help" | "which" | "tac" | "hostname" | "od" | "gzip" | "gunzip" | "zcat" | "yq" | "xan";
 /** Network command names (only available when network is configured) */
 export type NetworkCommandName = "curl";
-/** All command names including network commands */
-export type AllCommandName = CommandName | NetworkCommandName;
+/** SQLite command names (only available when sqlite is enabled) */
+export type SqliteCommandName = "sqlite3";
+/** All command names including network and sqlite commands */
+export type AllCommandName = CommandName | NetworkCommandName | SqliteCommandName;
 /**
- * Gets all available command names (excludes network commands)
+ * Gets all available command names (excludes network and sqlite commands)
  */
 export declare function getCommandNames(): string[];
 /**
@@ -23,6 +25,15 @@ export declare function createLazyCommands(filter?: CommandName[]): Command[];
  * These are only registered when network is explicitly configured.
  */
 export declare function createNetworkCommands(): Command[];
+/**
+ * Gets all sqlite command names
+ */
+export declare function getSqliteCommandNames(): string[];
+/**
+ * Creates sqlite commands for registration (sqlite3, etc.)
+ * These are only registered when sqlite is explicitly enabled.
+ */
+export declare function createSqliteCommands(): Command[];
 /**
  * Clears the command cache (for testing)
  */

package/dist/commands/sqlite3/formatters.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Output formatters for sqlite3 command
+ */
+export type OutputMode = "list" | "csv" | "json" | "line" | "column" | "table" | "markdown" | "tabs" | "box" | "quote" | "html" | "ascii";
+export interface FormatOptions {
+    mode: OutputMode;
+    header: boolean;
+    separator: string;
+    nullValue: string;
+    newline: string;
+}
+/**
+ * Format query results according to the specified options
+ */
+export declare function formatOutput(columns: string[], rows: unknown[][], options: FormatOptions): string;

package/dist/commands/sqlite3/sqlite3.d.ts

@@ -0,0 +1,11 @@
+/**
+ * sqlite3 - SQLite database CLI
+ *
+ * Wraps better-sqlite3 to provide SQLite database access through the virtual filesystem.
+ * Databases are loaded from buffers and written back after modifications.
+ *
+ * Queries run in a worker thread with a timeout to prevent runaway queries
+ * (e.g., infinite recursive CTEs) from blocking execution.
+ */
+import type { Command } from "../../types.js";
+export declare const sqlite3Command: Command;

package/dist/commands/sqlite3/worker.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Worker thread for sqlite3 query execution.
+ *
+ * This isolates potentially long-running queries so they can be
+ * terminated if they exceed the timeout.
+ */
+export interface WorkerInput {
+    dbBuffer: Uint8Array | null;
+    sql: string;
+    options: {
+        bail: boolean;
+        echo: boolean;
+    };
+}
+export interface WorkerSuccess {
+    success: true;
+    results: StatementResult[];
+    hasModifications: boolean;
+    dbBuffer: Uint8Array | null;
+}
+export interface StatementResult {
+    type: "data" | "error";
+    columns?: string[];
+    rows?: unknown[][];
+    error?: string;
+}
+export interface WorkerError {
+    success: false;
+    error: string;
+}
+export type WorkerOutput = WorkerSuccess | WorkerError;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export type { BashLogger, BashOptions, ExecOptions } from "./Bash.js";
 export { Bash } from "./Bash.js";
-export type { AllCommandName, CommandName, NetworkCommandName, } from "./commands/registry.js";
-export { getCommandNames, getNetworkCommandNames, } from "./commands/registry.js";
+export type { AllCommandName, CommandName, NetworkCommandName, SqliteCommandName, } from "./commands/registry.js";
+export { getCommandNames, getNetworkCommandNames, getSqliteCommandNames, } from "./commands/registry.js";
 export type { CustomCommand, LazyCommand } from "./custom-commands.js";
 export { defineCommand } from "./custom-commands.js";
 export { InMemoryFs } from "./fs/in-memory-fs/index.js";

package/dist/limits.d.ts

@@ -21,6 +21,8 @@ export interface ExecutionLimits {
     maxSedIterations?: number;
     /** Maximum iterations for jq loops (until, while, repeat) (default: 10000) */
     maxJqIterations?: number;
+    /** Maximum sqlite3 query execution time in milliseconds (default: 5000) */
+    maxSqliteTimeoutMs?: number;
 }
 /**
  * Resolve execution limits by merging user-provided limits with defaults.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "just-bash",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "description": "A simulated bash environment with virtual filesystem",
   "repository": {
     "type": "git",
@@ -52,6 +52,7 @@
   "license": "Apache-2.0",
   "devDependencies": {
     "@biomejs/biome": "^2.3.10",
+    "@types/better-sqlite3": "^7.6.11",
     "@types/ini": "^4.1.1",
     "@types/node": "^25.0.3",
     "@types/papaparse": "^5.5.2",
@@ -63,6 +64,7 @@
     "vitest": "^4.0.16"
   },
   "dependencies": {
+    "better-sqlite3": "^11.9.1",
     "diff": "^8.0.2",
     "fast-xml-parser": "^5.3.3",
     "file-type": "^21.2.0",