chuvsu-js 4.2.0 → 5.0.0

package/docs/v5-architecture.md

@@ -0,0 +1,144 @@
+# Архитектура расписания chuvsu-js v5
+
+## Цели
+
+- Одна реальная пара хранится один раз, даже если разные страницы показывают
+  разные части информации о ней.
+- Серии и конкретные занятия получают устойчивые случайные ID, не зависящие от
+  изменяемых даты, аудитории и времени.
+- Семестровое расписание и сессия становятся форматами входных наблюдений одной
+  модели запросов.
+- TTL-кеш страниц не управляет временем жизни канонических ID.
+- Репозиторий, календарь и запросы работают в браузере без Node-сети и DOM.
+
+Версия 5 намеренно несовместима с v4; старые формы вызовов не сохраняются.
+
+## Границы пакетов
+
+- `chuvsu-js` и `chuvsu-js/node` — Node-клиенты, парсеры и ядро;
+- `chuvsu-js/browser` — репозиторий, `Schedule`, календарные функции, доменные
+  типы и импорт/экспорт снимков;
+- `chuvsu-js/parsers` — серверные HTML-парсеры без авторизованных клиентов.
+
+Браузерная точка входа не импортирует `undici`, `linkedom`, сертификаты или
+`Buffer`.
+
+## Наблюдение и каноническая сущность
+
+Строка страницы — не готовая пара, а `ScheduleObservation`. Владелец страницы
+является достоверным неявным фактом: страница группы доказывает участие группы,
+страница преподавателя — преподавателя, страница аудитории — аудиторию.
+
+Отсутствующие поля означают «источник не сообщил». Явное отсутствие передается
+как `null` на границе парсера и превращается в пустой `RelationSet` с
+`completeness: "complete"`.
+
+```text
+RelationSet<T> = {
+  values: T[]
+  completeness: "unknown" | "partial" | "complete"
+}
+```
+
+Это устраняет пустые строки и не позволяет принять нехватку данных за известное
+отсутствие.
+
+## Время и дата
+
+Номер и фактический интервал независимы:
+
+```text
+slotNumber?: number
+time?: { start: Time, end: Time }
+```
+
+Стандартная сетка звонков — только справочная информация и не переписывает
+утверждение портала. Сессия не получает вычисленный номер пары по ближайшему
+времени.
+
+Дата без времени — `LocalDate` (`YYYY-MM-DD`). В модели не используется
+полуночный `Date`, поэтому сериализация через UTC не может сдвинуть учебный день.
+
+## Серии и занятия
+
+`LessonSeries` описывает повторение в семестре: учебный год, период, день недели,
+необязательный диапазон недель, чередование, независимые номер и время, предмет,
+тип, связи, замены и происхождение данных. Отсутствующий диапазон означает, что
+источник не ограничил недели; фиктивные диапазоны вроде `0..0` запрещены.
+
+`LessonOccurrence` описывает конкретное занятие. У него есть `scheduledDate`,
+`nominalDate`, статус переноса, отдельное локальное время и, для семестровой
+пары, `seriesId`. Экзамен, консультация и другая строка сессии сразу становятся
+`LessonOccurrence` с датой из страницы: у них нет `recurrence` и диапазона недель.
+
+ID серии создается генератором и хранится в репозитории. ID семестрового
+занятия выводится из ID серии, учебной недели и порядкового номера возникновения;
+дата, время и аудитория в идентичность не входят. Строка сессии получает
+сохраненный `lessonId`.
+
+## Согласование наблюдений
+
+При загрузке источника репозиторий:
+
+1. Нормализует текст и ссылки на сущности.
+2. Сохраняет прежний ID, если наблюдение связано с уже известной строкой этого
+   источника.
+3. Для нового источника рассматривает только тот же учебный год, период и вид
+   сущности.
+4. Запрещает объединение разных дат конкретных занятий, разных дней недели,
+   непересекающихся недель и несовместимого чередования.
+5. Независимо оценивает совпадение номера и времени, а также предмета, типа,
+   групп, преподавателей и аудиторий.
+6. Объединяет только единственного кандидата с достаточным доказательством;
+   неоднозначность создает новый ID.
+7. Хранит происхождение всех утверждений и объединяет совместимые связи.
+8. Выбирает номер пары и интервал времени независимо по совокупности источников,
+   поэтому ни одна «самая полная» строка не перетирает остальные поля целиком.
+
+Результат проверяется в прямом и обратном порядке загрузки корпуса. Совпавшее
+время может сохранить идентичность при ошибочном номере пары, но разные дни или
+чередование не могут быть склеены похожими метаданными.
+
+## Справочник сущностей
+
+Репозиторий содержит справочник групп, преподавателей и аудиторий. Его наполняют
+поиск, списки и владельцы загруженных страниц. Сокращение преподавателя
+разрешается по фамилии и инициалам только при единственном совпадении.
+
+Загрузка расписания не делает скрытых сетевых запросов. Допустимы только явно
+вызванные `resolve*` со стратегией поиска или `preloadDirectory`.
+
+## Хранилища
+
+Есть три независимых слоя:
+
+1. TTL-кеш сетевых ответов и метаданных.
+2. Канонический репозиторий ID, наблюдений, связей и ревизии.
+3. Производные представления запросов, инвалидируемые ревизией.
+
+Снимок репозитория имеет `schemaVersion: 5`. Адаптер постоянного хранилища
+использует compare-and-set по ревизии.
+
+## Запросы
+
+`Schedule` — легкое синхронное представление владельца поверх репозитория:
+
+- `on(date)`;
+- `week(academicWeek?)`;
+- `weekday(day, options?)`;
+- `today()`, `tomorrow()`, `thisWeek()`;
+- `current()`;
+- `series()`.
+
+При раскрытии серии применяются недели, праздники, замены и переносы, после чего
+добавляются прямые занятия сессии.
+
+## Проверка
+
+Полностраничный корпус содержит 34 страницы групп, 4 преподавателей и 4
+аудиторий. Для каждой страницы есть полный вручную проверенный JSON-эталон;
+всего проверено 1184 занятия. Тест сравнивает весь канонический результат, а не
+отдельные поля. Генератора эталонов в репозитории нет. Журнал ручной проверки
+находится в [`fixture-review.md`](fixture-review.md). Отдельные тесты проверяют
+устойчивость ID, неоднозначность, объединение трех проекций, порядок запросов,
+локальные даты, три состояния связей и границу браузерного пакета.

