nazar-salary 3.4.7 → 3.4.8

package/index.d.ts

@@ -496,7 +496,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 {
@@ -1769,8 +1772,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.8",
   "description": "Frontend library for Nazar Salary API",
   "main": "index.js",
   "types": "index.d.ts",