zdu-student-api 1.1.6 → 1.1.8

package/dist/cabinet/sesId.js

@@ -1,40 +1,40 @@
-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;
-    }
-}
+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

@@ -11,140 +11,3 @@ export interface SessionData {
     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

@@ -1,8 +1,8 @@
 /**
- * Перевіряє чи є це сторінка авторизації
+ * Отримати ймовірний семестр поточної дати
+ * @category Cabinet
+ * @remarks
+ * З 2 вересня по кінець січня - перший семестр
+ * З 1 лютого по 1 вересня - другий семестр
  */
-export declare function isLoginPage(html: string): boolean;
-/**
- * Генерує cookie строку з DateTime та SessGUID
- */
-export declare function generateCookieString(sessGUID: string): string;
+export declare function getSemester(): 1 | 2;

package/dist/cabinet/utils.js

@@ -1,22 +1,19 @@
 /**
- * Перевіряє чи є це сторінка авторизації
+ * Отримати ймовірний семестр поточної дати
+ * @category Cabinet
+ * @remarks
+ * З 2 вересня по кінець січня - перший семестр
+ * З 1 лютого по 1 вересня - другий семестр
  */
-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}`;
+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

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

@@ -1,29 +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;
-    }
-}
+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>;
+}