package/docs/v5-migration.md

@@ -0,0 +1,451 @@
+# Переход с v4 на v5
+
+Версия 5 полностью меняет модель расписания и намеренно не содержит слоя
+совместимости с v4. Основное отличие: в v4 каждый запрос возвращал независимую
+копию HTML-таблицы, а в v5 страницы групп, преподавателей и аудиторий пополняют
+единый канонический репозиторий. Одна реальная пара получает один ID и собирает
+из разных страниц все известные связи.
+
+## Установка
+
+```bash
+npm install chuvsu-js@^5
+```
+
+Рекомендуется Node.js 20+ и ESM. Сетевые клиенты доступны из `chuvsu-js` и
+`chuvsu-js/node`; браузерное ядро — из `chuvsu-js/browser`; HTML-парсеры — из
+`chuvsu-js/parsers`.
+
+## Минимальная миграция
+
+### v4
+
+```ts
+import { TtClient } from "chuvsu-js";
+
+const client = new TtClient({ cache: 15 * 60_000 });
+await client.loginAsGuest();
+
+const [group] = await client.searchGroup({ name: "КТ-41-24" });
+const schedule = await client.getSchedule(group.id);
+
+for (const lesson of schedule.forDate(new Date())) {
+  console.log(lesson.number, lesson.subject, lesson.room, lesson.teacher);
+}
+```
+
+### v5
+
+```ts
+import { TimetableClient } from "chuvsu-js";
+
+const client = new TimetableClient({ cache: 15 * 60_000 });
+await client.loginAsGuest();
+
+const [group] = await client.searchGroups("КТ-41-24");
+const schedule = await client.getGroupSchedule(group.id);
+
+for (const lesson of schedule.on(new Date())) {
+  console.log(
+    lesson.id,
+    lesson.slotNumber,
+    lesson.subject,
+    lesson.rooms.values,
+    lesson.teachers.values,
+  );
+}
+```
+
+## Переименования клиентов и общих типов
+
+| v4 | v5 |
+|---|---|
+| `TtClient` | `TimetableClient` |
+| `TtClientOptions` | `TimetableClientOptions` |
+| `LkClient` | `StudentPortalClient` |
+| `LkClientOptions` | `StudentPortalClientOptions` |
+| `LkCacheConfig` | `StudentPortalCacheConfig` |
+| `PersonalData` | `StudentProfile` |
+| `Audience` | `Room` |
+| `AudienceInfo` | `RoomInfo` |
+| `EducationType` | `EducationLevel` |
+| `Period` | `AcademicPeriod` |
+
+Опция клиента также переименована:
+
+```ts
+// v4
+new TtClient({ educationType: EducationType.HigherEducation });
+
+// v5
+new TimetableClient({ educationLevel: EducationLevel.HigherEducation });
+```
+
+## Методы `TimetableClient`
+
+| v4 | v5 |
+|---|---|
+| `getSchedule(groupId)` | `getGroupSchedule(groupId)` |
+| `getScheduleForPeriod({ groupId, period })` | `getGroupSchedule(groupId, { periods: [period] })` |
+| `getTeacherScheduleForPeriod({ teacherId, period })` | `getTeacherSchedule(teacherId, { periods: [period] })` |
+| `getAudienceSchedule(id)` | `getRoomSchedule(id)` |
+| `getAudienceScheduleForPeriod({ audienceId, period })` | `getRoomSchedule(audienceId, { periods: [period] })` |
+| `searchGroup({ name })` | `searchGroups(name)` |
+| `searchTeacher({ name })` | `searchTeachers(name)` |
+| `searchAudience({ name })` | `searchRooms(name)` |
+| `getGroupsForFaculty({ facultyId })` | `getFacultyGroups(facultyId)` |
+| `getAudiences()` | `getRooms()` |
+| `findAudienceByName({ name })` | `findRoomByName(name)` |
+| `getAudienceName(id)` | `getRoomName(id)` |
+| `getAudienceInfo(id)` | `getRoomInfo(id)` |
+| `getAudienceImage(id)` | `getRoomImage(id)` |
+| `getAudienceBlockImage(id)` | `getRoomBuildingImage(id)` |
+| `getAudienceFloorplan(id)` | `getRoomFloorPlan(id)` |
+| `getTeacherPhoto(id)` / `getTeacherPhotoLazy(id)` | `getTeacherPhoto(id)` |
+
+`getGroupSchedule`, `getTeacherSchedule` и `getRoomSchedule` по умолчанию
+загружают все четыре периода. Для ограничения запросов передайте `periods`:
+
+```ts
+import { AcademicPeriod } from "chuvsu-js";
+
+const schedule = await client.getTeacherSchedule(teacherId, {
+  periods: [
+    AcademicPeriod.FallSemester,
+    AcademicPeriod.WinterSession,
+  ],
+});
+```
+
+Для кода, который работает с разными владельцами одинаково, добавлен общий
+метод:
+
+```ts
+const schedule = await client.getSchedule({
+  type: "room",
+  room: { id: roomId, name: "Г-402" },
+});
+```
+
+## Методы `Schedule`
+
+| v4 | v5 |
+|---|---|
+| `forDate(date)` | `on(date)` |
+| `forWeek(week, options)` | `week(week, options)` |
+| `forDay(weekday, options)` | `weekday(weekday, options)` |
+| `currentLesson(options)` | `current(options)` |
+| `today(options)` | `today(options)` |
+| `tomorrow(options)` | `tomorrow(options)` |
+| `thisWeek(options)` | `thisWeek(options)` |
+
+`on`, `week`, `weekday`, `today`, `tomorrow` и `thisWeek` теперь всегда
+возвращают `LessonOccurrence[]`. Опция `subgroup` сохранена:
+
+```ts
+const lessons = schedule.weekday(1, { week: 4, subgroup: 2 });
+```
+
+Новый метод `series()` возвращает повторяющиеся определения
+`LessonSeries[]`. Поля v4 `scheduleMap`, `days`, `periods` и `getDays()` удалены:
+канонический `Schedule` больше не является оберткой над HTML-таблицей.
+
+## Миграция `Lesson` на `LessonOccurrence`
+
+| v4 `Lesson` | v5 `LessonOccurrence` |
+|---|---|
+| `number` | `slotNumber` |
+| `start.hours`, `start.minutes` | `time?.start.hours`, `time?.start.minutes` |
+| `end.hours`, `end.minutes` | `time?.end.hours`, `time?.end.minutes` |
+| `start.date` | `scheduledDate` (`YYYY-MM-DD`) |
+| `room` | `rooms.values` |
+| `teacher` | `teachers.values` |
+| `groups: string[]` | `groups.values: GroupAttendance[]` |
+| `originalRoom` | `originalRooms` |
+| `originalTeacher` | `originalTeachers` |
+| `transfer` | `status`, `nominalDate`, `scheduledDate`, `movedFrom` |
+| отсутствовало | `id` и необязательный `seriesId` |
+| отсутствовало | `sources` |
+
+`slotNumber` и `time` необязательны и независимы. Нельзя использовать
+утверждение `lesson.number === 5` как источник времени или вычислять номер пары
+по ближайшему интервалу.
+
+```ts
+for (const lesson of schedule.on(date)) {
+  const roomNames = lesson.rooms.values.map((room) => room.name);
+  const teacherNames = lesson.teachers.values.map((teacher) => teacher.name);
+  const groupNames = lesson.groups.values.map(({ group }) => group.name);
+
+  if (lesson.time) {
+    console.log(lesson.time.start, lesson.time.end);
+  }
+}
+```
+
+Поля повторения больше не дублируются в конкретном занятии. Диапазон недель,
+день и чередование находятся в `LessonSeries.recurrence`:
+
+```ts
+for (const series of schedule.series()) {
+  console.log(
+    series.id,
+    series.recurrence.weekday,
+    series.recurrence.weeks,
+    series.recurrence.parity,
+  );
+}
+```
+
+Отсутствующий `recurrence.weeks` означает, что источник не сообщил ограничение,
+а не диапазон `0..0`.
+
+## Связи и отсутствие данных
+
+В v4 пустая строка или пустой массив одновременно могли означать «значения
+нет» и «страница его не показала». В v5 группы, преподаватели и аудитории имеют
+тип `RelationSet<T>`:
+
+```ts
+type RelationSet<T> = {
+  values: T[];
+  completeness: "unknown" | "partial" | "complete";
+};
+```
+
+- `unknown` — источник ничего не сообщил;
+- `partial` — известна только часть списка;
+- `complete` — список известен полностью, включая явный пустой список.
+
+Проверяйте не только `values.length`, если для приложения важно различать
+неизвестность и подтвержденное отсутствие.
+
+Ссылки на сущности теперь могут содержать ID:
+
+```ts
+lesson.teachers.values // TeacherRef[]: { id?, name, position?, degree? }
+lesson.rooms.values    // RoomRef[]: { id?, name, building? }
+lesson.groups.values   // GroupAttendance[]: { group: GroupRef, subgroup? }
+```
+
+## Даты, сессия и переносы
+
+Календарные даты внутри модели представлены `LocalDate` — строкой
+`YYYY-MM-DD`. Это предотвращает сдвиг учебного дня при сериализации в UTC.
+Методы запросов по-прежнему принимают локальный `Date`.
+
+```ts
+import { formatLocalDate, parseLocalDate } from "chuvsu-js";
+
+const key = formatLocalDate(new Date(2026, 8, 3)); // "2026-09-03"
+const date = parseLocalDate(key);                  // локальный Date
+```
+
+Экзамен, консультация и другая строка сессии сразу являются
+`LessonOccurrence` с датой из портала. У них нет фиктивных недель и обычно нет
+`seriesId`.
+
+Для перенесенного занятия:
+
+- `nominalDate` — исходная дата;
+- `scheduledDate` — фактическая дата;
+- `status === "moved"`;
+- `movedFrom` содержит исходную дату и номер пары.
+
+## ID и постоянное хранилище
+
+В v4 устойчивых ID занятий не было. Поэтому старый кеш нельзя преобразовать в
+ID v5. После первого получения данных v5 ID сохраняются в
+`TimetableRepository` и не зависят от даты, аудитории или времени.
+
+TTL-кеш сетевых ответов и репозиторий идентичности — разные хранилища:
+
+```ts
+const client = new TimetableClient({
+  cache: 15 * 60_000,
+  cacheAdapter,
+  repositoryAdapter,
+});
+```
+
+Для сохранения ID между процессами реализуйте `TimetableRepositoryAdapter` или
+используйте `MemoryTimetableRepositoryAdapter` в рамках одного процесса.
+Снимок можно получить явно:
+
+```ts
+const snapshot = await client.exportRepository();
+```
+
+Не передавайте экспорт `exportCache()` из v4 в `importCache()` v5: изменились
+ключи, категории и форма закешированных страниц. Старый TTL-кеш и старые blob-
+ключи следует удалить. Снимок репозитория v5 имеет `schemaVersion: 5`.
+
+## Дополнение данных и справочник сущностей
+
+Полученный `Schedule` является живым представлением репозитория. Последующие
+запросы могут дополнить ту же пару, не меняя ее ID:
+
+```ts
+const schedule = await client.getGroupSchedule(groupId);
+const before = schedule.on(date);
+
+await client.getTeacherSchedule(teacherId);
+await client.getRoomSchedule(roomId);
+
+const after = schedule.on(date);
+```
+
+Загрузка расписания не запускает каскадный поиск групп, преподавателей или
+аудиторий. Справочник можно наполнить явно:
+
+```ts
+await client.preloadDirectory({
+  teachers: true,
+  rooms: true,
+  facultyIds: [19],
+});
+
+const teacher = await client.resolveTeacher("Иванов И. И.");
+const searched = await client.resolveTeacher("Иванов И. И.", {
+  strategy: "search",
+});
+```
+
+Стратегия по умолчанию — `cache-only`. ID сокращенному имени присваивается
+только при единственном совпадении.
+
+## HTML-парсеры
+
+Если приложение использовало табличные типы v4 напрямую, миграция выполняется
+отдельно от канонического `Schedule`:
+
+| v4 | v5 (`chuvsu-js/parsers`) |
+|---|---|
+| `FullScheduleDay` | `ParsedScheduleDay` |
+| `FullScheduleSlot` | `ParsedScheduleBlock` |
+| `ScheduleEntry` | `ParsedLesson` |
+| `day.slots` | `day.blocks` |
+| `slot.number` | `block.slotNumber` |
+| `slot.timeStart`, `slot.timeEnd` | `block.time?.start`, `block.time?.end` |
+| `slot.entries` | `block.lessons` |
+
+```ts
+import { parseGroupSchedule } from "chuvsu-js/parsers";
+
+const days = parseGroupSchedule(html);
+for (const day of days) {
+  for (const block of day.blocks) {
+    console.log(block.slotNumber, block.time, block.lessons);
+  }
+}
+```
+
+`ParsedLesson.room`, `teacher` и `groups` могут быть `undefined` (источник не
+сообщил) или `null` (источник явно сообщил отсутствие). Для загрузки разобранной
+страницы в доменную модель используйте `createScheduleSourceSnapshot`, затем
+`TimetableRepository.ingest`.
+
+## Вебинары
+
+| v4 | v5 |
+|---|---|
+| `attachWebinarsToLessons` | `attachWebinars` |
+| `matchWebinarToLesson` | `findWebinar` |
+| `webinar.date` | `webinar.scheduledDate` |
+| `webinar.timeStart`, `webinar.timeEnd` | `webinar.time.start`, `webinar.time.end` |
+
+```ts
+import { attachWebinars } from "chuvsu-js";
+
+const lessons = schedule.on(date);
+const webinars = await client.getWebinars({ date });
+const withWebinars = attachWebinars(lessons, webinars);
+```
+
+`attachWebinars` возвращает новые объекты `LessonWithWebinar` и не изменяет
+занятия в репозитории.
+
+## Сетка звонков
+
+| v4 | v5 |
+|---|---|
+| `getTimeSlots()` | `getStandardScheduleBlocks()` |
+| `getLessonNumber(time)` | удален |
+
+Стандартная сетка в v5 является только справочником. Она не исправляет данные
+портала и не используется для вычисления `slotNumber` по времени.
+
+## Личный кабинет
+
+| v4 | v5 |
+|---|---|
+| `new LkClient()` | `new StudentPortalClient()` |
+| `getPersonalData()` | `getProfile()` |
+| `getPhoto()` | `getProfilePhoto()` |
+| `getGroupId()` | `getTimetableGroupId()` |
+
+Поля профиля не изменились; изменились имена класса, типа и методов. Ключи
+настроек кеша переименованы с `personalData`, `photo`, `groupId` на `profile`,
+`profilePhoto`, `timetableGroupId`.
+
+## Ключи `CacheConfig`
+
+В расписании переименованы категории:
+
+| v4 | v5 |
+|---|---|
+| `audiences` | `rooms` |
+| `audienceNames` | `roomNames` |
+| `audienceInfo` | `roomInfo` |
+| `audienceImages` | `roomImages` |
+
+Остальные категории сохраняют назначение, но содержимое кеша v4 повторно
+использовать нельзя.
+
+## Браузер
+
+В v4 браузерный `Schedule` строился из `Map<Period, FullScheduleDay[]>`. В v5
+браузер получает снимок канонического репозитория от сервера:
+
+```ts
+// Node/server
+const snapshot = await client.exportRepository();
+
+// Browser
+import { Schedule, TimetableRepository } from "chuvsu-js/browser";
+
+const repository = new TimetableRepository({ snapshot });
+const schedule = new Schedule(
+  repository,
+  { type: "group", group: { id: 8919, name: "КТ-41-24" } },
+  2026,
+);
+```
+
+`chuvsu-js/browser` не включает HTML-парсер, `undici`, сертификаты ЧГУ и
+`Buffer`. Авторизацию и загрузку страниц выполняйте на сервере.
+
+## Удаленные допущения v4
+
+- Нельзя считать пустую строку аудитории подтвержденным отсутствием аудитории.
+- Нельзя считать номер пары индексом массива или выводить время из номера.
+- Нельзя читать недели у экзамена или консультации: это датированные занятия.
+- Нельзя сравнивать пары по `дата + аудитория + время`; используйте `id`.
+- Нельзя ожидать, что страница группы содержит полное имя и ID преподавателя.
+- Нельзя импортировать TTL-кеш v4 как репозиторий v5.
+- Нельзя создавать `Schedule` из старых `FullScheduleDay[]`.
+
+## Рекомендуемый порядок перехода
+
+1. Переименовать клиенты, enum и методы поиска.
+2. Заменить методы получения расписаний и вызовы `Schedule`.
+3. Перевести UI и бизнес-логику с `Lesson` на `LessonOccurrence`.
+4. Обработать `RelationSet` и необязательные `slotNumber`/`time`.
+5. Перевести сохраняемые даты на `LocalDate`.
+6. Перенести работу с повторением в `schedule.series()`.
+7. Удалить старый кеш; отдельно подключить `repositoryAdapter`.
+8. Если используются парсеры или браузер, перейти на новые точки входа.
+9. Обновить сопоставление вебинаров и методы личного кабинета.
+10. Проверить сессию, переносы, замены, подгруппы и ДОТ на реальных данных.
+
+Описание внутренней модели: [`v5-architecture.md`](v5-architecture.md).

