nazar-salary 3.5.3 → 3.5.5

package/index.d.ts

@@ -870,6 +870,8 @@ declare module 'nazar-salary' {
     lessonsDone: number;
     /** lessons in the course; 12 until set */
     lessonsTotal: number;
+    /** shown on the check page in place of the certificate's type; null until set */
+    teacher_full_name: string | null;
     /** null while the course is not completed */
     certificate: AkcentCertificate | null;
   }
@@ -883,6 +885,8 @@ declare module 'nazar-salary' {
     lessonsDone?: number | null;
     /** 1–1000 */
     lessonsTotal?: number | null;
+    /** up to 201 characters; "" counts as null */
+    teacher_full_name?: string | null;
   }
 
   export interface UpdateAkcentCourseResponse {
@@ -891,6 +895,14 @@ declare module 'nazar-salary' {
     languageLevel: AkcentLanguageLevel | string;
     lessonsDone: number;
     lessonsTotal: number;
+    teacher_full_name: string | null;
+  }
+
+  /** Teacher of the student's latest course in Salary (default for teacher_full_name) */
+  export interface CertificatesSalaryTeacher {
+    id: number;
+    first_name: string | null;
+    last_name: string | null;
   }
 
   export interface AkcentStudent {
@@ -900,12 +912,60 @@ 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;
+    teacher_full_name: string;
+    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;
+    /** up to 201 characters */
+    teacher_full_name: string;
+    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';
@@ -1877,6 +1937,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>}
    */
@@ -770,7 +770,7 @@ class SalaryAPI {
    * Shown on the certificate check page (verifyUrl). Send only what changes; null = default.
    * @param {number} studentId - Student ID
    * @param {number} courseId - Akcent course ID
-   * @param {object} data - { languageLevel?, lessonsDone?, lessonsTotal? }
+   * @param {object} data - { languageLevel?, lessonsDone?, lessonsTotal?, teacher_full_name? }
    * @returns {Promise<UpdateAkcentCourseResponse>}
    */
   async updateStudentCertificateCourse(studentId, courseId, data) {
@@ -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.3",
+  "version": "3.5.5",
   "description": "Frontend library for Nazar Salary API",
   "main": "index.js",
   "types": "index.d.ts",