@citolab/qti-backend-firebase 0.0.3 → 0.0.5

package/dist/helpers/excel-helper.js

@@ -0,0 +1,150 @@
+import Excel from "exceljs";
+export class ExcelHelper {
+    filename;
+    worksheetName;
+    workbook = new Excel.Workbook();
+    worksheet = undefined;
+    columnsByIndex = new Map();
+    columnsByName = new Map();
+    rows = [];
+    constructor(filename, worksheetName) {
+        this.filename = filename;
+        this.worksheetName = worksheetName;
+    }
+    async save() {
+        await this.workbook.xlsx.writeFile(this.filename);
+    }
+    async init() {
+        await this.workbook.xlsx.readFile(this.filename);
+        if (this.worksheetName) {
+            this.workbook.worksheets.forEach((w) => {
+                if (w.name === this.worksheetName) {
+                    this.worksheet = w;
+                }
+            });
+        }
+        else {
+            this.worksheet = this.workbook.getWorksheet(1);
+        }
+        if (!this.worksheet) {
+            throw new Error(`Worksheet ${this.worksheetName} not found in file ${this.filename}`);
+        }
+        this.worksheet.getRow(1).eachCell((cell, colNumber) => {
+            if (cell.value?.toString()) {
+                this.columnsByIndex.set(colNumber, cell.value.toString().toLowerCase());
+                this.columnsByName.set(cell.value.toString().toLowerCase(), colNumber);
+            }
+        });
+        // this loads the rows
+        this.clearFilter();
+    }
+    getCellValue(row, key) {
+        const cellKey = this.columnsByName.get(key);
+        if (!cellKey) {
+            console.error(`Column ${key} not found in worksheet`);
+            return "";
+        }
+        return row.getCell(cellKey).value?.toString() || "";
+    }
+    uniqueValuesInColumn(key) {
+        const values = [];
+        const columnIndex = this.columnsByName.get(key);
+        if (!this.worksheet || !columnIndex) {
+            return values;
+        }
+        this.worksheet.eachRow((row, rowNumber) => {
+            if (rowNumber === 1)
+                return;
+            const value = row.getCell(columnIndex)?.value || "";
+            if (!value)
+                return;
+            if (!values.includes(value.toString())) {
+                values.push(value.toString());
+            }
+        });
+        return values;
+    }
+    clearFilter() {
+        if (!this.worksheet) {
+            throw new Error("Worksheet not initialized");
+        }
+        this.rows = Array.from(this.worksheet.getRows(2, this.worksheet.rowCount - 1) || []).map((r) => new ExcelHelperRow(r, this.columnsByName));
+    }
+    filterSheetByColumnValue(filter) {
+        const filterWithColumnNumber = filter.map(({ columnName, value }) => {
+            const columnNumber = this.columnsByName.get(columnName.toLowerCase());
+            return { columnNumber, value, columnName };
+        });
+        // get the rows with column Packagenaam = bb-bi-22-examenvariant-1
+        const filteredRows = [];
+        if (!this.worksheet) {
+            throw new Error("Worksheet not initialized");
+        }
+        this.worksheet.eachRow((row, rowNumber) => {
+            let matchesFilter = true;
+            for (const { columnNumber, value } of filterWithColumnNumber) {
+                if (columnNumber === undefined || columnNumber === null) {
+                    console.error(`Column ${columnNumber} not found in worksheet`);
+                    matchesFilter = false;
+                    break;
+                }
+                if (row.getCell(columnNumber).value?.toString() !== value?.toString()) {
+                    matchesFilter = false;
+                    break;
+                }
+            }
+            if (matchesFilter) {
+                filteredRows.push(row);
+            }
+        });
+        this.rows = filteredRows.map((r) => new ExcelHelperRow(r, this.columnsByName));
+    }
+}
+export class ExcelHelperRow {
+    row;
+    columnsByName;
+    constructor(row, columnsByName) {
+        this.row = row;
+        this.columnsByName = columnsByName;
+    }
+    getValue(key) {
+        if (!this.columnsByName.get(key.toLowerCase())) {
+            console.error(`Column ${key} not found in row ${this.row.number}`);
+            return "";
+        }
+        if (!key) {
+            return "";
+        }
+        const columnName = this.columnsByName.get(key.toLowerCase());
+        if (!columnName) {
+            return "";
+        }
+        const cellValue = this.row.getCell(columnName)?.value;
+        const value = cellValue?.text
+            ? cellValue.text
+            : cellValue?.toString() || "";
+        return value === "[object Object]" ? "" : value;
+    }
+    getNumericValue(key) {
+        const value = this.getValue(key);
+        try {
+            const number = parseFloat(value);
+            if (isNaN(number)) {
+                return null;
+            }
+            return number;
+        }
+        catch (e) {
+            return null;
+        }
+    }
+    setValue = (key, value) => {
+        const columnName = this.columnsByName.get(key.toLowerCase());
+        if (!columnName) {
+            console.error(`Column ${key} not found in row ${this.row.number}`);
+            return;
+        }
+        this.row.getCell(columnName).value = value;
+    };
+}
+//# sourceMappingURL=excel-helper.js.map

