zdu-student-api 1.1.5 → 1.1.7

package/dist/cabinet/utils.js

@@ -0,0 +1,19 @@
+/**
+ * Отримати ймовірний семестр поточної дати
+ * @category Cabinet
+ * @remarks
+ * З 2 вересня по кінець січня - перший семестр
+ * З 1 лютого по 1 вересня - другий семестр
+ */
+export function getSemester() {
+    const year = new Date().getFullYear();
+    const febStart = new Date(year, 1, 1); // лютий = 1
+    const sepStart = new Date(year, 8, 1); // вересень = 8
+    const date = new Date();
+    if (!(date < febStart || date >= sepStart)) {
+        return 2;
+    }
+    else {
+        return 1;
+    }
+}

package/dist/cabinet/validSession.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Перевірка на валідність сесії
+ * @category Cabinet
+ * @param sesId - ID сесії користувача
+ * @param sessGUID - GUID сесії з cookie
+ * @returns boolean значення.
+ */
+export declare function isValidSession(sesId: string, sessGUID: string): Promise<boolean>;

package/dist/cabinet/validSession.js

@@ -0,0 +1,29 @@
+import fetch from 'cross-fetch';
+import iconv from 'iconv-lite';
+import { generateCookieString, isLoginPage } from './utils.js';
+/**
+ * Перевірка на валідність сесії
+ * @category Cabinet
+ * @param sesId - ID сесії користувача
+ * @param sessGUID - GUID сесії з cookie
+ * @returns boolean значення.
+ */
+export async function isValidSession(sesId, sessGUID) {
+    try {
+        const cookieString = generateCookieString(sessGUID);
+        const response = await fetch(`https://dekanat.zu.edu.ua/cgi-bin/classman.cgi?n=3&sesID=${sesId}`, {
+            headers: {
+                Cookie: cookieString,
+            },
+        });
+        const buffer = await response.arrayBuffer();
+        const html = iconv.decode(Buffer.from(buffer), 'windows-1251');
+        if (!isLoginPage(html)) {
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/cabinetStudent/cabinetStudent.d.ts

@@ -0,0 +1,87 @@
+import { Discipline, Disciplines, DataStudent, Scores } from './types.js';
+/**
+ * Клас кабінету студента
+ * @category CabinetStudent
+ */
+export declare class CabinetStudent {
+    /**
+     * Прізвище користувача
+     */
+    login: string;
+    /**
+     * Пароль від кабінету студента
+     */
+    password: string;
+    /**
+     * ID сесії користувача
+     */
+    sesID?: string;
+    /**
+     * GUID сесії з cookie
+     */
+    sessGUID?: string;
+    /**
+     * Семестр для пошуку оцінок (1 - перший, 2 - другий)
+     */
+    semester: 1 | 2;
+    /**
+     * Список дисциплін {@link Discipline}
+     */
+    disciplines: Discipline[];
+    /**
+     * Данні студента {@link Data}
+     */
+    data?: DataStudent;
+    /**
+     * Оціки з усіх предметів {@link Scores}
+     */
+    allScores?: Scores[];
+    /**
+     * Айді в системі оцінювання
+     */
+    private id?;
+    /**
+     * Конструктор
+     * @param login - Прізвище користувача
+     * @param password - Пароль
+     */
+    constructor(login: string, password: string);
+    /**
+     * Авторизація
+     */
+    auth(login?: string, password?: string): Promise<boolean>;
+    /**
+     * Базове значення семестру
+     */
+    private setSemester;
+    /**
+     * Отримання всіх данних
+     */
+    loadData(): Promise<boolean>;
+    /**
+     * Відновлення сесії
+     */
+    setSession(sesID: string, sessGUID: string): Promise<boolean>;
+    /**
+     * Перевірка валідності сесії
+     */
+    isValidSession(): Promise<boolean>;
+    /**
+     * Отримати дисципліни поточного семестру студента
+     * @returns Об'єкт дисциплін {@link Disciplines}
+     */
+    getDisciplines(): Promise<Disciplines>;
+    /**
+     * Отримати анкетні данні студента
+     * @returns Об'єкт {@link Data}
+     */
+    getData(): Promise<DataStudent>;
+    /**
+     * Отримати оцінки з всіх предметів
+     */
+    getAllScores(semester?: 1 | 2): Promise<Scores[]>;
+    /**
+     * Отримати айді в системі оцінювання
+     */
+    getId(): Promise<string | undefined>;
+}

package/dist/cabinetStudent/cabinetStudent.js

@@ -0,0 +1,181 @@
+import { getSesId, isValidSession } from '../cabinet/session.js';
+import { getСurrentDisciplines } from './disciplines.js';
+import { getScores } from './scores.js';
+import { getSemester } from '../cabinet/utils.js';
+import { getDataStudent } from '../cabinet/data.js';
+/**
+ * Клас кабінету студента
+ * @category CabinetStudent
+ */
+export class CabinetStudent {
+    /**
+     * Прізвище користувача
+     */
+    login;
+    /**
+     * Пароль від кабінету студента
+     */
+    password;
+    /**
+     * ID сесії користувача
+     */
+    sesID;
+    /**
+     * GUID сесії з cookie
+     */
+    sessGUID;
+    /**
+     * Семестр для пошуку оцінок (1 - перший, 2 - другий)
+     */
+    semester = 1;
+    /**
+     * Список дисциплін {@link Discipline}
+     */
+    disciplines = [];
+    /**
+     * Данні студента {@link Data}
+     */
+    data;
+    /**
+     * Оціки з усіх предметів {@link Scores}
+     */
+    allScores;
+    /**
+     * Айді в системі оцінювання
+     */
+    id;
+    /**
+     * Конструктор
+     * @param login - Прізвище користувача
+     * @param password - Пароль
+     */
+    constructor(login, password) {
+        this.login = login;
+        this.password = password;
+    }
+    /**
+     * Авторизація
+     */
+    async auth(login, password) {
+        const accountData = await getSesId(login ?? this.login, password ?? this.password, 'student');
+        this.setSemester();
+        if (accountData.ok) {
+            this.sesID = accountData.sesID;
+            this.sessGUID = accountData.sessGUID;
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Базове значення семестру
+     */
+    setSemester() {
+        this.semester = getSemester();
+    }
+    /**
+     * Отримання всіх данних
+     */
+    async loadData() {
+        const one = (await this.getDisciplines()).ok;
+        const two = (await this.getData()).ok;
+        const three = (await this.getAllScores()).length > 0;
+        return one && two && three;
+    }
+    /**
+     * Відновлення сесії
+     */
+    async setSession(sesID, sessGUID) {
+        this.setSemester();
+        const ses = await isValidSession(sesID, sessGUID, 'student');
+        if (ses) {
+            this.sesID = sesID;
+            this.sessGUID = sessGUID;
+        }
+        return ses;
+    }
+    /**
+     * Перевірка валідності сесії
+     */
+    async isValidSession() {
+        if (!this.sesID || !this.sessGUID)
+            return false;
+        return await isValidSession(this.sesID, this.sessGUID, 'student');
+    }
+    /**
+     * Отримати дисципліни поточного семестру студента
+     * @returns Об'єкт дисциплін {@link Disciplines}
+     */
+    async getDisciplines() {
+        if (!this.sesID || !this.sessGUID)
+            return { ok: false, disciplines: [] };
+        try {
+            const disciplinesData = await getСurrentDisciplines(this.sesID, this.sessGUID);
+            if (disciplinesData.ok) {
+                this.disciplines = disciplinesData.disciplines;
+            }
+            return disciplinesData;
+        }
+        catch {
+            return { ok: false, disciplines: [] };
+        }
+    }
+    /**
+     * Отримати анкетні данні студента
+     * @returns Об'єкт {@link Data}
+     */
+    async getData() {
+        if (!this.sesID || !this.sessGUID)
+            return { ok: false };
+        try {
+            const data = await getDataStudent(this.sesID, this.sessGUID);
+            if (data.ok) {
+                this.data = data;
+            }
+            return data;
+        }
+        catch {
+            return { ok: false };
+        }
+    }
+    /**
+     * Отримати оцінки з всіх предметів
+     */
+    async getAllScores(semester) {
+        if (!this.sesID || !this.sessGUID)
+            return [];
+        if (!this.disciplines?.length)
+            return [];
+        const targetSemester = semester ?? this.semester;
+        try {
+            const scorePromises = this.disciplines.map((discipline) => getScores(this.sesID, this.sessGUID, discipline.prId, targetSemester));
+            const results = await Promise.all(scorePromises);
+            const allScores = results.filter((scores) => scores.ok);
+            this.allScores = allScores;
+            return allScores;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Отримати айді в системі оцінювання
+     */
+    async getId() {
+        if (this.id)
+            return this.id;
+        if (!this.sesID || !this.sessGUID)
+            return undefined;
+        if (!this.disciplines?.length) {
+            await this.getDisciplines();
+        }
+        if (!this.disciplines?.length)
+            return undefined;
+        try {
+            const result = await getScores(this.sesID, this.sessGUID, this.disciplines[0].prId, this.semester);
+            return result.studentId;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}

package/dist/cabinetStudent/disciplines.d.ts

@@ -0,0 +1,19 @@
+import { Disciplines } from './types.js';
+/**
+ * Отримати всі дисципліни студента
+ * @category CabinetStudent
+ * @param sesId - ID сесії користувача
+ * @param sessGUID - GUID сесії з cookie
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+ * @returns Масив дисциплін {@link Disciplines}
+ */
+export declare function getDisciplines(sesId: string, sessGUID: string): Promise<Disciplines>;
+/**
+ * Отримати поточні дисципліни студента
+ * @category CabinetStudent
+ * @param sesId - ID сесії користувача
+ * @param sessGUID - GUID сесії з cookie
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+ * @returns Масив дисциплін {@link Disciplines}
+ */
+export declare function getСurrentDisciplines(sesId: string, sessGUID: string): Promise<Disciplines>;

package/dist/cabinetStudent/disciplines.js

@@ -0,0 +1,86 @@
+import fetch from 'cross-fetch';
+import iconv from 'iconv-lite';
+import { parseDisciplinesPageN6, parseDisciplinesPageN7 } from '../cabinet/parsers.js';
+import { generateCookieString, isLoginPage } from '../cabinet/session.js';
+/**
+ * Отримати всі дисципліни студента
+ * @category CabinetStudent
+ * @param sesId - ID сесії користувача
+ * @param sessGUID - GUID сесії з cookie
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+ * @returns Масив дисциплін {@link Disciplines}
+ */
+export async function getDisciplines(sesId, sessGUID) {
+    try {
+        const result = { ok: false, disciplines: [] };
+        const cookieString = generateCookieString(sessGUID);
+        const response1 = await fetch(`https://dekanat.zu.edu.ua/cgi-bin/classman.cgi?n=3&sesID=${sesId}`, { headers: { Cookie: cookieString } });
+        const buffer1 = await response1.arrayBuffer();
+        const html1 = iconv.decode(Buffer.from(buffer1), 'windows-1251');
+        if (isLoginPage(html1))
+            return result;
+        let data = extractStrongValue(html1, 'Семестрові бали');
+        if (data === undefined)
+            return result;
+        const response2 = await fetch(`https://dekanat.zu.edu.ua/cgi-bin/${data.slice(2)}`, {
+            headers: { Cookie: cookieString },
+        });
+        const buffer2 = await response2.arrayBuffer();
+        const html2 = iconv.decode(Buffer.from(buffer2), 'windows-1251');
+        if (isLoginPage(html2))
+            return result;
+        result.disciplines = parseDisciplinesPageN6(html2);
+        result.ok = true;
+        return result;
+    }
+    catch (e) {
+        console.error('Error in getDisciplines:', e);
+        throw e;
+    }
+}
+/**
+ * Витягує значення з HTML після label до кінця li тегу
+ */
+function extractStrongValue(html, label) {
+    const textIdx = html.indexOf(label);
+    if (textIdx === -1)
+        return undefined;
+    const liStart = html.lastIndexOf('<li', textIdx);
+    if (liStart === -1)
+        return undefined;
+    const liEnd = html.indexOf('</li>', textIdx);
+    if (liEnd === -1)
+        return undefined;
+    const liContent = html.substring(liStart, liEnd);
+    const hrefMatch = liContent.match(/href\s*=\s*["']([^"']+)["']/i);
+    if (!hrefMatch)
+        return undefined;
+    const href = hrefMatch[1].trim();
+    return href || undefined;
+}
+/**
+ * Отримати поточні дисципліни студента
+ * @category CabinetStudent
+ * @param sesId - ID сесії користувача
+ * @param sessGUID - GUID сесії з cookie
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+ * @returns Масив дисциплін {@link Disciplines}
+ */
+export async function getСurrentDisciplines(sesId, sessGUID) {
+    try {
+        const result = { ok: false, disciplines: [] };
+        const cookieString = generateCookieString(sessGUID);
+        const response1 = await fetch(`https://dekanat.zu.edu.ua/cgi-bin/classman.cgi?n=7&sesID=${sesId}`, { headers: { Cookie: cookieString } });
+        const buffer1 = await response1.arrayBuffer();
+        const html1 = iconv.decode(Buffer.from(buffer1), 'windows-1251');
+        if (isLoginPage(html1))
+            return result;
+        result.disciplines = parseDisciplinesPageN7(html1);
+        result.ok = true;
+        return result;
+    }
+    catch (e) {
+        console.error('Error in getСurrentDisciplines:', e);
+        throw e;
+    }
+}

package/dist/cabinetStudent/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './disciplines.js';
+export * from './scores.js';
+export * from './cabinetStudent.js';

package/dist/cabinetStudent/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './disciplines.js';
+export * from './scores.js';
+export * from './cabinetStudent.js';

package/dist/cabinetStudent/scores.d.ts

@@ -0,0 +1,12 @@
+import { Scores } from './types.js';
+/**
+ * Отримати оцінки пвибраного предмета студента
+ * @category CabinetStudent
+ * @param sesId - ID сесії користувача
+ * @param sessGUID - GUID сесії з cookie
+ * @param prId - ID дисципліни
+ * @param semester - Семестр
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+ * @returns Масив дисциплін {@link Disciplines}
+ */
+export declare function getScores(sesId: string, sessGUID: string, prId: string, semester: 1 | 2): Promise<Scores>;

package/dist/cabinetStudent/scores.js

@@ -0,0 +1,101 @@
+import fetch from 'cross-fetch';
+import iconv from 'iconv-lite';
+import { generateCookieString, isLoginPage } from '../cabinet/session.js';
+/**
+ * Отримати оцінки пвибраного предмета студента
+ * @category CabinetStudent
+ * @param sesId - ID сесії користувача
+ * @param sessGUID - GUID сесії з cookie
+ * @param prId - ID дисципліни
+ * @param semester - Семестр
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+ * @returns Масив дисциплін {@link Disciplines}
+ */
+export async function getScores(sesId, sessGUID, prId, semester) {
+    try {
+        const result = {
+            ok: false,
+            prId: prId,
+            studentId: '',
+            scheduleItem: [],
+            studentScores: [],
+        };
+        const cookieString = generateCookieString(sessGUID);
+        const formData = `n=7&sesID=${sesId}&teacher=0&irc=0&tid=0&CYKLE=-1&prt=${prId}&hlf=${semester === 1 ? 0 : 1}&grade=0&m=-1`;
+        const encodedFormData = iconv.encode(formData, 'windows-1251');
+        const response1 = await fetch(`https://dekanat.zu.edu.ua/cgi-bin/classman.cgi?n=7&sesID=${sesId}`, {
+            method: 'POST',
+            body: new Uint8Array(encodedFormData),
+            redirect: 'manual',
+            headers: { Cookie: cookieString },
+        });
+        const buffer1 = await response1.arrayBuffer();
+        let html1 = iconv.decode(Buffer.from(buffer1), 'windows-1251');
+        if (isLoginPage(html1))
+            return result;
+        result.scheduleItem = parseSchedule(html1);
+        result.studentScores = parseScores(html1);
+        result.studentId = result.studentScores[0].id;
+        result.studentScores.sort((a, b) => a.id.localeCompare(b.id));
+        result.ok = true;
+        return result;
+    }
+    catch (e) {
+        console.error('Error in getQuestionnaireData:', e);
+        throw e;
+    }
+}
+/**
+ * Витягує список пар з 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;
+    const result = [];
+    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 });
+    }
+    return result;
+}
+/**
+ * Витягує список оцінок з HTML
+ */
+function parseScores(html) {
+    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 scoresMap = new Map();
+        for (const td of tdMatches) {
+            const dataItem = Number(td[1]);
+            const score = td[2].trim() || '';
+            if (!scoresMap.has(dataItem)) {
+                scoresMap.set(dataItem, [score]);
+            }
+            else {
+                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 finalScore = finalMatch ? finalMatch[1].trim() : '';
+        const absenceMatches = [...row.matchAll(/<td[^>]*class="f f2"[^>]*>([\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 });
+    }
+    return result;
+}