@kth/om-kursen-ladok-client 2.5.6 → 3.1.0

package/dist/{mapSearchResult.d.ts → mapCourseInstanceResult.d.ts}

@@ -1,6 +1,7 @@
 import { LadokStatus } from '@kth/ladok-attributvarde-utils';
-import { SokUtbildningsTillfalleItem, SokUtbildningsTillfalleSlimItem } from '@kth/ladok-mellanlager-client';
+import { PeriodItem, SokUtbildningsTillfalleItem, SokUtbildningsTillfalleSlimItem } from '@kth/ladok-mellanlager-client';
 import { Language, TranslatedGrunddata, TranslatedOrganisation, TranslatedUtbildningstyp } from './utils/languageUtil';
+import { KTHPeriodSemester } from './kth/KTHPeriod/KTHPeriod';
 export type SearchResultPeriod = {
     startperiod: string;
     forstaUndervisningsdatum?: {
@@ -17,7 +18,7 @@ export type SearchResultPeriod = {
     };
     tillfallesperioderNummer: number;
 };
-export type CourseSearchResult = {
+export type CourseInstanceResult = {
     versionsnummer: number;
     kod: string;
     benamning: string;
@@ -36,8 +37,9 @@ export type CourseSearchResult = {
         code: string;
         inDigits: string | null;
     };
-    period?: SearchResultPeriod;
-    isMiljo?: boolean;
     status?: LadokStatus;
+    isMiljo?: boolean;
+    kthPeriods: KTHPeriodSemester[];
+    startingKTHPeriod: KTHPeriodSemester | undefined;
 };
-export declare const mapKursTillfalleResult: (courseInstance: SokUtbildningsTillfalleItem | SokUtbildningsTillfalleSlimItem, language: Language) => CourseSearchResult;
+export declare const mapCourseInstanceResult: (courseInstance: SokUtbildningsTillfalleItem | SokUtbildningsTillfalleSlimItem, periodItems: PeriodItem[], language: Language) => CourseInstanceResult;

package/dist/{mapSearchResult.js → mapCourseInstanceResult.js}

@@ -1,14 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapKursTillfalleResult = void 0;
+exports.mapCourseInstanceResult = void 0;
 const ladok_attributvarde_utils_1 = require("@kth/ladok-attributvarde-utils");
 const languageUtil_1 = require("./utils/languageUtil");
 const utils_1 = require("./utils");
 const creditsUtil_1 = require("./utils/creditsUtil");
 const schoolUtil_1 = require("./utils/schoolUtil");
-// TODO Benni this should be refactored together with mapCourseInstance
-const mapKursTillfalleResult = (courseInstance, language) => {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+const getKTHPeriodSemesters_1 = require("./kth/KTHPeriod/getKTHPeriodSemesters");
+// TODO this should be refactored together with mapCourseInstance
+const mapCourseInstanceResult = (courseInstance, periodItems, language) => {
+    var _a, _b, _c;
     const benamning = {
         sv: (0, ladok_attributvarde_utils_1.extractString)(courseInstance.instans.Attributvarden, 'utbildning.attribut.svensk.benamning'),
         en: (0, ladok_attributvarde_utils_1.extractString)(courseInstance.instans.Attributvarden, 'utbildning.attribut.engelsk.benamning'),
@@ -26,6 +27,8 @@ const mapKursTillfalleResult = (courseInstance, language) => {
     const schoolCode = (0, schoolUtil_1.extractSchoolCodeFromOrganisation)(organisation, language);
     const omfattning = (_b = (0, ladok_attributvarde_utils_1.extractString)(courseInstance.instans.Attributvarden, 'utbildning.attribut.omfattning', 'omfattning')) !== null && _b !== void 0 ? _b : '';
     const isMiljo = (0, ladok_attributvarde_utils_1.extractIsMiljo)(courseInstance.instans.Attributvarden);
+    const kthPeriods = (0, getKTHPeriodSemesters_1.getKTHPeriodSemesters)(courseInstance.Tillfallesperioder, periodItems);
+    const startingKTHPeriod = kthPeriods.at(0);
     return {
         versionsnummer: (0, ladok_attributvarde_utils_1.extractVersionNumber)(courseInstance.instans.Attributvarden),
         kod: (0, ladok_attributvarde_utils_1.extractString)(courseInstance.instans.Attributvarden, 'utbildning.attribut.kod'),
@@ -44,24 +47,12 @@ const mapKursTillfalleResult = (courseInstance, language) => {
             code: startperiod.code,
             inDigits: (0, utils_1.transformPeriodInDigits)(startperiod.code),
         },
-        period: {
-            startperiod: (startperiod === null || startperiod === void 0 ? void 0 : startperiod.code) || '',
-            forstaUndervisningsdatum: Object.assign({ date: (_d = courseInstance.Tillfallesperioder.at(0)) === null || _d === void 0 ? void 0 : _d.ForstaUndervisningsdatum, period: (0, utils_1.getKthStudyPeriod)(new Date((_e = courseInstance.Tillfallesperioder.at(0)) === null || _e === void 0 ? void 0 : _e.ForstaUndervisningsdatum), {
-                    code: startperiod === null || startperiod === void 0 ? void 0 : startperiod.code,
-                    startDate: startperiod && new Date(startperiod.startDay),
-                    endDate: startperiod && new Date(startperiod.lastDay),
-                }, 'start') }, (0, utils_1.getYearAndWeek)((_f = courseInstance.Tillfallesperioder.at(0)) === null || _f === void 0 ? void 0 : _f.ForstaUndervisningsdatum)),
-            sistaUndervisningsdatum: Object.assign({ date: (_g = courseInstance.Tillfallesperioder.at(-1)) === null || _g === void 0 ? void 0 : _g.SistaUndervisningsdatum, period: (0, utils_1.getKthStudyPeriod)(new Date((_h = courseInstance.Tillfallesperioder.at(-1)) === null || _h === void 0 ? void 0 : _h.SistaUndervisningsdatum), {
-                    code: startperiod === null || startperiod === void 0 ? void 0 : startperiod.code,
-                    startDate: startperiod && new Date(startperiod.startDay),
-                    endDate: startperiod && new Date(startperiod.lastDay),
-                }, 'end') }, (0, utils_1.getYearAndWeek)((_j = courseInstance.Tillfallesperioder.at(-1)) === null || _j === void 0 ? void 0 : _j.SistaUndervisningsdatum)),
-            tillfallesperioderNummer: courseInstance.Tillfallesperioder.length,
-        },
+        kthPeriods,
+        startingKTHPeriod,
         schoolCode,
         isMiljo,
         status: (0, ladok_attributvarde_utils_1.extractLadokStatus)(courseInstance.Attributvarden),
     };
 };
-exports.mapKursTillfalleResult = mapKursTillfalleResult;
-//# sourceMappingURL=mapSearchResult.js.map
+exports.mapCourseInstanceResult = mapCourseInstanceResult;
+//# sourceMappingURL=mapCourseInstanceResult.js.map

package/dist/mapCourseInstanceResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapCourseInstanceResult.js","sourceRoot":"","sources":["../src/mapCourseInstanceResult.ts"],"names":[],"mappings":"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"}

package/dist/report/createReportApi.d.ts

@@ -0,0 +1,3 @@
+import { LadokMellanlagerApiClient } from '@kth/ladok-mellanlager-client';
+import { ReportApi } from './types';
+export declare const createReportApi: (ladokClient: LadokMellanlagerApiClient) => ReportApi;

package/dist/report/createReportApi.js

@@ -0,0 +1,22 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReportApi = void 0;
+const getSchedulingReport_1 = require("./getSchedulingReport");
+const createReportApi = (ladokClient) => {
+    return {
+        getSemesterCoursesGroupedByProgramme: (semester, language) => __awaiter(void 0, void 0, void 0, function* () {
+            return (0, getSchedulingReport_1.getSemesterCoursesGroupedByProgramme)(ladokClient, semester, language);
+        }),
+    };
+};
+exports.createReportApi = createReportApi;
+//# sourceMappingURL=createReportApi.js.map

package/dist/report/createReportApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReportApi.js","sourceRoot":"","sources":["../../src/report/createReportApi.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,+DAA4E;AAErE,MAAM,eAAe,GAAG,CAAC,WAAsC,EAAa,EAAE;IACnF,OAAO;QACL,oCAAoC,EAAE,CAAO,QAAQ,EAAE,QAAQ,EAAE,EAAE;YACjE,OAAO,IAAA,0DAAoC,EAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QAC9E,CAAC,CAAA;KACF,CAAA;AACH,CAAC,CAAA;AANY,QAAA,eAAe,mBAM3B"}

package/dist/report/getSchedulingReport.d.ts

@@ -0,0 +1,4 @@
+import { LadokMellanlagerApiClient } from '@kth/ladok-mellanlager-client';
+import { Language } from '../utils/languageUtil';
+import { SchedulingReport } from './types';
+export declare const getSemesterCoursesGroupedByProgramme: (ladokClient: LadokMellanlagerApiClient, semester: string, language: Language) => Promise<SchedulingReport>;

package/dist/report/getSchedulingReport.js

@@ -0,0 +1,228 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSemesterCoursesGroupedByProgramme = void 0;
+const getAllEntitiesByUseOfContinuation_1 = require("../utils/getAllEntitiesByUseOfContinuation");
+const responseUtils_1 = require("../utils/responseUtils");
+const partOfProgrammeUtil_1 = require("../utils/partOfProgrammeUtil");
+const attributVardenConstants_1 = require("../attributVardenConstants");
+const queryConstants_1 = require("../queryConstants");
+const mapCourseInstanceToSchedulingReportCourse_1 = require("./mapCourseInstanceToSchedulingReportCourse");
+const periodUtil_1 = require("../utils/periodUtil");
+const programmeStructureUtil_1 = require("../utils/programmeStructureUtil");
+const COURSE_UTBILDNINGSTYP_IDS = '52,101955,101382,101994,102008';
+/*
+ ** 2007KTF – 52
+ ** 2007FKTF – 101955
+ ** FUPKTF – 101382
+ ** UPHPKTF – 101994
+ ** UPVKTF – 102008
+ */
+// Common base query parameters for all search phases
+const BASE_SEARCH_QUERY = {
+    kodEllerBenamning: '*',
+    attributVarden: attributVardenConstants_1.ATTRIBUT_VARDEN_FOR_COURSE_INSTANCES_SCHEDULING,
+    instansAttributVarden: attributVardenConstants_1.INSTANS_ATTRIBUT_VARDEN_FOR_COURSE_INSTANCES_SCHEDULING,
+    antalTraffar: queryConstants_1.MAX_ANTAL_TRAFFAR,
+    utbildningstypgrundtyp: 'KURS',
+    utbildningstypid: COURSE_UTBILDNINGSTYP_IDS,
+};
+// Common continuation options for all search phases
+const SEARCH_CONTINUATION_OPTIONS = {
+    maxSearchResultsToReturn: 10000,
+    maxContinuationIterations: 500,
+};
+const getSemesterDates = (semesterCode, periods) => {
+    const period = (0, periodUtil_1.findPeriodByKod)(semesterCode, periods);
+    if (!period) {
+        throw new Error(`Period not found for semester code: ${semesterCode}`);
+    }
+    return {
+        startDate: period.Giltighetsperiod.Startdatum,
+        endDate: period.Giltighetsperiod.Slutdatum,
+    };
+};
+const getSemesterCoursesGroupedByProgramme = (ladokClient, semester, language) => __awaiter(void 0, void 0, void 0, function* () {
+    const overallStartTime = Date.now();
+    const periods = yield ladokClient.period();
+    const periodsData = (0, responseUtils_1.throwIfError)(periods);
+    const { startDate, endDate } = getSemesterDates(semester, periodsData.Period);
+    // Map to deduplicate course instances by tillfalle_uid
+    const entityMap = new Map();
+    // PHASE 1 – PRIMARY SEARCH (STARTPERIOD-BASED)
+    console.log(`Phase 1: Primary search with startPeriod=${semester}`);
+    const phase1StartTime = Date.now();
+    const phase1Result = yield (0, getAllEntitiesByUseOfContinuation_1.getAllEntitiesByUseOfContinuation)(ladokClient.sokKursTillfalleSlim, Object.assign(Object.assign({}, BASE_SEARCH_QUERY), { startPeriod: semester }), SEARCH_CONTINUATION_OPTIONS);
+    const phase1Entities = (0, responseUtils_1.throwIfContinuationError)(phase1Result);
+    phase1Entities.forEach(entity => {
+        entityMap.set(entity.tillfalle_uid, entity);
+    });
+    const phase1Duration = ((Date.now() - phase1StartTime) / 1000).toFixed(2);
+    console.log(`Phase 1: Found ${phase1Entities.length} course instances (${phase1Duration}s)`);
+    // PHASE 2 – SAFETY NET SEARCH (ONGOING AT SEMESTER START)
+    console.log(`Phase 2: Safety net search at semester start (${startDate})`);
+    const phase2StartTime = Date.now();
+    const phase2Result = yield (0, getAllEntitiesByUseOfContinuation_1.getAllEntitiesByUseOfContinuation)(ladokClient.sokKursTillfalleSlim, Object.assign(Object.assign({}, BASE_SEARCH_QUERY), { pagaendeDatum: startDate }), SEARCH_CONTINUATION_OPTIONS);
+    const phase2Entities = (0, responseUtils_1.throwIfContinuationError)(phase2Result);
+    let phase2NewCount = 0;
+    phase2Entities.forEach(entity => {
+        if (!entityMap.has(entity.tillfalle_uid)) {
+            entityMap.set(entity.tillfalle_uid, entity);
+            phase2NewCount++;
+        }
+    });
+    const phase2Duration = ((Date.now() - phase2StartTime) / 1000).toFixed(2);
+    console.log(`Phase 2: Found ${phase2Entities.length} total, ${phase2NewCount} new course instances (${phase2Duration}s)`);
+    // PHASE 3 – SAFETY NET SEARCH (ONGOING AT SEMESTER END)
+    console.log(`Phase 3: Safety net search at semester end (${endDate})`);
+    const phase3StartTime = Date.now();
+    const phase3Result = yield (0, getAllEntitiesByUseOfContinuation_1.getAllEntitiesByUseOfContinuation)(ladokClient.sokKursTillfalleSlim, Object.assign(Object.assign({}, BASE_SEARCH_QUERY), { pagaendeDatum: endDate }), SEARCH_CONTINUATION_OPTIONS);
+    const phase3Entities = (0, responseUtils_1.throwIfContinuationError)(phase3Result);
+    let phase3NewCount = 0;
+    phase3Entities.forEach(entity => {
+        if (!entityMap.has(entity.tillfalle_uid)) {
+            entityMap.set(entity.tillfalle_uid, entity);
+            phase3NewCount++;
+        }
+    });
+    const phase3Duration = ((Date.now() - phase3StartTime) / 1000).toFixed(2);
+    console.log(`Phase 3: Found ${phase3Entities.length} total, ${phase3NewCount} new course instances (${phase3Duration}s)`);
+    // AFTER ALL THREE PHASES - Convert to array
+    const allEntities = Array.from(entityMap.values());
+    const totalSearchDuration = ((Date.now() - overallStartTime) / 1000).toFixed(2);
+    console.log(`Total unique course instances after deduplication: ${allEntities.length} (Total search time: ${totalSearchDuration}s)`);
+    // Get programme associations
+    console.log('Fetching programme associations...');
+    const partOfProgrammesStartTime = Date.now();
+    const partOfProgrammes = yield (0, partOfProgrammeUtil_1.getPartOfProgrammes)(allEntities, periodsData.Period, ladokClient, true);
+    const partOfProgrammesDuration = ((Date.now() - partOfProgrammesStartTime) / 1000).toFixed(2);
+    console.log(`Programme associations fetched in ${partOfProgrammesDuration}s`);
+    const coursesWithProgrammes = allEntities.map(entity => (0, mapCourseInstanceToSchedulingReportCourse_1.mapCourseInstanceToSchedulingReportCourse)(entity, language, partOfProgrammes[entity.tillfalle_uid] || [], periodsData.Period));
+    // Categorize courses by programme
+    const { programmes, standaloneCourses } = categorizeCoursesByProgramme(coursesWithProgrammes);
+    return {
+        programmes,
+        standaloneCourses,
+    };
+});
+exports.getSemesterCoursesGroupedByProgramme = getSemesterCoursesGroupedByProgramme;
+/**
+ * Categorize courses by programme or as standalone courses.
+ * Courses are grouped by programme code, and courses without programmes are kept separate.
+ */
+const categorizeCoursesByProgramme = (courses) => {
+    const programmeMap = new Map();
+    const standaloneCourses = [];
+    courses.forEach(course => {
+        if (!course.partOfProgrammes || course.partOfProgrammes.length === 0) {
+            // Course is not part of any programme - "Fristående kurs"
+            standaloneCourses.push(course);
+        }
+        else {
+            // Course is part of one or more programmes
+            course.partOfProgrammes.forEach((programme) => {
+                if (!programmeMap.has(programme.kod)) {
+                    programmeMap.set(programme.kod, {
+                        programmeCode: programme.kod,
+                        programmeName: programme.benamning,
+                        courses: [],
+                    });
+                }
+                const programmeGroup = programmeMap.get(programme.kod);
+                // Create course entry for this programme with only the programme-specific partOfProgrammes
+                const courseInProgramme = {
+                    kod: course.kod,
+                    benamning: course.benamning,
+                    omfattning: course.omfattning,
+                    tillfalleskod: course.tillfalleskod,
+                    startperiod: course.startperiod,
+                    organisation: course.organisation,
+                    finansieringsform: course.finansieringsform,
+                    utbildningsplatser: course.utbildningsplatser,
+                    status: course.status,
+                    connectedProgrammes: course.connectedProgrammes,
+                    weeks: course.weeks,
+                    kthPeriods: course.kthPeriods,
+                    studietakt: course.studietakt,
+                    utbildningstyp: course.utbildningstyp,
+                    // Include only this specific programme's context
+                    partOfProgrammes: [programme],
+                };
+                programmeGroup.courses.push(courseInProgramme);
+            });
+        }
+    });
+    // Convert map to array and sort courses within each programme
+    const programmes = Array.from(programmeMap.values()).map(group => (Object.assign(Object.assign({}, group), { courses: sortCoursesForProgramme(group.courses) })));
+    // Sort programme groups by programme code
+    programmes.sort((a, b) => a.programmeCode.localeCompare(b.programmeCode));
+    return {
+        programmes,
+        standaloneCourses,
+    };
+};
+/**
+ * Sort courses within a programme by:
+ * 1. Study year (ascending)
+ * 2. Common (shared) courses first, then specialisation-specific courses
+ * 3. Course-type priority: Compulsory -> Conditionally elective -> Elective -> Recommended
+ * 4. Course code (alphabetically)
+ */
+const sortCoursesForProgramme = (courses) => {
+    const valinfoRank = (part) => {
+        if (!part)
+            return 0;
+        const desc = part.sv && part.sv.trim().length > 0 ? part.sv : part.en;
+        const category = (0, programmeStructureUtil_1.getCategory)(desc);
+        switch (category) {
+            case programmeStructureUtil_1.ValvillkorCategory.O:
+                return 0;
+            case programmeStructureUtil_1.ValvillkorCategory.VV:
+                return 1;
+            case programmeStructureUtil_1.ValvillkorCategory.V:
+                return 2;
+            case programmeStructureUtil_1.ValvillkorCategory.R:
+                return 3;
+            default:
+                return 0;
+        }
+    };
+    return courses.sort((a, b) => {
+        var _a, _b, _c, _d, _e, _f;
+        const aPart = (_a = a.partOfProgrammes) === null || _a === void 0 ? void 0 : _a[0];
+        const bPart = (_b = b.partOfProgrammes) === null || _b === void 0 ? void 0 : _b[0];
+        const aStudyYear = (_c = aPart === null || aPart === void 0 ? void 0 : aPart.arskurs) !== null && _c !== void 0 ? _c : 0;
+        const bStudyYear = (_d = bPart === null || bPart === void 0 ? void 0 : bPart.arskurs) !== null && _d !== void 0 ? _d : 0;
+        // 1) Study year ascending
+        if (aStudyYear !== bStudyYear)
+            return aStudyYear - bStudyYear;
+        // 2) Common (shared) courses first (no inriktning)
+        const aIsShared = !(aPart === null || aPart === void 0 ? void 0 : aPart.inriktning);
+        const bIsShared = !(bPart === null || bPart === void 0 ? void 0 : bPart.inriktning);
+        if (aIsShared !== bIsShared)
+            return aIsShared ? -1 : 1;
+        // If both are specialisation courses, group by inriktning code
+        if (!aIsShared && !bIsShared) {
+            const aInr = (_e = aPart === null || aPart === void 0 ? void 0 : aPart.inriktning) !== null && _e !== void 0 ? _e : '';
+            const bInr = (_f = bPart === null || bPart === void 0 ? void 0 : bPart.inriktning) !== null && _f !== void 0 ? _f : '';
+            if (aInr !== bInr)
+                return aInr.localeCompare(bInr);
+        }
+        // 3) Course-type priority
+        const aValRank = valinfoRank(aPart === null || aPart === void 0 ? void 0 : aPart.valinformation);
+        const bValRank = valinfoRank(bPart === null || bPart === void 0 ? void 0 : bPart.valinformation);
+        if (aValRank !== bValRank)
+            return aValRank - bValRank;
+        // 4) Finally, sort alphabetically by course code
+        return a.kod.localeCompare(b.kod);
+    });
+};
+//# sourceMappingURL=getSchedulingReport.js.map

package/dist/report/getSchedulingReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getSchedulingReport.js","sourceRoot":"","sources":["../../src/report/getSchedulingReport.ts"],"names":[],"mappings":"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"}

package/dist/report/index.d.ts

@@ -0,0 +1,4 @@
+export { getSemesterCoursesGroupedByProgramme } from './getSchedulingReport';
+export { mapCourseInstanceToSchedulingReportCourse } from './mapCourseInstanceToSchedulingReportCourse';
+export { createReportApi } from './createReportApi';
+export type { ReportApi, SchedulingReport, SchedulingReportProgramme, SchedulingReportCourse } from './types';

package/dist/report/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReportApi = exports.mapCourseInstanceToSchedulingReportCourse = exports.getSemesterCoursesGroupedByProgramme = void 0;
+var getSchedulingReport_1 = require("./getSchedulingReport");
+Object.defineProperty(exports, "getSemesterCoursesGroupedByProgramme", { enumerable: true, get: function () { return getSchedulingReport_1.getSemesterCoursesGroupedByProgramme; } });
+var mapCourseInstanceToSchedulingReportCourse_1 = require("./mapCourseInstanceToSchedulingReportCourse");
+Object.defineProperty(exports, "mapCourseInstanceToSchedulingReportCourse", { enumerable: true, get: function () { return mapCourseInstanceToSchedulingReportCourse_1.mapCourseInstanceToSchedulingReportCourse; } });
+var createReportApi_1 = require("./createReportApi");
+Object.defineProperty(exports, "createReportApi", { enumerable: true, get: function () { return createReportApi_1.createReportApi; } });
+//# sourceMappingURL=index.js.map

package/dist/report/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":";;;AAAA,6DAA4E;AAAnE,2IAAA,oCAAoC,OAAA;AAC7C,yGAAuG;AAA9F,sKAAA,yCAAyC,OAAA;AAClD,qDAAmD;AAA1C,kHAAA,eAAe,OAAA"}

package/dist/report/mapCourseInstanceToSchedulingReportCourse.d.ts

@@ -0,0 +1,14 @@
+import { SokUtbildningsTillfalleSlimItem, PeriodItem } from '@kth/ladok-mellanlager-client';
+import { Language } from '../utils/languageUtil';
+import { PartOfProgramme } from '../mapPartOfProgramme';
+import { SchedulingReportCourse } from './types';
+/**
+ * Map a course instance entity to CourseInstanceWithProgrammes with scheduling information.
+ *
+ * @param entity - The course instance entity from Ladok
+ * @param language - Language for text fields ('sv' or 'en')
+ * @param partOfProgrammes - Programme associations for this course instance
+ * @param periodItems - Period definitions for KTH period calculation (optional)
+ * @returns Mapped course instance with extended scheduling information
+ */
+export declare const mapCourseInstanceToSchedulingReportCourse: (entity: SokUtbildningsTillfalleSlimItem, language: Language, partOfProgrammes: PartOfProgramme[], periodItems?: PeriodItem[]) => SchedulingReportCourse;

package/dist/report/mapCourseInstanceToSchedulingReportCourse.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapCourseInstanceToSchedulingReportCourse = void 0;
+const ladok_attributvarde_utils_1 = require("@kth/ladok-attributvarde-utils");
+const utils_1 = require("../utils");
+const creditsUtil_1 = require("../utils/creditsUtil");
+const getKTHPeriodSemesters_1 = require("../kth/KTHPeriod/getKTHPeriodSemesters");
+/**
+ * Map a course instance entity to CourseInstanceWithProgrammes with scheduling information.
+ *
+ * @param entity - The course instance entity from Ladok
+ * @param language - Language for text fields ('sv' or 'en')
+ * @param partOfProgrammes - Programme associations for this course instance
+ * @param periodItems - Period definitions for KTH period calculation (optional)
+ * @returns Mapped course instance with extended scheduling information
+ */
+const mapCourseInstanceToSchedulingReportCourse = (entity, language, partOfProgrammes, periodItems) => {
+    var _a, _b, _c, _d;
+    const attributeValues = entity.Attributvarden;
+    const instansAttributeValues = entity.instans.Attributvarden;
+    // Extract basic course information
+    const kod = (0, ladok_attributvarde_utils_1.extractString)(instansAttributeValues, 'utbildning.attribut.kod');
+    const benamning = {
+        sv: (0, ladok_attributvarde_utils_1.extractString)(instansAttributeValues, 'utbildning.attribut.svensk.benamning'),
+        en: (0, ladok_attributvarde_utils_1.extractString)(instansAttributeValues, 'utbildning.attribut.engelsk.benamning'),
+    };
+    const omfattningValue = (_a = (0, ladok_attributvarde_utils_1.extractString)(instansAttributeValues, 'utbildning.attribut.omfattning', 'omfattning')) !== null && _a !== void 0 ? _a : '';
+    const utbildningstyp = (0, ladok_attributvarde_utils_1.extractUtbildningstyp)(instansAttributeValues);
+    const studietakt = (0, ladok_attributvarde_utils_1.extractStudietakt)(attributeValues);
+    // Extract scheduling-specific fields
+    const organisation = (0, ladok_attributvarde_utils_1.extractOrganisation)(attributeValues);
+    const finansieringsform = (0, ladok_attributvarde_utils_1.extractGrunddata)(attributeValues, 'utbildning.attribut.finansieringsform');
+    const tillfalleskod = (0, ladok_attributvarde_utils_1.extractString)(attributeValues, 'utbildning.attribut.utbildningstillfalleskod');
+    const utbildningsplatser = (0, ladok_attributvarde_utils_1.extractUtbildningsplatser)(attributeValues);
+    const status = (0, ladok_attributvarde_utils_1.extractLadokStatus)(attributeValues);
+    const startperiod = (0, ladok_attributvarde_utils_1.extractStartPeriod)(attributeValues);
+    // Extract teaching dates
+    const forstaUndervisningsdatum = (_b = entity.Tillfallesperioder.at(0)) === null || _b === void 0 ? void 0 : _b.ForstaUndervisningsdatum;
+    const sistaUndervisningsdatum = (_c = entity.Tillfallesperioder.at(-1)) === null || _c === void 0 ? void 0 : _c.SistaUndervisningsdatum;
+    const forstaDate = forstaUndervisningsdatum
+        ? Object.assign({ date: forstaUndervisningsdatum }, (0, utils_1.getYearAndWeek)(forstaUndervisningsdatum)) : undefined;
+    const sistaDate = sistaUndervisningsdatum
+        ? Object.assign({ date: sistaUndervisningsdatum }, (0, utils_1.getYearAndWeek)(sistaUndervisningsdatum)) : undefined;
+    const weeks = forstaDate && sistaDate
+        ? forstaDate.year === sistaDate.year
+            ? `${forstaDate.year} week ${forstaDate.week} - week ${sistaDate.week}`
+            : `${forstaDate.year} week ${forstaDate.week} - ${sistaDate.year} week ${sistaDate.week}`
+        : undefined;
+    const kthPeriods = periodItems && entity.Tillfallesperioder ? (0, getKTHPeriodSemesters_1.getKTHPeriodSemesters)(entity.Tillfallesperioder, periodItems) : [];
+    // Build formatted connected programmes string from `partOfProgrammes`.
+    // Group by programme code AND year, collect specialisations (inriktning) for each combination.
+    const connectedProgrammes = (() => {
+        if (!partOfProgrammes || partOfProgrammes.length === 0)
+            return undefined;
+        // Map key: "CODE_YEAR" -> { hasMain, specialisations }
+        const map = new Map();
+        partOfProgrammes.forEach(p => {
+            const year = p.arskurs || 0;
+            const key = `${p.kod}_${year}`;
+            const entry = map.get(key) || { kod: p.kod, arskurs: year, hasMain: false, specialisations: [] };
+            if (p.inriktning) {
+                if (!entry.specialisations.includes(p.inriktning))
+                    entry.specialisations.push(p.inriktning);
+            }
+            else {
+                entry.hasMain = true;
+            }
+            map.set(key, entry);
+        });
+        const parts = [];
+        for (const info of map.values()) {
+            const yearSuffix = info.arskurs ? `${info.arskurs}` : '';
+            const specials = info.hasMain ? ['-'].concat(info.specialisations) : info.specialisations;
+            const bracket = specials.length > 0 ? ` [${specials.join(', ')}]` : '';
+            // Format: CODE{YEAR} [BRACKET]
+            parts.push(`${info.kod}${yearSuffix}${bracket}`);
+        }
+        const result = parts.join(', ');
+        return result.length > 0 ? result : undefined;
+    })();
+    return {
+        kod,
+        benamning: (_d = benamning[language]) !== null && _d !== void 0 ? _d : '',
+        omfattning: (0, creditsUtil_1.formatCreditsWithUnitLabel)(omfattningValue, utbildningstyp, language),
+        utbildningstyp: utbildningstyp ? (0, utils_1.translateUtbildningstyp)(utbildningstyp, language).name : '',
+        studietakt: studietakt ? (0, utils_1.translateStudietakt)(studietakt, language) : undefined,
+        partOfProgrammes,
+        tillfalleskod,
+        startperiod: startperiod
+            ? {
+                code: startperiod.code,
+                inDigits: (0, utils_1.transformPeriodInDigits)(startperiod.code),
+            }
+            : undefined,
+        organisation: organisation
+            ? {
+                kod: (0, utils_1.translateOrganisation)(organisation, language).code,
+                benamning: (0, utils_1.translateOrganisation)(organisation, language).name,
+                organisationType: (0, utils_1.translateOrganisation)(organisation, language).organisationTypeName,
+            }
+            : undefined,
+        finansieringsform: finansieringsform ? (0, utils_1.translateGrunddata)(finansieringsform, language) : undefined,
+        utbildningsplatser,
+        status,
+        connectedProgrammes,
+        weeks,
+        kthPeriods: kthPeriods.length > 0 ? kthPeriods : undefined,
+    };
+};
+exports.mapCourseInstanceToSchedulingReportCourse = mapCourseInstanceToSchedulingReportCourse;
+//# sourceMappingURL=mapCourseInstanceToSchedulingReportCourse.js.map

package/dist/report/mapCourseInstanceToSchedulingReportCourse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapCourseInstanceToSchedulingReportCourse.js","sourceRoot":"","sources":["../../src/report/mapCourseInstanceToSchedulingReportCourse.ts"],"names":[],"mappings":"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"}

package/dist/report/types.d.ts

@@ -0,0 +1,33 @@
+import { Language } from '../utils';
+import { PartOfProgramme } from '../mapPartOfProgramme';
+import { CourseInstance } from '../mapCourseInstance';
+import { KTHPeriodSemester } from '../kth/KTHPeriod/KTHPeriod';
+export type ReportApi = {
+    getSemesterCoursesGroupedByProgramme: (semester: string, language: Language) => Promise<SchedulingReport>;
+};
+export type SchedulingReportCourse = Pick<CourseInstance, 'tillfalleskod' | 'startperiod' | 'finansieringsform' | 'utbildningsplatser' | 'status' | 'studietakt' | 'utbildningstyp'> & {
+    kod: string;
+    benamning: string;
+    omfattning: string;
+    organisation?: {
+        kod: string;
+        benamning: string;
+        organisationType?: string;
+    };
+    weeks?: string;
+    kthPeriods?: KTHPeriodSemester[];
+    partOfProgrammes?: PartOfProgramme[];
+    connectedProgrammes?: string;
+};
+export type SchedulingReportProgramme = {
+    programmeCode: string;
+    programmeName: {
+        sv: string;
+        en: string;
+    };
+    courses: SchedulingReportCourse[];
+};
+export type SchedulingReport = {
+    programmes: SchedulingReportProgramme[];
+    standaloneCourses: SchedulingReportCourse[];
+};

package/dist/report/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/report/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/report/types.ts"],"names":[],"mappings":""}