package/dist/helpers/excel-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-helper.js","sourceRoot":"","sources":["../../src/helpers/excel-helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,MAAM,OAAO,WAAW;IAMF;IAA0B;IAL9C,QAAQ,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;IAChC,SAAS,GAAgC,SAAS,CAAC;IACnD,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,IAAI,GAAqB,EAAE,CAAC;IAC5B,YAAoB,QAAgB,EAAU,aAAsB;QAAhD,aAAQ,GAAR,QAAQ,CAAQ;QAAU,kBAAa,GAAb,aAAa,CAAS;IAAG,CAAC;IAExE,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBACrC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;oBAClC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,aAAa,IAAI,CAAC,aAAa,sBAAsB,IAAI,CAAC,QAAQ,EAAE,CACrE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE;YACpD,IAAI,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC;gBAC3B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;gBACxE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;YACzE,CAAC;QACH,CAAC,CAAC,CAAC;QACH,sBAAsB;QACtB,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,YAAY,CAAC,GAAc,EAAE,GAAW;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,yBAAyB,CAAC,CAAC;YACtD,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACtD,CAAC;IAED,oBAAoB,CAAC,GAAW;QAC9B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE;YACxC,IAAI,SAAS,KAAK,CAAC;gBAAE,OAAO;YAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;YACpD,IAAI,CAAC,KAAK;gBAAE,OAAO;YACnB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YAChC,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW;QACT,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CACpB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,EAAE,CAC7D,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,wBAAwB,CAAC,MAA+C;QACtE,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;YAClE,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;YACtE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAC7C,CAAC,CAAC,CAAC;QACH,kEAAkE;QAClE,MAAM,YAAY,GAAgB,EAAE,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE;YACxC,IAAI,aAAa,GAAG,IAAI,CAAC;YACzB,KAAK,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,sBAAsB,EAAE,CAAC;gBAC7D,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;oBACxD,OAAO,CAAC,KAAK,CAAC,UAAU,YAAY,yBAAyB,CAAC,CAAC;oBAC/D,aAAa,GAAG,KAAK,CAAC;oBACtB,MAAM;gBACR,CAAC;gBACD,IAAI,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC;oBACtE,aAAa,GAAG,KAAK,CAAC;oBACtB,MAAM;gBACR,CAAC;YACH,CAAC;YACD,IAAI,aAAa,EAAE,CAAC;gBAClB,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,GAAG,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CACjD,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,cAAc;IAEf;IACA;IAFV,YACU,GAAc,EACd,aAAkC;QADlC,QAAG,GAAH,GAAG,CAAW;QACd,kBAAa,GAAb,aAAa,CAAqB;IACzC,CAAC;IAEJ,QAAQ,CAAC,GAAW;QAClB,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,qBAAqB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACnE,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,KAAY,CAAC;QAC7D,MAAM,KAAK,GAAG,SAAS,EAAE,IAAI;YAC3B,CAAC,CAAC,SAAS,CAAC,IAAI;YAChB,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QAChC,OAAO,KAAK,KAAK,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAClD,CAAC;IAED,eAAe,CAAC,GAAW;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,QAAQ,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,qBAAqB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC;IAC7C,CAAC,CAAC;CACH"}

