nazar-salary 3.4.7 → 3.4.9

package/index.d.ts

@@ -461,6 +461,10 @@ declare module 'nazar-salary' {
     active_students: number;
     /** Distinct students whose courses on this tariff are all closed */
     inactive_students: number;
+    /** Team salary per month per student on this tariff; null if not configured */
+    monthly_team_price: number | null;
+    /** Sum of monthly_team_price * enrollment_months over active courses (same as /admin/team_salary/total gross, per tariff); null if not configured */
+    team_salary_total: number | null;
   }
 
   export interface PricesListResponse {
@@ -483,6 +487,8 @@ declare module 'nazar-salary' {
     rate_per_lesson: number;
     /** Gross payments attributed to this student on this tariff */
     purchase_amount: number;
+    /** enrollment_months * monthly_team_price; null if no team_salary config for this price */
+    team_salary_amount: number | null;
     teacher_id: number | null;
     teacher_name: string | null;
     /** Owner of the student (student_history.owned_by) */
@@ -496,7 +502,10 @@ declare module 'nazar-salary' {
     group_name: string | null;
     main_course: string;
     student_history_id: number;
+    /** Course start date, ms timestamp */
     created_at: number;
+    /** Student sale/registration date (students.created_at) — what created_from/created_to filter on */
+    student_created_at: number;
   }
 
   export interface PriceStudentsResponse {
@@ -508,6 +517,8 @@ declare module 'nazar-salary' {
       lessons_per_month: number;
       duration_minutes: number;
       rate_per_lesson: number;
+      /** null if team salary is not configured for this tariff */
+      monthly_team_price: number | null;
     };
     pagination: {
       page: number;
@@ -908,6 +919,12 @@ declare module 'nazar-salary' {
       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;
+      /** Team salary for sales of the selected month: months sold (new sales, extensions, resales) × tariff monthly_team_price */
+      team_salary_gross: number;
+      /** Team salary deductions with deduction_date in the selected month */
+      team_salary_deductions: number;
+      /** team_salary_gross − team_salary_deductions */
+      team_salary_net: number;
     };
   }
 
@@ -1769,8 +1786,8 @@ declare module 'nazar-salary' {
     getPriceHistory(priceId: number): Promise<PriceHistoryResponse>;
     deletePrice(priceId: number): Promise<void>;
     getPricesList(): Promise<PricesListResponse>;
-    getPriceStudents(priceId: number, params?: { status?: 'active' | 'inactive'; page?: number; limit?: number }): Promise<PriceStudentsResponse>;
-    exportPriceStudents(prices?: number[] | string, options?: { status?: 'active' | 'inactive' }): Promise<ArrayBuffer>;
+    getPriceStudents(priceId: number, params?: { status?: 'active' | 'inactive'; created_from?: string; created_to?: string; page?: number; limit?: number }): Promise<PriceStudentsResponse>;
+    exportPriceStudents(prices?: number[] | string, options?: { status?: 'active' | 'inactive'; created_from?: string; created_to?: string }): Promise<ArrayBuffer>;
 
     // Student endpoints
     createStudent(data: CreateStudentData): Promise<CreateStudentResponse>;

package/index.js

@@ -541,6 +541,8 @@ class SalaryAPI {
    * @param {number} priceId - Price/tariff ID
    * @param {object} [params]
    * @param {'active'|'inactive'} [params.status] - Filter by course state
+   * @param {string} [params.created_from] - Student sale date from, YYYY-MM-DD or ISO 8601
+   * @param {string} [params.created_to] - Student sale date to, inclusive
    * @param {number} [params.page=1]
    * @param {number} [params.limit=30] - Max 200
    * @returns {Promise<PriceStudentsResponse>}
@@ -1073,6 +1075,8 @@ class SalaryAPI {
    * @param {number[]|string} [prices] - Tariff IDs, e.g. [1,2,3] or "1,2,3". Omit for all tariffs
    * @param {object} [options]
    * @param {'active'|'inactive'} [options.status] - Filter by course state
+   * @param {string} [options.created_from] - Student sale date from, YYYY-MM-DD or ISO 8601
+   * @param {string} [options.created_to] - Student sale date to, inclusive
    * @returns {Promise<ArrayBuffer>} Excel file
    */
   async exportPriceStudents(prices, options = {}) {
@@ -1081,6 +1085,8 @@ class SalaryAPI {
       params.prices = Array.isArray(prices) ? prices.join(",") : prices;
     }
     if (options.status !== undefined) params.status = options.status;
+    if (options.created_from !== undefined) params.created_from = options.created_from;
+    if (options.created_to !== undefined) params.created_to = options.created_to;
     return await this.client.get("/api/v1/price/students/export", {
       params,
       responseType: "arraybuffer",

package/package.json

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