nazar-salary 3.3.0 → 3.3.2

package/index.d.ts

@@ -1625,10 +1625,120 @@ declare module 'nazar-salary' {
      */
     getTeacherExpensesForecast(monthsAhead?: number): Promise<TeacherExpensesForecastResponse>;
 
+    // Export endpoints
+    /**
+     * Export students by manager as Excel file (Admin only)
+     * @param managerId Manager (МЗК) ID (required)
+     * @param month Period filter in YYYY-MM format (optional). If omitted, all students are exported.
+     */
+    exportStudentsByManager(managerId: number, month?: string): Promise<ArrayBuffer>;
+
+    // ===== RESALE ENDPOINTS =====
+
+    /** Extend active student course. TASK-001-1 */
+    extendStudentCourse(studentId: number, data: ExtendCourseData): Promise<ExtendCourseResponse>;
+
+    /** Resale course to a completed student. TASK-001-2 */
+    resaleStudentCourse(studentId: number, data: ResaleCourseData): Promise<ResaleCourseResponse>;
+
+    /** Get list of students with resales (Admin only). TASK-001-3 */
+    getResalesStudents(params?: ResalesStudentsParams): Promise<ResalesStudentsResponse>;
+
     // Custom request
     request(method: string, path: string, data?: any): Promise<any>;
   }
 
+  // ===== RESALE TYPES =====
+
+  export interface ExtendCourseData {
+    /** Months to add (1-12) */
+    added_months: number;
+    teacher_id: number;
+    purchase_amount: number;
+    operation_number: string;
+  }
+
+  export interface ExtendCourseResponse {
+    status: 'success';
+    type: 'extension';
+    student_id: number;
+    previous_enrollment_months: number;
+    new_enrollment_months: number;
+    added_months: number;
+    previous_total_lessons: number;
+    new_total_lessons: number;
+    purchase_id: number;
+    resale_history_id: number;
+    created_at: string;
+  }
+
+  export interface ResaleCourseData {
+    price_id: number;
+    teacher_id: number;
+    enrollment_months: number;
+    /** Required for non-individual price formats */
+    group_name?: string;
+    main_course: string;
+    bonus_languages?: string[];
+    purchase_amount: number;
+    operation_number: string;
+    prepayment: boolean;
+    /** Admin only */
+    manager_id?: number;
+  }
+
+  export interface ResaleCourseResponse {
+    status: 'success';
+    type: 'resale';
+    student_id: number;
+    new_student_history_id: number;
+    enrollment_months: number;
+    total_lessons: number;
+    purchase_id: number;
+    resale_history_id: number;
+    created_at: string;
+  }
+
+  export interface ResalesStudentsParams {
+    type?: 'extension' | 'resale';
+    /** Format: YYYY-MM */
+    month?: string;
+    page?: number;
+    /** Max 30 */
+    limit?: number;
+  }
+
+  export interface ResaleStudentItem {
+    resale_id: number;
+    student_id: number;
+    student_name: string;
+    phone: string;
+    type: 'extension' | 'resale';
+    previous_enrollment_months: number | null;
+    new_enrollment_months: number | null;
+    added_months: number | null;
+    purchase_amount: number;
+    manager_id: number;
+    manager_name: string;
+    created_at: string;
+  }
+
+  export interface ResalesStudentsResponse {
+    status: 'success';
+    summary: {
+      total: number;
+      extension_count: number;
+      resale_count: number;
+    };
+    students: ResaleStudentItem[];
+    pagination: {
+      page: number;
+      limit: number;
+      total: number;
+      total_pages: number;
+    };
+  }
+
   export interface TeacherExpensesForecastResponse {
     status: string;
     forecast_metadata: {

package/index.js

@@ -993,6 +993,73 @@ class SalaryAPI {
     });
   }
 
+  /**
+   * Export students by manager as Excel file (Admin only)
+   * @param {number} managerId - Manager (МЗК) ID (required)
+   * @param {string} [month] - Period filter in YYYY-MM format (optional)
+   * @returns {Promise<Buffer>} Excel file buffer
+   */
+  async exportStudentsByManager(managerId, month) {
+    const params = { manager_id: managerId };
+    if (month !== undefined) params.month = month;
+    return await this.client.get("/api/v1/students/export", {
+      params,
+      responseType: "arraybuffer",
+    });
+  }
+
+  // ===== RESALE ENDPOINTS =====
+
+  /**
+   * Extend active student course (Manager, Admin)
+   * TASK-001-1: extension
+   * @param {number} studentId - Student ID
+   * @param {object} data - Extension data
+   * @param {number} data.added_months - Months to add (1-12)
+   * @param {number} data.teacher_id - Teacher ID
+   * @param {number} data.purchase_amount - Payment amount
+   * @param {string} data.operation_number - Unique operation number
+   * @returns {Promise<ExtendCourseResponse>}
+   */
+  async extendStudentCourse(studentId, data) {
+    return await this.client.post(`/api/v1/students/${studentId}/extend`, data);
+  }
+
+  /**
+   * Resale course to a completed student (Manager, Admin)
+   * TASK-001-2: resale
+   * @param {number} studentId - Student ID
+   * @param {object} data - Resale data
+   * @param {number} data.price_id - Price plan ID
+   * @param {number} data.teacher_id - Teacher ID
+   * @param {number} data.enrollment_months - Enrollment months (1-12)
+   * @param {string} [data.group_name] - Group name (required for non-individual formats)
+   * @param {string} data.main_course - Main course name
+   * @param {string[]} [data.bonus_languages] - Bonus languages
+   * @param {number} data.purchase_amount - Payment amount
+   * @param {string} data.operation_number - Unique operation number
+   * @param {boolean} data.prepayment - Is prepayment
+   * @param {number} [data.manager_id] - Manager ID (Admin only)
+   * @returns {Promise<ResaleCourseResponse>}
+   */
+  async resaleStudentCourse(studentId, data) {
+    return await this.client.post(`/api/v1/students/${studentId}/resale`, data);
+  }
+
+  /**
+   * Get list of students with resales (Admin only)
+   * TASK-001-3
+   * @param {object} [params] - Query parameters
+   * @param {'extension'|'resale'} [params.type] - Filter by resale type
+   * @param {string} [params.month] - Filter by month (YYYY-MM)
+   * @param {number} [params.page=1] - Page number
+   * @param {number} [params.limit=30] - Items per page (max 30)
+   * @returns {Promise<ResalesStudentsResponse>}
+   */
+  async getResalesStudents(params = {}) {
+    return await this.client.get('/api/v1/resales/students', { params });
+  }
+
   // ===== CUSTOM REQUEST =====
 
   /**

package/package.json

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