nazar-salary 2.8.2 → 2.8.3

package/index.d.ts

@@ -1106,6 +1106,96 @@ declare module 'nazar-salary' {
     total_purchase_amount: number;
   }
 
+  export type StudentStatus = 'active' | 'waiting' | 'cancelled';
+
+  export interface CreateWaitingStudentData {
+    first_name: string;
+    last_name: string;
+    phone: string;
+    age?: number;
+    main_course: string;
+    price_id: number;
+    enrollment_months: number;
+    purchase_amount: number;
+    operation_number: string;
+    bonus_languages?: string[];
+    manager_id?: number;
+  }
+
+  export interface CreateWaitingStudentResponse {
+    id: number;
+    status: 'waiting';
+    first_name: string;
+    last_name: string;
+    phone: string;
+    age: number | null;
+    main_course: string;
+    price_id: number;
+    enrollment_months: number;
+    total_lessons: number;
+    purchase_amount: number;
+    operation_number: string;
+    owned_by: number;
+    created_at: number;
+  }
+
+  export interface WaitingStudentItem {
+    id: number;
+    first_name: string;
+    last_name: string;
+    phone: string;
+    age: number | null;
+    status: StudentStatus;
+    main_course: string;
+    bonus_languages: string[];
+    price_id: number;
+    group_type: GroupType;
+    lessons_per_month: number;
+    rate_per_lesson: number;
+    enrollment_months: number;
+    total_lessons: number;
+    purchase_amount: number;
+    operation_number: string;
+    owned_by: number;
+    manager_name: string;
+    created_at: number;
+  }
+
+  export interface WaitingStudentsParams {
+    main_course?: string;
+    created_from?: string;
+    created_to?: string;
+    page?: number;
+    limit?: number;
+  }
+
+  export interface WaitingStudentsResponse {
+    total_students: number;
+    current_page: number;
+    total_pages: number;
+    students: WaitingStudentItem[];
+  }
+
+  export interface ActivateWaitingStudentData {
+    teacher_id: number;
+    group_name: string;
+    lesson_group_id?: number;
+  }
+
+  export interface ActivateWaitingStudentResponse {
+    id: number;
+    status: 'active';
+    teacher_id: number;
+    group_name: string;
+    group_type: GroupType;
+    lesson_group: {
+      lesson_group_id: number;
+      students_in_group: Array<{ id: number; name: string }>;
+      group_capacity: string;
+    } | null;
+    activated_at: number;
+  }
+
   export interface DeleteStudentResponse {
     message: string;
     student_id: number;
@@ -1224,6 +1314,11 @@ declare module 'nazar-salary' {
     getAllStudents(params?: AllStudentsParams): Promise<AllStudentsResponse>;
     deleteStudentPurchase(studentId: number, purchaseId: number): Promise<DeleteStudentPurchaseResponse>;
 
+    // Waiting list endpoints
+    createWaitingStudent(data: CreateWaitingStudentData): Promise<CreateWaitingStudentResponse>;
+    getWaitingStudents(params?: WaitingStudentsParams): Promise<WaitingStudentsResponse>;
+    activateWaitingStudent(studentId: number, data: ActivateWaitingStudentData): Promise<ActivateWaitingStudentResponse>;
+
     // Custom request
     request(method: string, path: string, data?: any): Promise<any>;
   }

package/index.js

@@ -692,6 +692,57 @@ class SalaryAPI {
     return await this.client.get("/api/v1/student/list/lite", { params });
   }
 
+  // ===== WAITING LIST ENDPOINTS =====
+
+  /**
+   * Create student in waiting status (requireAuth)
+   * Teacher and group are NOT assigned at this stage
+   * @param {object} data - Student data
+   * @param {string} data.first_name - First name
+   * @param {string} data.last_name - Last name
+   * @param {string} data.phone - Phone number (11 digits)
+   * @param {number} [data.age] - Age (optional)
+   * @param {string} data.main_course - Main course
+   * @param {number} data.price_id - Price/tariff ID
+   * @param {number} data.enrollment_months - Enrollment months (1-12)
+   * @param {number} data.purchase_amount - Purchase amount > 0
+   * @param {string} data.operation_number - Unique operation number
+   * @param {string[]} [data.bonus_languages] - Bonus languages array
+   * @param {number} [data.manager_id] - Manager ID (Admin only)
+   * @returns {Promise<object>}
+   */
+  async createWaitingStudent(data) {
+    return await this.client.post("/api/v1/students/waiting/new", data);
+  }
+
+  /**
+   * Get list of waiting students (requireAuth)
+   * Managers see only their own students, admins see all
+   * @param {object} [params] - Query parameters
+   * @param {string} [params.main_course] - Filter by main course
+   * @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 {number} [params.page=1] - Page number
+   * @param {number} [params.limit=30] - Items per page (max 30)
+   * @returns {Promise<object>}
+   */
+  async getWaitingStudents(params = {}) {
+    return await this.client.get("/api/v1/students/waiting", { params });
+  }
+
+  /**
+   * Activate waiting student — assign teacher and group (requireAuth)
+   * @param {number} studentId - Student ID
+   * @param {object} data - Activation data
+   * @param {number} data.teacher_id - Teacher ID (required)
+   * @param {string} data.group_name - Group/chat name (required)
+   * @param {number} [data.lesson_group_id] - Existing lesson group ID (for duet/trio)
+   * @returns {Promise<object>}
+   */
+  async activateWaitingStudent(studentId, data) {
+    return await this.client.post(`/api/v1/students/${studentId}/activate`, data);
+  }
+
   /**
    * Delete student (soft delete, requireAuth)
    * Managers can only delete their own students

package/package.json

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