nazar-salary 3.5.0 → 3.5.2

package/index.d.ts

@@ -849,6 +849,40 @@ 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;
+    /** null while the course is not completed */
+    certificate: AkcentCertificate | null;
+  }
+
+  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 {
@@ -1094,15 +1128,21 @@ declare module 'nazar-salary' {
     to?: number;
     /** Filter by manager (admin only; ignored for manager role) */
     manager_id?: number;
+    /** Page number (default 1) */
+    page?: number;
+    /** Items per page (default 20, max 100) */
+    limit?: number;
   }
 
   export interface RefundsListResponse {
+    /** Totals across all refunds matching the filters (not just the current page) */
     summary: {
       count: number;
       total_refund_amount: number;
       total_deduction_amount: number;
     };
     refunds: RefundItem[];
+    pagination: Pagination;
   }
 
   export type TeacherPaymentStatus = 'not_paid' | 'pending' | 'paid';
@@ -1810,6 +1850,7 @@ 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>;
     searchStudents(params: SearchStudentsParams): Promise<SearchStudentsResponse>;
     getStoppedStudents(params?: StoppedStudentsParams): Promise<StoppedStudentsResponse>;
     getMyStoppedStudents(params?: MyStoppedStudentsParams): Promise<MyStoppedStudentsResponse>;

package/index.js

@@ -755,6 +755,16 @@ 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`);
+  }
+
   /**
    * Search students globally (Admin only)
     * By default returns only active records; pass is_active=false for stopped.
@@ -1052,6 +1062,8 @@ class SalaryAPI {
    * @param {number} [params.from] - Start timestamp (ms)
    * @param {number} [params.to] - End timestamp (ms)
    * @param {number} [params.manager_id] - Filter by manager ID
+   * @param {number} [params.page=1] - Page number
+   * @param {number} [params.limit=20] - Items per page (max 100)
    * @returns {Promise<RefundsListResponse>}
    */
   async getRefunds(params = {}) {

package/package.json

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