chuvsu-js 2.6.2 → 2.7.0

package/dist/tt/client.d.ts

@@ -20,6 +20,7 @@ export declare class TtClient {
     private isSessionExpired;
     private relogin;
     private authGet;
+    private authGetBuffer;
     private authPost;
     private fetchSchedule;
     /**
@@ -58,4 +59,16 @@ export declare class TtClient {
         period: Period;
     }): Promise<Schedule>;
     getTeacherInfo(teacherId: number): Promise<TeacherInfo | null>;
+    /**
+     * Get the teacher's photo as a Buffer.
+     * Returns null if the teacher has no photo.
+     * Uses cached teacher info when available to avoid extra requests.
+     */
+    getTeacherPhoto(teacherId: number): Promise<Buffer | null>;
+    /**
+     * Get the teacher's photo without parsing the schedule page.
+     * Uses the known URL pattern directly — no extra page fetch needed.
+     * Returns null if the teacher has no photo.
+     */
+    getTeacherPhotoLazy(teacherId: number): Promise<Buffer | null>;
 }

package/dist/tt/client.js

@@ -88,6 +88,9 @@ export class TtClient {
         }
         return res;
     }
+    async authGetBuffer(url) {
+        return this.http.getBuffer(url);
+    }
     async authPost(url, data) {
         const res = await this.http.post(url, data);
         if (this.loginMode && this.isSessionExpired(res.body)) {
@@ -192,6 +195,12 @@ export class TtClient {
         const { body } = await this.authPost(url, { htype: String(period) });
         const days = parseTeacherFullSchedule(body, this.educationType);
         this.cache?.set("schedule", cacheKey, days);
+        // Cache teacher info from the same page to avoid extra requests
+        if (!this.cache?.get("teacherInfo", String(teacherId))) {
+            const info = parseTeacherInfo(body);
+            if (info)
+                this.cache?.set("teacherInfo", String(teacherId), info);
+        }
         return days;
     }
     async getTeacherSchedule(teacherId) {
@@ -212,8 +221,61 @@ export class TtClient {
         return new Schedule(opts.teacherId, schedules, opts.period, this.educationType, undefined, undefined, true);
     }
     async getTeacherInfo(teacherId) {
+        const cached = this.cache?.get("teacherInfo", String(teacherId));
+        if (cached)
+            return cached;
         const url = `${BASE}/index/techtt/tech/${teacherId}`;
         const { body } = await this.authGet(url);
-        return parseTeacherInfo(body);
+        const info = parseTeacherInfo(body);
+        if (info)
+            this.cache?.set("teacherInfo", String(teacherId), info);
+        return info;
+    }
+    /**
+     * Get the teacher's photo as a Buffer.
+     * Returns null if the teacher has no photo.
+     * Uses cached teacher info when available to avoid extra requests.
+     */
+    async getTeacherPhoto(teacherId) {
+        const photoCacheKey = String(teacherId);
+        const cachedPhoto = this.cache?.get("teacherPhotos", photoCacheKey);
+        if (cachedPhoto !== null && cachedPhoto !== undefined) {
+            const entry = cachedPhoto;
+            return entry.data ? Buffer.from(entry.data, "base64") : null;
+        }
+        // Get teacher info (may already be cached from schedule fetch)
+        const info = await this.getTeacherInfo(teacherId);
+        if (!info?.photoUrl) {
+            this.cache?.set("teacherPhotos", photoCacheKey, { data: null });
+            return null;
+        }
+        const photoBuffer = await this.authGetBuffer(`${BASE}${info.photoUrl}`);
+        this.cache?.set("teacherPhotos", photoCacheKey, {
+            data: photoBuffer.toString("base64"),
+        });
+        return photoBuffer;
+    }
+    /**
+     * Get the teacher's photo without parsing the schedule page.
+     * Uses the known URL pattern directly — no extra page fetch needed.
+     * Returns null if the teacher has no photo.
+     */
+    async getTeacherPhotoLazy(teacherId) {
+        const photoCacheKey = String(teacherId);
+        const cachedPhoto = this.cache?.get("teacherPhotos", photoCacheKey);
+        if (cachedPhoto !== null && cachedPhoto !== undefined) {
+            const entry = cachedPhoto;
+            return entry.data ? Buffer.from(entry.data, "base64") : null;
+        }
+        const url = `${BASE}/index/photo/tech/${teacherId}/id/${teacherId}`;
+        const photoBuffer = await this.authGetBuffer(url);
+        if (photoBuffer.length === 0) {
+            this.cache?.set("teacherPhotos", photoCacheKey, { data: null });
+            return null;
+        }
+        this.cache?.set("teacherPhotos", photoCacheKey, {
+            data: photoBuffer.toString("base64"),
+        });
+        return photoBuffer;
     }
 }

package/dist/tt/parse.js

@@ -497,5 +497,7 @@ export function parseTeacherInfo(html) {
     const degree = degreeEl ? text(degreeEl).trim() : undefined;
     const deptEl = doc.querySelector(".htext");
     const department = deptEl ? text(deptEl).trim() : undefined;
-    return { name, degree: degree || undefined, department: department || undefined };
+    const photoImg = doc.querySelector("#photosrc");
+    const photoUrl = photoImg?.getAttribute("src") || undefined;
+    return { name, degree: degree || undefined, department: department || undefined, photoUrl };
 }

package/dist/tt/types.d.ts

@@ -105,6 +105,8 @@ export interface TeacherInfo {
     name: string;
     degree?: string;
     department?: string;
+    /** Relative photo URL (e.g. "/index/photo/tech/653/id/653"), or undefined if no photo. */
+    photoUrl?: string;
 }
 export interface SemesterWeek {
     week: number;
@@ -116,6 +118,8 @@ export interface CacheConfig {
     faculties?: number;
     groups?: number;
     teachers?: number;
+    teacherInfo?: number;
+    teacherPhotos?: number;
 }
 export interface TtClientOptions {
     educationType?: EducationType;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chuvsu-js",
-  "version": "2.6.2",
+  "version": "2.7.0",
   "description": "Node.js library for ChuvSU student portal (lk.chuvsu.ru) and schedule (tt.chuvsu.ru)",
   "type": "module",
   "main": "dist/index.js",