chuvsu-js 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Artemy Egorov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,229 @@
+# chuvsu-js
+
+Node.js библиотека для работы с порталами ЧувГУ:
+
+- **tt.chuvsu.ru** — расписание занятий (факультеты, группы, преподаватели)
+- **lk.chuvsu.ru** — личный кабинет студента (персональные данные)
+
+Пока что очень сырая, много что можно оптимизировать.
+
+## Установка
+
+```bash
+npm install chuvsu-js
+```
+
+## Быстрый старт
+
+### Расписание (TtClient)
+
+```ts
+import { TtClient } from "chuvsu-js";
+
+const tt = new TtClient();
+
+// Войти гостем (без учётной записи)
+await tt.loginAsGuest();
+
+// Найти группу по названию
+const groups = await tt.searchGroup({ name: "КТ-41-24" });
+console.log(groups); // [{ id: 123, name: "КТ-41-24", specialty: "...", profile: "..." }]
+
+// Получить расписание на сегодня
+const lessons = await tt.getScheduleForDate({
+  groupId: groups[0].id,
+  date: new Date(),
+});
+
+for (const lesson of lessons) {
+  console.log(
+    `${lesson.start.hours}:${lesson.start.minutes} — ${lesson.subject} (${lesson.type})`,
+  );
+}
+```
+
+### Личный кабинет (LkClient)
+
+```ts
+import { LkClient } from "chuvsu-js";
+
+const lk = new LkClient();
+await lk.login({ email: "student@mail.ru", password: "password" });
+
+const data = await lk.getPersonalData();
+console.log(`${data.lastName} ${data.firstName}, группа ${data.group}`);
+
+// Получить ID группы для использования с TtClient
+const groupId = await lk.getGroupId();
+```
+
+## API
+
+### TtClient
+
+Клиент для работы с расписанием (`tt.chuvsu.ru`).
+
+#### Конструктор
+
+```ts
+new TtClient(options?: TtClientOptions)
+```
+
+| Опция           | Тип                     | По умолчанию      | Описание                                                       |
+| --------------- | ----------------------- | ----------------- | -------------------------------------------------------------- |
+| `educationType` | `EducationType`         | `HigherEducation` | Тип образования: высшее (1) или СПО (2)                        |
+| `cache`         | `number \| CacheConfig` | —                 | TTL кеша в мс. Число задаёт единый TTL, объект — по категориям |
+
+#### Авторизация
+
+```ts
+// С учётной записью
+await tt.login({ email: "...", password: "..." });
+
+// Гостевой вход
+await tt.loginAsGuest();
+```
+
+#### Расписание
+
+```ts
+// Полное расписание группы (все дни, все слоты)
+const schedule = await tt.getGroupSchedule({ groupId, period? });
+
+// Расписание на конкретную дату
+const lessons = await tt.getScheduleForDate({ groupId, date, filter?, period? });
+
+// Расписание на день недели (0 = воскресенье, 1 = понедельник, ...)
+const lessons = await tt.getScheduleForDay({ groupId, weekday, filter?, period? });
+
+// Расписание на неделю
+const week = await tt.getScheduleForWeek({ groupId, week?, filter?, period? });
+
+// Текущая пара
+const lesson = await tt.getCurrentLesson({ groupId, filter? });
+```
+
+**ScheduleFilter** — фильтрация по подгруппе и/или неделе:
+
+```ts
+{ subgroup?: number; week?: number }
+```
+
+#### Поиск
+
+```ts
+// Список факультетов
+const faculties = await tt.getFaculties();
+
+// Группы факультета
+const groups = await tt.getGroupsForFaculty({ facultyId });
+
+// Поиск группы по названию
+const groups = await tt.searchGroup({ name: "ЗИ" });
+
+// Поиск преподавателя
+const teachers = await tt.searchTeacher({ name: "Иванов" });
+```
+
+#### Кеш
+
+```ts
+// Очистить весь кеш или по категории
+tt.clearCache();
+tt.clearCache("schedule");
+
+// Экспорт/импорт (для сохранения между запусками)
+const data = tt.exportCache();
+tt.importCache(data);
+```
+
+Категории кеша: `schedule`, `faculties`, `groups`, `currentPeriod`.
+
+#### Утилиты семестра
+
+```ts
+import {
+  getSemesterStart,
+  getSemesterWeeks,
+  getWeekNumber,
+  Period,
+} from "chuvsu-js";
+
+// Начало семестра
+getSemesterStart({ period: Period.FallSemester, year: 2025 });
+
+// Все недели семестра
+getSemesterWeeks({ period: Period.SpringSemester });
+
+// Номер текущей недели
+getWeekNumber({ period: Period.SpringSemester });
+```
+
+### LkClient
+
+Клиент для личного кабинета (`lk.chuvsu.ru`).
+
+```ts
+await lk.login({ email, password });
+const data = await lk.getPersonalData();
+const groupId = await lk.getGroupId();
+```
+
+**PersonalData** содержит: `lastName`, `firstName`, `patronymic`, `sex`, `birthday`, `recordBookNumber`, `faculty`, `specialty`, `profile`, `group`, `course`, `email`, `phone`.
+
+## Типы
+
+### Period
+
+```ts
+enum Period {
+  FallSemester = 1, // Осенний семестр
+  WinterSession = 2, // Зимняя сессия
+  SpringSemester = 3, // Весенний семестр
+  SummerSession = 4, // Летняя сессия
+}
+```
+
+### EducationType
+
+```ts
+enum EducationType {
+  HigherEducation = 1, // Высшее образование
+  VocationalEducation = 2, // СПО
+}
+```
+
+### Lesson
+
+```ts
+interface Lesson {
+  number: number; // Номер пары
+  start: LessonTime; // Начало { date, hours, minutes }
+  end: LessonTime; // Конец { date, hours, minutes }
+  subject: string; // Предмет
+  type: string; // Тип (лекция, практика, лаб. работа)
+  room: string; // Аудитория
+  teacher: Teacher; // Преподаватель { name, position?, degree? }
+  weeks: WeekRange; // Диапазон недель { from, to }
+  subgroup?: number; // Подгруппа
+  weekParity?: "even" | "odd"; // Чётность недели
+}
+```
+
+## Обработка ошибок
+
+```ts
+import { AuthError, ParseError } from "chuvsu-js";
+
+try {
+  await tt.login({ email: "...", password: "wrong" });
+} catch (e) {
+  if (e instanceof AuthError) {
+    console.error("Неверные данные для входа");
+  }
+}
+```
+
+## Лицензия
+
+MIT

