nazar-salary 2.1.1 → 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 {
@@ -505,6 +585,23 @@ declare module 'nazar-salary' {
     main_course?: string;
   }
 
+  export interface ChangeStudentManagerData {
+    new_manager_id: number;
+  }
+
+  export interface ChangeStudentManagerResponse {
+    student_id: number;
+    old_manager: {
+      id: number;
+      name: string;
+    };
+    new_manager: {
+      id: number;
+      name: string;
+    };
+    reassigned_at: number;
+  }
+
   export interface StudentBasicInfo {
     id: number;
     first_name: string;
@@ -649,7 +746,7 @@ declare module 'nazar-salary' {
   }
 
   /** @deprecated Use StudentsListParams instead */
-  export interface ManagerStudentsParams extends Omit<StudentsListParams, 'manager_id'> {}
+  export interface ManagerStudentsParams extends Omit<StudentsListParams, 'manager_id'> { }
 
   /** @deprecated Use StudentsListResponse instead */
   export interface ManagerStudentsResponse extends StudentsListResponse {
@@ -709,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>;
@@ -727,9 +825,11 @@ 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>;
     searchStudents(params: SearchStudentsParams): Promise<SearchStudentsResponse>;
     getStudentsList(params?: StudentsListParams): Promise<StudentsListResponse>;

package/index.js

@@ -189,13 +189,14 @@ class SalaryAPI {
    */
   async uploadKaspiReceipt(file, options = {}) {
     const formData = new FormData();
-    formData.append('file', file);
-    if (options.period_from) formData.append('period_from', options.period_from);
-    if (options.period_to) formData.append('period_to', options.period_to);
+    formData.append("file", file);
+    if (options.period_from)
+      formData.append("period_from", options.period_from);
+    if (options.period_to) formData.append("period_to", options.period_to);
 
     return await this.client.post("/api/v1/admin/receipts/upload", formData, {
       headers: {
-        'Content-Type': 'multipart/form-data',
+        "Content-Type": "multipart/form-data",
       },
     });
   }
@@ -256,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 =====
 
   /**
@@ -418,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
@@ -452,7 +482,24 @@ class SalaryAPI {
    * @returns {Promise<object>}
    */
   async transferStudent(studentId, data) {
-    return await this.client.post(`/api/v1/student/${studentId}/transfer`, data);
+    return await this.client.post(
+      `/api/v1/student/${studentId}/transfer`,
+      data,
+    );
+  }
+
+  /**
+   * Change student manager (Admin only)
+   * @param {number} studentId - Student ID
+   * @param {object} data - Change manager data
+   * @param {number} data.new_manager_id - New manager user ID
+   * @returns {Promise<{student_id: number, old_manager: object, new_manager: object, reassigned_at: number}>}
+   */
+  async changeStudentManager(studentId, data) {
+    return await this.client.post(
+      `/api/v1/student/${studentId}/change-manager`,
+      data,
+    );
   }
 
   /**

package/package.json

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