@nimbus-sh/core 0.5.0 → 0.7.0

package/dist/substrate/lifo/commands/types.d.ts

@@ -3,9 +3,8 @@ import type { VfsCred } from '../../../runtime/os-contracts.js';
 export interface CommandOutputStream {
     write(text: string): void;
     /**
-     * Present on sinks that store bytes verbatim (files, `/dev/null`). Textual
-     * sinks — the terminal, shell pipes — omit it and take decoded text, since
-     * they have no way to carry a byte that is not text.
+     * Present on sinks that store bytes verbatim — files, `/dev/null`, and
+     * byte-capable shell pipes. Sinks without it take decoded text instead.
      */
     writeBytes?(bytes: Uint8Array): void;
     /**
@@ -20,7 +19,12 @@ export interface CommandInputStream {
     read(): Promise<string | null>;
     readAll(): Promise<string>;
     readLine?(): Promise<string | null>;
-    readBytes?(maxLength: number): Promise<string | null>;
+    /**
+     * Bounded raw-byte read. Byte-capable sources (shell pipes, dumps) return
+     * the original bytes; text-only sources encode what they hold. Null means
+     * EOF with nothing returned.
+     */
+    readBytes?(maxLength: number): Promise<Uint8Array | null>;
 }
 export interface TerminalInputStream extends CommandInputStream {
     rawMode: boolean;

package/dist/substrate/lifo/commands/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/substrate/lifo/commands/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACrC;;;;;OAKG;IACH,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EAAE,KACX,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/substrate/lifo/commands/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kCAAkC,CAAC;AAEhE,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACrC;;;;;OAKG;IACH,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpC;;;;OAIG;IACH,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC3D;AACD,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,aAAa,CAAC,EAAE,mBAAmB,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EAAE,KACX,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC"}

package/dist/substrate/lifo/node-compat/zlib.d.ts

@@ -1,16 +1,32 @@
 import { Buffer } from './buffer.js';
 type ZlibCallback = (err: Error | null, result?: Buffer) => void;
-export declare const gzip: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-export declare const gunzip: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-export declare const deflate: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-export declare const inflate: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-export declare const deflateRaw: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-export declare const inflateRaw: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-export declare const unzip: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-export declare function gzipSync(): never;
-export declare function gunzipSync(): never;
-export declare function deflateSync(): never;
-export declare function inflateSync(): never;
+/**
+ * Node's async surface: the callback is required, with options optional in
+ * front of it. There is no promise return to fall back on.
+ */
+interface ZlibAsync {
+    (data: ZlibInput, callback: ZlibCallback): void;
+    (data: ZlibInput, options: object, callback: ZlibCallback): void;
+}
+/**
+ * Everything a zlib entry point accepts: strings encode to UTF-8;
+ * ArrayBuffers and every ArrayBufferView carry their own bytes.
+ */
+type ZlibInput = string | ArrayBufferView | ArrayBuffer;
+export declare const gzip: ZlibAsync;
+export declare const gunzip: ZlibAsync;
+export declare const deflate: ZlibAsync;
+export declare const inflate: ZlibAsync;
+export declare const deflateRaw: ZlibAsync;
+export declare const inflateRaw: ZlibAsync;
+export declare const unzip: ZlibAsync;
+export declare function gzipSync(buffer?: ZlibInput, options?: object): never;
+export declare function gunzipSync(buffer?: ZlibInput, options?: object): never;
+export declare function deflateSync(buffer?: ZlibInput, options?: object): never;
+export declare function inflateSync(buffer?: ZlibInput, options?: object): never;
+export declare function deflateRawSync(buffer?: ZlibInput, options?: object): never;
+export declare function inflateRawSync(buffer?: ZlibInput, options?: object): never;
+export declare function unzipSync(buffer?: ZlibInput, options?: object): never;
 export declare const constants: {
     Z_NO_FLUSH: number;
     Z_PARTIAL_FLUSH: number;
@@ -31,17 +47,20 @@ export declare const constants: {
     Z_DEFAULT_COMPRESSION: number;
 };
 declare const _default: {
-    gzip: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-    gunzip: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-    deflate: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-    inflate: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-    deflateRaw: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-    inflateRaw: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
-    unzip: (data: Uint8Array | string, optionsOrCb: unknown, cb?: ZlibCallback) => void;
+    gzip: ZlibAsync;
+    gunzip: ZlibAsync;
+    deflate: ZlibAsync;
+    inflate: ZlibAsync;
+    deflateRaw: ZlibAsync;
+    inflateRaw: ZlibAsync;
+    unzip: ZlibAsync;
     gzipSync: typeof gzipSync;
     gunzipSync: typeof gunzipSync;
     deflateSync: typeof deflateSync;
     inflateSync: typeof inflateSync;
+    deflateRawSync: typeof deflateRawSync;
+    inflateRawSync: typeof inflateRawSync;
+    unzipSync: typeof unzipSync;
     constants: {
         Z_NO_FLUSH: number;
         Z_PARTIAL_FLUSH: number;

package/dist/substrate/lifo/node-compat/zlib.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zlib.d.ts","sourceRoot":"","sources":["../../../../src/substrate/lifo/node-compat/zlib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AA8CjE,eAAO,MAAM,IAAI,SAVQ,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAUvC,CAAC;AAClD,eAAO,MAAM,MAAM,SAXM,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAWnC,CAAC;AACtD,eAAO,MAAM,OAAO,SAZK,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAYjC,CAAC;AACxD,eAAO,MAAM,OAAO,SAbK,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAa/B,CAAC;AAC1D,eAAO,MAAM,UAAU,SAdE,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAc1B,CAAC;AAC/D,eAAO,MAAM,UAAU,SAfE,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAexB,CAAC;AACjE,eAAO,MAAM,KAAK,SAhBO,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAgBpC,CAAC;AAGrD,wBAAgB,QAAQ,IAAI,KAAK,CAEhC;AACD,wBAAgB,UAAU,IAAI,KAAK,CAElC;AACD,wBAAgB,WAAW,IAAI,KAAK,CAEnC;AACD,wBAAgB,WAAW,IAAI,KAAK,CAEnC;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;CAkBrB,CAAC;;iBAlDuB,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAAI;mBAAnE,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAAI;oBAAnE,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAAI;oBAAnE,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAAI;uBAAnE,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAAI;uBAAnE,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAAI;kBAAnE,UAAU,GAAG,MAAM,eAAe,OAAO,OAAO,YAAY,KAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;AAoD5F,wBAGE"}
+{"version":3,"file":"zlib.d.ts","sourceRoot":"","sources":["../../../../src/substrate/lifo/node-compat/zlib.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEjE;;;GAGG;AACH,UAAU,SAAS;IACjB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAChD,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;CAClE;AAED;;;GAGG;AACH,KAAK,SAAS,GAAG,MAAM,GAAG,eAAe,GAAG,WAAW,CAAC;AA0IxD,eAAO,MAAM,IAAI,WAAgC,CAAC;AAClD,eAAO,MAAM,MAAM,WAAkC,CAAC;AACtD,eAAO,MAAM,OAAO,WAAmC,CAAC;AACxD,eAAO,MAAM,OAAO,WAAqC,CAAC;AAC1D,eAAO,MAAM,UAAU,WAAuC,CAAC;AAC/D,eAAO,MAAM,UAAU,WAAyC,CAAC;AACjE,eAAO,MAAM,KAAK,WAAgF,CAAC;AAcnG,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAEpE;AACD,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAEtE;AACD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAEvE;AACD,wBAAgB,WAAW,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAEvE;AACD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAE1E;AACD,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAE1E;AACD,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAErE;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;CAkBrB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEF,wBAKE"}

package/dist/substrate/lifo/node-compat/zlib.js

@@ -1,18 +1,90 @@
 import { Buffer } from './buffer.js';
+/**
+ * One funnel for every entry point. The result views the caller's exact
+ * byte region — byteOffset and byteLength preserved, element values never
+ * reinterpreted — so sniffing and the codec see identical bytes for a
+ * Uint8Array, a Uint16Array, an offset DataView, or a bare ArrayBuffer.
+ */
+function toBytes(data) {
+    if (typeof data === 'string')
+        return new TextEncoder().encode(data);
+    if (data instanceof Uint8Array)
+        return data;
+    if (ArrayBuffer.isView(data)) {
+        return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+    }
+    return new Uint8Array(data);
+}
+/**
+ * Node splits decompression failures two ways, and the engine's own failure
+ * is the only thing that can tell them apart: an input that ran out is
+ * Z_BUF_ERROR / errno -5, while everything else — bad header, bad block, and
+ * a checksum or length trailer that can only fail once the member is
+ * complete — is Z_DATA_ERROR / errno -3 carrying the engine's message. Which
+ * side of a write or a close the failure lands on says nothing about that,
+ * so it is not consulted.
+ */
+function isUnexpectedEnd(cause) {
+    const message = cause instanceof Error && typeof cause.message === 'string' ? cause.message : String(cause);
+    return /unexpected end|end of (?:file|input|stream)|premature|truncated|\bEOF\b/i.test(message);
+}
+function zDataError(cause) {
+    const message = cause instanceof Error && cause.message ? cause.message : String(cause);
+    return Object.assign(new Error(message), { code: 'Z_DATA_ERROR', errno: -3, cause });
+}
+function zBufError(cause) {
+    return Object.assign(new Error('unexpected end of file'), {
+        code: 'Z_BUF_ERROR',
+        errno: -5,
+        cause,
+    });
+}
+/**
+ * Node throws this synchronously rather than deferring a callback that does
+ * not exist.
+ */
+function invalidCallback(value) {
+    const received = value === undefined ? 'undefined'
+        : value === null ? 'null'
+            : typeof value === 'object' ? `an instance of ${value.constructor?.name ?? 'Object'}`
+                : `type ${typeof value} (${String(value)})`;
+    return Object.assign(new TypeError(`The "callback" argument must be of type function. Received ${received}`), { code: 'ERR_INVALID_ARG_TYPE' });
+}
 async function processStream(data, format, type) {
     const stream = type === 'compress'
         ? new CompressionStream(format)
         : new DecompressionStream(format);
     const writer = stream.writable.getWriter();
-    writer.write(data);
-    writer.close();
     const reader = stream.readable.getReader();
     const chunks = [];
-    for (;;) {
-        const { done, value } = await reader.read();
-        if (done)
-            break;
-        chunks.push(value);
+    // Feeding and draining run together: a single write large enough to fill
+    // the codec's output queue only completes while somebody reads. Both sides
+    // are contained so neither rejection surfaces unhandled, and the first
+    // failure is the one reported.
+    const failures = [];
+    const record = (reason) => {
+        if (failures.length === 0)
+            failures.push(reason);
+    };
+    const drain = (async () => {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done)
+                return;
+            chunks.push(value);
+        }
+    })().catch(record);
+    const feed = (async () => {
+        await writer.write(data);
+        await writer.close();
+    })().catch(record);
+    await Promise.all([drain, feed]);
+    if (failures.length > 0) {
+        const reason = failures[0];
+        if (type === 'decompress') {
+            throw isUnexpectedEnd(reason) ? zBufError(reason) : zDataError(reason);
+        }
+        throw reason instanceof Error ? reason : new Error(String(reason));
     }
     let totalLength = 0;
     for (const c of chunks)
@@ -25,14 +97,22 @@ async function processStream(data, format, type) {
     }
     return result;
 }
+/**
+ * Node's Unzip sniffs the wrapper itself: the gzip magic bytes mean gunzip,
+ * anything else is treated as zlib-wrapped deflate.
+ */
+function looksLikeGzip(data) {
+    return data.length >= 2 && data[0] === 0x1f && data[1] === 0x8b;
+}
 function wrapAsync(format, type) {
     return function (data, optionsOrCb, cb) {
         const callback = typeof optionsOrCb === 'function' ? optionsOrCb : cb;
-        const input = typeof data === 'string' ? new TextEncoder().encode(data) : data;
-        const raw = input instanceof Buffer ? new Uint8Array(input) : input;
-        processStream(raw, format, type)
-            .then((result) => callback(null, result))
-            .catch((err) => callback(err instanceof Error ? err : new Error(String(err))));
+        if (typeof callback !== 'function')
+            throw invalidCallback(callback);
+        const bytes = toBytes(data);
+        // Two arms, not .then().catch(): a callback that throws on success must
+        // not be handed its own exception as a second, failed invocation.
+        processStream(bytes, typeof format === 'function' ? format(bytes) : format, type).then((result) => callback(null, result), (err) => callback(err instanceof Error ? err : new Error(String(err))));
     };
 }
 export const gzip = wrapAsync('gzip', 'compress');
@@ -41,19 +121,36 @@ export const deflate = wrapAsync('deflate', 'compress');
 export const inflate = wrapAsync('deflate', 'decompress');
 export const deflateRaw = wrapAsync('deflate-raw', 'compress');
 export const inflateRaw = wrapAsync('deflate-raw', 'decompress');
-export const unzip = wrapAsync('gzip', 'decompress');
-// Sync variants are not supported in the browser
-export function gzipSync() {
-    throw new Error('zlib sync operations are not supported in Lifo');
+export const unzip = wrapAsync((data) => (looksLikeGzip(data) ? 'gzip' : 'deflate'), 'decompress');
+/**
+ * The Sync surface needs a synchronous compress primitive; browser-class
+ * runtimes only offer the async CompressionStream. Each Sync name refuses
+ * with the working async replacement spelled out instead of failing as a
+ * missing export or a vague "not supported".
+ */
+function syncUnavailable(name, asyncName) {
+    throw Object.assign(new Error(`zlib.${name}: synchronous compression is not available on this runtime. Use the async zlib.${asyncName}(data, callback) form instead.`), { code: 'ERR_ZLIB_SYNC_UNAVAILABLE' });
+}
+export function gzipSync(buffer, options) {
+    syncUnavailable('gzipSync', 'gzip');
+}
+export function gunzipSync(buffer, options) {
+    syncUnavailable('gunzipSync', 'gunzip');
+}
+export function deflateSync(buffer, options) {
+    syncUnavailable('deflateSync', 'deflate');
+}
+export function inflateSync(buffer, options) {
+    syncUnavailable('inflateSync', 'inflate');
 }
-export function gunzipSync() {
-    throw new Error('zlib sync operations are not supported in Lifo');
+export function deflateRawSync(buffer, options) {
+    syncUnavailable('deflateRawSync', 'deflateRaw');
 }
-export function deflateSync() {
-    throw new Error('zlib sync operations are not supported in Lifo');
+export function inflateRawSync(buffer, options) {
+    syncUnavailable('inflateRawSync', 'inflateRaw');
 }
-export function inflateSync() {
-    throw new Error('zlib sync operations are not supported in Lifo');
+export function unzipSync(buffer, options) {
+    syncUnavailable('unzipSync', 'unzip');
 }
 export const constants = {
     Z_NO_FLUSH: 0,
@@ -76,5 +173,7 @@ export const constants = {
 };
 export default {
     gzip, gunzip, deflate, inflate, deflateRaw, inflateRaw, unzip,
-    gzipSync, gunzipSync, deflateSync, inflateSync, constants,
+    gzipSync, gunzipSync, deflateSync, inflateSync,
+    deflateRawSync, inflateRawSync, unzipSync,
+    constants,
 };

package/dist/substrate/lifo/shell/interpreter.d.ts

@@ -241,8 +241,16 @@ export declare class Interpreter {
      */
     private withFdFlush;
     private flushFds;
+    /**
+     * Byte-faithful redirected input: bounded range reads keep >64 KiB
+     * redirections intact and preserve bytes that are not valid UTF-8, while
+     * the text view still decodes progressively across chunk boundaries.
+     *
+     * Only a zero-length range means EOF. Devices and some mounts answer with
+     * fewer bytes than asked whenever their internal bound is hit; those short
+     * nonempty reads advance the offset and continue, exactly like read(2).
+     */
     private createFileReader;
-    private createStringReader;
     private resolveOutputFd;
     private resolveInputFd;
     private parseFdTarget;

package/dist/substrate/lifo/shell/interpreter.d.ts.map

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

package/dist/substrate/lifo/shell/interpreter.js

@@ -7,6 +7,7 @@ import { exitCodeForAbortSignal } from './signals.js';
 import { resolve } from '../utils/path.js';
 import { encode } from '../utils/encoding.js';
 import { globMatch } from '../utils/glob.js';
+import { staticStdinReader } from '../../../shell/stdin-adapter.js';
 /**
  * Bytes a file-backed descriptor holds before committing. Matches the stream
  * chunk size used elsewhere and keeps a line-at-a-time producer from paying a
@@ -1136,7 +1137,7 @@ export class Interpreter {
                 const body = heredoc.quoted
                     ? heredoc.body
                     : await expandWord([{ text: heredoc.body, quoted: 'double' }], expandCtx);
-                this.setInputFd(fds, redir.fd ?? 0, { stream: this.createStringReader(body), terminal: false });
+                this.setInputFd(fds, redir.fd ?? 0, { stream: staticStdinReader(body), terminal: false });
                 continue;
             }
             const target = await expandWord(redir.target, expandCtx);
@@ -1275,11 +1276,17 @@ export class Interpreter {
         }
         if (target === '/dev/stdin')
             return this.resolveInputFd('0', fds.inputFds, fds.terminalInputFds);
+        const targetPath = resolve(this.config.getCwd(), target);
+        const vfs = io.vfs ?? this.config.vfs;
         try {
-            return {
-                stream: this.createFileReader(io.vfs ?? this.config.vfs, resolve(this.config.getCwd(), target)),
-                terminal: false,
-            };
+            // Open-authorize before the command runs, the way open(2) would: a
+            // missing, unreadable, or directory target fails the redirection even
+            // when the command never reads a byte.
+            if (vfs.stat(targetPath).type === 'directory') {
+                throw Object.assign(new Error(`EISDIR: ${targetPath}`), { code: 'EISDIR' });
+            }
+            vfs.access(targetPath, 0o4);
+            return { stream: this.createFileReader(vfs, targetPath), terminal: false };
         }
         catch (error) {
             throw new RedirectionOpenError(target, error);
@@ -1347,39 +1354,82 @@ export class Interpreter {
         for (const stream of fds.outputFds.values())
             stream.flush?.();
     }
+    /**
+     * Byte-faithful redirected input: bounded range reads keep >64 KiB
+     * redirections intact and preserve bytes that are not valid UTF-8, while
+     * the text view still decodes progressively across chunk boundaries.
+     *
+     * Only a zero-length range means EOF. Devices and some mounts answer with
+     * fewer bytes than asked whenever their internal bound is hit; those short
+     * nonempty reads advance the offset and continue, exactly like read(2).
+     */
     createFileReader(vfs, path) {
-        const content = vfs.readFileString(path);
-        return this.createStringReader(content);
-    }
-    createStringReader(content) {
+        const decoder = new TextDecoder('utf-8');
         let offset = 0;
+        let eof = false;
+        const pull = (max) => {
+            if (eof)
+                return null;
+            const chunk = vfs.readRange(path, offset, max);
+            if (chunk.length === 0) {
+                eof = true;
+                return null;
+            }
+            offset += chunk.length;
+            return chunk;
+        };
         return {
+            readBytes: async (maxLength) => {
+                if (maxLength <= 0)
+                    return new Uint8Array(0);
+                return pull(maxLength);
+            },
             read: async () => {
-                if (offset >= content.length)
-                    return null;
-                const chunk = content.slice(offset);
-                offset = content.length;
-                return chunk;
+                while (true) {
+                    const bytes = pull(65536);
+                    if (bytes === null) {
+                        const tail = decoder.decode();
+                        return tail.length > 0 ? tail : null;
+                    }
+                    const text = decoder.decode(bytes, { stream: true });
+                    if (text.length > 0)
+                        return text;
+                }
             },
             readAll: async () => {
-                if (offset >= content.length)
-                    return '';
-                const chunk = content.slice(offset);
-                offset = content.length;
-                return chunk;
+                let out = '';
+                while (true) {
+                    const bytes = pull(65536);
+                    if (bytes === null)
+                        break;
+                    out += decoder.decode(bytes, { stream: true });
+                }
+                out += decoder.decode();
+                return out;
             },
             readLine: async () => {
-                if (offset >= content.length)
-                    return null;
-                const newline = content.indexOf('\n', offset);
-                if (newline < 0) {
-                    const line = content.slice(offset);
-                    offset = content.length;
-                    return line;
+                let line = '';
+                let sawAny = false;
+                while (true) {
+                    const bytes = pull(65536);
+                    if (bytes === null)
+                        break;
+                    sawAny = true;
+                    // Split on the raw 0x0A byte so pushback returns ORIGINAL bytes;
+                    // decoded-text pushback would corrupt multibyte sequences that
+                    // straddle the chunk boundary or mis-measure invalid UTF-8.
+                    const newline = bytes.indexOf(0x0a);
+                    if (newline >= 0) {
+                        offset -= bytes.length - (newline + 1);
+                        eof = false;
+                        line += decoder.decode(bytes.subarray(0, newline), { stream: true });
+                        const flushed = decoder.decode();
+                        return line + flushed;
+                    }
+                    line += decoder.decode(bytes, { stream: true });
                 }
-                const line = content.slice(offset, newline);
-                offset = newline + 1;
-                return line;
+                line += decoder.decode();
+                return sawAny || line.length > 0 ? line : null;
             },
         };
     }

package/dist/substrate/lifo/shell/pipe.d.ts

@@ -1,13 +1,29 @@
 import type { CommandOutputStream, CommandInputStream } from '../commands/types.js';
+/**
+ * A shell pipe that carries the producer's exact bytes. Text writes are
+ * encoded once at the write side, `writeBytes` stores bytes verbatim, and
+ * the text view (`read`/`readAll`/`readLine`) decodes progressively so a
+ * multi-byte UTF-8 sequence split across chunks survives intact.
+ */
 export declare class PipeChannel {
     private buffer;
     private closed;
     private waiting;
+    private decoder;
     readonly writer: CommandOutputStream;
     readonly reader: CommandInputStream;
+    /** Next queued chunk, a waiter's delivery, or null once closed and empty. */
+    private pull;
     private read;
     private readAll;
     private readLine;
+    /**
+     * Bounded byte read: returns whatever the producer has already delivered,
+     * capped at maxLength. maxLength bounds the result, it is never a fill
+     * target — waiting to complete it would stall every consumer downstream of
+     * a live open producer. A larger chunk keeps only its first maxLength
+     * bytes; the remainder stays queued in original order.
+     */
     private readBytes;
     close(): void;
     private deliver;

package/dist/substrate/lifo/shell/pipe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../../../src/substrate/lifo/shell/pipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEpF,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAA6C;IAE5D,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAKlC;IAEF,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAKjC;IAEF,OAAO,CAAC,IAAI;YAYE,OAAO;YAUP,QAAQ;YAiBR,SAAS;IAWvB,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,OAAO;CAYhB"}
+{"version":3,"file":"pipe.d.ts","sourceRoot":"","sources":["../../../../src/substrate/lifo/shell/pipe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAGpF;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAiD;IAChE,OAAO,CAAC,OAAO,CAA4B;IAE3C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CASlC;IAEF,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAKjC;IAEF,6EAA6E;IAC7E,OAAO,CAAC,IAAI;YAYE,IAAI;YAYJ,OAAO;YAUP,QAAQ;IA0BtB;;;;;;OAMG;YACW,SAAS;IAUvB,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,OAAO;CAahB"}