zdu-student-api 1.1.6 → 1.1.8

package/dist/cabinetTeacher/cabinetTeacher.js

@@ -0,0 +1,132 @@
+import { getSesId } from '../cabinet/session.js';
+import { isValidSession } from '../cabinet/session.js';
+import { getAcademicGroups } from './academicGroups.js';
+import { getDataTeacher } from '../cabinet/data.js';
+import { getSemester } from '../cabinet/utils.js';
+/**
+ * Клас кабінету викладача
+ * @category CabinetTeacher
+ */
+export class CabinetTeacher {
+    /**
+     * Логін користувача
+     */
+    login;
+    /**
+     * Пароль від кабінету викладача
+     */
+    password;
+    /**
+     * ID сесії викладача
+     */
+    sesID;
+    /**
+     * GUID сесії з cookie
+     */
+    sessGUID;
+    /**
+     * Семестр для пошуку оцінок (0 - перший, 1 - другий)
+     */
+    semester = 1;
+    /**
+     * Данні викладача {@link DataTeacher}
+     */
+    data;
+    /**
+     * Список академічних груп {@link AcademicGroup}
+     */
+    academicGroups = [];
+    /**
+     * Конструктор
+     * @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, 'teacher');
+        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.getAcademicGroups()).ok;
+        const two = (await this.getData()).ok;
+        return one && two;
+    }
+    /**
+     * Відновлення сесії
+     */
+    async setSession(sesID, sessGUID) {
+        this.setSemester();
+        const ses = await isValidSession(sesID, sessGUID, 'teacher');
+        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, 'teacher');
+    }
+    /**
+     * Отримати всі академічні групи
+     * @returns Об'єкт академічних груп {@link AcademicGroups}
+     */
+    async getAcademicGroups() {
+        if (!this.sesID || !this.sessGUID)
+            return { ok: false, groups: [] };
+        try {
+            const academicGroupsData = await getAcademicGroups(this.sesID, this.sessGUID);
+            if (academicGroupsData.ok) {
+                this.academicGroups = academicGroupsData.groups;
+            }
+            return academicGroupsData;
+        }
+        catch {
+            return { ok: false, groups: [] };
+        }
+    }
+    /**
+     * Отримати анкетні данні викладача
+     * @returns Об'єкт {@link Data}
+     */
+    async getData() {
+        if (!this.sesID || !this.sessGUID)
+            return { ok: false };
+        try {
+            const data = await getDataTeacher(this.sesID, this.sessGUID);
+            if (data.ok) {
+                this.data = data;
+            }
+            return data;
+        }
+        catch (err) {
+            console.log(err);
+            return { ok: false };
+        }
+    }
+}

package/dist/cabinetTeacher/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './academicGroups.js';
+export * from './cabinetTeacher.js';

package/dist/cabinetTeacher/index.js

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './academicGroups.js';
+export * from './cabinetTeacher.js';

package/dist/cabinetTeacher/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Дані викладача з головної сторінки кабінету
+ * @category CabinetTeacher
+ * @remarks
+ * **Статус запиту:**
+ * - `ok` — Успіх отримання даних (true/false)
+ *
+ * **ПІБ викладача:**
+ * - `fullName` — Повне ім'я викладача (Прізвище Ім'я По батькові)
+ * - `lastName` — Прізвище
+ * - `firstName` — Ім'я
+ * - `middleName` — По батькові
+ *
+ * **Інформація про роботу:**
+ * - `department` — Назва кафедри
+ * - `partTimeHours` — Кількість годин за сумісництвом (число без "год.")
+ * - `workDurationMonths` — Тривалість роботи в навчальному році (місяців)
+ * - `totalPositionHours` — Загальна кількість годин за ставками (число без "год.")
+ * - `workloadByStaff` — Розподілене навантаження за штатом (число без "год.")
+ * - `totalWorkload` — Загальне розподілене навантаження (число без "год.")
+ */
+export interface DataTeacher {
+    ok: boolean;
+    fullName?: string;
+    lastName?: string;
+    firstName?: string;
+    middleName?: string;
+    department?: string;
+    partTimeHours?: number;
+    workDurationMonths?: number;
+    totalPositionHours?: number;
+    workloadByStaff?: number;
+    totalWorkload?: number;
+}
+/**
+ * Інформація про академічну групу
+ * @category CabinetTeacher
+ * @remarks
+ * - `name` — Назва групи (наприклад: "23Мд-СОфіз")
+ * - `semester` — Семестр: "1" (перше), "2" (друге)
+ * - `encodedName` — URL-encoded назва групи для запитів
+ * - `course` — Номер курсу (1-4)
+ * - `specialty` — Повна назва спеціальності з кодом
+ * - `faculty` — Назва факультету
+ * - `teacherId` — ID викладача з параметра teacher в URL
+ * - `journalUrl` — Відносний URL для переходу до журналу групи
+ */
+export interface AcademicGroup {
+    name: string;
+    semester: number;
+    encodedName: string;
+    course: number;
+    specialty: string;
+    faculty: string;
+    teacherId: string;
+    journalUrl: string;
+}
+/**
+ * Список академічних груп викладача
+ * @category CabinetTeacher
+ * @remarks
+ * - `ok` — Успіх отримання даних (true/false)
+ * - `groups` — Масив груп {@link Group}
+ */
+export interface AcademicGroups {
+    ok: boolean;
+    groups: AcademicGroup[];
+}