package/dist/common/cache.d.ts

@@ -0,0 +1,14 @@
+export interface CacheEntry {
+    data: unknown;
+    timestamp: number;
+}
+export declare class Cache {
+    private ttls;
+    private store;
+    constructor(ttls: Record<string, number | undefined>);
+    get(category: string, key: string): unknown | null;
+    set(category: string, key: string, data: unknown): void;
+    clear(category?: string): void;
+    export(): Record<string, CacheEntry>;
+    import(data: Record<string, CacheEntry>): void;
+}

package/dist/common/cache.js

@@ -0,0 +1,48 @@
+export class Cache {
+    ttls;
+    store = new Map();
+    constructor(ttls) {
+        this.ttls = ttls;
+    }
+    get(category, key) {
+        const ttl = this.ttls[category];
+        if (ttl == null)
+            return null;
+        const entry = this.store.get(`${category}:${key}`);
+        if (!entry)
+            return null;
+        if (ttl !== Infinity && Date.now() - entry.timestamp > ttl) {
+            this.store.delete(`${category}:${key}`);
+            return null;
+        }
+        return entry.data;
+    }
+    set(category, key, data) {
+        if (this.ttls[category] == null)
+            return;
+        this.store.set(`${category}:${key}`, {
+            data,
+            timestamp: Date.now(),
+        });
+    }
+    clear(category) {
+        if (!category) {
+            this.store.clear();
+            return;
+        }
+        const prefix = `${category}:`;
+        for (const key of this.store.keys()) {
+            if (key.startsWith(prefix)) {
+                this.store.delete(key);
+            }
+        }
+    }
+    export() {
+        return Object.fromEntries(this.store);
+    }
+    import(data) {
+        for (const [key, entry] of Object.entries(data)) {
+            this.store.set(key, entry);
+        }
+    }
+}

package/dist/common/certs.d.ts

