Merge remote-tracking branch 'origin/dev' into feat/user-routes

# Conflicts:
#	backend/src/controllers/learning-objects.ts
#	frontend/src/controllers/controllers.ts
#	frontend/src/queries/themes.ts

frontend/src/queries/learning-objects.ts

@@ -0,0 +1,57 @@
+import { type MaybeRefOrGetter, toValue } from "vue";
+import type { Language } from "@/data-objects/language.ts";
+import { useQuery, type UseQueryReturnType } from "@tanstack/vue-query";
+import { getLearningObjectController } from "@/controllers/controllers.ts";
+import type { LearningObject } from "@/data-objects/learning-objects/learning-object.ts";
+import type { LearningPath } from "@/data-objects/learning-paths/learning-path.ts";
+
+const LEARNING_OBJECT_KEY = "learningObject";
+const learningObjectController = getLearningObjectController();
+
+export function useLearningObjectMetadataQuery(
+    hruid: MaybeRefOrGetter<string>,
+    language: MaybeRefOrGetter<Language>,
+    version: MaybeRefOrGetter<number>,
+): UseQueryReturnType<LearningObject, Error> {
+    return useQuery({
+        queryKey: [LEARNING_OBJECT_KEY, "metadata", hruid, language, version],
+        queryFn: async () => {
+            const [hruidVal, languageVal, versionVal] = [toValue(hruid), toValue(language), toValue(version)];
+            return learningObjectController.getMetadata(hruidVal, languageVal, versionVal);
+        },
+        enabled: () => Boolean(toValue(hruid)) && Boolean(toValue(language)) && Boolean(toValue(version)),
+    });
+}
+
+export function useLearningObjectHTMLQuery(
+    hruid: MaybeRefOrGetter<string>,
+    language: MaybeRefOrGetter<Language>,
+    version: MaybeRefOrGetter<number>,
+): UseQueryReturnType<Document, Error> {
+    return useQuery({
+        queryKey: [LEARNING_OBJECT_KEY, "html", hruid, language, version],
+        queryFn: async () => {
+            const [hruidVal, languageVal, versionVal] = [toValue(hruid), toValue(language), toValue(version)];
+            return learningObjectController.getHTML(hruidVal, languageVal, versionVal);
+        },
+        enabled: () => Boolean(toValue(hruid)) && Boolean(toValue(language)) && Boolean(toValue(version)),
+    });
+}
+
+export function useLearningObjectListForPathQuery(
+    learningPath: MaybeRefOrGetter<LearningPath | undefined>,
+): UseQueryReturnType<LearningObject[], Error> {
+    return useQuery({
+        queryKey: [LEARNING_OBJECT_KEY, "onPath", learningPath],
+        queryFn: async () => {
+            const learningObjects: Promise<LearningObject>[] = [];
+            for (const node of toValue(learningPath)!.nodesAsList) {
+                learningObjects.push(
+                    learningObjectController.getMetadata(node.learningobjectHruid, node.language, node.version),
+                );
+            }
+            return Promise.all(learningObjects);
+        },
+        enabled: () => Boolean(toValue(learningPath)),
+    });
+}

frontend/src/queries/learning-paths.ts

@@ -0,0 +1,46 @@
+import { type MaybeRefOrGetter, toValue } from "vue";
+import type { Language } from "@/data-objects/language.ts";
+import { useQuery, type UseQueryReturnType } from "@tanstack/vue-query";
+import { getLearningPathController } from "@/controllers/controllers";
+import type { LearningPath } from "@/data-objects/learning-paths/learning-path.ts";
+
+const LEARNING_PATH_KEY = "learningPath";
+const learningPathController = getLearningPathController();
+
+export function useGetLearningPathQuery(
+    hruid: MaybeRefOrGetter<string>,
+    language: MaybeRefOrGetter<Language>,
+    options?: MaybeRefOrGetter<{ forGroup?: string; forStudent?: string }>,
+): UseQueryReturnType<LearningPath, Error> {
+    return useQuery({
+        queryKey: [LEARNING_PATH_KEY, "get", hruid, language, options],
+        queryFn: async () => {
+            const [hruidVal, languageVal, optionsVal] = [toValue(hruid), toValue(language), toValue(options)];
+            return learningPathController.getBy(hruidVal, languageVal, optionsVal);
+        },
+        enabled: () => Boolean(toValue(hruid)) && Boolean(toValue(language)),
+    });
+}
+
+export function useGetAllLearningPathsByThemeQuery(
+    theme: MaybeRefOrGetter<string>,
+): UseQueryReturnType<LearningPath[], Error> {
+    return useQuery({
+        queryKey: [LEARNING_PATH_KEY, "getAllByTheme", theme],
+        queryFn: async () => learningPathController.getAllByTheme(toValue(theme)),
+        enabled: () => Boolean(toValue(theme)),
+    });
+}
+
+export function useSearchLearningPathQuery(
+    query: MaybeRefOrGetter<string | undefined>,
+): UseQueryReturnType<LearningPath[], Error> {
+    return useQuery({
+        queryKey: [LEARNING_PATH_KEY, "search", query],
+        queryFn: async () => {
+            const queryVal = toValue(query)!;
+            return learningPathController.search(queryVal);
+        },
+        enabled: () => Boolean(toValue(query)),
+    });
+}