zdu-student-api 1.1.5 → 1.1.6

package/dist/cabinet/disciplines.js

@@ -0,0 +1,87 @@
+import fetch from 'cross-fetch';
+import iconv from 'iconv-lite';
+import { parseDisciplinesPageN6, parseDisciplinesPageN7 } from './parsers.js';
+import { generateCookieString, isLoginPage } from './utils.js';
+/**
+ * Отримати всі дисципліни студента
+ * @category Cabinet
+ * @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 Cabinet
+ * @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);
+        //console.log(html1);
+        result.ok = true;
+        return result;
+    }
+    catch (e) {
+        console.error('Error in getСurrentDisciplines:', e);
+        throw e;
+    }
+}

package/dist/cabinet/index.d.ts

@@ -1,2 +1,6 @@
-export * from "./sesId.js";
-export * from "./types.js";
+export * from './sesId.js';
+export * from './types.js';
+export * from './data.js';
+export * from './disciplines.js';
+export * from './scores.js';
+export * from './cabinet.js';

package/dist/cabinet/index.js

@@ -1,2 +1,6 @@
-export * from "./sesId.js";
-export * from "./types.js";
+export * from './sesId.js';
+export * from './types.js';
+export * from './data.js';
+export * from './disciplines.js';
+export * from './scores.js';
+export * from './cabinet.js';

package/dist/cabinet/parsers.d.ts

@@ -0,0 +1,18 @@
+import { Discipline, Data } from './types.js';
+/**
+ * Парсить дані з сторінки n=31 (анкетні дані)
+ */
+export declare function parseDataPageN31(html: string): Partial<Data>;
+/**
+ * Парсить дані з сторінки n=3 (загальна інформація)
+ */
+export declare function parseDataPageN3(html: string): Partial<Data>;
+/**
+ * Парсить сторінку "Семестрові бали" (n=6) і повертає список дисциплін
+ */
+export declare function parseDisciplinesPageN6(html: string): Discipline[];
+/**
+ * Парсить HTML і повертає масив дисциплін (n=7)
+ * @param html - HTML сторінки з select[id="prt"]
+ */
+export declare function parseDisciplinesPageN7(html: string): Discipline[];

package/dist/cabinet/parsers.js

