@zukhruf/git-hooks 0.0.0-stage → 0.3.42

package/dist/commit.js

@@ -0,0 +1,96 @@
+import { execFile } from 'node:child_process';
+import { mkdtempDisposable } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join, matchesGlob } from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+// The staged commit: the index of the repo at `root`. Each read of a staged
+// file goes to its staged copy, never to the working tree, because other
+// sessions can edit the working tree while the hook runs. The environment is
+// the hook's own, so git keeps the index that `git commit` gave it in
+// GIT_INDEX_FILE.
+export class Commit {
+    root;
+    #environment;
+    constructor(root, environment) {
+        this.root = root;
+        this.#environment = environment;
+    }
+    // The paths that the commit adds, copies, modifies or renames.
+    async staged() {
+        const output = await this.#git('diff', '--cached', '--name-only', '--diff-filter=ACMR', '-z');
+        return output.split('\0').filter((path) => path !== '');
+    }
+    // The staged paths whose staged copy is the content of a file. The staged
+    // copy of a link is the path that it points to, and that of a submodule is
+    // a commit id, so a check of their content would judge the wrong text.
+    async files() {
+        const entries = await this.#git('ls-files', '--stage', '-z');
+        const files = new Set(entries
+            .split('\0')
+            .filter((entry) => /^100(644|755) /.test(entry))
+            .map((entry) => entry.slice(entry.indexOf('\t') + 1)));
+        return (await this.staged()).filter((path) => files.has(path));
+    }
+    // The staged copy of one file.
+    blob(path) {
+        return this.#git('cat-file', 'blob', `:${path}`);
+    }
+    // Whether the commit stages a path that matches one of the globs.
+    async touches(globs) {
+        const staged = await this.staged();
+        return staged.some((path) => globs.some((glob) => matchesGlob(path, glob)));
+    }
+    // Runs `work` on a copy of the staged tree in a temporary folder, for a
+    // check that reads many files at once. The folder is removed afterwards.
+    async inSnapshot(work) {
+        await using snapshot = await mkdtempDisposable(join(tmpdir(), 'git-hooks-'));
+        await this.#git('checkout-index', '--all', `--prefix=${snapshot.path}/`);
+        // Awaited here, so the folder stays until `work` ends.
+        return await work(snapshot.path);
+    }
+    // The tracked files whose working-tree copy differs from the staged copy.
+    async modified() {
+        const output = await this.#git('diff', '--name-only', '-z');
+        return output.split('\0').filter((path) => path !== '');
+    }
+    // Stages files that a step wrote itself. A step never stages anything else.
+    async stage(paths) {
+        await this.#git('add', '--', ...paths);
+    }
+    // Runs the repo's own nx with no daemon, so a hook started from a GUI or an
+    // agent shell does not leave a daemon behind or read its stale graph.
+    async nx(...args) {
+        const { stdout } = await execFileAsync(join(this.root, 'node_modules/.bin/nx'), args, {
+            cwd: this.root,
+            env: { ...this.#environment, NX_DAEMON: 'false' },
+            encoding: 'utf8',
+            maxBuffer: 2 ** 30,
+        });
+        return stdout;
+    }
+    // The nx projects that the staged files affect. The files come from the
+    // staged commit, so an edit that is only in the working tree affects nothing.
+    async affected() {
+        const staged = await this.staged();
+        if (staged.length === 0)
+            return [];
+        const output = await this.nx('show', 'projects', '--affected', `--files=${staged.join(',')}`, '--json');
+        const projects = JSON.parse(output);
+        if (!Array.isArray(projects) ||
+            !projects.every((project) => typeof project === 'string'))
+            throw new TypeError(`nx show projects gave ${output.trim()}, not a list of names`);
+        return projects;
+    }
+    async #git(...args) {
+        const { stdout } = await execFileAsync('git', args, {
+            cwd: this.root,
+            env: this.#environment,
+            encoding: 'utf8',
+            // A staged file of any size, not Node's default of 1 MiB.
+            maxBuffer: 2 ** 30,
+        });
+        return stdout;
+    }
+}
+//# sourceMappingURL=commit.js.map

