Next

.github/ISSUE_TEMPLATE/bug_report.md

@@ -22,8 +22,8 @@ Steps to reproduce the behavior:
 **Expected behavior**
 A clear and concise description of what you expected to happen.
 
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
+**Error messages**
+If applicable, add error messages to help explain your problem.
 
 **Additional context**
 Add any other context about the problem here.

.github/workflows/doc-publish.yml

@@ -10,12 +10,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Set up node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install yarn
         run: npm install -g yarn

.github/workflows/npmpublish.yml

@@ -4,22 +4,30 @@ on:
   pull_request:
     branches:
       - master
+      - next
 
   push:
     branches:
       - master
+      - next
+
+permissions:
+  contents: write
+  packages: write
+  id-token: write
+  issues: write
 
 jobs:
   test:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Set up node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install yarn
         run: npm install -g yarn
@@ -35,23 +43,13 @@ jobs:
     if: github.event_name == 'push'
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout code with ADMIN_TOKEN
-        if: github.event.pull_request.head.repo.full_name == github.repository
-        uses: actions/checkout@v2
-        with:
-           token: ${{ secrets.ADMIN_TOKEN }}
-
       - name: Checkout code
-        if: github.event.pull_request.head.repo.full_name != github.repository
-        uses: actions/checkout@v2
-
-      - name: Prepare repository
-        run: git fetch --unshallow --tags
+        uses: actions/checkout@v4
 
       - name: Set up node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
       - name: Install yarn
         run: npm install -g yarn
@@ -60,16 +58,15 @@ jobs:
         run: yarn install --frozen-lockfile
 
       - name: Cache node modules
-        uses: actions/cache@v1
+        uses: actions/cache@v4
         with:
           path: node_modules
           key: yarn-deps-${{ hashFiles('yarn.lock') }}
           restore-keys: |
             yarn-deps-${{ hashFiles('yarn.lock') }}
 
       - name: Create Release
+        run: npx semantic-release@25.0.3
         env:
