bsuir-iis-api 0.6.6 → 0.7.0

package/CHANGELOG.md

@@ -8,6 +8,35 @@ This changelog is maintained manually and updated in release commits.
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-04-19
+
+### Added
+
+- `BsuirConfigurationError` when the runtime has no `fetch` and none was passed to `createBsuirClient({ fetch })`.
+
+### Changed
+
+- HTTP client (2xx): valid JSON is parsed even when the server omits `application/json` in `Content-Type`; if the header declares JSON and the body is invalid, empty, or truncated, `BsuirApiError` (`Invalid JSON response payload`) is thrown; an empty body without a JSON `Content-Type` yields an empty string `""`.
+- `package.json` `engines.node`: `>=20.0.0`. GitHub Actions **CI** runs on Node.js 20, 22, and 24 (`fail-fast: false`).
+
+### Documentation
+
+- README: **Runtime requirements** (Node 20+ and CI), **Errors** (`BsuirConfigurationError`), **Successful HTTP responses (body parsing)**.
+- JSDoc on catalog `listAll` methods (student groups, employees, faculties, departments, specialities, auditories), including caller abort / `AbortError` behavior.
+- `.cursorrules` in the repository aligned with ESM-only build and the actual stack (Vitest, tsup, ESLint, native `fetch`).
+
+## [0.6.7] - 2026-04-02
+
+### Changed
+
+- Dev tooling: bumped TypeScript to 6.x, `@typescript-eslint/*` and `typescript-eslint` to ^8.58.0, `vitest` and `@vitest/coverage-v8` to ^4.1.2; added `@microsoft/api-extractor` for declaration emit; regenerated `package-lock.json`.
+- Build: enable tsup [`experimentalDts`](https://tsup.egoist.dev/) (API Extractor) instead of the default DTS plugin so declaration builds work on TypeScript 6 without relying on deprecated `baseUrl` injection.
+- Dev: npm [`overrides`](https://docs.npmjs.com/cli/v10/configuring-npm/package-json#overrides) pin transitive `lodash` to ^4.17.24 so `npm audit` stays clean with `@microsoft/api-extractor`.
+
+### Documentation
+
+- README: note on `experimentalDts` / API Extractor and TypeScript [`paths` without `baseUrl`](https://www.typescriptlang.org/docs/handbook/modules/reference.html).
+
 ## [0.6.6] - 2026-03-23
 
 ### Changed

package/README.md

@@ -4,7 +4,7 @@ Type-safe ESM SDK for [BSUIR IIS API](https://iis.bsuir.by/api/) with support fo
 
 ## Runtime requirements
 
-- **Node.js** `>=24` as declared in `package.json` (`engines`).
+- **Node.js** `>=20` as declared in `package.json` (`engines`). CI runs on Node 20, 22, and 24.
 - A global **`fetch`** implementation, or pass `fetch` into `createBsuirClient({ fetch })` (for tests or polyfills).
 - **`AbortController` / `AbortSignal`** for cancellation and timeouts. When `AbortSignal.any` is available (current Node and modern browsers), the client combines the per-request timeout with your `signal` using the platform API; otherwise it merges them manually with `setTimeout`, so timeouts still apply together with a caller-provided `AbortSignal`.
 
@@ -87,6 +87,7 @@ SDK throws typed errors:
 - `BsuirNetworkError` for transport errors (contains `endpoint`, `causeError`, and standard `cause`)
 - `BsuirTimeoutError` for timeouts (contains `endpoint`, `timeoutMs`)
 - `BsuirValidationError` for invalid input parameters
+- `BsuirConfigurationError` when the runtime has no `fetch` and none was passed to `createBsuirClient({ fetch })`
 
 Validation rules:
 
@@ -100,7 +101,15 @@ Retry and abort behavior:
 - Caller-provided aborted `AbortSignal` is re-thrown as native `AbortError`
 - Internal timeout is mapped to `BsuirTimeoutError`
 
-`createBsuirClient()` throws regular `Error` if no `fetch` implementation is available.
+`createBsuirClient()` throws `BsuirConfigurationError` if no `fetch` implementation is available.
+
+## Successful HTTP responses (body parsing)
+
+For **2xx** responses the client reads the body as text, then applies `JSON.parse` when the payload is valid JSON:
+
+- Valid JSON is returned even when `Content-Type` does **not** include `application/json` (mislabeled responses still parse).
+- If `Content-Type` indicates **`application/json`** but the body is empty or not valid JSON, the client throws `BsuirApiError` (`Invalid JSON response payload`), same as for a truncated `{` payload.
+- If the body is **empty** and the content type does **not** indicate JSON, the result is an empty string `""` (analogous to reading plain text). Typical IIS catalog JSON endpoints return a non-empty body.
 
 ## Raw vs normalized schedule response
 
@@ -144,6 +153,8 @@ npm run check
 npm run build
 ```
 
+`npm run build` uses [tsup](https://tsup.egoist.dev/) with [`experimentalDts`](https://tsup.egoist.dev/) so `.d.ts` output is produced via `@microsoft/api-extractor` rather than the legacy Rollup declaration path (which is awkward with TypeScript 6’s `baseUrl` deprecation). TypeScript’s handbook notes that [`paths` can be used without `baseUrl`](https://www.typescriptlang.org/docs/handbook/modules/reference.html) when you need path mapping.
+
 Linting uses ESLint flat config with strict type-aware TypeScript rules for `src`,
 plus test-specific overrides for `test` and `vitest.config.ts`.
 

package/dist/_tsup-dts-rollup.d.ts

@@ -0,0 +1,591 @@
+import { Options } from 'tsup';
+import { UserConfig } from 'vite';
+
+declare interface Announcement {
+    id: number;
+    employee: string;
+    content: string;
+    date: string;
+    employeeDepartments: string[];
+    studentGroups: StudentGroupShort[];
+}
+export { Announcement }
+export { Announcement as Announcement_alias_1 }
+export { Announcement as Announcement_alias_2 }
+
+/** Payload from IIS legacy `last-update-date/*` endpoints (`schedule.getLastUpdateByGroup` / `getLastUpdateByEmployee`). */
+declare interface ApiDateResponse {
+    lastUpdateDate: string;
+}
+export { ApiDateResponse }
+export { ApiDateResponse as ApiDateResponse_alias_1 }
+export { ApiDateResponse as ApiDateResponse_alias_2 }
+
+export declare function assertEmployeeUrlId(value: unknown, fieldName?: string): asserts value is string;
+
+export declare function assertGroupNumber(value: unknown, fieldName?: string): asserts value is string;
+
+export declare function assertNonEmptyString(value: unknown, fieldName: string): asserts value is string;
+
+export declare function assertPositiveInt(value: unknown, fieldName: string): asserts value is number;
+
+declare interface Auditory {
+    id: number;
+    name: string;
+    note: string;
+    capacity: number | null;
+    auditoryType: AuditoryType;
+    buildingNumber: BuildingNumber;
+    department: AuditoryDepartment;
+}
+export { Auditory }
+export { Auditory as Auditory_alias_1 }
+export { Auditory as Auditory_alias_2 }
+
+declare interface AuditoryDepartment {
+    idDepartment: number;
+    abbrev: string;
+    name: string;
+    nameAndAbbrev: string;
+}
+export { AuditoryDepartment }
+export { AuditoryDepartment as AuditoryDepartment_alias_1 }
+export { AuditoryDepartment as AuditoryDepartment_alias_2 }
+
+declare interface AuditoryType {
+    id: number;
+    name: string;
+    abbrev: string;
+}
+export { AuditoryType }
+export { AuditoryType as AuditoryType_alias_1 }
+export { AuditoryType as AuditoryType_alias_2 }
+
+declare class BsuirApiError extends Error {
+    readonly status: number;
+    readonly endpoint: string;
+    readonly body: unknown;
+    constructor(message: string, status: number, endpoint: string, body: unknown);
+}
+export { BsuirApiError }
+export { BsuirApiError as BsuirApiError_alias_1 }
+
+/**
+ * Public client contract returned by {@link createBsuirClient}.
+ */
+declare type BsuirClient = ReturnType<typeof createBsuirClient>;
+export { BsuirClient }
+export { BsuirClient as BsuirClient_alias_1 }
+
+/**
+ * Options accepted by {@link createBsuirClient}.
+ */
+declare interface BsuirClientOptions {
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    /** Request timeout per attempt, in milliseconds. */
+    timeoutMs?: number;
+    /** Number of retry attempts for retriable GET failures. */
+    retries?: number;
+    /** Base retry delay before backoff, in milliseconds. */
+    retryDelayMs?: number;
+    /** Upper bound for retry delay, in milliseconds. */
+    retryMaxDelayMs?: number;
+    /** Enable jitter for retry backoff to avoid synchronized retries. */
+    retryJitter?: boolean;
+    /** Optional User-Agent header (used mainly in Node.js runtimes). */
+    userAgent?: string;
+    /** Force raw API payload for schedule endpoints by default. */
+    defaultRaw?: boolean;
+}
+export { BsuirClientOptions }
+export { BsuirClientOptions as BsuirClientOptions_alias_1 }
+
+declare class BsuirConfigurationError extends Error {
+    constructor(message: string);
+}
+export { BsuirConfigurationError }
+export { BsuirConfigurationError as BsuirConfigurationError_alias_1 }
+
+declare class BsuirNetworkError extends Error {
+    readonly endpoint: string;
+    readonly causeError: unknown;
+    constructor(message: string, endpoint: string, causeError: unknown);
+}
+export { BsuirNetworkError }
+export { BsuirNetworkError as BsuirNetworkError_alias_1 }
+
+declare class BsuirTimeoutError extends Error {
+    readonly endpoint: string;
+    readonly timeoutMs: number;
+    constructor(message: string, endpoint: string, timeoutMs: number);
+}
+export { BsuirTimeoutError }
+export { BsuirTimeoutError as BsuirTimeoutError_alias_1 }
+
+declare class BsuirValidationError extends Error {
+    constructor(message: string);
+}
+export { BsuirValidationError }
+export { BsuirValidationError as BsuirValidationError_alias_1 }
+
+declare interface BuildingNumber {
+    id: number;
+    name: string;
+}
+export { BuildingNumber }
+export { BuildingNumber as BuildingNumber_alias_1 }
+export { BuildingNumber as BuildingNumber_alias_2 }
+
+export declare function createAnnouncementsModule(config: InternalClientConfig): {
+    /**
+     * Lists announcements for an employee. IIS may return HTTP `404` or `400` (no list / endpoint quirks); the SDK maps those to `[]`.
+     */
+    byEmployee(urlId: string, options?: ReadOptions): Promise<Announcement[]>;
+    /**
+     * Lists announcements for a department. IIS may return HTTP `404` or `400` (no list / endpoint quirks); the SDK maps those to `[]`.
+     */
+    byDepartment(id: number, options?: ReadOptions): Promise<Announcement[]>;
+};
+
+export declare function createAuditoriesModule(config: InternalClientConfig): {
+    /**
+     * Returns the full list of auditories from `/auditories`.
+     * If the caller aborts `options.signal`, the platform propagates `AbortError` (not wrapped by the SDK).
+     *
+     * @throws {BsuirApiError} When the API returns a non-success HTTP status
+     * @throws {BsuirNetworkError} On transport failures after retries
+     * @throws {BsuirTimeoutError} When the request exceeds `timeoutMs`
+     */
+    listAll(options?: ReadOptions): Promise<Auditory[]>;
+};
+
+/**
+ * Creates a configured BSUIR IIS API client.
+ */
+declare function createBsuirClient(options?: BsuirClientOptions): {
+    schedule: {
+        getGroup: <TRaw extends boolean | undefined = undefined>(groupNumber: string, options?: ReadOptions & {
+            raw?: TRaw;
+        }) => Promise<TRaw extends true ? ScheduleResponse : NormalizedScheduleResponse>;
+        getEmployee: <TRaw extends boolean | undefined = undefined>(urlId: string, options?: ReadOptions & {
+            raw?: TRaw;
+        }) => Promise<TRaw extends true ? ScheduleResponse : NormalizedScheduleResponse>;
+        getGroupFiltered: (groupNumber: string, filter: ScheduleFilterOptions, options?: ReadOptions) => Promise<FlattenedScheduleItem[]>;
+        getEmployeeFiltered: (urlId: string, filter: ScheduleFilterOptions, options?: ReadOptions) => Promise<FlattenedScheduleItem[]>;
+        getGroupExams(groupNumber: string, options?: ReadOptions): Promise<FlattenedScheduleItem[]>;
+        getEmployeeExams(urlId: string, options?: ReadOptions): Promise<FlattenedScheduleItem[]>;
+        getGroupBySubgroup(groupNumber: string, subgroup: number, options?: ReadOptions): Promise<FlattenedScheduleItem[]>;
+        getEmployeeBySubgroup(urlId: string, subgroup: number, options?: ReadOptions): Promise<FlattenedScheduleItem[]>;
+        getCurrentWeek: (options?: ReadOptions) => Promise<number>;
+        getLastUpdateByGroup(params: {
+            groupNumber: string;
+        } | {
+            id: number;
+        }, options?: ReadOptions): Promise<ApiDateResponse>;
+        getLastUpdateByEmployee(params: {
+            urlId: string;
+        } | {
+            id: number;
+        }, options?: ReadOptions): Promise<ApiDateResponse>;
+    };
+    groups: {
+        listAll(options?: ReadOptions): Promise<StudentGroupCatalogItem[]>;
+    };
+    employees: {
+        listAll(options?: ReadOptions): Promise<EmployeeCatalogItem[]>;
+    };
+    faculties: {
+        listAll(options?: ReadOptions): Promise<Faculty[]>;
+    };
+    departments: {
+        listAll(options?: ReadOptions): Promise<Department[]>;
+    };
+    specialities: {
+        listAll(options?: ReadOptions): Promise<Speciality[]>;
+    };
+    announcements: {
+        byEmployee(urlId: string, options?: ReadOptions): Promise<Announcement[]>;
+        byDepartment(id: number, options?: ReadOptions): Promise<Announcement[]>;
+    };
+    auditories: {
+        listAll(options?: ReadOptions): Promise<Auditory[]>;
+    };
+};
+export { createBsuirClient }
+export { createBsuirClient as createBsuirClient_alias_1 }
+
+export declare function createDepartmentsModule(config: InternalClientConfig): {
+    /**
+     * Returns the full list of departments from `/departments`.
+     * If the caller aborts `options.signal`, the platform propagates `AbortError` (not wrapped by the SDK).
+     *
+     * @throws {BsuirApiError} When the API returns a non-success HTTP status
+     * @throws {BsuirNetworkError} On transport failures after retries
+     * @throws {BsuirTimeoutError} When the request exceeds `timeoutMs`
+     */
+    listAll(options?: ReadOptions): Promise<Department[]>;
+};
+
+export declare function createEmployeesModule(config: InternalClientConfig): {
+    /**
+     * Returns the full list of employees from `/employees/all`.
+     * If the caller aborts `options.signal`, the platform propagates `AbortError` (not wrapped by the SDK).
+     *
+     * @throws {BsuirApiError} When the API returns a non-success HTTP status
+     * @throws {BsuirNetworkError} On transport failures after retries
+     * @throws {BsuirTimeoutError} When the request exceeds `timeoutMs`
+     */
+    listAll(options?: ReadOptions): Promise<EmployeeCatalogItem[]>;
+};
+
+export declare function createFacultiesModule(config: InternalClientConfig): {
+    /**
+     * Returns the full list of faculties from `/faculties`.
+     * If the caller aborts `options.signal`, the platform propagates `AbortError` (not wrapped by the SDK).
+     *
+     * @throws {BsuirApiError} When the API returns a non-success HTTP status
+     * @throws {BsuirNetworkError} On transport failures after retries
+     * @throws {BsuirTimeoutError} When the request exceeds `timeoutMs`
+     */
+    listAll(options?: ReadOptions): Promise<Faculty[]>;
+};
+
+export declare function createGroupsModule(config: InternalClientConfig): {
+    /**
+     * Returns the full list of student groups from `/student-groups`.
+     * If the caller aborts `options.signal`, the platform propagates `AbortError` (not wrapped by the SDK).
+     *
+     * @throws {BsuirApiError} When the API returns a non-success HTTP status
+     * @throws {BsuirNetworkError} On transport failures after retries
+     * @throws {BsuirTimeoutError} When the request exceeds `timeoutMs`
+     */
+    listAll(options?: ReadOptions): Promise<StudentGroupCatalogItem[]>;
+};
+
+export declare function createJsonResponse({ status, headers, body }: MockResponseInit): Response;
+
+export declare function createScheduleModule(config: InternalClientConfig): {
+    getGroup: <TRaw extends boolean | undefined = undefined>(groupNumber: string, options?: ReadOptions & {
+        raw?: TRaw;
+    }) => Promise<TRaw extends true ? ScheduleResponse : NormalizedScheduleResponse>;
+    getEmployee: <TRaw extends boolean | undefined = undefined>(urlId: string, options?: ReadOptions & {
+        raw?: TRaw;
+    }) => Promise<TRaw extends true ? ScheduleResponse : NormalizedScheduleResponse>;
+    getGroupFiltered: (groupNumber: string, filter: ScheduleFilterOptions, options?: ReadOptions) => Promise<FlattenedScheduleItem[]>;
+    getEmployeeFiltered: (urlId: string, filter: ScheduleFilterOptions, options?: ReadOptions) => Promise<FlattenedScheduleItem[]>;
+    getGroupExams(groupNumber: string, options?: ReadOptions): Promise<FlattenedScheduleItem[]>;
+    getEmployeeExams(urlId: string, options?: ReadOptions): Promise<FlattenedScheduleItem[]>;
+    getGroupBySubgroup(groupNumber: string, subgroup: number, options?: ReadOptions): Promise<FlattenedScheduleItem[]>;
+    getEmployeeBySubgroup(urlId: string, subgroup: number, options?: ReadOptions): Promise<FlattenedScheduleItem[]>;
+    getCurrentWeek: (options?: ReadOptions) => Promise<number>;
+    /**
+     * Calls IIS `/last-update-date/student-group`. That route is legacy and unsupported on the server;
+     * it may return an error for newer group numbers (e.g. six-digit `524404`).
+     */
+    getLastUpdateByGroup(params: {
+        groupNumber: string;
+    } | {
+        id: number;
+    }, options?: ReadOptions): Promise<ApiDateResponse>;
+    /**
+     * Calls IIS `/last-update-date/employee`. That route is legacy and unsupported on the server; prefer
+     * not relying on it for critical cache logic.
+     */
+    getLastUpdateByEmployee(params: {
+        urlId: string;
+    } | {
+        id: number;
+    }, options?: ReadOptions): Promise<ApiDateResponse>;
+};
+
+export declare function createSpecialitiesModule(config: InternalClientConfig): {
+    /**
+     * Returns the full list of specialities from `/specialities`.
+     * If the caller aborts `options.signal`, the platform propagates `AbortError` (not wrapped by the SDK).
+     *
+     * @throws {BsuirApiError} When the API returns a non-success HTTP status
+     * @throws {BsuirNetworkError} On transport failures after retries
+     * @throws {BsuirTimeoutError} When the request exceeds `timeoutMs`
+     */
+    listAll(options?: ReadOptions): Promise<Speciality[]>;
+};
+
+export declare const default_alias: Options | Options[] | ((overrideOptions: Options) => Options | Options[] | Promise<Options | Options[]>);
+
+export declare const default_alias_1: UserConfig;
+
+declare interface Department {
+    id: number;
+    name: string;
+    abbrev: string;
+}
+export { Department }
+export { Department as Department_alias_1 }
+export { Department as Department_alias_2 }
+
+declare interface EducationForm {
+    id: number;
+    name: string;
+}
+export { EducationForm }
+export { EducationForm as EducationForm_alias_1 }
+export { EducationForm as EducationForm_alias_2 }
+
+declare interface Employee {
+    firstName: string;
+    lastName: string;
+    middleName: string;
+    degree: string;
+    degreeAbbrev?: string;
+    email: Maybe<string>;
+    rank: Maybe<string>;
+    photoLink: string;
+    calendarId: string;
+    id: number;
+    urlId: string;
+    jobPositions: Maybe<string[]>;
+}
+export { Employee }
+export { Employee as Employee_alias_1 }
+export { Employee as Employee_alias_2 }
+
+declare interface EmployeeCatalogItem {
+    firstName: string;
+    lastName: string;
+    middleName: string;
+    degree: string;
+    rank: string;
+    photoLink: string;
+    calendarId: string;
+    academicDepartment?: string[];
+    id: number;
+    urlId: string;
+    fio: string;
+}
+export { EmployeeCatalogItem }
+export { EmployeeCatalogItem as EmployeeCatalogItem_alias_1 }
+export { EmployeeCatalogItem as EmployeeCatalogItem_alias_2 }
+
+declare interface Faculty {
+    id: number;
+    name: string;
+    abbrev: string;
+}
+export { Faculty }
+export { Faculty as Faculty_alias_1 }
+export { Faculty as Faculty_alias_2 }
+
+declare type FlattenedLessonsByDay = Partial<Record<Weekday, FlattenedScheduleItem[]>>;
+export { FlattenedLessonsByDay }
+export { FlattenedLessonsByDay as FlattenedLessonsByDay_alias_1 }
+export { FlattenedLessonsByDay as FlattenedLessonsByDay_alias_2 }
+
+declare interface FlattenedScheduleItem extends ScheduleItem {
+    day: Weekday | null;
+    source: "schedules" | "exams";
+}
+export { FlattenedScheduleItem }
+export { FlattenedScheduleItem as FlattenedScheduleItem_alias_1 }
+export { FlattenedScheduleItem as FlattenedScheduleItem_alias_2 }
+
+export declare interface InternalClientConfig {
+    baseUrl: string;
+    fetchImpl: typeof globalThis.fetch;
+    timeoutMs: number;
+    retries: number;
+    retryDelayMs: number;
+    retryMaxDelayMs: number;
+    retryJitter: boolean;
+    userAgent: string | undefined;
+    defaultRaw: boolean;
+}
+
+export declare function isAbortError(error: unknown): boolean;
+
+declare interface LessonStudentGroup {
+    specialityName: string;
+    specialityCode: string;
+    numberOfStudents: number;
+    name: string;
+    educationDegree: number;
+}
+export { LessonStudentGroup }
+export { LessonStudentGroup as LessonStudentGroup_alias_1 }
+export { LessonStudentGroup as LessonStudentGroup_alias_2 }
+
+declare type Maybe<T> = T | null;
+export { Maybe }
+export { Maybe as Maybe_alias_1 }
+export { Maybe as Maybe_alias_2 }
+
+/**
+ * Combines an optional caller {@link AbortSignal} with a per-attempt timeout.
+ * When `AbortSignal.any` exists at runtime, delegates to the platform implementation.
+ * Otherwise uses a manual merge so the timeout still applies alongside a caller signal.
+ */
+export declare function mergeSignals(signal: AbortSignal | undefined, timeoutMs: number): AbortSignal;
+
+/** Used when `AbortSignal.any` is unavailable; exposed for unit tests. */
+export declare function mergeSignalsManual(signal: AbortSignal | undefined, timeoutMs: number): AbortSignal;
+
+export declare function mockFetchSequence(responses: Array<Response | Error>): typeof globalThis.fetch;
+
+export declare interface MockResponseInit {
+    status?: number;
+    headers?: HeadersInit;
+    body: unknown;
+}
+
+declare interface NormalizedScheduleResponse extends Omit<ScheduleResponse, "schedules" | "exams"> {
+    schedules: WeekScheduleMap;
+    exams: ScheduleItem[];
+    lessons: FlattenedScheduleItem[];
+    lessonsByDay: FlattenedLessonsByDay;
+    scheduleLessons: FlattenedScheduleItem[];
+    examLessons: FlattenedScheduleItem[];
+}
+export { NormalizedScheduleResponse }
+export { NormalizedScheduleResponse as NormalizedScheduleResponse_alias_1 }
+export { NormalizedScheduleResponse as NormalizedScheduleResponse_alias_2 }
+
+/**
+ * Normalizes current week payload from API to a positive integer.
+ * API can return plain text (`"1\n"`) or number.
+ */
+export declare function parseCurrentWeek(payload: unknown): number;
+
+export declare function parseDdMmYyyy(value: string | null): Date | null;
+
+export declare type QueryParams = Record<string, QueryValue>;
+
+export declare type QueryValue = string | number | boolean | null | undefined;
+
+/**
+ * Read options used by all module methods.
+ */
+declare interface ReadOptions extends RequestOptions {
+    /**
+     * When true, return raw API payload where supported.
+     */
+    raw?: boolean;
+}
+export { ReadOptions }
+export { ReadOptions as ReadOptions_alias_1 }
+
+export declare function requestJson<T>(config: InternalClientConfig, path: string, options?: RequestOptions): Promise<T>;
+
+/**
+ * Common request options shared by read-only API methods.
+ */
+declare interface RequestOptions {
+    /**
+     * Query parameters appended to endpoint URL.
+     */
+    query?: QueryParams | undefined;
+    /**
+     * Optional signal to cancel request from the caller side.
+     */
+    signal?: AbortSignal | undefined;
+}
+export { RequestOptions }
+export { RequestOptions as RequestOptions_alias_1 }
+
+declare interface ScheduleFilterOptions {
+    source?: "schedules" | "exams";
+    weekday?: Weekday;
+    weekNumber?: number;
+    subgroup?: number;
+    lessonTypeAbbrev?: string | string[];
+    subjectQuery?: string;
+    employeeUrlId?: string;
+    auditory?: string;
+}
+export { ScheduleFilterOptions }
+export { ScheduleFilterOptions as ScheduleFilterOptions_alias_1 }
+export { ScheduleFilterOptions as ScheduleFilterOptions_alias_2 }
+
+declare interface ScheduleItem {
+    weekNumber: number[] | null;
+    studentGroups: LessonStudentGroup[];
+    numSubgroup: number;
+    auditories: string[];
+    startLessonTime: string;
+    endLessonTime: string;
+    subject: string;
+    subjectFullName: string;
+    note: Maybe<string>;
+    lessonTypeAbbrev: string | null;
+    dateLesson: Maybe<string>;
+    startLessonDate: Maybe<string>;
+    endLessonDate: Maybe<string>;
+    announcement: boolean;
+    split: boolean;
+    employees: Maybe<Employee[]>;
+}
+export { ScheduleItem }
+export { ScheduleItem as ScheduleItem_alias_1 }
+export { ScheduleItem as ScheduleItem_alias_2 }
+
+declare interface ScheduleResponse {
+    employeeDto: Maybe<Employee>;
+    studentGroupDto: Maybe<StudentGroupCatalogItem>;
+    schedules: WeekScheduleMap | null;
+    exams: ScheduleItem[] | null;
+    startDate: Maybe<string>;
+    endDate: Maybe<string>;
+    startExamsDate: Maybe<string>;
+    endExamsDate: Maybe<string>;
+}
+export { ScheduleResponse }
+export { ScheduleResponse as ScheduleResponse_alias_1 }
+export { ScheduleResponse as ScheduleResponse_alias_2 }
+
+declare interface Speciality {
+    id: number;
+    name: string;
+    abbrev: string;
+    educationForm: EducationForm[];
+    facultyId: number;
+    code: string;
+}
+export { Speciality }
+export { Speciality as Speciality_alias_1 }
+export { Speciality as Speciality_alias_2 }
+
+declare interface StudentGroupCatalogItem {
+    name: string;
+    facultyId: number;
+    facultyName?: string;
+    facultyAbbrev?: string;
+    specialityDepartmentEducationFormId: number;
+    specialityName: string;
+    specialityAbbrev?: string;
+    course: number;
+    id: number;
+    calendarId: string;
+    educationDegree?: number;
+}
+export { StudentGroupCatalogItem }
+export { StudentGroupCatalogItem as StudentGroupCatalogItem_alias_1 }
+export { StudentGroupCatalogItem as StudentGroupCatalogItem_alias_2 }
+
+declare interface StudentGroupShort {
+    id: number;
+    name: string;
+}
+export { StudentGroupShort }
+export { StudentGroupShort as StudentGroupShort_alias_1 }
+export { StudentGroupShort as StudentGroupShort_alias_2 }
+
+declare type Weekday = "Понедельник" | "Вторник" | "Среда" | "Четверг" | "Пятница" | "Суббота";
+export { Weekday }
+export { Weekday as Weekday_alias_1 }
+export { Weekday as Weekday_alias_2 }
+
+declare type WeekScheduleMap = Partial<Record<Weekday, ScheduleItem[]>>;
+export { WeekScheduleMap }
+export { WeekScheduleMap as WeekScheduleMap_alias_1 }
+export { WeekScheduleMap as WeekScheduleMap_alias_2 }
+
+export { }