skuba 12.3.0 → 12.4.0-skuba-lib-api-20250925050503

package/lib/cli/test/reporters/github/index.js

@@ -32,20 +32,19 @@ __export(github_exports, {
 });
 module.exports = __toCommonJS(github_exports);
 var import_util = require("util");
-var import_environment = require("../../../../api/github/environment.js");
-var GitHub = __toESM(require("../../../../api/github/index.js"));
 var import_logging = require("../../../../utils/logging.js");
 var import_wait = require("../../../../utils/wait.js");
 var import_annotations = require("./annotations.js");
+var GitHub = __toESM(require("@skuba-lib/api/github"));
 class GitHubReporter {
   async onRunComplete(_contexts, { testResults }) {
-    if (!(0, import_environment.enabledFromEnvironment)()) {
+    if (!GitHub.enabledFromEnvironment()) {
       return;
     }
     let lastCheckRun;
     try {
       const entries = (0, import_annotations.generateAnnotationEntries)(testResults);
-      const build = (0, import_environment.buildNameFromEnvironment)();
+      const build = GitHub.buildNameFromEnvironment();
       for (const { displayName, annotations } of entries) {
         const name = `skuba/test${displayName ? ` (${displayName})` : ""}`;
         const isOk = !annotations.length;

package/lib/cli/test/reporters/github/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/test/reporters/github/index.ts"],
-  "sourcesContent": ["import { inspect } from 'util';\n\nimport type { Reporter, TestContext } from '@jest/reporters';\nimport type { AggregatedResult } from '@jest/test-result';\n\nimport {\n  buildNameFromEnvironment,\n  enabledFromEnvironment,\n} from '../../../../api/github/environment.js';\nimport * as GitHub from '../../../../api/github/index.js';\nimport { log } from '../../../../utils/logging.js';\nimport { throwOnTimeout } from '../../../../utils/wait.js';\n\nimport { generateAnnotationEntries } from './annotations.js';\n\nexport default class GitHubReporter implements Pick<Reporter, 'onRunComplete'> {\n  async onRunComplete(\n    _contexts: Set<TestContext>,\n    { testResults }: AggregatedResult,\n  ): Promise<void> {\n    if (!enabledFromEnvironment()) {\n      return;\n    }\n\n    type CheckRun = Parameters<typeof GitHub.createCheckRun>[0];\n\n    let lastCheckRun: CheckRun | undefined;\n\n    try {\n      const entries = generateAnnotationEntries(testResults);\n\n      const build = buildNameFromEnvironment();\n\n      // Create a check run per display name.\n      // Run in series to reduce the likelihood of exceeding GitHub rate limits.\n      for (const { displayName, annotations } of entries) {\n        const name = `skuba/test${displayName ? ` (${displayName})` : ''}`;\n\n        const isOk = !annotations.length;\n\n        const summary = isOk\n          ? '`skuba test` passed.'\n          : '`skuba test` found issues that require triage.';\n\n        const checkRun: CheckRun = {\n          name,\n          annotations,\n          conclusion: isOk ? 'success' : 'failure',\n          summary,\n          title: `${build} ${isOk ? 'passed' : 'failed'}`,\n        };\n\n        lastCheckRun = checkRun;\n\n        await throwOnTimeout(GitHub.createCheckRun(checkRun), {\n          s: 30,\n        });\n      }\n    } catch (err) {\n      log.warn('Failed to report test results to GitHub.');\n      log.subtle(inspect(err));\n\n      if (lastCheckRun) {\n        log.subtle('Last request:');\n        log.subtle(JSON.stringify(lastCheckRun));\n      }\n    }\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAwB;AAKxB,yBAGO;AACP,aAAwB;AACxB,qBAAoB;AACpB,kBAA+B;AAE/B,yBAA0C;AAE1C,MAAO,eAAwE;AAAA,EAC7E,MAAM,cACJ,WACA,EAAE,YAAY,GACC;AACf,QAAI,KAAC,2CAAuB,GAAG;AAC7B;AAAA,IACF;AAIA,QAAI;AAEJ,QAAI;AACF,YAAM,cAAU,8CAA0B,WAAW;AAErD,YAAM,YAAQ,6CAAyB;AAIvC,iBAAW,EAAE,aAAa,YAAY,KAAK,SAAS;AAClD,cAAM,OAAO,aAAa,cAAc,KAAK,WAAW,MAAM,EAAE;AAEhE,cAAM,OAAO,CAAC,YAAY;AAE1B,cAAM,UAAU,OACZ,yBACA;AAEJ,cAAM,WAAqB;AAAA,UACzB;AAAA,UACA;AAAA,UACA,YAAY,OAAO,YAAY;AAAA,UAC/B;AAAA,UACA,OAAO,GAAG,KAAK,IAAI,OAAO,WAAW,QAAQ;AAAA,QAC/C;AAEA,uBAAe;AAEf,kBAAM,4BAAe,OAAO,eAAe,QAAQ,GAAG;AAAA,UACpD,GAAG;AAAA,QACL,CAAC;AAAA,MACH;AAAA,IACF,SAAS,KAAK;AACZ,yBAAI,KAAK,0CAA0C;AACnD,yBAAI,WAAO,qBAAQ,GAAG,CAAC;AAEvB,UAAI,cAAc;AAChB,2BAAI,OAAO,eAAe;AAC1B,2BAAI,OAAO,KAAK,UAAU,YAAY,CAAC;AAAA,MACzC;AAAA,IACF;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { inspect } from 'util';\n\nimport type { Reporter, TestContext } from '@jest/reporters';\nimport type { AggregatedResult } from '@jest/test-result';\n\nimport { log } from '../../../../utils/logging.js';\nimport { throwOnTimeout } from '../../../../utils/wait.js';\n\nimport { generateAnnotationEntries } from './annotations.js';\n\nimport * as GitHub from '@skuba-lib/api/github';\n\nexport default class GitHubReporter implements Pick<Reporter, 'onRunComplete'> {\n  async onRunComplete(\n    _contexts: Set<TestContext>,\n    { testResults }: AggregatedResult,\n  ): Promise<void> {\n    if (!GitHub.enabledFromEnvironment()) {\n      return;\n    }\n\n    type CheckRun = Parameters<typeof GitHub.createCheckRun>[0];\n\n    let lastCheckRun: CheckRun | undefined;\n\n    try {\n      const entries = generateAnnotationEntries(testResults);\n\n      const build = GitHub.buildNameFromEnvironment();\n\n      // Create a check run per display name.\n      // Run in series to reduce the likelihood of exceeding GitHub rate limits.\n      for (const { displayName, annotations } of entries) {\n        const name = `skuba/test${displayName ? ` (${displayName})` : ''}`;\n\n        const isOk = !annotations.length;\n\n        const summary = isOk\n          ? '`skuba test` passed.'\n          : '`skuba test` found issues that require triage.';\n\n        const checkRun: CheckRun = {\n          name,\n          annotations,\n          conclusion: isOk ? 'success' : 'failure',\n          summary,\n          title: `${build} ${isOk ? 'passed' : 'failed'}`,\n        };\n\n        lastCheckRun = checkRun;\n\n        await throwOnTimeout(GitHub.createCheckRun(checkRun), {\n          s: 30,\n        });\n      }\n    } catch (err) {\n      log.warn('Failed to report test results to GitHub.');\n      log.subtle(inspect(err));\n\n      if (lastCheckRun) {\n        log.subtle('Last request:');\n        log.subtle(JSON.stringify(lastCheckRun));\n      }\n    }\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAwB;AAKxB,qBAAoB;AACpB,kBAA+B;AAE/B,yBAA0C;AAE1C,aAAwB;AAExB,MAAO,eAAwE;AAAA,EAC7E,MAAM,cACJ,WACA,EAAE,YAAY,GACC;AACf,QAAI,CAAC,OAAO,uBAAuB,GAAG;AACpC;AAAA,IACF;AAIA,QAAI;AAEJ,QAAI;AACF,YAAM,cAAU,8CAA0B,WAAW;AAErD,YAAM,QAAQ,OAAO,yBAAyB;AAI9C,iBAAW,EAAE,aAAa,YAAY,KAAK,SAAS;AAClD,cAAM,OAAO,aAAa,cAAc,KAAK,WAAW,MAAM,EAAE;AAEhE,cAAM,OAAO,CAAC,YAAY;AAE1B,cAAM,UAAU,OACZ,yBACA;AAEJ,cAAM,WAAqB;AAAA,UACzB;AAAA,UACA;AAAA,UACA,YAAY,OAAO,YAAY;AAAA,UAC/B;AAAA,UACA,OAAO,GAAG,KAAK,IAAI,OAAO,WAAW,QAAQ;AAAA,QAC/C;AAEA,uBAAe;AAEf,kBAAM,4BAAe,OAAO,eAAe,QAAQ,GAAG;AAAA,UACpD,GAAG;AAAA,QACL,CAAC;AAAA,MACH;AAAA,IACF,SAAS,KAAK;AACZ,yBAAI,KAAK,0CAA0C;AACnD,yBAAI,WAAO,qBAAQ,GAAG,CAAC;AAEvB,UAAI,cAAc;AAChB,2BAAI,OAAO,eAAe;AAC1B,2BAAI,OAAO,KAAK,UAAU,YAAY,CAAC;AAAA,MACzC;AAAA,IACF;AAAA,EACF;AACF;",
   "names": []
 }

package/lib/index.d.ts

@@ -9,11 +9,11 @@
  * const { Net } = require('skuba');
  * ```
  */
-export * as Buildkite from './api/buildkite/index.js';
-export * as Git from './api/git/index.js';
-export * as GitHub from './api/github/index.js';
+export * as Buildkite from '@skuba-lib/api/buildkite';
+export * as Git from '@skuba-lib/api/git';
+export * as GitHub from '@skuba-lib/api/github';
+export * as Net from '@skuba-lib/api/net';
 export * as Jest from './api/jest/index.js';
-export * as Net from './api/net/index.js';
 declare global {
     namespace WebAssembly {
         interface Module {

package/lib/index.js

@@ -35,11 +35,11 @@ __export(index_exports, {
   Net: () => Net
 });
 module.exports = __toCommonJS(index_exports);
-var Buildkite = __toESM(require("./api/buildkite/index.js"));
-var Git = __toESM(require("./api/git/index.js"));
-var GitHub = __toESM(require("./api/github/index.js"));
+var Buildkite = __toESM(require("@skuba-lib/api/buildkite"));
+var Git = __toESM(require("@skuba-lib/api/git"));
+var GitHub = __toESM(require("@skuba-lib/api/github"));
+var Net = __toESM(require("@skuba-lib/api/net"));
 var Jest = __toESM(require("./api/jest/index.js"));
-var Net = __toESM(require("./api/net/index.js"));
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Buildkite,

package/lib/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["/**\n * Entry point for the Node.js development API.\n *\n * This is where skuba imports point to:\n *\n * ```typescript\n * import { Net } from 'skuba';\n *\n * const { Net } = require('skuba');\n * ```\n */\n\nexport * as Buildkite from './api/buildkite/index.js';\nexport * as Git from './api/git/index.js';\nexport * as GitHub from './api/github/index.js';\nexport * as Jest from './api/jest/index.js';\nexport * as Net from './api/net/index.js';\n\n// evanw/esbuild#2388\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace WebAssembly {\n    // eslint-disable-next-line @typescript-eslint/no-empty-object-type\n    interface Module {}\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,gBAA2B;AAC3B,UAAqB;AACrB,aAAwB;AACxB,WAAsB;AACtB,UAAqB;",
+  "sourcesContent": ["/**\n * Entry point for the Node.js development API.\n *\n * This is where skuba imports point to:\n *\n * ```typescript\n * import { Net } from 'skuba';\n *\n * const { Net } = require('skuba');\n * ```\n */\n\nexport * as Buildkite from '@skuba-lib/api/buildkite';\nexport * as Git from '@skuba-lib/api/git';\nexport * as GitHub from '@skuba-lib/api/github';\nexport * as Net from '@skuba-lib/api/net';\nexport * as Jest from './api/jest/index.js';\n\n// evanw/esbuild#2388\ndeclare global {\n  // eslint-disable-next-line @typescript-eslint/no-namespace\n  namespace WebAssembly {\n    // eslint-disable-next-line @typescript-eslint/no-empty-object-type\n    interface Module {}\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,gBAA2B;AAC3B,UAAqB;AACrB,aAAwB;AACxB,UAAqB;AACrB,WAAsB;",
   "names": []
 }

package/lib/utils/dir.js

@@ -41,8 +41,8 @@ var import_path = __toESM(require("path"));
 var import_fs_extra = __toESM(require("fs-extra"));
 var import_ignore = __toESM(require("ignore"));
 var import_picomatch = __toESM(require("picomatch"));
-var import_findRoot = require("../api/git/findRoot.js");
 var import_error = require("./error.js");
+var Git = __toESM(require("@skuba-lib/api/git"));
 const buildPatternToFilepathMap = (patterns, allFilepaths, options) => Object.fromEntries(
   patterns.map((pattern) => {
     const isMatch = (0, import_picomatch.default)(pattern, options);
@@ -135,7 +135,7 @@ const findWorkspaceRoot = async (cwd = process.cwd()) => {
       locateNearestFile({ cwd, filename: "pnpm-lock.yaml" }),
       locateNearestFile({ cwd, filename: "yarn.lock" }),
       locateFurthestFile({ cwd, filename: "package.json" }),
-      (0, import_findRoot.findRoot)({ dir: cwd })
+      Git.findRoot({ dir: cwd })
     ]);
     const candidates = [
       pnpmLock ? import_path.default.dirname(pnpmLock) : null,

package/lib/utils/dir.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/dir.ts"],
-  "sourcesContent": ["import path from 'path';\n\nimport fs from 'fs-extra';\nimport ignore from 'ignore';\nimport picomatch from 'picomatch';\n\nimport { findRoot as findGitRoot } from '../api/git/findRoot.js';\n\nimport { isErrorWithCode } from './error.js';\n\n/**\n * Build a map that associates each glob pattern with its matching filepaths.\n */\nexport const buildPatternToFilepathMap = (\n  patterns: string[],\n  allFilepaths: string[],\n  options?: picomatch.PicomatchOptions,\n) =>\n  Object.fromEntries(\n    patterns.map((pattern) => {\n      const isMatch = picomatch(pattern, options);\n\n      const filepaths = allFilepaths.filter((filepath) => isMatch(filepath));\n\n      return [pattern, filepaths] as const;\n    }),\n  );\n\n/**\n * List relative filepaths contained within a directory root.\n *\n * This excludes:\n *\n * - Patterns in the ignore files specified in `ignoreFilenames`\n * - `.git` subdirectories\n * - `node_modules` subdirectories\n */\nexport const crawlDirectory = async (\n  root: string,\n  ignoreFilenames = ['.gitignore'],\n) => {\n  const ignoreFileFilter = await createInclusionFilter(\n    ignoreFilenames.map((ignoreFilename) => path.join(root, ignoreFilename)),\n  );\n\n  const absoluteFilenames = await crawl(root, {\n    includeDirName: (dirname) => !['.git', 'node_modules'].includes(dirname),\n    includeFilePath: (pathname) =>\n      ignoreFileFilter(path.relative(root, pathname)),\n  });\n\n  const relativeFilepaths = absoluteFilenames.map((filepath) =>\n    path.relative(root, filepath),\n  );\n\n  return relativeFilepaths;\n};\n\n/**\n * Create a filter function that excludes filepaths based on ignore files like\n * `.gitignore` and `.prettierignore`.\n */\nexport const createInclusionFilter = async (ignoreFilepaths: string[]) => {\n  const ignoreFiles = await Promise.all(\n    ignoreFilepaths.map(async (ignoreFilepath) => {\n      try {\n        return await fs.promises.readFile(ignoreFilepath, 'utf8');\n      } catch (err) {\n        if (isErrorWithCode(err, 'ENOENT')) {\n          return;\n        }\n\n        throw err;\n      }\n    }),\n  );\n\n  const managers = ignoreFiles\n    .filter((value): value is string => typeof value === 'string')\n    .map((value) => ignore().add(value));\n\n  return ignore().add('.git').add(managers).createFilter();\n};\n\n/**\n * Recursively crawl a directory and return all file paths that match the\n * filters. `paths` is mutated and returned.\n */\nasync function crawl(\n  directoryPath: string,\n  filters: {\n    includeDirName: (dirName: string) => boolean;\n    includeFilePath: (path: string) => boolean;\n  },\n  paths: string[] = [],\n) {\n  try {\n    const entries = await fs.promises.readdir(directoryPath, {\n      withFileTypes: true,\n    });\n\n    await Promise.all(\n      entries.map(async (entry) => {\n        const fullPath = path.join(directoryPath, entry.name);\n\n        if (\n          (entry.isFile() || entry.isSymbolicLink()) &&\n          filters.includeFilePath(fullPath)\n        ) {\n          paths.push(fullPath);\n        }\n\n        if (entry.isDirectory() && filters.includeDirName(entry.name)) {\n          await crawl(fullPath, filters, paths);\n        }\n      }),\n    );\n  } catch {\n    // Ignore errors, because of e.g. permission issues reading directories\n  }\n\n  return paths;\n}\n\nexport const locateNearestFile = async ({\n  cwd,\n  filename,\n}: {\n  cwd: string;\n  filename: string;\n}) => {\n  let currentDir = cwd;\n  while (currentDir !== path.dirname(currentDir)) {\n    const filePath = path.join(currentDir, filename);\n    if (await fs.pathExists(filePath)) {\n      return filePath;\n    }\n    currentDir = path.dirname(currentDir);\n  }\n\n  return null;\n};\n\nexport const locateFurthestFile = async ({\n  cwd,\n  filename,\n}: {\n  cwd: string;\n  filename: string;\n}) => {\n  let currentDir = cwd;\n  let furthestFilePath: string | null = null;\n\n  while (currentDir !== path.dirname(currentDir)) {\n    const filePath = path.join(currentDir, filename);\n    if (await fs.pathExists(filePath)) {\n      furthestFilePath = filePath;\n    }\n    currentDir = path.dirname(currentDir);\n  }\n\n  return furthestFilePath;\n};\n\nconst workspaceRootCache: Record<string, string | null> = {};\n\nexport const findWorkspaceRoot = async (\n  cwd = process.cwd(),\n): Promise<string | null> => {\n  const find = async (): Promise<string | null> => {\n    const [pnpmLock, yarnLock, packageJson, gitRoot] = await Promise.all([\n      locateNearestFile({ cwd, filename: 'pnpm-lock.yaml' }),\n      locateNearestFile({ cwd, filename: 'yarn.lock' }),\n      locateFurthestFile({ cwd, filename: 'package.json' }),\n      findGitRoot({ dir: cwd }),\n    ]);\n\n    const candidates = [\n      pnpmLock ? path.dirname(pnpmLock) : null,\n      yarnLock ? path.dirname(yarnLock) : null,\n      packageJson ? path.dirname(packageJson) : null,\n      gitRoot,\n    ].filter((dir): dir is string => dir !== null);\n\n    if (candidates[0]) {\n      // Pick the longest path. This will be the most specific, which helps guard against someone\n      // having an accidental lockfile in a parent directory by mistake.\n\n      return candidates.reduce((longest, current) => {\n        if (current.split(path.sep).length > longest.split(path.sep).length) {\n          return current;\n        }\n        return longest;\n      }, candidates[0]);\n    }\n\n    return null;\n  };\n\n  return (workspaceRootCache[cwd] ??= await find());\n};\n\nexport const findCurrentWorkspaceProjectRoot = async (\n  cwd = process.cwd(),\n): Promise<string | null> => {\n  const packageJson = await locateNearestFile({\n    cwd,\n    filename: 'package.json',\n  });\n  return packageJson ? path.dirname(packageJson) : null;\n};\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiB;AAEjB,sBAAe;AACf,oBAAmB;AACnB,uBAAsB;AAEtB,sBAAwC;AAExC,mBAAgC;AAKzB,MAAM,4BAA4B,CACvC,UACA,cACA,YAEA,OAAO;AAAA,EACL,SAAS,IAAI,CAAC,YAAY;AACxB,UAAM,cAAU,iBAAAA,SAAU,SAAS,OAAO;AAE1C,UAAM,YAAY,aAAa,OAAO,CAAC,aAAa,QAAQ,QAAQ,CAAC;AAErE,WAAO,CAAC,SAAS,SAAS;AAAA,EAC5B,CAAC;AACH;AAWK,MAAM,iBAAiB,OAC5B,MACA,kBAAkB,CAAC,YAAY,MAC5B;AACH,QAAM,mBAAmB,MAAM;AAAA,IAC7B,gBAAgB,IAAI,CAAC,mBAAmB,YAAAC,QAAK,KAAK,MAAM,cAAc,CAAC;AAAA,EACzE;AAEA,QAAM,oBAAoB,MAAM,MAAM,MAAM;AAAA,IAC1C,gBAAgB,CAAC,YAAY,CAAC,CAAC,QAAQ,cAAc,EAAE,SAAS,OAAO;AAAA,IACvE,iBAAiB,CAAC,aAChB,iBAAiB,YAAAA,QAAK,SAAS,MAAM,QAAQ,CAAC;AAAA,EAClD,CAAC;AAED,QAAM,oBAAoB,kBAAkB;AAAA,IAAI,CAAC,aAC/C,YAAAA,QAAK,SAAS,MAAM,QAAQ;AAAA,EAC9B;AAEA,SAAO;AACT;AAMO,MAAM,wBAAwB,OAAO,oBAA8B;AACxE,QAAM,cAAc,MAAM,QAAQ;AAAA,IAChC,gBAAgB,IAAI,OAAO,mBAAmB;AAC5C,UAAI;AACF,eAAO,MAAM,gBAAAC,QAAG,SAAS,SAAS,gBAAgB,MAAM;AAAA,MAC1D,SAAS,KAAK;AACZ,gBAAI,8BAAgB,KAAK,QAAQ,GAAG;AAClC;AAAA,QACF;AAEA,cAAM;AAAA,MACR;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,WAAW,YACd,OAAO,CAAC,UAA2B,OAAO,UAAU,QAAQ,EAC5D,IAAI,CAAC,cAAU,cAAAC,SAAO,EAAE,IAAI,KAAK,CAAC;AAErC,aAAO,cAAAA,SAAO,EAAE,IAAI,MAAM,EAAE,IAAI,QAAQ,EAAE,aAAa;AACzD;AAMA,eAAe,MACb,eACA,SAIA,QAAkB,CAAC,GACnB;AACA,MAAI;AACF,UAAM,UAAU,MAAM,gBAAAD,QAAG,SAAS,QAAQ,eAAe;AAAA,MACvD,eAAe;AAAA,IACjB,CAAC;AAED,UAAM,QAAQ;AAAA,MACZ,QAAQ,IAAI,OAAO,UAAU;AAC3B,cAAM,WAAW,YAAAD,QAAK,KAAK,eAAe,MAAM,IAAI;AAEpD,aACG,MAAM,OAAO,KAAK,MAAM,eAAe,MACxC,QAAQ,gBAAgB,QAAQ,GAChC;AACA,gBAAM,KAAK,QAAQ;AAAA,QACrB;AAEA,YAAI,MAAM,YAAY,KAAK,QAAQ,eAAe,MAAM,IAAI,GAAG;AAC7D,gBAAM,MAAM,UAAU,SAAS,KAAK;AAAA,QACtC;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,SAAO;AACT;AAEO,MAAM,oBAAoB,OAAO;AAAA,EACtC;AAAA,EACA;AACF,MAGM;AACJ,MAAI,aAAa;AACjB,SAAO,eAAe,YAAAA,QAAK,QAAQ,UAAU,GAAG;AAC9C,UAAM,WAAW,YAAAA,QAAK,KAAK,YAAY,QAAQ;AAC/C,QAAI,MAAM,gBAAAC,QAAG,WAAW,QAAQ,GAAG;AACjC,aAAO;AAAA,IACT;AACA,iBAAa,YAAAD,QAAK,QAAQ,UAAU;AAAA,EACtC;AAEA,SAAO;AACT;AAEO,MAAM,qBAAqB,OAAO;AAAA,EACvC;AAAA,EACA;AACF,MAGM;AACJ,MAAI,aAAa;AACjB,MAAI,mBAAkC;AAEtC,SAAO,eAAe,YAAAA,QAAK,QAAQ,UAAU,GAAG;AAC9C,UAAM,WAAW,YAAAA,QAAK,KAAK,YAAY,QAAQ;AAC/C,QAAI,MAAM,gBAAAC,QAAG,WAAW,QAAQ,GAAG;AACjC,yBAAmB;AAAA,IACrB;AACA,iBAAa,YAAAD,QAAK,QAAQ,UAAU;AAAA,EACtC;AAEA,SAAO;AACT;AAEA,MAAM,qBAAoD,CAAC;AAEpD,MAAM,oBAAoB,OAC/B,MAAM,QAAQ,IAAI,MACS;AAC3B,QAAM,OAAO,YAAoC;AAC/C,UAAM,CAAC,UAAU,UAAU,aAAa,OAAO,IAAI,MAAM,QAAQ,IAAI;AAAA,MACnE,kBAAkB,EAAE,KAAK,UAAU,iBAAiB,CAAC;AAAA,MACrD,kBAAkB,EAAE,KAAK,UAAU,YAAY,CAAC;AAAA,MAChD,mBAAmB,EAAE,KAAK,UAAU,eAAe,CAAC;AAAA,UACpD,gBAAAG,UAAY,EAAE,KAAK,IAAI,CAAC;AAAA,IAC1B,CAAC;AAED,UAAM,aAAa;AAAA,MACjB,WAAW,YAAAH,QAAK,QAAQ,QAAQ,IAAI;AAAA,MACpC,WAAW,YAAAA,QAAK,QAAQ,QAAQ,IAAI;AAAA,MACpC,cAAc,YAAAA,QAAK,QAAQ,WAAW,IAAI;AAAA,MAC1C;AAAA,IACF,EAAE,OAAO,CAAC,QAAuB,QAAQ,IAAI;AAE7C,QAAI,WAAW,CAAC,GAAG;AAIjB,aAAO,WAAW,OAAO,CAAC,SAAS,YAAY;AAC7C,YAAI,QAAQ,MAAM,YAAAA,QAAK,GAAG,EAAE,SAAS,QAAQ,MAAM,YAAAA,QAAK,GAAG,EAAE,QAAQ;AACnE,iBAAO;AAAA,QACT;AACA,eAAO;AAAA,MACT,GAAG,WAAW,CAAC,CAAC;AAAA,IAClB;AAEA,WAAO;AAAA,EACT;AAEA,SAAQ,mBAAmB,GAAG,MAAM,MAAM,KAAK;AACjD;AAEO,MAAM,kCAAkC,OAC7C,MAAM,QAAQ,IAAI,MACS;AAC3B,QAAM,cAAc,MAAM,kBAAkB;AAAA,IAC1C;AAAA,IACA,UAAU;AAAA,EACZ,CAAC;AACD,SAAO,cAAc,YAAAA,QAAK,QAAQ,WAAW,IAAI;AACnD;",
-  "names": ["picomatch", "path", "fs", "ignore", "findGitRoot"]
+  "sourcesContent": ["import path from 'path';\n\nimport fs from 'fs-extra';\nimport ignore from 'ignore';\nimport picomatch from 'picomatch';\n\nimport { isErrorWithCode } from './error.js';\n\nimport * as Git from '@skuba-lib/api/git';\n\n/**\n * Build a map that associates each glob pattern with its matching filepaths.\n */\nexport const buildPatternToFilepathMap = (\n  patterns: string[],\n  allFilepaths: string[],\n  options?: picomatch.PicomatchOptions,\n) =>\n  Object.fromEntries(\n    patterns.map((pattern) => {\n      const isMatch = picomatch(pattern, options);\n\n      const filepaths = allFilepaths.filter((filepath) => isMatch(filepath));\n\n      return [pattern, filepaths] as const;\n    }),\n  );\n\n/**\n * List relative filepaths contained within a directory root.\n *\n * This excludes:\n *\n * - Patterns in the ignore files specified in `ignoreFilenames`\n * - `.git` subdirectories\n * - `node_modules` subdirectories\n */\nexport const crawlDirectory = async (\n  root: string,\n  ignoreFilenames = ['.gitignore'],\n) => {\n  const ignoreFileFilter = await createInclusionFilter(\n    ignoreFilenames.map((ignoreFilename) => path.join(root, ignoreFilename)),\n  );\n\n  const absoluteFilenames = await crawl(root, {\n    includeDirName: (dirname) => !['.git', 'node_modules'].includes(dirname),\n    includeFilePath: (pathname) =>\n      ignoreFileFilter(path.relative(root, pathname)),\n  });\n\n  const relativeFilepaths = absoluteFilenames.map((filepath) =>\n    path.relative(root, filepath),\n  );\n\n  return relativeFilepaths;\n};\n\n/**\n * Create a filter function that excludes filepaths based on ignore files like\n * `.gitignore` and `.prettierignore`.\n */\nexport const createInclusionFilter = async (ignoreFilepaths: string[]) => {\n  const ignoreFiles = await Promise.all(\n    ignoreFilepaths.map(async (ignoreFilepath) => {\n      try {\n        return await fs.promises.readFile(ignoreFilepath, 'utf8');\n      } catch (err) {\n        if (isErrorWithCode(err, 'ENOENT')) {\n          return;\n        }\n\n        throw err;\n      }\n    }),\n  );\n\n  const managers = ignoreFiles\n    .filter((value): value is string => typeof value === 'string')\n    .map((value) => ignore().add(value));\n\n  return ignore().add('.git').add(managers).createFilter();\n};\n\n/**\n * Recursively crawl a directory and return all file paths that match the\n * filters. `paths` is mutated and returned.\n */\nasync function crawl(\n  directoryPath: string,\n  filters: {\n    includeDirName: (dirName: string) => boolean;\n    includeFilePath: (path: string) => boolean;\n  },\n  paths: string[] = [],\n) {\n  try {\n    const entries = await fs.promises.readdir(directoryPath, {\n      withFileTypes: true,\n    });\n\n    await Promise.all(\n      entries.map(async (entry) => {\n        const fullPath = path.join(directoryPath, entry.name);\n\n        if (\n          (entry.isFile() || entry.isSymbolicLink()) &&\n          filters.includeFilePath(fullPath)\n        ) {\n          paths.push(fullPath);\n        }\n\n        if (entry.isDirectory() && filters.includeDirName(entry.name)) {\n          await crawl(fullPath, filters, paths);\n        }\n      }),\n    );\n  } catch {\n    // Ignore errors, because of e.g. permission issues reading directories\n  }\n\n  return paths;\n}\n\nexport const locateNearestFile = async ({\n  cwd,\n  filename,\n}: {\n  cwd: string;\n  filename: string;\n}) => {\n  let currentDir = cwd;\n  while (currentDir !== path.dirname(currentDir)) {\n    const filePath = path.join(currentDir, filename);\n    if (await fs.pathExists(filePath)) {\n      return filePath;\n    }\n    currentDir = path.dirname(currentDir);\n  }\n\n  return null;\n};\n\nexport const locateFurthestFile = async ({\n  cwd,\n  filename,\n}: {\n  cwd: string;\n  filename: string;\n}) => {\n  let currentDir = cwd;\n  let furthestFilePath: string | null = null;\n\n  while (currentDir !== path.dirname(currentDir)) {\n    const filePath = path.join(currentDir, filename);\n    if (await fs.pathExists(filePath)) {\n      furthestFilePath = filePath;\n    }\n    currentDir = path.dirname(currentDir);\n  }\n\n  return furthestFilePath;\n};\n\nconst workspaceRootCache: Record<string, string | null> = {};\n\nexport const findWorkspaceRoot = async (\n  cwd = process.cwd(),\n): Promise<string | null> => {\n  const find = async (): Promise<string | null> => {\n    const [pnpmLock, yarnLock, packageJson, gitRoot] = await Promise.all([\n      locateNearestFile({ cwd, filename: 'pnpm-lock.yaml' }),\n      locateNearestFile({ cwd, filename: 'yarn.lock' }),\n      locateFurthestFile({ cwd, filename: 'package.json' }),\n      Git.findRoot({ dir: cwd }),\n    ]);\n\n    const candidates = [\n      pnpmLock ? path.dirname(pnpmLock) : null,\n      yarnLock ? path.dirname(yarnLock) : null,\n      packageJson ? path.dirname(packageJson) : null,\n      gitRoot,\n    ].filter((dir): dir is string => dir !== null);\n\n    if (candidates[0]) {\n      // Pick the longest path. This will be the most specific, which helps guard against someone\n      // having an accidental lockfile in a parent directory by mistake.\n\n      return candidates.reduce((longest, current) => {\n        if (current.split(path.sep).length > longest.split(path.sep).length) {\n          return current;\n        }\n        return longest;\n      }, candidates[0]);\n    }\n\n    return null;\n  };\n\n  return (workspaceRootCache[cwd] ??= await find());\n};\n\nexport const findCurrentWorkspaceProjectRoot = async (\n  cwd = process.cwd(),\n): Promise<string | null> => {\n  const packageJson = await locateNearestFile({\n    cwd,\n    filename: 'package.json',\n  });\n  return packageJson ? path.dirname(packageJson) : null;\n};\n"],
+  "mappings": "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",
+  "names": ["picomatch", "path", "fs", "ignore"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skuba",
-  "version": "12.3.0",
+  "version": "12.4.0-skuba-lib-api-20250925050503",
   "private": false,
   "description": "SEEK development toolkit for backend applications and packages",
   "homepage": "https://github.com/seek-oss/skuba#readme",
@@ -97,7 +97,8 @@
     "tsx": "^4.16.2",
     "typescript": "~5.9.0",
     "zod": "^4.0.0",
-    "eslint-config-skuba": "7.1.2"
+    "eslint-config-skuba": "7.1.2",
+    "@skuba-lib/api": "^0.1.0-skuba-lib-api-20250925050503"
   },
   "devDependencies": {
     "@changesets/cli": "2.29.7",

package/template/base/_pnpm-workspace.yaml

@@ -3,6 +3,7 @@ ignorePatchFailures: false
 minimumReleaseAge: 4320 # 3 days
 minimumReleaseAgeExclude:
   - '@seek/*'
+  - '@skuba-lib/*'
   - eslint-config-seek
   - eslint-config-skuba
   - eslint-plugin-skuba

package/template/greeter/package.json

@@ -17,7 +17,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.10",
-    "skuba": "*"
+    "skuba": "12.4.0-skuba-lib-api-20250925050503"
   },
   "packageManager": "pnpm@10.17.0",
   "engines": {

package/template/lambda-sqs-worker-cdk/package.json

@@ -35,7 +35,7 @@
     "datadog-lambda-js": "^12.0.0",
     "dd-trace": "^5.0.0",
     "pino-pretty": "^13.0.0",
-    "skuba": "*"
+    "skuba": "12.4.0-skuba-lib-api-20250925050503"
   },
   "packageManager": "pnpm@10.17.0",
   "engines": {

package/lib/api/buildkite/annotate.d.ts

@@ -1,28 +0,0 @@
-export type AnnotationStyle = 'success' | 'info' | 'warning' | 'error';
-interface AnnotationOptions {
-    context?: string;
-    /**
-     * Scopes an annotation's context to the Buildkite step ID.
-     *
-     * This lets you emit distinct annotations per step, and only takes effect if
-     * the `BUILDKITE_STEP_ID` environment variable is present.
-     */
-    scopeContextToStep?: boolean;
-    style?: AnnotationStyle;
-}
-export declare const MAX_SIZE: number;
-export declare const TRUNCATION_WARNING = "... [Truncated due to size limit]";
-/**
- * Asynchronously uploads a Buildkite annotation.
- *
- * If the following environment variables are not present,
- * the function will silently return without attempting to annotate:
- *
- * - `BUILDKITE`
- * - `BUILDKITE_AGENT_ACCESS_TOKEN`
- * - `BUILDKITE_JOB_ID`
- *
- * The `buildkite-agent` binary must also be on your `PATH`.
- */
-export declare const annotate: (markdown: string, opts?: AnnotationOptions) => Promise<void>;
-export {};

package/lib/api/buildkite/annotate.js

@@ -1,62 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var annotate_exports = {};
-__export(annotate_exports, {
-  MAX_SIZE: () => MAX_SIZE,
-  TRUNCATION_WARNING: () => TRUNCATION_WARNING,
-  annotate: () => annotate
-});
-module.exports = __toCommonJS(annotate_exports);
-var import_exec = require("../../utils/exec.js");
-var import_logging = require("../../utils/logging.js");
-const isAnnotationEnabled = async () => Boolean(
-  process.env.BUILDKITE && process.env.BUILDKITE_AGENT_ACCESS_TOKEN && process.env.BUILDKITE_JOB_ID && await (0, import_exec.hasCommand)("buildkite-agent")
-);
-const MAX_SIZE = 1024 * 1024;
-const TRUNCATION_WARNING = "... [Truncated due to size limit]";
-const annotate = async (markdown, opts = {}) => {
-  if (!await isAnnotationEnabled()) {
-    return;
-  }
-  let truncatedMarkdown = markdown;
-  if (markdown.length > MAX_SIZE) {
-    const remainingSpace = MAX_SIZE - TRUNCATION_WARNING.length;
-    truncatedMarkdown = markdown.slice(0, remainingSpace) + TRUNCATION_WARNING;
-    import_logging.log.warn(`Annotation truncated, full message is: ${markdown}`);
-  }
-  const context = [
-    opts.scopeContextToStep && process.env.BUILDKITE_STEP_ID,
-    opts.context
-  ].filter(Boolean).join("|");
-  const { style } = opts;
-  await (0, import_exec.exec)(
-    "buildkite-agent",
-    "annotate",
-    ...context ? ["--context", context] : [],
-    ...style ? ["--style", style] : [],
-    truncatedMarkdown
-  );
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  MAX_SIZE,
-  TRUNCATION_WARNING,
-  annotate
-});
-//# sourceMappingURL=annotate.js.map

package/lib/api/buildkite/annotate.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/api/buildkite/annotate.ts"],
-  "sourcesContent": ["import { exec, hasCommand } from '../../utils/exec.js';\nimport { log } from '../../utils/logging.js';\n\nexport type AnnotationStyle = 'success' | 'info' | 'warning' | 'error';\n\nconst isAnnotationEnabled = async () =>\n  Boolean(\n    process.env.BUILDKITE &&\n      process.env.BUILDKITE_AGENT_ACCESS_TOKEN &&\n      process.env.BUILDKITE_JOB_ID &&\n      (await hasCommand('buildkite-agent')),\n  );\n\ninterface AnnotationOptions {\n  context?: string;\n\n  /**\n   * Scopes an annotation's context to the Buildkite step ID.\n   *\n   * This lets you emit distinct annotations per step, and only takes effect if\n   * the `BUILDKITE_STEP_ID` environment variable is present.\n   */\n  scopeContextToStep?: boolean;\n\n  style?: AnnotationStyle;\n}\n\n// Buildkite annotation currently only supports 1MiB of data\nexport const MAX_SIZE = 1024 * 1024; // 1MiB in bytes\nexport const TRUNCATION_WARNING = '... [Truncated due to size limit]';\n\n/**\n * Asynchronously uploads a Buildkite annotation.\n *\n * If the following environment variables are not present,\n * the function will silently return without attempting to annotate:\n *\n * - `BUILDKITE`\n * - `BUILDKITE_AGENT_ACCESS_TOKEN`\n * - `BUILDKITE_JOB_ID`\n *\n * The `buildkite-agent` binary must also be on your `PATH`.\n */\nexport const annotate = async (\n  markdown: string,\n  opts: AnnotationOptions = {},\n): Promise<void> => {\n  if (!(await isAnnotationEnabled())) {\n    return;\n  }\n\n  // Check if the annotation exceeds the maximum size\n  let truncatedMarkdown = markdown;\n  if (markdown.length > MAX_SIZE) {\n    // Notify user of truncation, leave space for message\n    const remainingSpace = MAX_SIZE - TRUNCATION_WARNING.length;\n    truncatedMarkdown = markdown.slice(0, remainingSpace) + TRUNCATION_WARNING;\n    // Log full message to the build log\n    log.warn(`Annotation truncated, full message is: ${markdown}`);\n  }\n\n  // Always scope to the current Buildkite step.\n  const context = [\n    opts.scopeContextToStep && process.env.BUILDKITE_STEP_ID,\n    opts.context,\n  ]\n    .filter(Boolean)\n    .join('|');\n\n  const { style } = opts;\n\n  await exec(\n    'buildkite-agent',\n    'annotate',\n    ...(context ? ['--context', context] : []),\n    ...(style ? ['--style', style] : []),\n    truncatedMarkdown,\n  );\n};\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiC;AACjC,qBAAoB;AAIpB,MAAM,sBAAsB,YAC1B;AAAA,EACE,QAAQ,IAAI,aACV,QAAQ,IAAI,gCACZ,QAAQ,IAAI,oBACX,UAAM,wBAAW,iBAAiB;AACvC;AAiBK,MAAM,WAAW,OAAO;AACxB,MAAM,qBAAqB;AAc3B,MAAM,WAAW,OACtB,UACA,OAA0B,CAAC,MACT;AAClB,MAAI,CAAE,MAAM,oBAAoB,GAAI;AAClC;AAAA,EACF;AAGA,MAAI,oBAAoB;AACxB,MAAI,SAAS,SAAS,UAAU;AAE9B,UAAM,iBAAiB,WAAW,mBAAmB;AACrD,wBAAoB,SAAS,MAAM,GAAG,cAAc,IAAI;AAExD,uBAAI,KAAK,0CAA0C,QAAQ,EAAE;AAAA,EAC/D;AAGA,QAAM,UAAU;AAAA,IACd,KAAK,sBAAsB,QAAQ,IAAI;AAAA,IACvC,KAAK;AAAA,EACP,EACG,OAAO,OAAO,EACd,KAAK,GAAG;AAEX,QAAM,EAAE,MAAM,IAAI;AAElB,YAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,GAAI,UAAU,CAAC,aAAa,OAAO,IAAI,CAAC;AAAA,IACxC,GAAI,QAAQ,CAAC,WAAW,KAAK,IAAI,CAAC;AAAA,IAClC;AAAA,EACF;AACF;",
-  "names": []
-}

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

@@ -1,3 +0,0 @@
-export type { AnnotationStyle } from './annotate.js';
-export { annotate } from './annotate.js';
-export { md } from './md.js';

package/lib/api/buildkite/index.js

@@ -1,32 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var buildkite_exports = {};
-__export(buildkite_exports, {
-  annotate: () => import_annotate.annotate,
-  md: () => import_md.md
-});
-module.exports = __toCommonJS(buildkite_exports);
-var import_annotate = require("./annotate.js");
-var import_md = require("./md.js");
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  annotate,
-  md
-});
-//# sourceMappingURL=index.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/api/buildkite/index.ts"],
-  "sourcesContent": ["export type { AnnotationStyle } from './annotate.js';\nexport { annotate } from './annotate.js';\nexport { md } from './md.js';\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,sBAAyB;AACzB,gBAAmB;",
-  "names": []
-}

package/lib/api/buildkite/md.d.ts

@@ -1,6 +0,0 @@
-/**
- * @internal
- */
-export declare const md: {
-    terminal: (code: string) => string;
-};

package/lib/api/buildkite/md.js

@@ -1,33 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var md_exports = {};
-__export(md_exports, {
-  md: () => md
-});
-module.exports = __toCommonJS(md_exports);
-const md = {
-  terminal: (code) => `\`\`\`term
-${code.replace(/```/g, "\\`\\`\\`")}
-\`\`\``
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  md
-});
-//# sourceMappingURL=md.js.map

package/lib/api/buildkite/md.js.map

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/api/buildkite/md.ts"],
-  "sourcesContent": ["/**\n * @internal\n */\nexport const md = {\n  terminal: (code: string) =>\n    `\\`\\`\\`term\\n${code.replace(/```/g, '\\\\`\\\\`\\\\`')}\\n\\`\\`\\``,\n};\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,MAAM,KAAK;AAAA,EAChB,UAAU,CAAC,SACT;AAAA,EAAe,KAAK,QAAQ,QAAQ,WAAW,CAAC;AAAA;AACpD;",
-  "names": []
-}

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

@@ -1,15 +0,0 @@
-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

@@ -1,52 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var commit_exports = {};
-__export(commit_exports, {
-  commit: () => commit
-});
-module.exports = __toCommonJS(commit_exports);
-var import_fs_extra = __toESM(require("fs-extra"));
-var import_isomorphic_git = __toESM(require("isomorphic-git"));
-const commit = async ({
-  author = { name: "skuba" },
-  committer = { name: "skuba" },
-  dir,
-  message
-}) => import_isomorphic_git.default.commit({
-  author,
-  committer,
-  dir,
-  fs: import_fs_extra.default,
-  message
-});
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  commit
-});
-//# sourceMappingURL=commit.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/api/git/commit.ts"],
-  "sourcesContent": ["import fs from 'fs-extra';\nimport git from 'isomorphic-git';\n\nexport interface Identity {\n  email?: string;\n  name?: string;\n}\n\ninterface CommitParameters {\n  author?: Identity;\n  committer?: Identity;\n  dir: string;\n  message: string;\n}\n\n/**\n * Writes a commit to the local Git repository.\n */\nexport const commit = async ({\n  author = { name: 'skuba' },\n  committer = { name: 'skuba' },\n  dir,\n  message,\n}: CommitParameters): Promise<string> =>\n  git.commit({\n    author,\n    committer,\n    dir,\n    fs,\n    message,\n  });\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAe;AACf,4BAAgB;AAiBT,MAAM,SAAS,OAAO;AAAA,EAC3B,SAAS,EAAE,MAAM,QAAQ;AAAA,EACzB,YAAY,EAAE,MAAM,QAAQ;AAAA,EAC5B;AAAA,EACA;AACF,MACE,sBAAAA,QAAI,OAAO;AAAA,EACT;AAAA,EACA;AAAA,EACA;AAAA,EACA,oBAAAC;AAAA,EACA;AACF,CAAC;",
-  "names": ["git", "fs"]
-}

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

