nazar-salary 3.4.3 → 3.4.4

package/index.d.ts

@@ -818,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;
     };
@@ -1727,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
     /**
@@ -1854,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;
@@ -1867,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

@@ -1033,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.3",
+  "version": "3.4.4",
   "description": "Frontend library for Nazar Salary API",
   "main": "index.js",
   "types": "index.d.ts",