ci-cost-diff-action 0.1.0

package/src/inputs.js

@@ -0,0 +1,187 @@
+/**
+ * Reads a GitHub Action input from its normalized environment variable name.
+ * @param {string} name Action input name from `action.yml`.
+ * @param {string} [fallback=""] Value returned when the input is absent.
+ * @returns {string} Trimmed input value or fallback.
+ */
+export function getInput(name, fallback = "") {
+  const candidates = [
+    `INPUT_${name.replace(/ /g, "_").toUpperCase()}`,
+    `INPUT_${name.replace(/[\s-]+/g, "_").toUpperCase()}`
+  ];
+
+  for (const key of candidates) {
+    if (Object.prototype.hasOwnProperty.call(process.env, key)) {
+      return process.env[key]?.trim() ?? "";
+    }
+  }
+
+  return fallback;
+}
+
+/**
+ * Parses common boolean spellings used by action inputs and CLI flags.
+ * @param {unknown} value Raw value.
+ * @param {boolean} [fallback=false] Value returned for empty input.
+ * @returns {boolean} Parsed boolean.
+ */
+export function parseBoolean(value, fallback = false) {
+  if (value === undefined || value === null || value === "") {
+    return fallback;
+  }
+
+  const normalized = String(value).trim().toLowerCase();
+  if (["1", "true", "yes", "on"].includes(normalized)) {
+    return true;
+  }
+
+  if (["0", "false", "no", "off"].includes(normalized)) {
+    return false;
+  }
+
+  throw new Error(`Expected a boolean, got "${value}".`);
+}
+
+/**
+ * Parses and validates a string enum input.
+ * @param {unknown} value Raw value.
+ * @param {string[]} choices Allowed lowercase values.
+ * @param {string} fallback Value returned for empty input.
+ * @param {string} [name="value"] Name used in validation errors.
+ * @returns {string} Parsed choice.
+ */
+export function parseChoice(value, choices, fallback, name = "value") {
+  if (value === undefined || value === null || value === "") {
+    return fallback;
+  }
+
+  const normalized = String(value).trim().toLowerCase();
+  if (choices.includes(normalized)) {
+    return normalized;
+  }
+
+  throw new Error(`${name} must be one of: ${choices.join(", ")}.`);
+}
+
+/**
+ * Parses a finite number.
+ * @param {unknown} value Raw value.
+ * @param {number} [fallback] Value returned for empty input.
+ * @returns {number|undefined} Parsed number or fallback.
+ */
+export function parseNumber(value, fallback = undefined) {
+  if (value === undefined || value === null || value === "") {
+    return fallback;
+  }
+
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed)) {
+    throw new Error(`Expected a number, got "${value}".`);
+  }
+
+  return parsed;
+}
+
+/**
+ * Parses a finite non-negative number.
+ * @param {unknown} value Raw value.
+ * @param {number|undefined} [fallback] Value returned for empty input.
+ * @param {string} [name="value"] Name used in validation errors.
+ * @returns {number|undefined} Parsed non-negative number or fallback.
+ */
+export function parseNonNegativeNumber(value, fallback = undefined, name = "value") {
+  const parsed = parseNumber(value, fallback);
+  if (parsed !== undefined && parsed < 0) {
+    throw new Error(`${name} must be a non-negative number.`);
+  }
+
+  return parsed;
+}
+
+/**
+ * Parses an integer.
+ * @param {unknown} value Raw value.
+ * @param {number} fallback Value returned for empty input.
+ * @returns {number} Parsed integer.
+ */
+export function parseInteger(value, fallback) {
+  const parsed = parseNumber(value, fallback);
+  if (!Number.isInteger(parsed)) {
+    throw new Error(`Expected an integer, got "${value}".`);
+  }
+
+  return parsed;
+}
+
+/**
+ * Parses a positive integer.
+ * @param {unknown} value Raw value.
+ * @param {number} fallback Value returned for empty input.
+ * @param {string} [name="value"] Name used in validation errors.
+ * @returns {number} Parsed positive integer.
+ */
+export function parsePositiveInteger(value, fallback, name = "value") {
+  const parsed = parseInteger(value, fallback);
+  if (parsed < 1) {
+    throw new Error(`${name} must be a positive integer.`);
+  }
+
+  return parsed;
+}
+
+/**
+ * Parses a JSON object input.
+ * @param {unknown} value Raw JSON string.
+ * @param {Record<string, unknown>} [fallback] Value returned for empty input.
+ * @param {string} [name="value"] Name used in validation errors.
+ * @returns {Record<string, unknown>} Parsed object.
+ */
+export function parseJsonObject(value, fallback = {}, name = "value") {
+  if (!value) {
+    return fallback;
+  }
+
+  const parsed = parseJson(value, name);
+  if (!parsed || Array.isArray(parsed) || typeof parsed !== "object") {
+    throw new Error(`${name} must be a JSON object.`);
+  }
+
+  return parsed;
+}
+
+function parseJson(value, name) {
+  try {
+    return JSON.parse(value);
+  } catch (error) {
+    throw new Error(`${name} must be a valid JSON object: ${error.message}`);
+  }
+}
+
+/**
+ * Parses comma- or newline-separated input into non-empty strings.
+ * @param {unknown} value Raw list value.
+ * @returns {string[]} Trimmed list entries.
+ */
+export function parseList(value) {
+  if (!value) {
+    return [];
+  }
+
+  return String(value)
+    .split(/[\n,]/)
+    .map((item) => item.trim())
+    .filter(Boolean);
+}
+
+/**
+ * Drops unevaluated workflow expressions so optional inputs can be copied verbatim.
+ * @param {string} value Raw input value.
+ * @returns {string} Empty string for unresolved expressions, otherwise the original value.
+ */
+export function resolvedInput(value) {
+  if (!value || value.includes("${{")) {
+    return "";
+  }
+
+  return value;
+}

package/src/jobs.js

@@ -0,0 +1,40 @@
+/**
+ * Finds a job by either its workflow job id or related check run id.
+ * @param {import("./cost.js").GitHubJob[]} jobs
+ * @param {string|number} id
+ * @returns {import("./cost.js").GitHubJob|null}
+ */
+export function findJobByWorkflowOrCheckRunId(jobs, id) {
+  return jobs.find((job) => jobMatchesWorkflowOrCheckRunId(job, id)) ?? null;
+}
+
+/**
+ * GitHub's jobs API exposes workflow job ids as `id`, while workflows expose
+ * `${{ job.check_run_id }}` as the related check run id in `check_run_url`.
+ * @param {import("./cost.js").GitHubJob} job
+ * @param {string|number} id
+ * @returns {boolean}
+ */
+export function jobMatchesWorkflowOrCheckRunId(job, id) {
+  const expectedId = String(id ?? "");
+  if (!expectedId) {
+    return false;
+  }
+
+  return String(job.id ?? "") === expectedId || checkRunIdFromUrl(job.check_run_url) === expectedId;
+}
+
+/**
+ * Extracts a check run id from a GitHub Checks API URL.
+ * @param {unknown} value URL-like value.
+ * @returns {string} Check run id, or an empty string when absent.
+ */
+export function checkRunIdFromUrl(value) {
+  try {
+    const segments = new URL(String(value ?? "")).pathname.split("/").filter(Boolean);
+    const index = segments.lastIndexOf("check-runs");
+    return index === -1 ? "" : segments[index + 1] ?? "";
+  } catch {
+    return "";
+  }
+}