skuba 3.16.1 → 3.17.0-beta.3

package/jest-preset.js

@@ -1,28 +1,14 @@
-const { defaults: tsJestDefaults } = require('ts-jest/presets');
+const { defaults } = require('ts-jest/presets');
 
-const TS_JEST_NAME = 'ts-jest';
-
-/**
- * Resolved path of the `ts-jest` preset.
- *
- * This allows Jest to resolve the preset even if it is installed to a nested
- * `./node_modules/skuba/node_modules/ts-jest` directory.
- */
-const TS_JEST_PATH = require.resolve(TS_JEST_NAME);
-
-// Rewrite `ts-jest` transformations using our resolved `TS_JEST_PATH`.
-const tsJestTransform = Object.fromEntries(
-  Object.entries(tsJestDefaults.transform).map(([key, value]) => [
-    key,
-    value === TS_JEST_NAME ? TS_JEST_PATH : value,
-  ]),
-);
+const { createModuleNameMapper } = require('./jest/moduleNameMapper');
+const { transform } = require('./jest/transform');
 
 /** @type {import('@jest/types').Config.InitialOptions} */
 module.exports = {
-  ...tsJestDefaults,
+  ...defaults,
 
-  transform: tsJestTransform,
+  moduleNameMapper: createModuleNameMapper(),
+  transform,
 
   collectCoverageFrom: [
     '**/*.ts',
@@ -35,13 +21,10 @@ module.exports = {
     '!<rootDir>/jest.*.ts',
   ],
   coverageDirectory: 'coverage',
-  moduleNameMapper: {
-    '^src$': '<rootDir>/src',
-    '^src/(.+)$': '<rootDir>/src/$1',
-  },
   testEnvironment: 'node',
   testPathIgnorePatterns: [
     '/node_modules.*/',
     '<rootDir>/(coverage|dist|lib|tmp).*/',
   ],
+  reporters: ['default', require.resolve('./lib/cli/test/reporters/github')],
 };

package/lib/api/git/commit.d.ts

@@ -0,0 +1,15 @@
+export interface Identity {
+    email?: string;
+    name?: string;
+}
+interface CommitParameters {
+    author?: Identity;
+    committer?: Identity;
+    dir: string;
+    message: string;
+}
+/**
+ * Writes a commit to the local Git repository.
+ */
+export declare const commit: ({ author, committer, dir, message, }: CommitParameters) => Promise<string>;
+export {};

package/lib/api/git/commit.js

@@ -0,0 +1,31 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commit = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const isomorphic_git_1 = __importDefault(require("isomorphic-git"));
+/**
+ * Writes a commit to the local Git repository.
+ */
+const commit = ({ author = { name: 'skuba' }, committer = { name: 'skuba' }, dir, message, }) => __awaiter(void 0, void 0, void 0, function* () {
+    return isomorphic_git_1.default.commit({
+        author,
+        committer,
+        dir,
+        fs: fs_extra_1.default,
+        message,
+    });
+});
+exports.commit = commit;
+//# sourceMappingURL=commit.js.map

package/lib/api/git/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../../src/api/git/commit.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,wDAA0B;AAC1B,oEAAiC;AAcjC;;GAEG;AACI,MAAM,MAAM,GAAG,CAAO,EAC3B,MAAM,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAC1B,SAAS,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAC7B,GAAG,EACH,OAAO,GACU,EAAmB,EAAE;IACtC,OAAA,wBAAG,CAAC,MAAM,CAAC;QACT,MAAM;QACN,SAAS;QACT,GAAG;QACH,EAAE,EAAF,kBAAE;QACF,OAAO;KACR,CAAC,CAAA;EAAA,CAAC;AAZQ,QAAA,MAAM,UAYd"}

package/lib/api/git/commitAllChanges.d.ts

@@ -0,0 +1,12 @@
+import type { Identity } from './commit';
+interface CommitAllParameters {
+    dir: string;
+    message: string;
+    author?: Identity;
+    committer?: Identity;
+}
+/**
+ * Stages all changes and writes a commit to the local Git repository.
+ */
+export declare const commitAllChanges: ({ dir, message, author, committer, }: CommitAllParameters) => Promise<void>;
+export {};

package/lib/api/git/commitAllChanges.js

@@ -0,0 +1,36 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commitAllChanges = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const isomorphic_git_1 = __importDefault(require("isomorphic-git"));
+const commit_1 = require("./commit");
+const getChangedFiles_1 = require("./getChangedFiles");
+/**
+ * Stages all changes and writes a commit to the local Git repository.
+ */
+const commitAllChanges = ({ dir, message, author, committer, }) => __awaiter(void 0, void 0, void 0, function* () {
+    const changedFiles = yield (0, getChangedFiles_1.getChangedFiles)({ dir });
+    yield Promise.all(changedFiles.map((file) => file.state === 'deleted'
+        ? isomorphic_git_1.default.remove({ fs: fs_extra_1.default, dir, filepath: file.path })
+        : isomorphic_git_1.default.add({ fs: fs_extra_1.default, dir, filepath: file.path })));
+    yield (0, commit_1.commit)({
+        dir,
+        message,
+        author,
+        committer,
+    });
+});
+exports.commitAllChanges = commitAllChanges;
+//# sourceMappingURL=commitAllChanges.js.map

package/lib/api/git/commitAllChanges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commitAllChanges.js","sourceRoot":"","sources":["../../../src/api/git/commitAllChanges.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,wDAA0B;AAC1B,oEAAiC;AAEjC,qCAAkC;AAElC,uDAAoD;AASpD;;GAEG;AACI,MAAM,gBAAgB,GAAG,CAAO,EACrC,GAAG,EACH,OAAO,EACP,MAAM,EACN,SAAS,GACW,EAAiB,EAAE;IACvC,MAAM,YAAY,GAAG,MAAM,IAAA,iCAAe,EAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACpD,MAAM,OAAO,CAAC,GAAG,CACf,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACxB,IAAI,CAAC,KAAK,KAAK,SAAS;QACtB,CAAC,CAAC,wBAAG,CAAC,MAAM,CAAC,EAAE,EAAE,EAAF,kBAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9C,CAAC,CAAC,wBAAG,CAAC,GAAG,CAAC,EAAE,EAAE,EAAF,kBAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAC9C,CACF,CAAC;IAEF,MAAM,IAAA,eAAM,EAAC;QACX,GAAG;QACH,OAAO;QACP,MAAM;QACN,SAAS;KACV,CAAC,CAAC;AACL,CAAC,CAAA,CAAC;AArBW,QAAA,gBAAgB,oBAqB3B"}

package/lib/api/git/getChangedFiles.d.ts

@@ -0,0 +1,14 @@
+declare type ChangedFileState = 'added' | 'modified' | 'deleted';
+export interface ChangedFile {
+    path: string;
+    state: ChangedFileState;
+}
+interface ChangedFilesParameters {
+    dir: string;
+}
+/**
+ * Returns all the files which have been added, modified or deleted in the
+ * working directory of the local Git repository since the last commit.
+ */
+export declare const getChangedFiles: ({ dir, }: ChangedFilesParameters) => Promise<ChangedFile[]>;
+export {};

package/lib/api/git/getChangedFiles.js

@@ -0,0 +1,41 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChangedFiles = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const isomorphic_git_1 = __importDefault(require("isomorphic-git"));
+const statusMatrix_1 = require("./statusMatrix");
+const mapState = (row) => {
+    if (row[statusMatrix_1.HEAD] === statusMatrix_1.ABSENT) {
+        return 'added';
+    }
+    if (row[statusMatrix_1.WORKDIR] === statusMatrix_1.MODIFIED) {
+        return 'modified';
+    }
+    return 'deleted';
+};
+/**
+ * Returns all the files which have been added, modified or deleted in the
+ * working directory of the local Git repository since the last commit.
+ */
+const getChangedFiles = ({ dir, }) => __awaiter(void 0, void 0, void 0, function* () {
+    const allFiles = yield isomorphic_git_1.default.statusMatrix({ fs: fs_extra_1.default, dir });
+    return allFiles
+        .filter((row) => row[statusMatrix_1.HEAD] !== statusMatrix_1.UNMODIFIED ||
+        row[statusMatrix_1.WORKDIR] !== statusMatrix_1.UNMODIFIED ||
+        row[statusMatrix_1.STAGE] !== statusMatrix_1.UNMODIFIED)
+        .map((row) => ({ path: row[statusMatrix_1.FILEPATH], state: mapState(row) }));
+});
+exports.getChangedFiles = getChangedFiles;
+//# sourceMappingURL=getChangedFiles.js.map

package/lib/api/git/getChangedFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getChangedFiles.js","sourceRoot":"","sources":["../../../src/api/git/getChangedFiles.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,wDAA0B;AAC1B,oEAAiC;AAEjC,iDAQwB;AAWxB,MAAM,QAAQ,GAAG,CACf,GAA8C,EAC5B,EAAE;IACpB,IAAI,GAAG,CAAC,mBAAI,CAAC,KAAK,qBAAM,EAAE;QACxB,OAAO,OAAO,CAAC;KAChB;IAED,IAAI,GAAG,CAAC,sBAAO,CAAC,KAAK,uBAAQ,EAAE;QAC7B,OAAO,UAAU,CAAC;KACnB;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;GAGG;AACI,MAAM,eAAe,GAAG,CAAO,EACpC,GAAG,GACoB,EAA0B,EAAE;IACnD,MAAM,QAAQ,GAAG,MAAM,wBAAG,CAAC,YAAY,CAAC,EAAE,EAAE,EAAF,kBAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACrD,OAAO,QAAQ;SACZ,MAAM,CACL,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,CAAC,mBAAI,CAAC,KAAK,yBAAU;QACxB,GAAG,CAAC,sBAAO,CAAC,KAAK,yBAAU;QAC3B,GAAG,CAAC,oBAAK,CAAC,KAAK,yBAAU,CAC5B;SACA,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,uBAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACnE,CAAC,CAAA,CAAC;AAZW,QAAA,eAAe,mBAY1B"}

package/lib/api/git/index.d.ts

@@ -0,0 +1,7 @@
+export { commit } from './commit';
+export { commitAllChanges } from './commitAllChanges';
+export { getChangedFiles } from './getChangedFiles';
+export { getHeadCommitId } from './log';
+export { getOwnerAndRepo } from './remote';
+export { push } from './push';
+export { reset } from './reset';

package/lib/api/git/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reset = exports.push = exports.getOwnerAndRepo = exports.getHeadCommitId = exports.getChangedFiles = exports.commitAllChanges = exports.commit = void 0;
+var commit_1 = require("./commit");
+Object.defineProperty(exports, "commit", { enumerable: true, get: function () { return commit_1.commit; } });
+var commitAllChanges_1 = require("./commitAllChanges");
+Object.defineProperty(exports, "commitAllChanges", { enumerable: true, get: function () { return commitAllChanges_1.commitAllChanges; } });
+var getChangedFiles_1 = require("./getChangedFiles");
+Object.defineProperty(exports, "getChangedFiles", { enumerable: true, get: function () { return getChangedFiles_1.getChangedFiles; } });
+var log_1 = require("./log");
+Object.defineProperty(exports, "getHeadCommitId", { enumerable: true, get: function () { return log_1.getHeadCommitId; } });
+var remote_1 = require("./remote");
+Object.defineProperty(exports, "getOwnerAndRepo", { enumerable: true, get: function () { return remote_1.getOwnerAndRepo; } });
+var push_1 = require("./push");
+Object.defineProperty(exports, "push", { enumerable: true, get: function () { return push_1.push; } });
+var reset_1 = require("./reset");
+Object.defineProperty(exports, "reset", { enumerable: true, get: function () { return reset_1.reset; } });
+//# sourceMappingURL=index.js.map

package/lib/api/git/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/api/git/index.ts"],"names":[],"mappings":";;;AAAA,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,6BAAwC;AAA/B,sGAAA,eAAe,OAAA;AACxB,mCAA2C;AAAlC,yGAAA,eAAe,OAAA;AACxB,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,iCAAgC;AAAvB,8FAAA,KAAK,OAAA"}

package/lib/api/git/log.d.ts

@@ -0,0 +1,12 @@
+interface GetHeadCommitIdParameters {
+    dir: string;
+    env?: Record<string, string | undefined>;
+}
+/**
+ * Gets the object ID of the head commit.
+ *
+ * This tries to extract the commit ID from common CI environment variables,
+ * and falls back to the local Git repository log.
+ */
+export declare const getHeadCommitId: ({ dir, env, }: GetHeadCommitIdParameters) => Promise<string>;
+export {};

package/lib/api/git/log.js

@@ -0,0 +1,37 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHeadCommitId = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const isomorphic_git_1 = __importDefault(require("isomorphic-git"));
+/**
+ * Gets the object ID of the head commit.
+ *
+ * This tries to extract the commit ID from common CI environment variables,
+ * and falls back to the local Git repository log.
+ */
+const getHeadCommitId = ({ dir, env = process.env, }) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const oidFromEnv = (_a = env.BUILDKITE_COMMIT) !== null && _a !== void 0 ? _a : env.GITHUB_SHA;
+    if (oidFromEnv) {
+        return oidFromEnv;
+    }
+    const [headCommit] = yield isomorphic_git_1.default.log({ depth: 1, dir, fs: fs_extra_1.default });
+    if (!headCommit) {
+        throw new Error('Git log does not contain any commits');
+    }
+    return headCommit.oid;
+});
+exports.getHeadCommitId = getHeadCommitId;
+//# sourceMappingURL=log.js.map