@@ -0,0 +1,5 @@
+/** GlobalSign GCC R3 DV TLS CA 2020 (intermediate) */
+export declare const GLOBALSIGN_GCC_R3_DV_TLS_CA_2020 = "-----BEGIN CERTIFICATE-----\nMIIEsDCCA5igAwIBAgIQd70OB0LV2enQSdd00CpvmjANBgkqhkiG9w0BAQsFADBM\nMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEGA1UEChMKR2xv\nYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjAeFw0yMDA3MjgwMDAwMDBaFw0y\nOTAzMTgwMDAwMDBaMFMxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWdu\nIG52LXNhMSkwJwYDVQQDEyBHbG9iYWxTaWduIEdDQyBSMyBEViBUTFMgQ0EgMjAy\nMDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKxnlJV/de+OpwyvCXAJ\nIcxPCqkFPh1lttW2oljS3oUqPKq8qX6m7K0OVKaKG3GXi4CJ4fHVUgZYE6HRdjqj\nhhnuHY6EBCBegcUFgPG0scB12Wi8BHm9zKjWxo3Y2bwhO8Fvr8R42pW0eINc6OTb\nQXC0VWFCMVzpcqgz6X49KMZowAMFV6XqtItcG0cMS//9dOJs4oBlpuqX9INxMTGp\n6EASAF9cnlAGy/RXkVS9nOLCCa7pCYV+WgDKLTF+OK2Vxw3RUJ/p8009lQeUARv2\nUCcNNPCifYX1xIspvarkdjzLwzOdLahDdQbJON58zN4V+lMj0msg+c0KnywPIRp3\nBMkCAwEAAaOCAYUwggGBMA4GA1UdDwEB/wQEAwIBhjAdBgNVHSUEFjAUBggrBgEF\nBQcDAQYIKwYBBQUHAwIwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQUDZjA\nc3+rvb3ZR0tJrQpKDKw+x3wwHwYDVR0jBBgwFoAUj/BLf6guRSSuTVD6Y5qL3uLd\nG7wwewYIKwYBBQUHAQEEbzBtMC4GCCsGAQUFBzABhiJodHRwOi8vb2NzcDIuZ2xv\nYmFsc2lnbi5jb20vcm9vdHIzMDsGCCsGAQUFBzAChi9odHRwOi8vc2VjdXJlLmds\nb2JhbHNpZ24uY29tL2NhY2VydC9yb290LXIzLmNydDA2BgNVHR8ELzAtMCugKaAn\nhiVodHRwOi8vY3JsLmdsb2JhbHNpZ24uY29tL3Jvb3QtcjMuY3JsMEcGA1UdIARA\nMD4wPAYEVR0gADA0MDIGCCsGAQUFBwIBFiZodHRwczovL3d3dy5nbG9iYWxzaWdu\nLmNvbS9yZXBvc2l0b3J5LzANBgkqhkiG9w0BAQsFAAOCAQEAy8j/c550ea86oCkf\nr2W+ptTCYe6iVzvo7H0V1vUEADJOWelTv07Obf+YkEatdN1Jg09ctgSNv2h+LMTk\nKRZdAXmsE3N5ve+z1Oa9kuiu7284LjeS09zHJQB4DJJJkvtIbjL/ylMK1fbMHhAW\ni0O194TWvH3XWZGXZ6ByxTUIv1+kAIql/Mt29PmKraTT5jrzcVzQ5A9jw16yysuR\nXRrLODlkS1hyBjsfyTNZrmL1h117IFgntBA5SQNVl9ckedq5r4RSAU85jV8XK5UL\nREjRZt2I6M9Po9QL7guFLu4sPFJpwR1sPJvubS2THeo7SxYoNDtdyBHs7euaGcMa\nD/fayQ==\n-----END CERTIFICATE-----";
+/** GlobalSign Root CA - R3 */
+export declare const GLOBALSIGN_ROOT_R3 = "-----BEGIN CERTIFICATE-----\nMIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4G\nA1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNp\nZ24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4\nMTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEG\nA1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI\nhvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWtiHL8\nRgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsT\ngHeMCOFJ0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmm\nKPZpO/bLyCiR5Z2KYVc3rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zd\nQQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjlOCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZ\nXriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2xmmFghcCAwEAAaNCMEAw\nDgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI/wS3+o\nLkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZU\nRUm7lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMp\njjM5RcOO5LlXbKr8EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK\n6fBdRoyV3XpYKBovHd7NADdBj+1EbddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQX\nmcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18YIvDQVETI53O9zJrlAGomecs\nMx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH\nWD9f\n-----END CERTIFICATE-----";
+export declare const CHUVSU_CA_CERTS: string[];