@@ -0,0 +1,166 @@
+/**
+ * Парсить дані з сторінки n=31 (анкетні дані)
+ */
+export function parseDataPageN31(html) {
+    const data = {};
+    const fullName = extractFullName(html);
+    if (fullName) {
+        data.fullName = fullName;
+        const nameParts = parseFullName(fullName);
+        Object.assign(data, nameParts);
+    }
+    data.birthDate = extractStrongValue(html, 'Дата народження');
+    data.gender = extractStrongValue(html, 'Стать');
+    data.previousFullName = extractStrongValue(html, 'Попереднє ПІБ студента');
+    data.country = extractStrongValue(html, 'Країна, з якої навчається студент');
+    data.lastNameEng = extractStrongValue(html, 'Прізвище англ.');
+    data.firstNameEng = extractStrongValue(html, 'Ім`я англ.');
+    data.middleNameEng = extractStrongValue(html, 'По батькові англ.');
+    data.email = extractStrongValue(html, 'E-mail:');
+    const phonesStr = extractStrongValue(html, 'Телефон(и)');
+    if (phonesStr) {
+        data.phones = phonesStr
+            .split(';')
+            .map((p) => p.trim())
+            .filter((p) => p.length > 0);
+    }
+    return data;
+}
+/**
+ * Парсить дані з сторінки n=3 (загальна інформація)
+ */
+export function parseDataPageN3(html) {
+    const data = {};
+    const extractFromParagraph = (label) => {
+        const labelIdx = html.indexOf(label);
+        if (labelIdx === -1)
+            return undefined;
+        const pStart = html.lastIndexOf('<p>', labelIdx);
+        if (pStart === -1)
+            return undefined;
+        const pEnd = html.indexOf('</p>', labelIdx);
+        if (pEnd === -1)
+            return undefined;
+        const pContent = html.substring(pStart, pEnd);
+        const strongMatch = pContent.match(/<strong>([^<]+)<\/strong>/);
+        if (!strongMatch)
+            return undefined;
+        const value = strongMatch[1].trim();
+        return value.length > 0 ? value : undefined;
+    };
+    data.faculty = extractFromParagraph('Факультет');
+    const specialtyPIdx = html.indexOf('Спеціальність');
+    if (specialtyPIdx !== -1) {
+        const pStart = html.lastIndexOf('<p>', specialtyPIdx);
+        const pEnd = html.indexOf('</p>', specialtyPIdx);
+        if (pStart !== -1 && pEnd !== -1) {
+            const pContent = html.substring(pStart, pEnd);
+            const specialtyMatch = pContent.match(/<strong>"([^"]+)"<\/strong>/) ||
+                pContent.match(/<strong>([^<]+)<\/strong>/);
+            if (specialtyMatch)
+                data.specialty = specialtyMatch[1].trim();
+        }
+    }
+    data.degree = extractFromParagraph('Ступінь / Освітньо-професійний ступінь');
+    data.group = extractFromParagraph('Группа');
+    data.studyForm = extractFromParagraph('Форма навчання');
+    data.paymentForm = extractFromParagraph('Форма оплати навчання');
+    data.studyDuration = extractFromParagraph('Термін навчання');
+    data.graduationDate = extractFromParagraph('Дата закінчення навчання');
+    const orderIdx = html.indexOf('Наказ на зарахування');
+    if (orderIdx !== -1) {
+        const pStart = html.lastIndexOf('<p>', orderIdx);
+        const pEnd = html.indexOf('</p>', orderIdx);
+        if (pStart !== -1 && pEnd !== -1) {
+            const pContent = html.substring(pStart, pEnd);
+            const orderMatch = pContent.match(/Наказ на зарахування\s+<strong>([^<]+)<\/strong>\s+від\s+<strong>([^<]+)<\/strong>/);
+            if (orderMatch) {
+                data.enrollmentOrder = orderMatch[1].trim();
+                data.enrollmentDate = orderMatch[2].trim();
+            }
+        }
+    }
+    return data;
+}
+/**
+ * Витягує значення з HTML після label до кінця li тегу
+ */
+function extractStrongValue(html, label) {
+    const labelIdx = html.indexOf(label);
+    if (labelIdx === -1)
+        return undefined;
+    const liStart = html.lastIndexOf('<li>', labelIdx);
+    if (liStart === -1)
+        return undefined;
+    const liEnd = html.indexOf('</li>', labelIdx);
+    if (liEnd === -1)
+        return undefined;
+    const liContent = html.substring(liStart, liEnd);
+    const strongMatch = liContent.match(/<strong>(.*?)<\/strong>/);
+    if (!strongMatch)
+        return undefined;
+    const value = strongMatch[1].trim();
+    return value.length > 0 ? value : undefined;
+}
+/**
+ * Витягує повне ім'я з h3 тегу
+ */
+function extractFullName(html) {
+    const h2Idx = html.indexOf('<h2>Анкетні дані студента</h2>');
+    if (h2Idx === -1)
+        return undefined;
+    const h3Match = html.substring(h2Idx).match(/<h3>([^<]+)<\/h3>/);
+    if (!h3Match)
+        return undefined;
+    return h3Match[1].trim();
+}
+/**
+ * Парсить повне ім'я на прізвище, ім'я та по батькові
+ */
+function parseFullName(fullName) {
+    const parts = fullName.trim().split(/\s+/);
+    if (parts.length === 0)
+        return {};
+    if (parts.length === 1)
+        return { lastName: parts[0] };
+    if (parts.length === 2)
+        return { lastName: parts[0], firstName: parts[1] };
+    return {
+        lastName: parts[0],
+        firstName: parts[1],
+        middleName: parts.slice(2).join(' '),
+    };
+}
+/**
+ * Парсить сторінку "Семестрові бали" (n=6) і повертає список дисциплін
+ */
+export function parseDisciplinesPageN6(html) {
+    const result = [];
+    const rowRegex = /<tr>\s*<td>([^<]+)<\/td>\s*<td>\d+<\/td>\s*<td>[\s\S]*?<a[^>]+href="[^"]*prID=(\d+)[^"]*"[\s\S]*?<\/a>[\s\S]*?<\/td>\s*<\/tr>/gi;
+    let match;
+    while ((match = rowRegex.exec(html)) !== null) {
+        const name = match[1].trim();
+        const prId = match[2].trim();
+        if (name && prId) {
+            result.push({ name, prId });
+        }
+    }
+    return result;
+}
+/**
+ * Парсить HTML і повертає масив дисциплін (n=7)
+ * @param html - HTML сторінки з select[id="prt"]
+ */
+export function parseDisciplinesPageN7(html) {
+    const disciplines = [];
+    const optionRegex = /<option\s+value="(\d+)">([\s\S]*?)<\/option>/g;
+    let match;
+    while ((match = optionRegex.exec(html)) !== null) {
+        const value = match[1];
+        const name = match[2].trim();
+        if (value !== '-1') {
+            disciplines.push({ prId: value, name });
+        }
+    }
+    return disciplines;
+}