package/lib/api/git/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../../src/api/git/log.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,wDAA0B;AAC1B,oEAAiC;AAOjC;;;;;GAKG;AACI,MAAM,eAAe,GAAG,CAAO,EACpC,GAAG,EACH,GAAG,GAAG,OAAO,CAAC,GAAG,GACS,EAAmB,EAAE;;IAC/C,MAAM,UAAU,GAAG,MAAA,GAAG,CAAC,gBAAgB,mCAAI,GAAG,CAAC,UAAU,CAAC;IAE1D,IAAI,UAAU,EAAE;QACd,OAAO,UAAU,CAAC;KACnB;IAED,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,wBAAG,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAF,kBAAE,EAAE,CAAC,CAAC;IAE1D,IAAI,CAAC,UAAU,EAAE;QACf,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;KACzD;IAED,OAAO,UAAU,CAAC,GAAG,CAAC;AACxB,CAAC,CAAA,CAAC;AAjBW,QAAA,eAAe,mBAiB1B"}

package/lib/api/git/push.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Use a GitHub app token to auth the Git push.
+ *
+ * This defaults to the `GITHUB_API_TOKEN` and `GITHUB_TOKEN` environment
+ * variables if `token` is not provided.
+ */
+interface GitHubAppAuth {
+    type: 'gitHubApp';
+    token?: string;
+}
+interface PushParameters {
+    /**
+     * The auth mechanism for the push.
+     *
+     * Currently, only GitHub app tokens are supported.
+     */
+    auth: GitHubAppAuth;
+    dir: string;
+    /**
+     * The reference to push to the remote.
+     *
+     * This may be a commit, branch or tag in the local repository.
+     */
+    ref: string;
+    remote?: string;
+    /**
+     * The destination branch or tag on the remote.
+     *
+     * This defaults to `ref`.
+     */
+    remoteRef?: string;
+    /**
+     * Forcefully override any conflicts.
+     *
+     * This defaults to `false`.
+     */
+    force?: boolean;
+}
+/**
+ * Pushes the specified `ref` from the local Git repository to a remote.
+ */
+export declare const push: ({ auth, dir, ref, remote, remoteRef, force, }: PushParameters) => Promise<import("isomorphic-git").PushResult>;
+export {};

