@sparkwing/sdk 0.0.0-stage → 0.68.2

package/dist/helpers/git.js

@@ -0,0 +1,263 @@
+import { createHash } from "node:crypto";
+import * as fs from "node:fs/promises";
+import * as paths from "node:path";
+import { assertExecution } from "../scope.js";
+import { isMissing, path, regularFiles, inputMatcher } from "./files.js";
+async function command(ctx, directory, ...args) {
+    assertExecution();
+    const result = await ctx
+        .exec(["git", ...args], {
+        cwd: directory || path(),
+        env: { GIT_TERMINAL_PROMPT: "0", GCM_INTERACTIVE: "0" },
+    })
+        .capture();
+    return result.stdout;
+}
+function exitCode(error) {
+    return typeof error === "object" && error !== null && "exitCode" in error ? Number(error.exitCode) : undefined;
+}
+async function optionalRef(ctx, directory, ref) {
+    try {
+        return (await command(ctx, directory, "symbolic-ref", "--quiet", "--short", ref)).trim();
+    }
+    catch (error) {
+        if (exitCode(error) !== 1)
+            throw error;
+        await command(ctx, directory, "rev-parse", "--git-dir");
+        return "";
+    }
+}
+async function currentSHA(ctx, directory) {
+    return (await command(ctx, directory, "rev-parse", "HEAD")).trim();
+}
+async function remoteOriginURL(ctx, directory) {
+    const remotes = (await command(ctx, directory, "remote")).trim().split("\n");
+    if (!remotes.includes("origin"))
+        return "";
+    return (await command(ctx, directory, "remote", "get-url", "origin")).trim();
+}
+async function hasRepository(directory) {
+    let current = paths.resolve(directory);
+    for (;;) {
+        try {
+            await fs.lstat(paths.join(current, ".git"));
+            return true;
+        }
+        catch (error) {
+            if (!isMissing(error))
+                throw error;
+        }
+        const parent = paths.dirname(current);
+        if (parent === current)
+            return false;
+        current = parent;
+    }
+}
+async function filesetHash(ctx, directory) {
+    assertExecution();
+    const root = path(directory || ".");
+    const names = (await hasRepository(root))
+        ? (await command(ctx, root, "ls-files", "-z", "--cached", "--others", "--exclude-standard")).split("\0").filter(Boolean)
+        : await regularFiles(root, ctx.signal, new Set([".git", "node_modules", "vendor", "dist", "build", ".sparkwing"]));
+    let ignores = [];
+    try {
+        ignores = (await fs.readFile(paths.join(root, ".dockerignore"), "utf8"))
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((line) => line && !line.startsWith("#"))
+            .map((pattern) => {
+            const matches = inputMatcher(pattern);
+            return (file) => matches(file) || file.startsWith(pattern + "/");
+        });
+    }
+    catch (error) {
+        if (!isMissing(error))
+            throw error;
+    }
+    const hash = createHash("sha256");
+    for (const name of [...new Set(names)].sort()) {
+        ctx.signal.throwIfAborted();
+        if (ignores.some((ignore) => ignore(name)))
+            continue;
+        const file = paths.join(root, name);
+        let stat;
+        try {
+            stat = await fs.stat(file);
+        }
+        catch (error) {
+            if (isMissing(error))
+                continue;
+            throw error;
+        }
+        if (!stat.isFile())
+            continue;
+        const bytes = await fs.readFile(file);
+        hash.update(`${Buffer.byteLength(name)}\0${name}\0${stat.mode & 0o777}\0${bytes.length}\0`).update(bytes);
+    }
+    return names.length ? hash.digest("hex").slice(0, 12) : "";
+}
+function version(value) {
+    const match = /^v?(0|[1-9]\d*)(?:\.(0|[1-9]\d*))?(?:\.(0|[1-9]\d*))?(?:-([\da-zA-Z-]+(?:\.[\da-zA-Z-]+)*))?(?:\+([\da-zA-Z-]+(?:\.[\da-zA-Z-]+)*))?$/.exec(value);
+    if (!match || ((match[4] || match[5]) && !match[3]))
+        return undefined;
+    const prerelease = match[4]?.split(".") ?? [];
+    if (prerelease.some((part) => /^0\d+$/.test(part)))
+        return undefined;
+    return { numbers: [BigInt(match[1]), BigInt(match[2] ?? 0), BigInt(match[3] ?? 0)], prerelease };
+}
+function compare(a, b) {
+    for (let i = 0; i < 3; i++)
+        if (a.numbers[i] !== b.numbers[i])
+            return a.numbers[i] > b.numbers[i] ? 1 : -1;
+    if (!a.prerelease.length || !b.prerelease.length)
+        return Number(!a.prerelease.length) - Number(!b.prerelease.length);
+    for (let i = 0; i < Math.min(a.prerelease.length, b.prerelease.length); i++) {
+        const left = a.prerelease[i], right = b.prerelease[i];
+        if (left === right)
+            continue;
+        const leftNumber = /^\d+$/.test(left), rightNumber = /^\d+$/.test(right);
+        if (leftNumber !== rightNumber)
+            return leftNumber ? -1 : 1;
+        return leftNumber ? (BigInt(left) > BigInt(right) ? 1 : -1) : left > right ? 1 : -1;
+    }
+    return a.prerelease.length - b.prerelease.length;
+}
+async function latestTag(ctx, directory, prefix) {
+    const tags = (await command(ctx, directory, "tag", "--list")).trim().split("\n");
+    let best = "", bestVersion;
+    for (const tag of tags) {
+        if (!tag.startsWith(prefix))
+            continue;
+        const candidate = version(tag.slice(prefix.length));
+        if (candidate && (!bestVersion || compare(candidate, bestVersion) > 0)) {
+            best = tag;
+            bestVersion = candidate;
+        }
+    }
+    return best;
+}
+async function validateTag(ctx, directory, tag) {
+    if (!tag || tag.startsWith("-"))
+        throw new Error("Git tag must be a valid nonempty tag name");
+    await command(ctx, directory, "check-ref-format", `refs/tags/${tag}`);
+}
+async function tagExistsOnRemote(ctx, directory, tag) {
+    await validateTag(ctx, directory, tag);
+    const output = await command(ctx, directory, "ls-remote", "--tags", "origin", `refs/tags/${tag}`);
+    return output.split("\n").some((line) => line.split("\t")[1] === `refs/tags/${tag}`);
+}
+async function pushTag(ctx, directory, tag, message) {
+    if (await tagExistsOnRemote(ctx, directory, tag))
+        throw new Error(`Git tag already exists on remote: ${tag}`);
+    let local;
+    try {
+        local = (await command(ctx, directory, "rev-parse", "--verify", "--quiet", `refs/tags/${tag}^{commit}`)).trim();
+    }
+    catch (error) {
+        if (exitCode(error) !== 1)
+            throw error;
+    }
+    if (local !== undefined && local !== (await currentSHA(ctx, directory)))
+        throw new Error(`Local git tag points outside HEAD: ${tag}`);
+    if (local === undefined)
+        await command(ctx, directory, "tag", "-a", tag, "-m", message || tag);
+    await command(ctx, directory, "push", "origin", `refs/tags/${tag}`);
+}
+export const git = {
+    async clone(ctx, url, destDir, options = {}) {
+        const args = ["clone"];
+        if (options.depth !== undefined) {
+            if (!Number.isInteger(options.depth) || options.depth <= 0)
+                throw new Error("Clone depth must be positive");
+            args.push("--depth", String(options.depth));
+        }
+        await command(ctx, "", ...args, "--", url, destDir);
+    },
+    async fetch(ctx, directory) {
+        await command(ctx, directory, "fetch");
+    },
+    async shortCommit(ctx, directory) {
+        return (await currentSHA(ctx, directory)).slice(0, 12);
+    },
+    currentSHA,
+    currentBranch: (ctx, directory) => optionalRef(ctx, directory, "HEAD"),
+    async defaultBranch(ctx, directory) {
+        return (await optionalRef(ctx, directory, "refs/remotes/origin/HEAD")).replace(/^origin\//, "");
+    },
+    remoteOriginURL,
+    async isDirty(ctx, directory) {
+        return (await command(ctx, directory, "status", "--porcelain")).trim() !== "";
+    },
+    filesetHash,
+    async changedFiles(ctx, directory, since) {
+        return (await command(ctx, directory, "diff", "--name-only", "-z", ...(since ? ["--end-of-options", `${since}...HEAD`] : ["HEAD"])))
+            .split("\0")
+            .filter(Boolean);
+    },
+    async tagsAtHead(ctx, directory) {
+        return (await command(ctx, directory, "tag", "--points-at", "HEAD")).trim().split("\n").filter(Boolean);
+    },
+    latestTag,
+    tagExistsOnRemote,
+    pushTag,
+};
+export class Git {
+    repo;
+    branch;
+    commit;
+    defaultBranch;
+    repoURL;
+    #directory;
+    constructor(directory, facts) {
+        this.#directory = directory;
+        this.repo = facts.repo;
+        this.branch = facts.branch;
+        this.commit = facts.commit;
+        if (facts.defaultBranch !== undefined)
+            this.defaultBranch = facts.defaultBranch;
+        if (facts.repoURL !== undefined)
+            this.repoURL = facts.repoURL;
+        Object.freeze(this);
+    }
+    workDir() {
+        return this.#directory;
+    }
+    shortSHA() {
+        return this.commit.slice(0, 12);
+    }
+    name() {
+        return this.repo.split("/").at(-1) ?? "";
+    }
+    isDirty(ctx) {
+        return git.isDirty(ctx, this.#directory);
+    }
+    filesetHash(ctx) {
+        return git.filesetHash(ctx, this.#directory);
+    }
+    changedFiles(ctx, since) {
+        return git.changedFiles(ctx, this.#directory, since);
+    }
+    tagsAtHead(ctx) {
+        return git.tagsAtHead(ctx, this.#directory);
+    }
+    latestTag(ctx, prefix) {
+        return git.latestTag(ctx, this.#directory, prefix);
+    }
+    pushTag(ctx, tag, message) {
+        return git.pushTag(ctx, this.#directory, tag, message);
+    }
+}
+export async function gitFromTree(ctx, directory) {
+    const root = path(directory || ".");
+    const commit = await git.currentSHA(ctx, root);
+    const branch = await git.currentBranch(ctx, root);
+    const defaultBranch = await git.defaultBranch(ctx, root);
+    const repoURL = await git.remoteOriginURL(ctx, root);
+    const match = /^(?:git@github\.com:|https?:\/\/github\.com\/)([^/]+)\/([^/]+?)(?:\.git)?\/?$/.exec(repoURL);
+    return new Git(root, { commit, branch, defaultBranch, repoURL, repo: match ? `${match[1]}/${match[2]}` : "" });
+}
+export function githubOwnerRepo(slug) {
+    const match = /^([^/]+)\/(.+)$/.exec(slug.trim());
+    return match ? { owner: match[1], repo: match[2] } : { owner: "", repo: "" };
+}
+//# sourceMappingURL=git.js.map

package/dist/helpers/git.js.map

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

package/dist/helpers/memo.js

@@ -0,0 +1,29 @@
+export const noMemo = Symbol("noMemo");
+export function memoKey(...parts) {
+    return parts.includes(noMemo) ? noMemo : parts;
+}
+export function ignore(...patterns) {
+    return { ignore: patterns };
+}
+export function files(...patterns) {
+    return { kind: "files", patterns };
+}
+export function repoFiles(...options) {
+    return { kind: "repo_files", patterns: options.flatMap((option) => option.ignore) };
+}
+export function tree(root) {
+    return { kind: "tree", root };
+}
+export function env(...names) {
+    return { kind: "env", names };
+}
+export function constant(value) {
+    return { kind: "const", value };
+}
+export function compose(...inputs) {
+    return { kind: "compose", inputs };
+}
+export function parts(...values) {
+    return { kind: "parts", parts: values };
+}
+//# sourceMappingURL=memo.js.map

package/dist/helpers/memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.js","sourceRoot":"","sources":["../../src/helpers/memo.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,MAAM,GAAkB,MAAM,CAAC,QAAQ,CAAkB,CAAC;AAEvE,MAAM,UAAU,OAAO,CAAC,GAAG,KAAyB;IAClD,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AACjD,CAAC;AACD,MAAM,UAAU,MAAM,CAAC,GAAG,QAA2B;IACnD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC;AACD,MAAM,UAAU,KAAK,CAAC,GAAG,QAA2B;IAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,GAAG,OAAmC;IAC9D,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;AACtF,CAAC;AACD,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AACD,MAAM,UAAU,GAAG,CAAC,GAAG,KAAwB;IAC7C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAClC,CAAC;AACD,MAAM,UAAU,OAAO,CAAC,GAAG,MAA4B;IACrD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,GAAG,MAA0B;IACjD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC"}

package/dist/helpers/services.js

@@ -0,0 +1,160 @@
+import { randomBytes } from "node:crypto";
+import { assertExecution } from "../scope.js";
+import { cleanupContext, withSignal } from "../command.js";
+import { dockerCommand, removeContainer } from "./docker.js";
+const autoPort = -1;
+const defaultReadyTimeoutMs = 30000;
+const cleanupProgram = `
+const { execFileSync } = require("node:child_process");
+const ids = execFileSync("docker", ["ps", "--all", "--quiet", "--no-trunc", "--filter", "label=" + process.argv[1]], { encoding: "utf8" }).trim().split(/\\s+/).filter(Boolean);
+if (ids.some(id => !/^[a-f0-9]{64}$/.test(id))) throw new Error("Docker returned an invalid container ID");
+if (ids.length) execFileSync("docker", ["rm", "-f", ...ids], { stdio: "inherit" });
+`;
+function delay(ms, signal) {
+    signal.throwIfAborted();
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            signal.removeEventListener("abort", abort);
+            resolve();
+        }, ms);
+        function abort() {
+            clearTimeout(timer);
+            reject(signal.reason);
+        }
+        signal.addEventListener("abort", abort, { once: true });
+    });
+}
+async function ready(ctx, spec, name) {
+    if (!spec.readyCmd) {
+        await delay(2000, ctx.signal);
+        return;
+    }
+    const timeout = spec.readyTimeoutMs || defaultReadyTimeoutMs;
+    const deadline = new AbortController();
+    const timer = setTimeout(() => deadline.abort(new Error(`Service ${name} did not become ready within ${timeout}ms`)), timeout);
+    const signal = AbortSignal.any([ctx.signal, deadline.signal]);
+    try {
+        for (;;) {
+            signal.throwIfAborted();
+            const attempt = new AbortController();
+            const attemptTimer = setTimeout(() => attempt.abort(new Error(`Service ${name} readiness command timed out`)), 1500);
+            try {
+                await dockerCommand(withSignal(ctx, AbortSignal.any([signal, attempt.signal])), "exec", name, "sh", "-c", spec.readyCmd);
+                signal.throwIfAborted();
+                return;
+            }
+            catch (error) {
+                signal.throwIfAborted();
+                ctx.log.debug("Service readiness command failed", { name, error: String(error) });
+            }
+            finally {
+                clearTimeout(attemptTimer);
+            }
+            await delay(500, signal);
+        }
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function nameFor(spec) {
+    if (spec.name)
+        return spec.name;
+    const image = spec.image.split("@")[0].split("/").at(-1).split(":")[0];
+    return (image.replace(/[^a-zA-Z0-9_.-]/g, "-") || "service") + "-" + randomBytes(3).toString("hex");
+}
+function validate(spec) {
+    if (!spec.image)
+        throw new Error("Service image is required");
+    const port = spec.port ?? 0, host = spec.hostPort ?? 0;
+    if (!Number.isInteger(port) || port < 0 || port > 65535)
+        throw new Error("Service port must be between 0 and 65535");
+    if (!Number.isInteger(host) || host < -1 || host > 65535)
+        throw new Error("Service hostPort must be autoPort or between 0 and 65535");
+    if (!port && host)
+        throw new Error("Service hostPort requires a container port");
+    if (!port && process.platform !== "linux")
+        throw new Error("Service host networking requires Linux");
+    if (spec.readyTimeoutMs !== undefined && (!Number.isFinite(spec.readyTimeoutMs) || spec.readyTimeoutMs < 0))
+        throw new Error("Service readiness timeout must be nonnegative");
+}
+async function withServicesAddrs(ctx, specs, fn) {
+    assertExecution();
+    const resolved = specs.map((spec) => {
+        validate(spec);
+        return { ...spec, name: nameFor(spec) };
+    });
+    const owned = [];
+    const containers = [];
+    const addrs = [];
+    let failed = false;
+    try {
+        for (const spec of resolved) {
+            const label = "dev.sparkwing.service=" + randomBytes(16).toString("hex");
+            const cleanup = [process.execPath, "-e", cleanupProgram, label];
+            const registration = await ctx.cleanup({ argv: cleanup, description: `Service ${spec.name}` });
+            const resource = { cleanup, registration };
+            owned.push(resource);
+            const args = ["create", "--name", spec.name, "--label", label];
+            const hostPort = spec.hostPort || spec.port || 0;
+            if (spec.port)
+                args.push("-p", `127.0.0.1:${hostPort === autoPort ? "" : hostPort}:${spec.port}`);
+            else
+                args.push("--network=host");
+            for (const key of Object.keys(spec.env ?? {}).sort())
+                args.push("-e", `${key}=${spec.env[key]}`);
+            args.push(spec.image);
+            const created = await dockerCommand(ctx, ...args);
+            const id = created.stdout.trim();
+            if (!/^[a-f0-9]{12,64}$/.test(id))
+                throw new Error(`Docker did not report a container ID for ${spec.name}`);
+            resource.name = id;
+            containers.push(id);
+            await dockerCommand(ctx, "start", id);
+            let actual = hostPort;
+            if (hostPort === autoPort) {
+                const result = await dockerCommand(ctx, "port", id, `${spec.port}/tcp`);
+                const match = /^127\.0\.0\.1:(\d+)\s*$/m.exec(result.stdout);
+                actual = Number(match?.[1]);
+                if (!Number.isInteger(actual) || actual < 1 || actual > 65535)
+                    throw new Error(`Docker did not report a host port for ${spec.name}`);
+            }
+            addrs.push({ name: spec.name, hostPort: actual });
+        }
+        for (let i = 0; i < resolved.length; i++)
+            await ready(ctx, resolved[i], containers[i]);
+        ctx.signal.throwIfAborted();
+        await fn(ctx, addrs);
+        ctx.signal.throwIfAborted();
+    }
+    catch (error) {
+        failed = true;
+        throw error;
+    }
+    finally {
+        const errors = [];
+        for (const { name, cleanup, registration } of owned.toReversed()) {
+            try {
+                if (name)
+                    await removeContainer(ctx, name, registration);
+                else {
+                    await cleanupContext(ctx).exec(cleanup).run();
+                    await registration.unregister();
+                }
+            }
+            catch (error) {
+                errors.push(error);
+                ctx.log.warn("Service cleanup failed; host cleanup remains registered", { name, error: String(error) });
+            }
+        }
+        if (!failed && errors.length)
+            throw new AggregateError(errors, "Service cleanup failed");
+    }
+}
+export const services = {
+    autoPort,
+    defaultReadyTimeoutMs,
+    withServicesAddrs,
+    withServices: (ctx, specs, fn) => withServicesAddrs(ctx, specs, fn),
+};
+//# sourceMappingURL=services.js.map

package/dist/helpers/services.js.map

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

package/dist/index.js

@@ -0,0 +1,10 @@
+export { definePipeline, Plan, Job, Step, ConcurrencyGroup, startup, goModules, npm, dir, refTo, refToLastRun } from "./plan.js";
+export { main } from "./main.js";
+export { SDKError, InputError, VerifyError, StepError, NoProjectError } from "./errors.js";
+export { ExecError, exitNotStarted, withCommandEnv } from "./command.js";
+export { workDir, path, readFile, writeFile, glob } from "./helpers/files.js";
+export { noMemo, memoKey, parts, ignore, files, repoFiles, tree, env, constant, compose } from "./helpers/memo.js";
+export { Git, gitFromTree, githubOwnerRepo, git } from "./helpers/git.js";
+export { docker } from "./helpers/docker.js";
+export { services } from "./helpers/services.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACjI,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACnH,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/json.js

@@ -0,0 +1,27 @@
+export function parseJSON(text) {
+    const value = JSON.parse(text);
+    const stack = [];
+    for (const [token] of text.matchAll(/"(?:[^"\\]|\\[\s\S])*"|[{}\[\],:]/g)) {
+        const current = stack.at(-1);
+        if (token === "{")
+            stack.push({ keys: new Set(), key: true });
+        else if (token === "[")
+            stack.push(undefined);
+        else if (token === "}" || token === "]")
+            stack.pop();
+        else if (current) {
+            if (token === ",")
+                current.key = true;
+            else if (token === ":")
+                current.key = false;
+            else if (current.key) {
+                const key = JSON.parse(token);
+                if (current.keys.has(key))
+                    throw new SyntaxError("duplicate JSON field");
+                current.keys.add(key);
+            }
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,KAAK,GAAwD,EAAE,CAAC;IACtE,KAAK,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,oCAAoC,CAAC,EAAE,CAAC;QAC1E,MAAM,OAAO,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,KAAK,KAAK,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;aACzD,IAAI,KAAK,KAAK,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;aACzC,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG;YAAE,KAAK,CAAC,GAAG,EAAE,CAAC;aAChD,IAAI,OAAO,EAAE,CAAC;YACjB,IAAI,KAAK,KAAK,GAAG;gBAAE,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;iBACjC,IAAI,KAAK,KAAK,GAAG;gBAAE,OAAO,CAAC,GAAG,GAAG,KAAK,CAAC;iBACvC,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBACrB,MAAM,GAAG,GAAW,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,MAAM,IAAI,WAAW,CAAC,sBAAsB,CAAC,CAAC;gBACzE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/log.js

@@ -0,0 +1,42 @@
+import { writeFrame } from "./protocol.js";
+export class LogWriter {
+    #sink;
+    #step;
+    #now;
+    constructor(sink, step, now = () => new Date()) {
+        this.#sink = sink;
+        this.#step = step;
+        this.#now = now;
+    }
+    debug(msg, attrs) {
+        this.#log("debug", msg, attrs);
+    }
+    info(msg, attrs) {
+        this.#log("info", msg, attrs);
+    }
+    warn(msg, attrs) {
+        this.#log("warn", msg, attrs);
+    }
+    error(msg, attrs) {
+        this.#log("error", msg, attrs);
+    }
+    event(event, attrs) {
+        if (event === "exec_chunk") {
+            this.#emit({
+                ts: this.#now().toISOString(), level: "info", event: "exec_line", stream: String(attrs?.stream ?? ""),
+                ...(attrs?.data === undefined ? {} : { stream_data: String(attrs.data) }),
+                ...(attrs?.end === true ? { stream_end: true } : {}),
+            });
+            return;
+        }
+        const msg = event === "exec_start" ? `$ ${String(attrs?.command ?? "")}` : undefined;
+        this.#emit({ ts: this.#now().toISOString(), level: "info", event, ...(attrs ? { attrs } : {}), ...(msg === undefined ? {} : { msg }) });
+    }
+    #log(level, msg, attrs) {
+        this.#emit({ ts: this.#now().toISOString(), level, msg, ...(attrs ? { attrs } : {}) });
+    }
+    #emit(record) {
+        writeFrame(this.#sink, { ...record, ...(this.#step === undefined ? {} : { step: this.#step }) });
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/log.js.map

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