package/dist/commit.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,7 @@
+import type { Commit } from './commit.ts';
+import { type Outcome, Step } from './step.ts';
+export declare class Format extends Step<Commit> {
+    readonly name = "format";
+    run(commit: Commit): Promise<Outcome>;
+}
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAK/C,qBAAa,MAAO,SAAQ,IAAI,CAAC,MAAM,CAAC;IACtC,QAAQ,CAAC,IAAI,YAAY;IAEnB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAmC5C"}

package/dist/format.js

@@ -0,0 +1,44 @@
+import { join } from 'node:path';
+import { check, getFileInfo, resolveConfig } from 'prettier';
+import { Step } from "./step.js";
+// Checks the staged copy of each staged file with the repo's Prettier config,
+// and changes nothing. A step that formatted and staged files would also stage
+// the edits that another session made to them at the same moment.
+export class Format extends Step {
+    name = 'format';
+    async run(commit) {
+        const unformatted = [];
+        const ignorePath = join(commit.root, '.prettierignore');
+        for (const path of await commit.files()) {
+            const file = join(commit.root, path);
+            // Prettier gives no parser for a file that .prettierignore names or that
+            // it cannot format, so no list of extensions here.
+            const { inferredParser } = await getFileInfo(file, { ignorePath });
+            if (inferredParser === null)
+                continue;
+            const options = await resolveConfig(file);
+            try {
+                const source = await commit.blob(path);
+                const formatted = await check(source, { ...options, filepath: file });
+                if (!formatted)
+                    unformatted.push({ path });
+            }
+            catch (error) {
+                const [reason = ''] = String(error).split('\n');
+                unformatted.push({ path, reason });
+            }
+        }
+        if (unformatted.length === 0)
+            return this.pass('the staged files are formatted');
+        const paths = unformatted.map(({ path }) => path);
+        const one = unformatted.length === 1;
+        return this.fail([
+            one
+                ? '1 staged file is not formatted:'
+                : `${unformatted.length} staged files are not formatted:`,
+            ...unformatted.map(({ path, reason }) => reason === undefined ? `  ${path}` : `  ${path} (${reason})`),
+            `Run \`npx prettier --write ${paths.join(' ')}\`, stage ${one ? 'it' : 'them'}, and commit again.`,
+        ].join('\n'));
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG7D,OAAO,EAAgB,IAAI,EAAE,MAAM,WAAW,CAAC;AAE/C,8EAA8E;AAC9E,+EAA+E;AAC/E,kEAAkE;AAClE,MAAM,OAAO,MAAO,SAAQ,IAAY;IAC7B,IAAI,GAAG,QAAQ,CAAC;IAEzB,KAAK,CAAC,GAAG,CAAC,MAAc;QACtB,MAAM,WAAW,GAAwC,EAAE,CAAC;QAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;QACxD,KAAK,MAAM,IAAI,IAAI,MAAM,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrC,yEAAyE;YACzE,mDAAmD;YACnD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;YACnE,IAAI,cAAc,KAAK,IAAI;gBAAE,SAAS;YACtC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvC,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtE,IAAI,CAAC,SAAS;oBAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,MAAM,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChD,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAC1B,OAAO,IAAI,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,IAAI,CACd;YACE,GAAG;gBACD,CAAC,CAAC,iCAAiC;gBACnC,CAAC,CAAC,GAAG,WAAW,CAAC,MAAM,kCAAkC;YAC3D,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CACtC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,KAAK,MAAM,GAAG,CAC7D;YACD,8BAA8B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,qBAAqB;SACnG,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { Build } from './build.ts';
+export { Codegen } from './codegen.ts';
+export { Commit } from './commit.ts';
+export { Format } from './format.ts';
+export { Push } from './push.ts';
+export type { RefUpdate } from './ref-update.ts';
+export { preCommit } from './scripts/pre-commit.ts';
+export { prePush } from './scripts/pre-push.ts';
+export { type Outcome, Step } from './step.ts';
+export { Sync } from './sync.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,KAAK,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export { Build } from "./build.js";
+export { Codegen } from "./codegen.js";
+export { Commit } from "./commit.js";
+export { Format } from "./format.js";
+export { Push } from "./push.js";
+export { preCommit } from "./scripts/pre-commit.js";
+export { prePush } from "./scripts/pre-push.js";
+export { Step } from "./step.js";
+export { Sync } from "./sync.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":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAgB,IAAI,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/push.d.ts

@@ -0,0 +1,29 @@
+import { type RefUpdate } from './ref-update.ts';
+export declare class MissingLockfileError extends Error {
+    readonly sha: string;
+    constructor(sha: string);
+}
+interface PushOptions {
+    readonly root: string;
+    readonly environment: NodeJS.ProcessEnv;
+    readonly remote: {
+        readonly name: string;
+        readonly url: string;
+    };
+    readonly input: string;
+    readonly notice: (message: string) => void;
+}
+export declare class Push {
+    #private;
+    readonly remote: {
+        readonly name: string;
+        readonly url: string;
+    };
+    readonly updates: readonly RefUpdate[];
+    private constructor();
+    static read(options: PushOptions): Promise<Push>;
+    inSnapshot<T>(sha: string, work: (folder: string, environment: NodeJS.ProcessEnv) => Promise<T>): Promise<T>;
+    nx(sha: string, ...args: string[]): Promise<string>;
+}
+export {};
+//# sourceMappingURL=push.d.ts.map

package/dist/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../src/push.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AASjE,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,GAAG,EAAE,MAAM;CAKxB;AAED,UAAU,WAAW;IAEnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC;IAExC,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAEjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAKD,qBAAa,IAAI;;IACf,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAC;IAKvC,OAAO;WAWM,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAchD,UAAU,CAAC,CAAC,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GACnE,OAAO,CAAC,CAAC,CAAC;IA6Db,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAcpD"}

package/dist/push.js

@@ -0,0 +1,108 @@
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { mkdir, mkdtempDisposable, realpath } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { setTimeout as delay } from 'node:timers/promises';
+import { promisify } from 'node:util';
+import { FileLock } from '@zukhruf/fs';
+import { readRefUpdates } from "./ref-update.js";
+import { writeCommitFiles } from "./snapshot/commit-files.js";
+import { hasInstallDrift } from "./snapshot/drift.js";
+import { installFor } from "./snapshot/installs.js";
+import { runNx } from "./snapshot/nx.js";
+import { linkPackages } from "./snapshot/packages.js";
+const execFileAsync = promisify(execFile);
+export class MissingLockfileError extends Error {
+    sha;
+    constructor(sha) {
+        super(`${sha.slice(0, 7)} has no package-lock.json`);
+        this.name = 'MissingLockfileError';
+        this.sha = sha;
+    }
+}
+// What `git push` is about to send: the remote and the ref updates. A step
+// judges the pushed commits in snapshots, never the working tree, because
+// other sessions can edit the working tree while the hook runs.
+export class Push {
+    remote;
+    updates;
+    #root;
+    #environment;
+    #notice;
+    constructor({ root, environment, remote, notice }, updates) {
+        this.remote = remote;
+        this.updates = updates;
+        this.#root = root;
+        this.#environment = environment;
+        this.#notice = notice;
+    }
+    static async read(options) {
+        const git = (...args) => gitIn(options.root, options.environment, ...args);
+        return new Push(options, await readRefUpdates(git, options.remote.name, options.input));
+    }
+    // Runs `work` on the snapshot of one commit: its files in a temporary
+    // folder, with a node_modules that a build can use. `environment` makes git
+    // see a clean checkout of the commit there, and holds the nx cache of the
+    // state folder. One snapshot is open at a time in a repo; the snapshot is
+    // deleted after `work`.
+    async inSnapshot(sha, work) {
+        const state = join((await this.#git('rev-parse', '--path-format=absolute', '--git-common-dir')).trim(), 'git-hooks');
+        await mkdir(state, { recursive: true });
+        using lock = FileLock.open(join(state, 'lock'));
+        if (!lock.tryLock()) {
+            this.#notice('waiting for another pre-push build in this repo');
+            while (!lock.tryLock())
+                await delay(200);
+        }
+        await using temporary = await mkdtempDisposable(join(tmpdir(), 'git-hooks-push-'));
+        const top = await realpath(temporary.path);
+        const folder = join(top, 'tree');
+        await writeCommitFiles((...args) => this.#git(...args), { cwd: this.#root, env: this.#environment }, sha, folder);
+        if (!existsSync(join(folder, 'package-lock.json')))
+            throw new MissingLockfileError(sha);
+        const installed = (await hasInstallDrift(join(folder, 'package-lock.json'), join(this.#root, 'node_modules/.package-lock.json')))
+            ? await installFor(state, folder, this.#environment, () => this.#notice(`${sha.slice(0, 7)}: the installed packages differ from package-lock.json; installing it with npm ci (first time for this lockfile)`))
+            : this.#root;
+        await linkPackages(installed, folder);
+        const cache = join(state, 'nx');
+        const environment = {
+            ...this.#environment,
+            GIT_DIR: (await this.#git('rev-parse', '--absolute-git-dir')).trim(),
+            GIT_WORK_TREE: folder,
+            GIT_INDEX_FILE: join(top, 'index'),
+            NX_DAEMON: 'false',
+            NX_CACHE_DIRECTORY: cache,
+            NX_WORKSPACE_DATA_DIRECTORY: join(cache, 'workspace-data'),
+        };
+        // A temporary index of the commit, refreshed against the snapshot, so git
+        // finds no changed and no untracked files.
+        await gitIn(folder, environment, 'read-tree', sha);
+        await gitIn(folder, environment, 'update-index', '-q', '--refresh');
+        // Awaited here, so the snapshot and the lock stay until `work` ends.
+        return await work(folder, environment);
+    }
+    // Runs nx in the snapshot of one commit, and gives its standard output.
+    // When nx exits with a code other than 0, it throws.
+    nx(sha, ...args) {
+        return this.inSnapshot(sha, async (folder, environment) => {
+            const { code, stdout, stderr } = await runNx(folder, environment, args);
+            if (code !== 0)
+                throw new Error(`nx ${args.join(' ')} exited with ${code}:\n${`${stdout}${stderr}`.trimEnd()}`);
+            return stdout;
+        });
+    }
+    #git(...args) {
+        return gitIn(this.#root, this.#environment, ...args);
+    }
+}
+async function gitIn(cwd, environment, ...args) {
+    const { stdout } = await execFileAsync('git', args, {
+        cwd,
+        env: environment,
+        encoding: 'utf8',
+        maxBuffer: 2 ** 30,
+    });
+    return stdout;
+}
+//# sourceMappingURL=push.js.map

package/dist/push.js.map

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

package/dist/ref-update.d.ts

@@ -0,0 +1,17 @@
+interface RefLine {
+    readonly localRef: string;
+    readonly localSha: string;
+    readonly remoteRef: string;
+    readonly remoteSha: string;
+}
+export type RefUpdate = (RefLine & {
+    readonly kind: 'create' | 'update';
+    readonly head: string;
+    readonly base: string | undefined;
+}) | (RefLine & {
+    readonly kind: 'delete';
+});
+type Git = (...args: string[]) => Promise<string>;
+export declare function readRefUpdates(git: Git, remote: string, input: string): Promise<RefUpdate[]>;
+export {};
+//# sourceMappingURL=ref-update.d.ts.map

package/dist/ref-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-update.d.ts","sourceRoot":"","sources":["../src/ref-update.ts"],"names":[],"mappings":"AAEA,UAAU,OAAO;IACf,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAKD,MAAM,MAAM,SAAS,GACjB,CAAC,OAAO,GAAG;IACT,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC,GACF,CAAC,OAAO,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAE5C,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAIlD,wBAAsB,cAAc,CAClC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,SAAS,EAAE,CAAC,CAoBtB"}

package/dist/ref-update.js

@@ -0,0 +1,43 @@
+const absent = /^0+$/;
+export async function readRefUpdates(git, remote, input) {
+    const updates = [];
+    for (const line of input.split('\n')) {
+        if (line.trim() === '')
+            continue;
+        const [localRef = '', localSha = '', remoteRef = '', remoteSha = ''] = line
+            .trim()
+            .split(' ');
+        const refLine = { localRef, localSha, remoteRef, remoteSha };
+        if (absent.test(localSha)) {
+            updates.push({ ...refLine, kind: 'delete' });
+            continue;
+        }
+        const kind = absent.test(remoteSha) ? 'create' : 'update';
+        const base = kind === 'update' && (await isLocal(git, remoteSha))
+            ? remoteSha
+            : await firstUnseenParent(git, remote, localSha);
+        updates.push({ ...refLine, kind, head: localSha, base });
+    }
+    return updates;
+}
+async function isLocal(git, sha) {
+    try {
+        await git('cat-file', '-e', `${sha}^{commit}`);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// The parent of the first commit that no ref of the remote has, as the
+// pre-commit framework finds the "from" ref of its pre-push stage.
+async function firstUnseenParent(git, remote, head) {
+    const unseen = await git('rev-list', head, '--topo-order', '--reverse', '--not', `--remotes=${remote}`);
+    const [first = ''] = unseen.split('\n', 1);
+    if (first === '')
+        return head;
+    const parents = await git('rev-list', '--parents', '--max-count=1', first);
+    const [, parent] = parents.trim().split(' ');
+    return parent;
+}
+//# sourceMappingURL=ref-update.js.map

package/dist/ref-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-update.js","sourceRoot":"","sources":["../src/ref-update.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,GAAG,MAAM,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAQ,EACR,MAAc,EACd,KAAa;IAEb,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACjC,MAAM,CAAC,QAAQ,GAAG,EAAE,EAAE,QAAQ,GAAG,EAAE,EAAE,SAAS,GAAG,EAAE,EAAE,SAAS,GAAG,EAAE,CAAC,GAAG,IAAI;aACxE,IAAI,EAAE;aACN,KAAK,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,OAAO,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAC7D,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7C,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1D,MAAM,IAAI,GACR,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAClD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,MAAM,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,GAAQ,EAAE,GAAW;IAC1C,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,GAAG,WAAW,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,mEAAmE;AACnE,KAAK,UAAU,iBAAiB,CAC9B,GAAQ,EACR,MAAc,EACd,IAAY;IAEZ,MAAM,MAAM,GAAG,MAAM,GAAG,CACtB,UAAU,EACV,IAAI,EACJ,cAAc,EACd,WAAW,EACX,OAAO,EACP,aAAa,MAAM,EAAE,CACtB,CAAC;IACF,MAAM,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/scripts/pre-commit.d.ts

@@ -0,0 +1,4 @@
+import { Commit } from '../commit.ts';
+import type { Step } from '../step.ts';
+export declare function preCommit(steps: readonly Step<Commit>[]): Promise<void>;
+//# sourceMappingURL=pre-commit.d.ts.map

package/dist/scripts/pre-commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-commit.d.ts","sourceRoot":"","sources":["../../src/scripts/pre-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAKvC,wBAAsB,SAAS,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAa7E"}

package/dist/scripts/pre-commit.js

@@ -0,0 +1,20 @@
+import { Commit } from "../commit.js";
+// What a repo's `.husky/pre-commit.ts` calls. Git runs the hook at the root of
+// the work tree, so the current folder is the repo. This is the one module
+// that prints and reads the environment, as a script may.
+export async function preCommit(steps) {
+    const commit = new Commit(process.cwd(), process.env);
+    for (const step of steps) {
+        const outcome = await step.run(commit);
+        const [first = '', ...rest] = outcome.message.split('\n');
+        console.error(`${step.name.padEnd(9)} ${first}`);
+        for (const line of rest)
+            console.error(`${' '.repeat(10)}${line}`);
+        if (outcome.kind === 'fail') {
+            console.error('✖ commit stopped by the pre-commit hook');
+            process.exitCode = 1;
+            return;
+        }
+    }
+}
+//# sourceMappingURL=pre-commit.js.map

package/dist/scripts/pre-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-commit.js","sourceRoot":"","sources":["../../src/scripts/pre-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,+EAA+E;AAC/E,2EAA2E;AAC3E,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAA8B;IAC5D,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;QACjD,KAAK,MAAM,IAAI,IAAI,IAAI;YAAE,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;QACnE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;YACzD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/scripts/pre-push.d.ts

@@ -0,0 +1,4 @@
+import { Push } from '../push.ts';
+import type { Step } from '../step.ts';
+export declare function prePush(steps: readonly Step<Push>[]): Promise<void>;
+//# sourceMappingURL=pre-push.d.ts.map

package/dist/scripts/pre-push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-push.d.ts","sourceRoot":"","sources":["../../src/scripts/pre-push.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAOvC,wBAAsB,OAAO,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBzE"}

package/dist/scripts/pre-push.js

@@ -0,0 +1,35 @@
+import { text } from 'node:stream/consumers';
+import { Push } from "../push.js";
+// What a repo's `.husky/pre-push.ts` calls. Git runs the hook at the root of
+// the work tree, with the name and the URL of the remote as arguments and one
+// ref update on each line of the standard input. This is the one module that
+// prints and reads the arguments, the input and the environment, as a script
+// may.
+export async function prePush(steps) {
+    let current = '';
+    const print = (name, message) => {
+        const [first = '', ...rest] = message.split('\n');
+        console.error(`${name.padEnd(9)} ${first}`);
+        for (const line of rest)
+            console.error(`${' '.repeat(10)}${line}`);
+    };
+    const [name = '', url = ''] = process.argv.slice(2);
+    const push = await Push.read({
+        root: process.cwd(),
+        environment: process.env,
+        remote: { name, url },
+        input: await text(process.stdin),
+        notice: (message) => print(current, message),
+    });
+    for (const step of steps) {
+        current = step.name;
+        const outcome = await step.run(push);
+        print(step.name, outcome.message);
+        if (outcome.kind === 'fail') {
+            console.error('✖ push stopped by the pre-push hook');
+            process.exitCode = 1;
+            return;
+        }
+    }
+}
+//# sourceMappingURL=pre-push.js.map

package/dist/scripts/pre-push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-push.js","sourceRoot":"","sources":["../../src/scripts/pre-push.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAGlC,6EAA6E;AAC7E,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,OAAO;AACP,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAA4B;IACxD,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,OAAe,EAAE,EAAE;QAC9C,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,IAAI;YAAE,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;IACF,MAAM,CAAC,IAAI,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;QAC3B,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE;QACnB,WAAW,EAAE,OAAO,CAAC,GAAG;QACxB,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE;QACrB,KAAK,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAChC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC;KAC7C,CAAC,CAAC;IACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACrD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/snapshot/commit-files.d.ts

@@ -0,0 +1,5 @@
+export declare function writeCommitFiles(git: (...args: string[]) => Promise<string>, gitOptions: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}, sha: string, folder: string): Promise<void>;
+//# sourceMappingURL=commit-files.d.ts.map

package/dist/snapshot/commit-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit-files.d.ts","sourceRoot":"","sources":["../../src/snapshot/commit-files.ts"],"names":[],"mappings":"AAgBA,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,EAC3C,UAAU,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;CAAE,EACnD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAqDf"}

package/dist/snapshot/commit-files.js

@@ -0,0 +1,101 @@
+import { spawn } from 'node:child_process';
+import { once } from 'node:events';
+import { chmod, mkdir, stat, symlink, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+// Writes the files of one commit into an empty folder, from the object store:
+// `git ls-tree` names them and one `git cat-file --batch` gives their content.
+// No filter applies (no autocrlf, no smudge, no LFS), and `export-ignore` does
+// not apply. A submodule is not a file, so it is not written.
+export async function writeCommitFiles(git, gitOptions, sha, folder) {
+    const blobs = (await git('ls-tree', '-r', '-z', '--full-tree', sha))
+        .split('\0')
+        .filter((line) => line !== '')
+        .map((line) => {
+        const tab = line.indexOf('\t');
+        const [mode = '', type = '', object = ''] = line.slice(0, tab).split(' ');
+        return { mode, type, object, path: line.slice(tab + 1) };
+    })
+        .filter(({ type }) => type === 'blob');
+    const catFile = spawn('git', ['cat-file', '--batch'], {
+        ...gitOptions,
+        stdio: ['pipe', 'pipe', 'inherit'],
+    });
+    const exited = once(catFile, 'close');
+    catFile.stdin.end(blobs.map(({ object }) => `${object}\n`).join(''));
+    const records = new Records(catFile.stdout);
+    const links = [];
+    for (const blob of blobs) {
+        const header = (await records.line()).split(' ');
+        const size = Number(header[2]);
+        if (header[1] !== 'blob' || !Number.isInteger(size))
+            throw new Error(`git cat-file gave "${header.join(' ')}" for ${blob.path}`);
+        const content = await records.bytes(size + 1);
+        const path = join(folder, blob.path);
+        await mkdir(dirname(path), { recursive: true });
+        if (blob.mode === '120000')
+            links.push({ blob, target: content.subarray(0, size).toString() });
+        else {
+            await writeFile(path, content.subarray(0, size));
+            if (blob.mode === '100755')
+                await chmod(path, 0o755);
+        }
+    }
+    await exited;
+    // The files come first: on Windows, a link becomes a junction when its
+    // target is a folder of the commit, or else a text file that holds the
+    // target, as git does with core.symlinks=false.
+    for (const { blob, target } of links) {
+        const path = join(folder, blob.path);
+        if (process.platform !== 'win32')
+            await symlink(target, path);
+        else {
+            const absolute = resolve(dirname(path), target);
+            const isFolder = await stat(absolute).then((stats) => stats.isDirectory(), () => false);
+            if (isFolder)
+                await symlink(absolute, path, 'junction');
+            else
+                await writeFile(path, target);
+        }
+    }
+}
+// Reads the records of `git cat-file --batch`: a header line, then the
+// content and a newline.
+class Records {
+    #chunks;
+    #buffer = Buffer.alloc(0);
+    constructor(stream) {
+        this.#chunks = stream[Symbol.asyncIterator]();
+    }
+    async line() {
+        let end = this.#buffer.indexOf(0x0a);
+        while (end === -1) {
+            this.#buffer = Buffer.concat([this.#buffer, await this.#next()]);
+            end = this.#buffer.indexOf(0x0a);
+        }
+        const line = this.#buffer.subarray(0, end).toString();
+        this.#buffer = this.#buffer.subarray(end + 1);
+        return line;
+    }
+    async bytes(count) {
+        if (this.#buffer.length < count) {
+            const parts = [this.#buffer];
+            let length = this.#buffer.length;
+            while (length < count) {
+                const chunk = await this.#next();
+                parts.push(chunk);
+                length += chunk.length;
+            }
+            this.#buffer = Buffer.concat(parts, length);
+        }
+        const bytes = this.#buffer.subarray(0, count);
+        this.#buffer = this.#buffer.subarray(count);
+        return bytes;
+    }
+    async #next() {
+        const { done, value } = await this.#chunks.next();
+        if (done === true)
+            throw new Error('git cat-file ended before it gave each file');
+        return Buffer.isBuffer(value) ? value : Buffer.from(String(value));
+    }
+}
+//# sourceMappingURL=commit-files.js.map