package/lib/api/git/push.js

@@ -0,0 +1,46 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.push = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const isomorphic_git_1 = __importDefault(require("isomorphic-git"));
+const node_1 = __importDefault(require("isomorphic-git/http/node"));
+const environment_1 = require("../github/environment");
+const remote_1 = require("./remote");
+/**
+ * Pushes the specified `ref` from the local Git repository to a remote.
+ */
+const push = ({ auth, dir, ref, remote, remoteRef, force, }) => __awaiter(void 0, void 0, void 0, function* () {
+    const { owner, repo } = yield (0, remote_1.getOwnerAndRepo)({ dir });
+    const url = `https://github.com/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`;
+    return isomorphic_git_1.default.push({
+        onAuth: () => {
+            var _a;
+            return ({
+                username: 'x-access-token',
+                password: (_a = auth.token) !== null && _a !== void 0 ? _a : (0, environment_1.apiTokenFromEnvironment)(),
+            });
+        },
+        dir,
+        fs: fs_extra_1.default,
+        http: node_1.default,
+        ref,
+        remote,
+        remoteRef,
+        url,
+        force,
+    });
+});
+exports.push = push;
+//# sourceMappingURL=push.js.map

package/lib/api/git/push.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.js","sourceRoot":"","sources":["../../../src/api/git/push.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,wDAA0B;AAC1B,oEAAiC;AACjC,oEAA4C;AAE5C,uDAAgE;AAEhE,qCAA2C;AA+C3C;;GAEG;AACI,MAAM,IAAI,GAAG,CAAO,EACzB,IAAI,EACJ,GAAG,EACH,GAAG,EACH,MAAM,EACN,SAAS,EACT,KAAK,GACU,EAAE,EAAE;IACnB,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,IAAA,wBAAe,EAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAEvD,MAAM,GAAG,GAAG,sBAAsB,kBAAkB,CAClD,KAAK,CACN,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;IAEhC,OAAO,wBAAG,CAAC,IAAI,CAAC;QACd,MAAM,EAAE,GAAG,EAAE;;YAAC,OAAA,CAAC;gBACb,QAAQ,EAAE,gBAAgB;gBAC1B,QAAQ,EAAE,MAAA,IAAI,CAAC,KAAK,mCAAI,IAAA,qCAAuB,GAAE;aAClD,CAAC,CAAA;SAAA;QACF,GAAG;QACH,EAAE,EAAF,kBAAE;QACF,IAAI,EAAJ,cAAI;QACJ,GAAG;QACH,MAAM;QACN,SAAS;QACT,GAAG;QACH,KAAK;KACN,CAAC,CAAC;AACL,CAAC,CAAA,CAAC;AA5BW,QAAA,IAAI,QA4Bf"}

