steamutils 1.5.49 → 1.5.51

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, formatMarketHistoryDate, getCleanObject, getImageSize, isJWT, JSON_parse, JSON_stringify, removeSpaceKeys, secretAsBuffer, sleep } from "./utils.js";
+import { console_log, convertLongsToNumbers, downloadImage, formatMarketCurrency, formatMarketHistoryDate, getCleanObject, getImageSize, getMarketPriceValueAsInt, 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";
@@ -6262,10 +6262,27 @@ export default class SteamUser {
     }
   }
 
+  /**
+   * Sells an item from the user's inventory on the Steam market.
+   *
+   * @param {Object} options - The item selling options.
+   * @param {number} [options.appid=730] - The application ID (default is 730).
+   * @param {number} [options.contextid=2] - The inventory context ID (default is 2).
+   * @param {string|number} options.assetid - The asset ID of the item to sell.
+   * @param {number} [options.amount=1] - The number of items to sell (default is 1).
+   * @param {number|string} options.price - The price at which to list the item.
+   * @returns {Promise<{
+   *   success: boolean,
+   *   requires_confirmation: number,
+   *   needs_mobile_confirmation: boolean,
+   *   needs_email_confirmation: boolean,
+   *   email_domain: string
+   * } | null>} An object with the sale result and required confirmations, or null if input is invalid or request fails.
+   */
   async sellItem({ appid = 730, contextid = 2, assetid, amount = 1, price }) {
     price = parseInt(price);
     if (!price) {
-      return;
+      return null;
     }
 
     const result = await this._httpRequestAjax({
@@ -6285,18 +6302,10 @@ export default class SteamUser {
     });
 
     if (result instanceof ResponseError) {
-      return result;
+      return null;
     }
 
     return result?.data;
-
-    const resultExample = {
-      success: true,
-      requires_confirmation: 1,
-      needs_mobile_confirmation: true,
-      needs_email_confirmation: false,
-      email_domain: "gmail.com",
-    };
   }
 
   async removeListing(id) {
@@ -6770,20 +6779,62 @@ export default class SteamUser {
     return friendSince;
   }
 
+  /**
+   * Retrieves the Steam Wallet balances (main and pending) and the account currency
+   * for the currently authenticated user by parsing the wallet info from the profile HTML.
+   *
+   * @async
+   * @returns {Promise<{mainBalance: string|null, pending: string|null, currency: string|null}|undefined>}
+   *   A Promise that resolves to an object containing:
+   *   - mainBalance: The main wallet balance as a string (e.g., "276.400,82₫"), or null if not found.
+   *   - pending: The pending wallet balance as a string (e.g., "90.176,70₫"), or null if not found.
+   *   - currency: The detected currency symbol or code (e.g., "₫", "€", "$", "TL"), or null if not found.
+   *   The function returns undefined if an error occurs or valid HTML is not available.
+   *
+   * @example
+   * const { mainBalance, pending, currency } = await getWalletBalance();
+   * console.log(mainBalance); // e.g., "276.400,82₫"
+   * console.log(pending);     // e.g., "90.176,70₫"
+   * console.log(currency);    // e.g., "₫"
+   */
   async getWalletBalance() {
     const result = await this._httpRequest(`my?l=english`);
     if (result instanceof ResponseError) {
-      return result;
+      return;
     }
     const html = result?.data;
     if (!html || typeof html !== "string") {
       return;
     }
     const $ = cheerio.load(html);
-    const headerEl = $("#header_wallet_balance");
-    try {
-      return headerEl[0].children.map((el) => $(el).text().trim()).filter(Boolean);
-    } catch (e) {}
+
+    const mainBalance = $("#header_wallet_balance").clone().children().remove().end().text().trim() || null;
+
+    let currency = null;
+    if (mainBalance) {
+      // This regex matches all non-digit, non-comma, non-dot characters at the end (currency symbol/code)
+      // Handles "12,34€", "$12.34", "12,34 TL", etc.
+      const m = mainBalance.match(/([^\d.,\s].*)$/);
+      if (m) currency = m[1].trim();
+      else {
+        // fallback for prefix (e.g. "$12.34")
+        const m2 = mainBalance.match(/^([^\d.,\s]+)/);
+        if (m2) currency = m2[1].trim();
+      }
+    }
+
+    let pendingStr = $("#header_wallet_balance span.tooltip").text();
+    let pending = null;
+    if (pendingStr) {
+      const match = pendingStr.match(/Pending:\s*([\d.,]+[^\s]*)/);
+      if (match) pending = match[1];
+    }
+
+    return {
+      mainBalance,
+      pending,
+      currency,
+    };
   }
 
   async acceptConfirmationForObject(accessToken, identitySecret, objectID) {

package/package.json

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