poe-code 15.0.14 → 15.0.16

package/packages/safe-bash/dist/commands/hexdump/format.js

@@ -0,0 +1,25 @@
+export function formatBlock(block, used, address, canonical) {
+    let result = address.toString(16).padStart(canonical ? 8 : 7, "0") + (canonical ? "  " : " ");
+    if (canonical) {
+        for (let index = 0; index < 16; index++) {
+            if (index === 8)
+                result += " ";
+            result += index < used ? block[index].toString(16).padStart(2, "0") : "  ";
+            if (index !== 15)
+                result += " ";
+        }
+        result += "  |";
+        for (let index = 0; index < used; index++) {
+            const byte = block[index];
+            result += byte >= 32 && byte <= 126 ? String.fromCharCode(byte) : ".";
+        }
+        return result + "|\n";
+    }
+    for (let index = 0; index < 16; index += 2) {
+        result += index < used ? (block[index] + (index + 1 < used ? block[index + 1] * 256 : 0)).toString(16).padStart(4, "0") : "    ";
+        if (index !== 14)
+            result += " ";
+    }
+    return result + "\n";
+}
+//# sourceMappingURL=format.js.map

package/packages/safe-bash/dist/commands/hexdump/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../src/commands/hexdump/format.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,IAAY,EAAE,OAAe,EAAE,SAAkB;IAC9F,IAAI,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9F,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;YACxC,IAAI,KAAK,KAAK,CAAC;gBAAE,MAAM,IAAI,GAAG,CAAC;YAC/B,MAAM,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC5E,IAAI,KAAK,KAAK,EAAE;gBAAE,MAAM,IAAI,GAAG,CAAC;QAClC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC;QAChB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;YAC3B,MAAM,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACxE,CAAC;QACD,OAAO,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IACD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAE,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACnI,IAAI,KAAK,KAAK,EAAE;YAAE,MAAM,IAAI,GAAG,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,GAAG,IAAI,CAAC;AACvB,CAAC"}

package/packages/safe-bash/dist/commands/hexdump/index.browser.js

@@ -0,0 +1,17 @@
+import {
+  createHdCommand,
+  createHexdumpCommand,
+  createHexdumpCommands,
+  hexdumpCommands
+} from "../../chunks/chunk-R3QJL5HH.js";
+import "../../chunks/chunk-DPJWEGIX.js";
+import "../../chunks/chunk-PZMJ4EC3.js";
+import "../../chunks/chunk-5VBLSPNM.js";
+import "../../chunks/chunk-2KL6W6NB.js";
+export {
+  createHdCommand,
+  createHexdumpCommand,
+  createHexdumpCommands,
+  hexdumpCommands
+};
+//# sourceMappingURL=index.browser.js.map

package/packages/safe-bash/dist/commands/hexdump/index.browser.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/packages/safe-bash/dist/commands/hexdump/index.d.ts

@@ -0,0 +1,7 @@
+import type { CommandDefinition, VirtualShellPlugin } from "../../contracts/index.js";
+import type { HexdumpCommandsOptions } from "./internal.js";
+export { createHexdumpCommand, createHdCommand } from "./command.js";
+export type { HexdumpCommandsOptions, HexdumpLimits } from "./internal.js";
+export declare function createHexdumpCommands(options?: HexdumpCommandsOptions): readonly CommandDefinition[];
+export declare function hexdumpCommands(options?: HexdumpCommandsOptions): VirtualShellPlugin;
+//# sourceMappingURL=index.d.ts.map

package/packages/safe-bash/dist/commands/hexdump/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/hexdump/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAE5D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrE,YAAY,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE3E,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,sBAA2B,GAAG,SAAS,iBAAiB,EAAE,CAExG;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,kBAAkB,CAMxF"}

package/packages/safe-bash/dist/commands/hexdump/index.js