package/dist/cabinetTeacher/types.js

@@ -0,0 +1 @@
+export {};

package/dist/examples.d.ts

@@ -1 +1 @@
-export {};
+import 'dotenv/config';

package/dist/examples.js

@@ -1,4 +1,4 @@
-import { Cabinet } from './index.js';
+import 'dotenv/config';
 // const schedule = new Schedule();
 // schedule.group = '23Бд-СОінф123'
 // schedule.type = 'group'
@@ -23,9 +23,9 @@ import { Cabinet } from './index.js';
 // } catch (err: any) {
 //     console.error(err.message);
 // }
-//console.log((await getGroups('25Бд-Комп'))) // -3158
-// console.log((await getTeachers('Кривонос Олександр')))
-// console.log((await getRooms('319')))
+// console.log(await getGroups('25Бд-Комп')); // -3158
+// console.log(await getTeachers('Кривонос Олександр'));
+// console.log(await getRooms('319'));
 // const audience = new Audience();
 // audience.blockName = "гуртож №3"
 // try {
@@ -39,10 +39,10 @@ import { Cabinet } from './index.js';
 // console.log((await getSesId("FFFFF", "123456789")))
 // console.log(cb.data);
 // console.log(cb.disciplines);
-// const { sesID, sessGUID } = await getSesId('Хоречко', '1357900');
+// const { sesID, sessGUID } = await getSesId(process.env.LOGIN!, process.env.PASSWORD!);
 // console.log(sesID, sessGUID);
-// const sesID = '2850142C-AF52-4291-90C6-7EF356F90530';
-// const sessGUID = '20225423078dcb37d97904b76ba534af';
+// const sesID = '';
+// const sessGUID = '';
 // const data = await getData(sesID, sessGUID);
 // const data = await getDisciplines(sesID, sessGUID);
 // const data = await getСurrentDisciplines(sesID, sessGUID);
@@ -50,35 +50,47 @@ import { Cabinet } from './index.js';
 // const data2 = await getScores(sesID, sessGUID, '43910', 0);
 // // console.log(data2);
 // const me = data2.studentScores.find((s) => s.id === data2.studentId)!;
-const sesID = '2850142C-AF52-4291-90C6-7EF356F90530';
-const sessGUID = '20225423078dcb37d97904b76ba534af';
-const cb = new Cabinet('Хоречко', '1357900');
-// await cb.auth();
-await cb.setSession(sesID, sessGUID);
-// console.log(cb.sesID, cb.sessGUID);
-console.log(await cb.loadData());
+// 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());
+// await cb.getDisciplines();
+// console.log(await cb.getId());
 // console.log(cb.allScores);
-printFinalScores(cb.allScores, cb.disciplines);
-function printFinalScores(scoresArray, disciplines) {
-    // Створюємо мапу prId → name для швидкого доступу
-    const disciplineMap = {};
-    for (const d of disciplines) {
-        disciplineMap[d.prId] = d.name;
-    }
-    const result = {};
-    for (const scoresObj of scoresArray) {
-        const disciplineId = scoresObj.prId;
-        const disciplineName = disciplineMap[disciplineId] ?? disciplineId;
-        for (const student of scoresObj.studentScores) {
-            if (!result[student.id])
-                result[student.id] = {};
-            result[student.id][disciplineName] = student.finalScore;
-        }
-    }
-    for (const studentId in result) {
-        console.log(`Student ${studentId}:`);
-        for (const disciplineName in result[studentId]) {
-            console.log(`  ${disciplineName}: ${result[studentId][disciplineName]}`);
-        }
-    }
-}
+// printFinalScores(cb.allScores!, cb.disciplines);
+// function printFinalScores(scoresArray: Scores[], disciplines: Discipline[]) {
+//     // Створюємо мапу prId → name для швидкого доступу
+//     const disciplineMap: Record<string, string> = {};
+//     for (const d of disciplines) {
+//         disciplineMap[d.prId] = d.name;
+//     }
+//     const result: Record<string, Record<string, string>> = {};
+//     for (const scoresObj of scoresArray) {
+//         const disciplineId = scoresObj.prId;
+//         const disciplineName = disciplineMap[disciplineId] ?? disciplineId;
+//         for (const student of scoresObj.studentScores) {
+//             if (!result[student.id]) result[student.id] = {};
+//             result[student.id][disciplineName] = student.finalScore;
+//         }
+//     }
+//     for (const studentId in result) {
+//         console.log(`Student ${studentId}:`);
+//         for (const disciplineName in result[studentId]) {
+//             console.log(`  ${disciplineName}: ${result[studentId][disciplineName]}`);
+//         }
+//     }
+// }
+// const sesID = '';
+// const sessGUID = '';
+// const cb = new CabinetTeacher(process.env.LOGINT!, process.env.PASSWORDT!);
+// // console.log(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(cb.data);
+// console.log(cb.academicGroups);