package/lib/api/git/remote.d.ts

@@ -0,0 +1,18 @@
+interface GetOwnerAndRepoParameters {
+    dir: string;
+}
+/**
+ * Extracts the owner and repository names from local Git remotes.
+ *
+ * Currently, only GitHub repository URLs are supported:
+ *
+ * ```console
+ * git@github.com:seek-oss/skuba.git
+ * https://github.com/seek-oss/skuba.git
+ * ```
+ */
+export declare const getOwnerAndRepo: ({ dir, }: GetOwnerAndRepoParameters) => Promise<{
+    owner: string;
+    repo: string;
+}>;
+export {};

package/lib/api/git/remote.js

@@ -0,0 +1,57 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOwnerAndRepo = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const isomorphic_git_1 = __importDefault(require("isomorphic-git"));
+/**
+ * Matches the owner and repository names in a GitHub repository URL.
+ *
+ * For example, given the following input strings:
+ *
+ * ```console
+ * git@github.com:seek-oss/skuba.git
+ * https://github.com/seek-oss/skuba.git
+ * ```
+ *
+ * This pattern will produce the following matches:
+ *
+ * 1. seek-oss
+ * 2. skuba
+ */
+const ownerRepoRegex = /github.com(?::|\/)(.+)\/(.+).git$/;
+/**
+ * Extracts the owner and repository names from local Git remotes.
+ *
+ * Currently, only GitHub repository URLs are supported:
+ *
+ * ```console
+ * git@github.com:seek-oss/skuba.git
+ * https://github.com/seek-oss/skuba.git
+ * ```
+ */
+const getOwnerAndRepo = ({ dir, }) => __awaiter(void 0, void 0, void 0, function* () {
+    const remotes = yield isomorphic_git_1.default.listRemotes({ dir, fs: fs_extra_1.default });
+    for (const { url } of remotes) {
+        const match = ownerRepoRegex.exec(url);
+        const owner = match === null || match === void 0 ? void 0 : match[1];
+        const repo = match === null || match === void 0 ? void 0 : match[2];
+        if (owner && repo) {
+            return { owner, repo };
+        }
+    }
+    throw new Error('Could not find a GitHub remote');
+});
+exports.getOwnerAndRepo = getOwnerAndRepo;
+//# sourceMappingURL=remote.js.map

