nazar-salary 3.3.1 → 3.3.3

package/index.d.ts

@@ -1242,6 +1242,8 @@ declare module 'nazar-salary' {
     created_from?: string;
     created_to?: string;
     main_course?: string;
+    /** If true, returns students who have finished the course (is_active=FALSE) */
+    is_finished?: boolean;
     page?: number;
     limit?: number;
   }
@@ -1633,10 +1635,112 @@ declare module 'nazar-salary' {
      */
     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

@@ -313,6 +313,7 @@ class SalaryAPI {
    * @param {string} [params.created_from] - Filter by created date from (ISO 8601)
    * @param {string} [params.created_to] - Filter by created date to (ISO 8601)
    * @param {string} [params.main_course] - Filter by main course
+   * @param {boolean} [params.is_finished] - If true, returns students who have finished the course
    * @param {number} [params.page=1] - Page number
    * @param {number} [params.limit=30] - Items per page (max 30)
    * @returns {Promise<{manager: object, total_students: number, current_page: number, total_pages: number, students: array}>}
@@ -1008,6 +1009,58 @@ class SalaryAPI {
     });
   }
 
+  // ===== 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.1",
+  "version": "3.3.3",
   "description": "Frontend library for Nazar Salary API",
   "main": "index.js",
   "types": "index.d.ts",