package/package.json

@@ -1,23 +1,32 @@
 {
   "name": "chuvsu-js",
-  "version": "4.2.0",
-  "description": "Node.js library for ChuvSU student portal (lk.chuvsu.ru) and schedule (tt.chuvsu.ru)",
+  "version": "5.0.0",
+  "description": "Библиотека для расписания и личного кабинета ЧГУ им. И. Н. Ульянова",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js"
     },
     "./browser": {
-      "import": "./dist/browser.js",
-      "types": "./dist/browser.d.ts"
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js"
+    },
+    "./parsers": {
+      "types": "./dist/parsers.d.ts",
+      "import": "./dist/parsers.js"
     }
   },
   "files": [
     "dist",
     "README.md",
+    "docs",
     "LICENSE"
   ],
   "keywords": [
@@ -44,8 +53,9 @@
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
     "build": "pnpm clean && tsc",
     "test": "pnpm build && node --test",
+    "test:coverage": "pnpm build && node --experimental-test-coverage --test-coverage-include='dist/tt/domain/*.js' --test-coverage-include='dist/tt/observations.js' --test-coverage-include='dist/tt/parse/*.js' --test-coverage-include='dist/tt/utils/*.js' --test-coverage-include='dist/tt/webinars.js' --test-coverage-lines=95 --test-coverage-functions=94 --test-coverage-branches=80 --test",
     "test:live:schedules": "pnpm build && node --env-file=.env utils/testSchedules.mjs",
-    "fixtures:audit": "pnpm build && node utils/auditScheduleExpectations.mjs",
+    "fixtures:test": "pnpm build && node --test test/schedule-fixtures.test.mjs",
     "fixtures:collect": "pnpm build && node --env-file=.env utils/collectScheduleFixtures.mjs"
   }
 }

