@skuba-lib/api 0.0.0 → 0.1.0-skuba-lib-api-20250925050503

package/LICENSE

@@ -0,0 +1,21 @@
+### MIT License
+
+Copyright (c) 2020 SEEK
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,8 @@
+# @skuba-lib/api
+
+[![npm package](https://img.shields.io/npm/v/@skuba-lib/api?labelColor=cb0000&color=5b5b5b)](https://www.npmjs.com/package/@skuba-lib/api)
+[![Node.js version](https://img.shields.io/node/v/@skuba-lib/api?labelColor=5fa04e&color=5b5b5b)](https://www.npmjs.com/package/@skuba-lib/api)
+
+Shared apis for **[skuba]**.
+
+[skuba]: https://github.com/seek-oss/skuba

package/buildkite/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../lib/buildkite/index.js",
+  "module": "../lib/buildkite/index.mjs",
+  "types": "../lib/buildkite/index.d.ts"
+}

package/git/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../lib/git/index.js",
+  "module": "../lib/git/index.mjs",
+  "types": "../lib/git/index.d.ts"
+}

package/github/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../lib/github/index.js",
+  "module": "../lib/github/index.mjs",
+  "types": "../lib/github/index.d.ts"
+}

package/lib/buildkite/index.d.mts

@@ -0,0 +1,2 @@
+import { AnnotationStyle, annotate$1 as annotate, md$1 as md } from "../index-DiqTDK1U.mjs";
+export { AnnotationStyle, annotate, md };

package/lib/buildkite/index.d.ts

@@ -0,0 +1,2 @@
+import { AnnotationStyle, annotate, md } from "../index-CfnlMf_4.js";
+export { AnnotationStyle, annotate, md };

package/lib/buildkite/index.js

@@ -0,0 +1,6 @@
+require('../exec-B2akdw0z.js');
+require('../logging-6TTEX4U4.js');
+const require_buildkite = require('../buildkite-BXHjSY0I.js');
+
+exports.annotate = require_buildkite.annotate;
+exports.md = require_buildkite.md;

package/lib/buildkite/index.mjs

@@ -0,0 +1,5 @@
+import "../exec-p0gJ30UO.mjs";
+import "../logging-Dr8kuQ_p.mjs";
+import { annotate, md } from "../buildkite-DSHpKA4z.mjs";
+
+export { annotate, md };

package/lib/buildkite-BXHjSY0I.js

@@ -0,0 +1,67 @@
+const require_chunk = require('./chunk-odGzh3W-.js');
+const require_exec = require('./exec-B2akdw0z.js');
+const require_logging = require('./logging-6TTEX4U4.js');
+
+//#region src/buildkite/annotate.ts
+const isAnnotationEnabled = async () => Boolean(process.env.BUILDKITE && process.env.BUILDKITE_AGENT_ACCESS_TOKEN && process.env.BUILDKITE_JOB_ID && await require_exec.hasCommand("buildkite-agent"));
+const MAX_SIZE = 1024 * 1024;
+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`.
+*/
+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;
+		require_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 require_exec.exec("buildkite-agent", "annotate", ...context ? ["--context", context] : [], ...style ? ["--style", style] : [], truncatedMarkdown);
+};
+
+//#endregion
+//#region src/buildkite/md.ts
+/**
+* @internal
+*/
+const md = { terminal: (code) => `\`\`\`term\n${code.replace(/```/g, "\\`\\`\\`")}\n\`\`\`` };
+
+//#endregion
+//#region src/buildkite/index.ts
+var buildkite_exports = {};
+require_chunk.__export(buildkite_exports, {
+	annotate: () => annotate,
+	md: () => md
+});
+
+//#endregion
+Object.defineProperty(exports, 'annotate', {
+  enumerable: true,
+  get: function () {
+    return annotate;
+  }
+});
+Object.defineProperty(exports, 'buildkite_exports', {
+  enumerable: true,
+  get: function () {
+    return buildkite_exports;
+  }
+});
+Object.defineProperty(exports, 'md', {
+  enumerable: true,
+  get: function () {
+    return md;
+  }
+});

package/lib/buildkite-DSHpKA4z.mjs

@@ -0,0 +1,50 @@
+import { __export } from "./chunk-CZCtuq8p.mjs";
+import { exec, hasCommand } from "./exec-p0gJ30UO.mjs";
+import { log } from "./logging-Dr8kuQ_p.mjs";
+
+//#region src/buildkite/annotate.ts
+const isAnnotationEnabled = async () => Boolean(process.env.BUILDKITE && process.env.BUILDKITE_AGENT_ACCESS_TOKEN && process.env.BUILDKITE_JOB_ID && await hasCommand("buildkite-agent"));
+const MAX_SIZE = 1024 * 1024;
+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`.
+*/
+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;
+		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 exec("buildkite-agent", "annotate", ...context ? ["--context", context] : [], ...style ? ["--style", style] : [], truncatedMarkdown);
+};
+
+//#endregion
+//#region src/buildkite/md.ts
+/**
+* @internal
+*/
+const md = { terminal: (code) => `\`\`\`term\n${code.replace(/```/g, "\\`\\`\\`")}\n\`\`\`` };
+
+//#endregion
+//#region src/buildkite/index.ts
+var buildkite_exports = {};
+__export(buildkite_exports, {
+	annotate: () => annotate,
+	md: () => md
+});
+
+//#endregion
+export { annotate, buildkite_exports, md };

package/lib/chunk-CZCtuq8p.mjs

@@ -0,0 +1,37 @@
+import { createRequire } from "node:module";
+
+//#region rolldown:runtime
+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 __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+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 (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __commonJS, __export, __reExport, __require, __toESM };

package/lib/chunk-odGzh3W-.js

@@ -0,0 +1,58 @@
+//#region rolldown:runtime
+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 __commonJS = (cb, mod) => function() {
+	return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+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 (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+Object.defineProperty(exports, '__commonJS', {
+  enumerable: true,
+  get: function () {
+    return __commonJS;
+  }
+});
+Object.defineProperty(exports, '__export', {
+  enumerable: true,
+  get: function () {
+    return __export;
+  }
+});
+Object.defineProperty(exports, '__reExport', {
+  enumerable: true,
+  get: function () {
+    return __reExport;
+  }
+});
+Object.defineProperty(exports, '__toESM', {
+  enumerable: true,
+  get: function () {
+    return __toESM;
+  }
+});