@poe-platform/safe-bash 0.1.0

package/dist/safe-bash/commands/stream-inspection/shared.js

@@ -0,0 +1,202 @@
+import { FsError, readBytes, resolvePath, writeBytes } from "../../contracts/index.js";
+import { diagnostic } from "../internal.js";
+export function settings(options) {
+    const limits = {
+        maxInputBytes: 32 * 1024 * 1024, maxOutputBytes: 64 * 1024 * 1024,
+        maxRecordBytes: 8 * 1024 * 1024, maxChunkBytes: 1024 * 1024,
+        maxFiles: 64, maxSteps: 256 * 1024 * 1024, maxArgumentBytes: 65536,
+        ...options.limits,
+    };
+    for (const [name, value] of Object.entries(limits)) {
+        if (!Number.isSafeInteger(value) || value < 1)
+            throw new RangeError(`Invalid stream-inspection limit: ${name}`);
+    }
+    return limits;
+}
+class InputFailure extends Error {
+    original;
+    constructor(original) {
+        super("input failed");
+        this.original = original;
+    }
+}
+export class Session {
+    context;
+    limits;
+    inputBytes = 0;
+    outputBytes = 0;
+    steps = 0;
+    untilYield = 4096;
+    stdin;
+    controller = new AbortController();
+    signal;
+    failed = false;
+    constructor(context, limits) {
+        this.context = context;
+        this.limits = limits;
+        this.signal = AbortSignal.any([context.signal, this.controller.signal]);
+        this.check(context.args.reduce((size, value) => size + Buffer.byteLength(value), 0), limits.maxArgumentBytes, "argument");
+    }
+    check(size, maximum, label) {
+        if (size > maximum)
+            throw new FsError("EFBIG", { message: `stream-inspection ${label} limit exceeded` });
+    }
+    async step(count = 1) {
+        this.signal.throwIfAborted();
+        this.steps += count;
+        this.check(this.steps, this.limits.maxSteps, "step");
+        this.untilYield -= count;
+        if (this.untilYield <= 0) {
+            this.untilYield = 4096;
+            await new Promise(resolve => setImmediate(resolve));
+            this.signal.throwIfAborted();
+        }
+    }
+    async output(bytes) {
+        this.check(this.outputBytes + bytes.length, this.limits.maxOutputBytes, "output");
+        this.outputBytes += bytes.length;
+        const width = Math.min(16384, this.limits.maxChunkBytes);
+        for (let offset = 0; offset < bytes.length; offset += width) {
+            await this.step();
+            await writeBytes(this.context.stdout, new Uint8Array(bytes.subarray(offset, offset + width)), this.signal);
+        }
+    }
+    names(operands) {
+        const names = operands.length ? operands : ["-"];
+        this.check(names.length, this.limits.maxFiles, "file");
+        return names;
+    }
+    async *read(name) {
+        const controller = new AbortController();
+        const signal = AbortSignal.any([this.signal, controller.signal]);
+        let reader;
+        try {
+            const session = this;
+            const source = (async function* () {
+                if (name === "-") {
+                    session.stdin ??= session.context.stdin[Symbol.asyncIterator]();
+                    const cursor = session.stdin;
+                    yield* { [Symbol.asyncIterator]() { return { next: () => cursor.next() }; } };
+                }
+                else {
+                    if (!name)
+                        throw new FsError("ENOENT", { path: name });
+                    const path = resolvePath(session.context.cwd, name);
+                    const stat = await session.context.fs.stat(path, { signal });
+                    signal.throwIfAborted();
+                    if (stat.type === "directory")
+                        throw new FsError("EISDIR", { path });
+                    if (session.context.fs.readStream)
+                        yield* session.context.fs.readStream(path, { signal });
+                    else
+                        yield await session.context.fs.readFile(path, { signal, maxBytes: Math.min(session.limits.maxChunkBytes, session.limits.maxInputBytes - session.inputBytes) });
+                }
+            })();
+            reader = readBytes(source, signal);
+            while (true) {
+                await this.step();
+                let item;
+                try {
+                    item = await reader.next();
+                }
+                catch (error) {
+                    this.signal.throwIfAborted();
+                    throw new InputFailure(error);
+                }
+                if (item.done)
+                    break;
+                this.check(item.value.length, this.limits.maxChunkBytes, "chunk");
+                this.inputBytes += item.value.length;
+                this.check(this.inputBytes, this.limits.maxInputBytes, "input");
+                yield item.value;
+            }
+        }
+        finally {
+            controller.abort(new FsError("EPIPE", { message: "stream-inspection input transfer ended" }));
+            if (reader)
+                await reader.return(undefined).catch(() => { });
+        }
+    }
+    async files(names, process) {
+        for (const name of names) {
+            try {
+                await process(this.read(name), name);
+            }
+            catch (error) {
+                this.signal.throwIfAborted();
+                if (!(error instanceof InputFailure))
+                    throw error;
+                await diagnostic(this.context, error.original);
+                this.failed = true;
+            }
+        }
+    }
+    async close() {
+        this.controller.abort(new FsError("EPIPE", { message: "stream-inspection command ended" }));
+        if (this.stdin?.return) {
+            const cleanup = Promise.resolve().then(() => this.stdin.return());
+            void cleanup.catch(() => { });
+        }
+    }
+}
+export function command(name, limits, run) {
+    return { name, async execute(context) {
+            context.signal.throwIfAborted();
+            let session;
+            try {
+                session = new Session(context, limits);
+                await run(session);
+                context.signal.throwIfAborted();
+                return { exitCode: session.failed ? 1 : 0 };
+            }
+            catch (error) {
+                context.signal.throwIfAborted();
+                await diagnostic(context, error);
+                return { exitCode: 1 };
+            }
+            finally {
+                await session?.close();
+            }
+        } };
+}
+export class ByteOutput {
+    session;
+    bytes;
+    size = 0;
+    constructor(session) {
+        this.session = session;
+        this.bytes = new Uint8Array(Math.min(16384, session.limits.maxChunkBytes));
+    }
+    async byte(value) {
+        this.bytes[this.size++] = value;
+        if (this.size === this.bytes.length)
+            await this.flush();
+    }
+    async flush() {
+        if (this.size)
+            await this.session.output(this.bytes.subarray(0, this.size));
+        this.size = 0;
+    }
+}
+export class RecordBuffer {
+    session;
+    bytes;
+    size = 0;
+    constructor(session) {
+        this.session = session;
+        this.bytes = new Uint8Array(Math.min(1024, session.limits.maxRecordBytes));
+    }
+    push(byte) {
+        this.session.check(this.size + 1, this.session.limits.maxRecordBytes, "record");
+        if (this.size === this.bytes.length) {
+            const grown = new Uint8Array(Math.min(this.bytes.length * 2, this.session.limits.maxRecordBytes));
+            grown.set(this.bytes);
+            this.bytes = grown;
+        }
+        this.bytes[this.size++] = byte;
+    }
+    view() { return this.bytes.subarray(0, this.size); }
+    drop(count) { this.bytes.copyWithin(0, count, this.size); this.size -= count; }
+    clear() { this.size = 0; }
+}
+//# sourceMappingURL=shared.js.map

