zdu-student-api 1.1.5 → 1.1.7

package/dist/cabinet/parsers.js

@@ -0,0 +1,284 @@
+/**
+ * Парсить дані з сторінки 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;
+}
+/**
+ * Парсить головну сторінку кабінету викладача
+ * @param html - HTML сторінки кабінету викладача
+ * @returns Дані викладача
+ */
+export function parseTeacherData(html) {
+    const data = { ok: false };
+    try {
+        const fullName = extractTeacherFullName(html);
+        if (fullName) {
+            data.fullName = fullName;
+            const nameParts = parseFullName(fullName);
+            Object.assign(data, nameParts);
+        }
+        data.department = extractDepartment(html);
+        data.partTimeHours = extractHoursValue(html, /за сумісництвом\s*:\s*<strong>[^0-9]*\((\d+)[^)]*\)<\/strong>/);
+        data.workDurationMonths = extractNumericValue(html, /Тривалість роботи в навч\. році \(місяців\):\s*<strong>(\d+)<\/strong>/);
+        data.totalPositionHours = extractHoursValue(html, /загалом\s*<strong>(\d+)\s*год\.<\/strong>\s*за ставками/);
+        data.workloadByStaff = extractHoursValue(html, /за штатом\s*-\s*<strong>(\d+)\s*год\.<\/strong>/);
+        const workloadSectionIndex = html.indexOf('Розподілене навчальне навантаження:');
+        if (workloadSectionIndex !== -1) {
+            const workloadSection = html.substring(workloadSectionIndex);
+            data.totalWorkload = extractHoursValue(workloadSection, /загалом\s*<strong>(\d+)\s*год\.<\/strong>/);
+        }
+        data.ok = true;
+    }
+    catch (error) {
+        data.ok = false;
+    }
+    return data;
+}
+/**
+ * Витягує повне ім'я викладача з h2 тегу
+ */
+function extractTeacherFullName(html) {
+    const h2Match = html.match(/<h2>Викладач:\s*([^<]+)<\/h2>/);
+    if (!h2Match)
+        return undefined;
+    return h2Match[1].trim();
+}
+/**
+ * Витягує назву кафедри з h3 тегу
+ */
+function extractDepartment(html) {
+    const h3Match = html.match(/<h3>Кафедра:\s*([^<]+)<\/h3>/);
+    if (!h3Match)
+        return undefined;
+    return h3Match[1].trim();
+}
+/**
+ * Витягує числове значення годин за регулярним виразом
+ */
+function extractHoursValue(html, regex) {
+    const match = html.match(regex);
+    if (!match)
+        return undefined;
+    const value = parseInt(match[1], 10);
+    return isNaN(value) ? undefined : value;
+}
+/**
+ * Витягує числове значення за регулярним виразом
+ */
+function extractNumericValue(html, regex) {
+    const match = html.match(regex);
+    if (!match)
+        return undefined;
+    const value = parseInt(match[1], 10);
+    return isNaN(value) ? undefined : value;
+}
+/**
+ * Парсить сторінку зі списком академічних груп викладача
+ * @param html - HTML сторінки "Академічні групи"
+ * @returns Список груп викладача
+ */
+export function parseGroupsPage(html, semester) {
+    try {
+        const groups = [];
+        const rowRegex = /<tr><td><a[^>]+href="\.\/teachers\.cgi\?sesID=[^"]+&n=1&grp=([^"&]+)&teacher=(\d+)"[^>]*>([^<]+)<\/a><\/td><td[^>]*>(\d+)<\/td><td>([^<]+?)<br\s*\/>\s*<em>([^<]+)<\/em><\/td><\/tr>/gi;
+        let match;
+        while ((match = rowRegex.exec(html)) !== null) {
+            const encodedName = match[1].trim();
+            const teacherId = match[2].trim();
+            const name = match[3].trim();
+            const course = parseInt(match[4].trim(), 10);
+            const specialty = match[5].trim();
+            const faculty = match[6].trim();
+            // Формуємо повний URL журналу
+            const journalUrl = `./teachers.cgi?sesID={sesID}&n=1&grp=${encodedName}&teacher=${teacherId}`;
+            groups.push({
+                name,
+                semester,
+                encodedName,
+                course,
+                specialty,
+                faculty,
+                teacherId,
+                journalUrl,
+            });
+        }
+        return groups;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Декодує назву групи з URL-encoded формату
+ * @param encodedName - URL-encoded назва групи
+ * @returns Декодована назва групи
+ */
+export function decodeGroupName(encodedName) {
+    try {
+        return decodeURIComponent(encodedName);
+    }
+    catch (error) {
+        return encodedName;
+    }
+}

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";
-/**
- * Отримати sesID та sessGUID користувача
- * @category Cabinet
- * @param family - прізвище користувача
- * @param password - пароль
- * @returns Об'єкт { sesID, sessGUID }
- */
-export declare function getSesId(family: string, password: string): Promise<SessionData>;
+import { SessionData } from './types.js';
+/**
+ * Отримати sesID та sessGUID користувача
+ * @category Cabinet
+ * @param login - Прізвище користувача
+ * @param password - Пароль
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+ * @returns Об'єкт { sesID, sessGUID }
+ */
+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";
-/**
- * Отримати sesID та sessGUID користувача
- * @category Cabinet
- * @param family - прізвище користувача
- * @param password - пароль
- * @returns Об'єкт { sesID, sessGUID }
- */
-export async function getSesId(family, 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",
-            body: new Uint8Array(encodedFormData),
-            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 = "";
-            if (cookies) {
-                const sessGUIDStart = cookies.indexOf("SessGUID=") + "SessGUID=".length;
-                const sessGUIDEnd = cookies.indexOf(";", sessGUIDStart);
-                sessGUID = cookies.substring(sessGUIDStart, sessGUIDEnd);
-            }
-            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);
-        throw e;
-    }
-}
+import fetch from 'cross-fetch';
+import iconv from 'iconv-lite';
+/**
+ * Отримати sesID та sessGUID користувача
+ * @category Cabinet
+ * @param login - Прізвище користувача
+ * @param password - Пароль
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+ * @returns Об'єкт { sesID, sessGUID }
+ */
+export async function getSesId(login, password) {
+    try {
+        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',
+        });
+        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 = '';
+            if (cookies) {
+                const sessGUIDStart = cookies.indexOf('SessGUID=') + 'SessGUID='.length;
+                const sessGUIDEnd = cookies.indexOf(';', sessGUIDStart);
+                sessGUID = cookies.substring(sessGUIDStart, sessGUIDEnd);
+            }
+            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);
+        throw e;
+    }
+}