@@ -0,0 +1,17 @@
+import { createHexdumpCommand, createHdCommand } from "./command.js";
+export { createHexdumpCommand, createHdCommand } from "./command.js";
+export function createHexdumpCommands(options = {}) {
+    return [createHexdumpCommand(options), createHdCommand(options)];
+}
+export function hexdumpCommands(options = {}) {
+    const commands = createHexdumpCommands(options);
+    return { name: "hexdump-commands", setup(host) {
+            if (!options.replace)
+                for (const command of commands)
+                    if (host.commands.has(command.name))
+                        throw new Error(`Command already registered: ${command.name}`);
+            for (const command of commands)
+                host.commands.register(command, { replace: options.replace ?? false });
+        } };
+}
+//# sourceMappingURL=index.js.map

package/packages/safe-bash/dist/commands/hexdump/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/hexdump/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGrE,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGrE,MAAM,UAAU,qBAAqB,CAAC,UAAkC,EAAE;IACxE,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAkC,EAAE;IAClE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,CAAC,IAAI;YAC3C,IAAI,CAAC,OAAO,CAAC,OAAO;gBAAE,KAAK,MAAM,OAAO,IAAI,QAAQ;oBAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1J,KAAK,MAAM,OAAO,IAAI,QAAQ;gBAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC;QACzG,CAAC,EAAE,CAAC;AACN,CAAC"}

package/packages/safe-bash/dist/commands/hexdump/internal.d.ts

@@ -0,0 +1,52 @@
+import { type CommandContext } from "../../contracts/index.js";
+import { PublicDiagnostic } from "../../diagnostics.js";
+export interface HexdumpLimits {
+    readonly maxArguments: number;
+    readonly maxArgumentBytes: number;
+    readonly maxInputBytes: number;
+    readonly maxBufferedBytes: number;
+    readonly maxOutputBytes: number;
+    readonly maxDiagnosticBytes: number;
+    readonly maxFormats: number;
+    readonly maxWork: number;
+    readonly maxEmptyChunks: number;
+}
+export interface HexdumpCommandsOptions {
+    readonly replace?: boolean;
+    readonly limits?: Partial<HexdumpLimits>;
+}
+export declare function settings(options: HexdumpCommandsOptions): HexdumpLimits;
+export declare class HexdumpError extends PublicDiagnostic {
+    readonly bare: boolean;
+    constructor(message: string, bare?: boolean);
+}
+export declare function raw(value: Uint8Array): string;
+export declare function bytes(value: string): Uint8Array;
+export declare function pathText(value: string): string;
+export declare class Budget {
+    readonly context: CommandContext;
+    readonly limits: HexdumpLimits;
+    readonly signal: AbortSignal;
+    private readonly callerSignal;
+    readonly admission: {
+        readonly closed: boolean;
+    };
+    private work;
+    private checkpoint;
+    private retained;
+    private input;
+    private output;
+    private diagnostics;
+    constructor(context: CommandContext, limits: HexdumpLimits, signal: AbortSignal, callerSignal: AbortSignal, admission: {
+        readonly closed: boolean;
+    });
+    assertOpen(): void;
+    check(value: number, maximum: number, label: string): void;
+    charge(amount?: number): void;
+    checkpointWork(): Promise<void>;
+    retain(amount: number): void;
+    inputBytes(amount: number): void;
+    emitted(amount: number, diagnostic: boolean): void;
+    arguments(): string[];
+}
+//# sourceMappingURL=internal.d.ts.map

package/packages/safe-bash/dist/commands/hexdump/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../../src/commands/hexdump/internal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGpF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CAC1C;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa,CAWvE;AAED,qBAAa,YAAa,SAAQ,gBAAgB;IACnB,QAAQ,CAAC,IAAI;gBAA9B,OAAO,EAAE,MAAM,EAAW,IAAI,UAAQ;CACnD;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAI7C;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAE/C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,qBAAa,MAAM;IAOL,QAAQ,CAAC,OAAO,EAAE,cAAc;IAAE,QAAQ,CAAC,MAAM,EAAE,aAAa;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW;IAAE,OAAO,CAAC,QAAQ,CAAC,YAAY;IAAe,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE;IANxM,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,WAAW,CAAK;gBACH,OAAO,EAAE,cAAc,EAAW,MAAM,EAAE,aAAa,EAAW,MAAM,EAAE,WAAW,EAAmB,YAAY,EAAE,WAAW,EAAW,SAAS,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE;IACxM,UAAU,IAAI,IAAI;IAIlB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAG1D,MAAM,CAAC,MAAM,SAAI,GAAG,IAAI;IAKlB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAQrC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI;IAUlD,SAAS,IAAI,MAAM,EAAE;CA0CtB"}

