nazar-salary 2.0.1 → 2.2.0

package/index.d.ts

@@ -165,6 +165,86 @@ declare module 'nazar-salary' {
     period_to?: string;
   }
 
+  export interface ManualPaymentData {
+    operation_number: string;
+    bank_id: string;
+    payment_method: string;
+    amount: number;
+    transaction_date?: string;
+    transaction_time?: string;
+    comment?: string;
+  }
+
+  export interface ManualPaymentStudent {
+    id: number;
+    first_name: string;
+    last_name: string;
+    phone?: string;
+    manager_name?: string;
+    purchase_amount?: number;
+    is_verified: boolean;
+    verified_at?: string;
+  }
+
+  export interface ManualPaymentDetails {
+    operation_number: string;
+    amount: number;
+    bank_commission?: number;
+    net_amount?: number;
+    manager_commission?: number;
+    discrepancy_amount?: number;
+    payment_method?: string;
+    manual_verification?: boolean;
+    verified_by?: number;
+  }
+
+  export interface ManualPaymentResponse {
+    status: 'success' | 'error';
+    result: 'verified' | 'discrepancy' | 'orphan';
+    message: string;
+    student?: ManualPaymentStudent;
+    payment: ManualPaymentDetails;
+    code?: string;
+    details?: any;
+  }
+
+  export interface OrphanPaymentItem {
+    id: number;
+    operation_number: string;
+    amount: number;
+    bank_name: string;
+    payment_method: string;
+    commission_rate: number;
+    bank_commission: number;
+    net_amount: number;
+    transaction_date?: string;
+    transaction_time?: string;
+    comment?: string;
+    created_by: string;
+    created_at: string;
+  }
+
+  export interface OrphanPaymentsResponse {
+    orphan_payments: OrphanPaymentItem[];
+    pagination: Pagination;
+  }
+
+  export interface PaymentMethod {
+    payment_method_id: string;
+    payment_method_name: string;
+    commission_rate: number;
+  }
+
+  export interface BankConfig {
+    bank_id: string;
+    bank_name: string;
+    payment_methods: PaymentMethod[];
+  }
+
+  export interface BanksConfigResponse {
+    banks: BankConfig[];
+  }
+
   export interface UpdateUserData {
     first_name?: string;
     last_name?: string;
@@ -425,6 +505,23 @@ declare module 'nazar-salary' {
     main_course?: string;
   }
 
+  export interface ChangeStudentManagerData {
+    new_manager_id: number;
+  }
+
+  export interface ChangeStudentManagerResponse {
+    student_id: number;
+    old_manager: {
+      id: number;
+      name: string;
+    };
+    new_manager: {
+      id: number;
+      name: string;
+    };
+    reassigned_at: number;
+  }
+
   export interface StudentBasicInfo {
     id: number;
     first_name: string;
@@ -569,7 +666,7 @@ declare module 'nazar-salary' {
   }
 
   /** @deprecated Use StudentsListParams instead */
-  export interface ManagerStudentsParams extends Omit<StudentsListParams, 'manager_id'> {}
+  export interface ManagerStudentsParams extends Omit<StudentsListParams, 'manager_id'> { }
 
   /** @deprecated Use StudentsListResponse instead */
   export interface ManagerStudentsResponse extends StudentsListResponse {
@@ -626,6 +723,9 @@ declare module 'nazar-salary' {
     uploadKaspiReceipt(file: File | Buffer, options?: UploadBankReceiptOptions): Promise<BankReceiptUploadResponse>;
     getReceiptsList(params?: BankReceiptsListParams): Promise<BankReceiptsListResponse>;
     getReceiptStatus(logId: number): Promise<BankReceiptStatusResponse>;
+    addManualPayment(data: ManualPaymentData): Promise<ManualPaymentResponse>;
+    getOrphanPayments(params?: { page?: number; limit?: number }): Promise<OrphanPaymentsResponse>;
+    getBanksConfig(): Promise<BanksConfigResponse>;
 
     // Teacher endpoints
     getTeacherLanguages(): Promise<TeacherLanguagesResponse>;
@@ -647,6 +747,7 @@ declare module 'nazar-salary' {
     createStudent(data: CreateStudentData): Promise<Student>;
     updateStudent(studentId: number, data: UpdateStudentData): Promise<UpdatedStudent>;
     transferStudent(studentId: number, data: TransferStudentData): Promise<TransferResponse>;
+    changeStudentManager(studentId: number, data: ChangeStudentManagerData): Promise<ChangeStudentManagerResponse>;
     getStudent(studentId: number): Promise<StudentDetail>;
     searchStudents(params: SearchStudentsParams): Promise<SearchStudentsResponse>;
     getStudentsList(params?: StudentsListParams): Promise<StudentsListResponse>;

package/index.js

@@ -179,7 +179,7 @@ class SalaryAPI {
 
   /**
    * Upload bank receipt Excel file for verification (Admin only)
-   * Supports Kaspi, Halyk, Jusan and other bank statements
+   * Supports Kaspi only
    * Processing happens asynchronously, use getReceiptStatus to check progress
    * @param {File|Buffer} file - Excel file (.xlsx) with bank statement
    * @param {object} [options] - Upload options
@@ -189,13 +189,14 @@ class SalaryAPI {
    */
   async uploadKaspiReceipt(file, options = {}) {
     const formData = new FormData();
-    formData.append('file', file);
-    if (options.period_from) formData.append('period_from', options.period_from);
-    if (options.period_to) formData.append('period_to', options.period_to);
+    formData.append("file", file);
+    if (options.period_from)
+      formData.append("period_from", options.period_from);
+    if (options.period_to) formData.append("period_to", options.period_to);
 
     return await this.client.post("/api/v1/admin/receipts/upload", formData, {
       headers: {
-        'Content-Type': 'multipart/form-data',
+        "Content-Type": "multipart/form-data",
       },
     });
   }
@@ -218,7 +219,42 @@ class SalaryAPI {
    * @returns {Promise<{status: string, log_id: number, file_name: string, summary?: object, details?: object, error_message?: string}>}
    */
   async getReceiptStatus(logId) {
-    return await this.client.get(`/api/v1/admin/receipts/${logId}`);
+    return await this.client.get(`/api/v1/admin/receipts/logs/${logId}`);
+  }
+
+  /**
+   * Manually add payment from non-Kaspi banks (Admin only)
+   * @param {object} data - Payment data
+   * @param {string} data.operation_number - 11-digit operation number
+   * @param {string} data.bank_id - Bank ID (halyk, forte, jusan, freedom, centercredit)
+   * @param {string} data.payment_method - Payment method ID
+   * @param {number} data.amount - Payment amount (2000-10000000 KZT)
+   * @param {string} [data.transaction_date] - Transaction date
+   * @param {string} [data.transaction_time] - Transaction time
+   * @param {string} [data.comment] - Comment (max 500 chars)
+   * @returns {Promise<{status: string, result: string, message: string, student?: object, payment: object}>}
+   */
+  async addManualPayment(data) {
+    return await this.client.post("/api/v1/admin/receipts/manual-add", data);
+  }
+
+  /**
+   * Get list of orphan (unused) payments (Admin only)
+   * @param {object} [params] - Query parameters
+   * @param {number} [params.page=1] - Page number
+   * @param {number} [params.limit=30] - Items per page
+   * @returns {Promise<{orphan_payments: array, pagination: object}>}
+   */
+  async getOrphanPayments(params = {}) {
+    return await this.client.get("/api/v1/admin/receipts/orphan", { params });
+  }
+
+  /**
+   * Get available banks and payment methods configuration (Admin only)
+   * @returns {Promise<{banks: array}>}
+   */
+  async getBanksConfig() {
+    return await this.client.get("/api/v1/admin/receipts/banks");
   }
 
   // ===== TEACHER ENDPOINTS =====
@@ -417,7 +453,24 @@ class SalaryAPI {
    * @returns {Promise<object>}
    */
   async transferStudent(studentId, data) {
-    return await this.client.post(`/api/v1/student/${studentId}/transfer`, data);
+    return await this.client.post(
+      `/api/v1/student/${studentId}/transfer`,
+      data,
+    );
+  }
+
+  /**
+   * Change student manager (Admin only)
+   * @param {number} studentId - Student ID
+   * @param {object} data - Change manager data
+   * @param {number} data.new_manager_id - New manager user ID
+   * @returns {Promise<{student_id: number, old_manager: object, new_manager: object, reassigned_at: number}>}
+   */
+  async changeStudentManager(studentId, data) {
+    return await this.client.post(
+      `/api/v1/student/${studentId}/change-manager`,
+      data,
+    );
   }
 
   /**

package/package.json

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