nazar-salary 3.3.6 → 3.4.1

package/index.d.ts

@@ -694,7 +694,26 @@ declare module 'nazar-salary' {
     reassigned_at: number;
   }
 
+  export interface ChangeStudentTeacherData {
+    new_teacher_id: number;
+  }
+
+  export interface ChangeStudentTeacherResponse {
+    student_id: number;
+    old_teacher: {
+      id: number | null;
+      name: string | null;
+    };
+    new_teacher: {
+      id: number;
+      name: string;
+    };
+    lesson_group_id: number | null;
+    changed_at: number;
+  }
+
   export interface UpdateStudentProgressData {
+    /** Change in completed lessons (delta): positive to add, negative to correct */
     new_completed_lessons: number;
     comment?: string;
   }
@@ -720,6 +739,38 @@ declare module 'nazar-salary' {
     };
   }
 
+  export interface ProgressHistoryParams {
+    limit?: number;
+    offset?: number;
+  }
+
+  export interface ProgressHistoryEntry {
+    id: number;
+    student_history_id: number;
+    previous_completed: number;
+    new_completed: number;
+    delta: number;
+    update_source: 'manual' | 'stop' | 'resume' | string;
+    comment: string | null;
+    updated_at: number;
+    updated_by: number;
+    updated_by_name: string | null;
+    main_course: string;
+    total_lessons: number;
+  }
+
+  export interface ProgressHistoryResponse {
+    status: string;
+    student: {
+      id: number;
+      name: string;
+    };
+    total: number;
+    limit: number;
+    offset: number;
+    history: ProgressHistoryEntry[];
+  }
+
   export type StopReason = 'student_quit' | 'moved_away' | 'health_issues' | 'financial' | 'other' | 'refund';
 
   export interface StopStudentData {
@@ -1630,7 +1681,9 @@ declare module 'nazar-salary' {
     updateStudent(studentId: number, data: UpdateStudentData): Promise<UpdateStudentResponse>;
     transferStudent(studentId: number, data: TransferStudentData): Promise<TransferResponse>;
     changeStudentManager(studentId: number, data: ChangeStudentManagerData): Promise<ChangeStudentManagerResponse>;
+    changeStudentTeacher(studentId: number, data: ChangeStudentTeacherData): Promise<ChangeStudentTeacherResponse>;
     updateStudentProgress(studentId: number, data: UpdateStudentProgressData): Promise<UpdateStudentProgressResponse>;
+    getStudentProgressHistory(studentId: number, params?: ProgressHistoryParams): Promise<ProgressHistoryResponse>;
     stopStudent(studentId: number, data: StopStudentData): Promise<StopStudentResponse>;
     resumeStudent(studentId: number, data?: ResumeStudentData): Promise<ResumeStudentResponse>;
     resumeMyStudent(studentId: number, data?: ResumeStudentData): Promise<ResumeStudentResponse>;
@@ -1704,6 +1757,8 @@ declare module 'nazar-salary' {
     teacher_id: number;
     purchase_amount: number;
     operation_number: string;
+    /** Unix timestamp (ms) — дата покупки; её месяц определяет месяц зарплаты менеджера */
+    created_at: number;
   }
 
   export interface ExtendCourseResponse {
@@ -1733,6 +1788,8 @@ declare module 'nazar-salary' {
     prepayment: boolean;
     /** Admin only */
     manager_id?: number;
+    /** Unix timestamp (ms) — дата покупки; её месяц определяет месяц зарплаты менеджера */
+    created_at: number;
   }
 
   export interface ResaleCourseResponse {

package/index.js

@@ -603,6 +603,22 @@ class SalaryAPI {
     );
   }
 
+  /**
+   * Change student's teacher only (requireAuth: admin or owner).
+   * Keeps the current course as-is — does NOT recalculate lessons or create a new course.
+   * For group lessons, changes the teacher for the whole group.
+   * @param {number} studentId - Student ID
+   * @param {object} data - Change teacher data
+   * @param {number} data.new_teacher_id - New teacher ID
+   * @returns {Promise<{student_id: number, old_teacher: {id: number|null, name: string|null}, new_teacher: {id: number, name: string}, lesson_group_id: number|null, changed_at: number}>}
+   */
+  async changeStudentTeacher(studentId, data) {
+    return await this.client.patch(
+      `/api/v1/student/${studentId}/teacher`,
+      data,
+    );
+  }
+
   /**
    * Change student manager (Admin only)
    * @param {number} studentId - Student ID
@@ -621,7 +637,7 @@ class SalaryAPI {
    * Update student progress (Admin only)
    * @param {number} studentId - Student ID
    * @param {object} data - Progress data
-   * @param {number} data.new_completed_lessons - New completed lessons count
+   * @param {number} data.new_completed_lessons - Change in completed lessons (delta): positive to add, negative to correct
    * @param {string} [data.comment] - Optional comment for logging
    * @returns {Promise<{status: string, student: object, students_in_group?: array, teacher_payment_created?: object}>}
    */
@@ -632,6 +648,22 @@ class SalaryAPI {
     );
   }
 
+  /**
+   * Get student progress change history (Admin only)
+   * Append-only log of every completed-lessons change (add/correction/stop/resume).
+   * @param {number} studentId - Student ID
+   * @param {object} [params] - Pagination
+   * @param {number} [params.limit] - Max rows (default 100, max 500)
+   * @param {number} [params.offset] - Offset (default 0)
+   * @returns {Promise<{status: string, student: object, total: number, limit: number, offset: number, history: Array<object>}>}
+   */
+  async getStudentProgressHistory(studentId, params = {}) {
+    return await this.client.get(
+      `/api/v1/admin/progress/${studentId}/history`,
+      { params },
+    );
+  }
+
   /**
    * Get admin dashboard summary (Admin only)
    * @param {string} [month] - Month in MM.YYYY format (e.g. "04.2026"). Defaults to current month.
@@ -1034,6 +1066,7 @@ class SalaryAPI {
    * @param {number} data.teacher_id - Teacher ID
    * @param {number} data.purchase_amount - Payment amount
    * @param {string} data.operation_number - Unique operation number
+   * @param {number} data.created_at - Unix timestamp (ms) — дата покупки; её месяц определяет, в какой месяц попадёт зарплата менеджера
    * @returns {Promise<ExtendCourseResponse>}
    */
   async extendStudentCourse(studentId, data) {
@@ -1055,6 +1088,7 @@ class SalaryAPI {
    * @param {string} data.operation_number - Unique operation number
    * @param {boolean} data.prepayment - Is prepayment
    * @param {number} [data.manager_id] - Manager ID (Admin only)
+   * @param {number} data.created_at - Unix timestamp (ms) — дата покупки; её месяц определяет, в какой месяц попадёт зарплата менеджера
    * @returns {Promise<ResaleCourseResponse>}
    */
   async resaleStudentCourse(studentId, data) {

package/package.json

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