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

package/build/common/color.d.ts

@@ -1,53 +1,43 @@
+/**
+ * Retrieves a gradient if color has more than one valid hex codes else a single color.
+ *
+ * @param color The color to parse.
+ * @param fallbackColor The fallback color.
+ * @returns The gradient or color.
+ */
+declare const fallbackColor: (color: string | undefined, fallbackColor: string | Array<string>) => string | Array<string>;
 /**
  * Object containing card colors.
  */
-export type CardColors = {
+interface CardColors {
     titleColor: string;
     iconColor: string;
     textColor: string;
-    bgColor: string | string[];
+    bgColor: string | Array<string>;
     borderColor: string;
     ringColor: string;
-};
-/**
- * Retrieves a gradient if color has more than one valid hex codes else a single color.
- *
- * @param {string} color The color to parse.
- * @param {string | string[]} fallbackColor The fallback color.
- * @returns {string | string[]} The gradient or color.
- */
-export function fallbackColor(color: string, fallbackColor: string | string[]): string | string[];
-/**
- * Object containing card colors.
- * @typedef {{
- *  titleColor: string;
- *  iconColor: string;
- *  textColor: string;
- *  bgColor: string | string[];
- *  borderColor: string;
- *  ringColor: string;
- * }} CardColors
- */
+}
 /**
  * Returns theme based colors with proper overrides and defaults.
  *
- * @param {Object} args Function arguments.
- * @param {string=} args.title_color Card title color.
- * @param {string=} args.text_color Card text color.
- * @param {string=} args.icon_color Card icon color.
- * @param {string=} args.bg_color Card background color.
- * @param {string=} args.border_color Card border color.
- * @param {string=} args.ring_color Card ring color.
- * @param {string=} args.theme Card theme.
- * @returns {CardColors} Card colors.
+ * @param props Function arguments.
+ * @param props.title_color Card title color.
+ * @param props.text_color Card text color.
+ * @param props.icon_color Card icon color.
+ * @param props.bg_color Card background color.
+ * @param props.border_color Card border color.
+ * @param props.ring_color Card ring color.
+ * @param props.theme Card theme.
+ * @returns Card colors.
  */
-export function getCardColors({ title_color, text_color, icon_color, bg_color, border_color, ring_color, theme, }: {
-    title_color?: string | undefined;
-    text_color?: string | undefined;
-    icon_color?: string | undefined;
-    bg_color?: string | undefined;
-    border_color?: string | undefined;
-    ring_color?: string | undefined;
-    theme?: string | undefined;
-}): CardColors;
+declare const getCardColors: ({ title_color, text_color, icon_color, bg_color, border_color, ring_color, theme, }: {
+    title_color?: string;
+    text_color?: string;
+    icon_color?: string;
+    bg_color?: string;
+    border_color?: string;
+    ring_color?: string;
+    theme?: string;
+}) => CardColors;
+export { fallbackColor, getCardColors };
 //# sourceMappingURL=color.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/common/color.js"],"names":[],"mappings":";;;yBAoDa;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CAClB;AA9BJ;;;;;;GAMG;AACH,qCAJW,MAAM,iBACN,MAAM,GAAG,MAAM,EAAE,GACf,MAAM,GAAG,MAAM,EAAE,CAc7B;AAED;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;GAYG;AACH,mHATG;IAAsB,WAAW,GAAzB,MAAM,YAAC;IACO,UAAU,GAAxB,MAAM,YAAC;IACO,UAAU,GAAxB,MAAM,YAAC;IACO,QAAQ,GAAtB,MAAM,YAAC;IACO,YAAY,GAA1B,MAAM,YAAC;IACO,UAAU,GAAxB,MAAM,YAAC;IACO,KAAK,GAAnB,MAAM,YAAC;CACf,GAAU,UAAU,CAqEtB"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/common/color.ts"],"names":[],"mappings":"AA2BA;;;;;;GAMG;AACH,QAAA,MAAM,aAAa,GACjB,OAAO,MAAM,GAAG,SAAS,EACzB,eAAe,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KACpC,MAAM,GAAG,KAAK,CAAC,MAAM,CAWvB,CAAC;AAEF;;GAEG;AACH,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,aAAa,GAAI,qFAQpB;IACD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,KAAG,UAuDH,CAAC;AAEF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC"}

