webuntis-client 1.0.0

package/README.md

@@ -0,0 +1,5 @@
+# Web Untis Client
+
+A Web Untis API Client to interact with [Web Untis](https://webuntis.com).
+
+> 🚧 WIP 🚧

package/dist/Credentials.d.ts

@@ -0,0 +1,16 @@
+export declare class Credentials {
+    private readonly _identity;
+    private readonly _school;
+    private readonly _username;
+    private readonly _password;
+    private readonly _url;
+    private readonly _schoolBase64;
+    constructor(_identity: string, _school: string, _username: string, _password: string);
+    get identity(): string;
+    get school(): string;
+    get username(): string;
+    get password(): string;
+    get url(): string;
+    get schoolBase64(): string;
+}
+//# sourceMappingURL=Credentials.d.ts.map

package/dist/Credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Credentials.d.ts","sourceRoot":"","sources":["../src/Credentials.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IAKhB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;gBAGlB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM;IAMtC,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;CACJ"}

package/dist/Credentials.js

@@ -0,0 +1,34 @@
+export class Credentials {
+    _identity;
+    _school;
+    _username;
+    _password;
+    _url;
+    _schoolBase64;
+    constructor(_identity, _school, _username, _password) {
+        this._identity = _identity;
+        this._school = _school;
+        this._username = _username;
+        this._password = _password;
+        this._url = `https://${_school}.webuntis.com`;
+        this._schoolBase64 = "_" + Buffer.from(_school).toString("base64");
+    }
+    get identity() {
+        return this._identity;
+    }
+    get school() {
+        return this._school;
+    }
+    get username() {
+        return this._username;
+    }
+    get password() {
+        return this._password;
+    }
+    get url() {
+        return this._url;
+    }
+    get schoolBase64() {
+        return this._schoolBase64;
+    }
+}

package/dist/WebUntis.d.ts

@@ -0,0 +1,108 @@
+import { Credentials } from "./Credentials";
+import { AppData, CurrentSchoolYear, Holiday, OneDriveData, Tenant, User } from './types/app-data';
+import { Profile } from "./types/profile";
+import { SessionInfo } from "./types/session";
+import { TimetableResponse } from "./types/timetable";
+export declare class WebUntisClient {
+    private readonly _httpClient;
+    private readonly _apiClient;
+    private readonly _rpcClient;
+    private readonly _authManager;
+    private readonly _tokenManager;
+    private readonly _appDataService;
+    private readonly _profileService;
+    private readonly _timetableService;
+    constructor(credentials: Credentials);
+    /**
+     * Login to WebUntis
+     */
+    login(): Promise<SessionInfo>;
+    /**
+     * Logout and end session
+     */
+    logout(): Promise<void>;
+    /**
+     * Check if currently authenticated
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get current session info
+     */
+    getSession(): SessionInfo | null;
+    /**
+     * Get app data
+     */
+    getAppData(): Promise<AppData>;
+    /**
+     * Get current school year from cache
+     */
+    getCurrentSchoolYear(): CurrentSchoolYear;
+    /**
+     * Get current school year id from cache
+     */
+    getCurrentSchoolYearId(): string;
+    /**
+     * Get departments from cache
+     */
+    getDepartments(): unknown[];
+    /**
+     * Check if playground mode is enabled
+     */
+    isPlayground(): boolean;
+    /**
+     * Get OneDrive data from cache
+     */
+    getOneDriveData(): OneDriveData;
+    /**
+     * Get tenant information from cache
+     */
+    getTenant(): Tenant;
+    /**
+     * Check if UI 2020 is enabled
+     */
+    isUi2020(): boolean;
+    /**
+     * Get user information from cache
+     */
+    getUser(): User;
+    /**
+     * Get user permissions from cache
+     */
+    getPermissions(): string[];
+    /**
+     * Get settings from cache
+     */
+    getSettings(): string[];
+    /**
+     * Get polling jobs from cache
+     */
+    getPollingJobs(): unknown[];
+    /**
+     * Check if support access is open
+     */
+    isSupportAccessOpen(): boolean;
+    /**
+     * Get license expiration date from cache
+     */
+    getLicenceExpiresAt(): string;
+    /**
+     * Get holidays from cache
+     */
+    getHolidays(): Holiday[];
+    /**
+     * Get current user's profile
+     */
+    getProfile(): Promise<Profile>;
+    /**
+     * Get own timetable for date range
+     *
+     * @param start - Start date
+     * @param end - End date
+     */
+    getOwnTimetable(start: Date, end: Date): Promise<TimetableResponse>;
+    /**
+     * Ensure user is authenticated
+     */
+    private _ensureAuthenticated;
+}
+//# sourceMappingURL=WebUntis.d.ts.map

package/dist/WebUntis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebUntis.d.ts","sourceRoot":"","sources":["../src/WebUntis.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAO5C,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACnG,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;IAG3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAG7C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;gBAEzC,WAAW,EAAE,WAAW;IAgCpC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IASnC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;OAEG;IACH,UAAU,IAAI,WAAW,GAAG,IAAI;IAQhC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAKpC;;OAEG;IACH,oBAAoB,IAAI,iBAAiB;IAIzC;;OAEG;IACH,sBAAsB,IAAI,MAAM;IAIhC;;OAEG;IACH,cAAc,IAAI,OAAO,EAAE;IAI3B;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAI1B;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,cAAc,IAAI,OAAO,EAAE;IAI3B;;OAEG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,WAAW,IAAI,OAAO,EAAE;IAQxB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IASpC;;;;;OAKG;IACG,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC;IASzE;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAS/B"}

package/dist/WebUntis.js

@@ -0,0 +1,192 @@
+import { ApiClient } from "./clients/Api";
+import { HttpClient } from "./clients/Http";
+import { JsonRpcClient } from "./clients/JsonRpc";
+import { ValidationError } from "./errors/Validation";
+import { AuthenticationManager } from "./managers/Authentication";
+import { TokenManager } from "./managers/Token";
+import { AppDataService } from "./services/AppData";
+import { ProfileService } from "./services/Profile";
+import { TimetableService } from "./services/Timetable";
+export class WebUntisClient {
+    // Clients
+    _httpClient;
+    _apiClient;
+    _rpcClient;
+    // Managers
+    _authManager;
+    _tokenManager;
+    // Services
+    _appDataService;
+    _profileService;
+    _timetableService;
+    constructor(credentials) {
+        const { identity, url } = credentials;
+        // Clients
+        this._httpClient = new HttpClient(url);
+        this._rpcClient = new JsonRpcClient(identity, url);
+        // Managers
+        this._authManager = new AuthenticationManager(credentials, this._rpcClient);
+        this._tokenManager = new TokenManager(this._httpClient, () => this._authManager.getCookies());
+        // Clients
+        this._apiClient = new ApiClient(this._httpClient, () => this._authManager.getCookies(), () => this._tokenManager.getToken(), () => this._tokenManager.getTenantId(), () => this.getCurrentSchoolYearId());
+        // Services
+        this._appDataService = new AppDataService(this._apiClient);
+        this._profileService = new ProfileService(this._apiClient);
+        this._timetableService = new TimetableService(this._apiClient, this._authManager);
+    }
+    //#region Authentication
+    /**
+     * Login to WebUntis
+     */
+    async login() {
+        const session = await this._authManager.login();
+        await this._tokenManager.getToken();
+        await this._appDataService.getAppData();
+        return session;
+    }
+    /**
+     * Logout and end session
+     */
+    async logout() {
+        await this._authManager.logout();
+        this._tokenManager.clearToken();
+        this._appDataService.clearCache();
+    }
+    /**
+     * Check if currently authenticated
+     */
+    isAuthenticated() {
+        return this._authManager.isAuthenticated();
+    }
+    /**
+     * Get current session info
+     */
+    getSession() {
+        return this._authManager.getSession();
+    }
+    //#endregion
+    //#region App Data
+    /**
+     * Get app data
+     */
+    async getAppData() {
+        this._ensureAuthenticated();
+        return await this._appDataService.getAppData();
+    }
+    /**
+     * Get current school year from cache
+     */
+    getCurrentSchoolYear() {
+        return this._appDataService.getCurrentSchoolYear();
+    }
+    /**
+     * Get current school year id from cache
+     */
+    getCurrentSchoolYearId() {
+        return this._appDataService.getCurrentSchoolYearId();
+    }
+    /**
+     * Get departments from cache
+     */
+    getDepartments() {
+        return this._appDataService.getDepartments();
+    }
+    /**
+     * Check if playground mode is enabled
+     */
+    isPlayground() {
+        return this._appDataService.isPlayground();
+    }
+    /**
+     * Get OneDrive data from cache
+     */
+    getOneDriveData() {
+        return this._appDataService.getOneDriveData();
+    }
+    /**
+     * Get tenant information from cache
+     */
+    getTenant() {
+        return this._appDataService.getTenant();
+    }
+    /**
+     * Check if UI 2020 is enabled
+     */
+    isUi2020() {
+        return this._appDataService.isUi2020();
+    }
+    /**
+     * Get user information from cache
+     */
+    getUser() {
+        return this._appDataService.getUser();
+    }
+    /**
+     * Get user permissions from cache
+     */
+    getPermissions() {
+        return this._appDataService.getPermissions();
+    }
+    /**
+     * Get settings from cache
+     */
+    getSettings() {
+        return this._appDataService.getSettings();
+    }
+    /**
+     * Get polling jobs from cache
+     */
+    getPollingJobs() {
+        return this._appDataService.getPollingJobs();
+    }
+    /**
+     * Check if support access is open
+     */
+    isSupportAccessOpen() {
+        return this._appDataService.isSupportAccessOpen();
+    }
+    /**
+     * Get license expiration date from cache
+     */
+    getLicenceExpiresAt() {
+        return this._appDataService.getLicenceExpiresAt();
+    }
+    /**
+     * Get holidays from cache
+     */
+    getHolidays() {
+        return this._appDataService.getHolidays();
+    }
+    //#endregion
+    //#region User's Profile
+    /**
+     * Get current user's profile
+     */
+    async getProfile() {
+        this._ensureAuthenticated();
+        return await this._profileService.getProfile();
+    }
+    //#endregion
+    //#region Own Timetable
+    /**
+     * Get own timetable for date range
+     *
+     * @param start - Start date
+     * @param end - End date
+     */
+    async getOwnTimetable(start, end) {
+        this._ensureAuthenticated();
+        return await this._timetableService.getOwnTimetable(start, end);
+    }
+    //#endregion
+    //#region Helpers
+    /**
+     * Ensure user is authenticated
+     */
+    _ensureAuthenticated() {
+        const isNotAuthenticated = !this._authManager.isAuthenticated();
+        if (isNotAuthenticated) {
+            throw new ValidationError('Not authenticated. Please call login() first.');
+        }
+    }
+}

package/dist/clients/Api.d.ts

@@ -0,0 +1,28 @@
+import { AppData } from '../types/app-data';
+import { ProfileResponse } from '../types/profile';
+import { TimetableResponse } from '../types/timetable';
+import { HttpClient } from './Http';
+/**
+ * Client for WebUntis REST API endpoints
+ */
+export declare class ApiClient {
+    private readonly _httpClient;
+    private readonly _getCookies;
+    private readonly _getToken;
+    private readonly _getTenantId;
+    private readonly _getSchoolYearId;
+    constructor(_httpClient: HttpClient, _getCookies: () => string, _getToken: () => Promise<string>, _getTenantId: () => string | null, _getSchoolYearId: () => string);
+    /**
+     * Fetch app data
+     */
+    fetchAppData(): Promise<AppData>;
+    /**
+     * Fetch user profile data
+     */
+    fetchProfile(): Promise<ProfileResponse>;
+    /**
+     * Fetch timetable entries
+     */
+    fetchOwnTimetable(params: URLSearchParams): Promise<TimetableResponse>;
+}
+//# sourceMappingURL=Api.d.ts.map

package/dist/clients/Api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Api.d.ts","sourceRoot":"","sources":["../../src/clients/Api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;GAEG;AACH,qBAAa,SAAS;IAEd,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAJhB,WAAW,EAAE,UAAU,EACvB,WAAW,EAAE,MAAM,MAAM,EACzB,SAAS,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAChC,YAAY,EAAE,MAAM,MAAM,GAAG,IAAI,EACjC,gBAAgB,EAAE,MAAM,MAAM;IAGnD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAmBtC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IAS9C;;OAEG;IACG,iBAAiB,CACnB,MAAM,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,CAAC;CAoBhC"}

package/dist/clients/Api.js

@@ -0,0 +1,58 @@
+/**
+ * Client for WebUntis REST API endpoints
+ */
+export class ApiClient {
+    _httpClient;
+    _getCookies;
+    _getToken;
+    _getTenantId;
+    _getSchoolYearId;
+    constructor(_httpClient, _getCookies, _getToken, _getTenantId, _getSchoolYearId) {
+        this._httpClient = _httpClient;
+        this._getCookies = _getCookies;
+        this._getToken = _getToken;
+        this._getTenantId = _getTenantId;
+        this._getSchoolYearId = _getSchoolYearId;
+    }
+    /**
+     * Fetch app data
+     */
+    async fetchAppData() {
+        const token = await this._getToken();
+        const tenantId = this._getTenantId();
+        const cookies = this._getCookies();
+        if (!tenantId) {
+            throw new Error('Tenant ID not available');
+        }
+        return this._httpClient.get('/WebUntis/api/rest/view/v1/app/data', {
+            Authorization: `Bearer ${token}`,
+            'tenant-id': tenantId,
+            Cookie: cookies,
+        });
+    }
+    /**
+     * Fetch user profile data
+     */
+    async fetchProfile() {
+        const cookies = this._getCookies();
+        return this._httpClient.get('/WebUntis/api/profile/general', { Cookie: cookies });
+    }
+    /**
+     * Fetch timetable entries
+     */
+    async fetchOwnTimetable(params) {
+        const token = await this._getToken();
+        const tenantId = this._getTenantId();
+        const cookies = this._getCookies();
+        const schoolYearId = this._getSchoolYearId();
+        if (!tenantId) {
+            throw new Error('Tenant ID not available');
+        }
+        return await this._httpClient.get(`/WebUntis/api/rest/view/v1/timetable/entries?${params}`, {
+            Authorization: `Bearer ${token}`,
+            'tenant-id': tenantId,
+            'x-webuntis-api-school-year-id': schoolYearId,
+            Cookie: cookies,
+        });
+    }
+}

package/dist/clients/Http.d.ts

@@ -0,0 +1,22 @@
+export declare class HttpClient {
+    private readonly _url;
+    private readonly _defaultHeaders;
+    constructor(_url: string);
+    /**
+     * Make a GET request
+     */
+    get<T>(endpoint: string, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Make a POST request
+     */
+    post<T>(endpoint: string, body?: Record<string, unknown>, headers?: Record<string, string>): Promise<T>;
+    /**
+     * Make a GET request that returns text
+     */
+    getText(endpoint: string, headers?: Record<string, string>): Promise<string>;
+    /**
+     * Handle HTTP response and errors
+     */
+    private _handleResponse;
+}
+//# sourceMappingURL=Http.d.ts.map

package/dist/clients/Http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Http.d.ts","sourceRoot":"","sources":["../../src/clients/Http.ts"],"names":[],"mappings":"AAGA,qBAAa,UAAU;IAQP,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAK9B;gBAE2B,IAAI,EAAE,MAAM;IAEzC;;OAEG;IACG,GAAG,CAAC,CAAC,EACP,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC;IAeb;;OAEG;IACG,IAAI,CAAC,CAAC,EACR,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,CAAC,CAAC;IAkBb;;OAEG;IACG,OAAO,CACT,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC;IAsBlB;;OAEG;YACW,eAAe;CAgBhC"}

package/dist/clients/Http.js

@@ -0,0 +1,71 @@
+import { NetworkError } from "../errors/Network";
+export class HttpClient {
+    _url;
+    _defaultHeaders = {
+        'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/61.0.3163.79 Safari/537.36',
+        'Cache-Control': 'no-cache',
+        'X-Requested-With': 'XMLHttpRequest',
+        Pragma: 'no-cache',
+    };
+    constructor(_url) {
+        this._url = _url;
+    }
+    /**
+     * Make a GET request
+     */
+    async get(endpoint, headers) {
+        const response = await fetch(`${this._url}${endpoint}`, {
+            method: 'GET',
+            headers: {
+                ...this._defaultHeaders,
+                ...headers,
+            },
+        });
+        return this._handleResponse(response);
+    }
+    /**
+     * Make a POST request
+     */
+    async post(endpoint, body, headers) {
+        const response = await fetch(`${this._url}${endpoint}`, {
+            method: 'POST',
+            headers: {
+                ...this._defaultHeaders,
+                'Content-Type': 'application/json',
+                ...headers,
+            },
+            body: body ? JSON.stringify(body) : undefined,
+            redirect: 'manual',
+        });
+        return this._handleResponse(response);
+    }
+    /**
+     * Make a GET request that returns text
+     */
+    async getText(endpoint, headers) {
+        const response = await fetch(`${this._url}${endpoint}`, {
+            method: 'GET',
+            headers: {
+                ...this._defaultHeaders,
+                ...headers,
+            },
+        });
+        if (!response.ok) {
+            throw new NetworkError(`HTTP ${response.status}: ${response.statusText}`, response.status);
+        }
+        return response.text();
+    }
+    /**
+     * Handle HTTP response and errors
+     */
+    async _handleResponse(response) {
+        if (response.status < 200 || response.status >= 303) {
+            throw new NetworkError(`HTTP ${response.status}: ${response.statusText}`, response.status);
+        }
+        const contentType = response.headers.get('content-type');
+        if (contentType?.includes('application/json')) {
+            return response.json();
+        }
+        return response.text();
+    }
+}

package/dist/clients/JsonRpc.d.ts

@@ -0,0 +1,23 @@
+import { SessionInfo } from '../types/session';
+/**
+ * JSON-RPC client for WebUntis API
+ */
+export declare class JsonRpcClient {
+    private readonly _identity;
+    private readonly _httpClient;
+    private readonly _endpoint;
+    constructor(_identity: string, url: string);
+    /**
+     * Authenticate user and get session
+     */
+    authenticate(username: string, password: string, client: string): Promise<SessionInfo>;
+    /**
+     * Logout and end session
+     */
+    logout(cookies: string): Promise<void>;
+    /**
+     * Make a JSON-RPC call
+     */
+    private _call;
+}
+//# sourceMappingURL=JsonRpc.d.ts.map

package/dist/clients/JsonRpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonRpc.d.ts","sourceRoot":"","sources":["../../src/clients/JsonRpc.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C;;GAEG;AACH,qBAAa,aAAa;IAKlB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAJ9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;gBAG/B,SAAS,EAAE,MAAM,EAClC,GAAG,EAAE,MAAM;IAKf;;OAEG;IACG,YAAY,CACd,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC;IAyBvB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;YACW,KAAK;CAiCtB"}

package/dist/clients/JsonRpc.js

@@ -0,0 +1,62 @@
+import { AuthenticationError } from '../errors/Authentication';
+import { HttpClient } from './Http';
+/**
+ * JSON-RPC client for WebUntis API
+ */
+export class JsonRpcClient {
+    _identity;
+    _httpClient;
+    _endpoint = '/WebUntis/jsonrpc.do';
+    constructor(_identity, url) {
+        this._identity = _identity;
+        this._httpClient = new HttpClient(url);
+    }
+    /**
+     * Authenticate user and get session
+     */
+    async authenticate(username, password, client) {
+        try {
+            const result = await this._call('authenticate', {
+                user: username,
+                password: password,
+                client: client,
+            });
+            if (!result.sessionId) {
+                throw new AuthenticationError('Authentication failed: No session ID returned');
+            }
+            return result;
+        }
+        catch (error) {
+            if (error instanceof AuthenticationError) {
+                throw error;
+            }
+            throw new AuthenticationError(`Authentication failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Logout and end session
+     */
+    async logout(cookies) {
+        await this._call('logout', {}, cookies);
+    }
+    /**
+     * Make a JSON-RPC call
+     */
+    async _call(method, params, cookies) {
+        const headers = {};
+        if (cookies) {
+            headers.Cookie = cookies;
+        }
+        const body = {
+            id: this._identity,
+            jsonrpc: '2.0',
+            method,
+            params,
+        };
+        const response = await this._httpClient.post(this._endpoint, body, headers);
+        if (response.error) {
+            throw new AuthenticationError(`${response.error.message} (${response.error.code})`, response.error.code.toString());
+        }
+        return response.result;
+    }
+}

package/dist/errors/Authentication.d.ts

@@ -0,0 +1,5 @@
+import { WebUntisError } from "./WebUntis";
+export declare class AuthenticationError extends WebUntisError {
+    constructor(message: string, code?: string);
+}
+//# sourceMappingURL=Authentication.d.ts.map

package/dist/errors/Authentication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Authentication.d.ts","sourceRoot":"","sources":["../../src/errors/Authentication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,qBAAa,mBAAoB,SAAQ,aAAa;gBACtC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAK7C"}

package/dist/errors/Authentication.js

@@ -0,0 +1,8 @@
+import { WebUntisError } from "./WebUntis";
+export class AuthenticationError extends WebUntisError {
+    constructor(message, code) {
+        super(message, code);
+        this.name = 'AuthenticationError';
+        Object.setPrototypeOf(this, AuthenticationError.prototype);
+    }
+}

package/dist/errors/Network.d.ts

@@ -0,0 +1,6 @@
+import { WebUntisError } from "./WebUntis";
+export declare class NetworkError extends WebUntisError {
+    readonly statusCode?: number | undefined;
+    constructor(message: string, statusCode?: number | undefined, code?: string);
+}
+//# sourceMappingURL=Network.d.ts.map

package/dist/errors/Network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Network.d.ts","sourceRoot":"","sources":["../../src/errors/Network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,qBAAa,YAAa,SAAQ,aAAa;aAGvB,UAAU,CAAC,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnC,IAAI,CAAC,EAAE,MAAM;CAMpB"}