@orjok/commons 1.0.2 → 1.2.0

package/dist/hooks.js

@@ -1,3 +1,16 @@
+import {
+  aggregateSubjectMetrics,
+  calculateUnreadCount,
+  getPublicExamsByLevel,
+  isDifficultyMatch,
+  isLanguageMatch,
+  isStorageKey,
+  isValidMCQ,
+  mergeNotificationTimeline,
+  resolveMediaUrl,
+  shuffle
+} from "./chunk-B4UJE3F4.js";
+
 // src/hooks/useOrjokClient.ts
 import { createContext, useContext } from "react";
 var OrjokContext = createContext(null);
@@ -9,8 +22,632 @@ function useOrjokClient() {
   }
   return client;
 }
+
+// src/hooks/useMediaUrl.ts
+import { useQuery } from "@tanstack/react-query";
+function useMediaUrl(key) {
+  const client = useOrjokClient();
+  const isResolvable = Boolean(key && isStorageKey(key));
+  const query = useQuery({
+    queryKey: ["media-url", key],
+    queryFn: async () => {
+      if (!key) return null;
+      return resolveMediaUrl(key, client.storage);
+    },
+    enabled: isResolvable,
+    staleTime: 50 * 60 * 1e3
+    // 50 mins
+  });
+  if (!key) {
+    return { url: null, isLoading: false };
+  }
+  if (!isStorageKey(key)) {
+    return { url: key, isLoading: false };
+  }
+  return {
+    url: query.data ?? null,
+    isLoading: query.isLoading
+  };
+}
+
+// src/hooks/useCurriculum.ts
+import { useQuery as useQuery2 } from "@tanstack/react-query";
+function useCurriculum({ level, subjectId, chapterId } = {}) {
+  const client = useOrjokClient();
+  const subjectsQuery = useQuery2({
+    queryKey: ["curriculum-subjects", level],
+    queryFn: () => level ? client.curriculum.getSubjects(level) : Promise.resolve([]),
+    enabled: Boolean(level)
+  });
+  const chaptersQuery = useQuery2({
+    queryKey: ["curriculum-chapters", subjectId],
+    queryFn: () => subjectId ? client.curriculum.getChapters(subjectId) : Promise.resolve([]),
+    enabled: Boolean(subjectId)
+  });
+  const topicsQuery = useQuery2({
+    queryKey: ["curriculum-topics", chapterId],
+    queryFn: () => chapterId ? client.curriculum.getTopics(chapterId) : Promise.resolve([]),
+    enabled: Boolean(chapterId)
+  });
+  return {
+    subjects: subjectsQuery.data ?? [],
+    chapters: chaptersQuery.data ?? [],
+    topics: topicsQuery.data ?? [],
+    isLoadingSubjects: subjectsQuery.isLoading,
+    isLoadingChapters: chaptersQuery.isLoading,
+    isLoadingTopics: topicsQuery.isLoading
+  };
+}
+
+// src/hooks/useQuestions.ts
+import { useQuery as useQuery3 } from "@tanstack/react-query";
+function useQuestions({
+  subjectId,
+  chapterId,
+  topicId,
+  language,
+  difficulty,
+  limit = 20,
+  nextToken
+} = {}) {
+  const client = useOrjokClient();
+  const lang = language === "All" ? void 0 : language;
+  const diff = difficulty === "All" ? void 0 : difficulty;
+  const query = useQuery3({
+    queryKey: ["questions", { subjectId, chapterId, topicId, language, difficulty, limit, nextToken }],
+    queryFn: async () => {
+      if (topicId) {
+        return client.questions.listByTopic({ id: topicId, language: lang, difficulty: diff, limit, nextToken: nextToken || void 0 });
+      }
+      if (chapterId) {
+        return client.questions.listByChapter({ id: chapterId, language: lang, difficulty: diff, limit, nextToken: nextToken || void 0 });
+      }
+      if (subjectId) {
+        return client.questions.listBySubject({ id: subjectId, language: lang, difficulty: diff, limit, nextToken: nextToken || void 0 });
+      }
+      return { items: [], nextToken: null };
+    },
+    enabled: Boolean(subjectId || chapterId || topicId)
+  });
+  return {
+    questions: query.data?.items ?? [],
+    nextToken: query.data?.nextToken ?? null,
+    isLoading: query.isLoading,
+    refetch: query.refetch
+  };
+}
+
+// src/hooks/usePacks.ts
+import { useQuery as useQuery4 } from "@tanstack/react-query";
+function usePacks({
+  subjectId,
+  chapterId,
+  topicId,
+  language,
+  difficulty,
+  limit = 20,
+  nextToken
+} = {}) {
+  const client = useOrjokClient();
+  const lang = language === "All" ? void 0 : language;
+  const diff = difficulty === "All" ? void 0 : difficulty;
+  const query = useQuery4({
+    queryKey: ["packs", { subjectId, chapterId, topicId, language, difficulty, limit, nextToken }],
+    queryFn: async () => {
+      if (topicId) {
+        return client.packs.listByTopic({ id: topicId, language: lang, difficulty: diff, limit, nextToken: nextToken || void 0 });
+      }
+      if (chapterId) {
+        return client.packs.listByChapter({ id: chapterId, language: lang, difficulty: diff, limit, nextToken: nextToken || void 0 });
+      }
+      if (subjectId) {
+        return client.packs.listBySubject({ id: subjectId, language: lang, difficulty: diff, limit, nextToken: nextToken || void 0 });
+      }
+      return { items: [], nextToken: null };
+    },
+    enabled: Boolean(subjectId || chapterId || topicId)
+  });
+  return {
+    packs: query.data?.items ?? [],
+    nextToken: query.data?.nextToken ?? null,
+    isLoading: query.isLoading,
+    refetch: query.refetch
+  };
+}
+function usePackDetail(packId) {
+  const client = useOrjokClient();
+  const query = useQuery4({
+    queryKey: ["pack-detail", packId],
+    queryFn: async () => {
+      if (!packId) return null;
+      return client.packs.getFull(packId);
+    },
+    enabled: Boolean(packId)
+  });
+  return {
+    pack: query.data ?? null,
+    questions: query.data?.questions?.items ?? [],
+    isLoading: query.isLoading,
+    refetch: query.refetch
+  };
+}
+
+// src/hooks/useContest.ts
+import { useQuery as useQuery5 } from "@tanstack/react-query";
+function useContest(contestId, checkParticipation = false) {
+  const client = useOrjokClient();
+  const contestQuery = useQuery5({
+    queryKey: ["contest", contestId],
+    queryFn: async () => {
+      if (!contestId) return null;
+      return client.contests.get(contestId);
+    },
+    enabled: Boolean(contestId)
+  });
+  const partQuery = useQuery5({
+    queryKey: ["contest-participation", contestId],
+    queryFn: async () => {
+      if (!contestId || !checkParticipation) return null;
+      return client.contests.checkParticipation(contestId);
+    },
+    enabled: Boolean(contestId && checkParticipation)
+  });
+  return {
+    contest: contestQuery.data ?? null,
+    participation: partQuery.data ?? null,
+    isLoading: contestQuery.isLoading || checkParticipation && partQuery.isLoading,
+    refetch: async () => {
+      await Promise.all([contestQuery.refetch(), partQuery.refetch()]);
+    }
+  };
+}
+function useContestsList({ level, nextToken } = {}) {
+  const client = useOrjokClient();
+  const query = useQuery5({
+    queryKey: ["contests-list", level, nextToken],
+    queryFn: () => client.contests.list(nextToken, level)
+  });
+  return {
+    contests: query.data?.items ?? [],
+    nextToken: query.data?.nextToken ?? null,
+    isLoading: query.isLoading,
+    refetch: query.refetch
+  };
+}
+
+// src/hooks/useCourse.ts
+import { useQuery as useQuery6 } from "@tanstack/react-query";
+function useCourse(courseId) {
+  const client = useOrjokClient();
+  const query = useQuery6({
+    queryKey: ["course", courseId],
+    queryFn: async () => {
+      if (!courseId) return null;
+      return client.courses.get(courseId);
+    },
+    enabled: Boolean(courseId)
+  });
+  return {
+    course: query.data ?? null,
+    isLoading: query.isLoading,
+    refetch: query.refetch
+  };
+}
+function useCourseItems(courseId) {
+  const client = useOrjokClient();
+  const query = useQuery6({
+    queryKey: ["course-items", courseId],
+    queryFn: async () => {
+      if (!courseId) return [];
+      return client.courses.getItems(courseId);
+    },
+    enabled: Boolean(courseId)
+  });
+  return {
+    items: query.data ?? [],
+    isLoading: query.isLoading,
+    refetch: query.refetch
+  };
+}
+function useCourseLiveExams(courseId) {
+  const client = useOrjokClient();
+  const query = useQuery6({
+    queryKey: ["course-live-exams", courseId],
+    queryFn: async () => {
+      if (!courseId) return { items: [], nextToken: null };
+      return client.courses.getLiveExams(courseId);
+    },
+    enabled: Boolean(courseId)
+  });
+  return {
+    exams: query.data?.items ?? [],
+    isLoading: query.isLoading,
+    refetch: query.refetch
+  };
+}
+
+// src/hooks/useProgress.ts
+import { useQuery as useQuery7 } from "@tanstack/react-query";
+function useProgress(userId) {
+  const client = useOrjokClient();
+  const subjectsQuery = useQuery7({
+    queryKey: ["user-subject-progress", userId],
+    queryFn: () => userId ? client.progress.getSubjectProgress(userId) : Promise.resolve([]),
+    enabled: Boolean(userId)
+  });
+  const chaptersQuery = useQuery7({
+    queryKey: ["user-chapter-progress", userId],
+    queryFn: () => userId ? client.progress.getChapterProgress(userId) : Promise.resolve([]),
+    enabled: Boolean(userId)
+  });
+  const topicsQuery = useQuery7({
+    queryKey: ["user-topic-progress", userId],
+    queryFn: () => userId ? client.progress.getTopicProgress(userId) : Promise.resolve([]),
+    enabled: Boolean(userId)
+  });
+  const subjectsProgress = subjectsQuery.data ?? [];
+  const chaptersProgress = chaptersQuery.data ?? [];
+  const topicsProgress = topicsQuery.data ?? [];
+  const metrics = aggregateSubjectMetrics(subjectsProgress);
+  return {
+    subjectsProgress,
+    chaptersProgress,
+    topicsProgress,
+    metrics,
+    isLoading: subjectsQuery.isLoading || chaptersQuery.isLoading || topicsQuery.isLoading,
+    refetch: async () => {
+      await Promise.all([
+        subjectsQuery.refetch(),
+        chaptersQuery.refetch(),
+        topicsQuery.refetch()
+      ]);
+    }
+  };
+}
+
+// src/hooks/usePractice.ts
+import { useState, useCallback } from "react";
+function usePractice({
+  subjectId,
+  chapterIds = [],
+  topicIds = [],
+  language = "Bangla",
+  difficulty = "All",
+  userId,
+  isCreator
+} = {}) {
+  const client = useOrjokClient();
+  const [mode, setMode] = useState("setup");
+  const [questions, setQuestions] = useState([]);
+  const [currentIdx, setCurrentIdx] = useState(0);
+  const [selectedOption, setSelectedOption] = useState(null);
+  const [isAnswered, setIsAnswered] = useState(false);
+  const [isCorrect, setIsCorrect] = useState(null);
+  const [score, setScore] = useState(0);
+  const [totalPracticed, setTotalPracticed] = useState(0);
+  const [isLoading, setIsLoading] = useState(false);
+  const [isValidating, setIsValidating] = useState(false);
+  const fetchQuestionsPool = useCallback(async () => {
+    const bounds = [];
+    if (topicIds.length > 0) {
+      topicIds.forEach((tId) => bounds.push({ id: tId, type: "topic" }));
+    } else if (chapterIds.length > 0) {
+      chapterIds.forEach((cId) => bounds.push({ id: cId, type: "chapter" }));
+    } else if (subjectId) {
+      bounds.push({ id: subjectId, type: "subject" });
+    }
+    if (bounds.length === 0) return [];
+    const queries = bounds.map(async (b) => {
+      try {
+        if (b.type === "topic") {
+          return await client.questions.listByTopic({ id: b.id, limit: 50 });
+        } else if (b.type === "chapter") {
+          return await client.questions.listByChapter({ id: b.id, limit: 50 });
+        } else {
+          return await client.questions.listBySubject({ id: b.id, limit: 50 });
+        }
+      } catch (e) {
+        console.error("Error fetching bounds query in practice:", b, e);
+        return { items: [] };
+      }
+    });
+    const results = await Promise.all(queries);
+    const uniqueMap = /* @__PURE__ */ new Map();
+    results.forEach((r) => {
+      (r.items || []).forEach((q) => {
+        if (q && q.id && !uniqueMap.has(q.id)) {
+          uniqueMap.set(q.id, q);
+        }
+      });
+    });
+    let list = Array.from(uniqueMap.values()).filter((q) => {
+      if (!isLanguageMatch(q.language, language)) return false;
+      if (!isDifficultyMatch(q.difficulty, difficulty)) return false;
+      return true;
+    });
+    if (list.length < 5 && subjectId && bounds.some((b) => b.type !== "subject")) {
+      try {
+        const subRes = await client.questions.listBySubject({ id: subjectId, limit: 50 });
+        (subRes.items || []).forEach((q) => {
+          if (q && q.id && !uniqueMap.has(q.id)) {
+            if (isLanguageMatch(q.language, language) && isDifficultyMatch(q.difficulty, difficulty)) {
+              list.push(q);
+              uniqueMap.set(q.id, q);
+            }
+          }
+        });
+      } catch (e) {
+        console.error("Error fetching subject fallback in practice:", e);
+      }
+    }
+    return list.filter(isValidMCQ);
+  }, [client, subjectId, chapterIds, topicIds, language, difficulty]);
+  const startPractice = useCallback(async () => {
+    setIsLoading(true);
+    setMode("practice");
+    setCurrentIdx(0);
+    setScore(0);
+    setTotalPracticed(0);
+    setSelectedOption(null);
+    setIsAnswered(false);
+    setIsCorrect(null);
+    try {
+      const fetched = await fetchQuestionsPool();
+      setQuestions(shuffle(fetched));
+    } catch (e) {
+      console.error("Error starting practice:", e);
+      setQuestions([]);
+    } finally {
+      setIsLoading(false);
+    }
+  }, [fetchQuestionsPool]);
+  const selectOption = useCallback(
+    async (optionId) => {
+      if (isAnswered || isValidating || questions.length === 0) return;
+      setSelectedOption(optionId);
+      setIsValidating(true);
+      const currentQ = questions[currentIdx];
+      if (!currentQ) {
+        setIsValidating(false);
+        return;
+      }
+      try {
+        const fullQ = await client.questions.get(currentQ.id);
+        const ansVal = fullQ?.answer;
+        const rawOpts = currentQ.options;
+        const optsList = Array.isArray(rawOpts) ? rawOpts : rawOpts && typeof rawOpts === "object" && Array.isArray(rawOpts.items) ? rawOpts.items : [];
+        const chosenOpt = optsList.find((o) => o?.id === optionId);
+        const correct = Boolean(
+          ansVal && (ansVal === optionId || chosenOpt && ansVal === chosenOpt.content)
+        );
+        setIsCorrect(correct);
+        setIsAnswered(true);
+        setTotalPracticed((prev) => prev + 1);
+        if (correct) setScore((prev) => prev + 1);
+        if (userId && isCreator) {
+          void client.progress.track({
+            questionId: currentQ.id,
+            isCorrect: correct,
+            subjectId: currentQ.subjectId || subjectId,
+            chapterId: currentQ.chapterId || (chapterIds.length === 1 ? chapterIds[0] : void 0),
+            topicId: currentQ.topicId || (topicIds.length === 1 ? topicIds[0] : void 0)
+          }).catch((e) => console.error("Tracking practice progress error:", e));
+        }
+      } catch (err) {
+        console.error("Error validating option in practice:", err);
+      } finally {
+        setIsValidating(false);
+      }
+    },
+    [client, isAnswered, isValidating, questions, currentIdx, userId, isCreator, subjectId, chapterIds, topicIds]
+  );
+  const nextQuestion = useCallback(() => {
+    if (questions.length === 0) return;
+    if (currentIdx + 1 < questions.length) {
+      setCurrentIdx((prev) => prev + 1);
+      setSelectedOption(null);
+      setIsAnswered(false);
+      setIsCorrect(null);
+    } else {
+      setQuestions((prev) => shuffle(prev));
+      setCurrentIdx(0);
+      setSelectedOption(null);
+      setIsAnswered(false);
+      setIsCorrect(null);
+    }
+  }, [questions.length, currentIdx]);
+  const finishPractice = useCallback(() => {
+    setMode("summary");
+  }, []);
+  const resetPractice = useCallback(() => {
+    setMode("setup");
+    setQuestions([]);
+    setCurrentIdx(0);
+    setScore(0);
+    setTotalPracticed(0);
+    setSelectedOption(null);
+    setIsAnswered(false);
+    setIsCorrect(null);
+  }, []);
+  const accuracy = totalPracticed > 0 ? Math.round(score / totalPracticed * 100) : 0;
+  return {
+    mode,
+    questions,
+    currentIdx,
+    currentQuestion: questions[currentIdx] ?? null,
+    selectedOption,
+    isAnswered,
+    isCorrect,
+    score,
+    totalPracticed,
+    accuracy,
+    isLoading,
+    isValidating,
+    startPractice,
+    selectOption,
+    nextQuestion,
+    finishPractice,
+    resetPractice
+  };
+}
+
+// src/hooks/useAvailablePublicExams.ts
+import { useMemo } from "react";
+import { useQuery as useQuery8 } from "@tanstack/react-query";
+function useAvailablePublicExams({
+  level,
+  exploreType = "Question",
+  enabled = true,
+  client: directClient
+} = {}) {
+  let contextClient = null;
+  try {
+    contextClient = useOrjokClient();
+  } catch {
+  }
+  const client = directClient ?? contextClient;
+  const candidateExams = useMemo(() => getPublicExamsByLevel(level), [level]);
+  const query = useQuery8({
+    queryKey: ["availablePublicExams", level, exploreType],
+    queryFn: async () => {
+      if (!client || !level || candidateExams.length === 0) return candidateExams;
+      const results = await Promise.all(
+        candidateExams.map(async (exam) => {
+          try {
+            if (exploreType === "Pack") {
+              const res = await client.packs.listByPublicExam({
+                publicExam: exam.value,
+                limit: 1
+              });
+              return (res.items?.length ?? 0) > 0 ? exam : null;
+            } else {
+              const res = await client.questions.listByPublicExam({
+                publicExam: exam.value,
+                limit: 1
+              });
+              return (res.items?.length ?? 0) > 0 ? exam : null;
+            }
+          } catch {
+            return null;
+          }
+        })
+      );
+      return results.filter((e) => e !== null);
+    },
+    enabled: Boolean(level) && enabled,
+    staleTime: 10 * 60 * 1e3,
+    gcTime: 30 * 60 * 1e3
+  });
+  if (!enabled || !level) {
+    return {
+      availableExams: candidateExams,
+      isLoading: false,
+      isSuccess: true,
+      refetch: async () => candidateExams
+    };
+  }
+  return {
+    availableExams: query.data ?? [],
+    isLoading: query.isLoading,
+    isSuccess: query.isSuccess,
+    refetch: query.refetch
+  };
+}
+
+// src/hooks/useNotifications.ts
+import { useQuery as useQuery9, useMutation, useQueryClient } from "@tanstack/react-query";
+function useNotifications(userId, lastReadAnnouncementAt) {
+  const client = useOrjokClient();
+  const queryClient = useQueryClient();
+  const announcementsQuery = useQuery9({
+    queryKey: ["notifications-announcements"],
+    queryFn: async () => {
+      const result = await client.notifications.listAnnouncements(50);
+      return result.items || [];
+    },
+    enabled: Boolean(userId),
+    refetchInterval: 3e4
+    // Poll every 30s
+  });
+  const userNotificationsQuery = useQuery9({
+    queryKey: ["notifications-user", userId],
+    queryFn: async () => {
+      if (!userId) return [];
+      const result = await client.notifications.listUserNotifications(userId, 50);
+      return result.items || [];
+    },
+    enabled: Boolean(userId),
+    refetchInterval: 3e4
+  });
+  const announcements = announcementsQuery.data ?? [];
+  const userNotifications = userNotificationsQuery.data ?? [];
+  const timeline = mergeNotificationTimeline({
+    announcements,
+    userNotifications,
+    lastReadAnnouncementAt
+  });
+  const unreadCount = calculateUnreadCount({
+    announcements,
+    userNotifications,
+    lastReadAnnouncementAt
+  });
+  const markAsReadMutation = useMutation({
+    mutationFn: (id) => client.notifications.markNotificationAsRead(id),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["notifications-user", userId] });
+    }
+  });
+  const deleteAnnouncementMutation = useMutation({
+    mutationFn: (id) => client.notifications.deleteAnnouncement(id),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["notifications-announcements"] });
+    }
+  });
+  const deleteUserNotificationMutation = useMutation({
+    mutationFn: (id) => client.notifications.deleteUserNotification(id),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: ["notifications-user", userId] });
+    }
+  });
+  return {
+    announcements,
+    userNotifications,
+    timeline,
+    unreadCount,
+    isLoading: announcementsQuery.isLoading || Boolean(userId) && userNotificationsQuery.isLoading,
+    refetch: async () => {
+      await Promise.all([
+        announcementsQuery.refetch(),
+        userId ? userNotificationsQuery.refetch() : Promise.resolve()
+      ]);
+    },
+    markNotificationAsRead: async (id) => {
+      return markAsReadMutation.mutateAsync(id);
+    },
+    deleteAnnouncement: async (id) => {
+      return deleteAnnouncementMutation.mutateAsync(id);
+    },
+    deleteUserNotification: async (id) => {
+      return deleteUserNotificationMutation.mutateAsync(id);
+    }
+  };
+}
 export {
   OrjokProvider,
-  useOrjokClient
+  useAvailablePublicExams,
+  useContest,
+  useContestsList,
+  useCourse,
+  useCourseItems,
+  useCourseLiveExams,
+  useCurriculum,
+  useMediaUrl,
+  useNotifications,
+  useOrjokClient,
+  usePackDetail,
+  usePacks,
+  usePractice,
+  useProgress,
+  useQuestions
 };
 //# sourceMappingURL=hooks.js.map