package/build/common/color.js

@@ -1,10 +1,9 @@
-// @ts-check
 import { themes } from "../themes/index.js";
 /**
  * Checks if a string is a valid hex color.
  *
- * @param {string} hexColor String to check.
- * @returns {boolean} True if the given string is a valid hex color.
+ * @param hexColor String to check.
+ * @returns True if the given string is a valid hex color.
  */
 const isValidHexColor = (hexColor) => {
     return new RegExp(/^([A-Fa-f0-9]{8}|[A-Fa-f0-9]{6}|[A-Fa-f0-9]{3}|[A-Fa-f0-9]{4})$/).test(hexColor);
@@ -12,8 +11,8 @@ const isValidHexColor = (hexColor) => {
 /**
  * Check if the given string is a valid gradient.
  *
- * @param {string[]} colors Array of colors.
- * @returns {boolean} True if the given string is a valid gradient.
+ * @param colors Array of colors.
+ * @returns True if the given string is a valid gradient.
  */
 const isValidGradient = (colors) => {
     return (colors.length > 2 &&
@@ -22,60 +21,49 @@ const isValidGradient = (colors) => {
 /**
  * Retrieves a gradient if color has more than one valid hex codes else a single color.
  *
- * @param {string} color The color to parse.
- * @param {string | string[]} fallbackColor The fallback color.
- * @returns {string | string[]} The gradient or color.
+ * @param color The color to parse.
+ * @param fallbackColor The fallback color.
+ * @returns The gradient or color.
  */
 const fallbackColor = (color, fallbackColor) => {
-    let gradient = null;
-    let colors = color ? color.split(",") : [];
+    const colors = color ? color.split(",") : [];
     if (colors.length > 1 && isValidGradient(colors)) {
-        gradient = colors;
+        return colors;
     }
-    return ((gradient ? gradient : isValidHexColor(color) && `#${color}`) ||
-        fallbackColor);
+    if (color !== undefined && isValidHexColor(color)) {
+        return `#${color}`;
+    }
+    return fallbackColor;
 };
-/**
- * Object containing card colors.
- * @typedef {{
- *  titleColor: string;
- *  iconColor: string;
- *  textColor: string;
- *  bgColor: string | string[];
- *  borderColor: string;
- *  ringColor: string;
- * }} CardColors
- */
 /**
  * Returns theme based colors with proper overrides and defaults.
  *
- * @param {Object} args Function arguments.
- * @param {string=} args.title_color Card title color.
- * @param {string=} args.text_color Card text color.
- * @param {string=} args.icon_color Card icon color.
- * @param {string=} args.bg_color Card background color.
- * @param {string=} args.border_color Card border color.
- * @param {string=} args.ring_color Card ring color.
- * @param {string=} args.theme Card theme.
- * @returns {CardColors} Card colors.
+ * @param props Function arguments.
+ * @param props.title_color Card title color.
+ * @param props.text_color Card text color.
+ * @param props.icon_color Card icon color.
+ * @param props.bg_color Card background color.
+ * @param props.border_color Card border color.
+ * @param props.ring_color Card ring color.
+ * @param props.theme Card theme.
+ * @returns Card colors.
  */
 const getCardColors = ({ title_color, text_color, icon_color, bg_color, border_color, ring_color, theme, }) => {
-    const defaultTheme = themes["default"];
-    const isThemeProvided = theme !== null && theme !== undefined && theme in themes;
-    // @ts-ignore
-    const selectedTheme = isThemeProvided ? themes[theme] : defaultTheme;
+    const defaultTheme = themes.default;
+    const isThemeProvided = theme !== undefined && theme in themes;
+    const selectedTheme = isThemeProvided
+        ? themes[theme]
+        : defaultTheme;
     const defaultBorderColor = "border_color" in selectedTheme
         ? selectedTheme.border_color
-        : // @ts-ignore
-            defaultTheme.border_color;
+        : defaultTheme.border_color;
     // get the color provided by the user else the theme color
     // finally if both colors are invalid fallback to default theme
     const titleColor = fallbackColor(title_color || selectedTheme.title_color, "#" + defaultTheme.title_color);
     // get the color provided by the user else the theme color
     // finally if both colors are invalid we use the titleColor
-    const ringColor = fallbackColor(
-    // @ts-ignore
-    ring_color || selectedTheme.ring_color, titleColor);
+    // NOTE: no built-in theme defines `ring_color`, so it falls back to the title color.
+    const ringColor = fallbackColor(ring_color, titleColor);
     const iconColor = fallbackColor(icon_color || selectedTheme.icon_color, "#" + defaultTheme.icon_color);
     const textColor = fallbackColor(text_color || selectedTheme.text_color, "#" + defaultTheme.text_color);
     const bgColor = fallbackColor(bg_color || selectedTheme.bg_color, "#" + defaultTheme.bg_color);

package/build/common/config.d.ts

@@ -1,3 +1,19 @@
-export function loadConfigFromEnv(env?: Record<string, string | undefined>): void;
-export function getConfig(): any;
+type Env = Record<string, string | undefined>;
+interface PersonalAccessToken {
+    name: string;
+    value: string;
+}
+interface Config {
+    whitelist: Array<string> | undefined;
+    gistWhitelist: Array<string> | undefined;
+    excludeRepositories: Array<string>;
+    fetchMultiPageStars: string | undefined;
+    pats: Array<PersonalAccessToken>;
+}
+/**
+ * @param env Environment variables used to build the runtime config.
+ */
+export declare const loadConfigFromEnv: (env?: Env) => void;
+export declare const getConfig: () => Config;
+export {};
 //# sourceMappingURL=config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/common/config.js"],"names":[],"mappings":"AA6DO,wCAFI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,QAc5C;AAIM,iCAAqC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/common/config.ts"],"names":[],"mappings":"AAAA,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9C,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,MAAM;IACd,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACrC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACzC,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;CAClC;AAkDD;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAK,GAAqB,KAAG,IAY9D,CAAC;AAIF,eAAO,MAAM,SAAS,QAAO,MAAuB,CAAC"}

package/build/common/config.js

@@ -1,7 +1,6 @@
-// @ts-check
 /**
- * @param {string | undefined} value Comma-separated string.
- * @returns {string[] | undefined} Parsed string values.
+ * @param value Comma-separated string.
+ * @returns Parsed string values.
  */
 const parseCsv = (value) => {
     if (!value) {
@@ -10,58 +9,50 @@ const parseCsv = (value) => {
     return value.split(",");
 };
 /**
- * @param {Record<string, string | undefined>} env Environment variables to inspect.
- * @returns {{name: string, value: string}[]} Personal access tokens found in the environment.
+ * @param env Environment variables to inspect.
+ * @returns Personal access tokens found in the environment.
  */
 const parsePATsFromEnv = (env) => {
     return Object.keys(env)
         .filter((key) => /PAT_\d*$/.exec(key))
         .map((name) => ({
         name,
-        value: env[name],
+        value: env[name] ?? "",
     }));
 };
 /**
- * @returns {Record<string, string | undefined>} `process.env` if available, otherwise `{}`.
+ * @returns `process.env` if available, otherwise `{}`.
  */
 const getDefaultEnv = () => {
-    if (typeof process !== "undefined" && process?.env) {
-        return process.env;
-    }
-    return {};
+    const processEnv = globalThis.process?.env;
+    return processEnv ?? {};
 };
 /**
- * @param {Partial<ReturnType<typeof loadConfigFromEnv>>} config (Partial) config values to normalize.
- * @returns {{
- *   whitelist: string[] | undefined,
- *   gistWhitelist: string[] | undefined,
- *   excludeRepositories: string[],
- *   fetchMultiPageStars: string | undefined,
- *   pats: {name: string, value: string}[],
- * }} Normalized config object with defaults applied.
+ * @param config (Partial) config values to normalize.
+ * @returns Normalized config object with defaults applied.
  */
 const normalizeConfig = (config = {}) => {
     return {
         whitelist: config.whitelist,
         gistWhitelist: config.gistWhitelist,
-        excludeRepositories: config.excludeRepositories || [],
+        excludeRepositories: config.excludeRepositories ?? [],
         fetchMultiPageStars: config.fetchMultiPageStars,
-        pats: config.pats || [],
+        pats: config.pats ?? [],
     };
 };
 let currentConfig;
 /**
- * @param {Record<string, string | undefined>} env Environment variables used to build the runtime config.
+ * @param env Environment variables used to build the runtime config.
  */
 export const loadConfigFromEnv = (env = getDefaultEnv()) => {
-    const whitelist = parseCsv(env.WHITELIST);
-    const gistWhitelist = parseCsv(env.GIST_WHITELIST);
-    const excludeRepositories = parseCsv(env.EXCLUDE_REPO) || [];
+    const whitelist = parseCsv(env["WHITELIST"]);
+    const gistWhitelist = parseCsv(env["GIST_WHITELIST"]);
+    const excludeRepositories = parseCsv(env["EXCLUDE_REPO"]) ?? [];
     currentConfig = normalizeConfig({
         whitelist,
         gistWhitelist,
         excludeRepositories,
-        fetchMultiPageStars: env.FETCH_MULTI_PAGE_STARS,
+        fetchMultiPageStars: env["FETCH_MULTI_PAGE_STARS"],
         pats: parsePATsFromEnv(env),
     });
 };

package/build/common/constants.d.ts

@@ -1,6 +1,6 @@
 /**
  * Valid owner affiliations for GitHub API queries.
- * @type {Array<string>}
  */
-export const OWNER_AFFILIATIONS: Array<string>;
+declare const OWNER_AFFILIATIONS: Array<string>;
+export { OWNER_AFFILIATIONS };
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/common/constants.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,iCAFU,KAAK,CAAC,MAAM,CAAC,CAEqD"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAIrC,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/build/common/constants.js

@@ -1,7 +1,9 @@
-// @ts-check
 /**
  * Valid owner affiliations for GitHub API queries.
- * @type {Array<string>}
  */
-const OWNER_AFFILIATIONS = ["OWNER", "COLLABORATOR", "ORGANIZATION_MEMBER"];
+const OWNER_AFFILIATIONS = [
+    "OWNER",
+    "COLLABORATOR",
+    "ORGANIZATION_MEMBER",
+];
 export { OWNER_AFFILIATIONS };

package/build/common/error.d.ts

@@ -1,7 +1,32 @@
+/**
+ * A general message to ask user to try again later.
+ */
+declare const TRY_AGAIN_LATER = "Please try again later";
+/**
+ * A map of error types to secondary error messages.
+ */
+declare const SECONDARY_ERROR_MESSAGES: {
+    MAX_RETRY: string;
+    NO_TOKENS: string;
+    USER_NOT_FOUND: string;
+    GRAPHQL_ERROR: string;
+    GITHUB_REST_API_ERROR: string;
+    WAKATIME_USER_NOT_FOUND: string;
+    INVALID_AFFILIATION: string;
+};
 /**
  * Custom error class to handle custom GRS errors.
  */
-export class CustomError extends Error {
+declare class CustomError extends Error {
+    type: string;
+    secondaryMessage: string;
+    /**
+     * Custom error constructor.
+     *
+     * @param message Error message.
+     * @param type Error type.
+     */
+    constructor(message: string, type: string);
     static MAX_RETRY: string;
     static NO_TOKENS: string;
     static USER_NOT_FOUND: string;
@@ -9,45 +34,27 @@ export class CustomError extends Error {
     static GITHUB_REST_API_ERROR: string;
     static WAKATIME_ERROR: string;
     static INVALID_AFFILIATION: string;
-    /**
-     * Custom error constructor.
-     *
-     * @param {string} message Error message.
-     * @param {string} type Error type.
-     */
-    constructor(message: string, type: string);
-    type: string;
-    secondaryMessage: string;
 }
 /**
  * Missing query parameter class.
  */
-export class MissingParamError extends Error {
+declare class MissingParamError extends Error {
+    missedParams: Array<string>;
+    secondaryMessage: string | undefined;
     /**
      * Missing query parameter error constructor.
      *
-     * @param {string[]} missedParams An array of missing parameters names.
-     * @param {string=} secondaryMessage Optional secondary message to display.
+     * @param missedParams An array of missing parameters names.
+     * @param secondaryMessage Optional secondary message to display.
      */
-    constructor(missedParams: string[], secondaryMessage?: string | undefined);
-    missedParams: string[];
-    secondaryMessage: string | undefined;
+    constructor(missedParams: Array<string>, secondaryMessage?: string);
 }
-/**
- * @type {Object<string, string>} A map of error types to secondary error messages.
- */
-export const SECONDARY_ERROR_MESSAGES: {
-    [x: string]: string;
-};
-/**
- * @type {string} A general message to ask user to try again later.
- */
-export const TRY_AGAIN_LATER: string;
 /**
  * Retrieve secondary message from an error object.
  *
- * @param {Error} err The error object.
- * @returns {string|undefined} The secondary message if available, otherwise undefined.
+ * @param err The error object.
+ * @returns The secondary message if available, otherwise undefined.
  */
-export function retrieveSecondaryMessage(err: Error): string | undefined;
+declare const retrieveSecondaryMessage: (err: Error) => string | undefined;
+export { CustomError, MissingParamError, SECONDARY_ERROR_MESSAGES, TRY_AGAIN_LATER, retrieveSecondaryMessage, };
 //# sourceMappingURL=error.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/common/error.js"],"names":[],"mappings":"AA0BA;;GAEG;AACH;IAaE,yBAA+B;IAC/B,yBAA+B;IAC/B,8BAAyC;IACzC,6BAAuC;IACvC,qCAAuD;IACvD,8BAAyC;IACzC,mCAAmD;IAlBnD;;;;;OAKG;IACH,qBAHW,MAAM,QACN,MAAM,EAMhB;IAFC,aAAgB;IAChB,yBAA8D;CAUjE;AAED;;GAEG;AACH;IACE;;;;;OAKG;IACH,0BAHW,MAAM,EAAE,qBACR,MAAM,YAAC,EASjB;IAFC,uBAAgC;IAChC,qCAAwC;CAE3C;AA5DD;;GAEG;AACH;;EAYE;AApBF;;GAEG;AACH,8BAFU,MAAM,CAEiC;AAgEjD;;;;;GAKG;AACH,8CAHW,KAAK,GACH,MAAM,GAAC,SAAS,CAM5B"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../src/common/error.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,QAAA,MAAM,eAAe,2BAA2B,CAAC;AAEjD;;GAEG;AACH,QAAA,MAAM,wBAAwB;;;;;;;;CAY7B,CAAC;AAEF;;GAEG;AACH,cAAM,WAAY,SAAQ,KAAK;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAQzC,MAAM,CAAC,SAAS,SAAe;IAC/B,MAAM,CAAC,SAAS,SAAe;IAC/B,MAAM,CAAC,cAAc,SAAoB;IACzC,MAAM,CAAC,aAAa,SAAmB;IACvC,MAAM,CAAC,qBAAqB,SAA2B;IACvD,MAAM,CAAC,cAAc,SAAoB;IACzC,MAAM,CAAC,mBAAmB,SAAyB;CACpD;AAED;;GAEG;AACH,cAAM,iBAAkB,SAAQ,KAAK;IACnC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC;;;;;OAKG;gBACS,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,EAAE,MAAM;CAQnE;AAED;;;;;GAKG;AACH,QAAA,MAAM,wBAAwB,GAAI,KAAK,KAAK,KAAG,MAAM,GAAG,SAIvD,CAAC;AAEF,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,wBAAwB,EACxB,eAAe,EACf,wBAAwB,GACzB,CAAC"}

package/build/common/error.js

@@ -1,11 +1,10 @@
-// @ts-check
 import { OWNER_AFFILIATIONS } from "./constants.js";
 /**
- * @type {string} A general message to ask user to try again later.
+ * A general message to ask user to try again later.
  */
 const TRY_AGAIN_LATER = "Please try again later";
 /**
- * @type {Object<string, string>} A map of error types to secondary error messages.
+ * A map of error types to secondary error messages.
  */
 const SECONDARY_ERROR_MESSAGES = {
     MAX_RETRY: "You can deploy own instance or wait until public will be no longer limited",
@@ -20,16 +19,19 @@ const SECONDARY_ERROR_MESSAGES = {
  * Custom error class to handle custom GRS errors.
  */
 class CustomError extends Error {
+    type;
+    secondaryMessage;
     /**
      * Custom error constructor.
      *
-     * @param {string} message Error message.
-     * @param {string} type Error type.
+     * @param message Error message.
+     * @param type Error type.
      */
     constructor(message, type) {
         super(message);
         this.type = type;
-        this.secondaryMessage = SECONDARY_ERROR_MESSAGES[type] || type;
+        this.secondaryMessage =
+            SECONDARY_ERROR_MESSAGES[type] ?? type;
     }
     static MAX_RETRY = "MAX_RETRY";
     static NO_TOKENS = "NO_TOKENS";
@@ -43,11 +45,13 @@ class CustomError extends Error {
  * Missing query parameter class.
  */
 class MissingParamError extends Error {
+    missedParams;
+    secondaryMessage;
     /**
      * Missing query parameter error constructor.
      *
-     * @param {string[]} missedParams An array of missing parameters names.
-     * @param {string=} secondaryMessage Optional secondary message to display.
+     * @param missedParams An array of missing parameters names.
+     * @param secondaryMessage Optional secondary message to display.
      */
     constructor(missedParams, secondaryMessage) {
         const msg = `Missing params ${missedParams
@@ -61,8 +65,8 @@ class MissingParamError extends Error {
 /**
  * Retrieve secondary message from an error object.
  *
- * @param {Error} err The error object.
- * @returns {string|undefined} The secondary message if available, otherwise undefined.
+ * @param err The error object.
+ * @returns The secondary message if available, otherwise undefined.
  */
 const retrieveSecondaryMessage = (err) => {
     return "secondaryMessage" in err && typeof err.secondaryMessage === "string"

package/build/common/fmt.d.ts

@@ -1,27 +1,28 @@
 /**
  * Retrieves num with suffix k(thousands) precise to given decimal places.
  *
- * @param {number} num The number to format.
- * @param {number=} precision The number of decimal places to include.
- * @returns {string|number} The formatted number.
+ * @param num The number to format.
+ * @param precision The number of decimal places to include.
+ * @returns The formatted number.
  */
-export function kFormatter(num: number, precision?: number | undefined): string | number;
+declare const kFormatter: (num: number, precision?: number) => string | number;
 /**
  * Convert bytes to a human-readable string representation.
  *
- * @param {number} bytes The number of bytes to convert.
- * @returns {string} The human-readable representation of bytes.
+ * @param bytes The number of bytes to convert.
+ * @returns The human-readable representation of bytes.
  * @throws {Error} If bytes is negative or too large.
  */
-export function formatBytes(bytes: number): string;
+declare const formatBytes: (bytes: number) => string;
 /**
  * Split text over multiple lines based on the card width.
  *
- * @param {string} text Text to split.
- * @param {number} width Available wrap width in px.
- * @param {number} fontSize Font size in px.
- * @param {number} maxLines Maximum number of lines.
- * @returns {string[]} Array of lines.
+ * @param text Text to split.
+ * @param width Available wrap width in px.
+ * @param fontSize Font size in px.
+ * @param maxLines Maximum number of lines.
+ * @returns Array of lines.
  */
-export function wrapTextMultiline(text: string, width: number, fontSize: number, maxLines?: number): string[];
+declare const wrapTextMultiline: (text: string, width: number, fontSize: number, maxLines?: number) => Array<string>;
+export { kFormatter, formatBytes, wrapTextMultiline };
 //# sourceMappingURL=fmt.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fmt.d.ts","sourceRoot":"","sources":["../../src/common/fmt.js"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,gCAJW,MAAM,cACN,MAAM,YAAC,GACL,MAAM,GAAC,MAAM,CAezB;AAED;;;;;;GAMG;AACH,mCAJW,MAAM,GACJ,MAAM,CAqBlB;AAED;;;;;;;;GAQG;AACH,wCANW,MAAM,SACN,MAAM,YACN,MAAM,aACN,MAAM,GACJ,MAAM,EAAE,CAgBpB"}
+{"version":3,"file":"fmt.d.ts","sourceRoot":"","sources":["../../src/common/fmt.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,QAAA,MAAM,UAAU,GAAI,KAAK,MAAM,EAAE,YAAY,MAAM,KAAG,MAAM,GAAG,MAa9D,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAmBpC,CAAC;AAEF;;;;;;;;GAQG;AACH,QAAA,MAAM,iBAAiB,GACrB,MAAM,MAAM,EACZ,OAAO,MAAM,EACb,UAAU,MAAM,EAChB,iBAAY,KACX,KAAK,CAAC,MAAM,CAkBd,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC"}

package/build/common/fmt.js

@@ -1,12 +1,11 @@
-// @ts-check
 import { encodeHTML } from "./html.js";
 import { splitWrappedText } from "./render.js";
 /**
  * Retrieves num with suffix k(thousands) precise to given decimal places.
  *
- * @param {number} num The number to format.
- * @param {number=} precision The number of decimal places to include.
- * @returns {string|number} The formatted number.
+ * @param num The number to format.
+ * @param precision The number of decimal places to include.
+ * @returns The formatted number.
  */
 const kFormatter = (num, precision) => {
     const abs = Math.abs(num);
@@ -17,13 +16,13 @@ const kFormatter = (num, precision) => {
     if (abs < 1000) {
         return sign * abs;
     }
-    return sign * parseFloat((abs / 1000).toFixed(1)) + "k";
+    return `${sign * parseFloat((abs / 1000).toFixed(1))}k`;
 };
 /**
  * Convert bytes to a human-readable string representation.
  *
- * @param {number} bytes The number of bytes to convert.
- * @returns {string} The human-readable representation of bytes.
+ * @param bytes The number of bytes to convert.
+ * @returns The human-readable representation of bytes.
  * @throws {Error} If bytes is negative or too large.
  */
 const formatBytes = (bytes) => {
@@ -36,19 +35,20 @@ const formatBytes = (bytes) => {
     const sizes = ["B", "KB", "MB", "GB", "TB", "PB", "EB"];
     const base = 1024;
     const i = Math.floor(Math.log(bytes) / Math.log(base));
-    if (i >= sizes.length) {
+    const unit = sizes[i];
+    if (unit === undefined) {
         throw new Error("Bytes is too large to convert to a human-readable string");
     }
-    return `${(bytes / Math.pow(base, i)).toFixed(1)} ${sizes[i]}`;
+    return `${(bytes / Math.pow(base, i)).toFixed(1)} ${unit}`;
 };
 /**
  * Split text over multiple lines based on the card width.
  *
- * @param {string} text Text to split.
- * @param {number} width Available wrap width in px.
- * @param {number} fontSize Font size in px.
- * @param {number} maxLines Maximum number of lines.
- * @returns {string[]} Array of lines.
+ * @param text Text to split.
+ * @param width Available wrap width in px.
+ * @param fontSize Font size in px.
+ * @param maxLines Maximum number of lines.
+ * @returns Array of lines.
  */
 const wrapTextMultiline = (text, width, fontSize, maxLines = 3) => {
     const wrapped = splitWrappedText(text, fontSize, width);
@@ -57,7 +57,11 @@ const wrapTextMultiline = (text, width, fontSize, maxLines = 3) => {
         .slice(0, maxLines); // Only consider maxLines lines
     // Add "..." to the last line if the text exceeds maxLines
     if (wrapped.length > maxLines) {
-        lines[maxLines - 1] += "...";
+        const lastIndex = maxLines - 1;
+        const lastLine = lines[lastIndex];
+        if (lastLine !== undefined) {
+            lines[lastIndex] = `${lastLine}...`;
+        }
     }
     // Remove empty lines if text fits in less than maxLines lines
     const multiLineText = lines.filter(Boolean);

package/build/common/html.d.ts

@@ -2,9 +2,7 @@
  * Encode string as HTML.
  *
  * @see https://stackoverflow.com/a/48073476/10629172
- *
- * @param {string} str String to encode.
- * @returns {string} Encoded string.
  */
-export function encodeHTML(str: string): string;
+declare const encodeHTML: (str: string) => string;
+export { encodeHTML };
 //# sourceMappingURL=html.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/common/html.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,gCAHW,MAAM,GACJ,MAAM,CAWlB"}
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/common/html.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,QAAA,MAAM,UAAU,GAAI,KAAK,MAAM,KAAG,MASjC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,CAAC"}