@functional-systems/srcx 0.1.0-dev.1

package/dist/common.js

@@ -0,0 +1,74 @@
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+export const APP = "srcx";
+export const PURPOSE = "code-search-v1";
+export function canonical(value) {
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(",")}]`;
+    if (value && typeof value === "object")
+        return `{${Object.entries(value)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+            .map(([k, v]) => `${JSON.stringify(k)}:${canonical(v)}`)
+            .join(",")}}`;
+    return JSON.stringify(value);
+}
+export function hash(value) {
+    return createHash("sha256")
+        .update(Buffer.isBuffer(value)
+        ? value
+        : typeof value === "string"
+            ? value
+            : canonical(value))
+        .digest("hex");
+}
+export function invariant(value, message) {
+    if (!value)
+        throw new Error(message);
+}
+export async function atomic(path, value) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const temp = `${path}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temp, `${JSON.stringify(value, null, 2)}\n`, {
+            flag: "wx",
+            mode: 0o600,
+        });
+        await rename(temp, path);
+    }
+    finally {
+        await rm(temp, { force: true });
+    }
+}
+export async function json(path) {
+    return JSON.parse(await readFile(path, "utf8"));
+}
+export async function optionalJson(path) {
+    try {
+        return await json(path);
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return undefined;
+        throw e;
+    }
+}
+export function utf8(bytes) {
+    const s = bytes.toString("utf8");
+    return Buffer.from(s).equals(bytes) ? s : undefined;
+}
+export function sortedHash(docs) {
+    return hash([...docs].sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0)));
+}
+export function lineAt(source, byte) {
+    let n = 1;
+    for (let i = 0; i < byte; i++)
+        if (source[i] === 10)
+            n++;
+    return n;
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,38 @@
+export declare function git(path: string, args: string[]): Promise<Buffer>;
+export declare function resolveCommit(path: string, ref: string): Promise<{
+    oid: string;
+    branch?: string;
+    time: string;
+}>;
+export type Entry = {
+    path: string;
+    pathBase64: string;
+    validPath: boolean;
+    mode: string;
+    oid: string;
+    type: string;
+    bytes: number;
+};
+export declare function inventory(path: string, oid: string): Promise<Entry[]>;
+/** One sequential cat-file process; each response is bounded to one allowed blob. */
+export declare class Blobs {
+    private child;
+    private iterator;
+    private buffer;
+    constructor(path: string);
+    private fill;
+    read(e: Entry): Promise<Buffer>;
+    close(): void;
+}
+export declare function normalizeRemote(raw: string): string;
+export type Identity = {
+    key: string;
+    name: string;
+    path: string;
+    remote?: string;
+};
+export declare function identity(path: string, remote?: string): Promise<Identity>;
+export declare function gitTags(path: string): Promise<{
+    ref: string;
+    oid: string;
+}[]>;

package/dist/git.js

@@ -0,0 +1,224 @@
+import { execFile, spawn } from "node:child_process";
+import { promisify } from "node:util";
+import { realpath } from "node:fs/promises";
+import { basename, join } from "node:path";
+import { randomUUID } from "node:crypto";
+import { atomic, hash, invariant, optionalJson, utf8 } from "./common.js";
+import { stateRoot } from "./settings.js";
+const exec = promisify(execFile);
+export async function git(path, args) {
+    try {
+        const r = await exec("git", ["--no-replace-objects", "-C", path, ...args], {
+            encoding: "buffer",
+            maxBuffer: 64 * 1024 * 1024,
+            env: {
+                ...process.env,
+                GIT_NO_REPLACE_OBJECTS: "1",
+                GIT_TERMINAL_PROMPT: "0",
+            },
+        });
+        return r.stdout;
+    }
+    catch {
+        throw new Error(`Git ${args[0]} failed. Verify the repository, ref, and local objects.`);
+    }
+}
+export async function resolveCommit(path, ref) {
+    invariant(ref && !ref.startsWith("-") && !/[\s~^:@{\\]/.test(ref), "Use a branch, Git tag, or commit OID; revision expressions are not supported.");
+    let qualified = ref;
+    let branch;
+    const exists = async (r) => {
+        try {
+            await git(path, ["show-ref", "--verify", "--hash", r]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    if (ref.startsWith("refs/")) {
+        invariant(ref.startsWith("refs/heads/") || ref.startsWith("refs/tags/"), "Only heads/tags refs are supported.");
+        invariant(await exists(ref), "Ref not found.");
+        if (ref.startsWith("refs/heads/"))
+            branch = ref;
+    }
+    else {
+        const heads = await exists(`refs/heads/${ref}`), tags = await exists(`refs/tags/${ref}`);
+        invariant(!(heads && tags), "Ambiguous branch/tag name: use refs/heads/... or refs/tags/...");
+        if (heads) {
+            qualified = `refs/heads/${ref}`;
+            branch = qualified;
+        }
+        else if (tags)
+            qualified = `refs/tags/${ref}`;
+        else
+            invariant(/^[0-9a-fA-F]{4,64}$/.test(ref), "Unknown ref; only local branch/tag names and commit OIDs are accepted.");
+    }
+    const oid = (await git(path, [
+        "rev-parse",
+        "--verify",
+        "--end-of-options",
+        `${qualified}^{commit}`,
+    ]))
+        .toString()
+        .trim();
+    const time = (await git(path, ["show", "-s", "--format=%cI", oid]))
+        .toString()
+        .trim();
+    return { oid, branch, time };
+}
+export async function inventory(path, oid) {
+    const raw = await git(path, ["ls-tree", "-r", "-z", "--full-tree", oid]);
+    const entries = [];
+    let start = 0;
+    for (let i = 0; i < raw.length; i++)
+        if (raw[i] === 0) {
+            const rec = raw.subarray(start, i);
+            start = i + 1;
+            const tab = rec.indexOf(9);
+            invariant(tab >= 0, "Malformed Git tree.");
+            const [mode, type, object] = rec.subarray(0, tab).toString().split(" ");
+            const name = rec.subarray(tab + 1);
+            const decoded = utf8(name);
+            invariant(mode && type && object, "Malformed tree metadata.");
+            entries.push({
+                path: decoded ?? `<invalid-utf8:${name.toString("base64")}>`,
+                pathBase64: name.toString("base64"),
+                validPath: decoded !== undefined,
+                mode,
+                oid: object,
+                type,
+                bytes: 0,
+            });
+        }
+    const blobs = entries.filter((e) => e.type === "blob");
+    if (blobs.length) {
+        const child = spawn("git", [
+            "--no-replace-objects",
+            "-C",
+            path,
+            "cat-file",
+            "--batch-check=%(objectname) %(objecttype) %(objectsize)",
+        ], { stdio: ["pipe", "pipe", "ignore"] });
+        const pieces = [];
+        child.stdout.on("data", (b) => pieces.push(b));
+        const ended = new Promise((ok, no) => {
+            child.once("error", no);
+            child.once("close", (c) => c === 0 ? ok() : no(new Error("Git object size lookup failed.")));
+        });
+        child.stdin.on("error", () => { });
+        child.stdin.end(blobs.map((e) => e.oid + "\n").join(""));
+        await ended;
+        const lines = Buffer.concat(pieces).toString().trim().split("\n");
+        invariant(lines.length === blobs.length, "Incomplete Git object inventory.");
+        lines.forEach((line, i) => {
+            const [id, type, size] = line.split(" ");
+            const e = blobs[i];
+            invariant(id === e.oid && type === "blob" && /^\d+$/.test(size ?? ""), "Missing Git blob.");
+            e.bytes = Number(size);
+        });
+    }
+    return entries;
+}
+/** One sequential cat-file process; each response is bounded to one allowed blob. */
+export class Blobs {
+    child;
+    iterator;
+    buffer = Buffer.alloc(0);
+    constructor(path) {
+        this.child = spawn("git", ["--no-replace-objects", "-C", path, "cat-file", "--batch"], { stdio: ["pipe", "pipe", "ignore"] });
+        this.child.on("error", () => { });
+        this.child.stdin.on("error", () => { });
+        this.iterator = this.child.stdout[Symbol.asyncIterator]();
+    }
+    async fill(n) {
+        while (this.buffer.length < n) {
+            const r = await this.iterator.next();
+            invariant(!r.done, "Git blob stream ended early.");
+            this.buffer = Buffer.concat([this.buffer, r.value]);
+        }
+    }
+    async read(e) {
+        this.child.stdin.write(e.oid + "\n");
+        let newline = this.buffer.indexOf(10);
+        while (newline < 0) {
+            await this.fill(this.buffer.length + 1);
+            newline = this.buffer.indexOf(10);
+        }
+        const header = this.buffer.subarray(0, newline).toString();
+        this.buffer = this.buffer.subarray(newline + 1);
+        invariant(header === `${e.oid} blob ${e.bytes}`, "Git blob metadata changed or object is missing.");
+        await this.fill(e.bytes + 1);
+        const data = Buffer.from(this.buffer.subarray(0, e.bytes));
+        invariant(this.buffer[e.bytes] === 10, "Malformed Git blob response.");
+        this.buffer = this.buffer.subarray(e.bytes + 1);
+        return data;
+    }
+    close() {
+        this.child.stdin.end();
+        this.child.kill();
+    }
+}
+export function normalizeRemote(raw) {
+    const value = raw.trim();
+    let host, path;
+    if (value.includes("://")) {
+        const u = new URL(value);
+        invariant(["ssh:", "https:", "http:", "git:"].includes(u.protocol) &&
+            !u.search &&
+            !u.hash, "Unsupported remote URL.");
+        host = u.host.toLowerCase();
+        path = u.pathname;
+    }
+    else {
+        const m = /^(?:[^@/:]+@)?([^/:]+):(.+)$/.exec(value);
+        invariant(m, "Remote must be a network Git URL; local-path remotes need explicit support.");
+        host = m[1].toLowerCase();
+        path = m[2];
+    }
+    path = path.replace(/^\/+|\/+$/g, "").replace(/\.git$/, "");
+    invariant(host && path && !path.split("/").some((x) => !x || x === "." || x === ".."), "Invalid remote identity.");
+    if (host === "github.com")
+        path = path.toLowerCase();
+    return `${host}/${path}`;
+}
+export async function identity(path, remote) {
+    path = await realpath(path);
+    await git(path, ["rev-parse", "--git-dir"]);
+    const names = (await git(path, ["remote"]))
+        .toString()
+        .trim()
+        .split("\n")
+        .filter(Boolean);
+    let selected = remote;
+    if (!selected && names.includes("origin"))
+        selected = "origin";
+    if (!selected && names.length)
+        throw new Error("No origin remote; choose --remote explicitly.");
+    if (selected) {
+        invariant(names.includes(selected), "Selected remote does not exist.");
+        const key = normalizeRemote((await git(path, ["remote", "get-url", selected])).toString());
+        return { key, name: key.split("/").at(-1), path, remote: selected };
+    }
+    const file = join(stateRoot(), "local-sources", hash(path) + ".json");
+    let saved = await optionalJson(file);
+    if (!saved) {
+        saved = { key: `local/${randomUUID()}` };
+        await atomic(file, saved);
+    }
+    return { key: saved.key, name: basename(path), path };
+}
+export async function gitTags(path) {
+    const refs = (await git(path, ["for-each-ref", "--format=%(refname)", "refs/tags/"]))
+        .toString()
+        .trim()
+        .split("\n")
+        .filter(Boolean);
+    const result = [];
+    for (const ref of refs) {
+        const { oid } = await resolveCommit(path, ref);
+        result.push({ ref, oid });
+    }
+    return result;
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AACjC,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAY,EAAE,IAAc;IACpD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,sBAAsB,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE;YACzE,QAAQ,EAAE,QAAQ;YAClB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;YAC3B,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,sBAAsB,EAAE,GAAG;gBAC3B,mBAAmB,EAAE,GAAG;aACzB;SACF,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,MAAM,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,OAAO,IAAI,CAAC,CAAC,CAAC,yDAAyD,CACxE,CAAC;IACJ,CAAC;AACH,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,GAAW;IAEX,SAAS,CACP,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EACvD,+EAA+E,CAChF,CAAC;IACF,IAAI,SAAS,GAAG,GAAG,CAAC;IACpB,IAAI,MAA0B,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,EAAE,CAAS,EAAE,EAAE;QACjC,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC;IACF,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,SAAS,CACP,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,EAC7D,qCAAqC,CACtC,CAAC;QACF,SAAS,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAC/C,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC;YAAE,MAAM,GAAG,GAAG,CAAC;IAClD,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,cAAc,GAAG,EAAE,CAAC,EAC7C,IAAI,GAAG,MAAM,MAAM,CAAC,aAAa,GAAG,EAAE,CAAC,CAAC;QAC1C,SAAS,CACP,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,EAChB,gEAAgE,CACjE,CAAC;QACF,IAAI,KAAK,EAAE,CAAC;YACV,SAAS,GAAG,cAAc,GAAG,EAAE,CAAC;YAChC,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;aAAM,IAAI,IAAI;YAAE,SAAS,GAAG,aAAa,GAAG,EAAE,CAAC;;YAE9C,SAAS,CACP,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAC/B,wEAAwE,CACzE,CAAC;IACN,CAAC;IACD,MAAM,GAAG,GAAG,CACV,MAAM,GAAG,CAAC,IAAI,EAAE;QACd,WAAW;QACX,UAAU;QACV,kBAAkB;QAClB,GAAG,SAAS,WAAW;KACxB,CAAC,CACH;SACE,QAAQ,EAAE;SACV,IAAI,EAAE,CAAC;IACV,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC,CAAC;SAChE,QAAQ,EAAE;SACV,IAAI,EAAE,CAAC;IACV,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC/B,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAY,EAAE,GAAW;IACvD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC;IACzE,MAAM,OAAO,GAAY,EAAE,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE;QACjC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACnC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC3B,SAAS,CAAC,GAAG,IAAI,CAAC,EAAE,qBAAqB,CAAC,CAAC;YAC3C,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACxE,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,SAAS,CAAC,IAAI,IAAI,IAAI,IAAI,MAAM,EAAE,0BAA0B,CAAC,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO,IAAI,iBAAiB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG;gBAC5D,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACnC,SAAS,EAAE,OAAO,KAAK,SAAS;gBAChC,IAAI;gBACJ,GAAG,EAAE,MAAM;gBACX,IAAI;gBACJ,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;QACL,CAAC;IACH,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,KAAK,CACjB,KAAK,EACL;YACE,sBAAsB;YACtB,IAAI;YACJ,IAAI;YACJ,UAAU;YACV,yDAAyD;SAC1D,EACD,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CACtC,CAAC;QACF,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,IAAI,OAAO,CAAO,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE;YACzC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CACxB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC,CACjE,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,KAAK,CAAC;QACZ,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClE,SAAS,CACP,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAC7B,kCAAkC,CACnC,CAAC;QACF,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACxB,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACzC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACpB,SAAS,CACP,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,EAC3D,mBAAmB,CACpB,CAAC;YACF,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AACD,qFAAqF;AACrF,MAAM,OAAO,KAAK;IACR,KAAK,CAAC;IACN,QAAQ,CAAC;IACT,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjC,YAAY,IAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAChB,KAAK,EACL,CAAC,sBAAsB,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,EAC3D,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CACtC,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;IAC5D,CAAC;IACO,KAAK,CAAC,IAAI,CAAC,CAAS;QAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAC;YACnD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,KAAe,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,CAAQ;QACjB,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QACrC,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,OAAO,OAAO,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACxC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC3D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAChD,SAAS,CACP,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,KAAK,EAAE,EACrC,iDAAiD,CAClD,CAAC;QACF,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,8BAA8B,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;CACF;AACD,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACzB,IAAI,IAAY,EAAE,IAAY,CAAC;IAC/B,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QACzB,SAAS,CACP,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YACtD,CAAC,CAAC,CAAC,MAAM;YACT,CAAC,CAAC,CAAC,IAAI,EACT,yBAAyB,CAC1B,CAAC;QACF,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAC5B,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,GAAG,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,SAAS,CACP,CAAC,EACD,6EAA6E,CAC9E,CAAC;QACF,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;QAC3B,IAAI,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACf,CAAC;IACD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC5D,SAAS,CACP,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,EAC3E,0BAA0B,CAC3B,CAAC;IACF,IAAI,IAAI,KAAK,YAAY;QAAE,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrD,OAAO,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;AAC3B,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,IAAY,EACZ,MAAe;IAEf,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;SACxC,QAAQ,EAAE;SACV,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,IAAI,QAAQ,GAAG,MAAM,CAAC;IACtB,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/D,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM;QAC3B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,IAAI,QAAQ,EAAE,CAAC;QACb,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,iCAAiC,CAAC,CAAC;QACvE,MAAM,GAAG,GAAG,eAAe,CACzB,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAC9D,CAAC;QACF,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACvE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;IACtE,IAAI,KAAK,GAAG,MAAM,YAAY,CAAkB,IAAI,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,EAAE,GAAG,EAAE,SAAS,UAAU,EAAE,EAAE,EAAE,CAAC;QACzC,MAAM,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,IAAY;IAEZ,MAAM,IAAI,GAAG,CACX,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,cAAc,EAAE,qBAAqB,EAAE,YAAY,CAAC,CAAC,CACvE;SACE,QAAQ,EAAE;SACV,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/publish.d.ts

@@ -0,0 +1,60 @@
+import { type Doc } from "./common.js";
+import { type Build } from "./build.js";
+import { type CollectionStore } from "./remote.js";
+export type Binding = {
+    repoId: string;
+    indexId: string;
+    repoKey: string;
+    configHash: string;
+};
+export type Published = Doc & {
+    commitOid: string;
+    tagName: string;
+    snapshotId: string;
+    writer: string;
+    buildId: string;
+    recordsHash: string;
+    inventoryHash: string;
+    attemptId: string;
+};
+export type Journal = {
+    buildId: string;
+    recordsHash: string;
+    inventoryHash: string;
+    artifact: string;
+    attemptId: string;
+    writer: string;
+    source: string;
+    baseline?: Published;
+    phase: "branch" | "writing" | "waiting" | "publishing";
+    batches: {
+        operation: string;
+        hash: string;
+        outcome: "unknown" | "accepted" | "superseded";
+    }[];
+    candidate?: {
+        name: string;
+        snapshotId: string;
+    };
+};
+export declare function versionTag(oid: string): string;
+export declare function versionId(oid: string): string;
+export declare function exclusive<T>(directory: string, work: () => Promise<T>): Promise<T>;
+export declare function matchesManifest(doc: Doc | undefined, b: Build, binding: Binding, attemptId?: string): boolean;
+/** Exact immutable inventory/content comparison, not merely a marker/count check. */
+export declare function validateCandidate(store: CollectionStore, name: string, b: Build, binding: Binding, attemptId: string): Promise<boolean>;
+export declare function published(store: CollectionStore, binding: Binding): Promise<Published[]>;
+/** Caller holds the per-collection lock for the complete import. */
+export declare function publish(args: {
+    store: CollectionStore;
+    binding: Binding;
+    build: Build;
+    state: string;
+    baseline?: {
+        version: Published;
+        build: Build;
+    };
+    resume?: boolean;
+    timeoutMs?: number;
+    pollMs?: number;
+}): Promise<Published>;