steamutils 1.5.52 → 1.5.54

package/index.js

@@ -5,7 +5,7 @@ import moment from "moment";
 import { hex2b64, Key as RSA } from "node-bignumber";
 import SteamID from "steamid";
 import qs from "qs";
-import { console_log, convertLongsToNumbers, downloadImage, formatMarketCurrency, formatMarketHistoryDate, getCleanObject, getImageSize, getMarketPriceValueAsInt, isJWT, JSON_parse, JSON_stringify, removeSpaceKeys, secretAsBuffer, sleep } from "./utils.js";
+import { console_log, convertLongsToNumbers, downloadImage, getCleanObject, getImageSize, isJWT, JSON_parse, JSON_stringify, removeSpaceKeys, secretAsBuffer, sleep } from "./utils.js";
 import { Header, request } from "./axios.js";
 import { getTableHasHeaders, querySelectorAll, table2json } from "./cheerio.js";
 import { getJSObjectFronXML } from "./xml2json.js";
@@ -21,7 +21,7 @@ import { AppID_CSGO, E1GameBanOnRecord, E1VACBanOnRecord, EActivityType, ECommen
 import SteamTotp from "steam-totp";
 import { SteamProto, SteamProtoType } from "./steamproto.js";
 import EventEmitter from "node:events";
-import { extractAssetItemsFromHovers, parseMarketHistoryListings, parseMarketListings } from "./parse_html.js";
+import { extractAssetItemsFromHovers, parseMarketHistoryListings, parseMarketListings, parseSteamProfileXmlToJson, parseUserProfile } from "./parse_html.js";
 
 const eventEmitter = (globalThis.steamUserEventEmitter = new EventEmitter());
 
@@ -397,8 +397,9 @@ export default class SteamUser {
 
     const result = await this._httpRequest(url);
     if (result instanceof ResponseError) {
-      return result;
+      return null;
     }
+
     return SteamUser._parseUserProfile(result?.data || "");
   }
 
@@ -537,6 +538,32 @@ export default class SteamUser {
     };
   }
 
