bsuir-iis-api 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and the project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-03-15
+
+### Added
+
+- Initial ESM-only TypeScript SDK implementation.
+- Typed modules for schedules, catalogs, announcements, current week and last update.
+- Retry/timeout-enabled HTTP client with typed errors.
+- Unit and smoke tests with Vitest.
+- CI, release and npm publishing scaffolding.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kotru21
+
+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,98 @@
+# bsuir-iis-api
+
+Type-safe ESM SDK for [BSUIR IIS API](https://iis.bsuir.by/api/v1) with support for Node.js and browser runtimes.
+
+## Install
+
+```bash
+npm install bsuir-iis-api
+```
+
+## Quick start
+
+```ts
+import { createBsuirClient } from "bsuir-iis-api";
+
+const client = createBsuirClient();
+
+const schedule = await client.schedule.getGroup("053503");
+if ("lessons" in schedule) {
+  console.log(schedule.lessons.length);
+}
+```
+
+## Client options
+
+```ts
+const client = createBsuirClient({
+  baseUrl: "https://iis.bsuir.by/api/v1",
+  timeoutMs: 10000,
+  retries: 2,
+  retryDelayMs: 300,
+  defaultRaw: false
+});
+```
+
+- `fetch` can be passed for custom runtime/testing.
+- `AbortSignal` is supported by all read methods.
+
+## API
+
+### Schedule
+
+- `client.schedule.getGroup(groupNumber, options?)`
+- `client.schedule.getEmployee(urlId, options?)`
+- `client.schedule.getCurrentWeek(options?)`
+- `client.schedule.getLastUpdateByGroup({ groupNumber } | { id }, options?)`
+- `client.schedule.getLastUpdateByEmployee({ urlId } | { id }, options?)`
+
+### Catalogs
+
+- `client.groups.listAll(options?)`
+- `client.employees.listAll(options?)`
+- `client.faculties.listAll(options?)`
+- `client.departments.listAll(options?)`
+- `client.specialities.listAll(options?)`
+- `client.auditories.listAll(options?)`
+
+### Announcements
+
+- `client.announcements.byEmployee(urlId, options?)`
+- `client.announcements.byDepartment(id, options?)`
+
+### Meta
+
+- `client.currentWeek.get(options?)`
+- `client.lastUpdate.byGroup({ groupNumber } | { id }, options?)`
+- `client.lastUpdate.byEmployee({ urlId } | { id }, options?)`
+
+## Errors
+
+SDK throws typed errors:
+
+- `BsuirApiError` for HTTP errors (contains `status`, `endpoint`, `body`)
+- `BsuirNetworkError` for transport errors
+- `BsuirTimeoutError` for timeouts
+- `BsuirValidationError` for invalid input parameters
+
+## Raw vs normalized schedule response
+
+By default, schedule methods return normalized response with `lessons` array.
+
+```ts
+const raw = await client.schedule.getGroup("053503", { raw: true });
+```
+
+Use `defaultRaw: true` in `createBsuirClient` to change global behavior.
+
+## Development
+
+```bash
+npm install
+npm run check
+npm run build
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,250 @@
+type QueryValue = string | number | boolean | null | undefined;
+type QueryParams = Record<string, QueryValue>;
+interface RequestOptions {
+    query?: QueryParams | undefined;
+    signal?: AbortSignal | undefined;
+}
+interface BsuirClientOptions {
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+    timeoutMs?: number;
+    retries?: number;
+    retryDelayMs?: number;
+    userAgent?: string;
+    defaultRaw?: boolean;
+}
+
+interface ReadOptions extends RequestOptions {
+    raw?: boolean;
+}
+
+declare function createBsuirClient(options?: BsuirClientOptions): {
+    schedule: {
+        getGroup(groupNumber: string, options?: ReadOptions): Promise<ScheduleResponse | NormalizedScheduleResponse>;
+        getEmployee(urlId: string, options?: ReadOptions): Promise<ScheduleResponse | NormalizedScheduleResponse>;
+        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[]>;
+    };
+    lastUpdate: {
+        byGroup(params: {
+            groupNumber: string;
+        } | {
+            id: number;
+        }, options?: ReadOptions): Promise<ApiDateResponse>;
+        byEmployee(params: {
+            urlId: string;
+        } | {
+            id: number;
+        }, options?: ReadOptions): Promise<ApiDateResponse>;
+    };
+    currentWeek: {
+        get(options?: ReadOptions): Promise<number>;
+    };
+};
+type BsuirClient = ReturnType<typeof createBsuirClient>;
+
+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 = "Понедельник" | "Вторник" | "Среда" | "Четверг" | "Пятница" | "Суббота";
+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[];
+    studentGroups: LessonStudentGroup[];
+    numSubgroup: number;
+    auditories: string[];
+    startLessonTime: string;
+    endLessonTime: string;
+    subject: string;
+    subjectFullName: string;
+    note: Maybe<string>;
+    lessonTypeAbbrev: string;
+    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;
+    exams: ScheduleItem[];
+    startDate: Maybe<string>;
+    endDate: Maybe<string>;
+    startExamsDate: Maybe<string>;
+    endExamsDate: Maybe<string>;
+}
+interface FlattenedScheduleItem extends ScheduleItem {
+    day: Weekday | null;
+    source: "schedules" | "exams";
+}
+interface NormalizedScheduleResponse extends Omit<ScheduleResponse, "schedules" | "exams"> {
+    schedules: WeekScheduleMap;
+    exams: ScheduleItem[];
+    lessons: 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 FlattenedScheduleItem, type LessonStudentGroup, type Maybe, type NormalizedScheduleResponse, type ScheduleItem, type ScheduleResponse, type Speciality, type StudentGroupCatalogItem, type StudentGroupShort, type WeekScheduleMap, type Weekday, createBsuirClient };

package/dist/index.js

@@ -0,0 +1,405 @@
+// src/client/errors.ts
+var BsuirApiError = class extends Error {
+  status;
+  endpoint;
+  body;
+  constructor(message, status, endpoint, body) {
+    super(message);
+    this.name = "BsuirApiError";
+    this.status = status;
+    this.endpoint = endpoint;
+    this.body = body;
+  }
+};
+var BsuirNetworkError = class extends Error {
+  endpoint;
+  causeError;
+  constructor(message, endpoint, causeError) {
+    super(message);
+    this.name = "BsuirNetworkError";
+    this.endpoint = endpoint;
+    this.causeError = causeError;
+  }
+};
+var BsuirTimeoutError = class extends Error {
+  endpoint;
+  timeoutMs;
+  constructor(message, endpoint, timeoutMs) {
+    super(message);
+    this.name = "BsuirTimeoutError";
+    this.endpoint = endpoint;
+    this.timeoutMs = timeoutMs;
+  }
+};
+var BsuirValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "BsuirValidationError";
+  }
+};
+
+// src/utils/guards.ts
+function assertNonEmptyString(value, fieldName) {
+  if (!value || value.trim().length === 0) {
+    throw new BsuirValidationError(`'${fieldName}' must be a non-empty string`);
+  }
+}
+function assertPositiveInt(value, fieldName) {
+  if (!Number.isInteger(value) || value <= 0) {
+    throw new BsuirValidationError(`'${fieldName}' must be a positive integer`);
+  }
+}
+function isAbortError(error) {
+  return error instanceof DOMException && error.name === "AbortError";
+}
+
+// src/client/http.ts
+var RETRIABLE_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+function buildUrl(baseUrl, path, query) {
+  const normalizedBase = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+  const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+  const url = new URL(`${normalizedBase}${normalizedPath}`);
+  if (query) {
+    for (const [key, value] of Object.entries(query)) {
+      if (value === void 0 || value === null) {
+        continue;
+      }
+      url.searchParams.set(key, String(value));
+    }
+  }
+  return url.toString();
+}
+function mergeSignals(signal, timeoutMs) {
+  if (typeof AbortSignal.any === "function") {
+    return AbortSignal.any([AbortSignal.timeout(timeoutMs), signal].filter(Boolean));
+  }
+  if (signal) {
+    return signal;
+  }
+  return AbortSignal.timeout(timeoutMs);
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function parseBody(response) {
+  const contentType = response.headers.get("content-type") ?? "";
+  if (!contentType.includes("application/json")) {
+    return response.text();
+  }
+  try {
+    return await response.json();
+  } catch {
+    throw new BsuirApiError("Invalid JSON response payload", response.status, response.url, null);
+  }
+}
+async function requestJson(config, path, options = {}) {
+  const endpoint = buildUrl(config.baseUrl, path, options.query);
+  const requestSignal = mergeSignals(options.signal, config.timeoutMs);
+  const headers = new Headers({
+    Accept: "application/json"
+  });
+  if (config.userAgent) {
+    headers.set("User-Agent", config.userAgent);
+  }
+  for (let attempt = 0; attempt <= config.retries; attempt += 1) {
+    try {
+      const response = await config.fetchImpl(endpoint, {
+        method: "GET",
+        headers,
+        signal: requestSignal
+      });
+      if (!response.ok) {
+        const errorBody = await parseBody(response);
+        if (attempt < config.retries && RETRIABLE_STATUS_CODES.has(response.status)) {
+          await sleep(config.retryDelayMs * (attempt + 1));
+          continue;
+        }
+        throw new BsuirApiError(
+          `BSUIR API returned HTTP ${response.status} for ${path}`,
+          response.status,
+          endpoint,
+          errorBody
+        );
+      }
+      return await parseBody(response);
+    } catch (error) {
+      if (error instanceof BsuirApiError) {
+        throw error;
+      }
+      if (isAbortError(error)) {
+        if (options.signal?.aborted) {
+          throw error;
+        }
+        throw new BsuirTimeoutError(
+          `Request timed out after ${config.timeoutMs}ms: ${path}`,
+          endpoint,
+          config.timeoutMs
+        );
+      }
+      if (attempt < config.retries) {
+        await sleep(config.retryDelayMs * (attempt + 1));
+        continue;
+      }
+      throw new BsuirNetworkError(`Network error while requesting ${path}`, endpoint, error);
+    }
+  }
+  throw new BsuirNetworkError(`Network error while requesting ${path}`, endpoint, null);
+}
+
+// src/modules/announcements.ts
+function createAnnouncementsModule(config) {
+  return {
+    async byEmployee(urlId, options = {}) {
+      assertNonEmptyString(urlId, "urlId");
+      return requestJson(config, "/announcements/employees", {
+        query: { "url-id": urlId },
+        signal: options.signal
+      });
+    },
+    async byDepartment(id, options = {}) {
+      assertPositiveInt(id, "id");
+      return requestJson(config, "/announcements/departments", {
+        query: { id },
+        signal: options.signal
+      });
+    }
+  };
+}
+
+// src/modules/auditories.ts
+function createAuditoriesModule(config) {
+  return {
+    async listAll(options = {}) {
+      return requestJson(config, "/auditories", {
+        signal: options.signal
+      });
+    }
+  };
+}
+
+// src/modules/currentWeek.ts
+function createCurrentWeekModule(config) {
+  return {
+    async get(options = {}) {
+      return requestJson(config, "/schedule/current-week", {
+        signal: options.signal
+      });
+    }
+  };
+}
+
+// src/modules/departments.ts
+function createDepartmentsModule(config) {
+  return {
+    async listAll(options = {}) {
+      return requestJson(config, "/departments", {
+        signal: options.signal
+      });
+    }
+  };
+}
+
+// src/modules/employees.ts
+function createEmployeesModule(config) {
+  return {
+    async listAll(options = {}) {
+      return requestJson(config, "/employees/all", {
+        signal: options.signal
+      });
+    }
+  };
+}
+
+// src/modules/faculties.ts
+function createFacultiesModule(config) {
+  return {
+    async listAll(options = {}) {
+      return requestJson(config, "/faculties", {
+        signal: options.signal
+      });
+    }
+  };
+}
+
+// src/modules/groups.ts
+function createGroupsModule(config) {
+  return {
+    async listAll(options = {}) {
+      return requestJson(config, "/student-groups", {
+        signal: options.signal
+      });
+    }
+  };
+}
+
+// src/modules/lastUpdate.ts
+function createLastUpdateModule(config) {
+  return {
+    async byGroup(params, options = {}) {
+      let query;
+      if ("groupNumber" in params) {
+        assertNonEmptyString(params.groupNumber, "groupNumber");
+        query = { groupNumber: params.groupNumber };
+      } else {
+        assertPositiveInt(params.id, "id");
+        query = { id: params.id };
+      }
+      return requestJson(config, "/last-update-date/student-group", {
+        query,
+        signal: options.signal
+      });
+    },
+    async byEmployee(params, options = {}) {
+      let query;
+      if ("urlId" in params) {
+        assertNonEmptyString(params.urlId, "urlId");
+        query = { "url-id": params.urlId };
+      } else {
+        assertPositiveInt(params.id, "id");
+        query = { id: params.id };
+      }
+      return requestJson(config, "/last-update-date/employee", {
+        query,
+        signal: options.signal
+      });
+    }
+  };
+}
+
+// src/modules/schedule.ts
+var WEEKDAYS = [
+  "\u041F\u043E\u043D\u0435\u0434\u0435\u043B\u044C\u043D\u0438\u043A",
+  "\u0412\u0442\u043E\u0440\u043D\u0438\u043A",
+  "\u0421\u0440\u0435\u0434\u0430",
+  "\u0427\u0435\u0442\u0432\u0435\u0440\u0433",
+  "\u041F\u044F\u0442\u043D\u0438\u0446\u0430",
+  "\u0421\u0443\u0431\u0431\u043E\u0442\u0430"
+];
+function normalizeSchedule(response) {
+  const lessons = [];
+  for (const day of WEEKDAYS) {
+    const dayItems = response.schedules[day] ?? [];
+    for (const item of dayItems) {
+      lessons.push({ ...item, day, source: "schedules" });
+    }
+  }
+  for (const exam of response.exams) {
+    lessons.push({
+      ...exam,
+      day: null,
+      // Exams are not grouped by weekday in API response.
+      source: "exams"
+    });
+  }
+  return {
+    ...response,
+    lessons
+  };
+}
+function createScheduleModule(config) {
+  return {
+    async getGroup(groupNumber, options = {}) {
+      assertNonEmptyString(groupNumber, "groupNumber");
+      const response = await requestJson(config, "/schedule", {
+        query: { studentGroup: groupNumber },
+        signal: options.signal
+      });
+      return options.raw ?? config.defaultRaw ? response : normalizeSchedule(response);
+    },
+    async getEmployee(urlId, options = {}) {
+      assertNonEmptyString(urlId, "urlId");
+      const response = await requestJson(config, `/employees/schedule/${urlId}`, {
+        signal: options.signal
+      });
+      return options.raw ?? config.defaultRaw ? response : normalizeSchedule(response);
+    },
+    async getCurrentWeek(options = {}) {
+      return requestJson(config, "/schedule/current-week", { signal: options.signal });
+    },
+    async getLastUpdateByGroup(params, options = {}) {
+      let query;
+      if ("groupNumber" in params) {
+        assertNonEmptyString(params.groupNumber, "groupNumber");
+        query = { groupNumber: params.groupNumber };
+      } else {
+        assertPositiveInt(params.id, "id");
+        query = { id: params.id };
+      }
+      return requestJson(config, "/last-update-date/student-group", {
+        query,
+        signal: options.signal
+      });
+    },
+    async getLastUpdateByEmployee(params, options = {}) {
+      let query;
+      if ("urlId" in params) {
+        assertNonEmptyString(params.urlId, "urlId");
+        query = { "url-id": params.urlId };
+      } else {
+        assertPositiveInt(params.id, "id");
+        query = { id: params.id };
+      }
+      return requestJson(config, "/last-update-date/employee", {
+        query,
+        signal: options.signal
+      });
+    }
+  };
+}
+
+// src/modules/specialities.ts
+function createSpecialitiesModule(config) {
+  return {
+    async listAll(options = {}) {
+      return requestJson(config, "/specialities", {
+        signal: options.signal
+      });
+    }
+  };
+}
+
+// src/client/createClient.ts
+var DEFAULT_BASE_URL = "https://iis.bsuir.by/api/v1";
+function resolveFetch(customFetch) {
+  if (customFetch) {
+    return customFetch;
+  }
+  if (typeof globalThis.fetch !== "function") {
+    throw new Error("Global fetch is unavailable. Provide 'fetch' in createBsuirClient options.");
+  }
+  return globalThis.fetch;
+}
+function createInternalConfig(options = {}) {
+  return {
+    baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
+    fetchImpl: resolveFetch(options.fetch),
+    timeoutMs: options.timeoutMs ?? 1e4,
+    retries: options.retries ?? 1,
+    retryDelayMs: options.retryDelayMs ?? 300,
+    userAgent: options.userAgent,
+    defaultRaw: options.defaultRaw ?? false
+  };
+}
+function createBsuirClient(options = {}) {
+  const config = createInternalConfig(options);
+  return {
+    schedule: createScheduleModule(config),
+    groups: createGroupsModule(config),
+    employees: createEmployeesModule(config),
+    faculties: createFacultiesModule(config),
+    departments: createDepartmentsModule(config),
+    specialities: createSpecialitiesModule(config),
+    announcements: createAnnouncementsModule(config),
+    auditories: createAuditoriesModule(config),
+    lastUpdate: createLastUpdateModule(config),
+    currentWeek: createCurrentWeekModule(config)
+  };
+}
+export {
+  BsuirApiError,
+  BsuirNetworkError,
+  BsuirTimeoutError,
+  BsuirValidationError,
+  createBsuirClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/errors.ts","../src/utils/guards.ts","../src/client/http.ts","../src/modules/announcements.ts","../src/modules/auditories.ts","../src/modules/currentWeek.ts","../src/modules/departments.ts","../src/modules/employees.ts","../src/modules/faculties.ts","../src/modules/groups.ts","../src/modules/lastUpdate.ts","../src/modules/schedule.ts","../src/modules/specialities.ts","../src/client/createClient.ts"],"sourcesContent":["export class BsuirApiError extends Error {\r\n  readonly status: number;\r\n  readonly endpoint: string;\r\n  readonly body: unknown;\r\n\r\n  constructor(message: string, status: number, endpoint: string, body: unknown) {\r\n    super(message);\r\n    this.name = \"BsuirApiError\";\r\n    this.status = status;\r\n    this.endpoint = endpoint;\r\n    this.body = body;\r\n  }\r\n}\r\n\r\nexport class BsuirNetworkError extends Error {\r\n  readonly endpoint: string;\r\n  readonly causeError: unknown;\r\n\r\n  constructor(message: string, endpoint: string, causeError: unknown) {\r\n    super(message);\r\n    this.name = \"BsuirNetworkError\";\r\n    this.endpoint = endpoint;\r\n    this.causeError = causeError;\r\n  }\r\n}\r\n\r\nexport class BsuirTimeoutError extends Error {\r\n  readonly endpoint: string;\r\n  readonly timeoutMs: number;\r\n\r\n  constructor(message: string, endpoint: string, timeoutMs: number) {\r\n    super(message);\r\n    this.name = \"BsuirTimeoutError\";\r\n    this.endpoint = endpoint;\r\n    this.timeoutMs = timeoutMs;\r\n  }\r\n}\r\n\r\nexport class BsuirValidationError extends Error {\r\n  constructor(message: string) {\r\n    super(message);\r\n    this.name = \"BsuirValidationError\";\r\n  }\r\n}\r\n","import { BsuirValidationError } from \"../client/errors\";\r\n\r\nexport function assertNonEmptyString(value: string, fieldName: string): void {\r\n  if (!value || value.trim().length === 0) {\r\n    throw new BsuirValidationError(`'${fieldName}' must be a non-empty string`);\r\n  }\r\n}\r\n\r\nexport function assertPositiveInt(value: number, fieldName: string): void {\r\n  if (!Number.isInteger(value) || value <= 0) {\r\n    throw new BsuirValidationError(`'${fieldName}' must be a positive integer`);\r\n  }\r\n}\r\n\r\nexport function isAbortError(error: unknown): boolean {\r\n  return error instanceof DOMException && error.name === \"AbortError\";\r\n}\r\n","import { BsuirApiError, BsuirNetworkError, BsuirTimeoutError } from \"./errors\";\r\nimport type { InternalClientConfig, QueryParams, RequestOptions } from \"./types\";\r\nimport { isAbortError } from \"../utils/guards\";\r\n\r\nconst RETRIABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504]);\r\n\r\nfunction buildUrl(baseUrl: string, path: string, query?: QueryParams): string {\r\n  const normalizedBase = baseUrl.endsWith(\"/\") ? baseUrl.slice(0, -1) : baseUrl;\r\n  const normalizedPath = path.startsWith(\"/\") ? path : `/${path}`;\r\n  const url = new URL(`${normalizedBase}${normalizedPath}`);\r\n\r\n  if (query) {\r\n    for (const [key, value] of Object.entries(query)) {\r\n      if (value === undefined || value === null) {\r\n        continue;\r\n      }\r\n      url.searchParams.set(key, String(value));\r\n    }\r\n  }\r\n\r\n  return url.toString();\r\n}\r\n\r\nfunction mergeSignals(signal: AbortSignal | undefined, timeoutMs: number): AbortSignal {\r\n  if (typeof AbortSignal.any === \"function\") {\r\n    return AbortSignal.any([AbortSignal.timeout(timeoutMs), signal].filter(Boolean) as AbortSignal[]);\r\n  }\r\n\r\n  if (signal) {\r\n    return signal;\r\n  }\r\n\r\n  return AbortSignal.timeout(timeoutMs);\r\n}\r\n\r\nfunction sleep(ms: number): Promise<void> {\r\n  return new Promise((resolve) => setTimeout(resolve, ms));\r\n}\r\n\r\nasync function parseBody(response: Response): Promise<unknown> {\r\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\r\n  if (!contentType.includes(\"application/json\")) {\r\n    return response.text();\r\n  }\r\n\r\n  try {\r\n    return await response.json();\r\n  } catch {\r\n    throw new BsuirApiError(\"Invalid JSON response payload\", response.status, response.url, null);\r\n  }\r\n}\r\n\r\nexport async function requestJson<T>(\r\n  config: InternalClientConfig,\r\n  path: string,\r\n  options: RequestOptions = {}\r\n): Promise<T> {\r\n  const endpoint = buildUrl(config.baseUrl, path, options.query);\r\n  const requestSignal = mergeSignals(options.signal, config.timeoutMs);\r\n  const headers = new Headers({\r\n    Accept: \"application/json\"\r\n  });\r\n\r\n  if (config.userAgent) {\r\n    headers.set(\"User-Agent\", config.userAgent);\r\n  }\r\n\r\n  for (let attempt = 0; attempt <= config.retries; attempt += 1) {\r\n    try {\r\n      const response = await config.fetchImpl(endpoint, {\r\n        method: \"GET\",\r\n        headers,\r\n        signal: requestSignal\r\n      });\r\n\r\n      if (!response.ok) {\r\n        const errorBody = await parseBody(response);\r\n        if (attempt < config.retries && RETRIABLE_STATUS_CODES.has(response.status)) {\r\n          await sleep(config.retryDelayMs * (attempt + 1));\r\n          continue;\r\n        }\r\n        throw new BsuirApiError(\r\n          `BSUIR API returned HTTP ${response.status} for ${path}`,\r\n          response.status,\r\n          endpoint,\r\n          errorBody\r\n        );\r\n      }\r\n\r\n      return (await parseBody(response)) as T;\r\n    } catch (error) {\r\n      if (error instanceof BsuirApiError) {\r\n        throw error;\r\n      }\r\n\r\n      if (isAbortError(error)) {\r\n        if (options.signal?.aborted) {\r\n          throw error;\r\n        }\r\n        throw new BsuirTimeoutError(\r\n          `Request timed out after ${config.timeoutMs}ms: ${path}`,\r\n          endpoint,\r\n          config.timeoutMs\r\n        );\r\n      }\r\n\r\n      if (attempt < config.retries) {\r\n        await sleep(config.retryDelayMs * (attempt + 1));\r\n        continue;\r\n      }\r\n\r\n      throw new BsuirNetworkError(`Network error while requesting ${path}`, endpoint, error);\r\n    }\r\n  }\r\n\r\n  throw new BsuirNetworkError(`Network error while requesting ${path}`, endpoint, null);\r\n}\r\n","import type { InternalClientConfig } from \"../client/types\";\r\nimport { requestJson } from \"../client/http\";\r\nimport { assertNonEmptyString, assertPositiveInt } from \"../utils/guards\";\r\nimport type { Announcement } from \"../types/announcement\";\r\nimport type { ReadOptions } from \"./types\";\r\n\r\nexport function createAnnouncementsModule(config: InternalClientConfig) {\r\n  return {\r\n    async byEmployee(urlId: string, options: ReadOptions = {}): Promise<Announcement[]> {\r\n      assertNonEmptyString(urlId, \"urlId\");\r\n      return requestJson<Announcement[]>(config, \"/announcements/employees\", {\r\n        query: { \"url-id\": urlId },\r\n        signal: options.signal\r\n      });\r\n    },\r\n\r\n    async byDepartment(id: number, options: ReadOptions = {}): Promise<Announcement[]> {\r\n      assertPositiveInt(id, \"id\");\r\n      return requestJson<Announcement[]>(config, \"/announcements/departments\", {\r\n        query: { id },\r\n        signal: options.signal\r\n      });\r\n    }\r\n  };\r\n}\r\n","import type { InternalClientConfig } from \"../client/types\";\r\nimport { requestJson } from \"../client/http\";\r\nimport type { Auditory } from \"../types/catalog\";\r\nimport type { ReadOptions } from \"./types\";\r\n\r\nexport function createAuditoriesModule(config: InternalClientConfig) {\r\n  return {\r\n    async listAll(options: ReadOptions = {}): Promise<Auditory[]> {\r\n      return requestJson<Auditory[]>(config, \"/auditories\", {\r\n        signal: options.signal\r\n      });\r\n    }\r\n  };\r\n}\r\n","import type { InternalClientConfig } from \"../client/types\";\r\nimport { requestJson } from \"../client/http\";\r\nimport type { ReadOptions } from \"./types\";\r\n\r\nexport function createCurrentWeekModule(config: InternalClientConfig) {\r\n  return {\r\n    async get(options: ReadOptions = {}): Promise<number> {\r\n      return requestJson<number>(config, \"/schedule/current-week\", {\r\n        signal: options.signal\r\n      });\r\n    }\r\n  };\r\n}\r\n","import type { InternalClientConfig } from \"../client/types\";\r\nimport { requestJson } from \"../client/http\";\r\nimport type { Department } from \"../types/catalog\";\r\nimport type { ReadOptions } from \"./types\";\r\n\r\nexport function createDepartmentsModule(config: InternalClientConfig) {\r\n  return {\r\n    async listAll(options: ReadOptions = {}): Promise<Department[]> {\r\n      return requestJson<Department[]>(config, \"/departments\", {\r\n        signal: options.signal\r\n      });\r\n    }\r\n  };\r\n}\r\n","import type { InternalClientConfig } from \"../client/types\";\r\nimport { requestJson } from \"../client/http\";\r\nimport type { EmployeeCatalogItem } from \"../types/employee\";\r\nimport type { ReadOptions } from \"./types\";\r\n\r\nexport function createEmployeesModule(config: InternalClientConfig) {\r\n  return {\r\n    async listAll(options: ReadOptions = {}): Promise<EmployeeCatalogItem[]> {\r\n      return requestJson<EmployeeCatalogItem[]>(config, \"/employees/all\", {\r\n        signal: options.signal\r\n      });\r\n    }\r\n  };\r\n}\r\n","import type { InternalClientConfig } from \"../client/types\";\r\nimport { requestJson } from \"../client/http\";\r\nimport type { Faculty } from \"../types/catalog\";\r\nimport type { ReadOptions } from \"./types\";\r\n\r\nexport function createFacultiesModule(config: InternalClientConfig) {\r\n  return {\r\n    async listAll(options: ReadOptions = {}): Promise<Faculty[]> {\r\n      return requestJson<Faculty[]>(config, \"/faculties\", {\r\n        signal: options.signal\r\n      });\r\n    }\r\n  };\r\n}\r\n","import type { InternalClientConfig } from \"../client/types\";\r\nimport { requestJson } from \"../client/http\";\r\nimport type { StudentGroupCatalogItem } from \"../types/catalog\";\r\nimport type { ReadOptions } from \"./types\";\r\n\r\nexport function createGroupsModule(config: InternalClientConfig) {\r\n  return {\r\n    async listAll(options: ReadOptions = {}): Promise<StudentGroupCatalogItem[]> {\r\n      return requestJson<StudentGroupCatalogItem[]>(config, \"/student-groups\", {\r\n        signal: options.signal\r\n      });\r\n    }\r\n  };\r\n}\r\n","import type { InternalClientConfig } from \"../client/types\";\r\nimport { requestJson } from \"../client/http\";\r\nimport { assertNonEmptyString, assertPositiveInt } from \"../utils/guards\";\r\nimport type { ApiDateResponse } from \"../types/common\";\r\nimport type { ReadOptions } from \"./types\";\r\n\r\nexport function createLastUpdateModule(config: InternalClientConfig) {\r\n  return {\r\n    async byGroup(\r\n      params: { groupNumber: string } | { id: number },\r\n      options: ReadOptions = {}\r\n    ): Promise<ApiDateResponse> {\r\n      let query: Record<string, string | number>;\r\n      if (\"groupNumber\" in params) {\r\n        assertNonEmptyString(params.groupNumber, \"groupNumber\");\r\n        query = { groupNumber: params.groupNumber };\r\n      } else {\r\n        assertPositiveInt(params.id, \"id\");\r\n        query = { id: params.id };\r\n      }\r\n\r\n      return requestJson<ApiDateResponse>(config, \"/last-update-date/student-group\", {\r\n        query,\r\n        signal: options.signal\r\n      });\r\n    },\r\n\r\n    async byEmployee(\r\n      params: { urlId: string } | { id: number },\r\n      options: ReadOptions = {}\r\n    ): Promise<ApiDateResponse> {\r\n      let query: Record<string, string | number>;\r\n      if (\"urlId\" in params) {\r\n        assertNonEmptyString(params.urlId, \"urlId\");\r\n        query = { \"url-id\": params.urlId };\r\n      } else {\r\n        assertPositiveInt(params.id, \"id\");\r\n        query = { id: params.id };\r\n      }\r\n\r\n      return requestJson<ApiDateResponse>(config, \"/last-update-date/employee\", {\r\n        query,\r\n        signal: options.signal\r\n      });\r\n    }\r\n  };\r\n}\r\n","import type { InternalClientConfig } from \"../client/types\";\r\nimport { requestJson } from \"../client/http\";\r\nimport { assertNonEmptyString, assertPositiveInt } from \"../utils/guards\";\r\nimport type {\r\n  FlattenedScheduleItem,\r\n  NormalizedScheduleResponse,\r\n  ScheduleResponse\r\n} from \"../types/schedule\";\r\nimport type { ApiDateResponse } from \"../types/common\";\r\nimport type { Weekday } from \"../types/common\";\r\nimport type { ReadOptions } from \"./types\";\r\n\r\nconst WEEKDAYS: Weekday[] = [\r\n  \"Понедельник\",\r\n  \"Вторник\",\r\n  \"Среда\",\r\n  \"Четверг\",\r\n  \"Пятница\",\r\n  \"Суббота\"\r\n];\r\n\r\nfunction normalizeSchedule(response: ScheduleResponse): NormalizedScheduleResponse {\r\n  const lessons: FlattenedScheduleItem[] = [];\r\n  for (const day of WEEKDAYS) {\r\n    const dayItems = response.schedules[day] ?? [];\r\n    for (const item of dayItems) {\r\n      lessons.push({ ...item, day, source: \"schedules\" });\r\n    }\r\n  }\r\n\r\n  for (const exam of response.exams) {\r\n    lessons.push({\r\n      ...exam,\r\n      day: null,\r\n      // Exams are not grouped by weekday in API response.\r\n      source: \"exams\"\r\n    });\r\n  }\r\n\r\n  return {\r\n    ...response,\r\n    lessons\r\n  };\r\n}\r\n\r\nexport function createScheduleModule(config: InternalClientConfig) {\r\n  return {\r\n    async getGroup(\r\n      groupNumber: string,\r\n      options: ReadOptions = {}\r\n    ): Promise<ScheduleResponse | NormalizedScheduleResponse> {\r\n      assertNonEmptyString(groupNumber, \"groupNumber\");\r\n      const response = await requestJson<ScheduleResponse>(config, \"/schedule\", {\r\n        query: { studentGroup: groupNumber },\r\n        signal: options.signal\r\n      });\r\n      return options.raw ?? config.defaultRaw ? response : normalizeSchedule(response);\r\n    },\r\n\r\n    async getEmployee(\r\n      urlId: string,\r\n      options: ReadOptions = {}\r\n    ): Promise<ScheduleResponse | NormalizedScheduleResponse> {\r\n      assertNonEmptyString(urlId, \"urlId\");\r\n      const response = await requestJson<ScheduleResponse>(config, `/employees/schedule/${urlId}`, {\r\n        signal: options.signal\r\n      });\r\n      return options.raw ?? config.defaultRaw ? response : normalizeSchedule(response);\r\n    },\r\n\r\n    async getCurrentWeek(options: ReadOptions = {}): Promise<number> {\r\n      return requestJson<number>(config, \"/schedule/current-week\", { signal: options.signal });\r\n    },\r\n\r\n    async getLastUpdateByGroup(\r\n      params: { groupNumber: string } | { id: number },\r\n      options: ReadOptions = {}\r\n    ): Promise<ApiDateResponse> {\r\n      let query: Record<string, string | number>;\r\n      if (\"groupNumber\" in params) {\r\n        assertNonEmptyString(params.groupNumber, \"groupNumber\");\r\n        query = { groupNumber: params.groupNumber };\r\n      } else {\r\n        assertPositiveInt(params.id, \"id\");\r\n        query = { id: params.id };\r\n      }\r\n      return requestJson<ApiDateResponse>(config, \"/last-update-date/student-group\", {\r\n        query,\r\n        signal: options.signal\r\n      });\r\n    },\r\n\r\n    async getLastUpdateByEmployee(\r\n      params: { urlId: string } | { id: number },\r\n      options: ReadOptions = {}\r\n    ): Promise<ApiDateResponse> {\r\n      let query: Record<string, string | number>;\r\n      if (\"urlId\" in params) {\r\n        assertNonEmptyString(params.urlId, \"urlId\");\r\n        query = { \"url-id\": params.urlId };\r\n      } else {\r\n        assertPositiveInt(params.id, \"id\");\r\n        query = { id: params.id };\r\n      }\r\n      return requestJson<ApiDateResponse>(config, \"/last-update-date/employee\", {\r\n        query,\r\n        signal: options.signal\r\n      });\r\n    }\r\n  };\r\n}\r\n","import type { InternalClientConfig } from \"../client/types\";\r\nimport { requestJson } from \"../client/http\";\r\nimport type { Speciality } from \"../types/catalog\";\r\nimport type { ReadOptions } from \"./types\";\r\n\r\nexport function createSpecialitiesModule(config: InternalClientConfig) {\r\n  return {\r\n    async listAll(options: ReadOptions = {}): Promise<Speciality[]> {\r\n      return requestJson<Speciality[]>(config, \"/specialities\", {\r\n        signal: options.signal\r\n      });\r\n    }\r\n  };\r\n}\r\n","import type { BsuirClientOptions, InternalClientConfig } from \"./types\";\r\nimport { createAnnouncementsModule } from \"../modules/announcements\";\r\nimport { createAuditoriesModule } from \"../modules/auditories\";\r\nimport { createCurrentWeekModule } from \"../modules/currentWeek\";\r\nimport { createDepartmentsModule } from \"../modules/departments\";\r\nimport { createEmployeesModule } from \"../modules/employees\";\r\nimport { createFacultiesModule } from \"../modules/faculties\";\r\nimport { createGroupsModule } from \"../modules/groups\";\r\nimport { createLastUpdateModule } from \"../modules/lastUpdate\";\r\nimport { createScheduleModule } from \"../modules/schedule\";\r\nimport { createSpecialitiesModule } from \"../modules/specialities\";\r\n\r\nconst DEFAULT_BASE_URL = \"https://iis.bsuir.by/api/v1\";\r\n\r\nfunction resolveFetch(customFetch?: typeof globalThis.fetch): typeof globalThis.fetch {\r\n  if (customFetch) {\r\n    return customFetch;\r\n  }\r\n\r\n  if (typeof globalThis.fetch !== \"function\") {\r\n    throw new Error(\"Global fetch is unavailable. Provide 'fetch' in createBsuirClient options.\");\r\n  }\r\n\r\n  return globalThis.fetch;\r\n}\r\n\r\nfunction createInternalConfig(options: BsuirClientOptions = {}): InternalClientConfig {\r\n  return {\r\n    baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\r\n    fetchImpl: resolveFetch(options.fetch),\r\n    timeoutMs: options.timeoutMs ?? 10_000,\r\n    retries: options.retries ?? 1,\r\n    retryDelayMs: options.retryDelayMs ?? 300,\r\n    userAgent: options.userAgent,\r\n    defaultRaw: options.defaultRaw ?? false\r\n  };\r\n}\r\n\r\nexport function createBsuirClient(options: BsuirClientOptions = {}) {\r\n  const config = createInternalConfig(options);\r\n\r\n  return {\r\n    schedule: createScheduleModule(config),\r\n    groups: createGroupsModule(config),\r\n    employees: createEmployeesModule(config),\r\n    faculties: createFacultiesModule(config),\r\n    departments: createDepartmentsModule(config),\r\n    specialities: createSpecialitiesModule(config),\r\n    announcements: createAnnouncementsModule(config),\r\n    auditories: createAuditoriesModule(config),\r\n    lastUpdate: createLastUpdateModule(config),\r\n    currentWeek: createCurrentWeekModule(config)\r\n  };\r\n}\r\n\r\nexport type BsuirClient = ReturnType<typeof createBsuirClient>;\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "bsuir-iis-api",
+  "version": "0.1.0",
+  "description": "Type-safe ESM SDK for BSUIR IIS API",
+  "type": "module",
+  "author": "kotru21",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kotru21/bsuir-iis-api.git"
+  },
+  "homepage": "https://github.com/kotru21/bsuir-iis-api#readme",
+  "bugs": {
+    "url": "https://github.com/kotru21/bsuir-iis-api/issues"
+  },
+  "keywords": [
+    "bsuir",
+    "iis",
+    "schedule",
+    "api",
+    "sdk",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "check": "npm run lint && npm run typecheck && npm run test",
+    "release:dry": "npm pack --dry-run"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.7",
+    "@eslint/js": "^9.38.0",
+    "@types/node": "^24.7.2",
+    "@typescript-eslint/eslint-plugin": "^8.46.1",
+    "@typescript-eslint/parser": "^8.46.1",
+    "@vitest/coverage-v8": "^3.2.4",
+    "eslint": "^9.38.0",
+    "eslint-config-prettier": "^10.1.8",
+    "globals": "^16.4.0",
+    "prettier": "^3.6.2",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}