nazar-salary 3.5.4 → 3.5.6

package/index.d.ts

@@ -912,13 +912,61 @@ declare module 'nazar-salary' {
     logo_url: string | null;
     phone: string | null;
     courses: AkcentCourse[];
+    /** certificates for offline courses, newest first */
+    offline_certificates: AkcentOfflineCertificate[];
+  }
+
+  export interface AkcentOfflineCertificate {
+    number: string;
+    /** given_date, epoch ms */
+    issuedAt: number;
+    course_name: string;
+    /** null when no teacher was given */
+    teacher_full_name: string | null;
+    languageLevel: AkcentLanguageLevel | string;
+    lessonsDone: number;
+    lessonsTotal: number;
+    totalGrade: number;
+    verifyUrl: string;
+    downloadUrl: string;
+  }
+
+  /** Latest course of the student in Salary (defaults for forms) */
+  export interface CertificatesSalaryCourse {
+    completed_lessons: number;
+    total_lessons: number;
   }
 
   export interface StudentCertificatesResponse {
-    /** false — no Akcent student with this phone */
+    /** false — the student could not be loaded from Akcent */
     found: boolean;
+    /** true — the student was just created in Akcent by this request */
+    created: boolean;
     student: AkcentStudent | null;
     salary_teacher: CertificatesSalaryTeacher | null;
+    salary_course: CertificatesSalaryCourse | null;
+  }
+
+  export interface CreateOfflineCertificateData {
+    /** up to 255 characters */
+    course_name: string;
+    /** optional, up to 201 characters; without it the check page shows the certificate's type and the PDF has no teacher line */
+    teacher_full_name?: string | null;
+    languageLevel: AkcentLanguageLevel;
+    /** 0–1000, not more than lessonsTotal */
+    lessonsDone: number;
+    /** 1–1000 */
+    lessonsTotal: number;
+    /** "YYYY-MM-DD" (Almaty day), ISO date-time or epoch ms; today by default; not later than tomorrow */
+    given_date?: string | number;
+    /** 0–100, 95 by default */
+    totalGrade?: number;
+  }
+
+  export interface CreateOfflineCertificateResponse {
+    /** false — the certificate given before for this student, course and day (updated) */
+    created: boolean;
+    certificate: AkcentOfflineCertificate;
   }
 
   export type StopReason = 'student_quit' | 'moved_away' | 'health_issues' | 'financial' | 'other' | 'refund';
@@ -1890,6 +1938,7 @@ declare module 'nazar-salary' {
     getStudent(studentId: number): Promise<StudentDetail>;
     getStudentCertificates(studentId: number): Promise<StudentCertificatesResponse>;
     updateStudentCertificateCourse(studentId: number, courseId: number, data: UpdateAkcentCourseData): Promise<UpdateAkcentCourseResponse>;
+    createStudentOfflineCertificate(studentId: number, data: CreateOfflineCertificateData): Promise<CreateOfflineCertificateResponse>;
     searchStudents(params: SearchStudentsParams): Promise<SearchStudentsResponse>;
     getStoppedStudents(params?: StoppedStudentsParams): Promise<StoppedStudentsResponse>;
     getMyStoppedStudents(params?: MyStoppedStudentsParams): Promise<MyStoppedStudentsResponse>;

package/index.js

@@ -757,7 +757,7 @@ class SalaryAPI {
 
   /**
    * Get student's Akcent Online courses and certificates (requireAuth: admin or owner manager)
-   * The backend finds the student in Akcent by phone.
+   * The backend finds the student in Akcent by phone and creates them there if missing.
    * @param {number} studentId - Student ID
    * @returns {Promise<StudentCertificatesResponse>}
    */
@@ -780,6 +780,20 @@ class SalaryAPI {
     );
   }
 
+  /**
+   * Give an Akcent certificate for an offline course (requireAuth: admin or owner manager)
+   * Same student, course_name and day again updates the certificate given before.
+   * @param {number} studentId - Student ID
+   * @param {object} data - { course_name, teacher_full_name?, languageLevel, lessonsDone, lessonsTotal, given_date?, totalGrade? }
+   * @returns {Promise<CreateOfflineCertificateResponse>}
+   */
+  async createStudentOfflineCertificate(studentId, data) {
+    return await this.client.post(
+      `/api/v1/student/${studentId}/certificates`,
+      data,
+    );
+  }
+
   /**
    * Search students globally (Admin only)
     * By default returns only active records; pass is_active=false for stopped.

package/package.json

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