package/dist/cabinet/scores.d.ts

@@ -0,0 +1,12 @@
+import { Scores } from './types.js';
+/**
+ * Отримати оцінки пвибраного предмета студента
+ * @category Cabinet
+ * @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: 0 | 1): Promise<Scores>;

package/dist/cabinet/scores.js

@@ -0,0 +1,101 @@
+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
+ * @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}&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;
+}

package/dist/cabinet/sesId.d.ts

@@ -1,9 +1,10 @@
-import { SessionData } from "./types.js";
+import { SessionData } from './types.js';
 /**
  * Отримати sesID та sessGUID користувача
  * @category Cabinet
- * @param family - прізвище користувача
- * @param password - пароль
+ * @param login - Прізвище користувача
+ * @param password - Пароль
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
  * @returns Об'єкт { sesID, sessGUID }
  */
-export declare function getSesId(family: string, password: string): Promise<SessionData>;
+export declare function getSesId(login: string, password: string): Promise<SessionData>;

package/dist/cabinet/sesId.js

@@ -1,39 +1,40 @@
 import fetch from 'cross-fetch';
-import iconv from "iconv-lite";
+import iconv from 'iconv-lite';
 /**
  * Отримати sesID та sessGUID користувача
  * @category Cabinet
- * @param family - прізвище користувача
- * @param password - пароль
+ * @param login - Прізвище користувача
+ * @param password - Пароль
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
  * @returns Об'єкт { sesID, sessGUID }
  */