package/dist/common/certs.js

@@ -0,0 +1,55 @@
+/** GlobalSign GCC R3 DV TLS CA 2020 (intermediate) */
+export const GLOBALSIGN_GCC_R3_DV_TLS_CA_2020 = `-----BEGIN CERTIFICATE-----
+MIIEsDCCA5igAwIBAgIQd70OB0LV2enQSdd00CpvmjANBgkqhkiG9w0BAQsFADBM
+MSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEGA1UEChMKR2xv
+YmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjAeFw0yMDA3MjgwMDAwMDBaFw0y
+OTAzMTgwMDAwMDBaMFMxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWdu
+IG52LXNhMSkwJwYDVQQDEyBHbG9iYWxTaWduIEdDQyBSMyBEViBUTFMgQ0EgMjAy
+MDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKxnlJV/de+OpwyvCXAJ
+IcxPCqkFPh1lttW2oljS3oUqPKq8qX6m7K0OVKaKG3GXi4CJ4fHVUgZYE6HRdjqj
+hhnuHY6EBCBegcUFgPG0scB12Wi8BHm9zKjWxo3Y2bwhO8Fvr8R42pW0eINc6OTb
+QXC0VWFCMVzpcqgz6X49KMZowAMFV6XqtItcG0cMS//9dOJs4oBlpuqX9INxMTGp
+6EASAF9cnlAGy/RXkVS9nOLCCa7pCYV+WgDKLTF+OK2Vxw3RUJ/p8009lQeUARv2
+UCcNNPCifYX1xIspvarkdjzLwzOdLahDdQbJON58zN4V+lMj0msg+c0KnywPIRp3
+BMkCAwEAAaOCAYUwggGBMA4GA1UdDwEB/wQEAwIBhjAdBgNVHSUEFjAUBggrBgEF
+BQcDAQYIKwYBBQUHAwIwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQUDZjA
+c3+rvb3ZR0tJrQpKDKw+x3wwHwYDVR0jBBgwFoAUj/BLf6guRSSuTVD6Y5qL3uLd
+G7wwewYIKwYBBQUHAQEEbzBtMC4GCCsGAQUFBzABhiJodHRwOi8vb2NzcDIuZ2xv
+YmFsc2lnbi5jb20vcm9vdHIzMDsGCCsGAQUFBzAChi9odHRwOi8vc2VjdXJlLmds
+b2JhbHNpZ24uY29tL2NhY2VydC9yb290LXIzLmNydDA2BgNVHR8ELzAtMCugKaAn
+hiVodHRwOi8vY3JsLmdsb2JhbHNpZ24uY29tL3Jvb3QtcjMuY3JsMEcGA1UdIARA
+MD4wPAYEVR0gADA0MDIGCCsGAQUFBwIBFiZodHRwczovL3d3dy5nbG9iYWxzaWdu
+LmNvbS9yZXBvc2l0b3J5LzANBgkqhkiG9w0BAQsFAAOCAQEAy8j/c550ea86oCkf
+r2W+ptTCYe6iVzvo7H0V1vUEADJOWelTv07Obf+YkEatdN1Jg09ctgSNv2h+LMTk
+KRZdAXmsE3N5ve+z1Oa9kuiu7284LjeS09zHJQB4DJJJkvtIbjL/ylMK1fbMHhAW
+i0O194TWvH3XWZGXZ6ByxTUIv1+kAIql/Mt29PmKraTT5jrzcVzQ5A9jw16yysuR
+XRrLODlkS1hyBjsfyTNZrmL1h117IFgntBA5SQNVl9ckedq5r4RSAU85jV8XK5UL
+REjRZt2I6M9Po9QL7guFLu4sPFJpwR1sPJvubS2THeo7SxYoNDtdyBHs7euaGcMa
+D/fayQ==
+-----END CERTIFICATE-----`;
+/** GlobalSign Root CA - R3 */
+export const GLOBALSIGN_ROOT_R3 = `-----BEGIN CERTIFICATE-----
+MIIDXzCCAkegAwIBAgILBAAAAAABIVhTCKIwDQYJKoZIhvcNAQELBQAwTDEgMB4G
+A1UECxMXR2xvYmFsU2lnbiBSb290IENBIC0gUjMxEzARBgNVBAoTCkdsb2JhbFNp
+Z24xEzARBgNVBAMTCkdsb2JhbFNpZ24wHhcNMDkwMzE4MTAwMDAwWhcNMjkwMzE4
+MTAwMDAwWjBMMSAwHgYDVQQLExdHbG9iYWxTaWduIFJvb3QgQ0EgLSBSMzETMBEG
+A1UEChMKR2xvYmFsU2lnbjETMBEGA1UEAxMKR2xvYmFsU2lnbjCCASIwDQYJKoZI
+hvcNAQEBBQADggEPADCCAQoCggEBAMwldpB5BngiFvXAg7aEyiie/QV2EcWtiHL8
+RgJDx7KKnQRfJMsuS+FggkbhUqsMgUdwbN1k0ev1LKMPgj0MK66X17YUhhB5uzsT
+gHeMCOFJ0mpiLx9e+pZo34knlTifBtc+ycsmWQ1z3rDI6SYOgxXG71uL0gRgykmm
+KPZpO/bLyCiR5Z2KYVc3rHQU3HTgOu5yLy6c+9C7v/U9AOEGM+iCK65TpjoWc4zd
+QQ4gOsC0p6Hpsk+QLjJg6VfLuQSSaGjlOCZgdbKfd/+RFO+uIEn8rUAVSNECMWEZ
+XriX7613t2Saer9fwRPvm2L7DWzgVGkWqQPabumDk3F2xmmFghcCAwEAAaNCMEAw
+DgYDVR0PAQH/BAQDAgEGMA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFI/wS3+o
+LkUkrk1Q+mOai97i3Ru8MA0GCSqGSIb3DQEBCwUAA4IBAQBLQNvAUKr+yAzv95ZU
+RUm7lgAJQayzE4aGKAczymvmdLm6AC2upArT9fHxD4q/c2dKg8dEe3jgr25sbwMp
+jjM5RcOO5LlXbKr8EpbsU8Yt5CRsuZRj+9xTaGdWPoO4zzUhw8lo/s7awlOqzJCK
+6fBdRoyV3XpYKBovHd7NADdBj+1EbddTKJd+82cEHhXXipa0095MJ6RMG3NzdvQX
+mcIfeg7jLQitChws/zyrVQ4PkX4268NXSb7hLi18YIvDQVETI53O9zJrlAGomecs
+Mx86OyXShkDOOyyGeMlhLxS67ttVb9+E7gUJTb0o2HLO02JQZR7rkpeDMdmztcpH
+WD9f
+-----END CERTIFICATE-----`;
+export const CHUVSU_CA_CERTS = [
+    GLOBALSIGN_GCC_R3_DV_TLS_CA_2020,
+    GLOBALSIGN_ROOT_R3,
+];