package/dist/helpers/general.d.ts

@@ -0,0 +1,15 @@
+import { DATABASE } from "./database";
+import { IApplicationSpecific } from "../api/app-specific";
+export declare function syncStudentResultsToTeacher(specificImplementation: IApplicationSpecific, db: DATABASE, filterByIds?: string[]): Promise<void>;
+export declare function addUserByEmail(email: string, application: string, password: string | undefined, isAdmin: boolean | undefined, db: DATABASE): Promise<string>;
+export declare function manualScored(xml: string): boolean;
+export declare const getFolderNames: (parentFolder: string) => Promise<string[]>;
+interface UploadOptions {
+    checkForManualFix?: (filename: string) => Promise<string>;
+    overrideOther?: boolean;
+    overrideXml?: boolean;
+}
+export declare function uploadFolderToStorage(folder: string, storageDestinationPath: string, uploadFiles: Promise<unknown>[], options?: UploadOptions): Promise<void>;
+export declare function addAssessmentResources(backendUrl: string, db: DATABASE, specificImplementation: IApplicationSpecific): Promise<void>;
+export {};
+//# sourceMappingURL=general.d.ts.map

package/dist/helpers/general.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../src/helpers/general.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,wBAAsB,2BAA2B,CAC/C,sBAAsB,EAAE,oBAAoB,EAC5C,EAAE,EAAE,QAAQ,EACZ,WAAW,GAAE,MAAM,EAAO,iBAmD3B;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,QAAQ,oBAAK,EACb,OAAO,qBAAQ,EACf,EAAE,EAAE,QAAQ,mBAkCb;AAOD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,WAEvC;AAED,eAAO,MAAM,cAAc,GAAU,cAAc,MAAM,sBAWxD,CAAC;AAEF,UAAU,aAAa;IACrB,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,sBAAsB,EAAE,MAAM,EAC9B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAC/B,OAAO,GAAE,aAAkB,iBAkD5B;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,QAAQ,EACZ,sBAAsB,EAAE,oBAAoB,iBAqB7C"}

package/dist/helpers/general.js

