rrisd-hac-api 1.0.1

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,33 @@
+# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
+# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
+
+name: Node.js Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npm test
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org/
+      - run: npm ci
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 pwR
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# hac api
+
+i was bored so uh i made this
+
+# usage
+you first need to require it, like so:
+```js
+const hac = require("rrisd-hac-api");
+const api = new hac();
+```
+
+---
+after you do that, call this function:
+```js
+await api.login(username, password);
+```
+---
+once thats done, call this:
+```js
+api.getGrades();
+```
+
+which will return an array that looks like this:
+```json
+[
+  { courseName: 'PE', average: 100 },
+  { courseName: 'Math', average: 86 },
+  { courseName: 'Spanish', average: 93 },
+  { courseName: 'ELA', average: 97 },
+  { courseName: 'Science', average: 92 },
+  { courseName: 'History', average: 90 },
+  { courseName: 'Band', average: 96 }
+]
+```
+
+## it will take a few seconds to fetch, be patient.

package/index.js

@@ -0,0 +1,83 @@
+const axios = require('axios');
+const cheerio = require('cheerio');
+const qs = require('qs');
+const { wrapper } = require('axios-cookiejar-support');
+const { CookieJar } = require('tough-cookie');
+
+class hac {
+    constructor() {
+        const jar = new CookieJar();
+        this.client = wrapper(axios.create({
+            baseURL: 'https://accesscenter.roundrockisd.org/HomeAccess/',
+            jar,
+            withCredentials: true,
+            headers: {
+                'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
+                'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8',
+                'Content-Type': 'application/x-www-form-urlencoded'
+            }
+        }));
+    }
+
+    async login(username, password) {
+        const loginPage = await this.client.get('Account/LogOn?ReturnUrl=%2fhomeaccess');
+        const $ = cheerio.load(loginPage.data);
+        
+        const token = $('input[name="__RequestVerificationToken"]').val();
+
+        if (!token) {
+            throw new Error("Could not find RequestVerificationToken. The site layout might have changed.");
+        }
+
+        const payload = qs.stringify({
+            '__RequestVerificationToken': token,
+            'SCKTY00328510CustomEnabled': 'False',
+            'SCKTY00436568CustomEnabled': 'False',
+            'Database': '10',
+            'VerificationOption': 'UsernamePassword',
+            'LogOnDetails.UserName': username,
+            'tempUN': '',
+            'tempPW': password, 
+            'LogOnDetails.Password': password
+        }, { format: 'RFC1738' });
+
+        const response = await this.client.post('Account/LogOn?ReturnUrl=%2fhomeaccess', payload, {
+            headers: {
+                'Referer': 'https://accesscenter.roundrockisd.org/HomeAccess/Account/LogOn?ReturnUrl=%2fhomeaccess',
+                'Origin': 'https://accesscenter.roundrockisd.org'
+            }
+        });
+
+        if (response.data.includes('LogOnDetails.Password')) {
+            throw new Error('Login failed: Invalid credentials.');
+        }
+
+        return true;
+    }
+
+    async getGrades() {
+        const { data: html } = await this.client.get('Content/Student/Assignments.aspx');
+        const $ = cheerio.load(html);
+        const courses = [];
+
+        $('.AssignmentClass').each((i, element) => {
+        const $el = $(element);
+        let rawTitle = $el.find('.sg-header-heading').text().trim();
+        let cleanTitle = rawTitle.replace(/\s\s+/g, ' ');
+        let courseName = cleanTitle.split(' AVG')[0].trim();
+        let averageText = $el.find('.sg-header-heading.sg-right').text().trim();
+        let average = parseFloat(averageText.replace(/[^\d.]/g, ''));
+
+        if (courseName) {
+            courses.push({
+                courseName,
+                average: isNaN(average) ? null : average
+            });
+        }
+    });
+
+        return courses;
+    }
+}
+
+module.exports = hac;

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "rrisd-hac-api",
+  "version": "1.0.1",
+  "description": "a scraper based api for round rock isd home access center",
+  "main": "index.js",
+  "scripts": {
+    "test": "node test.js"
+  },
+  "keywords": [
+    "rrisd",
+    "hac",
+    "home-access-center",
+    "grades",
+    "round-rock-isd"
+  ],
+  "author": "pwR",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0",
+    "axios-cookiejar-support": "^5.0.0",
+    "cheerio": "^1.0.0-rc.12",
+    "qs": "^6.11.0",
+    "tough-cookie": "^4.1.3"
+  }
+}

package/test.js

@@ -0,0 +1,27 @@
+const HAC = require('./index');
+const readline = require('node:readline/promises');
+const { stdin: input, stdout: output } = require('node:process');
+
+const api = new HAC();
+
+(async () => {
+    const rl = readline.createInterface({ input, output });
+
+    try {
+        const username = await rl.question('Username: ');
+        const password = await rl.question('Password: ');
+        rl.close();
+
+        await api.login(username, password);
+        const grades = await api.getGrades();
+        
+        if (grades.length === 0) {
+            console.log('No data returned.');
+        } else {
+            console.table(grades);
+        }
+
+    } catch (error) {
+        console.error(error.message);
+    }
+})();