@loka-sms/core-integration-be 0.0.2 → 0.0.3

package/README.md

@@ -1,6 +1,6 @@
-# @loka-sms/core-integration-be
+# @loka-sms/core-integration-be
 
-NestJS helper package untuk backend modul Loka SMS yang perlu mengakses data Core via service-to-service auth (`X-App-ID` + `X-App-Secret`).
+NestJS helper package untuk backend modul OMNISCHOOL yang perlu mengakses data Core via service-to-service auth (`X-App-ID` + `X-App-Secret`).
 
 Package ini cocok untuk **worker/background job/service sync**, bukan untuk forwarding token user.
 
@@ -28,9 +28,9 @@ npm install @loka-sms/core-integration-be
 
 | Variabel | Wajib | Fallback | Keterangan |
 |---|---|---|---|
-| `CORE_SERVICE_URL` | ✅ | — | Base URL Gateway, contoh: `http://localhost:3000/api` |
-| `CORE_APP_ID` | ✅ | `APP_ID` | Application ID yang terdaftar di Core |
-| `CORE_APP_SECRET` | ✅ | `APP_SECRET` | Application secret (plain, bukan bcrypt) |
+| `CORE_SERVICE_URL` | ✅ | — | Base URL Gateway, contoh: `http://localhost:3000/api` |
+| `CORE_APP_ID` | ✅ | `APP_ID` | Application ID yang terdaftar di Core |
+| `CORE_APP_SECRET` | ✅ | `APP_SECRET` | Application secret (plain, bukan bcrypt) |
 
 Contoh `.env`:
 

package/dist/core-integration.service.d.ts

@@ -16,6 +16,10 @@ export declare class CoreIntegrationService {
     private extractStudentId;
     private extractStudentUserId;
     private unwrapRecord;
+    private extractUserId;
+    private extractEntityId;
+    private matchByUserId;
+    private assertTenantScope;
     get<T = any>(path: string, schoolId?: string, options?: CoreRequestOptions): Promise<T>;
     post<T = any>(path: string, schoolId: string | undefined, body?: unknown, options?: CoreRequestOptions): Promise<T>;
     put<T = any>(path: string, schoolId: string | undefined, body?: unknown, options?: CoreRequestOptions): Promise<T>;
@@ -36,6 +40,12 @@ export declare class CoreIntegrationService {
     getTeacher(teacherId: string, schoolId: string): Promise<any>;
     getTeacherByUserId(userId: string, schoolId: string): Promise<any>;
     resolveTeacherUserIdToTeacherId(userId: string, schoolId: string): Promise<string | null>;
+    reconcileAcademicData(schoolId: string, academicYear?: string): Promise<{
+        teachers: any[];
+        classes: any[];
+        assignments: any[];
+    }>;
+    getTeacherAssignments(teacherId: string, schoolId: string, academicYear?: string): Promise<any[]>;
     getClass(classId: string, schoolId: string): Promise<any>;
     getClasses(schoolId: string, params?: Record<string, unknown>): Promise<any[]>;
     getTeachers(schoolId: string): Promise<any[]>;

package/dist/core-integration.service.js

@@ -65,6 +65,28 @@ let CoreIntegrationService = CoreIntegrationService_1 = class CoreIntegrationSer
     unwrapRecord(data) {
         return data?.data || data;
     }
+    extractUserId(entity) {
+        return entity?.userId || entity?.user_id || entity?.user?.id || null;
+    }
+    extractEntityId(entity) {
+        return entity?.id || null;
+    }
+    matchByUserId(items, userId) {
+        for (const item of items) {
+            if (item?.userId === userId)
+                return item;
+            if (item?.user_id === userId)
+                return item;
+            if (item?.user?.id === userId)
+                return item;
+        }
+        return null;
+    }
+    assertTenantScope(schoolId, contextLabel) {
+        if (!schoolId) {
+            throw new Error(`${contextLabel}: schoolId (X-School-ID) is required for non-super_admin operations`);
+        }
+    }
     async get(path, schoolId, options = {}) {
         const { headers, ...requestOptions } = options;
         const res = await (0, rxjs_1.firstValueFrom)(this.httpService.get(this.makeUrl(path), {
@@ -226,17 +248,55 @@ let CoreIntegrationService = CoreIntegrationService_1 = class CoreIntegrationSer
         }
     }
     async getTeacherByUserId(userId, schoolId) {
+        // Fast path: try direct lookup endpoint (if Core provides it)
         try {
-            return this.unwrapRecord(await this.get(`teachers/by-user/${userId}`, schoolId));
-        }
-        catch (error) {
-            this.logger.warn(`Failed to fetch teacher by user ${userId}: ${error.message}`);
-            return null;
+            const data = await this.get(`teachers/by-user/${userId}`, schoolId);
+            return this.unwrapRecord(data);
+        }
+        catch {
+            // Fallback: fetch all active teachers and find match by userId
+            try {
+                const teachers = await this.getTeachers(schoolId);
+                return this.matchByUserId(teachers, userId);
+            }
+            catch {
+                return null;
+            }
         }
     }
     async resolveTeacherUserIdToTeacherId(userId, schoolId) {
         const teacher = await this.getTeacherByUserId(userId, schoolId);
-        return teacher?.id || null;
+        return this.extractEntityId(teacher);
+    }
+    async reconcileAcademicData(schoolId, academicYear) {
+        try {
+            const data = await this.post('integrations/lms/reconcile', schoolId, {
+                schoolId,
+                academicYear,
+            });
+            const body = data?.data || data;
+            return {
+                teachers: body?.teachers || [],
+                classes: body?.classes || [],
+                assignments: body?.assignments || [],
+            };
+        }
+        catch (error) {
+            this.logger.error(`Failed to reconcile academic data: ${error.message}`);
+            throw new Error('Core service unavailable: unable to reconcile academic data');
+        }
+    }
+    async getTeacherAssignments(teacherId, schoolId, academicYear) {
+        try {
+            const data = await this.get(`teachers/${teacherId}/assignments`, schoolId, {
+                params: academicYear ? { academicYear } : {},
+            });
+            const raw = data?.data || data;
+            return raw?.data || (Array.isArray(raw) ? raw : []);
+        }
+        catch {
+            return [];
+        }
     }
     async getClass(classId, schoolId) {
         try {

package/package.json

@@ -1,7 +1,7 @@
-{
+{
   "name": "@loka-sms/core-integration-be",
-  "version": "0.0.2",
-  "description": "Internal NestJS client for service-to-service access to Loka SMS Core APIs",
+  "version": "0.0.3",
+  "description": "Internal NestJS client for service-to-service access to OMNISCHOOL Core APIs",
   "license": "MIT",
   "type": "commonjs",
   "main": "dist/index.js",