package/dist/safe-bash/commands/stream-inspection/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/stream-inspection/shared.ts"],"names":[],"mappings":"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"}

package/dist/safe-bash/commands/stream-inspection/strings.d.ts

@@ -0,0 +1,4 @@
+import type { CommandDefinition } from "../../contracts/index.js";
+import { type StreamInspectionLimits } from "./shared.js";
+export declare function createStringsCommand(limits: StreamInspectionLimits): CommandDefinition;
+//# sourceMappingURL=strings.d.ts.map

package/dist/safe-bash/commands/stream-inspection/strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.d.ts","sourceRoot":"","sources":["../../../src/commands/stream-inspection/strings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAyB,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEjF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,iBAAiB,CAyCtF"}

package/dist/safe-bash/commands/stream-inspection/strings.js

@@ -0,0 +1,54 @@
+import { integer, UsageError, value } from "../internal.js";
+import { numericOptions } from "./numeric-options.js";
+import { command, RecordBuffer } from "./shared.js";
+export function createStringsCommand(limits) {
+    return command("strings", limits, async (session) => {
+        const parsed = numericOptions(session.context.args, "afn:t:", { all: "a", "print-file-name": "f", bytes: "n", radix: "t" });
+        let minimum = 4;
+        for (const specification of parsed.values.get("n") ?? [])
+            minimum = integer(specification, 1);
+        if (parsed.legacyValue !== undefined) {
+            const specification = parsed.legacyValue;
+            if (!/^(?:0[0-7]*|[1-9][0-9]*)$/u.test(specification))
+                throw new UsageError(`invalid number '${specification}'`);
+            minimum = Number.parseInt(specification, specification.startsWith("0") ? 8 : 10);
+            if (minimum < 1 || minimum >= 4294967295)
+                throw new UsageError(`invalid number '${specification}'`);
+        }
+        const radix = value(parsed, "t");
+        if (radix !== undefined && !["d", "o", "x"].includes(radix))
+            throw new UsageError(`invalid radix '${radix}'`);
+        const files = parsed.operands.filter(name => name !== "-");
+        if (parsed.operands.length && !files.length)
+            throw new UsageError("missing file operand after '-' (use no operands for stdin)");
+        await session.files(session.names(files), async (source, name) => {
+            const record = new RecordBuffer(session);
+            let offset = 0, start = 0;
+            const flush = async () => {
+                if (record.size >= minimum) {
+                    const label = parsed.flags.has("f") ? `${name === "-" ? "{standard input}" : name}: ` : "";
+                    const location = radix === undefined ? "" : `${start.toString(radix === "x" ? 16 : radix === "o" ? 8 : 10).padStart(7, " ")} `;
+                    await session.output(new TextEncoder().encode(label + location));
+                    await session.output(record.view());
+                    await session.output(Uint8Array.of(10));
+                }
+                record.clear();
+            };
+            for await (const chunk of source) {
+                for (const byte of chunk) {
+                    await session.step();
+                    if (byte === 9 || byte >= 32 && byte <= 126) {
+                        if (!record.size)
+                            start = offset;
+                        record.push(byte);
+                    }
+                    else
+                        await flush();
+                    offset++;
+                }
+            }
+            await flush();
+        });
+    });
+}
+//# sourceMappingURL=strings.js.map