package/lib/api/git/remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote.js","sourceRoot":"","sources":["../../../src/api/git/remote.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,wDAA0B;AAC1B,oEAAiC;AAEjC;;;;;;;;;;;;;;GAcG;AACH,MAAM,cAAc,GAAG,mCAAmC,CAAC;AAM3D;;;;;;;;;GASG;AACI,MAAM,eAAe,GAAG,CAAO,EACpC,GAAG,GACuB,EAA4C,EAAE;IACxE,MAAM,OAAO,GAAG,MAAM,wBAAG,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,EAAE,EAAF,kBAAE,EAAE,CAAC,CAAC;IAEnD,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE;QAC7B,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEvC,MAAM,KAAK,GAAG,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAG,CAAC,CAAC,CAAC;QACzB,MAAM,IAAI,GAAG,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAG,CAAC,CAAC,CAAC;QAExB,IAAI,KAAK,IAAI,IAAI,EAAE;YACjB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SACxB;KACF;IAED,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;AACpD,CAAC,CAAA,CAAC;AAjBW,QAAA,eAAe,mBAiB1B"}

package/lib/api/git/reset.d.ts

@@ -0,0 +1,12 @@
+interface ResetParameters {
+    dir: string;
+    branch: string;
+    commitId: string;
+    hard?: boolean;
+}
+/**
+ * Resets the specified branch in the local Git repository to a particular
+ * commit.
+ */
+export declare const reset: ({ dir, branch, commitId, hard, }: ResetParameters) => Promise<void>;
+export {};

