zdu-student-api 1.1.4 → 1.1.6

package/dist/schedule.js

@@ -1,40 +1,40 @@
 import iconv from 'iconv-lite';
 import fetch from 'cross-fetch';
-import { faculties } from './constants';
+import { faculties } from './constants.js';
 /**
  * Клас розкладу
  * @category Schedule
  */
 export class Schedule {
     /**
-    * Тип розкладу.
-    *
-    * Типи: group, teacher, room.
-    */
+     * Тип розкладу.
+     *
+     * Типи: group, teacher, room.
+     */
     type = 'group';
     /**
-    * Група
-    */
+     * Група
+     */
     group = '';
     /**
-    * Id групи
-    */
+     * Id групи
+     */
     groupId;
     /**
-    * Викладач
-    */
+     * Викладач
+     */
     teacher = '';
     /**
-    * Id викладача
-    */
+     * Id викладача
+     */
     teacherId;
     /**
-    * Аудиторія
-    */
+     * Аудиторія
+     */
     room = '';
     /**
-    * Id аудиторії
-    */
+     * Id аудиторії
+     */
     roomId;
     /**
      * Факультет.
@@ -49,22 +49,22 @@ export class Schedule {
      */
     faculty = faculties.none;
     /**
-    * Курс
-    *
-    * `0` - не вибрано
-    */
+     * Курс
+     *
+     * `0` - не вибрано
+     */
     course = 0;
     /**
-    * Початкова дата розкладу
-    */
+     * Початкова дата розкладу
+     */
     beginDate = new Date();
     /**
-    * Кінцева дата розкладу (за промовчанням +7 днів)
-    */
+     * Кінцева дата розкладу (за промовчанням +7 днів)
+     */
     endDate = new Date(this.beginDate.getTime() + 7 * 24 * 60 * 60 * 1000);
     /**
-    * Показувати пусті дні - false
-    */
+     * Показувати пусті дні - false
+     */
     showEmpty = false;
     /**
      * false - сформований текст (за промовчанням)
@@ -84,69 +84,75 @@ export class Schedule {
         return this._rosText;
     }
     /**
-    * Повертає список пар (розклад)
-    *
-    * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
-    *
-    * @example
-    * ```ts
-    * import { Schedule, scheduleErrors } from "./index.ts";
-    * const schedule = new Schedule();
-    * schedule.group = '23Бд-СОінф123' // встановлюєм неправильну назву групи
-    * schedule.type = 'group' // встановлєм тип пошуку по групі
-    * schedule.rosText = true; // встановлюєм окремі стовпчики
-    * schedule.allStreamComponents = true; // встановлюєм повний склад потоку
-    * try {
-    *   const mySchedule = await schedule.getSchedule();
-    *   console.log("Розклад:", mySchedule);
-    * } catch (err: any) {
-    *   // Отримуєм помилку тому що ми неправильно вказали назву групи
-    *   console.error(err.message); // Поверне: "{"error_message":"Об‘єкт - 23Бд-СОінф123 - Об‘єкт не знайдено  ","errorcode":"-90"}"
-    *   console.error(scheduleErrors[JSON.parse(err.message).errorcode]); // Поверне: "Об`єкт, для якого потрібно показати розклад, не знайдено"
-    * }
-    * ```
-    *
-    * @remarks
-    * У `err.message` може повертатися простий текст помилки,
-    * або об’єкт у форматі:
-    * ```JSON
-    * {
-    *   "error_message": "Текст помилки",
-    *   "errorcode": "Код помилки"
-    * }
-    * ```
-    *
-    * Де:
-    * - `error_message` - текст помилки відповідно до {@link scheduleErrors}
-    * - `errorcode` - код помилки відповідно до {@link scheduleErrors}
-    */
+     * Повертає список пар (розклад)
+     *
+     * @throws {Error} Якщо виникають проблеми з запитом або дані некоректні.
+     *
+     * @example
+     * ```ts
+     * import { Schedule, scheduleErrors } from "./index.ts";
+     * const schedule = new Schedule();
+     * schedule.group = '23Бд-СОінф123' // встановлюєм неправильну назву групи
+     * schedule.type = 'group' // встановлєм тип пошуку по групі
+     * schedule.rosText = true; // встановлюєм окремі стовпчики
+     * schedule.allStreamComponents = true; // встановлюєм повний склад потоку
+     * try {
+     *   const mySchedule = await schedule.getSchedule();
+     *   console.log("Розклад:", mySchedule);
+     * } catch (err: any) {
+     *   // Отримуєм помилку тому що ми неправильно вказали назву групи
+     *   console.error(err.message); // Поверне: "{"error_message":"Об‘єкт - 23Бд-СОінф123 - Об‘єкт не знайдено  ","errorcode":"-90"}"
+     *   console.error(scheduleErrors[JSON.parse(err.message).errorcode]); // Поверне: "Об`єкт, для якого потрібно показати розклад, не знайдено"
+     * }
+     * ```
+     *
+     * @remarks
+     * У `err.message` може повертатися простий текст помилки,
+     * або об’єкт у форматі:
+     * ```JSON
+     * {
+     *   "error_message": "Текст помилки",
+     *   "errorcode": "Код помилки"
+     * }
+     * ```
+     *
+     * Де:
+     * - `error_message` - текст помилки відповідно до {@link scheduleErrors}
+     * - `errorcode` - код помилки відповідно до {@link scheduleErrors}
+     */
     async getSchedule() {
         const beginDate = this.beginDate.toLocaleDateString('uk-UA', {
             day: '2-digit',
             month: '2-digit',
-            year: 'numeric'
+            year: 'numeric',
         });
         const endDate = this.endDate.toLocaleDateString('uk-UA', {
             day: '2-digit',
             month: '2-digit',
-            year: 'numeric'
+            year: 'numeric',
         });
-        let id = (this.type === 'group' ? this.groupId : this.type === 'teacher' ? this.teacherId : this.roomId);
+        let id = this.type === 'group'
+            ? this.groupId
+            : this.type === 'teacher'
+                ? this.teacherId
+                : this.roomId;
         if (!id)
             id = '';
-        let name = (this.type === 'group' ? this.group : this.type === 'teacher' ? this.teacher : this.room);
+        let name = this.type === 'group' ? this.group : this.type === 'teacher' ? this.teacher : this.room;
         name = this.encodeCP1251(name);
         const response = await fetch(`https://dekanat.zu.edu.ua/cgi-bin/timetable_export.cgi?req_type=rozklad&req_mode=${this.type}&OBJ_ID=${id}&OBJ_name=${name}&dep_name=&begin_date=${beginDate}&end_date=${endDate}&ros_text=${this.rosText ? 'separated' : 'united'}${this.showEmpty ? '' : '&show_empty=yes'}${this.allStreamComponents ? '' : '&all_stream_components=yes'}&req_format=json&coding_mode=UTF8&bs=%D1%F4%EE%F0%EC%F3%E2%E0%F2%E8+%E7%E0%EF%E8%F2`);
         if (!response.ok)
             throw new Error(`HTTP error ${response.status}: ${response.statusText}`);
         const data = await response.json();
         if (data.psrozklad_export.code !== '0') {
-            throw new Error(JSON.stringify(data.psrozklad_export.error) || "Unknown error");
+            throw new Error(JSON.stringify(data.psrozklad_export.error) || 'Unknown error');
         }
         return data.psrozklad_export.roz_items;
     }
     encodeCP1251(str) {
         const buf = iconv.encode(str, 'win1251');
-        return Array.from(buf).map(b => '%' + b.toString(16).toUpperCase().padStart(2, '0')).join('');
+        return Array.from(buf)
+            .map((b) => '%' + b.toString(16).toUpperCase().padStart(2, '0'))
+            .join('');
     }
 }

