nazar-salary 3.4.4 → 3.4.6

package/index.d.ts

@@ -830,13 +830,19 @@ declare module 'nazar-salary' {
       teachers: number;
     };
     finance: {
+      /** Verified payments, NET of bank commission (sum of net_amount) */
       verified_amount: number;
       verified_count: number;
+      /** Not-yet-verified payments, GROSS (sum of purchase_amount) — net_amount only exists after verification, so this is not comparable to verified_amount and the two must not be summed */
+      not_verified_amount: number;
+      not_verified_count: number;
       manager_commission: number;
       teacher_pending_amount: number;
       teacher_pending_count: number;
       /** Total future teacher payments = sum of (remaining_lessons * rate_per_lesson) for all active students */
       future_teacher_payment: number;
+      /** Future teacher payments owed for students whose payments fall in the selected month (verified or not). Group courses counted once per group. */
+      future_teacher_payment_from_month: number;
     };
   }
 
@@ -1064,6 +1070,7 @@ declare module 'nazar-salary' {
       date_to?: string;
       display: string;
     };
+    /** Totals for the requested period (respects period/status/teacher_id filters) */
     summary: {
       total_teachers: number;
       total_payments: number;
@@ -1074,6 +1081,21 @@ declare module 'nazar-salary' {
         paid: number;
       };
     };
+    /**
+     * Lesson totals as of now — a snapshot, NOT limited by period/status
+     * (student_history has no per-lesson dates). Respects teacher_id if passed.
+     * Deleted students are excluded.
+     */
+    lessons_summary: {
+      /** Lessons conducted across all courses ever (finished and stopped included) */
+      completed_lessons: number;
+      /** Lessons still to be conducted — active courses only */
+      remaining_lessons: number;
+      /** completed_lessons valued at the current price (rate_per_lesson) */
+      completed_amount: number;
+      /** remaining_lessons valued at the current price — future teacher payout */
+      remaining_amount: number;
+    };
     teachers: TeacherSalaryItem[];
   }
 

package/index.js

@@ -362,7 +362,14 @@ class SalaryAPI {
    * @param {string} [params.date_to] - End date YYYY-MM-DD (required if period_type=custom)
    * @param {string} [params.status] - Filter by status: 'not_paid', 'pending', 'paid'
    * @param {number} [params.teacher_id] - Filter by teacher ID
-   * @returns {Promise<{period: object, summary: object, teachers: array}>}
+   *
+   * Response also carries `lessons_summary` — a snapshot as of now (NOT limited by
+   * period/status; respects teacher_id, excludes deleted students):
+   *   completed_lessons  — lessons conducted across all courses ever
+   *   remaining_lessons  — lessons still to conduct (active courses only)
+   *   completed_amount   — completed_lessons x current rate_per_lesson
+   *   remaining_amount   — remaining_lessons x current rate_per_lesson (future payout)
+   * @returns {Promise<{period: object, summary: object, lessons_summary: object, teachers: array}>}
    */
   async getTeachersSalary(params) {
     return await this.client.get("/api/v1/admin/salary/teachers", { params });

package/package.json

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