+  /**
+   * Fetches a Steam Community profile (in XML format) by SteamID, parses it,
+   * and returns a normalized JSON representation.
+   *
+   * @async
+   * @param {string} [steamId] - 64-bit SteamID. Defaults to the result of `this.getSteamIdUser()`.
+   * @returns {Promise<SteamProfileXml|undefined>} Promise resolving to the normalized Steam profile object, or `undefined` on failure.
+   *
+   */
+  async getProfileFromXml(steamId = this.getSteamIdUser()) {
+    const result = await this._httpRequest(`https://steamcommunity.com/profiles/${steamId}/?xml=1`);
+    if (result instanceof ResponseError) {
+      return;
+    }
+    try {
+      return parseSteamProfileXmlToJson(result?.data);
+    } catch (e) {}
+  }
+
+  static async getProfileFromXml(steamId) {
+    try {
+      const xml = (await axios.get(`https://steamcommunity.com/profiles/${steamId}/?xml=1`)).data;
+      return parseSteamProfileXmlToJson(xml);
+    } catch (e) {}
+  }
+
   static async getUsersSummaryByWebApiKey(webApiKey, steamIds) {
     if (!Array.isArray(steamIds)) {
       steamIds = [steamIds];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "steamutils",
-  "version": "1.5.52",
+  "version": "1.5.54",
   "main": "index.js",
   "dependencies": {
     "alpha-common-utils": "^1.0.6",

package/parse_html.js

@@ -1,189 +1,346 @@
-import { StringUtils } from "alpha-common-utils/index.js";
-import { formatMarketHistoryDate } from "./utils.js";
-import * as cheerio from "cheerio";
-
-/**
- * @typedef {Object} HoverItem
- * @property {string|null} listingId         The listing ID extracted from the selector, if available (as string).
- * @property {number} appid                  The app (game) ID for this item.
- * @property {number} contextid              The context ID for this item.
- * @property {number} assetid                The unique asset ID.
- * @property {string} unknown                A string field captured from the arguments (usually "0").
- * @property {string} [name_selector]        The HTML selector for the item's name, if present.
- * @property {string} [image_selector]       The HTML selector for the item's image, if present.
- * @property {string} [other_selector]       The selector string if it does not match name/image pattern.
- */
-
-/**
- * Extracts item information from Steam inventory trade history or similar HTML fragments.
- * Scans the given HTML string for calls to `CreateItemHoverFromContainer` and extracts
- * key data for each referenced item. Returns each item's info in a structured array.
- *
- * @param {string} html - The HTML string to parse.
- * @returns {HoverItem[]} Array of hover item objects.
- */
-export function extractAssetItemsFromHovers(html) {
-  // Use your preferred HTML/space scrubber.
-  html = StringUtils.cleanSpace(html);
-
-  // RegExp for CreateItemHoverFromContainer arguments
-  const re = /CreateItemHoverFromContainer\s*\(\s*g_rgAssets\s*,\s*'([^']+)'\s*,\s*(\d+)\s*,\s*'(\d+)'\s*,\s*'(\d+)'\s*,\s*(\d+)\s*\)/g;
-
-  /** @type {Record<number, HoverItem>} */
-  const itemsMap = {};
-  let match;
-
-  while ((match = re.exec(html)) !== null) {
-    const [_, selector, appid, contextid, assetid, unknown] = match;
-
-    // Extract listingId as a string if present: "history_row_<listingId>_"
-    let listingId = null;
-    const lidMatch = selector.match(/history_row_(\d+)_/);
-    if (lidMatch) listingId = lidMatch[1]; // assign as string
-
-    const appidNum = Number(appid);
-    const contextidNum = Number(contextid);
-    const assetidNum = Number(assetid);
-
-    if (!itemsMap[assetidNum]) {
-      itemsMap[assetidNum] = {
-        listingId,
-        appid: appidNum,
-        contextid: contextidNum,
-        assetid: assetidNum,
-        unknown,
-      };
-    }
-
-    if (selector.endsWith("_name")) {
-      itemsMap[assetidNum].name_selector = selector;
-    } else if (selector.endsWith("_image")) {
-      itemsMap[assetidNum].image_selector = selector;
-    } else {
-      itemsMap[assetidNum].other_selector = selector;
-    }
-  }
-  return Object.values(itemsMap);
-}
-
-/**
- * @typedef {Object} MarketHistoryListing
- * @property {string} id - HTML row id attribute (e.g. "history_row_4316182845737233773_4316182845737233774").
- * @property {string} listingId - Listing id (e.g. "4316182845737233773").
- * @property {number} price - Price in integer form (e.g. 80270).
- * @property {string} itemName - The market item's name (e.g. "UMP-45 | Mudder").
- * @property {string} gameName - The game's name (e.g. "Counter-Strike 2").
- * @property {string} listedOn - Listing date as string (e.g. "27 May 2024").
- * @property {string} actedOn - Acted on date or empty string.
- * @property {string} image - Full image URL for the item.
- * @property {string} gainOrLoss - "+" for buys, "-" for sells.
- * @property {string} status - Status text, usually empty string.
- * @property {string} [assetId] - (optional) Associated asset id, if available.
- */
-
-/**
- * Parses Steam market history listing rows into structured data objects.
- *
- * @param {string} html - The raw HTML string to parse.
- * @param {Object} [assetByListingId={}] - Optional mapping of listingId to assetId.
- * @returns {MarketHistoryListing[]} Array of market listing objects.
- */
-export function parseMarketHistoryListings(html, assetByListingId = {}) {
-  const $ = cheerio.load(html);
-  return $(".market_listing_row")
-    .toArray()
-    .map((el) => {
-      const $el = $(el);
-      const id = $el.attr("id");
-      const listingId = id?.match(/history_row_(.*?)_/)?.[1];
-      if (!listingId) return null;
-      const [gainOrLoss, image, priceText, itemName, gameName, listedOnText, actedOnText, status] = [$el.find(".market_listing_gainorloss").text().trim(), $el.find(".market_listing_item_img").attr("src"), $el.find(".market_table_value .market_listing_price").text(), $el.find(".market_listing_item_name").text().trim(), $el.find(".market_listing_game_name").text().trim(), $el.find(".market_listing_listed_date + .market_listing_listed_date").text(), $el.find(".market_listing_whoactedwith + .market_listing_listed_date").text(), $el.find(".market_listing_whoactedwith").text().trim()];
-      const price = parseInt(priceText.replace(/[₫().,]/g, "").trim(), 10) || "";
-      const listedOn = typeof formatMarketHistoryDate === "function" ? formatMarketHistoryDate(listedOnText.replace(/Listed:/, "").trim()) : listedOnText.replace(/Listed:/, "").trim();
-      const actedOn = typeof formatMarketHistoryDate === "function" ? formatMarketHistoryDate(actedOnText.replace(/Listed:/, "").trim()) : actedOnText.replace(/Listed:/, "").trim();
-
-      const result = {
-        id,
-        listingId,
-        price,
-        itemName,
-        gameName,
-        listedOn,
-        actedOn,
-        image,
-        gainOrLoss,
-        status,
-      };
-      if (assetByListingId?.[listingId]) result.assetId = assetByListingId[listingId];
-      return result;
-    })
-    .filter(Boolean);
-}
-
-/**
- * Parses Steam Market HTML listings to an array of items.
- *
- * @param {string} html - HTML string containing listing rows.
- * @returns {Array<{
- *   listingId: string,
- *   appId: number,
- *   contextId: number,
- *   itemId: number,
- *   imageUrl: string|null,
- *   buyerPaysPrice: string,
- *   receivePrice: string,
- *   itemName: string,
- *   gameName: string,
- *   listedDate: string
- * }>}
- */
-export function parseMarketListings(html) {
-  const $ = cheerio.load(html);
-  const results = [];
-
-  $(".market_listing_row").each((index, element) => {
-    const $row = $(element);
-
-    const cancelLink = $row.find(".market_listing_cancel_button > a").attr("href");
-    if (!cancelLink) return;
-
-    const paramsMatch = cancelLink.match(/\(([^)]*)\)/);
-    if (!paramsMatch) return;
-
-    let [, listingId, appId, contextId, itemId] = paramsMatch[1].split(",").map((param) => param.trim().replace(/^['"]|['"]$/g, ""));
-
-    appId = Number(appId);
-    contextId = Number(contextId);
-    itemId = Number(itemId);
-
-    const imageUrl = $row.find(`#mylisting_${listingId}_image`).attr("src") || null;
-
-    const buyerPaysElem = $row.find('.market_listing_price span[title="This is the price the buyer pays."]');
-    const buyerPaysPrice = StringUtils.cleanSpace(buyerPaysElem.text().replace(/[()]/g, ""));
-
-    const receiveElem = $row.find('.market_listing_price span[title="This is how much you will receive."]');
-    const receivePrice = StringUtils.cleanSpace(receiveElem.text().replace(/[()]/g, ""));
-
-    const itemName = $row.find(".market_listing_item_name_link").text() || $row.find(".market_listing_item_name").text();
-
-    const gameName = $row.find(".market_listing_game_name").text();
-
-    const listedDateElem = $row.find(".market_listing_game_name + .market_listing_listed_date_combined");
-    const listedDate = formatMarketHistoryDate(StringUtils.cleanSpace(listedDateElem.text()));
-
-    results.push({
-      listingId,
-      appId,
-      contextId,
-      itemId,
-      imageUrl,
-      buyerPaysPrice,
-      receivePrice,
-      itemName,
-      gameName,
-      listedDate,
-    });
-  });
-
-  return results;
-}
+import { StringUtils } from "alpha-common-utils/index.js";
+import { formatMarketHistoryDate, getAvatarHashFromUrl } from "./utils.js";
+import * as cheerio from "cheerio";
+import { getJSObjectFronXML } from "./xml2json.js";
+import moment from "moment";
+
+/**
+ * @typedef {Object} HoverItem
+ * @property {string|null} listingId         The listing ID extracted from the selector, if available (as string).
+ * @property {number} appid                  The app (game) ID for this item.
+ * @property {number} contextid              The context ID for this item.
+ * @property {number} assetid                The unique asset ID.
+ * @property {string} unknown                A string field captured from the arguments (usually "0").
+ * @property {string} [name_selector]        The HTML selector for the item's name, if present.
+ * @property {string} [image_selector]       The HTML selector for the item's image, if present.
+ * @property {string} [other_selector]       The selector string if it does not match name/image pattern.
+ */
+
+/**
+ * Extracts item information from Steam inventory trade history or similar HTML fragments.
+ * Scans the given HTML string for calls to `CreateItemHoverFromContainer` and extracts
+ * key data for each referenced item. Returns each item's info in a structured array.
+ *
+ * @param {string} html - The HTML string to parse.
+ * @returns {HoverItem[]} Array of hover item objects.
+ */
+export function extractAssetItemsFromHovers(html) {
+  // Use your preferred HTML/space scrubber.
+  html = StringUtils.cleanSpace(html);
+
+  // RegExp for CreateItemHoverFromContainer arguments
+  const re = /CreateItemHoverFromContainer\s*\(\s*g_rgAssets\s*,\s*'([^']+)'\s*,\s*(\d+)\s*,\s*'(\d+)'\s*,\s*'(\d+)'\s*,\s*(\d+)\s*\)/g;
+
+  /** @type {Record<number, HoverItem>} */
+  const itemsMap = {};
+  let match;
+
+  while ((match = re.exec(html)) !== null) {
+    const [_, selector, appid, contextid, assetid, unknown] = match;
+
+    // Extract listingId as a string if present: "history_row_<listingId>_"
+    let listingId = null;
+    const lidMatch = selector.match(/history_row_(\d+)_/);
+    if (lidMatch) listingId = lidMatch[1]; // assign as string
+
+    const appidNum = Number(appid);
+    const contextidNum = Number(contextid);
+    const assetidNum = Number(assetid);
+
+    if (!itemsMap[assetidNum]) {
+      itemsMap[assetidNum] = {
+        listingId,
+        appid: appidNum,
+        contextid: contextidNum,
+        assetid: assetidNum,
+        unknown,
+      };
+    }
+
+    if (selector.endsWith("_name")) {
+      itemsMap[assetidNum].name_selector = selector;
+    } else if (selector.endsWith("_image")) {
+      itemsMap[assetidNum].image_selector = selector;
+    } else {
+      itemsMap[assetidNum].other_selector = selector;
+    }
+  }
+  return Object.values(itemsMap);
+}
+
+/**
+ * @typedef {Object} MarketHistoryListing
+ * @property {string} id - HTML row id attribute (e.g. "history_row_4316182845737233773_4316182845737233774").
+ * @property {string} listingId - Listing id (e.g. "4316182845737233773").
+ * @property {number} price - Price in integer form (e.g. 80270).
+ * @property {string} itemName - The market item's name (e.g. "UMP-45 | Mudder").
+ * @property {string} gameName - The game's name (e.g. "Counter-Strike 2").
+ * @property {string} listedOn - Listing date as string (e.g. "27 May 2024").
+ * @property {string} actedOn - Acted on date or empty string.
+ * @property {string} image - Full image URL for the item.
+ * @property {string} gainOrLoss - "+" for buys, "-" for sells.
+ * @property {string} status - Status text, usually empty string.
+ * @property {string} [assetId] - (optional) Associated asset id, if available.
+ */
+
+/**
+ * Parses Steam market history listing rows into structured data objects.
+ *
+ * @param {string} html - The raw HTML string to parse.
+ * @param {Object} [assetByListingId={}] - Optional mapping of listingId to assetId.
+ * @returns {MarketHistoryListing[]} Array of market listing objects.
+ */
+export function parseMarketHistoryListings(html, assetByListingId = {}) {
+  const $ = cheerio.load(html);
+  return $(".market_listing_row")
+    .toArray()
+    .map((el) => {
+      const $el = $(el);
+      const id = $el.attr("id");
+      const listingId = id?.match(/history_row_(.*?)_/)?.[1];
+      if (!listingId) return null;
+      const [gainOrLoss, image, priceText, itemName, gameName, listedOnText, actedOnText, status] = [$el.find(".market_listing_gainorloss").text().trim(), $el.find(".market_listing_item_img").attr("src"), $el.find(".market_table_value .market_listing_price").text(), $el.find(".market_listing_item_name").text().trim(), $el.find(".market_listing_game_name").text().trim(), $el.find(".market_listing_listed_date + .market_listing_listed_date").text(), $el.find(".market_listing_whoactedwith + .market_listing_listed_date").text(), $el.find(".market_listing_whoactedwith").text().trim()];
+      const price = parseInt(priceText.replace(/[₫().,]/g, "").trim(), 10) || "";
+      const listedOn = typeof formatMarketHistoryDate === "function" ? formatMarketHistoryDate(listedOnText.replace(/Listed:/, "").trim()) : listedOnText.replace(/Listed:/, "").trim();
+      const actedOn = typeof formatMarketHistoryDate === "function" ? formatMarketHistoryDate(actedOnText.replace(/Listed:/, "").trim()) : actedOnText.replace(/Listed:/, "").trim();
+
+      const result = {
+        id,
+        listingId,
+        price,
+        itemName,
+        gameName,
+        listedOn,
+        actedOn,
+        image,
+        gainOrLoss,
+        status,
+      };
+      if (assetByListingId?.[listingId]) result.assetId = assetByListingId[listingId];
+      return result;
+    })
+    .filter(Boolean);
+}
+
+/**
+ * Parses Steam Market HTML listings to an array of items.
+ *
+ * @param {string} html - HTML string containing listing rows.
+ * @returns {Array<{
+ *   listingId: string,
+ *   appId: number,
+ *   contextId: number,
+ *   itemId: number,
+ *   imageUrl: string|null,
+ *   buyerPaysPrice: string,
+ *   receivePrice: string,
+ *   itemName: string,
+ *   gameName: string,
+ *   listedDate: string
+ * }>}
+ */
+export function parseMarketListings(html) {
+  const $ = cheerio.load(html);
+  const results = [];
+
+  $(".market_listing_row").each((index, element) => {
+    const $row = $(element);
+
+    const cancelLink = $row.find(".market_listing_cancel_button > a").attr("href");
+    if (!cancelLink) return;
+
+    const paramsMatch = cancelLink.match(/\(([^)]*)\)/);
+    if (!paramsMatch) return;
+
+    let [, listingId, appId, contextId, itemId] = paramsMatch[1].split(",").map((param) => param.trim().replace(/^['"]|['"]$/g, ""));
+
+    appId = Number(appId);
+    contextId = Number(contextId);
+    itemId = Number(itemId);
+
+    const imageUrl = $row.find(`#mylisting_${listingId}_image`).attr("src") || null;
+
+    const buyerPaysElem = $row.find('.market_listing_price span[title="This is the price the buyer pays."]');
+    const buyerPaysPrice = StringUtils.cleanSpace(buyerPaysElem.text().replace(/[()]/g, ""));
+
+    const receiveElem = $row.find('.market_listing_price span[title="This is how much you will receive."]');
+    const receivePrice = StringUtils.cleanSpace(receiveElem.text().replace(/[()]/g, ""));
+
+    const itemName = $row.find(".market_listing_item_name_link").text() || $row.find(".market_listing_item_name").text();
+
+    const gameName = $row.find(".market_listing_game_name").text();
+
+    const listedDateElem = $row.find(".market_listing_game_name + .market_listing_listed_date_combined");
+    const listedDate = formatMarketHistoryDate(StringUtils.cleanSpace(listedDateElem.text()));
+
+    results.push({
+      listingId,
+      appId,
+      contextId,
+      itemId,
+      imageUrl,
+      buyerPaysPrice,
+      receivePrice,
+      itemName,
+      gameName,
+      listedDate,
+    });
+  });
+
+  return results;
+}
+
+/**
+ * Represents a Steam Community group for a profile.
+ * @typedef {Object} SteamProfileGroupXml
+ * @property {string} groupID64
+ * @property {string} groupName
+ * @property {string} groupURL
+ * @property {string} headline
+ * @property {string} summary
+ * @property {string} avatarIcon
+ * @property {string} avatarMedium
+ * @property {string} avatarFull
+ * @property {number} memberCount
+ * @property {number} membersInChat
+ * @property {number} membersInGame
+ * @property {number} membersOnline
+ */
+
+/**
+ * Array of Steam Community groups.
+ * @typedef {SteamProfileGroupXml[]} SteamProfileGroupsXml
+ */
+
+/**
+ * Represents a most played game on a Steam profile.
+ * @typedef {Object} SteamProfileMostPlayedGameXml
+ * @property {string} gameName
+ * @property {string} gameLink
+ * @property {string} gameIcon
+ * @property {string} gameLogo
+ * @property {string} gameLogoSmall
+ * @property {number} hoursPlayed
+ * @property {number} hoursOnRecord
+ * @property {string} statsName
+ */
+
+/**
+ * Array of most played games.
+ * @typedef {SteamProfileMostPlayedGameXml[]} SteamProfileMostPlayedGamesXml
+ */
+
+/**
+ * Steam Community profile (parsed from XML, normalized).
+ * @typedef {Object} SteamProfileXml
+ * @property {string} name
+ * @property {string} steamId
+ * @property {string} onlineState
+ * @property {string} stateMessage
+ * @property {string} privacyState
+ * @property {number} visibilityState
+ * @property {string} avatarIcon
+ * @property {string} avatarMedium
+ * @property {string} avatarFull
+ * @property {string} avatarHash
+ * @property {number} vacBanned
+ * @property {string} tradeBanState
+ * @property {number} isLimitedAccount
+ * @property {string} customURL
+ * @property {string} memberSince
+ * @property {string} steamRating
+ * @property {number} hoursPlayed2Wk
+ * @property {string} headline
+ * @property {string} location
+ * @property {string} realname
+ * @property {string} summary
+ * @property {SteamProfileMostPlayedGamesXml} [mostPlayedGames]
+ * @property {SteamProfileGroupsXml} [groups]
+ */
+
+/**
+ * Parses a Steam profile XML into a normalized JSON format.
+ *
+ * @param {string} xml - The XML string as returned by the Steam Community profile endpoint.
+ * @returns {SteamProfileXml|undefined} The normalized profile object or undefined on error.
+ *
+ * @example
+ * import { parseSteamProfileXmlToJson } from "./your-module";
+ * const xml = await fetch('https://steamcommunity.com/profiles/76561198386265483/?xml=1').then(r => r.text());
+ * const profile = parseSteamProfileXmlToJson(xml);
+ * console.log(profile.name);
+ */
+export function parseSteamProfileXmlToJson(xml) {
+  const parsed = getJSObjectFronXML(xml);
+  if (!parsed || !parsed.profile) return;
+
+  // Flatten out the xml2js _structure, for direct children
+  const profile = {};
+  Object.entries(parsed.profile).forEach(([key, value]) => {
+    // If only text, keep as string
+    if (typeof value === "object" && value !== null && "_" in value && Object.keys(value).length === 1) {
+      profile[key] = value._;
+    } else {
+      profile[key] = value;
+    }
+  });
+
+  // Rename fields
+  if ("steamID" in profile) {
+    profile.name = profile.steamID;
+    delete profile.steamID;
+  }
+  if ("steamID64" in profile) {
+    profile.steamId = profile.steamID64;
+    delete profile.steamID64;
+  }
+
+  // Convert numbers
+  const numberFields = ["vacBanned", "isLimitedAccount", "visibilityState", "memberCount", "membersInChat", "membersInGame", "membersOnline", "hoursOnRecord"];
+  const floatFields = ["hoursPlayed2Wk", "hoursPlayed"];
+  for (const field of numberFields) {
+    if (field in profile) profile[field] = parseInt(profile[field], 10) || 0;
+  }
+  for (const field of floatFields) {
+    if (field in profile) profile[field] = parseFloat(profile[field]) || 0;
+  }
+
+  // Add avatarHash
+  const avatarUrl = profile.avatarFull || profile.avatarMedium || profile.avatarIcon;
+  profile.avatarHash = getAvatarHashFromUrl(avatarUrl);
+
+  const formats = ["MMMM DD, YYYY", "MMMM D, YYYY", "MMMM DD", "MMMM D"];
+  for (const format of formats) {
+    const memberSinceMoment = moment(profile.memberSince, format, true);
+    if (memberSinceMoment.isValid()) {
+      profile.memberSince = moment(profile.memberSince, format, true).valueOf();
+      break;
+    }
+  }
+
+  // Ensure all simple fields are strings if empty object
+  for (const key in profile) {
+    if (typeof profile[key] === "object" && profile[key] !== null && Object.keys(profile[key]).length === 0) {
+      profile[key] = "";
+    }
+  }
+
+  // Move groups.group to top-level 'groups' if present
+  if (profile.groups && profile.groups.group) {
+    profile.groups = profile.groups.group;
+  }
+
+  // Remove _attributes from groups (if present)
+  if (Array.isArray(profile.groups)) {
+    profile.groups = profile.groups.map((group) => {
+      if (group && typeof group === "object" && "_attributes" in group) {
+        // shallow clone and remove _attributes
+        const { _attributes, ...groupWithoutAttributes } = group;
+        return groupWithoutAttributes;
+      }
+      return group;
+    });
+  }
+
+  return profile;
+}

package/utils.js

@@ -1298,3 +1298,14 @@ export function isJWT(token) {
   }
   return false;
 }
+
+/**
+ * Extracts the 40-character Steam avatar hash from a URL.
+ * @param {string} avatarUrl
+ * @returns {string}
+ */
+export function getAvatarHashFromUrl(avatarUrl) {
+  if (!avatarUrl) return "";
+  const match = avatarUrl.match(/\/([a-f0-9]{40})[_\.]/i);
+  return match ? match[1] : "";
+}