-          token: ${{ secrets.ADMIN_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}
-        run: |
-          npx auto shipit
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+

.github/workflows/run-tests.yml

@@ -6,27 +6,44 @@ on:
 
 jobs:
   test:
+    permissions:
+      id-token: write
+
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Set up node
-        uses: actions/setup-node@v1
+        uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 24
 
-      - name: Install yarn
-        run: npm install -g yarn
+      - name: Enable Corepack
+        run: corepack enable
 
       - name: Install dependencies
-        run: yarn install
+        run: yarn install --frozen-lockfile
 
       - name: Lint lib/
         run: yarn lint
+
+      - id: auth
+        name: Generate ID Token
+        uses: google-github-actions/auth@v2
+        with:
+          token_format: id_token
+          workload_identity_provider: ${{ vars.workload_identity_provider }}
+          service_account: ${{ vars.service_account }}
+          id_token_audience: "https://${{ vars.forwarder_hostname }}"
+          id_token_include_email: true
+
       - name: Run tests
         env:
+          API_KEY: ${{ secrets.API_KEY }}
           COOKIE: ${{ secrets.COOKIE }}
           COOKIE_2: ${{ secrets.COOKIE_2 }}
+          FORWARDER_HOSTNAME: ${{ vars.forwarder_hostname }}
+          ID_TOKEN: ${{ steps.auth.outputs.id_token }}
         run: yarn test
 

README.md

@@ -33,6 +33,8 @@ This NPM package enables operations froms the [Roblox website](https://www.roblo
 
 If you are looking for more information on how to create something like this, check out [our sister library, `noblox.js-server`](https://github.com/noblox/noblox.js-server) or [our YouTube series](https://www.youtube.com/playlist?list=PLEW4K4VqMUb_VMA3Yp9LI4gReRyVWGTnU). Keep in mind that these resources may not always be up to date, so it is **highly** encouraged that you learn to use the `noblox.js` library directly.
 
+
+Note: We use the semantic release plugin. You should treat npm as the source of truth regarding package versions - the package.json version in this repository will not be up to date.
 ---
 
 ## Prerequisites

lib/accountinformation/getUserSocialLinks.js

@@ -1,5 +1,6 @@
 // Includes
 const http = require('../util/http.js').func
+const RobloxAPIError = require('../util/apiError.js')
 
 // Args
 exports.required = ['userId']
@@ -25,14 +26,11 @@ function getUserSocialLinks (userId, jar) {
       resolveWithFullResponse: true
     }
   })
-    .then(({ statusCode, body }) => {
-      const { errors } = JSON.parse(body)
-      if (statusCode === 200) {
-        return JSON.parse(body)
-      } else if (statusCode === 400) {
-        throw new Error(`${errors[0].message} | userId: ${userId}`)
+    .then((res) => {
+      if (res.statusCode === 200) {
+        return JSON.parse(res.body)
       } else {
-        throw new Error(`An unknown error occurred with getUserSocialLinks() | [${statusCode}] userId: ${userId}`)
+        throw new RobloxAPIError(res)
       }
     })
 }

lib/accountsettings/block.js

@@ -1,6 +1,7 @@
 // Includes
 const http = require('../util/http.js').func
 const getGeneralToken = require('../util/getGeneralToken.js').func
+const RobloxAPIError = require('../util/apiError.js')
 
 // Args
 exports.required = ['userId']
@@ -22,7 +23,7 @@ exports.optional = ['jar']
 function block (jar, token, userId) {
   return new Promise((resolve, reject) => {
     const httpOpt = {
-      url: `//accountsettings.roblox.com/v1/users/${userId}/block`,
+      url: `https://apis.roblox.com/user-blocking-api/v1/users/${userId}/block-user`,
       options: {
         method: 'POST',
         jar,
@@ -37,13 +38,7 @@ function block (jar, token, userId) {
         if (res.statusCode === 200) {
           resolve()
         } else {
-          const body = JSON.parse(res.body) || {}
-          if (body.errors && body.errors.length > 0) {
-            const errors = body.errors.map((e) => {
-              return e.message
-            })
-            reject(new Error(`${res.statusCode} ${errors.join(', ')}`))
-          }
+          reject(new RobloxAPIError(res))
         }
       })
   })

lib/accountsettings/unblock.js

@@ -1,6 +1,7 @@
 // Includes
 const http = require('../util/http.js').func
 const getGeneralToken = require('../util/getGeneralToken.js').func
+const RobloxAPIError = require('../util/apiError.js')
 
 // Args
 exports.required = ['userId']
@@ -22,7 +23,7 @@ exports.optional = ['jar']
 function unblock (jar, token, userId) {
   return new Promise((resolve, reject) => {
     const httpOpt = {
-      url: `//accountsettings.roblox.com/v1/users/${userId}/unblock`,
+      url: `https://apis.roblox.com/user-blocking-api/v1/users/${userId}/unblock-user`,
       options: {
         method: 'POST',
         jar,
@@ -37,13 +38,7 @@ function unblock (jar, token, userId) {
         if (res.statusCode === 200) {
           resolve()
         } else {
-          const body = JSON.parse(res.body) || {}
-          if (body.errors && body.errors.length > 0) {
-            const errors = body.errors.map((e) => {
-              return e.message
-            })
-            reject(new Error(`${res.statusCode} ${errors.join(', ')}`))
-          }
+          reject(new RobloxAPIError(res))
         }
       })
   })

lib/asset/deleteFromInventory.js

@@ -1,6 +1,7 @@
 // Includes
 const http = require('../util/http.js').func
 const getGeneralToken = require('../util/getGeneralToken.js').func
+const RobloxAPIError = require('../util/apiError.js')
 
 // Args
 exports.required = ['assetId']
@@ -28,30 +29,17 @@ function deleteFromInventory (jar, assetId, xcsrf) {
         resolveWithFullResponse: true,
         jar,
         headers: {
-          'X-CSRF-TOKEN': xcsrf,
-          'content-type': 'application/x-www-form-urlencoded; charset=UTF-8'
+          'X-CSRF-TOKEN': xcsrf
         }
       }
     }
 
     return http(httpOpt)
       .then(function (res) {
-        const responseData = typeof res.body === 'string' ? JSON.parse(res.body) : res.body
-        // Roblox likes to error here with 200 status codes too with inconsistency
         if (res.statusCode === 200) {
-          let error = 'An unknown error has occurred.'
-          if (responseData && !responseData.isValid) {
-            error = responseData.error
-            reject(new Error(error))
-          } else if (responseData && responseData.isValid) {
-            resolve()
-          }
+          resolve()
         } else {
-          let error = 'An unknown error has occurred.'
-          if (responseData && responseData.errors) {
-            error = responseData.errors.map((e) => e.message).join('\n')
-          }
-          reject(new Error(error))
+          reject(new RobloxAPIError(res))
         }
       })
       .catch(error => reject(error))

lib/asset/getGamePassProductInfo.js

@@ -1,6 +1,7 @@
 // Includes
 const http = require('../util/http.js').func
 const cache = require('../cache')
+const RobloxAPIError = require('../util/apiError.js')
 
 // Args
 exports.required = ['gamepass']
@@ -33,9 +34,7 @@ function getGamePassProductInfo (gamepass) {
         if (res.statusCode === 200) {
           resolve(data)
         } else {
-          const errors = data.errors.map((e) => e.message)
-
-          reject(new Error(`${res.statusCode} ${errors.join(', ')}`))
+          reject(new RobloxAPIError(res))
         }
       })
       .catch(error => reject(error))

lib/asset/getProductInfo.js

@@ -1,6 +1,7 @@
 // Includes
 const http = require('../util/http.js').func
 const cache = require('../cache')
+const RobloxAPIError = require('../util/apiError.js')
 
 // Args
 exports.required = ['asset']
@@ -30,18 +31,7 @@ function getProductInfo (asset) {
         if (res.statusCode === 200) {
           resolve(JSON.parse(res.body))
         } else {
-          // Sourced from: https://stackoverflow.com/a/32278428
-          const isAnObject = (val) => !!(val instanceof Array || val instanceof Object)
-
-          const body = isAnObject(res.body) ? JSON.parse(res.body) : {}
-          if (body.errors && body.errors.length > 0) {
-            const errors = body.errors.map((e) => {
-              return e.message
-            })
-            reject(new Error(`${res.statusCode} ${errors.join(', ')}`))
-          } else {
-            reject(new Error(`${res.statusCode} ${res.body}`))
-          }
+          reject(new RobloxAPIError(res))
         }
       })
       .catch(error => reject(error))

lib/avatar/avatarRules.js

@@ -1,4 +1,5 @@
 const http = require('../util/http.js').func
+const RobloxAPIError = require('../util/apiError.js')
 
 exports.optional = ['option', 'jar']
 
@@ -32,7 +33,7 @@ exports.func = (args) => {
 
       return result
     } else {
-      throw new Error('Error fetching avatar rules')
+      throw new RobloxAPIError(res)
     }
   })
 }

lib/avatar/currentlyWearing.js

@@ -1,4 +1,5 @@
 const http = require('../util/http.js').func
+const RobloxAPIError = require('../util/apiError.js')
 
 exports.required = ['userId']
 
@@ -26,7 +27,7 @@ exports.func = (args) => {
     if (res.statusCode === 200) {
       return JSON.parse(res.body)
     } else {
-      throw new Error('User does not exist')
+      throw new RobloxAPIError(res)
     }
   })
 }

lib/avatar/getAvatar.js

@@ -1,4 +1,5 @@
 const http = require('../util/http.js').func
+const RobloxAPIError = require('../util/apiError.js')
 
 exports.required = ['userId']
 
@@ -24,7 +25,7 @@ const getAvatar = (userId) => {
     if (res.statusCode === 200) {
       return JSON.parse(res.body)
     } else {
-      throw new Error('User does not exist')
+      throw new RobloxAPIError(res)
     }
   })
 }