@stats-organization/github-readme-stats-core 2.1.4 → 2.2.0

package/build/common/render.js

@@ -1,19 +1,25 @@
-import { getCardColors } from "./color.js";
+import { getCardColors, isPrefixedHexColor } from "./color.js";
 import { SECONDARY_ERROR_MESSAGES, TRY_AGAIN_LATER } from "./error.js";
+import { kFormatter } from "./fmt.js";
 import { encodeHTML } from "./html.js";
 import { clampValue } from "./ops.js";
 /**
  * Auto layout utility, allows us to layout things vertically or horizontally with
  * proper gaping.
  *
- * @param {object} props Function properties.
- * @param {string[]} props.items Array of items to layout.
- * @param {number} props.gap Gap between items.
- * @param {"column" | "row"=} props.direction Direction to layout items.
- * @param {number[]=} props.sizes Array of sizes for each item.
- * @returns {string[]} Array of items with proper layout.
+ * The caller must ensure that the passed `items` are properly sanitized!
+ *
+ * @param props Function properties.
+ * @param props.items Array of sanitized items to layout.
+ * @param props.gap Gap between items.
+ * @param props.direction Direction to layout items.
+ * @param props.sizes Array of sizes for each item.
+ * @returns Array of items with proper layout.
  */
-const flexLayout = ({ items, gap, direction, sizes = [] }) => {
+const flexLayout = ({ items, gap, direction, sizes = [], }) => {
+    if (sizes.some((size) => !Number.isFinite(size))) {
+        throw new Error("flexLayout: `sizes` must contain only numbers");
+    }
     let lastSize = 0;
     // filter() for filtering out empty strings
     return items.filter(Boolean).map((item, i) => {
@@ -29,40 +35,58 @@ const flexLayout = ({ items, gap, direction, sizes = [] }) => {
 /**
  * Creates a node to display the primary programming language of the repository/gist.
  *
- * @param {string} langName Language name.
- * @param {string} langColor Language color.
- * @returns {string} Language display SVG object.
+ * @param langName Language name.
+ * @param langColor Language color.
+ * @returns Language display SVG object.
  */
 const createLanguageNode = (langName, langColor) => {
+    if (!isPrefixedHexColor(langColor)) {
+        throw new Error(`Invalid language color: "${langColor}"`);
+    }
     return `
     <g data-testid="primary-lang">
       <circle data-testid="lang-color" cx="0" cy="-5" r="6" fill="${langColor}" />
-      <text data-testid="lang-name" class="gray" x="15">${langName}</text>
+      <text data-testid="lang-name" class="gray" x="15">${encodeHTML(langName)}</text>
     </g>
     `;
 };
 /**
  * Create a node to indicate progress in percentage along a horizontal line.
  *
- * @param {Object} params Object that contains the createProgressNode parameters.
- * @param {number} params.x X-axis position.
- * @param {number} params.y Y-axis position.
- * @param {number} params.width Width of progress bar.
- * @param {string} params.color Progress color.
- * @param {number} params.progress Progress value.
- * @param {string} params.progressBarBackgroundColor Progress bar bg color.
- * @param {number} params.delay Delay before animation starts.
- * @returns {string} Progress node.
+ * @param params Object that contains the createProgressNode parameters.
+ * @param params.x X-axis position.
+ * @param params.y Y-axis position.
+ * @param params.width Width of progress bar.
+ * @param params.color Optional foreground color as an inline fill fallback.
+ *   When omitted, the color must be set via a `.lang-progress` CSS rule.
+ * @param params.progress Progress value.
+ * @param params.delay Delay before animation starts.
+ * @returns Progress node.
  */
-const createProgressNode = ({ x, y, width, color, progress, progressBarBackgroundColor, delay, }) => {
+const createProgressNode = ({ x, y, width, color, progress, delay, }) => {
+    if (color !== undefined && !isPrefixedHexColor(color)) {
+        throw new Error(`Invalid progress color: "${color}"`);
+    }
+    if (!Number.isFinite(width)) {
+        throw new Error(`Invalid width: "${width}"`);
+    }
+    if (!Number.isFinite(x)) {
+        throw new Error(`Invalid x: "${x}"`);
+    }
+    if (!Number.isFinite(y)) {
+        throw new Error(`Invalid y: "${y}"`);
+    }
+    if (!Number.isFinite(delay)) {
+        throw new Error(`Invalid delay: "${delay}"`);
+    }
     const progressPercentage = clampValue(progress, 2, 100);
     return `
     <svg width="${width}" x="${x}" y="${y}">
-      <rect data-testid="progress-background" rx="5" ry="5" x="0" y="0" width="${width}" height="8" fill="${progressBarBackgroundColor}"></rect>
+      <rect data-testid="progress-background" class="progress-background" rx="5" ry="5" x="0" y="0" width="${width}" height="8"></rect>
       <svg data-testid="lang-progress" width="${progressPercentage}%">
         <rect
             height="8"
-            fill="${color}"
+            ${color === undefined ? "" : `fill="${color}"`}
             rx="5" ry="5" x="0" y="0"
             class="lang-progress"
             style="animation-delay: ${delay}ms;"
@@ -76,22 +100,37 @@ const createProgressNode = ({ x, y, width, color, progress, progressBarBackgroun
  * native, font-aware wrapping. Content overflowing `lineCount` lines is
  * clipped (with an ellipsis on the last visible line) by CSS line-clamp.
  *
- * @param {object} props Function properties.
- * @param {string} props.text Text to render (will be HTML-encoded).
- * @param {number} props.x X position of the foreignObject.
- * @param {number} props.y Y position of the foreignObject.
- * @param {number} props.width Width of the wrap box.
- * @param {number} props.height Height of the wrap box.
- * @param {number} props.lineCount Maximum number of lines to display.
- * @param {string} props.className CSS class applied to the inner element.
- * @param {string=} props.testId Optional test id for the inner element.
- * @returns {string} foreignObject SVG node.
+ * @param props Function properties.
+ * @param props.text Text to render (will be HTML-encoded).
+ * @param props.x X position of the foreignObject.
+ * @param props.y Y position of the foreignObject.
+ * @param props.width Width of the wrap box.
+ * @param props.height Height of the wrap box.
+ * @param props.lineCount Maximum number of lines to display.
+ * @param props.className CSS class applied to the inner element.
+ * @param props.testId Optional test id for the inner element.
+ * @returns foreignObject SVG node.
  */
 const wrappedTextNode = ({ text, x, y, width, height, lineCount, className, testId, }) => {
-    const testIdAttr = testId ? ` data-testid="${testId}"` : "";
+    if (!Number.isFinite(x)) {
+        throw new Error(`Invalid x: "${x}"`);
+    }
+    if (!Number.isFinite(y)) {
+        throw new Error(`Invalid y: "${y}"`);
+    }
+    if (!Number.isFinite(width)) {
+        throw new Error(`Invalid width: "${width}"`);
+    }
+    if (!Number.isFinite(height)) {
+        throw new Error(`Invalid height: "${height}"`);
+    }
+    if (!Number.isFinite(lineCount)) {
+        throw new Error(`Invalid lineCount: "${lineCount}"`);
+    }
+    const testIdAttr = testId ? ` data-testid="${encodeHTML(testId)}"` : "";
     return `
     <foreignObject x="${x}" y="${y}" width="${width}" height="${height}">
-      <div xmlns="http://www.w3.org/1999/xhtml" class="${className}" style="--lines: ${lineCount};"${testIdAttr}>${encodeHTML(text)}</div>
+      <div xmlns="http://www.w3.org/1999/xhtml" class="${encodeHTML(className)}" style="--lines: ${lineCount};"${testIdAttr}>${encodeHTML(text)}</div>
     </foreignObject>
   `;
 };
@@ -101,36 +140,46 @@ const wrappedTextNode = ({ text, x, y, width, height, lineCount, className, test
  * browser handles wrapping and the line count is taken from the `--lines`
  * custom property set on the element.
  *
- * @param {string} color Text color (CSS `color` property).
- * @returns {string} CSS rules block (without the surrounding selector).
+ * @param color Text color (CSS `color` property).
+ * @returns CSS rules block (without the surrounding selector).
  */
-const wrappedTextStyles = (color) => `
-    color: ${color};
-    margin: 0;
-    line-height: 1.2;
-    overflow-wrap: anywhere;
-    word-break: break-word;
-    display: -webkit-box;
-    -webkit-box-orient: vertical;
-    -webkit-line-clamp: var(--lines);
-    line-clamp: var(--lines);
-    overflow: hidden;
-    text-overflow: ellipsis;
-    padding-bottom: 0.15em;
-`;
+const wrappedTextStyles = (color) => {
+    if (!isPrefixedHexColor(color)) {
+        throw new Error(`Invalid text color: "${color}"`);
+    }
+    return `
+      color: ${color};
+      margin: 0;
+      line-height: 1.2;
+      overflow-wrap: anywhere;
+      word-break: break-word;
+      display: -webkit-box;
+      -webkit-box-orient: vertical;
+      -webkit-line-clamp: var(--lines);
+      line-clamp: var(--lines);
+      overflow: hidden;
+      text-overflow: ellipsis;
+      padding-bottom: 0.15em;
+  `;
+};
 /**
  * Creates an icon with label to display repository/gist stats like forks, stars, etc.
  *
- * @param {string} icon The icon to display.
- * @param {number|string} label The label to display.
- * @param {string} testid The testid to assign to the label.
- * @param {number} iconSize The size of the icon.
- * @returns {string} Icon with label SVG object.
+ * The caller must ensure that the passed `icon` is properly sanitized!
+ *
+ * @param icon The sanitized icon to display.
+ * @param label The label to display.
+ * @param testid The testid to assign to the label.
+ * @param iconSize The size of the icon.
+ * @returns Icon with label SVG object.
  */
 const iconWithLabel = (icon, label, testid, iconSize) => {
     if (typeof label === "number" && label <= 0) {
         return "";
     }
+    if (!Number.isFinite(iconSize)) {
+        throw new Error(`Invalid iconSize: "${iconSize}"`);
+    }
     const iconSvg = `
       <svg
         class="icon"
@@ -143,9 +192,78 @@ const iconWithLabel = (icon, label, testid, iconSize) => {
         ${icon}
       </svg>
     `;
-    const text = `<text data-testid="${testid}" class="gray">${label}</text>`;
+    const text = `<text data-testid="${encodeHTML(testid)}" class="gray">${encodeHTML(String(label))}</text>`;
     return flexLayout({ items: [iconSvg, text], gap: 20 }).join("");
 };
+/**
+ * Create a labelled stat text item
+ * (a label and its value, optionally with an icon and link).
+ * Shared by the stats and repo cards.
+ *
+ * The caller must ensure that the passed `icon` and `link` are properly sanitized!
+ *
+ * @param params Object that contains the createTextNode parameters.
+ * @param params.icon The sanitized icon to display.
+ * @param params.label The label to display.
+ * @param params.value The value to display.
+ * @param params.id The id of the stat.
+ * @param params.unitSymbol The unit symbol of the stat.
+ * @param params.index The index of the stat.
+ * @param params.showIcons Whether to show icons.
+ * @param params.shiftValuePos Number of pixels the value has to be shifted to the right.
+ * @param params.bold Whether to bold the label.
+ * @param params.numberFormat The format of numbers on card.
+ * @param params.numberPrecision The precision of numbers on card.
+ * @param params.link Sanitized url to link to.
+ * @param params.labelXOffset horizontal offset for label.
+ * @returns The stats card text item SVG object.
+ */
+const createTextNode = ({ icon, label, value, id, unitSymbol, index, showIcons, shiftValuePos, bold, numberFormat, numberPrecision, link, labelXOffset = 25, }) => {
+    if (!Number.isFinite(labelXOffset)) {
+        throw new Error(`Invalid labelXOffset: "${labelXOffset}"`);
+    }
+    if (!Number.isFinite(shiftValuePos)) {
+        throw new Error(`Invalid shiftValuePos: "${shiftValuePos}"`);
+    }
+    if (!Number.isFinite(index)) {
+        throw new Error(`Invalid index: "${index}"`);
+    }
+    const precision = numberPrecision !== undefined && Number.isFinite(numberPrecision)
+        ? clampValue(numberPrecision, 0, 2)
+        : undefined;
+    // `long` format and the percentage stat keep the raw value; everything else
+    // (always a number here) is abbreviated via kFormatter.
+    const rawValue = numberFormat.toLowerCase() === "long" || id === "prs_merged_percentage";
+    const kValue = rawValue || typeof value !== "number"
+        ? value
+        : kFormatter(value, precision);
+    const staggerDelay = (index + 3) * 150;
+    const boldClass = bold ? " bold" : "not_bold";
+    const valueX = (showIcons ? 140 : 120) + (bold ? 5 : 0) + shiftValuePos;
+    const unit = unitSymbol ? ` ${unitSymbol}` : "";
+    const labelOffset = showIcons ? `x="${labelXOffset}"` : "";
+    const iconSvg = showIcons
+        ? `
+    <svg data-testid="icon" class="icon" viewBox="0 0 16 16" version="1.1" width="16" height="16">
+      ${icon}
+    </svg>
+  `
+        : "";
+    const content = `
+      ${iconSvg}
+      <text class="stat ${boldClass}" ${labelOffset} y="12.5">${encodeHTML(label)}:</text>
+      <text
+        class="stat ${boldClass}"
+        x="${valueX}"
+        y="12.5"
+        data-testid="${id}"
+      >${kValue}${unit}</text>`;
+    const inner = link ? `<a href="${link}">${content}</a>` : content;
+    return `
+    <g class="stagger" style="animation-delay: ${staggerDelay}ms" transform="translate(25, 0)">${inner}
+    </g>
+  `;
+};
 // Script parameters.
 const ERROR_CARD_LENGTH = 576.5;
 const UPSTREAM_API_ERRORS = [
@@ -155,21 +273,20 @@ const UPSTREAM_API_ERRORS = [
 /**
  * Renders error message on the card.
  *
- * @param {object} args Function arguments.
- * @param {string} args.message Main error message.
- * @param {string} [args.secondaryMessage=""] The secondary error message.
- * @param {object} [args.renderOptions={}] Render options.
- * @param {string=} args.renderOptions.title_color Card title color.
- * @param {string=} args.renderOptions.text_color Card text color.
- * @param {string=} args.renderOptions.bg_color Card background color.
- * @param {string=} args.renderOptions.border_color Card border color.
- * @param {Parameters<typeof getCardColors>[0]["theme"]=} args.renderOptions.theme Card theme.
- * @param {boolean=} args.renderOptions.show_repo_link Whether to show repo link or not.
- * @returns {string} The SVG markup.
+ * @param args Function arguments.
+ * @param args.message Main error message.
+ * @param args.secondaryMessage The secondary error message.
+ * @param args.renderOptions Render options.
+ * @param args.renderOptions.title_color Card title color.
+ * @param args.renderOptions.text_color Card text color.
+ * @param args.renderOptions.bg_color Card background color.
+ * @param args.renderOptions.border_color Card border color.
+ * @param args.renderOptions.theme Card theme.
+ * @param args.renderOptions.show_repo_link Whether to show repo link or not.
+ * @returns The SVG markup.
  */
 const renderError = ({ message, secondaryMessage = "", renderOptions = {}, }) => {
     const { title_color, text_color, bg_color, border_color, theme = "default", show_repo_link = true, } = renderOptions;
-    // returns theme based colors with proper overrides and defaults
     const { titleColor, textColor, bgColor, borderColor } = getCardColors({
         title_color,
         text_color,
@@ -180,19 +297,19 @@ const renderError = ({ message, secondaryMessage = "", renderOptions = {}, }) =>
         theme,
     });
     return `
-    <svg width="${ERROR_CARD_LENGTH}"  height="120" viewBox="0 0 ${ERROR_CARD_LENGTH} 120" fill="${bgColor}" xmlns="http://www.w3.org/2000/svg">
+    <svg width="${ERROR_CARD_LENGTH}"  height="120" viewBox="0 0 ${ERROR_CARD_LENGTH} 120" fill="${String(bgColor)}" xmlns="http://www.w3.org/2000/svg">
     <style>
     .text { font: 600 16px 'Segoe UI', Ubuntu, Sans-Serif; fill: ${titleColor} }
     .small { font: 600 12px 'Segoe UI', Ubuntu, Sans-Serif; fill: ${textColor} }
     .gray { fill: #858585 }
     </style>
-    <rect x="0.5" y="0.5" width="${ERROR_CARD_LENGTH - 1}" height="99%" rx="4.5" fill="${bgColor}" stroke="${borderColor}"/>
+    <rect x="0.5" y="0.5" width="${ERROR_CARD_LENGTH - 1}" height="99%" rx="4.5" fill="${String(bgColor)}" stroke="${borderColor}"/>
     <text x="25" y="45" class="text">Something went wrong!${UPSTREAM_API_ERRORS.includes(secondaryMessage) || !show_repo_link
         ? ""
         : " file an issue at https://tinyurl.com/github-stats"}</text>
     <text data-testid="message" x="25" y="55" class="text small">
       <tspan x="25" dy="18">${encodeHTML(message)}</tspan>
-      <tspan x="25" dy="18" class="gray">${secondaryMessage}</tspan>
+      <tspan x="25" dy="18" class="gray">${encodeHTML(secondaryMessage)}</tspan>
     </text>
     </svg>
   `;
@@ -201,9 +318,9 @@ const renderError = ({ message, secondaryMessage = "", renderOptions = {}, }) =>
  * Retrieve text length based on Segoe UI font.
  *
  * @see https://stackoverflow.com/a/48172630/10629172
- * @param {string} str String to measure.
- * @param {number} fontSize Font size.
- * @returns {number} Text length.
+ * @param str String to measure.
+ * @param fontSize Font size.
+ * @returns Text length.
  */
 const measureText = (str, fontSize = 10) => {
     // prettier-ignore
@@ -254,7 +371,7 @@ const measureText = (str, fontSize = 10) => {
             return 1;
         }
         if (c.charCodeAt(0) < widths.length) {
-            return widths[c.charCodeAt(0)];
+            return widths[c.charCodeAt(0)] ?? avg;
         }
         else {
             return avg;
@@ -269,10 +386,10 @@ const measureText = (str, fontSize = 10) => {
  * The browser still does the real wrap inside the foreignObject; this is only
  * used to size the SVG.
  *
- * @param {string} text Text to split.
- * @param {number} fontSize Font size in px (matches `measureText`).
- * @param {number} maxWidth Available wrap width in px.
- * @returns {string[]} Estimated wrapped lines.
+ * @param text Text to split.
+ * @param fontSize Font size in px (matches `measureText`).
+ * @param maxWidth Available wrap width in px.
+ * @returns Estimated wrapped lines.
  */
 const splitWrappedText = (text, fontSize, maxWidth) => {
     if (!text) {
@@ -288,8 +405,8 @@ const splitWrappedText = (text, fontSize, maxWidth) => {
     // Korean Hangul (U+AC00–U+D7AF) is intentionally NOT in the CJK range
     // because Korean wraps at word boundaries by default in HTML.
     // ASCII whitespace is collapsed to a single space per CSS `white-space: normal;`
-    text = text.replace(/[\t\n\r ]+/g, " ");
-    const tokens = text.match(/\s|[\u3000-\u9FFF\uFF00-\uFFEF]|[^\s\u3000-\u9FFF\uFF00-\uFFEF]+/g);
+    const normalizedText = text.replace(/[\t\n\r ]+/g, " ");
+    const tokens = normalizedText.match(/\s|[\u3000-\u9FFF\uFF00-\uFFEF]|[^\s\u3000-\u9FFF\uFF00-\uFFEF]+/g);
     if (!tokens) {
         return [];
     }
@@ -318,7 +435,7 @@ const splitWrappedText = (text, fontSize, maxWidth) => {
             if (currentWidth === 0) {
                 continue;
             }
-            lines[lines.length - 1] += token;
+            lines[lines.length - 1] = (lines[lines.length - 1] ?? "") + token;
             currentWidth += measureText(token, fontSize);
             continue;
         }
@@ -326,7 +443,7 @@ const splitWrappedText = (text, fontSize, maxWidth) => {
         while (remaining) {
             const w = measureText(remaining, fontSize);
             if (currentWidth + w <= maxWidth) {
-                lines[lines.length - 1] += remaining;
+                lines[lines.length - 1] = (lines[lines.length - 1] ?? "") + remaining;
                 currentWidth += w;
                 break;
             }
@@ -337,7 +454,7 @@ const splitWrappedText = (text, fontSize, maxWidth) => {
             }
             // An atom wider than the box wraps mid-glyph (overflow-wrap: anywhere).
             const { segment, width } = takeFittingSegment(remaining, maxWidth);
-            lines[lines.length - 1] += segment;
+            lines[lines.length - 1] = (lines[lines.length - 1] ?? "") + segment;
             currentWidth = width;
             remaining = remaining.slice(segment.length);
         }
@@ -348,13 +465,13 @@ const splitWrappedText = (text, fontSize, maxWidth) => {
  * Estimate how many lines a string will wrap to when laid out greedily at the
  * given font size inside a box of width `maxWidth`, capped at `maxLines`.
  *
- * @param {string} text Text to estimate.
- * @param {number} fontSize Font size in px (matches `measureText`).
- * @param {number} maxWidth Available wrap width in px.
- * @param {number} maxLines Cap on the returned line count.
- * @returns {number} Estimated line count, at least 1, at most `maxLines`.
+ * @param text Text to estimate.
+ * @param fontSize Font size in px (matches `measureText`).
+ * @param maxWidth Available wrap width in px.
+ * @param maxLines Cap on the returned line count.
+ * @returns Estimated line count, at least 1, at most `maxLines`.
  */
 const countWrappedLines = (text, fontSize, maxWidth, maxLines) => {
     return Math.min(Math.max(1, splitWrappedText(text, fontSize, maxWidth).length), maxLines);
 };
-export { renderError, createLanguageNode, createProgressNode, iconWithLabel, flexLayout, measureText, splitWrappedText, countWrappedLines, wrappedTextNode, wrappedTextStyles, };
+export { renderError, createLanguageNode, createProgressNode, createTextNode, iconWithLabel, flexLayout, measureText, splitWrappedText, countWrappedLines, wrappedTextNode, wrappedTextStyles, };

package/build/common/retryer.d.ts

@@ -1,25 +1,34 @@
 import type { AxiosResponse } from "axios";
 /**
- * Subset of the response payload the retryer inspects to detect
- * rate-limiting and credential failures.
+ * Error-detection fields the retryer inspects to detect rate-limiting and credential failures.
+ * Every fetcher's payload is intersected with
+ * this, so the retryer can read `errors`/`message` regardless of the payload's own shape.
  */
-interface ResponseData {
+interface ResponseErrors {
     errors?: Array<{
         type?: string;
         message?: string;
     }>;
     message?: string;
 }
-type FetcherResponse = AxiosResponse<ResponseData>;
-type FetcherFunction = (variables: Record<string, unknown>, token: string, retriesForTests?: number) => Promise<FetcherResponse>;
+/**
+ * A fetcher's Axios response. `TData` is the shape of `response.data`,
+ * which is intersected with {@link ResponseErrors} so the retryer can inspect
+ * `errors`/`message`.
+ * Defaults to `unknown` (error fields only) for callers that don't care about the payload.
+ */
+type FetcherResponse<TData = unknown> = AxiosResponse<TData & ResponseErrors>;
+type FetcherFunction<TData = unknown, TVariables = Record<string, unknown>> = (variables: TVariables, token: string, retriesForTests?: number) => Promise<FetcherResponse<TData>>;
 /**
  * Try to execute the fetcher function until it succeeds or the max number of retries is reached.
  *
+ * @template TData Shape of `response.data` returned by the fetcher.
+ * @template TVariables Variables the fetcher accepts.
  * @param fetcher The fetcher function.
  * @param variables Object with arguments to pass to the fetcher function.
  * @param pat Optional PAT override.
  * @returns The response from the fetcher function.
  */
-declare const retryer: (fetcher: FetcherFunction, variables: Record<string, unknown>, pat?: string | null) => Promise<FetcherResponse>;
+declare const retryer: <TData = unknown, TVariables = Record<string, unknown>>(fetcher: FetcherFunction<TData, TVariables>, variables: TVariables, pat?: string | null) => Promise<FetcherResponse<TData>>;
 export { retryer };
 //# sourceMappingURL=retryer.d.ts.map

package/build/common/retryer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retryer.d.ts","sourceRoot":"","sources":["../../src/common/retryer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAM3C;;;GAGG;AACH,UAAU,YAAY;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgBD,KAAK,eAAe,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;AAEnD,KAAK,eAAe,GAAG,CACrB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,MAAM,KACrB,OAAO,CAAC,eAAe,CAAC,CAAC;AAE9B;;;;;;;GAOG;AACH,QAAA,MAAM,OAAO,GACX,SAAS,eAAe,EACxB,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,MAAK,MAAM,GAAG,IAAW,KACxB,OAAO,CAAC,eAAe,CAiEzB,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"retryer.d.ts","sourceRoot":"","sources":["../../src/common/retryer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAM3C;;;;GAIG;AACH,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAgBD;;;;;GAKG;AACH,KAAK,eAAe,CAAC,KAAK,GAAG,OAAO,IAAI,aAAa,CAAC,KAAK,GAAG,cAAc,CAAC,CAAC;AAE9E,KAAK,eAAe,CAAC,KAAK,GAAG,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAC5E,SAAS,EAAE,UAAU,EACrB,KAAK,EAAE,MAAM,EACb,eAAe,CAAC,EAAE,MAAM,KACrB,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;AAErC;;;;;;;;;GASG;AACH,QAAA,MAAM,OAAO,GAAU,KAAK,GAAG,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,SAAS,eAAe,CAAC,KAAK,EAAE,UAAU,CAAC,EAC3C,WAAW,UAAU,EACrB,MAAK,MAAM,GAAG,IAAW,KACxB,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAiEhC,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/build/common/retryer.js

@@ -17,6 +17,8 @@ function getRandomInt(max) {
 /**
  * Try to execute the fetcher function until it succeeds or the max number of retries is reached.
  *
+ * @template TData Shape of `response.data` returned by the fetcher.
+ * @template TVariables Variables the fetcher accepts.
  * @param fetcher The fetcher function.
  * @param variables Object with arguments to pass to the fetcher function.
  * @param pat Optional PAT override.

package/build/fetchers/gist.d.ts

@@ -1,26 +1,11 @@
-/**
- * Gist file.
- */
-export type GistFile = {
-    name: string;
-    language: {
-        name: string;
-    };
-    size: number;
-};
-/**
- * Gist data.
- */
-export type GistData = any;
-/**
- * @typedef {import('./types').GistData} GistData Gist data.
- */
+import type { GistData } from "./types.js";
 /**
  * Fetch GitHub gist information by given username and ID.
  *
- * @param {string} id GitHub gist ID.
- * @param {string | null} pat Optional PAT override.
- * @returns {Promise<GistData>} Gist data.
+ * @param id GitHub gist ID.
+ * @param pat Optional PAT override.
+ * @returns Gist data.
  */
-export function fetchGist(id: string, pat?: string | null): Promise<GistData>;
+declare const fetchGist: (id: string, pat?: string | null) => Promise<GistData>;
+export { fetchGist };
 //# sourceMappingURL=gist.d.ts.map

package/build/fetchers/gist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gist.d.ts","sourceRoot":"","sources":["../../src/fetchers/gist.js"],"names":[],"mappings":";;;uBA2Ca;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;KAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;;;;;AAiCxE;;GAEG;AAEH;;;;;;GAMG;AACH,8BAJW,MAAM,QACN,MAAM,GAAG,IAAI,GACX,OAAO,CAAC,QAAQ,CAAC,CAwB7B"}
+{"version":3,"file":"gist.d.ts","sourceRoot":"","sources":["../../src/fetchers/gist.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkC3C;;;;;;GAMG;AACH,QAAA,MAAM,SAAS,GACb,IAAI,MAAM,EACV,MAAK,MAAM,GAAG,IAAW,KACxB,OAAO,CAAC,QAAQ,CA0BlB,CAAC;AAEF,OAAO,EAAE,SAAS,EAAE,CAAC"}