package/dist/shared.d.ts

@@ -1,9 +0,0 @@
-export { Schedule } from "./tt/schedule.js";
-export { parseGroupsString, parseWebinars } from "./tt/parse/index.js";
-export { attachWebinarsToLessons, getAdjacentSemester, getCompensatingWorkDays, getCurrentPeriod, getEffectiveHolidays, getHolidayTransfers, getLessonNumber, getSemesterStart, getSemesterWeeks, getTimeSlots, getWeekNumber, getWeekdayName, isHoliday, isSessionPeriod, matchWebinarToLesson, RUSSIAN_HOLIDAYS, } from "./tt/utils/index.js";
-export type { Holiday, HolidayTransfer } from "./tt/utils/index.js";
-export { AuthError, EducationType, ParseError, Period, } from "./common/types.js";
-export type { Teacher, Time, WeekRange } from "./common/types.js";
-export type { BlobAdapter, BlobPutOptions, CacheAdapter, CacheEntry, } from "./common/cache.js";
-export type { Audience, AudienceInfo, CacheConfig, Faculty, FullScheduleDay, FullScheduleSlot, Group, Lesson, LessonTime, LessonTimeSlot, ScheduleEntry, SemesterWeek, SubstituteForInfo, Substitution, TeacherInfo, TransferInfo, TtClientOptions, Webinar, } from "./tt/types.js";
-export type { LkCacheConfig, LkClientOptions, PersonalData } from "./lk/types.js";

package/dist/shared.js

@@ -1,7 +0,0 @@
-// Shared exports that work in any environment (Node, browser, Deno).
-// Both ./index.ts and ./browser.ts re-export everything from here and only
-// add their platform-specific extras on top.
-export { Schedule } from "./tt/schedule.js";
-export { parseGroupsString, parseWebinars } from "./tt/parse/index.js";
-export { attachWebinarsToLessons, getAdjacentSemester, getCompensatingWorkDays, getCurrentPeriod, getEffectiveHolidays, getHolidayTransfers, getLessonNumber, getSemesterStart, getSemesterWeeks, getTimeSlots, getWeekNumber, getWeekdayName, isHoliday, isSessionPeriod, matchWebinarToLesson, RUSSIAN_HOLIDAYS, } from "./tt/utils/index.js";
-export { AuthError, ParseError, } from "./common/types.js";