package/dist/cabinet/session.d.ts

@@ -0,0 +1,33 @@
+import { SessionData } from './types.js';
+/**
+ * Отримати sesID та sessGUID користувача
+ * @category Cabinet
+ * @param login - Прізвище користувача
+ * @param password - Пароль
+ * @param type - тип кабінету 'student' | 'teacher'
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+ * @returns Об'єкт { sesID, sessGUID }
+ */
+export declare function getSesId(login: string, password: string, type: 'student' | 'teacher'): Promise<SessionData>;
+/**
+ * Перевірка на валідність сесії
+ * @category Cabinet
+ * @param sesId - ID сесії користувача
+ * @param sessGUID - GUID сесії з cookie
+ * @param type - тип кабінету 'student' | 'teacher'
+ * @returns boolean значення.
+ */
+export declare function isValidSession(sesId: string, sessGUID: string, type: 'student' | 'teacher'): Promise<boolean>;
+/**
+ * Генерує cookie строку з DateTime та SessGUID
+ * @category Cabinet
+ * @param sessGUID - GUID сесії з cookie
+ * @returns cookie рядок
+ */
+export declare function generateCookieString(sessGUID: string): string;
+/**
+ * Перевірка чи є отримана сторінка сторінкою авторизації
+ * @category Cabinet
+ * @returns true | false
+ */
+export declare function isLoginPage(html: string): boolean;