package/packages/safe-bash/dist/commands/hexdump/internal.js

@@ -0,0 +1,150 @@
+import { getCommandArguments } from "../../contracts/index.js";
+import { shellValueByteLength, shellValueBytes } from "../../contracts/value.js";
+import { yieldTurn } from "../../contracts/yield.js";
+import { PublicDiagnostic } from "../../diagnostics.js";
+export function settings(options) {
+    const limits = {
+        maxArguments: 4096, maxArgumentBytes: 65_536, maxInputBytes: 33_554_432,
+        maxBufferedBytes: 8_388_608, maxOutputBytes: 134_217_728,
+        maxDiagnosticBytes: 65_536, maxFormats: 64, maxWork: 536_870_912,
+        maxEmptyChunks: 4096, ...options.limits,
+    };
+    for (const [name, value] of Object.entries(limits)) {
+        if (!Number.isSafeInteger(value) || value < 1)
+            throw new RangeError(`Invalid hexdump limit: ${name}`);
+    }
+    return Object.freeze(limits);
+}
+export class HexdumpError extends PublicDiagnostic {
+    bare;
+    constructor(message, bare = false) {
+        super(message);
+        this.bare = bare;
+    }
+}
+export function raw(value) {
+    let result = "";
+    for (let offset = 0; offset < value.length; offset += 4096)
+        result += String.fromCharCode(...value.subarray(offset, offset + 4096));
+    return result;
+}
+export function bytes(value) {
+    return Uint8Array.from(value, character => character.charCodeAt(0));
+}
+export function pathText(value) {
+    try {
+        return new TextDecoder("utf-8", { fatal: true, ignoreBOM: true }).decode(bytes(value));
+    }
+    catch {
+        throw new HexdumpError("filesystem paths must be valid UTF-8");
+    }
+}
+export class Budget {
+    context;
+    limits;
+    signal;
+    callerSignal;
+    admission;
+    work = 0;
+    checkpoint = 0;
+    retained = 0;
+    input = 0;
+    output = 0;
+    diagnostics = 0;
+    constructor(context, limits, signal, callerSignal, admission) {
+        this.context = context;
+        this.limits = limits;
+        this.signal = signal;
+        this.callerSignal = callerSignal;
+        this.admission = admission;
+    }
+    assertOpen() {
+        this.signal.throwIfAborted();
+        if (this.admission.closed)
+            throw new HexdumpError("command is closed");
+    }
+    check(value, maximum, label) {
+        if (!Number.isSafeInteger(value) || value < 0 || value > maximum)
+            throw new HexdumpError(`${label} limit exceeded`);
+    }
+    charge(amount = 1) {
+        this.assertOpen();
+        this.check(this.work + amount, this.limits.maxWork, "work");
+        this.work += amount;
+    }
+    async checkpointWork() {
+        this.assertOpen();
+        if (this.work - this.checkpoint >= 4096) {
+            this.checkpoint = this.work;
+            await yieldTurn(this.callerSignal);
+            this.assertOpen();
+        }
+    }
+    retain(amount) {
+        this.check(this.retained + amount, this.limits.maxBufferedBytes, "buffered bytes");
+        this.retained += amount;
+    }
+    inputBytes(amount) {
+        this.check(this.input + amount, this.limits.maxInputBytes, "input bytes");
+        this.input += amount;
+    }
+    emitted(amount, diagnostic) {
+        if (diagnostic) {
+            this.check(this.diagnostics + amount, this.limits.maxDiagnosticBytes, "diagnostic bytes");
+            this.diagnostics += amount;
+        }
+        else {
+            this.check(this.output + amount, this.limits.maxOutputBytes, "output bytes");
+            this.charge(amount);
+            this.output += amount;
+        }
+    }
+    arguments() {
+        this.assertOpen();
+        const args = this.context.args;
+        this.assertOpen();
+        const count = args.length;
+        this.assertOpen();
+        this.check(count, this.limits.maxArguments, "argument count");
+        const argumentValues = this.context.argumentValues;
+        this.assertOpen();
+        const carrier = argumentValues === undefined ? undefined : getCommandArguments({ args, argumentValues });
+        this.assertOpen();
+        this.retain(count * 64 + 128);
+        const snapshot = [];
+        let units = 0, total = 0;
+        for (let index = 0; index < count; index++) {
+            const argument = args[index];
+            this.assertOpen();
+            if (typeof argument !== "string")
+                throw new HexdumpError("arguments must be strings");
+            units += argument.length;
+            this.check(units, this.limits.maxArgumentBytes, "argument bytes");
+            this.charge(argument.length + 1);
+            for (let offset = 0; offset < argument.length; offset++) {
+                const unit = argument.charCodeAt(offset);
+                if (unit >= 0xd800 && unit <= 0xdbff) {
+                    const next = argument.charCodeAt(++offset);
+                    if (!(next >= 0xdc00 && next <= 0xdfff))
+                        throw new HexdumpError("arguments must contain well-formed Unicode");
+                }
+                else if (unit >= 0xdc00 && unit <= 0xdfff)
+                    throw new HexdumpError("arguments must contain well-formed Unicode");
+            }
+            const size = shellValueByteLength(carrier ? carrier.values[index] : argument);
+            total += size;
+            this.check(total, this.limits.maxArgumentBytes, "argument bytes");
+            this.charge(size);
+            this.retain(size * 8);
+            snapshot.push(argument);
+        }
+        return (carrier ?? getCommandArguments({ args: snapshot })).values.map(argument => {
+            this.charge(shellValueByteLength(argument));
+            const value = shellValueBytes(argument);
+            if (value.includes(0))
+                throw new HexdumpError("NUL is not supported in arguments");
+            return raw(value);
+        });
+    }
+}
+//# sourceMappingURL=internal.js.map