package/dist/types.d.ts

@@ -59,10 +59,10 @@ export interface Room {
     block: string;
 }
 /**
-* Типи для отримання розкладу.
-* @category Schedule
-*
-*/
+ * Типи для отримання розкладу.
+ * @category Schedule
+ *
+ */
 export type ScheduleTypes = 'group' | 'teacher' | 'room';
 /**
  * Базова інформація про заняття
@@ -139,22 +139,22 @@ export interface AudienceRoom {
     comment: string;
 }
 /**
-* Блоки
-* @category Audience
-*/
+ * Блоки
+ * @category Audience
+ */
 export type Blocks = '' | '№1' | '№2' | '№3' | '№4' | '№5' | 'гуртож №1' | 'гуртож №2' | 'гуртож №3' | 'гуртож №4' | 'гуртож №5';
 /**
-* Тип аудиторії
-* @category Audience
-*/
+ * Тип аудиторії
+ * @category Audience
+ */
 export interface TypeAudience {
     full: string;
     short: string;
 }
 /**
-* Доп. обладнання
-* @category Audience
-*/
+ * Доп. обладнання
+ * @category Audience
+ */
 export interface Dop {
     name: string;
 }

package/dist/types.js

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

package/dist/utility/dops.d.ts

@@ -1,4 +1,4 @@
-import { Dop } from "../types";
+import { Dop } from "../types.js";
 /**
 * Повертає список доп. обладнання аудиторій
 * @category Utility

package/dist/utility/groups.d.ts

@@ -1,4 +1,4 @@
-import { Group } from "../types";
+import { Group } from "../types.js";
 /**
 * Повертає список груп
 * @category Utility

package/dist/utility/rooms.d.ts

@@ -1,4 +1,4 @@
-import { Room } from "../types";
+import { Room } from "../types.js";
 /**
 * Повертає список аудиторій
 * @category Utility

package/dist/utility/teachers.d.ts

@@ -1,4 +1,4 @@
-import { Teacher } from "../types";
+import { Teacher } from "../types.js";
 /**
 * Повертає список викладачів
 * @category Utility

package/dist/utility/types-audience.d.ts

@@ -1,4 +1,4 @@
-import { TypeAudience } from "../types";
+import { TypeAudience } from "../types.js";
 /**
 * Повертає список типів аудиторій
 * @category Utility

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zdu-student-api",
-  "version": "1.1.4",
+  "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",
@@ -23,6 +23,7 @@
   "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"