nazar-salary 2.2.0 → 2.3.0

package/index.d.ts

@@ -472,6 +472,85 @@ declare module 'nazar-salary' {
     transfer_date: number;
   }
 
+  export interface LessonGroup {
+    lesson_group_id: number;
+    lesson_group_name: string;
+    students_in_group: number;
+    group_capacity: number;
+  }
+
+  export interface LessonGroupsResponse {
+    available_groups: LessonGroup[];
+  }
+
+  export interface StudentCourse {
+    price_id: number;
+    teacher_id: number;
+    enrollment_months: number;
+    total_lessons: number;
+    main_course: string;
+    group_type: GroupType;
+    lessons_per_month: number;
+    rate_per_lesson: number;
+    lesson_group_id: number | null;
+  }
+
+  export interface CreateStudentResponse {
+    id: number;
+    first_name: string;
+    last_name: string;
+    phone: string;
+    age: number;
+    created_at: number;
+    purchase_amount: number;
+    operation_number: string;
+    is_verified: boolean;
+    verified_at: number | null;
+    prepayment: boolean;
+    completed_lessons: number;
+    owned_by: number;
+    group_name: string;
+    bonus_languages: string[] | null;
+    course: StudentCourse;
+  }
+
+  export interface UpdateStudentResponse {
+    student: {
+      id: number;
+      first_name: string;
+      last_name: string;
+      phone: string;
+      age: number;
+      operation_numbers: string[];
+      purchase_amounts: number[];
+      prepayment: boolean;
+      group_name: string;
+      main_course: string;
+      bonus_languages: string[] | null;
+      group_type: GroupType;
+      lessons_per_month: number;
+      duration_minutes: number;
+      rate_per_lesson: number;
+      updated_at: number;
+    };
+    current_course: {
+      price_id: number;
+      teacher_id: number;
+      enrollment_months: number;
+      total_lessons: number;
+      completed_lessons: number;
+    };
+    payments: {
+      id: number;
+      operation_number: string;
+      purchase_amount: number;
+      is_verified: boolean;
+      verified_at: number | null;
+      created_at: number;
+    }[];
+    total_purchase_amount: number;
+  }
+
   export interface CreateStudentData {
     first_name: string;
     last_name: string;
@@ -486,6 +565,7 @@ declare module 'nazar-salary' {
     main_course: string;
     prepayment: boolean;
     bonus_languages?: string[];
+    lesson_group_id?: number;
   }
 
   export interface UpdateStudentData {
@@ -726,6 +806,7 @@ declare module 'nazar-salary' {
     addManualPayment(data: ManualPaymentData): Promise<ManualPaymentResponse>;
     getOrphanPayments(params?: { page?: number; limit?: number }): Promise<OrphanPaymentsResponse>;
     getBanksConfig(): Promise<BanksConfigResponse>;
+    getManagerStudentsAdmin(managerId: number, params?: StudentsListParams): Promise<StudentsListResponse>;
 
     // Teacher endpoints
     getTeacherLanguages(): Promise<TeacherLanguagesResponse>;
@@ -744,8 +825,9 @@ declare module 'nazar-salary' {
     getPricesList(): Promise<PricesResponse>;
 
     // Student endpoints
-    createStudent(data: CreateStudentData): Promise<Student>;
-    updateStudent(studentId: number, data: UpdateStudentData): Promise<UpdatedStudent>;
+    createStudent(data: CreateStudentData): Promise<CreateStudentResponse>;
+    getLessonGroups(): Promise<LessonGroupsResponse>;
+    updateStudent(studentId: number, data: UpdateStudentData): Promise<UpdateStudentResponse>;
     transferStudent(studentId: number, data: TransferStudentData): Promise<TransferResponse>;
     changeStudentManager(studentId: number, data: ChangeStudentManagerData): Promise<ChangeStudentManagerResponse>;
     getStudent(studentId: number): Promise<StudentDetail>;

package/index.js

@@ -257,6 +257,26 @@ class SalaryAPI {
     return await this.client.get("/api/v1/admin/receipts/banks");
   }
 
+  /**
+   * Get students of specific manager (Admin only)
+   * @param {number} managerId - Manager ID
+   * @param {object} [params] - Filter parameters
+   * @param {boolean} [params.prepayment] - Filter by prepayment status
+   * @param {boolean} [params.is_verified] - Filter by verification status
+   * @param {number} [params.teacher_id] - Filter by teacher ID
+   * @param {number} [params.price_id] - Filter by price ID
+   * @param {boolean} [params.is_deleted] - Filter by deletion status
+   * @param {string} [params.created_from] - Filter by created date from (ISO 8601)
+   * @param {string} [params.created_to] - Filter by created date to (ISO 8601)
+   * @param {string} [params.main_course] - Filter by main course
+   * @param {number} [params.page=1] - Page number
+   * @param {number} [params.limit=30] - Items per page (max 30)
+   * @returns {Promise<{manager: object, total_students: number, current_page: number, total_pages: number, students: array}>}
+   */
+  async getManagerStudentsAdmin(managerId, params = {}) {
+    return await this.client.get(`/api/v1/admin/managers/${managerId}/students`, { params });
+  }
+
   // ===== TEACHER ENDPOINTS =====
 
   /**
@@ -419,12 +439,21 @@ class SalaryAPI {
    * @param {string} data.main_course - Main course
    * @param {boolean} data.prepayment - Prepayment flag
    * @param {string[]} [data.bonus_languages] - Bonus languages array
+   * @param {number} [data.lesson_group_id] - Lesson group ID for duet/trio (optional)
    * @returns {Promise<object>}
    */
   async createStudent(data) {
     return await this.client.post("/api/v1/student/new", data);
   }
 
+  /**
+   * Get available lesson groups for duet/trio (requireAuth)
+   * @returns {Promise<{available_groups: Array<{lesson_group_id: number, lesson_group_name: string, students_in_group: number, group_capacity: number}>}>}
+   */
+  async getLessonGroups() {
+    return await this.client.get("/api/v1/student/lesson-groups");
+  }
+
   /**
    * Update student (requireAuth)
    * @param {number} studentId - Student ID

package/package.json

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