nazar-salary 3.5.1 → 3.5.3

package/index.d.ts

@@ -849,6 +849,65 @@ declare module 'nazar-salary' {
     history: ProgressHistoryEntry[];
   }
 
+  export interface AkcentCertificate {
+    number: string | null;
+    /** epoch ms */
+    issuedAt: number;
+    verifyUrl: string | null;
+    /** public PDF link, supports ?lang=ru|kk|en */
+    downloadUrl: string | null;
+  }
+
+  export interface AkcentCourse {
+    courseId: number;
+    title: string;
+    cover_image_url: string | null;
+    /** percent 0–100, null until graded */
+    totalGrade: number | null;
+    /** A1…C2, shown on the certificate check page; 'B2' until set */
+    languageLevel: AkcentLanguageLevel | string;
+    /** lessons with a teacher the student had; 12 until set */
+    lessonsDone: number;
+    /** lessons in the course; 12 until set */
+    lessonsTotal: number;
+    /** null while the course is not completed */
+    certificate: AkcentCertificate | null;
+  }
+
+  export type AkcentLanguageLevel = 'A1' | 'A2' | 'B1' | 'B2' | 'C1' | 'C2';
+
+  /** Send only what changes; null puts the default back (B2, 12, 12). */
+  export interface UpdateAkcentCourseData {
+    languageLevel?: AkcentLanguageLevel | null;
+    /** 0–1000, not more than lessonsTotal */
+    lessonsDone?: number | null;
+    /** 1–1000 */
+    lessonsTotal?: number | null;
+  }
+
+  export interface UpdateAkcentCourseResponse {
+    userId: string;
+    courseId: number;
+    languageLevel: AkcentLanguageLevel | string;
+    lessonsDone: number;
+    lessonsTotal: number;
+  }
+
+  export interface AkcentStudent {
+    userId: string;
+    firstName: string | null;
+    lastName: string | null;
+    logo_url: string | null;
+    phone: string | null;
+    courses: AkcentCourse[];
+  }
+
+  export interface StudentCertificatesResponse {
+    /** false — no Akcent student with this phone */
+    found: boolean;
+    student: AkcentStudent | null;
+  }
+
   export type StopReason = 'student_quit' | 'moved_away' | 'health_issues' | 'financial' | 'other' | 'refund';
 
   export interface StopStudentData {
@@ -1816,6 +1875,8 @@ declare module 'nazar-salary' {
     resumeStudent(studentId: number, data?: ResumeStudentData): Promise<ResumeStudentResponse>;
     resumeMyStudent(studentId: number, data?: ResumeStudentData): Promise<ResumeStudentResponse>;
     getStudent(studentId: number): Promise<StudentDetail>;
+    getStudentCertificates(studentId: number): Promise<StudentCertificatesResponse>;
+    updateStudentCertificateCourse(studentId: number, courseId: number, data: UpdateAkcentCourseData): Promise<UpdateAkcentCourseResponse>;
     searchStudents(params: SearchStudentsParams): Promise<SearchStudentsResponse>;
     getStoppedStudents(params?: StoppedStudentsParams): Promise<StoppedStudentsResponse>;
     getMyStoppedStudents(params?: MyStoppedStudentsParams): Promise<MyStoppedStudentsResponse>;

package/index.js

@@ -755,6 +755,31 @@ class SalaryAPI {
     return await this.client.get(`/api/v1/student/${studentId}`);
   }
 
+  /**
+   * Get student's Akcent Online courses and certificates (requireAuth: admin or owner manager)
+   * The backend finds the student in Akcent by phone.
+   * @param {number} studentId - Student ID
+   * @returns {Promise<StudentCertificatesResponse>}
+   */
+  async getStudentCertificates(studentId) {
+    return await this.client.get(`/api/v1/student/${studentId}/certificates`);
+  }
+
+  /**
+   * Set language level and lessons held for one Akcent course (requireAuth: admin or owner manager)
+   * Shown on the certificate check page (verifyUrl). Send only what changes; null = default.
+   * @param {number} studentId - Student ID
+   * @param {number} courseId - Akcent course ID
+   * @param {object} data - { languageLevel?, lessonsDone?, lessonsTotal? }
+   * @returns {Promise<UpdateAkcentCourseResponse>}
+   */
+  async updateStudentCertificateCourse(studentId, courseId, data) {
+    return await this.client.put(
+      `/api/v1/student/${studentId}/certificates/courses/${courseId}`,
+      data,
+    );
+  }
+
   /**
    * Search students globally (Admin only)
     * By default returns only active records; pass is_active=false for stopped.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nazar-salary",
-  "version": "3.5.1",
+  "version": "3.5.3",
   "description": "Frontend library for Nazar Salary API",
   "main": "index.js",
   "types": "index.d.ts",