@@ -1,19 +0,0 @@
-import { type Identity } from './commit.js';
-import { type ChangedFile } from './getChangedFiles.js';
-interface CommitAllParameters {
-    dir: string;
-    message: string;
-    author?: Identity;
-    committer?: Identity;
-    /**
-     * File changes to exclude from the commit.
-     *
-     * Defaults to `[]` (no exclusions).
-     */
-    ignore?: ChangedFile[];
-}
-/**
- * Stages all changes and writes a commit to the local Git repository.
- */
-export declare const commitAllChanges: ({ dir, message, author, committer, ignore, }: CommitAllParameters) => Promise<string | undefined>;
-export {};

package/lib/api/git/commitAllChanges.js

@@ -1,83 +0,0 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var commitAllChanges_exports = {};
-__export(commitAllChanges_exports, {
-  commitAllChanges: () => commitAllChanges
-});
-module.exports = __toCommonJS(commitAllChanges_exports);
-var import_path = __toESM(require("path"));
-var import_fs_extra = __toESM(require("fs-extra"));
-var import_isomorphic_git = __toESM(require("isomorphic-git"));
-var import_commit = require("./commit.js");
-var import_findRoot = require("./findRoot.js");
-var import_getChangedFiles = require("./getChangedFiles.js");
-const commitAllChanges = async ({
-  dir,
-  message,
-  author,
-  committer,
-  ignore
-}) => {
-  const changedFiles = await (0, import_getChangedFiles.getChangedFiles)({ dir, ignore });
-  if (!changedFiles.length) {
-    return;
-  }
-  const gitRoot = await (0, import_findRoot.findRoot)({ dir });
-  if (!gitRoot) {
-    throw new Error(`Could not find Git root from directory: ${dir}`);
-  }
-  await Promise.all(
-    changedFiles.map(async (file) => {
-      const relativePath = import_path.default.relative(dir, file.path);
-      if (relativePath.startsWith("..")) {
-        return;
-      }
-      return file.state === "deleted" ? import_isomorphic_git.default.remove({
-        fs: import_fs_extra.default,
-        dir: gitRoot,
-        filepath: file.path
-      }) : import_isomorphic_git.default.add({
-        fs: import_fs_extra.default,
-        dir: gitRoot,
-        filepath: file.path
-      });
-    })
-  );
-  return (0, import_commit.commit)({
-    dir: gitRoot,
-    message,
-    author,
-    committer
-  });
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  commitAllChanges
-});
-//# sourceMappingURL=commitAllChanges.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/api/git/commitAllChanges.ts"],
-  "sourcesContent": ["import path from 'path';\n\nimport fs from 'fs-extra';\nimport git from 'isomorphic-git';\n\nimport { type Identity, commit } from './commit.js';\nimport { findRoot } from './findRoot.js';\nimport { type ChangedFile, getChangedFiles } from './getChangedFiles.js';\n\ninterface CommitAllParameters {\n  dir: string;\n  message: string;\n  author?: Identity;\n  committer?: Identity;\n\n  /**\n   * File changes to exclude from the commit.\n   *\n   * Defaults to `[]` (no exclusions).\n   */\n  ignore?: ChangedFile[];\n}\n\n/**\n * Stages all changes and writes a commit to the local Git repository.\n */\nexport const commitAllChanges = async ({\n  dir,\n  message,\n\n  author,\n  committer,\n  ignore,\n}: CommitAllParameters): Promise<string | undefined> => {\n  const changedFiles = await getChangedFiles({ dir, ignore });\n\n  if (!changedFiles.length) {\n    return;\n  }\n\n  const gitRoot = await findRoot({ dir });\n\n  if (!gitRoot) {\n    throw new Error(`Could not find Git root from directory: ${dir}`);\n  }\n\n  await Promise.all(\n    changedFiles.map(async (file) => {\n      const relativePath = path.relative(dir, file.path);\n\n      // Skipping file outside working directory, see https://github.com/seek-oss/skuba/pull/1269#discussion_r1335308704\n      if (relativePath.startsWith('..')) {\n        return;\n      }\n\n      return file.state === 'deleted'\n        ? git.remove({\n            fs,\n            dir: gitRoot,\n            filepath: file.path,\n          })\n        : git.add({\n            fs,\n            dir: gitRoot,\n            filepath: file.path,\n          });\n    }),\n  );\n\n  return commit({\n    dir: gitRoot,\n    message,\n    author,\n    committer,\n  });\n};\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAiB;AAEjB,sBAAe;AACf,4BAAgB;AAEhB,oBAAsC;AACtC,sBAAyB;AACzB,6BAAkD;AAmB3C,MAAM,mBAAmB,OAAO;AAAA,EACrC;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AACF,MAAwD;AACtD,QAAM,eAAe,UAAM,wCAAgB,EAAE,KAAK,OAAO,CAAC;AAE1D,MAAI,CAAC,aAAa,QAAQ;AACxB;AAAA,EACF;AAEA,QAAM,UAAU,UAAM,0BAAS,EAAE,IAAI,CAAC;AAEtC,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI,MAAM,2CAA2C,GAAG,EAAE;AAAA,EAClE;AAEA,QAAM,QAAQ;AAAA,IACZ,aAAa,IAAI,OAAO,SAAS;AAC/B,YAAM,eAAe,YAAAA,QAAK,SAAS,KAAK,KAAK,IAAI;AAGjD,UAAI,aAAa,WAAW,IAAI,GAAG;AACjC;AAAA,MACF;AAEA,aAAO,KAAK,UAAU,YAClB,sBAAAC,QAAI,OAAO;AAAA,QACT,oBAAAC;AAAA,QACA,KAAK;AAAA,QACL,UAAU,KAAK;AAAA,MACjB,CAAC,IACD,sBAAAD,QAAI,IAAI;AAAA,QACN,oBAAAC;AAAA,QACA,KAAK;AAAA,QACL,UAAU,KAAK;AAAA,MACjB,CAAC;AAAA,IACP,CAAC;AAAA,EACH;AAEA,aAAO,sBAAO;AAAA,IACZ,KAAK;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;",
-  "names": ["path", "git", "fs"]
-}

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

@@ -1,10 +0,0 @@
-interface CurrentBranchParameters {
-    dir?: string;
-    env?: Record<string, string | undefined>;
-}
-/**
- * Tries to return a Git branch name from CI environment variables, falling back
- * to the local Git repository when the current working `dir` is supplied.
- */
-export declare const currentBranch: ({ dir, env, }?: CurrentBranchParameters) => Promise<string | undefined>;
-export {};