nazar-salary 3.5.6 → 3.5.8

package/index.d.ts

@@ -864,8 +864,8 @@ declare module 'nazar-salary' {
     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;
+    /** A1…C2, shown on the certificate check page; null until set (the page shows no level) */
+    languageLevel: AkcentLanguageLevel | string | null;
     /** lessons with a teacher the student had; 12 until set */
     lessonsDone: number;
     /** lessons in the course; 12 until set */
@@ -878,7 +878,7 @@ declare module 'nazar-salary' {
 
   export type AkcentLanguageLevel = 'A1' | 'A2' | 'B1' | 'B2' | 'C1' | 'C2';
 
-  /** Send only what changes; null puts the default back (B2, 12, 12). */
+  /** Send only what changes; null puts the default back (no level, 12, 12, no teacher). */
   export interface UpdateAkcentCourseData {
     languageLevel?: AkcentLanguageLevel | null;
     /** 0–1000, not more than lessonsTotal */
@@ -892,7 +892,7 @@ declare module 'nazar-salary' {
   export interface UpdateAkcentCourseResponse {
     userId: string;
     courseId: number;
-    languageLevel: AkcentLanguageLevel | string;
+    languageLevel: AkcentLanguageLevel | string | null;
     lessonsDone: number;
     lessonsTotal: number;
     teacher_full_name: string | null;
@@ -923,7 +923,7 @@ declare module 'nazar-salary' {
     course_name: string;
     /** null when no teacher was given */
     teacher_full_name: string | null;
-    languageLevel: AkcentLanguageLevel | string;
+    languageLevel: AkcentLanguageLevel | string | null;
     lessonsDone: number;
     lessonsTotal: number;
     totalGrade: number;
@@ -952,7 +952,8 @@ declare module 'nazar-salary' {
     course_name: string;
     /** optional, up to 201 characters; without it the check page shows the certificate's type and the PDF has no teacher line */
     teacher_full_name?: string | null;
-    languageLevel: AkcentLanguageLevel;
+    /** optional; without it the check page and the PDF show no level */
+    languageLevel?: AkcentLanguageLevel | null;
     /** 0–1000, not more than lessonsTotal */
     lessonsDone: number;
     /** 1–1000 */
@@ -1606,6 +1607,56 @@ declare module 'nazar-salary' {
     students: ManagerFinishedStudentItem[];
   }
 
+  /** GET /admin/students/active — every filter optional, manager_id included */
+  export interface AdminStudentsListParams {
+    manager_id?: number;
+    teacher_id?: number;
+    prepayment?: boolean;
+    is_verified?: boolean;
+    price_id?: number;
+    created_from?: string;
+    created_to?: string;
+    main_course?: string;
+    page?: number;
+    /** Max 30 */
+    limit?: number;
+  }
+
+  export interface AdminStudentListItem extends Omit<StudentListItem, 'manager_name'> {
+    owned_by: number;
+    /** "First Last" of the student's manager */
+    manager_name: string | null;
+  }
+
+  export interface AdminStudentsListResponse {
+    total_students: number;
+    current_page: number;
+    total_pages: number;
+    students: AdminStudentListItem[];
+  }
+
+  /** GET /admin/students/finished */
+  export interface AdminFinishedStudentsParams {
+    manager_id?: number;
+    teacher_id?: number;
+    search?: string;
+    page?: number;
+    /** Max 30 */
+    limit?: number;
+  }
+
+  export interface AdminFinishedStudentItem extends ManagerFinishedStudentItem {
+    owned_by: number;
+    manager_name: string | null;
+  }
+
+  export interface AdminFinishedStudentsResponse {
+    total_students: number;
+    current_page: number;
+    total_pages: number;
+    students: AdminFinishedStudentItem[];
+  }
+
   export interface StudentsListLiteParams {
     page?: number;
   }
@@ -1893,6 +1944,8 @@ declare module 'nazar-salary' {
 
     /** Get finished (inactive course) students of specific manager (Admin only) */
     getManagerFinishedStudents(managerId: number, params?: ManagerFinishedStudentsParams): Promise<ManagerFinishedStudentsResponse>;
+    getAdminActiveStudents(params?: AdminStudentsListParams): Promise<AdminStudentsListResponse>;
+    getAdminFinishedStudents(params?: AdminFinishedStudentsParams): Promise<AdminFinishedStudentsResponse>;
 
     // Dashboard endpoints
     /**

package/index.js

@@ -339,6 +339,24 @@ class SalaryAPI {
     );
   }
 
+  /**
+   * Active students of all managers or one (manager_id), with manager_name (Admin only)
+   * @param {object} [params] - { manager_id?, teacher_id?, prepayment?, is_verified?, price_id?, created_from?, created_to?, main_course?, page?, limit? (max 30) }
+   * @returns {Promise<AdminStudentsListResponse>}
+   */
+  async getAdminActiveStudents(params = {}) {
+    return await this.client.get("/api/v1/admin/students/active", { params });
+  }
+
+  /**
+   * Finished students (completed_lessons = total_lessons) of all managers or one, with manager_name (Admin only)
+   * @param {object} [params] - { manager_id?, teacher_id?, search?, page?, limit? (max 30) }
+   * @returns {Promise<AdminFinishedStudentsResponse>}
+   */
+  async getAdminFinishedStudents(params = {}) {
+    return await this.client.get("/api/v1/admin/students/finished", { params });
+  }
+
   /**
    * Get manager salary for specific month (Admin only)
    * @param {string} month - Month in YYYY-MM format
@@ -784,7 +802,7 @@ class SalaryAPI {
    * Give an Akcent certificate for an offline course (requireAuth: admin or owner manager)
    * Same student, course_name and day again updates the certificate given before.
    * @param {number} studentId - Student ID
-   * @param {object} data - { course_name, teacher_full_name?, languageLevel, lessonsDone, lessonsTotal, given_date?, totalGrade? }
+   * @param {object} data - { course_name, teacher_full_name?, languageLevel?, lessonsDone, lessonsTotal, given_date?, totalGrade? }
    * @returns {Promise<CreateOfflineCertificateResponse>}
    */
   async createStudentOfflineCertificate(studentId, data) {

package/package.json

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