package/lib/api/git/reset.js

@@ -0,0 +1,39 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reset = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const isomorphic_git_1 = __importDefault(require("isomorphic-git"));
+const statusMatrix_1 = require("./statusMatrix");
+/**
+ * Resets the specified branch in the local Git repository to a particular
+ * commit.
+ */
+const reset = ({ dir, branch, commitId, hard, }) => __awaiter(void 0, void 0, void 0, function* () {
+    yield fs_extra_1.default.promises.writeFile(path_1.default.join(dir, '.git/refs/heads', branch), `${commitId}\n`);
+    if (hard) {
+        const allFiles = yield isomorphic_git_1.default.statusMatrix({ dir, fs: fs_extra_1.default });
+        // Get all files which have been modified or staged - does not include new untracked files or deleted files
+        const modifiedFiles = allFiles
+            .filter((row) => row[statusMatrix_1.WORKDIR] > statusMatrix_1.UNMODIFIED && row[statusMatrix_1.STAGE] > statusMatrix_1.UNMODIFIED)
+            .map((row) => row[statusMatrix_1.FILEPATH]);
+        // Delete modified/staged files
+        yield Promise.all(modifiedFiles.map((filePath) => fs_extra_1.default.promises.rm(filePath)));
+        // This will bring in the unmodified versions of files plus any files which were deleted
+        yield isomorphic_git_1.default.checkout({ dir, fs: fs_extra_1.default, ref: branch, force: true });
+    }
+});
+exports.reset = reset;
+//# sourceMappingURL=reset.js.map

package/lib/api/git/reset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.js","sourceRoot":"","sources":["../../../src/api/git/reset.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,gDAAwB;AAExB,wDAA0B;AAC1B,oEAAiC;AAEjC,iDAAsE;AAStE;;;GAGG;AACI,MAAM,KAAK,GAAG,CAAO,EAC1B,GAAG,EACH,MAAM,EACN,QAAQ,EACR,IAAI,GACY,EAAiB,EAAE;IACnC,MAAM,kBAAE,CAAC,QAAQ,CAAC,SAAS,CACzB,cAAI,CAAC,IAAI,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,CAAC,EACzC,GAAG,QAAQ,IAAI,CAChB,CAAC;IAEF,IAAI,IAAI,EAAE;QACR,MAAM,QAAQ,GAAG,MAAM,wBAAG,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,EAAE,EAAF,kBAAE,EAAE,CAAC,CAAC;QACrD,2GAA2G;QAC3G,MAAM,aAAa,GAAG,QAAQ;aAC3B,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,sBAAO,CAAC,GAAG,yBAAU,IAAI,GAAG,CAAC,oBAAK,CAAC,GAAG,yBAAU,CAAC;aACrE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,uBAAQ,CAAC,CAAC,CAAC;QAE/B,+BAA+B;QAC/B,MAAM,OAAO,CAAC,GAAG,CACf,aAAa,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,kBAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAC1D,CAAC;QAEF,wFAAwF;QACxF,MAAM,wBAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,EAAE,EAAF,kBAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;KAC3D;AACH,CAAC,CAAA,CAAC;AA1BW,QAAA,KAAK,SA0BhB"}

