@fuzdev/fuz_app 0.26.0 → 0.27.0

package/dist/runtime/deno.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deno.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/runtime/deno.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,WAAW,EAA4B,MAAM,WAAW,CAAC;AAsCtE;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,KAAG,WAwEhE,CAAC"}
+{"version":3,"file":"deno.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/runtime/deno.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,WAAW,EAA4B,MAAM,WAAW,CAAC;AAwDtE;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,aAAa,CAAC,MAAM,CAAC,KAAG,WA4HhE,CAAC"}

package/dist/runtime/deno.js

@@ -38,6 +38,33 @@ export const create_deno_runtime = (args) => ({
     mkdir: (path, options) => Deno.mkdir(path, options),
     read_text_file: (path) => Deno.readTextFile(path),
     read_file: (path) => Deno.readFile(path),
+    read_text_from_offset: async (path, offset) => {
+        const s = await Deno.stat(path);
+        const file_size = s.size;
+        const bytes_to_read = Math.max(0, file_size - offset);
+        if (bytes_to_read === 0)
+            return { content: '', bytes_read: 0, file_size };
+        const handle = await Deno.open(path, { read: true });
+        try {
+            await handle.seek(offset, Deno.SeekMode.Start);
+            const buffer = new Uint8Array(bytes_to_read);
+            const bytes_read = (await handle.read(buffer)) ?? 0;
+            return {
+                content: new TextDecoder().decode(buffer.subarray(0, bytes_read)),
+                bytes_read,
+                file_size,
+            };
+        }
+        finally {
+            handle.close();
+        }
+    },
+    readdir: async (path) => {
+        const names = [];
+        for await (const entry of Deno.readDir(path))
+            names.push(entry.name);
+        return names;
+    },
     write_text_file: (path, content) => Deno.writeTextFile(path, content),
     write_file: (path, data) => Deno.writeFile(path, data),
     rename: (old_path, new_path) => Deno.rename(old_path, new_path),
@@ -45,20 +72,46 @@ export const create_deno_runtime = (args) => ({
     // === HTTP ===
     fetch: globalThis.fetch,
     // === Local Commands ===
-    run_command: async (cmd, args) => {
+    run_command: async (cmd, args, options) => {
         try {
-            const proc = new Deno.Command(cmd, {
-                args,
-                stdout: 'piped',
-                stderr: 'piped',
-            });
-            const result = await proc.output();
-            return {
-                success: result.code === 0,
-                code: result.code,
-                stdout: new TextDecoder().decode(result.stdout),
-                stderr: new TextDecoder().decode(result.stderr),
-            };
+            const controller = options?.timeout_ms !== undefined ? new AbortController() : null;
+            const signal = controller && options?.signal
+                ? AbortSignal.any([controller.signal, options.signal])
+                : (controller?.signal ?? options?.signal);
+            const timer = controller && options?.timeout_ms !== undefined
+                ? setTimeout(() => controller.abort(), options.timeout_ms)
+                : null;
+            let timed_out = false;
+            if (controller) {
+                controller.signal.addEventListener('abort', () => {
+                    if (options?.signal?.aborted)
+                        return;
+                    timed_out = true;
+                }, { once: true });
+            }
+            try {
+                const proc = new Deno.Command(cmd, {
+                    args,
+                    cwd: options?.cwd,
+                    signal,
+                    stdout: 'piped',
+                    stderr: 'piped',
+                });
+                const result = await proc.output();
+                const base = {
+                    success: result.code === 0 && !timed_out,
+                    code: result.code,
+                    stdout: new TextDecoder().decode(result.stdout),
+                    stderr: new TextDecoder().decode(result.stderr),
+                };
+                if (options?.timeout_ms !== undefined)
+                    base.timed_out = timed_out;
+                return base;
+            }
+            finally {
+                if (timer !== null)
+                    clearTimeout(timer);
+            }
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);

package/dist/runtime/deps.d.ts

@@ -16,12 +16,28 @@ export interface StatResult {
 }
 /**
  * Result of executing a command.
+ *
+ * `timed_out` is present only when `timeout_ms` was passed in `RunCommandOptions`
+ * and the process was killed after exceeding the timeout. Callers that pass
+ * `timeout_ms` should check this flag to distinguish timeout from exit-code failure.
  */
 export interface CommandResult {
     success: boolean;
     code: number;
     stdout: string;
     stderr: string;
+    timed_out?: boolean;
+}
+/**
+ * Options for `run_command`.
+ */
+export interface RunCommandOptions {
+    /** Working directory for the child process. */
+    cwd?: string;
+    /** AbortSignal to terminate the child process. */
+    signal?: AbortSignal;
+    /** Kill the process and return `timed_out: true` after this many milliseconds. */
+    timeout_ms?: number;
 }
 /**
  * Environment variable access.
@@ -32,16 +48,37 @@ export interface EnvDeps {
     /** Set an environment variable. */
     env_set: (name: string, value: string) => void;
 }
+/**
+ * Result of reading text from a byte offset.
+ */
+export interface ReadTextFromOffsetResult {
+    /** Decoded text content read from the offset. */
+    content: string;
+    /** Number of bytes actually read. */
+    bytes_read: number;
+    /** Total file size at the time of the read (for truncation detection). */
+    file_size: number;
+}
 /**
  * File system read operations.
  */
 export interface FsReadDeps {
     /** Get file/directory stats, or null if path doesn't exist. */
     stat: (path: string) => Promise<StatResult | null>;
-    /** Read a file as text. */
+    /** Read a file as text. Throws if the file does not exist. */
     read_text_file: (path: string) => Promise<string>;
-    /** Read a file as bytes. */
+    /** Read a file as bytes. Throws if the file does not exist. */
     read_file: (path: string) => Promise<Uint8Array>;
+    /**
+     * Read text starting from a byte offset. Throws if the file does not exist.
+     *
+     * Returns `content`, `bytes_read`, and `file_size` so callers can detect
+     * truncation (when `file_size < offset`) and tail incrementally without
+     * re-reading the whole file.
+     */
+    read_text_from_offset: (path: string, offset: number) => Promise<ReadTextFromOffsetResult>;
+    /** List directory entries (names, not full paths). Throws if the directory does not exist. */
+    readdir: (path: string) => Promise<Array<string>>;
 }
 /**
  * File system write operations.
@@ -71,8 +108,15 @@ export interface FsRemoveDeps {
  * Command execution.
  */
 export interface CommandDeps {
-    /** Run a command and return the result. */
-    run_command: (cmd: string, args: Array<string>) => Promise<CommandResult>;
+    /**
+     * Run a command and return the result. Never throws — failures surface as
+     * `success: false`.
+     *
+     * `options.cwd` sets the child's working directory. `options.signal` aborts
+     * the child when the signal fires. `options.timeout_ms` kills the child
+     * after the given duration and returns `timed_out: true` on the result.
+     */
+    run_command: (cmd: string, args: Array<string>, options?: RunCommandOptions) => Promise<CommandResult>;
 }
 /**
  * HTTP fetch capability.

package/dist/runtime/deps.d.ts.map

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

package/dist/runtime/mock.d.ts

@@ -7,7 +7,7 @@
  *
  * @module
  */
-import type { RuntimeDeps, CommandResult } from './deps.js';
+import type { RuntimeDeps, CommandResult, RunCommandOptions } from './deps.js';
 /**
  * Mock `RuntimeDeps` with observable state for assertions.
  */
@@ -22,10 +22,11 @@ export interface MockRuntime extends RuntimeDeps {
     mock_dirs: Set<string>;
     /** Exit calls recorded (exit codes). */
     exit_calls: Array<number>;
-    /** Commands executed. */
+    /** Commands executed. Captures `options` when passed so tests can assert cwd/timeout/signal. */
     command_calls: Array<{
         cmd: string;
         args: Array<string>;
+        options?: RunCommandOptions;
     }>;
     /** Commands executed with inherit. */
     command_inherit_calls: Array<{

package/dist/runtime/mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/runtime/mock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAc,aAAa,EAAC,MAAM,WAAW,CAAC;AAItE;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,kCAAkC;IAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,0CAA0C;IAC1C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,+CAA+C;IAC/C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,mCAAmC;IACnC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,wCAAwC;IACxC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,yBAAyB;IACzB,aAAa,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAC,CAAC,CAAC;IACzD,sCAAsC;IACtC,qBAAqB,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAC,CAAC,CAAC;IACjE,8BAA8B;IAC9B,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,4CAA4C;IAC5C,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACjD,yCAAyC;IACzC,YAAY,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,4BAA4B;IAC5B,WAAW,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAAC,CAAC,CAAC;IACxE,wDAAwD;IACxD,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAM,KAAK,CAAC,MAAM,CAAM,KAAG,WA4K9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,WAAW,KAAG,IAazD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,WAAW,EAAE,OAAO,MAAM,KAAG,IAEpE,CAAC;AAEF;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;CAKxB"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/runtime/mock.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAc,aAAa,EAAE,iBAAiB,EAAC,MAAM,WAAW,CAAC;AAIzF;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,kCAAkC;IAClC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,0CAA0C;IAC1C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,+CAA+C;IAC/C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,mCAAmC;IACnC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACvB,wCAAwC;IACxC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,gGAAgG;IAChG,aAAa,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;KAAC,CAAC,CAAC;IACtF,sCAAsC;IACtC,qBAAqB,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAC,CAAC,CAAC;IACjE,8BAA8B;IAC9B,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,4CAA4C;IAC5C,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACjD,yCAAyC;IACzC,YAAY,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,4BAA4B;IAC5B,WAAW,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,WAAW,CAAA;KAAC,CAAC,CAAC;IACxE,wDAAwD;IACxD,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAM,KAAK,CAAC,MAAM,CAAM,KAAG,WAkO9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,WAAW,KAAG,IAazD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,WAAW,EAAE,OAAO,MAAM,KAAG,IAEpE,CAAC;AAEF;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM;CAKxB"}

package/dist/runtime/mock.js

@@ -114,6 +114,55 @@ export const create_mock_runtime = (args = []) => {
             error.code = 'ENOENT';
             throw error;
         },
+        read_text_from_offset: async (path, offset) => {
+            let bytes;
+            const stored_bytes = mock_fs_bytes.get(path);
+            if (stored_bytes !== undefined) {
+                bytes = stored_bytes;
+            }
+            else {
+                const content = mock_fs.get(path);
+                if (content === undefined) {
+                    const error = new Error(`ENOENT: no such file or directory: ${path}`);
+                    error.code = 'ENOENT';
+                    throw error;
+                }
+                bytes = new TextEncoder().encode(content);
+            }
+            const file_size = bytes.length;
+            const bytes_to_read = Math.max(0, file_size - offset);
+            if (bytes_to_read === 0)
+                return { content: '', bytes_read: 0, file_size };
+            const slice = bytes.subarray(offset, offset + bytes_to_read);
+            return {
+                content: new TextDecoder().decode(slice),
+                bytes_read: slice.length,
+                file_size,
+            };
+        },
+        readdir: async (path) => {
+            const prefix = path.endsWith('/') ? path : path + '/';
+            const seen = new Set();
+            const collect = (key) => {
+                if (!key.startsWith(prefix))
+                    return;
+                const rest = key.slice(prefix.length);
+                const slash = rest.indexOf('/');
+                seen.add(slash === -1 ? rest : rest.slice(0, slash));
+            };
+            for (const key of mock_fs.keys())
+                collect(key);
+            for (const key of mock_fs_bytes.keys())
+                collect(key);
+            for (const key of mock_dirs)
+                collect(key);
+            if (seen.size === 0 && !mock_dirs.has(path)) {
+                const error = new Error(`ENOENT: no such file or directory: ${path}`);
+                error.code = 'ENOENT';
+                throw error;
+            }
+            return Array.from(seen).sort();
+        },
         write_text_file: async (path, content) => {
             mock_fs.set(path, content);
         },
@@ -163,13 +212,20 @@ export const create_mock_runtime = (args = []) => {
             throw new TypeError(`fetch failed (no mock for ${url})`);
         },
         // === Local Commands ===
-        run_command: async (cmd, args) => {
-            command_calls.push({ cmd, args });
+        run_command: async (cmd, args, options) => {
+            command_calls.push(options ? { cmd, args, options } : { cmd, args });
             const key = `${cmd} ${args.join(' ')}`;
             const mocked = mock_command_results.get(key);
-            if (mocked)
+            if (mocked) {
+                if (options?.timeout_ms !== undefined && mocked.timed_out === undefined) {
+                    return { ...mocked, timed_out: false };
+                }
                 return mocked;
-            return { success: true, code: 0, stdout: '', stderr: '' };
+            }
+            const result = { success: true, code: 0, stdout: '', stderr: '' };
+            if (options?.timeout_ms !== undefined)
+                result.timed_out = false;
+            return result;
         },
         run_command_inherit: async (cmd, args) => {
             command_inherit_calls.push({ cmd, args });

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

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/runtime/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAC,WAAW,EAA4B,MAAM,WAAW,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC/B,OAAM,aAAa,CAAC,MAAM,CAAyB,KACjD,WAkHD,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"../src/lib/","sources":["../../src/lib/runtime/node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAAC,WAAW,EAA4B,MAAM,WAAW,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAC/B,OAAM,aAAa,CAAC,MAAM,CAAyB,KACjD,WAmKD,CAAC"}

package/dist/runtime/node.js

@@ -8,7 +8,7 @@
  */
 import { Buffer } from 'node:buffer';
 import { spawn } from 'node:child_process';
-import { stat, mkdir, readFile, writeFile, rename, rm } from 'node:fs/promises';
+import { stat, mkdir, readFile, readdir, writeFile, rename, rm, open } from 'node:fs/promises';
 import process from 'node:process';
 /**
  * Create a `RuntimeDeps` backed by Node.js APIs.
@@ -42,6 +42,27 @@ export const create_node_runtime = (args = process.argv.slice(2)) => ({
     },
     read_text_file: (path) => readFile(path, 'utf-8'),
     read_file: (path) => readFile(path).then((buf) => new Uint8Array(buf)),
+    read_text_from_offset: async (path, offset) => {
+        const s = await stat(path);
+        const file_size = s.size;
+        const bytes_to_read = Math.max(0, file_size - offset);
+        if (bytes_to_read === 0)
+            return { content: '', bytes_read: 0, file_size };
+        const handle = await open(path, 'r');
+        try {
+            const buffer = Buffer.alloc(bytes_to_read);
+            const { bytesRead } = await handle.read(buffer, 0, bytes_to_read, offset);
+            return {
+                content: buffer.toString('utf-8', 0, bytesRead),
+                bytes_read: bytesRead,
+                file_size,
+            };
+        }
+        finally {
+            await handle.close();
+        }
+    },
+    readdir: (path) => readdir(path),
     write_text_file: (path, content) => writeFile(path, content, 'utf-8'),
     write_file: (path, data) => writeFile(path, data),
     rename: (old_path, new_path) => rename(old_path, new_path),
@@ -49,17 +70,45 @@ export const create_node_runtime = (args = process.argv.slice(2)) => ({
     // === HTTP ===
     fetch: globalThis.fetch,
     // === Local Commands ===
-    run_command: (cmd, args) => {
+    run_command: (cmd, args, options) => {
         return new Promise((resolve) => {
             const proc = spawn(cmd, args, {
                 stdio: ['ignore', 'pipe', 'pipe'],
+                cwd: options?.cwd,
             });
             const stdout_chunks = [];
             const stderr_chunks = [];
+            let timed_out = false;
+            let done = false;
+            const finish = (result) => {
+                if (done)
+                    return;
+                done = true;
+                if (timer !== null)
+                    clearTimeout(timer);
+                if (options?.signal)
+                    options.signal.removeEventListener('abort', on_abort);
+                resolve(result);
+            };
+            const on_abort = () => {
+                proc.kill();
+            };
+            const timer = options?.timeout_ms !== undefined
+                ? setTimeout(() => {
+                    timed_out = true;
+                    proc.kill();
+                }, options.timeout_ms)
+                : null;
+            if (options?.signal) {
+                if (options.signal.aborted)
+                    proc.kill();
+                else
+                    options.signal.addEventListener('abort', on_abort, { once: true });
+            }
             proc.stdout.on('data', (chunk) => stdout_chunks.push(chunk));
             proc.stderr.on('data', (chunk) => stderr_chunks.push(chunk));
             proc.on('error', (error) => {
-                resolve({
+                finish({
                     success: false,
                     code: 1,
                     stdout: '',
@@ -67,12 +116,15 @@ export const create_node_runtime = (args = process.argv.slice(2)) => ({
                 });
             });
             proc.on('close', (code) => {
-                resolve({
-                    success: code === 0,
+                const result = {
+                    success: code === 0 && !timed_out,
                     code: code ?? 1,
                     stdout: Buffer.concat(stdout_chunks).toString('utf-8').trim(),
                     stderr: Buffer.concat(stderr_chunks).toString('utf-8').trim(),
-                });
+                };
+                if (options?.timeout_ms !== undefined)
+                    result.timed_out = timed_out;
+                finish(result);
             });
         });
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_app",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "fullstack app library",
   "glyph": "🗝",
   "logo": "logo.svg",