package/dist/common/http.d.ts

@@ -0,0 +1,12 @@
+export interface HttpResponse {
+    status: number;
+    body: string;
+    location?: string;
+}
+export declare class HttpClient {
+    private cookies;
+    private cookieHeader;
+    private saveCookies;
+    get(url: string, followRedirects?: boolean): Promise<HttpResponse>;
+    post(url: string, data: Record<string, string>, followRedirects?: boolean): Promise<HttpResponse>;
+}

package/dist/common/http.js

@@ -0,0 +1,54 @@
+import { Agent, fetch } from "undici";
+import { CHUVSU_CA_CERTS } from "./certs.js";
+const agent = new Agent({
+    connect: { ca: CHUVSU_CA_CERTS },
+});
+export class HttpClient {
+    cookies = new Map();
+    cookieHeader() {
+        return [...this.cookies.entries()]
+            .map(([k, v]) => `${k}=${v}`)
+            .join("; ");
+    }
+    saveCookies(headers) {
+        const raw = headers.getSetCookie?.() ?? [];
+        for (const c of raw) {
+            const match = c.match(/^([^=]+)=([^;]*)/);
+            if (match)
+                this.cookies.set(match[1], match[2]);
+        }
+    }
+    async get(url, followRedirects = true) {
+        const res = await fetch(url, {
+            method: "GET",
+            headers: { Cookie: this.cookieHeader() },
+            redirect: followRedirects ? "follow" : "manual",
+            dispatcher: agent,
+        });
+        this.saveCookies(res.headers);
+        return {
+            status: res.status,
+            body: await res.text(),
+            location: res.headers.get("location") ?? undefined,
+        };
+    }
+    async post(url, data, followRedirects = true) {
+        const body = new URLSearchParams(data).toString();
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/x-www-form-urlencoded",
+                Cookie: this.cookieHeader(),
+            },
+            body,
+            redirect: followRedirects ? "follow" : "manual",
+            dispatcher: agent,
+        });
+        this.saveCookies(res.headers);
+        return {
+            status: res.status,
+            body: await res.text(),
+            location: res.headers.get("location") ?? undefined,
+        };
+    }
+}