@@ -0,0 +1,148 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import { getAuth, getFirestore, getStorage } from "../helpers/firebase";
+import fs from "fs/promises";
+import mime from "mime";
+import path from "path";
+export async function syncStudentResultsToTeacher(specificImplementation, db, filterByIds = []) {
+    const firestore = getFirestore();
+    const batch = firestore.batch();
+    const allSessionsReferences = await firestore
+        .collection(db.SESSION.COLLECTION())
+        .get();
+    const allSessions = allSessionsReferences.docs.map((d) => d.data());
+    // const applicationSpecific = getSpecificImplementation(applicationId);
+    for (const session of allSessions) {
+        const code = session.code;
+        if (filterByIds.length > 0 && !filterByIds.includes(code)) {
+            continue;
+        }
+        // const studentSessions = await firestore
+        //   .collection(db.SESSION.COLLECTION(code))
+        //   .get();
+        // for (const session of studentSessions.docs) {
+        const assessmentId = session.id;
+        const testContextRef = await firestore
+            .doc(db.SESSION.TEST_CONTEXT(code))
+            .get();
+        const testContext = testContextRef.exists
+            ? testContextRef.data()
+            : null;
+        if (!testContext) {
+            console.error(`No test context found for student ${code} assessment ${assessmentId}`);
+            continue;
+        }
+        if (!testContext.state) {
+            if (session.sessionState) {
+                testContext.state = session.sessionState;
+            }
+        }
+        await specificImplementation.testContextToTeacher(code, assessmentId, session.deliveryId, session.teacherId, testContext, batch);
+        await batch.commit();
+    }
+}
+export async function addUserByEmail(email, application, password = "", isAdmin = false, db) {
+    let emailVerifyLink = "";
+    const auth = getAuth();
+    // check if user exists
+    let user = null;
+    try {
+        user = await auth.getUserByEmail(email);
+    }
+    catch {
+        // not found results in an error
+    }
+    if (!user) {
+        user = await auth.createUser({
+            displayName: email.split("@")[0],
+            email,
+            password: password || generatePassword(),
+            emailVerified: true,
+        });
+        if (!password) {
+            emailVerifyLink = await auth.generatePasswordResetLink(email);
+        }
+    }
+    const firestore = getFirestore();
+    const docRef = firestore.doc(db.AUTH.CHECK_APP_RIGHTS(user.uid, application));
+    const doc = await docRef.get();
+    if (!doc.exists) {
+        await docRef.set({ email, userId: user.uid, application });
+    }
+    if (isAdmin) {
+        const userDoc = firestore.doc(db.AUTH.DOC(user.uid));
+        await userDoc.set({ admin: true });
+    }
+    return emailVerifyLink;
+}
+function generatePassword() {
+    const password = Math.random().toString(36).slice(-8);
+    return password;
+}
+export function manualScored(xml) {
+    return xml.includes('use="instructions" view="scorer">');
+}
+export const getFolderNames = async (parentFolder) => {
+    const folderNames = [];
+    const folderReader = await fs.readdir(parentFolder, {
+        withFileTypes: true,
+    });
+    for (const folder of folderReader) {
+        if (folder.isDirectory()) {
+            folderNames.push(`${parentFolder}/${folder.name}`);
+        }
+    }
+    return folderNames;
+};
+export async function uploadFolderToStorage(folder, storageDestinationPath, uploadFiles, options = {} // default empty object
+) {
+    const storage = getStorage();
+    const bucket = storage.bucket();
+    const files = await fs.readdir(folder);
+    for (const file of files) {
+        if (file === ".DS_Store") {
+            continue;
+        }
+        const filePath = `${folder}/${file}`;
+        const stat = await fs.stat(filePath);
+        if (stat.isDirectory()) {
+            // Recursively upload files in subfolder
+            await uploadFolderToStorage(filePath, `${storageDestinationPath}/${file}`, uploadFiles, options);
+        }
+        else {
+            console.log(`uploading ${filePath}`);
+            let fileToUpload = path.join(folder, file);
+            // Allow manual filename fix
+            if (options.checkForManualFix) {
+                fileToUpload = await options.checkForManualFix(fileToUpload);
+            }
+            const fileExtension = path.extname(file).toLowerCase();
+            if ((fileExtension === ".xml" && options.overrideXml === false) ||
+                (fileExtension !== ".xml" && options.overrideOther === false)) {
+                console.log(`Skipping ${filePath} due to override settings.`);
+                continue;
+            }
+            uploadFiles.push(bucket.upload(fileToUpload, {
+                destination: `${storageDestinationPath}/${file}`,
+                metadata: {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    contentType: mime.getType(file),
+                },
+            }));
+        }
+    }
+}
+export async function addAssessmentResources(backendUrl, db, specificImplementation) {
+    const fs = getFirestore();
+    const assessmentCollection = await fs
+        .collection(db.ASSESSMENT.COLLECTION())
+        .get();
+    const assessments = assessmentCollection.docs.map((d) => d.data());
+    const digitalAssessments = assessments.filter((a) => a.isDigital !== false);
+    const packageLocation = `packages`;
+    for (const assessment of digitalAssessments) {
+        await specificImplementation.convertPackageAndAddToDatabase(packageLocation, `${backendUrl}/${assessment.packageId}/`, backendUrl, {
+            examenId: assessment.id,
+        });
+    }
+}
+//# sourceMappingURL=general.js.map

package/dist/helpers/general.js.map

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

package/dist/helpers/index.d.ts

@@ -8,4 +8,6 @@ export * from "./firebase";
 export * from "./logic";
 export * from "./request-headers";
 export * from "./endpoint-helpers";
+export * from "./excel-helper";
+export * from "./resource-cache";
 //# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/dist/helpers/index.js

@@ -8,4 +8,6 @@ export * from "./firebase";
 export * from "./logic";
 export * from "./request-headers";
 export * from "./endpoint-helpers";
