nazar-salary 3.3.6 → 3.4.0

package/index.d.ts

@@ -695,6 +695,7 @@ declare module 'nazar-salary' {
   }
 
   export interface UpdateStudentProgressData {
+    /** Change in completed lessons (delta): positive to add, negative to correct */
     new_completed_lessons: number;
     comment?: string;
   }
@@ -720,6 +721,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 {
@@ -1631,6 +1664,7 @@ declare module 'nazar-salary' {
     transferStudent(studentId: number, data: TransferStudentData): Promise<TransferResponse>;
     changeStudentManager(studentId: number, data: ChangeStudentManagerData): Promise<ChangeStudentManagerResponse>;
     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 +1738,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 +1769,8 @@ declare module 'nazar-salary' {
     prepayment: boolean;
     /** Admin only */
     manager_id?: number;
+    /** Unix timestamp (ms) — дата покупки; её месяц определяет месяц зарплаты менеджера */
+    created_at: number;
   }
 
   export interface ResaleCourseResponse {

package/index.js

@@ -621,7 +621,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 +632,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 +1050,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 +1072,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.0",
   "description": "Frontend library for Nazar Salary API",
   "main": "index.js",
   "types": "index.d.ts",