package/dist/cabinet/session.js

@@ -0,0 +1,99 @@
+import fetch from 'cross-fetch';
+import iconv from 'iconv-lite';
+/**
+ * Отримати sesID та sessGUID користувача
+ * @category Cabinet
+ * @param login - Прізвище користувача
+ * @param password - Пароль
+ * @param type - тип кабінету 'student' | 'teacher'
+ * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+ * @returns Об'єкт { sesID, sessGUID }
+ */
+export async function getSesId(login, password, type) {
+    try {
+        const urlStudent = 'https://dekanat.zu.edu.ua/cgi-bin/classman.cgi?n=1&ts=16161';
+        const urlTeacher = 'https://dekanat.zu.edu.ua/cgi-bin/kaf.cgi?n=1&ts=28888';
+        const formData = `user_name=${login}&user_pwd=${password}${type == 'student' ? '&n=1&rout=&t=16161' : '&n=1&rout=&t=1'}`;
+        const encodedFormData = iconv.encode(formData, 'windows-1251');
+        const response = await fetch(type == 'student' ? urlStudent : urlTeacher, {
+            method: 'POST',
+            body: new Uint8Array(encodedFormData),
+            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 = '';
+            if (cookies) {
+                const sessGUIDStart = cookies.indexOf('SessGUID=') + 'SessGUID='.length;
+                const sessGUIDEnd = cookies.indexOf(';', sessGUIDStart);
+                sessGUID = cookies.substring(sessGUIDStart, sessGUIDEnd);
+            }
+            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);
+        throw e;
+    }
+}
+/**
+ * Перевірка на валідність сесії
+ * @category Cabinet
+ * @param sesId - ID сесії користувача
+ * @param sessGUID - GUID сесії з cookie
+ * @param type - тип кабінету 'student' | 'teacher'
+ * @returns boolean значення.
+ */
+export async function isValidSession(sesId, sessGUID, type) {
+    const urlStudent = 'https://dekanat.zu.edu.ua/cgi-bin/classman.cgi?n=3&sesID=';
+    const urlTeacher = 'https://dekanat.zu.edu.ua/cgi-bin/kaf.cgi?n=2&sesID=';
+    try {
+        const cookieString = generateCookieString(sessGUID);
+        const response = await fetch(`${type == 'student' ? urlStudent : urlTeacher}${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;
+    }
+}
+/**
+ * Генерує cookie строку з DateTime та SessGUID
+ * @category Cabinet
+ * @param sessGUID - GUID сесії з cookie
+ * @returns cookie рядок
+ */
+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}`;
+}
+/**
+ * Перевірка чи є отримана сторінка сторінкою авторизації
+ * @category Cabinet
+ * @returns true | false
+ */
+export function isLoginPage(html) {
+    return (html.includes('Авторизація користувача') ||
+        html.includes('user_name') ||
+        html.includes('Недійсний ідентифікатор сесії користувача'));
+}

package/dist/cabinet/types.d.ts

@@ -3,8 +3,8 @@
  * @category Cabinet
  * @remarks
  * - `ok` — Успіх отримання токену
- * - `sesID` — Айді сесії
- * - `sessGUID` — Унікальний token у cookie для ідентифікації сесії
+ * - `sesID` — ID сесії користувача
+ * - `sessGUID` — GUID сесії з cookie
  */
 export interface SessionData {
     ok: boolean;

package/dist/cabinet/utils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Отримати ймовірний семестр поточної дати
+ * @category Cabinet
+ * @remarks
+ * З 2 вересня по кінець січня - перший семестр
+ * З 1 лютого по 1 вересня - другий семестр
+ */
+export declare function getSemester(): 1 | 2;