package/dist/common/parse.d.ts

@@ -0,0 +1,10 @@
+import type { Time, WeekRange, Teacher } from "./types.js";
+export declare function parseHtml(html: string): Document;
+export declare function text(el: Element | null): string;
+/** Parse "HH:MM" into {hours, minutes} */
+export declare function parseTime(s: string): Time;
+/** Parse "2 нед." -> {from:2,to:2}, "6 - 8 нед." -> {from:6,to:8} */
+export declare function parseWeeks(s: string): WeekRange;
+/** Parse <sup>*</sup> / <sup>**</sup> markers: * = odd week, ** = even week */
+export declare function parseWeekParity(html: string): "even" | "odd" | undefined;
+export declare function parseTeacher(s: string): Teacher;

package/dist/common/parse.js

@@ -0,0 +1,44 @@
+import { parseHTML } from "linkedom";
+export function parseHtml(html) {
+    return parseHTML(html).document;
+}
+export function text(el) {
+    return el?.textContent?.trim() ?? "";
+}
+/** Parse "HH:MM" into {hours, minutes} */
+export function parseTime(s) {
+    const [h, m] = s.split(":").map(Number);
+    return { hours: h ?? 0, minutes: m ?? 0 };
+}
+/** Parse "2 нед." -> {from:2,to:2}, "6 - 8 нед." -> {from:6,to:8} */
+export function parseWeeks(s) {
+    const range = s.match(/(\d+)\s*-\s*(\d+)/);
+    if (range)
+        return { from: parseInt(range[1]), to: parseInt(range[2]) };
+    const single = s.match(/(\d+)/);
+    if (single)
+        return { from: parseInt(single[1]), to: parseInt(single[1]) };
+    return { from: 0, to: 0 };
+}
+/** Parse <sup>*</sup> / <sup>**</sup> markers: * = odd week, ** = even week */
+export function parseWeekParity(html) {
+    const match = html.match(/<sup>\s*(\*{1,2})\s*<\/sup>/);
+    if (!match)
+        return undefined;
+    return match[1] === "**" ? "even" : "odd";
+}
+export function parseTeacher(s) {
+    const trimmed = s.trim();
+    if (!trimmed)
+        return { name: "" };
+    const posMatch = trimmed.match(/^(доц\.|проф\.|ст\.преп\.|ст\. преп\.|преп\.|асс\.)\s*/);
+    const afterPos = posMatch ? trimmed.slice(posMatch[0].length) : trimmed;
+    const degMatch = afterPos.match(/^([кд]\.[а-яё.-]+н\.)\s*/);
+    const name = degMatch ? afterPos.slice(degMatch[0].length).trim() : afterPos.trim();
+    const result = { name };
+    if (posMatch)
+        result.position = posMatch[1];
+    if (degMatch)
+        result.degree = degMatch[1];
+    return result;
+}

package/dist/common/types.d.ts

@@ -0,0 +1,29 @@
+export declare const enum Period {
+    FallSemester = 1,
+    WinterSession = 2,
+    SpringSemester = 3,
+    SummerSession = 4
+}
+export declare const enum EducationType {
+    HigherEducation = 1,
+    VocationalEducation = 2
+}
+export interface Time {
+    hours: number;
+    minutes: number;
+}
+export interface WeekRange {
+    from: number;
+    to: number;
+}
+export interface Teacher {
+    position?: string;
+    degree?: string;
+    name: string;
+}
+export declare class AuthError extends Error {
+    constructor(message: string);
+}
+export declare class ParseError extends Error {
+    constructor(message: string);
+}

package/dist/common/types.js

