bsuir-iis-api 0.6.6 → 0.6.7

package/CHANGELOG.md

@@ -8,6 +8,18 @@ This changelog is maintained manually and updated in release commits.
 
 ## [Unreleased]
 
+## [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

@@ -144,6 +144,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,537 @@
+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 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): {
+    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): {
+    listAll(options?: ReadOptions): Promise<Department[]>;
+};
+
+export declare function createEmployeesModule(config: InternalClientConfig): {
+    listAll(options?: ReadOptions): Promise<EmployeeCatalogItem[]>;
+};
+
+export declare function createFacultiesModule(config: InternalClientConfig): {
+    listAll(options?: ReadOptions): Promise<Faculty[]>;
+};
+
+export declare function createGroupsModule(config: InternalClientConfig): {
+    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): {
+    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 { }

package/dist/index.d.ts

@@ -1,293 +1,33 @@
-type QueryValue = string | number | boolean | null | undefined;
-type QueryParams = Record<string, QueryValue>;
-/**
- * Common request options shared by read-only API methods.
- */
-interface RequestOptions {
-    /**
-     * Query parameters appended to endpoint URL.
-     */
-    query?: QueryParams | undefined;
-    /**
-     * Optional signal to cancel request from the caller side.
-     */
-    signal?: AbortSignal | undefined;
-}
-/**
- * Options accepted by {@link createBsuirClient}.
- */
-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;
-}
-
-/**
- * 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[]>;
-    };
-};
-/**
- * Public client contract returned by {@link createBsuirClient}.
- */
-type BsuirClient = ReturnType<typeof createBsuirClient>;
-
-/**
- * Read options used by all module methods.
- */
-interface ReadOptions extends RequestOptions {
-    /**
-     * When true, return raw API payload where supported.
-     */
-    raw?: boolean;
-}
-
-declare class BsuirApiError extends Error {
-    readonly status: number;
-    readonly endpoint: string;
-    readonly body: unknown;
-    constructor(message: string, status: number, endpoint: string, body: unknown);
-}
-declare class BsuirNetworkError extends Error {
-    readonly endpoint: string;
-    readonly causeError: unknown;
-    constructor(message: string, endpoint: string, causeError: unknown);
-}
-declare class BsuirTimeoutError extends Error {
-    readonly endpoint: string;
-    readonly timeoutMs: number;
-    constructor(message: string, endpoint: string, timeoutMs: number);
-}
-declare class BsuirValidationError extends Error {
-    constructor(message: string);
-}
-
-type Weekday = "Понедельник" | "Вторник" | "Среда" | "Четверг" | "Пятница" | "Суббота";
-/** Payload from IIS legacy `last-update-date/*` endpoints (`schedule.getLastUpdateByGroup` / `getLastUpdateByEmployee`). */
-interface ApiDateResponse {
-    lastUpdateDate: string;
-}
-interface StudentGroupShort {
-    id: number;
-    name: string;
-}
-type Maybe<T> = T | null;
-
-interface Announcement {
-    id: number;
-    employee: string;
-    content: string;
-    date: string;
-    employeeDepartments: string[];
-    studentGroups: StudentGroupShort[];
-}
-
-interface Faculty {
-    id: number;
-    name: string;
-    abbrev: string;
-}
-interface Department {
-    id: number;
-    name: string;
-    abbrev: string;
-}
-interface EducationForm {
-    id: number;
-    name: string;
-}
-interface Speciality {
-    id: number;
-    name: string;
-    abbrev: string;
-    educationForm: EducationForm[];
-    facultyId: number;
-    code: string;
-}
-interface StudentGroupCatalogItem {
-    name: string;
-    facultyId: number;
-    facultyName?: string;
-    facultyAbbrev?: string;
-    specialityDepartmentEducationFormId: number;
-    specialityName: string;
-    specialityAbbrev?: string;
-    course: number;
-    id: number;
-    calendarId: string;
-    educationDegree?: number;
-}
-interface AuditoryType {
-    id: number;
-    name: string;
-    abbrev: string;
-}
-interface BuildingNumber {
-    id: number;
-    name: string;
-}
-interface AuditoryDepartment {
-    idDepartment: number;
-    abbrev: string;
-    name: string;
-    nameAndAbbrev: string;
-}
-interface Auditory {
-    id: number;
-    name: string;
-    note: string;
-    capacity: number | null;
-    auditoryType: AuditoryType;
-    buildingNumber: BuildingNumber;
-    department: AuditoryDepartment;
-}
-
-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[]>;
-}
-interface EmployeeCatalogItem {
-    firstName: string;
-    lastName: string;
-    middleName: string;
-    degree: string;
-    rank: string;
-    photoLink: string;
-    calendarId: string;
-    academicDepartment?: string[];
-    id: number;
-    urlId: string;
-    fio: string;
-}
-
-interface LessonStudentGroup {
-    specialityName: string;
-    specialityCode: string;
-    numberOfStudents: number;
-    name: string;
-    educationDegree: number;
-}
-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[]>;
-}
-type WeekScheduleMap = Partial<Record<Weekday, ScheduleItem[]>>;
-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>;
-}
-interface FlattenedScheduleItem extends ScheduleItem {
-    day: Weekday | null;
-    source: "schedules" | "exams";
-}
-type FlattenedLessonsByDay = Partial<Record<Weekday, FlattenedScheduleItem[]>>;
-interface ScheduleFilterOptions {
-    source?: "schedules" | "exams";
-    weekday?: Weekday;
-    weekNumber?: number;
-    subgroup?: number;
-    lessonTypeAbbrev?: string | string[];
-    subjectQuery?: string;
-    employeeUrlId?: string;
-    auditory?: string;
-}
-interface NormalizedScheduleResponse extends Omit<ScheduleResponse, "schedules" | "exams"> {
-    schedules: WeekScheduleMap;
-    exams: ScheduleItem[];
-    lessons: FlattenedScheduleItem[];
-    lessonsByDay: FlattenedLessonsByDay;
-    scheduleLessons: FlattenedScheduleItem[];
-    examLessons: FlattenedScheduleItem[];
-}
-
-export { type Announcement, type ApiDateResponse, type Auditory, type AuditoryDepartment, type AuditoryType, BsuirApiError, type BsuirClient, type BsuirClientOptions, BsuirNetworkError, BsuirTimeoutError, BsuirValidationError, type BuildingNumber, type Department, type EducationForm, type Employee, type EmployeeCatalogItem, type Faculty, type FlattenedLessonsByDay, type FlattenedScheduleItem, type LessonStudentGroup, type Maybe, type NormalizedScheduleResponse, type ReadOptions, type RequestOptions, type ScheduleFilterOptions, type ScheduleItem, type ScheduleResponse, type Speciality, type StudentGroupCatalogItem, type StudentGroupShort, type WeekScheduleMap, type Weekday, createBsuirClient };
+export { createBsuirClient } from './_tsup-dts-rollup.js';
+export { BsuirClient } from './_tsup-dts-rollup.js';
+export { BsuirClientOptions } from './_tsup-dts-rollup.js';
+export { RequestOptions } from './_tsup-dts-rollup.js';
+export { ReadOptions } from './_tsup-dts-rollup.js';
+export { BsuirApiError } from './_tsup-dts-rollup.js';
+export { BsuirNetworkError } from './_tsup-dts-rollup.js';
+export { BsuirTimeoutError } from './_tsup-dts-rollup.js';
+export { BsuirValidationError } from './_tsup-dts-rollup.js';
+export { Announcement } from './_tsup-dts-rollup.js';
+export { Faculty } from './_tsup-dts-rollup.js';
+export { Department } from './_tsup-dts-rollup.js';
+export { EducationForm } from './_tsup-dts-rollup.js';
+export { Speciality } from './_tsup-dts-rollup.js';
+export { StudentGroupCatalogItem } from './_tsup-dts-rollup.js';
+export { AuditoryType } from './_tsup-dts-rollup.js';
+export { BuildingNumber } from './_tsup-dts-rollup.js';
+export { AuditoryDepartment } from './_tsup-dts-rollup.js';
+export { Auditory } from './_tsup-dts-rollup.js';
+export { Weekday } from './_tsup-dts-rollup.js';
+export { ApiDateResponse } from './_tsup-dts-rollup.js';
+export { StudentGroupShort } from './_tsup-dts-rollup.js';
+export { Maybe } from './_tsup-dts-rollup.js';
+export { Employee } from './_tsup-dts-rollup.js';
+export { EmployeeCatalogItem } from './_tsup-dts-rollup.js';
+export { LessonStudentGroup } from './_tsup-dts-rollup.js';
+export { ScheduleItem } from './_tsup-dts-rollup.js';
+export { WeekScheduleMap } from './_tsup-dts-rollup.js';
+export { ScheduleResponse } from './_tsup-dts-rollup.js';
+export { FlattenedScheduleItem } from './_tsup-dts-rollup.js';
+export { FlattenedLessonsByDay } from './_tsup-dts-rollup.js';
+export { ScheduleFilterOptions } from './_tsup-dts-rollup.js';
+export { NormalizedScheduleResponse } from './_tsup-dts-rollup.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bsuir-iis-api",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "Type-safe ESM SDK for BSUIR IIS API",
   "type": "module",
   "author": "kotru21",
@@ -53,19 +53,23 @@
     "release:dry": "npm pack --dry-run"
   },
   "devDependencies": {
+    "@microsoft/api-extractor": "^7.58.0",
     "@changesets/cli": "^2.30.0",
     "@eslint/js": "^10.0.1",
     "@types/node": "^25.5.0",
-    "@typescript-eslint/eslint-plugin": "^8.57.2",
-    "@typescript-eslint/parser": "^8.57.2",
-    "@vitest/coverage-v8": "^4.1.1",
+    "@typescript-eslint/eslint-plugin": "^8.58.0",
+    "@typescript-eslint/parser": "^8.58.0",
+    "@vitest/coverage-v8": "^4.1.2",
     "eslint": "^10.1.0",
     "eslint-config-prettier": "^10.1.8",
     "globals": "^17.4.0",
     "prettier": "^3.8.1",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.57.2",
-    "vitest": "^4.1.1"
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.58.0",
+    "vitest": "^4.1.2"
+  },
+  "overrides": {
+    "lodash": "^4.17.24"
   }
 }