nazar-salary 3.4.1 → 3.4.4

package/index.d.ts

@@ -708,6 +708,8 @@ declare module 'nazar-salary' {
       id: number;
       name: string;
     };
+    /** ID of the newly created student_history row (active course with the new teacher) */
+    new_history_id: number;
     lesson_group_id: number | null;
     changed_at: number;
   }
@@ -816,7 +818,10 @@ declare module 'nazar-salary' {
 
   export interface DashboardKpi {
     students: {
+      /** Students whose latest course record is active (excludes deleted students) */
       active: number;
+      /** Students whose latest course record is closed — finished, stopped or refunded (excludes deleted students) */
+      inactive: number;
       new_this_month: number;
       finished_this_month: number;
     };
@@ -1125,6 +1130,7 @@ declare module 'nazar-salary' {
     teacher_name: string;
     enrollment_months: number;
     total_lessons: number;
+    /** Lessons completed by THIS teacher in this segment (rows after a teacher change start from 0) */
     completed_lessons: number;
     main_course: string;
     group_name: string;
@@ -1133,6 +1139,8 @@ declare module 'nazar-salary' {
     rate_per_lesson: number;
     lesson_group_id: number | null;
     created_at: number;
+    /** Why this course row was closed: 'teacher_change' marks a teacher handoff; null for the active row */
+    stop_reason: string | null;
   }
 
   export interface PaymentInfo {
@@ -1722,9 +1730,10 @@ declare module 'nazar-salary' {
     // Forecast endpoints
     /**
      * Get teacher salary forecast for upcoming months (Admin only)
-     * @param monthsAhead Number of months to forecast (1–12). Default: 6
+     * @param monthsAhead Number of forecast months (1–12). Default: 6
+     * @param monthsBefore Number of past months prepended to monthly_data (0–12). Default: 4
      */
-    getTeacherExpensesForecast(monthsAhead?: number): Promise<TeacherExpensesForecastResponse>;
+    getTeacherExpensesForecast(monthsAhead?: number, monthsBefore?: number): Promise<TeacherExpensesForecastResponse>;
 
     // Export endpoints
     /**
@@ -1849,6 +1858,10 @@ declare module 'nazar-salary' {
     forecast_metadata: {
       generated_at: string;
       current_month: string;
+      /** How many past months are prepended to monthly_data */
+      previous_months: number;
+      /** Earliest month present in monthly_data (current_month minus previous_months) */
+      data_from: string;
       forecast_period_months: number;
       forecast_from: string;
       forecast_to: string;
@@ -1862,6 +1875,7 @@ declare module 'nazar-salary' {
       min_month: string | null;
       max_month: string | null;
     };
+    /** First entry is the previous month (see forecast_metadata.previous_month), then the forecast window from current_month onward. summary/risk_analysis cover the forecast window only. */
     monthly_data: Array<{
       month: string;
       month_display: string;

package/index.js

@@ -604,13 +604,15 @@ 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.
+   * Change student's teacher (requireAuth: admin or owner).
+   * Closes the current course row and opens a new active row with the same total_lessons
+   * and carried-over progress, but the new teacher — so the previous teacher stays visible
+   * in the course history. Does NOT recalculate lessons (unlike transfer).
    * 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}>}
+   * @returns {Promise<{student_id: number, old_teacher: {id: number|null, name: string|null}, new_teacher: {id: number, name: string}, new_history_id: number, lesson_group_id: number|null, changed_at: number}>}
    */
   async changeStudentTeacher(studentId, data) {
     return await this.client.patch(
@@ -1031,12 +1033,13 @@ class SalaryAPI {
 
   /**
    * Get teacher salary forecast for upcoming months (Admin only)
-   * @param {number} [monthsAhead=6] - Number of months to forecast (1-12)
+   * @param {number} [monthsAhead=6] - Number of forecast months (1-12)
+   * @param {number} [monthsBefore=4] - Number of past months to prepend to monthly_data (0-12)
    * @returns {Promise<object>}
    */
-  async getTeacherExpensesForecast(monthsAhead = 6) {
+  async getTeacherExpensesForecast(monthsAhead = 6, monthsBefore = 4) {
     return await this.client.get("/api/v1/forecast/teacher-expenses", {
-      params: { months_ahead: monthsAhead },
+      params: { months_ahead: monthsAhead, months_before: monthsBefore },
     });
   }
 

package/package.json

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