package/packages/safe-bash/dist/commands/hexdump/internal.js.map

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

package/packages/safe-bash/dist/commands/hexdump/io.d.ts

@@ -0,0 +1,41 @@
+import { FsError, type ByteSink } from "../../contracts/index.js";
+import type { OutputOperation } from "../../contracts/output.js";
+import { Budget } from "./internal.js";
+export declare class Lifecycle {
+    readonly budget: Budget;
+    private readonly stdout;
+    private readonly caller;
+    private readonly pending;
+    private readonly cleanups;
+    private closing;
+    private diagnostic;
+    diagnosticCancellation: {
+        reason: unknown;
+    } | undefined;
+    constructor(budget: Budget, output: OutputOperation, stdout: ByteSink, caller: AbortSignal);
+    cleanup(action: () => Promise<void>): void;
+    forget(action: () => Promise<void>): void;
+    assertOpen(): void;
+    private assertDiagnosticOpen;
+    operation<Value>(action: () => Value | Promise<Value>, diagnostic?: boolean): Promise<Value>;
+    close(): Promise<void>;
+    write(value: string, diagnostic?: boolean): Promise<void>;
+}
+export declare class Reader {
+    readonly name: string | undefined;
+    readonly lifecycle: Lifecycle;
+    private iterator;
+    private chunk;
+    private offset;
+    private ended;
+    private empties;
+    private snapshotBytes;
+    private closed;
+    constructor(name: string | undefined, lifecycle: Lifecycle);
+    readonly close: () => Promise<void>;
+    private readonly releaseSnapshot;
+    open(): Promise<void>;
+    get(): Promise<number>;
+}
+export declare function fsDetail(error: FsError): string;
+//# sourceMappingURL=io.d.ts.map