+export * from "./excel-helper";
+export * from "./resource-cache";
 //# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC;AACrB,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC"}

package/dist/helpers/logic.d.ts

@@ -1,38 +1,54 @@
 import { DATABASE } from "./database";
-import { ApplicationInfo, ApplicationInfoWithUsers, AssessmentInfo, PlannedSessions, SessionInfoTeacher, SessionStateType, StudentAppSessionInfo, UniqueResponse, ItemStatisticsWithResponses } from "@citolab/qti-api";
+import { Assessment, SessionStateType, UniqueResponse, ItemStatisticsWithResponses, Session, Delivery, TestsetSession, TestsetStateType, Testset } from "@citolab/qti-api";
 import * as cheerio from "cheerio";
+import { Request } from "express";
 export declare function uploadFolderToStorage(folder: string, storageDestinationPath: string, uploadFiles: Promise<unknown>[], subfolder?: string): Promise<void>;
-export declare const getStudentSessionInfo: (code: string, db: DATABASE, userId?: string) => Promise<StudentAppSessionInfo | null>;
-export declare const getStudentGroupSessionInfo: (groupCode: string, db: DATABASE, userId: string, studentIdentification?: string) => Promise<StudentAppSessionInfo | null>;
-export declare const updateStudentSessionState: (db: DATABASE, code: string, assessmentId: string, state: SessionStateType, batch: FirebaseFirestore.WriteBatch) => Promise<null | undefined>;
-export declare const createAssessmentCode: (db: DATABASE, charCount: number, assessmentId: string, application?: ApplicationInfo) => Promise<string | null>;
-export declare const createDemoCodeForAssessment: (db: DATABASE, assessmentId: string, code: string) => Promise<string | undefined>;
-export declare const checkAssessmentCode: (db: DATABASE, code: string) => Promise<AssessmentInfo | null>;
-export declare const isStartable: (asessment: AssessmentInfo) => boolean;
-export declare const getCodeByUserId: (db: DATABASE, userId: string) => Promise<string | null>;
-export declare const getTeacherIdByCode: (db: DATABASE, code: string) => Promise<string | null>;
-export declare const getApplicationInfo: (db: DATABASE) => Promise<ApplicationInfo | undefined>;
-export declare const addApplicationInfo: (db: DATABASE, appInfo: ApplicationInfo) => Promise<void>;
-export declare const getApplication: (db: DATABASE) => Promise<ApplicationInfo | null>;
-export declare const codeExists: (code: string, db: DATABASE) => Promise<StudentAppSessionInfo | null>;
-export declare const hasAccess: (uid: string, appId: string) => Promise<boolean>;
-export declare const createSession: (teacherId: string, db: DATABASE, count: number, assessments: {
-    packageId: string;
-    assessmentId: string;
-    name: string;
-}[]) => Promise<StudentAppSessionInfo[]>;
-export declare const createSessionByIdentifications: (teacherId: string, db: DATABASE, identifications: {
-    identifier: string;
+export declare const getTestsetSessions: (testsetCode: string, db: DATABASE) => Promise<TestsetSession | null>;
+export declare const getTestsetSessionWithSessions: (testsetCode: string, db: DATABASE, userId: string) => Promise<{
+    sessions: (FirebaseFirestore.DocumentData | undefined)[];
+    userId: string;
+    code: string;
+    testsetId: string;
+    testset?: Testset;
+    teacherId: string;
+    identification?: string;
+    state: TestsetStateType;
+    sessionIds: string[];
+    currentSessionIndex?: number;
     password?: string;
-}[], sessionState: "not_available" | "not_started", assessments: {
-    packageId: string;
-    assessmentId: string;
-    name: string;
-}[]) => Promise<StudentAppSessionInfo[]>;
-export declare const getAllStudents: (db: DATABASE) => Promise<StudentAppSessionInfo[]>;
-export declare const getAssessments: (db: DATABASE) => Promise<AssessmentInfo[]>;
-export declare const getStartableAssessments: (db: DATABASE) => Promise<AssessmentInfo[]>;
-export declare const getAssessmentTest: (db: DATABASE, assessmentId: string) => Promise<AssessmentInfo>;
+    startedAt?: number;
+    completedAt?: number;
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    createdBy: string;
+} | null>;
+export declare const getSession: (code: string, db: DATABASE, userId?: string) => Promise<Session | null>;
+export declare const getDelivery: (code: string, db: DATABASE) => Promise<Delivery | null>;
+export declare const updateSessionState: (db: DATABASE, code: string, state: SessionStateType, batch: FirebaseFirestore.WriteBatch) => Promise<null | undefined>;
+export declare const isStartable: (asessment: Assessment) => boolean;
+export declare const checkDeliveryCode: (db: DATABASE, deliveryCode: string) => Promise<boolean>;
+export declare const checkTestsetCode: (db: DATABASE, testsetCode: string) => Promise<boolean>;
+export declare const checkSessionCode: (db: DATABASE, studentCode: string) => Promise<boolean>;
+export declare const deleteDelivery: (db: DATABASE, deliveryId: string) => Promise<void>;
+export declare const createDelivery: (db: DATABASE, userId: string, assessmentId: string) => Promise<string | null>;
+export declare const createSessionForDelivery: (db: DATABASE, userId: string, delivery: Delivery) => Promise<Session | undefined>;
+export declare const testsetSessionCodeExists: (code: string, db: DATABASE) => Promise<boolean>;
+export declare const sessionCodeExists: (code: string, db: DATABASE) => Promise<boolean>;
+export declare const deliveryCodeExists: (code: string, db: DATABASE) => Promise<boolean>;
+export declare const createTestsetSessionByIdentifications: (teacherId: string, db: DATABASE, testsetCode: string, identifications: string[], testsessionState?: TestsetStateType, sessionState?: SessionStateType, createPassword?: boolean) => Promise<{
+    session: Session[];
+    testsetSessions: TestsetSession[];
+} | undefined>;
+export declare const createUniqueCodeForDelivery: (db: DATABASE) => Promise<string | null>;
+export declare const createUniqueCodeForStudentSession: (db: DATABASE) => Promise<string | null>;
+export declare const createUniqueCodeForStudentTestsetSession: (db: DATABASE) => Promise<string | null>;
+export declare const hasAccess: (uid: string, appId: string) => Promise<boolean>;
+export declare const createSessions: (teacherId: string, deliveryCode: string, db: DATABASE, count: number, deliveryIds: string[]) => Promise<Session[]>;
+export declare const getAllStudents: (db: DATABASE) => Promise<Session[]>;
+export declare const getAssessments: (db: DATABASE) => Promise<Assessment[]>;
+export declare const getAssessment: (db: DATABASE, assessmentId: string) => Promise<Assessment>;
+export declare const getTestset: (testsetId: string, db: DATABASE) => Promise<Testset>;
 export declare const getAssessmentItemRefsFromPackage: ($assessmentTest: cheerio.CheerioAPI) => Promise<{
     identifier: string | undefined;
     sequenceNumber: number;
@@ -40,8 +56,8 @@ export declare const getAssessmentItemRefsFromPackage: ($assessmentTest: cheerio
 }[]>;
 export declare const getItemsStats: (db: DATABASE, teacherId: string, assessmentId: string, target: "teacher" | "reviewer") => Promise<ItemStatisticsWithResponses<UniqueResponse>[]>;
 export declare const updateItemStatResponseScore: (db: DATABASE, teacherId: string, assessmentId: string, itemId: string, responseId: string, scoreExternal: number | null, target: "reviewer" | "teacher") => Promise<void>;
-export declare const getPlannedStudents: (db: DATABASE, teacherId: string) => Promise<PlannedSessions<SessionInfoTeacher>[]>;
-export declare const getPlannedStudent: (db: DATABASE, teacherId: string, code: string) => Promise<PlannedSessions<SessionInfoTeacher>>;
+export declare const getPlannedStudents: (db: DATABASE, teacherId: string) => Promise<Session[]>;
+export declare const getPlannedStudent: (db: DATABASE, teacherId: string, code: string) => Promise<Session>;
 export declare const deleteStudent: (db: DATABASE, teacherId: string, code: string) => Promise<void>;
 export declare const getUser: (uid: string) => Promise<{
     admin?: boolean;
@@ -49,19 +65,26 @@ export declare const getUser: (uid: string) => Promise<{
 export declare const setUser: (uid: string, user: {
     admin?: boolean;
 }) => Promise<void>;
-export declare const resetSession: (db: DATABASE, teacherId: string, code: string, assessmentId: string) => Promise<void>;
-export declare const getStudentInfoForTeacher: (db: DATABASE, teacherId: string, code: string) => Promise<PlannedSessions<SessionInfoTeacher>>;
-export declare const updateStudent: (db: DATABASE, teacherId: string, code: string, identification: string) => Promise<void>;
-export declare const getAllApplications: () => Promise<ApplicationInfo[]>;
-export declare const createUserForApplication: (email: string, applicationId: string) => Promise<{
+export declare const reopenSession: (db: DATABASE, teacherId: string, code: string) => Promise<void>;
+export declare const resetSession: (db: DATABASE, teacherId: string, code: string) => Promise<void>;
+export declare const getStudentInfoForTeacher: (db: DATABASE, teacherId: string, code: string) => Promise<Session>;
+export declare const updateStudentIdentification: (db: DATABASE, teacherId: string, code: string, identification: string) => Promise<void>;
+export declare const createUser: (email: string) => Promise<{
     password: string;
     id: string;
 } | {
     id: string;
     password?: undefined;
 }>;
-export declare const deleteUserForApplication: (id: string, applicationId: string) => Promise<void>;
-export declare const getAllApplicationsWithUsers: () => Promise<ApplicationInfoWithUsers[]>;
+export declare const deleteUser: (id: string) => Promise<void>;
+export declare const getAllUsers: () => Promise<{
+    name: string;
+    users: {
+        id: string;
+        email: string;
+        disabled: boolean;
+    }[];
+}[]>;
 export declare function deleteDocumentAndSubcollections(docRef: FirebaseFirestore.DocumentReference): Promise<void>;
 export declare function checkAndDeletePackages(dateTime: number): Promise<void>;
 export declare function fetchUsersInChunks(ids: string[], chunkSize?: number): Promise<{
@@ -69,5 +92,41 @@ export declare function fetchUsersInChunks(ids: string[], chunkSize?: number): P
     email: string;
     disabled: boolean;
 }[]>;
-export declare const getPackageIdByAssessment: (db: DATABASE, code: string, assessmentId: string) => Promise<string | null>;
+/**
+ * Interface for feedback submission data
+ */
+export interface FeedbackSubmissionData {
+    type: string;
+    description: string;
+    feedbackId: string;
+    email?: string;
+    pageUrl?: string;
+}
+/**
+ * Processes feedback submission with optional screenshot
+ * @param req - Express request object
+ * @param userId - User ID who is submitting feedback
+ * @param userType - Type of user ('teacher' or 'student')
+ * @returns Promise<{data: FeedbackSubmissionData, fileBuffer: Buffer | null, fileOriginalname: string | null}>
+ */
+export declare function processFeedbackSubmission(req: Request): Promise<{
+    data: FeedbackSubmissionData;
+    fileBuffer: Buffer | null;
+    fileOriginalname: string | null;
+}>;
+/**
+ * Validates feedback submission data
+ * @param data - Feedback data to validate
+ * @returns Validation error message or null if valid
+ */
+export declare function validateFeedbackData(data: FeedbackSubmissionData): string | null;
+/**
+ * Saves feedback to Firestore and optionally uploads screenshot to Storage
+ * @param data - Feedback submission data
+ * @param userId - User ID who submitted the feedback
+ * @param userType - Type of user ('teacher' or 'student')
+ * @param fileBuffer - Screenshot file buffer (optional)
+ * @returns Promise<void>
+ */
+export declare function saveFeedback(data: FeedbackSubmissionData, userId: string, userType: 'teacher' | 'student', fileBuffer?: Buffer | null): Promise<void>;
 //# sourceMappingURL=logic.d.ts.map

package/dist/helpers/logic.d.ts.map

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