zdu-student-api 1.1.9 → 1.1.11

package/dist/audience.js

@@ -74,6 +74,7 @@ export class Audience {
         this.dops.forEach((dop) => {
             dops += `&dop_${dop}=yes`;
         });
+        // TODO FIX MIN AND MAX. IF MIN = true & !MAX, MAX=999999999
         const response = await fetch(`https://dekanat.zu.edu.ua/cgi-bin/timetable_export.cgi?req_type=free_rooms_list&&block_name=${this.blockName !== undefined ? this.encodeCP1251(this.blockName) : ''}&size_min=${this.size_min !== undefined ? this.size_min : ''}&size_max=${this.size_max !== undefined ? this.size_max : ''}&room_type=${this.roomType !== undefined ? this.encodeCP1251(this.roomType) : ''}&begin_date=${date}&lesson=${this.lesson}${dops}&req_format=json&coding_mode=UTF8&bs=%D1%F4%EE%F0%EC%F3%E2%E0%F2%E8+%E7%E0%EF%E8%F2`);
         if (!response.ok)
             throw new Error(`HTTP error ${response.status}: ${response.statusText}`);

package/dist/cabinet/data.js

@@ -2,6 +2,7 @@ import fetch from 'cross-fetch';
 import iconv from 'iconv-lite';
 import { generateCookieString, isLoginPage } from './session.js';
 import { parseDataPageN3, parseDataPageN31, parseTeacherData } from './parsers.js';
+import { Buffer } from 'buffer';
 /**
  * Отримати анкетні дані студента
  * @category CabinetTeacher

package/dist/cabinet/session.js

@@ -1,5 +1,6 @@
 import fetch from 'cross-fetch';
 import iconv from 'iconv-lite';
+import { Buffer } from 'buffer';
 /**
  * Отримати sesID та sessGUID користувача
  * @category Cabinet

package/dist/cabinetStudent/cabinetStudent.d.ts

@@ -51,9 +51,10 @@ export declare class CabinetStudent {
      */
     auth(login?: string, password?: string): Promise<boolean>;
     /**
-     * Базове значення семестру
+     * Встановити семестр
+     * @param password - Семестр в форматі рядка або числа, якщо не передавати згенерується ймовірний семестр
      */
-    private setSemester;
+    setSemester(semester?: 1 | 2 | '1' | '2'): void;
     /**
      * Отримання всіх данних
      */

package/dist/cabinetStudent/cabinetStudent.js

@@ -67,10 +67,18 @@ export class CabinetStudent {
         return false;
     }
     /**
-     * Базове значення семестру
-     */
-    setSemester() {
-        this.semester = getSemester();
+     * Встановити семестр
+     * @param password - Семестр в форматі рядка або числа, якщо не передавати згенерується ймовірний семестр
+     */
+    setSemester(semester) {
+        if (!semester)
+            this.semester = getSemester();
+        else {
+            if (semester === '1' || semester === 1)
+                this.semester = 1;
+            if (semester === '2' || semester === 2)
+                this.semester = 2;
+        }
     }
     /**
      * Отримання всіх данних

package/dist/cabinetStudent/disciplines.js

@@ -2,6 +2,7 @@ import fetch from 'cross-fetch';
 import iconv from 'iconv-lite';
 import { parseDisciplinesPageN6, parseDisciplinesPageN7 } from '../cabinet/parsers.js';
 import { generateCookieString, isLoginPage } from '../cabinet/session.js';
+import { Buffer } from 'buffer';
 /**
  * Отримати всі дисципліни студента
  * @category CabinetStudent

package/dist/cabinetStudent/scores.js

@@ -1,6 +1,7 @@
 import fetch from 'cross-fetch';
 import iconv from 'iconv-lite';
 import { generateCookieString, isLoginPage } from '../cabinet/session.js';
+import { Buffer } from 'buffer';
 /**
  * Отримати оцінки вибраного предмета студента
  * @category CabinetStudent
@@ -34,7 +35,7 @@ export async function getScores(sesId, sessGUID, prId, semester) {
         if (isLoginPage(html1))
             return result;
         result.scheduleItem = parseSchedule(html1);
-        result.studentScores = parseScores(html1);
+        result.studentScores = parseScores(html1, result.scheduleItem.length);
         result.studentId = result.studentScores[0]?.id;
         if (result.studentScores.length > 1) {
             result.studentScores.sort((a, b) => a.id.localeCompare(b.id));
@@ -51,38 +52,140 @@ export async function getScores(sesId, sessGUID, prId, semester) {
  * Витягує список пар з HTML
  */
 function parseSchedule(html) {
-    let idx = html.indexOf('<th></th>');
-    html = idx === -1 ? html : html.slice(idx + '<th></th>'.length);
-    idx = html.indexOf('<th class="dh">');
-    html = idx === -1 ? html : html.slice(0, idx);
-    const regex = /<th[^>]*data-hth="([^"]+)"[^>]*>[\s\S]*?<a[^>]*data-ind="([^"]+)"[^>]*>[^<]+<\/a>[\s\S]*?<br>([^<]+)<\/th>/g;
+    let idx = html.indexOf('<thead>');
+    if (idx === -1)
+        return [];
+    let theadEnd = html.indexOf('</thead>', idx);
+    if (theadEnd === -1)
+        return [];
+    let theadContent = html.slice(idx, theadEnd);
+    let firstTrStart = theadContent.indexOf('<tr>');
+    let firstTrEnd = theadContent.indexOf('</tr>', firstTrStart);
+    if (firstTrStart === -1 || firstTrEnd === -1)
+        return [];
+    let firstRow = theadContent.slice(firstTrStart, firstTrEnd);
+    let secondTrStart = theadContent.indexOf('<tr>', firstTrEnd);
+    let secondTrEnd = theadContent.indexOf('</tr>', secondTrStart);
+    let thirdTrStart = theadContent.indexOf('<tr>', secondTrEnd);
+    let thirdTrEnd = theadContent.indexOf('</tr>', thirdTrStart);
+    if (thirdTrStart === -1 || thirdTrEnd === -1)
+        return [];
+    let thirdRow = theadContent.slice(thirdTrStart, thirdTrEnd);
     const result = [];
+    const thStartRegex = /<th\b/g;
+    const positions = [];
     let match;
-    while ((match = regex.exec(html)) !== null) {
-        const [_, dataHth, index, time] = match;
-        const parts = dataHth.split(',');
-        const teacher = parts[0].trim();
-        const dateType = parts[1]?.trim().split(' ') || [];
-        const date = dateType[0] || '';
-        const type = dateType[1] || '';
-        result.push({ teacher, date, type, time: time.trim(), index });
+    while ((match = thStartRegex.exec(firstRow)) !== null) {
+        positions.push(match.index);
+    }
+    positions.push(firstRow.length);
+    const thirdPositions = [];
+    const thirdThStartRegex = /<th\b/g;
+    while ((match = thirdThStartRegex.exec(thirdRow)) !== null) {
+        thirdPositions.push(match.index);
+    }
+    thirdPositions.push(thirdRow.length);
+    for (let i = 0; i < positions.length - 1; i++) {
+        const start = positions[i];
+        const end = positions[i + 1];
+        const thFull = firstRow.slice(start, end);
+        const closeIdx = thFull.indexOf('</th>');
+        if (closeIdx === -1)
+            continue;
+        const thTag = thFull.slice(0, closeIdx + 5);
+        const thContent = thTag.replace(/<th[^>]*>/, '').replace(/<\/th>/, '');
+        if (!thContent.trim())
+            continue;
+        let moduleMatch = thContent.match(/^(М\d+)<br>/);
+        if (moduleMatch) {
+            const moduleNum = moduleMatch[1];
+            const timeMatch = thContent.match(/<br[^>]*>\s*(\d{2}:\d{2}-\d{2}:\d{2})/);
+            const time = timeMatch ? timeMatch[1].trim() : '';
+            result.push({
+                teacher: undefined,
+                date: undefined,
+                type: 'МД',
+                time: time,
+                index: `module_${moduleNum}`,
+                description: `Модуль ${moduleNum}`,
+            });
+            continue;
+        }
+        if (thContent.match(/Підсум\.|Всього|Невиправд\./)) {
+            continue;
+        }
+        const dataHthMatch = thTag.match(/data-hth="([^"]+)"/);
+        if (!dataHthMatch)
+            continue;
+        const dataHth = dataHthMatch[1];
+        const aMatch = thContent.match(/data-ind="([^"]+)"/);
+        if (!aMatch)
+            continue;
+        const index = aMatch[1];
+        const dateMatch = thContent.match(/>(\d{2}\.\d{2}\.\d{4})</);
+        const date = dateMatch ? dateMatch[1] : '';
+        const timeMatch = thContent.match(/<br[^>]*>\s*(\d{2}:\d{2}-\d{2}:\d{2})/);
+        const time = timeMatch ? timeMatch[1].trim() : '';
+        const parts = dataHth.split(',').map((p) => p.trim());
+        const teacher = parts[0] || '';
+        let type = '';
+        if (parts[1]) {
+            const dateTypeParts = parts[1].split(/\s+/);
+            type = dateTypeParts[1] || '';
+        }
+        result.push({ teacher, date, type, time, index });
+    }
+    const descriptions = parseDescriptions(html);
+    for (const item of result) {
+        if (item.index && !item.index.startsWith('module_') && descriptions.has(item.index)) {
+            item.description = descriptions.get(item.index);
+        }
     }
     return result;
 }
+/**
+ * Витягує описи занять з HTML
+ */
+function parseDescriptions(html) {
+    const descriptions = new Map();
+    const divRegex = /<div\s+id="r(\d+)"\s+class="hidden">\s*([\s\S]*?)\s*<br>/g;
+    let match;
+    while ((match = divRegex.exec(html)) !== null) {
+        const index = match[1];
+        const content = match[2].trim();
+        if (content && !content.startsWith('<')) {
+            descriptions.set(index, content);
+        }
+    }
+    return descriptions;
+}
 /**
  * Витягує список оцінок з HTML
  */
-function parseScores(html) {
+function parseScores(html, expectedScoresCount) {
     const studentRows = html.match(/<tr\s+[^>]*id="s\d+"[\s\S]*?<\/tr>/g) || [];
     const result = [];
     for (const row of studentRows) {
         const idMatch = row.match(/id="(s\d+)"/);
         const id = idMatch ? idMatch[1] : '';
-        const tdMatches = [...row.matchAll(/<td[^>]*data-item="(\d+)"[^>]*>([\s\S]*?)<\/td>/g)];
+        const allTds = [...row.matchAll(/<td\b[^>]*>([\s\S]*?)<\/td>/g)];
         const scoresMap = new Map();
-        for (const td of tdMatches) {
-            const dataItem = Number(td[1]);
-            const score = td[2].trim() || '';
+        for (const tdMatch of allTds) {
+            const fullTd = tdMatch[0];
+            const tdContent = tdMatch[1].trim();
+            const dataItemMatch = fullTd.match(/data-item="(\d+)"/);
+            if (!dataItemMatch)
+                continue;
+            const dataItem = Number(dataItemMatch[1]);
+            if (fullTd.match(/class="[^"]*\bf\s+f1\b[^"]*"/) ||
+                fullTd.match(/class="[^"]*\bf1\b[^"]*"/)) {
+                continue;
+            }
+            if (fullTd.match(/class="[^"]*\bf\s+f2\b[^"]*"/) ||
+                fullTd.match(/class="[^"]*\bf2\b[^"]*"/)) {
+                continue;
+            }
+            const score = tdContent || '';
             if (!scoresMap.has(dataItem)) {
                 scoresMap.set(dataItem, [score]);
             }
@@ -90,11 +193,13 @@ function parseScores(html) {
                 scoresMap.get(dataItem).push(score);
             }
         }
-        const scores = Array.from(scoresMap.values());
-        scores.shift();
-        const finalMatch = row.match(/<td[^>]*class="f f1"[^>]*>([\s\S]*?)<\/td>/);
+        const sortedItems = Array.from(scoresMap.entries()).sort((a, b) => a[0] - b[0]);
+        const scores = sortedItems.map(([_, values]) => values);
+        const finalMatch = row.match(/<td[^>]*class="[^"]*\bf\s+f1\b[^"]*"[^>]*>([\s\S]*?)<\/td>/);
         const finalScore = finalMatch ? finalMatch[1].trim() : '';
-        const absenceMatches = [...row.matchAll(/<td[^>]*class="f f2"[^>]*>([\s\S]*?)<\/td>/g)];
+        const absenceMatches = [
+            ...row.matchAll(/<td[^>]*class="[^"]*\bf\s+f2\b[^"]*"[^>]*>([\s\S]*?)<\/td>/g),
+        ];
         const absences = absenceMatches[0] ? Number(absenceMatches[0][1].trim() || 0) : 0;
         const uabsences = absenceMatches[1] ? Number(absenceMatches[1][1].trim() || 0) : 0;
         result.push({ id, scores, absences, uabsences, finalScore });

package/dist/cabinetStudent/types.d.ts

@@ -90,18 +90,20 @@ export interface Disciplines {
  * Опис заняття у кабінеті студента
  * @category CabinetStudent
  * @remarks
- * - `teacher` — Прізвище та ініціали викладача
- * - `date` — Дата заняття у форматі "dd.mm.yyyy"
- * - `type` — Тип заняття: "Лек", "ПрСем", "Лаб", "МК", "Екз"
+ * - `teacher` — Прізвище та ініціали викладача (undefined для модульних днів)
+ * - `date` — Дата заняття у форматі "dd.mm.yyyy" (undefined для модульних днів)
+ * - `type` — Тип заняття: "Лек", "ПрСем", "Лаб", "МК", "Екз", "МД"
  * - `time` — Час заняття у форматі "HH:MM-HH:MM"
  * - `index` — Значення атрибута `data-ind`, унікальний ідентифікатор
+ * - `description` — Опис заняття (може бути undefined) ("Модуль ##" для модульних днів, де ## - номер модуля, наприклад М0, М1)
  */
 export interface ScheduleItem {
-    teacher: string;
-    date: string;
+    teacher?: string;
+    date?: string;
     type: string;
     time: string;
     index: string;
+    description?: string;
 }
 /**
  * Список оцінок студента.

package/dist/cabinetTeacher/academicGroups.js

@@ -2,6 +2,7 @@ import fetch from 'cross-fetch';
 import iconv from 'iconv-lite';
 import { generateCookieString, isLoginPage } from '../cabinet/session.js';
 import { parseGroupsPage } from '../cabinet/parsers.js';
+import { Buffer } from 'buffer';
 /**
  * Отримати всі академічні групи
  * @category CabinetTeacher

package/dist/examples.js

@@ -1,4 +1,3 @@
-import { CabinetStudent, } from './index.js';
 import 'dotenv/config';
 // const schedule = new Schedule();
 // schedule.group = '23Бд-СОінф123'
@@ -28,10 +27,16 @@ import 'dotenv/config';
 // console.log(await getTeachers('Кривонос Олександр'));
 // console.log(await getRooms('319'));
 // const audience = new Audience();
-// audience.blockName = "гуртож №3"
+// // audience.blockName = 'гуртож №3';
 // try {
+//     audience.roomType = 'Комп. клас';
+//     audience.blockName = '№1';
+//     const [day, month, year] = '09.02.2026'.split('.');
+//     audience.roomsDate = new Date(+year, +month - 1, +day + 1);
+//     console.log(audience.roomsDate);
+//     audience.lesson = 5;
 //     const audiences = await audience.getAudience();
-//     console.log("Аудиторії:", audiences);
+//     console.log('Аудиторії:', audiences);
 // } catch (err: any) {
 //     console.error(err.message);
 // }
@@ -53,13 +58,14 @@ import 'dotenv/config';
 // const me = data2.studentScores.find((s) => s.id === data2.studentId)!;
 // const sesID = '';
 // const sessGUID = '';
-const cb = new CabinetStudent(process.env.LOGIN, process.env.PASSWORD);
-await cb.auth();
-// // console.log(cb.sesID, cb.sessGUID);
-// console.log(await cb.setSession(sesID, sessGUID));
-// // console.log(cb.sesID, cb.sessGUID);
-// console.log(await cb.loadData());
-console.log(await cb.getData());
+// const cb = new CabinetStudent(process.env.LOGIN!, process.env.PASSWORD!);
+// await cb.auth();
+// // // console.log(cb.sesID, cb.sessGUID);
+// // console.log(await cb.setSession(sesID, sessGUID));
+// // // console.log(cb.sesID, cb.sessGUID);
+// await cb.loadData();
+// const scores = cb.allScores;
+// await writeFile('scores.json', JSON.stringify(scores, null, 2), 'utf-8');
 // console.log(cb.data);
 // await cb.getDisciplines();
 // console.log(await cb.getId());

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "zdu-student-api",
-    "version": "1.1.9",
+    "version": "1.1.11",
     "description": "API client for ZDU student services",
     "author": "Nicita3 <ni596157@gmail.com> (https://github.com/Nicita-3)",
     "main": "dist/index.js",
@@ -22,16 +22,16 @@
     },
     "homepage": "https://nicita-3.github.io/zdu-student-api",
     "devDependencies": {
-        "@types/node": "^24.10.1",
-        "prettier": "^3.7.4",
+        "@types/node": "^24.12.2",
+        "prettier": "^3.8.1",
         "ts-node": "^10.9.2",
-        "typedoc": "^0.28.14",
+        "typedoc": "^0.28.18",
         "typescript": "^5.9.3"
     },
     "dependencies": {
         "buffer": "^6.0.3",
         "cross-fetch": "^4.1.0",
-        "dotenv": "^17.2.3",
-        "iconv-lite": "^0.7.0"
+        "dotenv": "^17.4.1",
+        "iconv-lite": "^0.7.2"
     }
 }