-export async function getSesId(family, password) {
+export async function getSesId(login, password) {
     try {
-        const formData = `user_name=${family}&user_pwd=${password}&n=1&rout=&t=16161`;
-        const encodedFormData = iconv.encode(formData, "windows-1251");
-        const response = await fetch("https://dekanat.zu.edu.ua/cgi-bin/classman.cgi?n=1&ts=16161", {
-            method: "POST",
+        const formData = `user_name=${login}&user_pwd=${password}&n=1&rout=&t=16161`;
+        const encodedFormData = iconv.encode(formData, 'windows-1251');
+        const response = await fetch('https://dekanat.zu.edu.ua/cgi-bin/classman.cgi?n=1&ts=16161', {
+            method: 'POST',
             body: new Uint8Array(encodedFormData),
-            redirect: "manual",
+            redirect: 'manual',
         });
         if (response.status === 302) {
             const buffer = await response.arrayBuffer();
-            const responseText = iconv.decode(Buffer.from(buffer), "utf-8");
-            const cookies = response.headers.get("set-cookie");
-            let sessGUID = "";
+            const responseText = iconv.decode(Buffer.from(buffer), 'utf-8');
+            const cookies = response.headers.get('set-cookie');
+            let sessGUID = '';
             if (cookies) {
-                const sessGUIDStart = cookies.indexOf("SessGUID=") + "SessGUID=".length;
-                const sessGUIDEnd = cookies.indexOf(";", sessGUIDStart);
+                const sessGUIDStart = cookies.indexOf('SessGUID=') + 'SessGUID='.length;
+                const sessGUIDEnd = cookies.indexOf(';', sessGUIDStart);
                 sessGUID = cookies.substring(sessGUIDStart, sessGUIDEnd);
             }
-            const sesIDIndex = responseText.indexOf("sesID=") + 6;
+            const sesIDIndex = responseText.indexOf('sesID=') + 6;
             const sesID = responseText.substring(sesIDIndex, sesIDIndex + 36);
             return { ok: true, sesID, sessGUID };
         }
         return { ok: false, sesID: '', sessGUID: '' };
     }
     catch (e) {
-        console.error("Error in getSesID:", e);
+        console.error('Error in getSesID:', e);
         throw e;
     }
 }

package/dist/cabinet/types.d.ts

@@ -3,11 +3,148 @@
  * @category Cabinet
  * @remarks
  * - `ok` — Успіх отримання токену
- * - `sesID` — Айді сесії
- * - `sessGUID` — Унікальний token у cookie для ідентифікації сесії
+ * - `sesID` — ID сесії користувача
+ * - `sessGUID` — GUID сесії з cookie
  */
 export interface SessionData {
     ok: boolean;
     sesID: string;
     sessGUID: string;
 }
+/**
+ * Анкетні дані студента
+ * @category Cabinet
+ * @remarks
+ * **Статус запиту:**
+ * - `ok` — Успіх отримання даних (true/false)
+ *
+ * **ПІБ студента:**
+ * - `fullName` — Повне ім'я студента (Прізвище Ім'я По батькові)
+ * - `lastName` — Прізвище
+ * - `firstName` — Ім'я
+ * - `middleName` — По батькові
+ *
+ * **Загальні дані:**
+ * - `birthDate` — Дата народження (формат: DD.MM.YYYY)
+ * - `gender` — Стать (Чол/Жін)
+ * - `previousFullName` — Попереднє ПІБ студента (якщо змінювалось)
+ * - `country` — Країна, з якої навчається студент
+ * - `lastNameEng` — Прізвище англійською
+ * - `firstNameEng` — Ім'я англійською
+ * - `middleNameEng` — По батькові англійською (зазвичай немає)
+ *
+ * **Контактні дані:**
+ * - `email` — Електронна пошта студента
+ * - `phones` — Масив телефонних номерів студента
+ *
+ * **Дані про навчання:**
+ * - `faculty` — Факультет
+ * - `specialty` — Спеціальність (назва освітньої програми)
+ * - `degree` — Ступінь / Освітньо-професійний ступінь (бакалавр, магістр тощо)
+ * - `group` — Академічна група
+ * - `studyForm` — Форма навчання (Денна, Заочна, Вечірня)
+ * - `paymentForm` — Форма оплати навчання (Держ.замовлення, Контракт)
+ * - `enrollmentOrder` — Номер наказу на зарахування
+ * - `enrollmentDate` — Дата наказу на зарахування (формат: DD.MM.YYYY)
+ * - `studyDuration` — Термін навчання (наприклад: "4 роки")
+ * - `graduationDate` — Дата закінчення навчання (формат: DD.MM.YYYY)
+ */
+export interface Data {
+    ok: boolean;
+    fullName?: string;
+    lastName?: string;
+    firstName?: string;
+    middleName?: string;
+    birthDate?: string;
+    gender?: string;
+    previousFullName?: string;
+    country?: string;
+    lastNameEng?: string;
+    firstNameEng?: string;
+    middleNameEng?: string;
+    email?: string;
+    phones?: string[];
+    faculty?: string;
+    specialty?: string;
+    degree?: string;
+    group?: string;
+    studyForm?: string;
+    paymentForm?: string;
+    enrollmentOrder?: string;
+    enrollmentDate?: string;
+    studyDuration?: string;
+    graduationDate?: string;
+}
+/**
+ * name та prId дисципліни
+ * @category Cabinet
+ * @remarks
+ * - `name` — Повна назва дисципліни
+ * - `prId` — Айді дисципліни
+ */
+export interface Discipline {
+    name: string;
+    prId: string;
+}
+/**
+ * name та prId дисципліни
+ * @category Cabinet
+ * @remarks
+ * - `ok` — Успіх отримання токену
+ * - `disciplines` — Масив дисциплін {@link Discipline}
+ */
+export interface Disciplines {
+    ok: boolean;
+    disciplines: Discipline[];
+}
+/**
+ * Опис заняття у кабінеті студента
+ * @category Cabinet
+ * @remarks
+ * - `teacher` — Прізвище та ініціали викладача
+ * - `date` — Дата заняття у форматі "dd.mm.yyyy"
+ * - `type` — Тип заняття: "Лек", "ПрСем", "Лаб", "МК", "Екз"
+ * - `time` — Час заняття у форматі "HH:MM-HH:MM"
+ * - `index` — Значення атрибута `data-ind`, унікальний ідентифікатор
+ */
+export interface ScheduleItem {
+    teacher: string;
+    date: string;
+    type: string;
+    time: string;
+    index: string;
+}
+/**
+ * Список оцінок студента.
+ * @category Cabinet
+ * @remarks
+ * - `id` — Унікальний ідентифікатор студента
+ * - `scores` — Оцінки по днях, масив масивів рядків (перший елемент - основна оцінка, другий елемент - оцінка перездачі)
+ * - `absences` — Кількість пропусків
+ * - `uabsences` — Кількість невиправлених пропусків
+ * - `finalScore` — Фінальна оцінка
+ */
+export interface StudentScores {
+    id: string;
+    scores: string[][];
+    absences: number;
+    uabsences: number;
+    finalScore: string;
+}
+/**
+ * Об'єкт оцінок з предмету.
+ * @category Cabinet
+ * @remarks
+ * - `ok` — Успіх отримання токену
+ * - `prId` — Айді дисципліни
+ * - `studentId` — Унікальний айді студента для предметів
+ * - `scheduleItem` — Опис заняття у кабінеті студента {@link ScheduleItem}
+ * - `studentScores` — Список оцінок студента {@link StudentScores}
+ */
+export interface Scores {
+    ok: boolean;
+    prId: string;
+    studentId: string;
+    scheduleItem: ScheduleItem[];
+    studentScores: StudentScores[];
+}

package/dist/cabinet/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Перевіряє чи є це сторінка авторизації
+ */
+export declare function isLoginPage(html: string): boolean;
+/**
+ * Генерує cookie строку з DateTime та SessGUID
+ */
+export declare function generateCookieString(sessGUID: string): string;

package/dist/cabinet/utils.js

@@ -0,0 +1,22 @@
+/**
+ * Перевіряє чи є це сторінка авторизації
+ */
+export function isLoginPage(html) {
+    return (html.includes('Авторизація користувача') ||
+        html.includes('user_name') ||
+        html.includes('Недійсний ідентифікатор сесії користувача'));
+}
+/**
+ * Генерує cookie строку з DateTime та SessGUID
+ */
+export function generateCookieString(sessGUID) {
+    const now = new Date();
+    const day = String(now.getDate()).padStart(2, '0');
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const year = now.getFullYear();
+    const hours = String(now.getHours()).padStart(2, '0');
+    const minutes = String(now.getMinutes()).padStart(2, '0');
+    const seconds = String(now.getSeconds()).padStart(2, '0');
+    const dateTime = `${day}.${month}.${year}+${hours}%3A${minutes}%3A${seconds}`;
+    return `DateTime=${dateTime}; SessGUID=${sessGUID}`;
+}

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>;