@@ -0,0 +1,12 @@
+export class AuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AuthError";
+    }
+}
+export class ParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ParseError";
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { LkClient } from "./lk/client.js";
+export { TtClient } from "./tt/client.js";
+export type { CacheEntry } from "./common/cache.js";
+export { getSemesterStart, getSemesterWeeks, getWeekNumber, getWeekdayName, filterSlots, slotsToLessons, } from "./tt/schedule.js";
+export { Period, EducationType, AuthError, ParseError } from "./common/types.js";
+export type { Time, WeekRange, Teacher, } from "./common/types.js";
+export type { PersonalData, } from "./lk/types.js";
+export type { Faculty, Group, ScheduleEntry, FullScheduleSlot, FullScheduleDay, LessonTimeSlot, Lesson, LessonTime, ScheduleWeekDay, ScheduleFilter, SemesterWeek, TtClientOptions, CacheConfig, } from "./tt/types.js";

package/dist/index.js

@@ -0,0 +1,4 @@
+export { LkClient } from "./lk/client.js";
+export { TtClient } from "./tt/client.js";
+export { getSemesterStart, getSemesterWeeks, getWeekNumber, getWeekdayName, filterSlots, slotsToLessons, } from "./tt/schedule.js";
+export { AuthError, ParseError } from "./common/types.js";

package/dist/lk/client.d.ts

@@ -0,0 +1,10 @@
+import type { PersonalData } from "./types.js";
+export declare class LkClient {
+    private http;
+    login(opts: {
+        email: string;
+        password: string;
+    }): Promise<void>;
+    getPersonalData(): Promise<PersonalData>;
+    getGroupId(): Promise<number | null>;
+}

package/dist/lk/client.js

@@ -0,0 +1,39 @@
+import { HttpClient } from "../common/http.js";
+import { AuthError } from "../common/types.js";
+import { extractScriptValues } from "./parse.js";
+const BASE = "https://lk.chuvsu.ru";
+const LOGIN_URL = `${BASE}/info/login.php`;
+const STUDENT_BASE = `${BASE}/student`;
+export class LkClient {
+    http = new HttpClient();
+    async login(opts) {
+        const res = await this.http.post(LOGIN_URL, { email: opts.email, password: opts.password, role: "1", enter: "" }, false);
+        if (!(res.status === 302 && res.location?.includes("student"))) {
+            throw new AuthError("LK login failed");
+        }
+    }
+    async getPersonalData() {
+        const { body } = await this.http.get(`${STUDENT_BASE}/personal_data.php`);
+        const vals = extractScriptValues(body, "form_personal_data");
+        return {
+            lastName: vals.fam ?? "",
+            firstName: vals.nam ?? "",
+            patronymic: vals.oth ?? "",
+            sex: vals.sex ?? "",
+            birthday: vals.birthday ?? "",
+            recordBookNumber: vals.zachetka ?? "",
+            faculty: vals.faculty ?? "",
+            specialty: vals.spec ?? "",
+            profile: vals.profile ?? "",
+            group: vals.groupname ?? "",
+            course: vals.course ?? "",
+            email: vals.email ?? "",
+            phone: vals.phone ?? "",
+        };
+    }
+    async getGroupId() {
+        const { body } = await this.http.get(`${STUDENT_BASE}/tt.php`);
+        const match = body.match(/tt\.chuvsu\.ru\/index\/grouptt\/gr\/(\d+)/);
+        return match ? parseInt(match[1]) : null;
+    }
+}

package/dist/lk/parse.d.ts

@@ -0,0 +1,2 @@
+/** Extract values set via `document.formName.field.value='...'` in script tags */
+export declare function extractScriptValues(html: string, formName: string): Record<string, string>;

package/dist/lk/parse.js

@@ -0,0 +1,10 @@
+/** Extract values set via `document.formName.field.value='...'` in script tags */
+export function extractScriptValues(html, formName) {
+    const result = {};
+    const re = new RegExp(`document\\.${formName}\\.(\\w+)\\.value\\s*=\\s*'([^']*)'`, "g");
+    let m;
+    while ((m = re.exec(html))) {
+        result[m[1]] = m[2];
+    }
+    return result;
+}

package/dist/lk/types.d.ts

@@ -0,0 +1,15 @@
+export interface PersonalData {
+    lastName: string;
+    firstName: string;
+    patronymic: string;
+    sex: string;
+    birthday: string;
+    recordBookNumber: string;
+    faculty: string;
+    specialty: string;
+    profile: string;
+    group: string;
+    course: string;
+    email: string;
+    phone: string;
+}

package/dist/lk/types.js

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