package/dist/safe-bash/commands/stream-inspection/strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.js","sourceRoot":"","sources":["../../../src/commands/stream-inspection/strings.ts"],"names":[],"mappings":"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"}

package/dist/safe-bash/commands/stream-inspection/tac.d.ts

@@ -0,0 +1,4 @@
+import type { CommandDefinition } from "../../contracts/index.js";
+import { type StreamInspectionLimits } from "./shared.js";
+export declare function createTacCommand(limits: StreamInspectionLimits): CommandDefinition;
+//# sourceMappingURL=tac.d.ts.map

package/dist/safe-bash/commands/stream-inspection/tac.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tac.d.ts","sourceRoot":"","sources":["../../../src/commands/stream-inspection/tac.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAW,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAEnE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,iBAAiB,CAuClF"}

package/dist/safe-bash/commands/stream-inspection/tac.js

@@ -0,0 +1,54 @@
+import { options, value } from "../internal.js";
+import { command } from "./shared.js";
+export function createTacCommand(limits) {
+    return command("tac", limits, async (session) => {
+        const parsed = options(session.context.args, "bs:", { before: "b", separator: "s" });
+        const text = value(parsed, "s") ?? "\n";
+        const separator = Buffer.from(text || "\0");
+        const reversed = Uint8Array.from(separator).reverse();
+        const prefix = new Uint32Array(reversed.length);
+        for (let index = 1, matched = 0; index < reversed.length; index++) {
+            await session.step();
+            while (matched && reversed[index] !== reversed[matched]) {
+                matched = prefix[matched - 1];
+                await session.step();
+            }
+            if (reversed[index] === reversed[matched])
+                matched++;
+            prefix[index] = matched;
+        }
+        await session.files(session.names(parsed.operands), async (source) => {
+            let bytes = new Uint8Array(Math.min(65536, limits.maxInputBytes));
+            let size = 0;
+            for await (const chunk of source) {
+                if (size + chunk.length > bytes.length) {
+                    const grown = new Uint8Array(Math.min(limits.maxInputBytes, Math.max(size + chunk.length, bytes.length * 2)));
+                    grown.set(bytes.subarray(0, size));
+                    bytes = grown;
+                }
+                bytes.set(chunk, size);
+                size += chunk.length;
+            }
+            let end = size, matched = 0;
+            for (let index = size - 1; index >= 0; index--) {
+                await session.step();
+                while (matched && bytes[index] !== reversed[matched]) {
+                    matched = prefix[matched - 1];
+                    await session.step();
+                }
+                if (bytes[index] === reversed[matched])
+                    matched++;
+                if (matched !== reversed.length)
+                    continue;
+                const boundary = parsed.flags.has("b") ? index : index + separator.length;
+                session.check(end - boundary, limits.maxRecordBytes, "record");
+                await session.output(bytes.subarray(boundary, end));
+                end = boundary;
+                matched = 0;
+            }
+            session.check(end, limits.maxRecordBytes, "record");
+            await session.output(bytes.subarray(0, end));
+        });
+    });
+}
+//# sourceMappingURL=tac.js.map

package/dist/safe-bash/commands/stream-inspection/tac.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tac.js","sourceRoot":"","sources":["../../../src/commands/stream-inspection/tac.ts"],"names":[],"mappings":"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"}

package/dist/safe-bash/commands/streams.d.ts

@@ -0,0 +1,3 @@
+import { type CommandDefinition } from "../contracts/index.js";
+export declare function streamCommands(): CommandDefinition[];
+//# sourceMappingURL=streams.d.ts.map

package/dist/safe-bash/commands/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/commands/streams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AA4LrI,wBAAgB,cAAc,IAAI,iBAAiB,EAAE,CAqKpD"}