package/packages/safe-bash/dist/commands/hexdump/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../src/commands/hexdump/io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,KAAK,QAAQ,EAAmB,MAAM,0BAA0B,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,MAAM,EAAiC,MAAM,eAAe,CAAC;AAOtE,qBAAa,SAAS;IAMR,QAAQ,CAAC,MAAM,EAAE,MAAM;IAA2B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAY,OAAO,CAAC,QAAQ,CAAC,MAAM;IALxH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,UAAU,CAA2E;IAC7F,sBAAsB,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;gBACnC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAmB,MAAM,EAAE,QAAQ,EAAmB,MAAM,EAAE,WAAW;IACrI,OAAO,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IACzC,UAAU,IAAI,IAAI;IAIlB,OAAO,CAAC,oBAAoB;IAQtB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,KAAK,CAAC;IAmBhG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWhB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA4B9D;AAED,qBAAa,MAAM;IAQL,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAAE,QAAQ,CAAC,SAAS,EAAE,SAAS;IAP5E,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,MAAM,CAA4B;gBACrB,IAAI,EAAE,MAAM,GAAG,SAAS,EAAW,SAAS,EAAE,SAAS;IAI5E,QAAQ,CAAC,KAAK,QAAO,OAAO,CAAC,IAAI,CAAC,CAS/B;IACH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG9B;IACI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6DrB,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;CAqC7B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAO/C"}

package/packages/safe-bash/dist/commands/hexdump/io.js