package/dist/index.d.ts

@@ -8,3 +8,5 @@ export * from './audience.js';
 export * from './utility/types-audience.js';
 export * from './utility/dops.js';
 export * from './cabinet/index.js';
+export * from './cabinetStudent/index.js';
+export * from './cabinetTeacher/index.js';

package/dist/index.js

@@ -8,3 +8,5 @@ export * from './audience.js';
 export * from './utility/types-audience.js';
 export * from './utility/dops.js';
 export * from './cabinet/index.js';
+export * from './cabinetStudent/index.js';
+export * from './cabinetTeacher/index.js';

package/dist/types.d.ts

@@ -94,16 +94,17 @@ export interface BaseLesson {
  * @category Schedule
  *
  * @remarks
- * - `half` — Номер підгрупи
+ * - `half` — Половина пари (не використовується)
  * - `teacher` — Основний викладач
  * - `teachers_add` — Додаткові викладачі
  * - `room` — Аудиторія, наприклад "319/№1"
- * - `group` — Список груп, які відвідують заняття
+ * - `group` — Список груп, які відвідують заняття / підгрупа
  * - `title` — Повна назва предмету або його код
  * - `type` — Тип заняття
  * - `replacement` — Позначка про заміну пари
+ * - `reservation` — Зарезервована пара
  * - `online` — Чи є онлайн-посилання / онлайн-режим
- * - `comment4link` — Коментар до посилання (іноді використовується для Zoom/Meet)
+ * - `comment4link` — Коментар до посилання (іноді використовується для Zoom/Meet) / підгрупа / коментар
  * - `link` — Посилання на онлайн-заняття
  */
 export interface DetailedLesson extends BaseLesson {

package/package.json

@@ -1,36 +1,37 @@
 {
-  "name": "zdu-student-api",
-  "version": "1.1.6",
-  "description": "API client for ZDU student services",
-  "author": "Nicita3 <ni596157@gmail.com> (https://github.com/Nicita-3)",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "type": "module",
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "docs": "typedoc --out docs src",
-    "test": "node --loader ts-node/esm src/examples.ts",
-    "publish:all": "npm run build && npm run docs && npm publish"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Nicita-3/zdu-student-api"
-  },
-  "homepage": "https://nicita-3.github.io/zdu-student-api",
-  "devDependencies": {
-    "@types/node": "^24.10.1",
-    "prettier": "^3.7.4",
-    "ts-node": "^10.9.2",
-    "typedoc": "^0.28.14",
-    "typescript": "^5.9.3"
-  },
-  "dependencies": {
-    "buffer": "^6.0.3",
-    "cross-fetch": "^4.1.0",
-    "iconv-lite": "^0.7.0"
-  }
+    "name": "zdu-student-api",
+    "version": "1.1.8",
+    "description": "API client for ZDU student services",
+    "author": "Nicita3 <ni596157@gmail.com> (https://github.com/Nicita-3)",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "type": "module",
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "docs": "typedoc --out docs src",
+        "test": "node --loader ts-node/esm src/examples.ts",
+        "publish:all": "npm run build && npm run docs && npm publish"
+    },
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/Nicita-3/zdu-student-api"
+    },
+    "homepage": "https://nicita-3.github.io/zdu-student-api",
+    "devDependencies": {
+        "@types/node": "^24.10.1",
+        "prettier": "^3.7.4",
+        "ts-node": "^10.9.2",
+        "typedoc": "^0.28.14",
+        "typescript": "^5.9.3"
+    },
+    "dependencies": {
+        "buffer": "^6.0.3",
+        "cross-fetch": "^4.1.0",
+        "dotenv": "^17.2.3",
+        "iconv-lite": "^0.7.0"
+    }
 }