package/lib/api/git/statusMatrix.d.ts

@@ -0,0 +1,7 @@
+export declare const FILEPATH = 0;
+export declare const HEAD = 1;
+export declare const WORKDIR = 2;
+export declare const STAGE = 3;
+export declare const ABSENT = 0;
+export declare const UNMODIFIED = 1;
+export declare const MODIFIED = 2;

package/lib/api/git/statusMatrix.js

@@ -0,0 +1,14 @@
+"use strict";
+// Based off https://isomorphic-git.org/docs/en/statusMatrix.html
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MODIFIED = exports.UNMODIFIED = exports.ABSENT = exports.STAGE = exports.WORKDIR = exports.HEAD = exports.FILEPATH = void 0;
+// Status matrix row indexes
+exports.FILEPATH = 0;
+exports.HEAD = 1;
+exports.WORKDIR = 2;
+exports.STAGE = 3;
+// Status matrix state
+exports.ABSENT = 0;
+exports.UNMODIFIED = 1;
+exports.MODIFIED = 2;
+//# sourceMappingURL=statusMatrix.js.map

package/lib/api/git/statusMatrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusMatrix.js","sourceRoot":"","sources":["../../../src/api/git/statusMatrix.ts"],"names":[],"mappings":";AAAA,iEAAiE;;;AAEjE,4BAA4B;AACf,QAAA,QAAQ,GAAG,CAAC,CAAC;AACb,QAAA,IAAI,GAAG,CAAC,CAAC;AACT,QAAA,OAAO,GAAG,CAAC,CAAC;AACZ,QAAA,KAAK,GAAG,CAAC,CAAC;AAEvB,sBAAsB;AACT,QAAA,MAAM,GAAG,CAAC,CAAC;AACX,QAAA,UAAU,GAAG,CAAC,CAAC;AACf,QAAA,QAAQ,GAAG,CAAC,CAAC"}

package/lib/api/github/checkRun.d.ts

@@ -1,22 +1,44 @@
-import { Endpoints } from '@octokit/types';
+import type { Endpoints } from '@octokit/types';
 declare type Output = NonNullable<Endpoints['POST /repos/{owner}/{repo}/check-runs']['parameters']['output']>;
 export declare type Annotation = NonNullable<Output['annotations']>[number];
+/**
+ * {@link https://docs.github.com/en/rest/reference/checks#create-a-check-run}
+ */
 interface CreateCheckRunParameters {
+    /**
+     * Adds information from your analysis to specific lines of code.
+     * Annotations are visible on GitHub in the **Checks** and **Files changed**
+     * tab of the pull request.
+     */
     annotations: Annotation[];
+    /**
+     * The final conclusion of the check.
+     */
     conclusion: 'failure' | 'success';
+    /**
+     * The name of the check. For example, "code-coverage".
+     */
     name: string;
+    /**
+     * The summary of the check run. This parameter supports Markdown.
+     */
     summary: string;
+    /**
+     * The details of the check run. This parameter supports Markdown.
+     */
+    text?: string;
+    /**
+     * The title of the check run.
+     */
     title: string;
 }
 /**
- * Asynchronously creates a GitHub [check run] with annotations.
+ * Asynchronously creates a GitHub check run with annotations.
  *
  * The first 50 `annotations` are written in full to GitHub.
  *
  * A `GITHUB_API_TOKEN` or `GITHUB_TOKEN` with the `checks:write` permission
  * must be present on the environment.
-
-
  */
-export declare const createCheckRun: ({ annotations, conclusion, name, summary, title, }: CreateCheckRunParameters) => Promise<void>;
+export declare const createCheckRun: ({ annotations, conclusion, name, summary, text, title, }: CreateCheckRunParameters) => Promise<void>;
 export {};