@@ -0,0 +1,288 @@
+import { FsError, resolvePath } from "../../contracts/index.js";
+import { Budget, HexdumpError, bytes, pathText } from "./internal.js";
+const typedArrayPrototype = Object.getPrototypeOf(Uint8Array.prototype);
+const viewBuffer = Object.getOwnPropertyDescriptor(typedArrayPrototype, "buffer").get;
+const viewOffset = Object.getOwnPropertyDescriptor(typedArrayPrototype, "byteOffset").get;
+const viewLength = Object.getOwnPropertyDescriptor(typedArrayPrototype, "byteLength").get;
+export class Lifecycle {
+    budget;
+    stdout;
+    caller;
+    pending = new Set();
+    cleanups = new Set();
+    closing;
+    diagnostic;
+    diagnosticCancellation;
+    constructor(budget, output, stdout, caller) {
+        this.budget = budget;
+        this.stdout = stdout;
+        this.caller = caller;
+        output.registerCleanup(() => this.close());
+    }
+    cleanup(action) { this.assertOpen(); this.cleanups.add(action); }
+    forget(action) { this.cleanups.delete(action); }
+    assertOpen() {
+        this.budget.assertOpen();
+        if (this.closing)
+            throw new HexdumpError("command is closed");
+    }
+    assertDiagnosticOpen() {
+        this.caller.throwIfAborted();
+        const consumer = this.diagnostic?.consumer;
+        if (consumer?.aborted) {
+            this.diagnosticCancellation = { reason: consumer.reason };
+            consumer.throwIfAborted();
+        }
+    }
+    async operation(action, diagnostic = false) {
+        if (diagnostic)
+            this.assertDiagnosticOpen();
+        else
+            this.assertOpen();
+        if (this.closing || this.budget.admission.closed)
+            throw new HexdumpError("command is closed");
+        if (!diagnostic)
+            this.budget.charge();
+        const pending = Promise.resolve().then(() => {
+            if (diagnostic)
+                this.assertDiagnosticOpen();
+            else
+                this.assertOpen();
+            return action();
+        });
+        this.pending.add(pending);
+        try {
+            const value = await pending;
+            if (diagnostic)
+                this.assertDiagnosticOpen();
+            else
+                this.assertOpen();
+            return value;
+        }
+        finally {
+            this.pending.delete(pending);
+        }
+    }
+    close() {
+        return this.closing ??= Promise.resolve().then(async () => {
+            while (this.pending.size)
+                await Promise.allSettled([...this.pending]);
+            const failures = [];
+            for (const cleanup of this.cleanups) {
+                try {
+                    await cleanup();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+            }
+            if (failures.length === 1)
+                throw failures[0];
+            if (failures.length > 1)
+                throw new AggregateError(failures, "hexdump cleanup failed");
+        });
+    }
+    async write(value, diagnostic = false) {
+        this.budget.emitted(value.length, diagnostic);
+        await this.operation(async () => {
+            if (!diagnostic)
+                this.budget.retain(value.length * 3);
+            try {
+                let destination;
+                if (diagnostic) {
+                    if (!this.diagnostic) {
+                        const sink = this.budget.context.stderr;
+                        this.assertDiagnosticOpen();
+                        const capability = sink.ownedOutput;
+                        this.assertDiagnosticOpen();
+                        const consumer = capability?.consumerClosed;
+                        this.diagnostic = { destination: capability ?? sink, consumer };
+                    }
+                    this.assertDiagnosticOpen();
+                    destination = this.diagnostic.destination;
+                }
+                else {
+                    destination = this.stdout;
+                    this.assertOpen();
+                }
+                const write = destination.write;
+                if (diagnostic)
+                    this.assertDiagnosticOpen();
+                else
+                    this.assertOpen();
+                await Reflect.apply(write, destination, [bytes(value)]);
+            }
+            finally {
+                if (!diagnostic)
+                    this.budget.retain(-value.length * 3);
+            }
+        }, diagnostic);
+    }
+}
+export class Reader {
+    name;
+    lifecycle;
+    iterator;
+    chunk = new Uint8Array();
+    offset = 0;
+    ended = false;
+    empties = 0;
+    snapshotBytes = 0;
+    closed;
+    constructor(name, lifecycle) {
+        this.name = name;
+        this.lifecycle = lifecycle;
+        lifecycle.budget.retain(256);
+        lifecycle.cleanup(this.close);
+    }
+    close = () => this.closed ??= Promise.resolve().then(async () => {
+        try {
+            if (!this.ended)
+                await this.iterator?.return?.();
+        }
+        finally {
+            this.iterator = undefined;
+            this.releaseSnapshot();
+            this.lifecycle.budget.retain(-this.chunk.length - 256);
+            this.chunk = new Uint8Array();
+            this.lifecycle.forget(this.close);
+        }
+    });
+    releaseSnapshot = () => {
+        this.lifecycle.budget.retain(-this.snapshotBytes);
+        this.snapshotBytes = 0;
+    };
+    async open() {
+        const { budget } = this.lifecycle;
+        await this.lifecycle.operation(async () => {
+            let source;
+            let needsAcquisitionCleanup = false;
+            if (this.name === undefined)
+                source = budget.context.stdin;
+            else {
+                if (this.name === "")
+                    throw new FsError("ENOENT", { path: this.name });
+                const cwd = budget.context.cwd;
+                this.lifecycle.assertOpen();
+                const path = resolvePath(cwd, pathText(this.name));
+                const fs = budget.context.fs;
+                this.lifecycle.assertOpen();
+                const statMethod = fs.stat;
+                this.lifecycle.assertOpen();
+                const stat = await Reflect.apply(statMethod, fs, [path, { signal: budget.signal }]);
+                this.lifecycle.assertOpen();
+                const type = stat.type;
+                this.lifecycle.assertOpen();
+                if (this.name.endsWith("/") && type !== "directory")
+                    throw new FsError("ENOTDIR", { path });
+                if (type === "directory")
+                    throw new FsError("EISDIR", { path });
+                if (type !== "file" && type !== "character")
+                    throw new FsError("ENOTSUP", { path });
+                const capabilitiesFor = fs.capabilitiesFor;
+                this.lifecycle.assertOpen();
+                const selected = capabilitiesFor ? await Reflect.apply(capabilitiesFor, fs, [path, { signal: budget.signal }]) : undefined;
+                this.lifecycle.assertOpen();
+                const capabilities = selected ?? fs.capabilities;
+                this.lifecycle.assertOpen();
+                const readStream = fs.readStream;
+                this.lifecycle.assertOpen();
+                const streamingRead = readStream && capabilities.streamingRead !== false;
+                this.lifecycle.assertOpen();
+                if (readStream && streamingRead) {
+                    source = Reflect.apply(readStream, fs, [path, { signal: budget.signal, chunkSize: 16_384 }]);
+                    needsAcquisitionCleanup = budget.signal.aborted || budget.admission.closed;
+                }
+                else {
+                    const maximum = Math.min(budget.limits.maxInputBytes, Math.floor(budget.limits.maxBufferedBytes / 2));
+                    const size = stat.size;
+                    this.lifecycle.assertOpen();
+                    budget.check(size, maximum, "buffered input bytes");
+                    budget.retain(maximum);
+                    this.snapshotBytes = maximum;
+                    const readFile = fs.readFile;
+                    this.lifecycle.assertOpen();
+                    const content = await Reflect.apply(readFile, fs, [path, { signal: budget.signal, maxBytes: maximum }]);
+                    this.lifecycle.assertOpen();
+                    if (!(content instanceof Uint8Array))
+                        throw new TypeError("hexdump input requires bytes");
+                    const length = viewLength.call(content);
+                    budget.check(length, maximum, "buffered input bytes");
+                    budget.retain(length - maximum);
+                    this.snapshotBytes = length;
+                    const { releaseSnapshot } = this;
+                    source = { async *[Symbol.asyncIterator]() { try {
+                            yield content;
+                        }
+                        finally {
+                            releaseSnapshot();
+                        } } };
+                }
+            }
+            if (!needsAcquisitionCleanup)
+                this.lifecycle.assertOpen();
+            const factory = source[Symbol.asyncIterator];
+            if (!needsAcquisitionCleanup)
+                this.lifecycle.assertOpen();
+            this.iterator = Reflect.apply(factory, source, []);
+        });
+    }
+    async get() {
+        const { budget } = this.lifecycle;
+        budget.charge();
+        await budget.checkpointWork();
+        while (this.offset === this.chunk.length) {
+            if (this.ended)
+                return -1;
+            await budget.checkpointWork();
+            const next = await this.lifecycle.operation(() => {
+                const iterator = this.iterator;
+                const advance = iterator.next;
+                this.lifecycle.assertOpen();
+                return Reflect.apply(advance, iterator, []);
+            });
+            budget.retain(-this.chunk.length);
+            this.chunk = new Uint8Array();
+            this.offset = 0;
+            const done = next.done;
+            this.lifecycle.assertOpen();
+            if (done) {
+                this.ended = true;
+                this.iterator = undefined;
+                return -1;
+            }
+            const value = next.value;
+            this.lifecycle.assertOpen();
+            if (!(value instanceof Uint8Array))
+                throw new TypeError("hexdump input requires bytes");
+            const buffer = viewBuffer.call(value);
+            const offset = viewOffset.call(value);
+            const length = viewLength.call(value);
+            this.lifecycle.assertOpen();
+            budget.inputBytes(length);
+            budget.charge(length);
+            budget.retain(length);
+            try {
+                if (viewOffset.call(value) !== offset || viewLength.call(value) < length)
+                    throw new TypeError("hexdump input extent changed during admission");
+                this.chunk = new Uint8Array(new Uint8Array(buffer, offset, length));
+            }
+            catch (error) {
+                budget.retain(-length);
+                throw error;
+            }
+            if (!this.chunk.length)
+                budget.check(++this.empties, budget.limits.maxEmptyChunks, "empty input chunks");
+        }
+        return this.chunk[this.offset++];
+    }
+}
+export function fsDetail(error) {
+    const details = {
+        EACCES: "Permission denied", EPERM: "Operation not permitted", ENOENT: "No such file or directory",
+        EISDIR: "Is a directory", ENOTDIR: "Not a directory", EIO: "Input/output error", ELOOP: "Too many levels of symbolic links",
+        ENAMETOOLONG: "File name too long", ENOTSUP: "Operation not supported",
+    };
+    return details[error.code] ?? error.message;
+}
+//# sourceMappingURL=io.js.map