@orjok/commons 1.1.0 → 1.2.0

package/dist/index.js

@@ -1,19 +1,36 @@
 import {
   MediaUrlCache,
+  XP_REWARDS,
+  XP_TIERS,
   _resetMediaUrlWarning,
   aggregateChapterMetrics,
   aggregateSubjectMetrics,
   aggregateTopicMetrics,
   calculateAccuracy,
+  calculateUnreadCount,
+  calculateXpReward,
+  difficultyOptions,
+  formatLevelUpNotification,
+  getAllXpTiers,
+  getLevelFromXp,
+  getPublicExamsByLevel,
+  getXpForLevel,
+  getXpProgress,
+  getXpRequiredForNextLevel,
+  getXpTier,
   isDifficultyMatch,
   isLanguageMatch,
   isStorageKey,
   isValidMCQ,
+  languageOptions,
+  levelOptions,
+  mergeNotificationTimeline,
+  publicExamOptions,
   resolveMediaUrl,
   resolveMediaUrls,
   shuffle,
   shuffleInPlace
-} from "./chunk-ZDGYAVEC.js";
+} from "./chunk-B4UJE3F4.js";
 
 // src/services/user.service.ts
 var UserService = class {
@@ -25,11 +42,12 @@ var UserService = class {
       `query GetUser($id: String!) {
         getUser(id: $id) {
           id fullName avatarUrl avatarConfig tier subscriptionExpiresAt
-          aiEvaluationRemaining questionCount packCount contestCount
+          aiEvaluationRemaining aiQuestionGenRemaining questionCount packCount contestCount
           EngineeringRating MedicalRating VarsityRating BCSRating
           sscOverallRating sscPhysicsRating sscChemistryRating sscMathRating sscBiologyRating
           hscOverallRating hscPhysicsRating hscChemistryRating hscMathRating hscBiologyRating
           bcsOverallRating
+          xp userLevel
         }
       }`,
       { id }
@@ -37,13 +55,16 @@ var UserService = class {
     return result.data.getUser;
   }
   async updateAvatar(input) {
+    const updateInput = { id: input.userId };
+    if (input.avatarUrl !== void 0) updateInput.avatarUrl = input.avatarUrl;
+    if (input.avatarConfig !== void 0) updateInput.avatarConfig = input.avatarConfig;
     const result = await this.network.mutate(
       `mutation UpdateUser($input: UpdateUserInput!) {
         updateUser(input: $input) {
           id fullName avatarUrl avatarConfig
         }
       }`,
-      { input: { id: input.userId, avatarUrl: input.avatarUrl, avatarConfig: input.avatarConfig } }
+      { input: updateInput }
     );
     return result.data.updateUser;
   }
@@ -107,8 +128,59 @@ var UserService = class {
     );
     return result.data.listCourseEnrolledByUserIdAndCreatedAt.items;
   }
+  async updateProfile(input) {
+    const result = await this.network.mutate(
+      `mutation UpdateUserProfile($input: UpdateUserInput!) {
+        updateUser(input: $input) {
+          id fullName avatarUrl avatarConfig tier subscriptionExpiresAt
+          aiEvaluationRemaining aiQuestionGenRemaining questionCount packCount contestCount
+          xp userLevel
+        }
+      }`,
+      { input }
+    );
+    return result.data.updateUser;
+  }
+  async list(input = {}) {
+    const result = await this.network.query(
+      `query ListUsers($limit: Int, $nextToken: String, $filter: ModelUserFilterInput) {
+        listUsers(limit: $limit, nextToken: $nextToken, filter: $filter) {
+          items {
+            id fullName avatarUrl avatarConfig tier subscriptionExpiresAt
+            aiEvaluationRemaining aiQuestionGenRemaining questionCount packCount contestCount
+            xp userLevel
+          }
+          nextToken
+        }
+      }`,
+      { limit: input.limit ?? 20, nextToken: input.nextToken, filter: input.filter }
+    );
+    return result.data.listUsers;
+  }
 };
 
+// src/utils/pagination.ts
+async function paginateWithAccumulator(fetchPage, targetLimit = 12, initialNextToken, maxIterations = 10) {
+  const accumulated = [];
+  let currentNextToken = initialNextToken;
+  let iterations = 0;
+  while (accumulated.length < targetLimit && iterations < maxIterations) {
+    iterations++;
+    const remaining = targetLimit - accumulated.length;
+    const response = await fetchPage(remaining, currentNextToken);
+    const items = response?.items || [];
+    accumulated.push(...items);
+    currentNextToken = response?.nextToken;
+    if (!currentNextToken || accumulated.length >= targetLimit) {
+      break;
+    }
+  }
+  return {
+    items: accumulated.slice(0, targetLimit),
+    nextToken: currentNextToken ?? null
+  };
+}
+
 // src/services/question.service.ts
 var QuestionService = class {
   constructor(network) {
@@ -116,8 +188,8 @@ var QuestionService = class {
   }
   async create(input) {
     const result = await this.network.mutate(
-      `mutation CreateQuestion($question: String!, $answer: String!, $options: String!, $language: String!, $level: String!, $difficulty: String!, $type: String, $explanation: String, $tags: String, $imagePayload: String, $optionsImagesPayload: String, $packId: ID, $order: Int, $contestId: ID, $subjectId: ID, $chapterId: ID, $topicId: ID, $extra: String, $markingInstructions: String) {
-        createQuestion(question: $question, answer: $answer, options: $options, language: $language, level: $level, difficulty: $difficulty, type: $type, explanation: $explanation, tags: $tags, imagePayload: $imagePayload, optionsImagesPayload: $optionsImagesPayload, packId: $packId, order: $order, contestId: $contestId, subjectId: $subjectId, chapterId: $chapterId, topicId: $topicId, extra: $extra, markingInstructions: $markingInstructions) {
+      `mutation CreateQuestion($question: String!, $answer: String!, $options: String!, $language: String!, $level: String!, $publicExam: String, $difficulty: String!, $type: String, $explanation: String, $tags: String, $imagePayload: String, $optionsImagesPayload: String, $packId: ID, $order: Int, $contestId: ID, $subjectId: ID, $chapterId: ID, $topicId: ID, $extra: String, $markingInstructions: String) {
+        createQuestion(question: $question, answer: $answer, options: $options, language: $language, level: $level, publicExam: $publicExam, difficulty: $difficulty, type: $type, explanation: $explanation, tags: $tags, imagePayload: $imagePayload, optionsImagesPayload: $optionsImagesPayload, packId: $packId, order: $order, contestId: $contestId, subjectId: $subjectId, chapterId: $chapterId, topicId: $topicId, extra: $extra, markingInstructions: $markingInstructions) {
           status questionId
         }
       }`,
@@ -129,7 +201,7 @@ var QuestionService = class {
     const result = await this.network.query(
       `query GetQuestion($id: String!) {
         getQuestionObject(id: $id) {
-          id question imageUrl language level difficulty type voteCount
+          id question imageUrl language level publicExam difficulty type voteCount
           verificationStatus owner packId subjectId chapterId topicId order createdAt
           options { items { id content } }
           tags { items { id tagId } }
@@ -143,7 +215,7 @@ var QuestionService = class {
     const result = await this.network.query(
       `query GetFullQuestion($id: String!) {
         getQuestionObject(id: $id) {
-          id question answer explanation extra imageUrl language level difficulty type
+          id question answer explanation extra imageUrl language level publicExam difficulty type
           markingInstructions voteCount verificationStatus owner packId
           subjectId chapterId topicId order createdAt
           options { items { id content } }
@@ -181,7 +253,7 @@ var QuestionService = class {
       `query ListQuestionsByPack($packId: ID!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
         listQuestionObjectByPackIdAndOrder(packId: $packId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
           items {
-            id question answer explanation extra imageUrl language level difficulty type
+            id question answer explanation extra imageUrl language level publicExam difficulty type
             markingInstructions voteCount owner packId subjectId chapterId topicId order createdAt
             options { items { id content } }
             tags { items { id tagId } }
@@ -197,7 +269,7 @@ var QuestionService = class {
     const result = await this.network.mutate(
       `mutation UpdateQuestion($input: UpdateQuestionObjectInput!) {
         updateQuestionObject(input: $input) {
-          id question answer explanation extra imageUrl language level difficulty type
+          id question answer explanation extra imageUrl language level publicExam difficulty type
           markingInstructions voteCount owner packId subjectId chapterId topicId order createdAt
           options { items { id content } }
         }
@@ -297,70 +369,288 @@ var QuestionService = class {
     return result.data.addQuestionTag;
   }
   async listBySubject(input) {
-    const variables = {
-      subjectId: input.id,
-      sortDirection: input.sortDirection ?? "DESC",
-      limit: input.limit ?? 20,
-      nextToken: input.nextToken
-    };
-    const result = await this.network.query(
-      `query ListQuestionsBySubject($subjectId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
-        listQuestionObjectBySubjectIdAndCreatedAt(subjectId: $subjectId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
-          items {
-            id question imageUrl language level difficulty type voteCount
-            verificationStatus owner packId subjectId chapterId topicId createdAt
-            options { items { id content } }
-          }
-          nextToken
+    const hasLanguage = Boolean(input.language && input.language !== "All" && input.language !== "Any");
+    const hasDifficulty = Boolean(input.difficulty && input.difficulty !== "All");
+    const filter = {};
+    if (input.publicExam) {
+      filter.publicExam = { eq: input.publicExam };
+    }
+    if (input.questionType && input.questionType !== "Both") {
+      filter.type = { eq: input.questionType };
+    }
+    const targetLimit = input.limit ?? 12;
+    const executeQuery = async (pageLimit, nextToken) => {
+      if (hasLanguage) {
+        const rangeKey = hasDifficulty ? `${input.language}#${input.difficulty}#` : `${input.language}#`;
+        const variables = {
+          subjectId: input.id,
+          language_difficulty_createdAt: { beginsWith: rangeKey },
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(filter).length > 0 ? { filter } : {}
+        };
+        const result = await this.network.query(
+          `query ListQuestionsBySubjectAndLangDiff($subjectId: String!, $language_difficulty_createdAt: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelQuestionObjectFilterInput) {
+            listQuestionObjectBySubjectIdAndLanguage_difficulty_createdAt(subjectId: $subjectId, language_difficulty_createdAt: $language_difficulty_createdAt, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id question imageUrl language level publicExam difficulty type voteCount
+                verificationStatus owner packId subjectId chapterId topicId createdAt
+                options { items { id content } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listQuestionObjectBySubjectIdAndLanguage_difficulty_createdAt;
+      } else {
+        const queryFilter = { ...filter };
+        if (hasDifficulty) {
+          queryFilter.difficulty = { eq: input.difficulty };
         }
-      }`,
-      variables
-    );
-    return result.data.listQuestionObjectBySubjectIdAndCreatedAt;
+        const variables = {
+          subjectId: input.id,
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(queryFilter).length > 0 ? { filter: queryFilter } : {}
+        };
+        const result = await this.network.query(
+          `query ListQuestionsBySubject($subjectId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelQuestionObjectFilterInput) {
+            listQuestionObjectBySubjectIdAndCreatedAt(subjectId: $subjectId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id question imageUrl language level publicExam difficulty type voteCount
+                verificationStatus owner packId subjectId chapterId topicId createdAt
+                options { items { id content } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listQuestionObjectBySubjectIdAndCreatedAt;
+      }
+    };
+    const hasPostFilter = hasLanguage ? Object.keys(filter).length > 0 : Object.keys(filter).length > 0 || hasDifficulty;
+    if (!hasPostFilter) {
+      return executeQuery(targetLimit, input.nextToken);
+    }
+    return paginateWithAccumulator(executeQuery, targetLimit, input.nextToken);
   }
   async listByChapter(input) {
-    const variables = {
-      chapterId: input.id,
-      sortDirection: input.sortDirection ?? "DESC",
-      limit: input.limit ?? 20,
-      nextToken: input.nextToken
-    };
-    const result = await this.network.query(
-      `query ListQuestionsByChapter($chapterId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
-        listQuestionObjectByChapterIdAndCreatedAt(chapterId: $chapterId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
-          items {
-            id question imageUrl language level difficulty type voteCount
-            verificationStatus owner packId subjectId chapterId topicId createdAt
-            options { items { id content } }
-          }
-          nextToken
+    const hasLanguage = Boolean(input.language && input.language !== "All" && input.language !== "Any");
+    const hasDifficulty = Boolean(input.difficulty && input.difficulty !== "All");
+    const filter = {};
+    if (input.publicExam) {
+      filter.publicExam = { eq: input.publicExam };
+    }
+    if (input.questionType && input.questionType !== "Both") {
+      filter.type = { eq: input.questionType };
+    }
+    const targetLimit = input.limit ?? 12;
+    const executeQuery = async (pageLimit, nextToken) => {
+      if (hasLanguage) {
+        const rangeKey = hasDifficulty ? `${input.language}#${input.difficulty}#` : `${input.language}#`;
+        const variables = {
+          chapterId: input.id,
+          language_difficulty_createdAt: { beginsWith: rangeKey },
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(filter).length > 0 ? { filter } : {}
+        };
+        const result = await this.network.query(
+          `query ListQuestionsByChapterAndLangDiff($chapterId: String!, $language_difficulty_createdAt: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelQuestionObjectFilterInput) {
+            listQuestionObjectByChapterIdAndLanguage_difficulty_createdAt(chapterId: $chapterId, language_difficulty_createdAt: $language_difficulty_createdAt, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id question imageUrl language level publicExam difficulty type voteCount
+                verificationStatus owner packId subjectId chapterId topicId createdAt
+                options { items { id content } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listQuestionObjectByChapterIdAndLanguage_difficulty_createdAt;
+      } else {
+        const queryFilter = { ...filter };
+        if (hasDifficulty) {
+          queryFilter.difficulty = { eq: input.difficulty };
         }
-      }`,
-      variables
-    );
-    return result.data.listQuestionObjectByChapterIdAndCreatedAt;
+        const variables = {
+          chapterId: input.id,
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(queryFilter).length > 0 ? { filter: queryFilter } : {}
+        };
+        const result = await this.network.query(
+          `query ListQuestionsByChapter($chapterId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelQuestionObjectFilterInput) {
+            listQuestionObjectByChapterIdAndCreatedAt(chapterId: $chapterId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id question imageUrl language level publicExam difficulty type voteCount
+                verificationStatus owner packId subjectId chapterId topicId createdAt
+                options { items { id content } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listQuestionObjectByChapterIdAndCreatedAt;
+      }
+    };
+    const hasPostFilter = hasLanguage ? Object.keys(filter).length > 0 : Object.keys(filter).length > 0 || hasDifficulty;
+    if (!hasPostFilter) {
+      return executeQuery(targetLimit, input.nextToken);
+    }
+    return paginateWithAccumulator(executeQuery, targetLimit, input.nextToken);
   }
   async listByTopic(input) {
-    const variables = {
-      topicId: input.id,
-      sortDirection: input.sortDirection ?? "DESC",
-      limit: input.limit ?? 20,
-      nextToken: input.nextToken
+    const hasLanguage = Boolean(input.language && input.language !== "All" && input.language !== "Any");
+    const hasDifficulty = Boolean(input.difficulty && input.difficulty !== "All");
+    const filter = {};
+    if (input.publicExam) {
+      filter.publicExam = { eq: input.publicExam };
+    }
+    if (input.questionType && input.questionType !== "Both") {
+      filter.type = { eq: input.questionType };
+    }
+    const targetLimit = input.limit ?? 12;
+    const executeQuery = async (pageLimit, nextToken) => {
+      if (hasLanguage) {
+        const rangeKey = hasDifficulty ? `${input.language}#${input.difficulty}#` : `${input.language}#`;
+        const variables = {
+          topicId: input.id,
+          language_difficulty_createdAt: { beginsWith: rangeKey },
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(filter).length > 0 ? { filter } : {}
+        };
+        const result = await this.network.query(
+          `query ListQuestionsByTopicAndLangDiff($topicId: String!, $language_difficulty_createdAt: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelQuestionObjectFilterInput) {
+            listQuestionObjectByTopicIdAndLanguage_difficulty_createdAt(topicId: $topicId, language_difficulty_createdAt: $language_difficulty_createdAt, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id question imageUrl language level publicExam difficulty type voteCount
+                verificationStatus owner packId subjectId chapterId topicId createdAt
+                options { items { id content } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listQuestionObjectByTopicIdAndLanguage_difficulty_createdAt;
+      } else {
+        const queryFilter = { ...filter };
+        if (hasDifficulty) {
+          queryFilter.difficulty = { eq: input.difficulty };
+        }
+        const variables = {
+          topicId: input.id,
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(queryFilter).length > 0 ? { filter: queryFilter } : {}
+        };
+        const result = await this.network.query(
+          `query ListQuestionsByTopic($topicId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelQuestionObjectFilterInput) {
+            listQuestionObjectByTopicIdAndCreatedAt(topicId: $topicId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id question imageUrl language level publicExam difficulty type voteCount
+                verificationStatus owner packId subjectId chapterId topicId createdAt
+                options { items { id content } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listQuestionObjectByTopicIdAndCreatedAt;
+      }
     };
-    const result = await this.network.query(
-      `query ListQuestionsByTopic($topicId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
-        listQuestionObjectByTopicIdAndCreatedAt(topicId: $topicId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
-          items {
-            id question imageUrl language level difficulty type voteCount
-            verificationStatus owner packId subjectId chapterId topicId createdAt
-            options { items { id content } }
+    const hasPostFilter = hasLanguage ? Object.keys(filter).length > 0 : Object.keys(filter).length > 0 || hasDifficulty;
+    if (!hasPostFilter) {
+      return executeQuery(targetLimit, input.nextToken);
+    }
+    return paginateWithAccumulator(executeQuery, targetLimit, input.nextToken);
+  }
+  async listByPublicExam(input) {
+    const hasLanguage = Boolean(input.language && input.language !== "All" && input.language !== "Any");
+    const hasDifficulty = Boolean(input.difficulty && input.difficulty !== "All");
+    const filter = {};
+    if (input.questionType && input.questionType !== "Both") {
+      filter.type = { eq: input.questionType };
+    }
+    const targetLimit = input.limit ?? 12;
+    const executeQuery = async (pageLimit, nextToken) => {
+      if (hasLanguage) {
+        const rangeKey = hasDifficulty ? `${input.language}#${input.difficulty}#` : `${input.language}#`;
+        const variables2 = {
+          publicExam: input.publicExam,
+          language_difficulty_createdAt: { beginsWith: rangeKey },
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(filter).length > 0 ? { filter } : {}
+        };
+        try {
+          const result2 = await this.network.query(
+            `query ListQuestionsByPublicExamAndLangDiff($publicExam: String!, $language_difficulty_createdAt: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelQuestionObjectFilterInput) {
+              listQuestionObjectByPublicExamAndLanguage_difficulty_createdAt(publicExam: $publicExam, language_difficulty_createdAt: $language_difficulty_createdAt, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+                items {
+                  id question imageUrl language level publicExam difficulty type voteCount
+                  verificationStatus owner packId subjectId chapterId topicId createdAt
+                  options { items { id content } }
+                }
+                nextToken
+              }
+            }`,
+            variables2
+          );
+          if (result2.data?.listQuestionObjectByPublicExamAndLanguage_difficulty_createdAt) {
+            return result2.data.listQuestionObjectByPublicExamAndLanguage_difficulty_createdAt;
           }
-          nextToken
+        } catch {
         }
-      }`,
-      variables
-    );
-    return result.data.listQuestionObjectByTopicIdAndCreatedAt;
+      }
+      const fallbackFilter = { ...filter };
+      if (hasLanguage) {
+        fallbackFilter.language = { eq: input.language };
+      }
+      if (hasDifficulty) {
+        fallbackFilter.difficulty = { eq: input.difficulty };
+      }
+      const variables = {
+        publicExam: input.publicExam,
+        sortDirection: input.sortDirection ?? "DESC",
+        limit: pageLimit,
+        nextToken,
+        ...Object.keys(fallbackFilter).length > 0 ? { filter: fallbackFilter } : {}
+      };
+      const result = await this.network.query(
+        `query ListQuestionsByPublicExam($publicExam: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelQuestionObjectFilterInput) {
+          listQuestionObjectByPublicExamAndCreatedAt(publicExam: $publicExam, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+            items {
+              id question imageUrl language level publicExam difficulty type voteCount
+              verificationStatus owner packId subjectId chapterId topicId createdAt
+              options { items { id content } }
+            }
+            nextToken
+          }
+        }`,
+        variables
+      );
+      return result.data.listQuestionObjectByPublicExamAndCreatedAt;
+    };
+    const hasPostFilter = hasLanguage ? Object.keys(filter).length > 0 : Object.keys(filter).length > 0 || hasLanguage || hasDifficulty;
+    if (!hasPostFilter) {
+      return executeQuery(targetLimit, input.nextToken);
+    }
+    return paginateWithAccumulator(executeQuery, targetLimit, input.nextToken);
   }
   async listByRandomHash(input) {
     const compositeKey = [input.language, input.difficulty].filter(Boolean).join("_");
@@ -374,7 +664,7 @@ var QuestionService = class {
       `query ListByRandomHash($subjectId: String!, $language_difficulty_randomHash: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int) {
         listQuestionObjectBySubjectIdAndLanguage_difficulty_randomHash(subjectId: $subjectId, language_difficulty_randomHash: $language_difficulty_randomHash, sortDirection: $sortDirection, limit: $limit) {
           items {
-            id question imageUrl language level difficulty type voteCount
+            id question imageUrl language level publicExam difficulty type voteCount
             verificationStatus owner packId subjectId chapterId topicId createdAt
             options { items { id content } }
           }
@@ -385,6 +675,76 @@ var QuestionService = class {
     );
     return result.data.listQuestionObjectBySubjectIdAndLanguage_difficulty_randomHash;
   }
+  async listByLevel(input) {
+    const hasLanguage = Boolean(input.language && input.language !== "All" && input.language !== "Any");
+    const hasDifficulty = Boolean(input.difficulty && input.difficulty !== "All");
+    const filter = {};
+    if (input.publicExam) {
+      filter.publicExam = { eq: input.publicExam };
+    }
+    if (input.questionType && input.questionType !== "Both") {
+      filter.type = { eq: input.questionType };
+    }
+    const targetLimit = input.limit ?? 12;
+    const executeQuery = async (pageLimit, nextToken) => {
+      if (hasLanguage) {
+        const rangeKey = hasDifficulty ? `${input.language}#${input.difficulty}#` : `${input.language}#`;
+        const variables = {
+          level: input.level,
+          language_difficulty_createdAt: { beginsWith: rangeKey },
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(filter).length > 0 ? { filter } : {}
+        };
+        const result = await this.network.query(
+          `query ListQuestionsByLevelAndLangDiff($level: String!, $language_difficulty_createdAt: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelQuestionObjectFilterInput) {
+            listQuestionObjectByLevelAndLanguage_difficulty_createdAt(level: $level, language_difficulty_createdAt: $language_difficulty_createdAt, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id question imageUrl language level publicExam difficulty type voteCount
+                verificationStatus owner packId subjectId chapterId topicId createdAt
+                options { items { id content } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listQuestionObjectByLevelAndLanguage_difficulty_createdAt;
+      } else {
+        const queryFilter = { ...filter };
+        if (hasDifficulty) {
+          queryFilter.difficulty = { eq: input.difficulty };
+        }
+        const variables = {
+          level: input.level,
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(queryFilter).length > 0 ? { filter: queryFilter } : {}
+        };
+        const result = await this.network.query(
+          `query ListQuestionsByLevel($level: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelQuestionObjectFilterInput) {
+            listQuestionObjectByLevelAndCreatedAt(level: $level, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id question imageUrl language level publicExam difficulty type voteCount
+                verificationStatus owner packId subjectId chapterId topicId createdAt
+                options { items { id content } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listQuestionObjectByLevelAndCreatedAt;
+      }
+    };
+    const hasPostFilter = hasLanguage ? Object.keys(filter).length > 0 : Object.keys(filter).length > 0 || hasDifficulty;
+    if (!hasPostFilter) {
+      return executeQuery(targetLimit, input.nextToken);
+    }
+    return paginateWithAccumulator(executeQuery, targetLimit, input.nextToken);
+  }
 };
 
 // src/services/pack.service.ts
@@ -394,8 +754,8 @@ var PackService = class {
   }
   async create(input) {
     const result = await this.network.mutate(
-      `mutation CreatePack($name: String!, $level: String!, $language: String!, $difficulty: String!, $automaticNumbering: Boolean, $subjectId: ID, $chapterId: ID, $topicId: ID) {
-        createPackObject(name: $name, level: $level, language: $language, difficulty: $difficulty, automaticNumbering: $automaticNumbering, subjectId: $subjectId, chapterId: $chapterId, topicId: $topicId) {
+      `mutation CreatePack($name: String!, $level: String!, $publicExam: String, $language: String!, $difficulty: String!, $automaticNumbering: Boolean, $subjectId: ID, $chapterId: ID, $topicId: ID) {
+        createPackObject(name: $name, level: $level, publicExam: $publicExam, language: $language, difficulty: $difficulty, automaticNumbering: $automaticNumbering, subjectId: $subjectId, chapterId: $chapterId, topicId: $topicId) {
           status id
         }
       }`,
@@ -407,7 +767,7 @@ var PackService = class {
     const result = await this.network.query(
       `query GetPack($id: ID!) {
         getPack(id: $id) {
-          id name language level difficulty questionCount automaticNumbering
+          id name language level publicExam difficulty questionCount automaticNumbering
           owner subjectId chapterId topicId packGroupId verificationStatus createdAt
           tags { items { id tagId } }
           user { id fullName avatarUrl }
@@ -421,13 +781,13 @@ var PackService = class {
     const result = await this.network.query(
       `query GetFullPack($id: ID!) {
         getPack(id: $id) {
-          id name language level difficulty questionCount automaticNumbering
+          id name language level publicExam difficulty questionCount automaticNumbering
           owner subjectId chapterId topicId packGroupId verificationStatus createdAt
           tags { items { id tagId } }
           user { id fullName avatarUrl }
           questions(sortDirection: ASC, limit: 200) {
             items {
-              id question answer explanation extra imageUrl language level difficulty type
+              id question answer explanation extra imageUrl language level publicExam difficulty type
               markingInstructions voteCount owner order createdAt
               options { items { id content } }
               tags { items { id tagId } }
@@ -440,6 +800,11 @@ var PackService = class {
     const pack = result.data.getPack;
     if (pack && pack.questions && Array.isArray(pack.questions.items)) {
       pack.questions.items.sort((a, b) => {
+        const isWrittenA = a.type === "WRITTEN" ? 1 : 0;
+        const isWrittenB = b.type === "WRITTEN" ? 1 : 0;
+        if (isWrittenA !== isWrittenB) {
+          return isWrittenA - isWrittenB;
+        }
         const orderA = typeof a.order === "number" ? a.order : a.order ? Number(a.order) : 0;
         const orderB = typeof b.order === "number" ? b.order : b.order ? Number(b.order) : 0;
         if (orderA !== orderB) {
@@ -458,7 +823,7 @@ var PackService = class {
     const result = await this.network.mutate(
       `mutation UpdatePack($input: UpdatePackInput!) {
         updatePack(input: $input) {
-          id name language level difficulty questionCount automaticNumbering
+          id name language level publicExam difficulty questionCount automaticNumbering
           owner subjectId chapterId topicId verificationStatus createdAt
         }
       }`,
@@ -468,12 +833,15 @@ var PackService = class {
   }
   async delete(id) {
     const result = await this.network.mutate(
-      `mutation DeletePack($input: DeletePackInput!) {
-        deletePack(input: $input) { id }
+      `mutation DeletePackCascade($packId: ID!) {
+        deletePackCascade(packId: $packId) { status }
       }`,
-      { input: { id } }
+      { packId: id }
     );
-    return result.data.deletePack;
+    if (result.data.deletePackCascade?.status === "success") {
+      return { id };
+    }
+    return null;
   }
   async verify(id, userId) {
     const result = await this.network.mutate(
@@ -493,7 +861,27 @@ var PackService = class {
     );
     return result.data.createPackReport;
   }
-  async submitExam(packId, selectedOptions) {
+  async submitExam(packId, selectedOptions, options) {
+    if (options?.functionUrl) {
+      try {
+        const headers = { "Content-Type": "application/json" };
+        if (options.authToken) {
+          headers["Authorization"] = `Bearer ${options.authToken}`;
+        }
+        const response = await fetch(options.functionUrl, {
+          method: "POST",
+          headers,
+          body: JSON.stringify({ packId, selectedOptions: JSON.stringify(selectedOptions) })
+        });
+        if (response.ok) {
+          const data = await response.json();
+          return data;
+        }
+        console.warn(`[PackService] Function URL failed with status ${response.status}, falling back to GraphQL...`);
+      } catch (err) {
+        console.warn("[PackService] Function URL fetch error, falling back to GraphQL...", err);
+      }
+    }
     const result = await this.network.mutate(
       `mutation SubmitPackExam($packId: ID!, $selectedOptions: String!) {
         submitPackExam(packId: $packId, selectedOptions: $selectedOptions) {
@@ -510,7 +898,7 @@ var PackService = class {
         listPackExamResultsByOwnerAndCreatedAt(owner: $owner, sortDirection: $sortDirection, nextToken: $nextToken) {
           items {
             id packId selectedOptions aiEvaluations owner createdAt
-            pack { id name language level difficulty questionCount }
+            pack { id name language level publicExam difficulty questionCount }
           }
           nextToken
         }
@@ -524,7 +912,7 @@ var PackService = class {
       `query GetPackExamResult($id: ID!) {
         getPackExamResults(id: $id) {
           id packId selectedOptions aiEvaluations owner createdAt
-          pack { id name language level difficulty questionCount }
+          pack { id name language level publicExam difficulty questionCount }
         }
       }`,
       { id: resultId }
@@ -532,79 +920,462 @@ var PackService = class {
     return result.data.getPackExamResults;
   }
   async listBySubject(input) {
-    const result = await this.network.query(
-      `query ListPacksBySubject($subjectId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
-        listPackBySubjectIdAndCreatedAt(subjectId: $subjectId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
-          items {
-            id name language level difficulty questionCount owner createdAt verificationStatus
-            tags { items { id tagId } }
-          }
-          nextToken
+    const hasLanguage = Boolean(input.language && input.language !== "All" && input.language !== "Any");
+    const hasDifficulty = Boolean(input.difficulty && input.difficulty !== "All");
+    const filter = {};
+    if (input.publicExam) {
+      filter.publicExam = { eq: input.publicExam };
+    }
+    const targetLimit = input.limit ?? 12;
+    const executeQuery = async (pageLimit, nextToken) => {
+      if (hasLanguage) {
+        const rangeKey = hasDifficulty ? `${input.language}#${input.difficulty}#` : `${input.language}#`;
+        const variables = {
+          subjectId: input.id,
+          language_difficulty_createdAt: { beginsWith: rangeKey },
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(filter).length > 0 ? { filter } : {}
+        };
+        const result = await this.network.query(
+          `query ListPacksBySubjectAndLangDiff($subjectId: String!, $language_difficulty_createdAt: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelPackFilterInput) {
+            listPackBySubjectIdAndLanguage_difficulty_createdAt(subjectId: $subjectId, language_difficulty_createdAt: $language_difficulty_createdAt, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+                tags { items { id tagId } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listPackBySubjectIdAndLanguage_difficulty_createdAt;
+      } else {
+        const queryFilter = { ...filter };
+        if (hasDifficulty) {
+          queryFilter.difficulty = { eq: input.difficulty };
         }
-      }`,
-      { subjectId: input.id, sortDirection: "DESC", limit: input.limit ?? 20, nextToken: input.nextToken }
-    );
-    return result.data.listPackBySubjectIdAndCreatedAt;
+        const variables = {
+          subjectId: input.id,
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(queryFilter).length > 0 ? { filter: queryFilter } : {}
+        };
+        const result = await this.network.query(
+          `query ListPacksBySubject($subjectId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelPackFilterInput) {
+            listPackBySubjectIdAndCreatedAt(subjectId: $subjectId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+                tags { items { id tagId } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listPackBySubjectIdAndCreatedAt;
+      }
+    };
+    const hasPostFilter = hasLanguage ? Object.keys(filter).length > 0 : Object.keys(filter).length > 0 || hasDifficulty;
+    if (!hasPostFilter) {
+      return executeQuery(targetLimit, input.nextToken);
+    }
+    return paginateWithAccumulator(executeQuery, targetLimit, input.nextToken);
   }
   async listByChapter(input) {
-    const result = await this.network.query(
-      `query ListPacksByChapter($chapterId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
-        listPackByChapterIdAndCreatedAt(chapterId: $chapterId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
-          items {
-            id name language level difficulty questionCount owner createdAt verificationStatus
-            tags { items { id tagId } }
-          }
-          nextToken
+    const hasLanguage = Boolean(input.language && input.language !== "All" && input.language !== "Any");
+    const hasDifficulty = Boolean(input.difficulty && input.difficulty !== "All");
+    const filter = {};
+    if (input.publicExam) {
+      filter.publicExam = { eq: input.publicExam };
+    }
+    const targetLimit = input.limit ?? 12;
+    const executeQuery = async (pageLimit, nextToken) => {
+      if (hasLanguage) {
+        const rangeKey = hasDifficulty ? `${input.language}#${input.difficulty}#` : `${input.language}#`;
+        const variables = {
+          chapterId: input.id,
+          language_difficulty_createdAt: { beginsWith: rangeKey },
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(filter).length > 0 ? { filter } : {}
+        };
+        const result = await this.network.query(
+          `query ListPacksByChapterAndLangDiff($chapterId: String!, $language_difficulty_createdAt: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelPackFilterInput) {
+            listPackByChapterIdAndLanguage_difficulty_createdAt(chapterId: $chapterId, language_difficulty_createdAt: $language_difficulty_createdAt, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+                tags { items { id tagId } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listPackByChapterIdAndLanguage_difficulty_createdAt;
+      } else {
+        const queryFilter = { ...filter };
+        if (hasDifficulty) {
+          queryFilter.difficulty = { eq: input.difficulty };
         }
-      }`,
-      { chapterId: input.id, sortDirection: "DESC", limit: input.limit ?? 20, nextToken: input.nextToken }
-    );
-    return result.data.listPackByChapterIdAndCreatedAt;
+        const variables = {
+          chapterId: input.id,
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(queryFilter).length > 0 ? { filter: queryFilter } : {}
+        };
+        const result = await this.network.query(
+          `query ListPacksByChapter($chapterId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelPackFilterInput) {
+            listPackByChapterIdAndCreatedAt(chapterId: $chapterId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+                tags { items { id tagId } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listPackByChapterIdAndCreatedAt;
+      }
+    };
+    const hasPostFilter = hasLanguage ? Object.keys(filter).length > 0 : Object.keys(filter).length > 0 || hasDifficulty;
+    if (!hasPostFilter) {
+      return executeQuery(targetLimit, input.nextToken);
+    }
+    return paginateWithAccumulator(executeQuery, targetLimit, input.nextToken);
   }
   async listByTopic(input) {
-    const result = await this.network.query(
-      `query ListPacksByTopic($topicId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
-        listPackByTopicIdAndCreatedAt(topicId: $topicId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
-          items {
-            id name language level difficulty questionCount owner createdAt verificationStatus
-            tags { items { id tagId } }
+    const hasLanguage = Boolean(input.language && input.language !== "All" && input.language !== "Any");
+    const hasDifficulty = Boolean(input.difficulty && input.difficulty !== "All");
+    const filter = {};
+    if (input.publicExam) {
+      filter.publicExam = { eq: input.publicExam };
+    }
+    const targetLimit = input.limit ?? 12;
+    const executeQuery = async (pageLimit, nextToken) => {
+      if (hasLanguage) {
+        const rangeKey = hasDifficulty ? `${input.language}#${input.difficulty}#` : `${input.language}#`;
+        const variables = {
+          topicId: input.id,
+          language_difficulty_createdAt: { beginsWith: rangeKey },
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(filter).length > 0 ? { filter } : {}
+        };
+        const result = await this.network.query(
+          `query ListPacksByTopicAndLangDiff($topicId: String!, $language_difficulty_createdAt: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelPackFilterInput) {
+            listPackByTopicIdAndLanguage_difficulty_createdAt(topicId: $topicId, language_difficulty_createdAt: $language_difficulty_createdAt, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+                tags { items { id tagId } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listPackByTopicIdAndLanguage_difficulty_createdAt;
+      } else {
+        const queryFilter = { ...filter };
+        if (hasDifficulty) {
+          queryFilter.difficulty = { eq: input.difficulty };
+        }
+        const variables = {
+          topicId: input.id,
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(queryFilter).length > 0 ? { filter: queryFilter } : {}
+        };
+        const result = await this.network.query(
+          `query ListPacksByTopic($topicId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelPackFilterInput) {
+            listPackByTopicIdAndCreatedAt(topicId: $topicId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+                tags { items { id tagId } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listPackByTopicIdAndCreatedAt;
+      }
+    };
+    const hasPostFilter = hasLanguage ? Object.keys(filter).length > 0 : Object.keys(filter).length > 0 || hasDifficulty;
+    if (!hasPostFilter) {
+      return executeQuery(targetLimit, input.nextToken);
+    }
+    return paginateWithAccumulator(executeQuery, targetLimit, input.nextToken);
+  }
+  async listByPublicExam(input) {
+    const hasLanguage = Boolean(input.language && input.language !== "All" && input.language !== "Any");
+    const hasDifficulty = Boolean(input.difficulty && input.difficulty !== "All");
+    const filter = {};
+    const targetLimit = input.limit ?? 12;
+    const executeQuery = async (pageLimit, nextToken) => {
+      if (hasLanguage) {
+        const rangeKey = hasDifficulty ? `${input.language}#${input.difficulty}#` : `${input.language}#`;
+        const variables = {
+          publicExam: input.publicExam,
+          language_difficulty_createdAt: { beginsWith: rangeKey },
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(filter).length > 0 ? { filter } : {}
+        };
+        try {
+          const result2 = await this.network.query(
+            `query ListPacksByPublicExamAndLangDiff($publicExam: String!, $language_difficulty_createdAt: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelPackFilterInput) {
+              listPackByPublicExamAndLanguage_difficulty_createdAt(publicExam: $publicExam, language_difficulty_createdAt: $language_difficulty_createdAt, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+                items {
+                  id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+                  tags { items { id tagId } }
+                }
+                nextToken
+              }
+            }`,
+            variables
+          );
+          if (result2.data?.listPackByPublicExamAndLanguage_difficulty_createdAt) {
+            return result2.data.listPackByPublicExamAndLanguage_difficulty_createdAt;
           }
-          nextToken
+        } catch {
         }
-      }`,
-      { topicId: input.id, sortDirection: "DESC", limit: input.limit ?? 20, nextToken: input.nextToken }
-    );
-    return result.data.listPackByTopicIdAndCreatedAt;
-  }
-  async listGroups(type, level) {
-    const queryField = level ? "listPackGroupByTypeLevelAndOrder" : "listPackGroupByTypeAndOrder";
-    const variables = level ? { typeLevel: `${type}_${level}`, sortDirection: "ASC" } : { type, sortDirection: "ASC" };
-    const result = await this.network.query(
-      level ? `query ListPackGroups($typeLevel: String!, $sortDirection: ModelSortDirection) {
-            listPackGroupByTypeLevelAndOrder(typeLevel: $typeLevel, sortDirection: $sortDirection) {
-              items { id name description imageUrl type level typeLevel packCount order }
+      }
+      const fallbackFilter = { ...filter };
+      if (hasLanguage) {
+        fallbackFilter.language = { eq: input.language };
+      }
+      if (hasDifficulty) {
+        fallbackFilter.difficulty = { eq: input.difficulty };
+      }
+      try {
+        const variables = {
+          publicExam: input.publicExam,
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(fallbackFilter).length > 0 ? { filter: fallbackFilter } : {}
+        };
+        const result2 = await this.network.query(
+          `query ListPacksByPublicExam($publicExam: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelPackFilterInput) {
+            listPackByPublicExamAndCreatedAt(publicExam: $publicExam, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+                tags { items { id tagId } }
+              }
+              nextToken
             }
-          }` : `query ListPackGroups($type: String!, $sortDirection: ModelSortDirection) {
-            listPackGroupByTypeAndOrder(type: $type, sortDirection: $sortDirection) {
-              items { id name description imageUrl type level typeLevel packCount order }
+          }`,
+          variables
+        );
+        if (result2.data?.listPackByPublicExamAndCreatedAt) {
+          return result2.data.listPackByPublicExamAndCreatedAt;
+        }
+      } catch {
+      }
+      const scanFilter = {
+        publicExam: { eq: input.publicExam },
+        ...fallbackFilter
+      };
+      const result = await this.network.query(
+        `query ListPacksFallback($filter: ModelPackFilterInput, $limit: Int, $nextToken: String) {
+          listPacks(filter: $filter, limit: $limit, nextToken: $nextToken) {
+            items {
+              id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+              tags { items { id tagId } }
+            }
+            nextToken
+          }
+        }`,
+        { filter: scanFilter, limit: pageLimit, nextToken }
+      );
+      return result.data.listPacks;
+    };
+    const hasPostFilter = hasLanguage ? Object.keys(filter).length > 0 : Object.keys(filter).length > 0 || hasLanguage || hasDifficulty;
+    if (!hasPostFilter) {
+      return executeQuery(targetLimit, input.nextToken);
+    }
+    return paginateWithAccumulator(executeQuery, targetLimit, input.nextToken);
+  }
+  async listByLevel(input) {
+    const hasLanguage = Boolean(input.language && input.language !== "All" && input.language !== "Any");
+    const hasDifficulty = Boolean(input.difficulty && input.difficulty !== "All");
+    const filter = {};
+    if (input.publicExam) {
+      filter.publicExam = { eq: input.publicExam };
+    }
+    const targetLimit = input.limit ?? 12;
+    const executeQuery = async (pageLimit, nextToken) => {
+      if (hasLanguage) {
+        const rangeKey = hasDifficulty ? `${input.language}#${input.difficulty}#` : `${input.language}#`;
+        const variables = {
+          level: input.level,
+          language_difficulty_createdAt: { beginsWith: rangeKey },
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(filter).length > 0 ? { filter } : {}
+        };
+        const result = await this.network.query(
+          `query ListPacksByLevelAndLangDiff($level: String!, $language_difficulty_createdAt: ModelStringKeyConditionInput, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelPackFilterInput) {
+            listPackByLevelAndLanguage_difficulty_createdAt(level: $level, language_difficulty_createdAt: $language_difficulty_createdAt, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+                tags { items { id tagId } }
+              }
+              nextToken
             }
           }`,
-      variables
+          variables
+        );
+        return result.data.listPackByLevelAndLanguage_difficulty_createdAt;
+      } else {
+        const queryFilter = { ...filter };
+        if (hasDifficulty) {
+          queryFilter.difficulty = { eq: input.difficulty };
+        }
+        const variables = {
+          level: input.level,
+          sortDirection: input.sortDirection ?? "DESC",
+          limit: pageLimit,
+          nextToken,
+          ...Object.keys(queryFilter).length > 0 ? { filter: queryFilter } : {}
+        };
+        const result = await this.network.query(
+          `query ListPacksByLevel($level: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String, $filter: ModelPackFilterInput) {
+            listPackByLevelAndCreatedAt(level: $level, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken, filter: $filter) {
+              items {
+                id name language level publicExam difficulty questionCount owner createdAt verificationStatus subjectId chapterId topicId
+                tags { items { id tagId } }
+              }
+              nextToken
+            }
+          }`,
+          variables
+        );
+        return result.data.listPackByLevelAndCreatedAt;
+      }
+    };
+    const hasPostFilter = hasLanguage ? Object.keys(filter).length > 0 : Object.keys(filter).length > 0 || hasDifficulty;
+    if (!hasPostFilter) {
+      return executeQuery(targetLimit, input.nextToken);
+    }
+    return paginateWithAccumulator(executeQuery, targetLimit, input.nextToken);
+  }
+  async createGroup(input) {
+    const typeLevel = input.type && input.level ? `${input.type}_${input.level}` : void 0;
+    const mutationInput = {
+      name: input.name,
+      description: input.description,
+      imageUrl: input.imageUrl,
+      type: input.type,
+      level: input.level,
+      typeLevel,
+      order: input.order
+    };
+    const result = await this.network.mutate(
+      `mutation CreatePackGroup($input: CreatePackGroupInput!) {
+        createPackGroup(input: $input) {
+          id name description imageUrl type level typeLevel packCount order
+        }
+      }`,
+      { input: mutationInput }
     );
-    return result.data[queryField].items;
+    const created = result.data.createPackGroup;
+    if (created && input.packIds && input.packIds.length > 0) {
+      await Promise.all(
+        input.packIds.map((pId) => this.update(pId, { packGroupId: created.id }))
+      );
+    }
+    return created;
+  }
+  async deleteGroup(id) {
+    const result = await this.network.mutate(
+      `mutation DeletePackGroup($input: DeletePackGroupInput!) {
+        deletePackGroup(input: $input) {
+          id
+        }
+      }`,
+      { input: { id } }
+    );
+    return result.data.deletePackGroup;
+  }
+  async listGroups(typeOrInput, level) {
+    let type;
+    let targetLevel;
+    let limit;
+    let nextToken;
+    let sortDirection = "ASC";
+    const isLegacyCall = typeof typeOrInput === "string";
+    if (isLegacyCall) {
+      type = typeOrInput;
+      targetLevel = level;
+    } else {
+      type = typeOrInput.type ?? "QB";
+      targetLevel = typeOrInput.level;
+      limit = typeOrInput.limit;
+      nextToken = typeOrInput.nextToken;
+      sortDirection = typeOrInput.sortDirection ?? "ASC";
+    }
+    const queryField = targetLevel ? "listPackGroupByTypeLevelAndOrder" : "listPackGroupByTypeAndOrder";
+    const variables = isLegacyCall ? targetLevel ? { typeLevel: `${type}_${targetLevel}`, sortDirection } : { type, sortDirection } : targetLevel ? { typeLevel: `${type}_${targetLevel}`, sortDirection, limit: limit ?? 20, nextToken } : { type, sortDirection, limit: limit ?? 20, nextToken };
+    const queryString = isLegacyCall ? targetLevel ? `query ListPackGroups($typeLevel: String!, $sortDirection: ModelSortDirection) {
+              listPackGroupByTypeLevelAndOrder(typeLevel: $typeLevel, sortDirection: $sortDirection) {
+                items { id name description imageUrl type level typeLevel packCount order }
+              }
+            }` : `query ListPackGroups($type: String!, $sortDirection: ModelSortDirection) {
+              listPackGroupByTypeAndOrder(type: $type, sortDirection: $sortDirection) {
+                items { id name description imageUrl type level typeLevel packCount order }
+              }
+            }` : targetLevel ? `query ListPackGroupsByLevel($typeLevel: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
+              listPackGroupByTypeLevelAndOrder(typeLevel: $typeLevel, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
+                items { id name description imageUrl type level typeLevel packCount order }
+                nextToken
+              }
+            }` : `query ListPackGroupsByType($type: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
+              listPackGroupByTypeAndOrder(type: $type, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
+                items { id name description imageUrl type level typeLevel packCount order }
+                nextToken
+              }
+            }`;
+    const result = await this.network.query(queryString, variables);
+    const paginated = result.data[queryField];
+    return isLegacyCall ? paginated.items : paginated;
   }
   async getGroup(id) {
     const result = await this.network.query(
       `query GetPackGroup($id: ID!) {
         getPackGroup(id: $id) {
           id name description imageUrl type level typeLevel packCount order
-          packs { items { id name language level difficulty questionCount owner createdAt verificationStatus } }
+          packs { items { id name language level publicExam difficulty questionCount owner createdAt verificationStatus } }
         }
       }`,
       { id }
     );
     return result.data.getPackGroup;
   }
+  async list(input) {
+    const result = await this.network.query(
+      `query ListPacks($limit: Int, $nextToken: String) {
+        listPacks(limit: $limit, nextToken: $nextToken) {
+          items {
+            id name language level publicExam difficulty questionCount owner createdAt verificationStatus packGroupId
+          }
+          nextToken
+        }
+      }`,
+      { limit: input?.limit ?? 20, nextToken: input?.nextToken }
+    );
+    return result.data.listPacks;
+  }
 };
 
 // src/services/contest.service.ts
@@ -962,6 +1733,28 @@ var CourseService = class {
     );
     return result.data.publishCourseLiveExamResults;
   }
+  async uploadCourseItem(input) {
+    const signed = await this.getSignedURL({
+      courseId: input.courseId,
+      fileName: input.fileName,
+      fileType: input.fileType,
+      parentId: input.parentId ?? void 0
+    });
+    if (signed && signed.signedURL && input.fileData) {
+      await fetch(signed.signedURL, {
+        method: "PUT",
+        body: input.fileData,
+        headers: { "Content-Type": input.fileType }
+      });
+    }
+    return this.createItem({
+      courseId: input.courseId,
+      name: input.itemName || input.fileName,
+      order: input.itemOrder,
+      type: "file",
+      parentId: input.parentId ?? void 0
+    });
+  }
 };
 
 // src/services/curriculum.service.ts
@@ -1029,6 +1822,67 @@ var CurriculumService = class {
     );
     return result.data.listTopicByChapterId.items;
   }
+  async recalculateQuestionCounts() {
+    let nextToken = null;
+    const counts = {};
+    do {
+      const res = await this.network.query(
+        `query ListQuestionsForRecalc($nextToken: String) {
+                    listQuestionObjects(limit: 1000, nextToken: $nextToken) {
+                        items { id subjectId chapterId topicId }
+                        nextToken
+                    }
+                }`,
+        { nextToken }
+      );
+      const items = res.data?.listQuestionObjects?.items || [];
+      for (const q of items) {
+        if (q.subjectId) counts[q.subjectId] = (counts[q.subjectId] || 0) + 1;
+      }
+      nextToken = res.data?.listQuestionObjects?.nextToken ?? null;
+    } while (nextToken);
+    const [hscSubjects, sscSubjects] = await Promise.all([
+      this.getSubjects("HSC").catch(() => []),
+      this.getSubjects("SSC").catch(() => [])
+    ]);
+    const allSubjects = [...hscSubjects, ...sscSubjects];
+    for (const s of allSubjects) {
+      await this.network.mutate(
+        `mutation UpdateSubjectCount($input: UpdateSubjectInput!) {
+                    updateSubject(input: $input) { id }
+                }`,
+        { input: { id: s.id, questionCount: counts[s.id] || 0 } }
+      );
+    }
+  }
+  async recalculateCreatorStats() {
+    let nextToken = null;
+    const userQuestionCounts = {};
+    do {
+      const res = await this.network.query(
+        `query ListQuestionsForCreatorStats($nextToken: String) {
+                    listQuestionObjects(limit: 1000, nextToken: $nextToken) {
+                        items { id owner }
+                        nextToken
+                    }
+                }`,
+        { nextToken }
+      );
+      const items = res.data?.listQuestionObjects?.items || [];
+      for (const q of items) {
+        if (q.owner) userQuestionCounts[q.owner] = (userQuestionCounts[q.owner] || 0) + 1;
+      }
+      nextToken = res.data?.listQuestionObjects?.nextToken ?? null;
+    } while (nextToken);
+    for (const [userId, count] of Object.entries(userQuestionCounts)) {
+      await this.network.mutate(
+        `mutation UpdateCreatorStats($input: UpdateUserInput!) {
+                    updateUser(input: $input) { id }
+                }`,
+        { input: { id: userId, questionCount: count } }
+      );
+    }
+  }
 };
 
 // src/services/media.service.ts
@@ -1207,7 +2061,7 @@ var ProgressService = class {
       return [];
     }
   }
-  async getMistakenQuestions(userId) {
+  async getMistakenQuestions(userId, status = "MISTAKE") {
     try {
       const result = await this.network.query(
         `query ListMistakes($userId: String!, $filter: ModelQuestionTrackingFilterInput) {
@@ -1215,7 +2069,7 @@ var ProgressService = class {
             items { id userId questionId subjectId chapterId topicId status attempts }
           }
         }`,
-        { userId, filter: { status: { eq: "MISTAKE" } } }
+        { userId, filter: { status: { eq: status } } }
       );
       return result.data?.listQuestionTrackingByUserIdAndQuestionId?.items || result.data?.listQuestionTrackingsByUserIdAndQuestionId?.items || result.data?.listQuestionTrackings?.items || [];
     } catch (e) {
@@ -1223,6 +2077,9 @@ var ProgressService = class {
       return [];
     }
   }
+  async getCorrectedQuestions(userId) {
+    return this.getMistakenQuestions(userId, "CORRECTED");
+  }
 };
 
 // src/services/ai.service.ts
@@ -1230,7 +2087,27 @@ var AIService = class {
   constructor(network) {
     this.network = network;
   }
-  async evaluateWrittenAnswer(input) {
+  async evaluateWrittenAnswer(input, options) {
+    if (options?.functionUrl) {
+      try {
+        const headers = { "Content-Type": "application/json" };
+        if (options.authToken) {
+          headers["Authorization"] = `Bearer ${options.authToken}`;
+        }
+        const response = await fetch(options.functionUrl, {
+          method: "POST",
+          headers,
+          body: JSON.stringify(input)
+        });
+        if (response.ok) {
+          const data = await response.json();
+          return data;
+        }
+        console.warn(`[AIService] Function URL failed with status ${response.status}, falling back to GraphQL...`);
+      } catch (err) {
+        console.warn("[AIService] Function URL fetch error, falling back to GraphQL...", err);
+      }
+    }
     const result = await this.network.query(
       `query EvaluateWrittenAnswer($question: String!, $userAnswer: String!, $correctAnswer: String!, $markingInstructions: String, $topicId: String, $topicName: String, $questionImageUrl: String) {
         evaluateWrittenAnswer(question: $question, userAnswer: $userAnswer, correctAnswer: $correctAnswer, markingInstructions: $markingInstructions, topicId: $topicId, topicName: $topicName, questionImageUrl: $questionImageUrl) {
@@ -1280,10 +2157,256 @@ var NewsService = class {
   }
 };
 
+// src/services/notification.service.ts
+var NotificationService = class {
+  constructor(network) {
+    this.network = network;
+  }
+  /**
+   * List broadcast announcements (ordered by category and createdAt).
+   */
+  async listAnnouncements(limit = 20, nextToken) {
+    const result = await this.network.query(
+      `query ListAnnouncements($limit: Int, $nextToken: String) {
+        listAnnouncements(limit: $limit, nextToken: $nextToken) {
+          items {
+            id title message senderType senderName senderAvatar category actionUrl priority createdAt updatedAt
+          }
+          nextToken
+        }
+      }`,
+      { limit, nextToken }
+    );
+    return result.data.listAnnouncements ?? { items: [], nextToken: null };
+  }
+  /**
+   * List announcements by category.
+   */
+  async listAnnouncementsByCategory(category = "ANNOUNCEMENT", limit = 20, nextToken) {
+    const result = await this.network.query(
+      `query ListAnnouncementsByCategory($category: String!, $limit: Int, $nextToken: String, $sortDirection: ModelSortDirection) {
+        listAnnouncementByCategoryAndCreatedAt(category: $category, limit: $limit, nextToken: $nextToken, sortDirection: $sortDirection) {
+          items {
+            id title message senderType senderName senderAvatar category actionUrl priority createdAt updatedAt
+          }
+          nextToken
+        }
+      }`,
+      { category, limit, nextToken, sortDirection: "DESC" }
+    );
+    return result.data.listAnnouncementByCategoryAndCreatedAt ?? {
+      items: [],
+      nextToken: null
+    };
+  }
+  /**
+   * Create an announcement (Admins only).
+   */
+  async createAnnouncement(input) {
+    const result = await this.network.mutate(
+      `mutation CreateAnnouncement($input: CreateAnnouncementInput!) {
+        createAnnouncement(input: $input) {
+          id title message senderType senderName senderAvatar category actionUrl priority createdAt updatedAt
+        }
+      }`,
+      {
+        input: {
+          ...input,
+          senderType: input.senderType || "ORJOK",
+          category: input.category || "ANNOUNCEMENT",
+          priority: input.priority || "NORMAL"
+        }
+      }
+    );
+    return result.data.createAnnouncement;
+  }
+  /**
+   * Delete an announcement (Admins only).
+   */
+  async deleteAnnouncement(id) {
+    const result = await this.network.mutate(
+      `mutation DeleteAnnouncement($input: DeleteAnnouncementInput!) {
+        deleteAnnouncement(input: $input) { id }
+      }`,
+      { input: { id } }
+    );
+    return Boolean(result.data.deleteAnnouncement?.id);
+  }
+  /**
+   * List user notifications for a specific user ID.
+   */
+  async listUserNotifications(userId, limit = 20, nextToken) {
+    const result = await this.network.query(
+      `query ListUserNotifications($userId: ID!, $limit: Int, $nextToken: String, $sortDirection: ModelSortDirection) {
+        listUserNotificationByUserIdAndCreatedAt(userId: $userId, limit: $limit, nextToken: $nextToken, sortDirection: $sortDirection) {
+          items {
+            id userId title message type senderType senderName senderAvatar actionUrl isRead readAt metadata createdAt updatedAt
+          }
+          nextToken
+        }
+      }`,
+      { userId, limit, nextToken, sortDirection: "DESC" }
+    );
+    return result.data.listUserNotificationByUserIdAndCreatedAt ?? {
+      items: [],
+      nextToken: null
+    };
+  }
+  /**
+   * Create a user notification (Level up, direct message, system alert).
+   */
+  async createUserNotification(input) {
+    const result = await this.network.mutate(
+      `mutation CreateUserNotification($input: CreateUserNotificationInput!) {
+        createUserNotification(input: $input) {
+          id userId title message type senderType senderName senderAvatar actionUrl isRead readAt metadata createdAt updatedAt
+        }
+      }`,
+      {
+        input: {
+          ...input,
+          isRead: false
+        }
+      }
+    );
+    return result.data.createUserNotification;
+  }
+  /**
+   * Mark a personal notification as read.
+   */
+  async markNotificationAsRead(id) {
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const result = await this.network.mutate(
+      `mutation UpdateUserNotification($input: UpdateUserNotificationInput!) {
+        updateUserNotification(input: $input) {
+          id isRead readAt
+        }
+      }`,
+      {
+        input: {
+          id,
+          isRead: true,
+          readAt: now
+        }
+      }
+    );
+    return result.data.updateUserNotification;
+  }
+  /**
+   * Delete a personal user notification.
+   */
+  async deleteUserNotification(id) {
+    const result = await this.network.mutate(
+      `mutation DeleteUserNotification($input: DeleteUserNotificationInput!) {
+        deleteUserNotification(input: $input) { id }
+      }`,
+      { input: { id } }
+    );
+    return Boolean(result.data.deleteUserNotification?.id);
+  }
+  /**
+   * Update the user's lastReadAnnouncementAt timestamp in DynamoDB.
+   */
+  async updateLastReadAnnouncement(userId, timestamp = (/* @__PURE__ */ new Date()).toISOString()) {
+    const result = await this.network.mutate(
+      `mutation UpdateUserLastRead($input: UpdateUserInput!) {
+        updateUser(input: $input) { id lastReadAnnouncementAt }
+      }`,
+      { input: { id: userId, lastReadAnnouncementAt: timestamp } }
+    );
+    return Boolean(result.data.updateUser?.id);
+  }
+};
+
+// src/services/subscription.service.ts
+var SubscriptionService = class {
+  constructor(network) {
+    this.network = network;
+  }
+  async createRequest(input) {
+    const result = await this.network.mutate(
+      `mutation CreateSubscriptionRequest($input: CreateSubscriptionRequestInput!) {
+        createSubscriptionRequest(input: $input) {
+          id userId userFullName userEmail itemType itemId itemTitle amount billingCycle paymentMethod senderPhone contactPhone trxId status aiEvals aiQuestions adminNotes processedAt processedBy createdAt updatedAt
+        }
+      }`,
+      { input }
+    );
+    return result.data.createSubscriptionRequest;
+  }
+  async getRequest(id) {
+    const result = await this.network.query(
+      `query GetSubscriptionRequest($id: ID!) {
+        getSubscriptionRequest(id: $id) {
+          id userId userFullName userEmail itemType itemId itemTitle amount billingCycle paymentMethod senderPhone contactPhone trxId status aiEvals aiQuestions adminNotes processedAt processedBy createdAt updatedAt
+        }
+      }`,
+      { id }
+    );
+    return result.data.getSubscriptionRequest;
+  }
+  async listRequests(input = {}) {
+    const limit = input.limit ?? 20;
+    const sortDirection = input.sortDirection ?? "DESC";
+    if (input.status) {
+      const result2 = await this.network.query(
+        `query ListSubscriptionRequestsByStatus($status: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
+          listSubscriptionRequestByStatusAndCreatedAt(status: $status, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
+            items {
+              id userId userFullName userEmail itemType itemId itemTitle amount billingCycle paymentMethod senderPhone contactPhone trxId status aiEvals aiQuestions adminNotes processedAt processedBy createdAt updatedAt
+            }
+            nextToken
+          }
+        }`,
+        { status: input.status, sortDirection, limit, nextToken: input.nextToken }
+      );
+      return result2.data.listSubscriptionRequestByStatusAndCreatedAt;
+    }
+    if (input.userId) {
+      const result2 = await this.network.query(
+        `query ListSubscriptionRequestsByUser($userId: String!, $sortDirection: ModelSortDirection, $limit: Int, $nextToken: String) {
+          listSubscriptionRequestByUserIdAndCreatedAt(userId: $userId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
+            items {
+              id userId userFullName userEmail itemType itemId itemTitle amount billingCycle paymentMethod senderPhone contactPhone trxId status aiEvals aiQuestions adminNotes processedAt processedBy createdAt updatedAt
+            }
+            nextToken
+          }
+        }`,
+        { userId: input.userId, sortDirection, limit, nextToken: input.nextToken }
+      );
+      return result2.data.listSubscriptionRequestByUserIdAndCreatedAt;
+    }
+    const result = await this.network.query(
+      `query ListAllSubscriptionRequests($limit: Int, $nextToken: String, $filter: ModelSubscriptionRequestFilterInput) {
+        listSubscriptionRequests(limit: $limit, nextToken: $nextToken, filter: $filter) {
+          items {
+            id userId userFullName userEmail itemType itemId itemTitle amount billingCycle paymentMethod senderPhone contactPhone trxId status aiEvals aiQuestions adminNotes processedAt processedBy createdAt updatedAt
+          }
+          nextToken
+        }
+      }`,
+      { limit, nextToken: input.nextToken, filter: input.filter }
+    );
+    return result.data.listSubscriptionRequests;
+  }
+  async updateRequest(input) {
+    const result = await this.network.mutate(
+      `mutation UpdateSubscriptionRequest($input: UpdateSubscriptionRequestInput!) {
+        updateSubscriptionRequest(input: $input) {
+          id userId userFullName userEmail itemType itemId itemTitle amount billingCycle paymentMethod senderPhone contactPhone trxId status aiEvals aiQuestions adminNotes processedAt processedBy createdAt updatedAt
+        }
+      }`,
+      { input }
+    );
+    return result.data.updateSubscriptionRequest;
+  }
+};
+
 // src/client.ts
 var OrjokClient = class {
   constructor(config) {
     this.auth = config.authProvider;
+    this.network = config.networkProvider;
     this.storage = config.storageProvider;
     this.users = new UserService(config.networkProvider);
     this.questions = new QuestionService(config.networkProvider);
@@ -1295,29 +2418,14 @@ var OrjokClient = class {
     this.progress = new ProgressService(config.networkProvider);
     this.ai = new AIService(config.networkProvider);
     this.news = new NewsService(config.networkProvider);
+    this.notifications = new NotificationService(config.networkProvider);
+    this.subscriptions = new SubscriptionService(config.networkProvider);
   }
 };
 function createOrjokClient(config) {
   return new OrjokClient(config);
 }
 
-// src/types/select-options.ts
-var levelOptions = [
-  { value: "SSC", label: "SSC" },
-  { value: "HSC+Admission", label: "HSC/Admission" },
-  { value: "BCS", label: "BCS" }
-];
-var languageOptions = [
-  { value: "Bangla", label: "Bangla" },
-  { value: "English", label: "English" },
-  { value: "Any", label: "Any" }
-];
-var difficultyOptions = [
-  { value: "Easy", label: "Easy" },
-  { value: "Medium", label: "Medium" },
-  { value: "Hard", label: "Hard" }
-];
-
 // src/logic/avatar.ts
 var HAIR_COLORS = [
   { name: "Original", filter: "none", hex: "#e2e8f0", brightness: 1 },
@@ -1403,15 +2511,124 @@ function parseAvatarConfig(configStr) {
     const parsed = JSON.parse(configStr);
     return {
       selections: parsed.selections || {},
-      colors: parsed.colors || {}
+      colors: parsed.colors || {},
+      gender: parsed.gender
     };
   } catch {
     return { selections: {}, colors: {} };
   }
 }
+function parseAvatarConfigWithDefaults(configStr, seed) {
+  const parsed = parseAvatarConfig(configStr);
+  const hasSelections = Object.keys(parsed.selections).length > 0;
+  if (!hasSelections) {
+    return generateRandomAvatarState({ seed });
+  }
+  return {
+    selections: { ...parsed.selections },
+    colors: { ...parsed.colors },
+    gender: parsed.gender
+  };
+}
 function serializeAvatarConfig(state) {
   return JSON.stringify(state);
 }
+function createSeededRandom(seedStr) {
+  let h = 1779033703 ^ seedStr.length;
+  for (let i = 0; i < seedStr.length; i++) {
+    h = Math.imul(h ^ seedStr.charCodeAt(i), 3432918353);
+    h = h << 13 | h >>> 19;
+  }
+  return () => {
+    h = Math.imul(h ^ h >>> 16, 2246822507);
+    h = Math.imul(h ^ h >>> 13, 3266489909);
+    return ((h ^= h >>> 16) >>> 0) / 4294967296;
+  };
+}
+function pickRandom(arr, fallback, rng = Math.random) {
+  if (arr.length === 0) return fallback;
+  const item = arr[Math.floor(rng() * arr.length)];
+  return item !== void 0 ? item : fallback;
+}
+function generateRandomAvatarState(options) {
+  const rng = options?.seed ? createSeededRandom(options.seed) : Math.random;
+  const gender = options?.gender || (rng() > 0.5 ? "Male" : "Female");
+  const backgrounds = ["Solid", "3 Stripes"];
+  const skinColors = [
+    "Light Peach",
+    "Warm Peach",
+    "Golden Tan",
+    "Sand Beige",
+    "Warm Brown",
+    "Deep Brown"
+  ];
+  const maleHairs = ["Clean", "Mid", "Curled", "Bald"];
+  const femaleHairs = ["Bun", "Long", "Mid", "Short"];
+  const clothesList = ["Tshirt", "Hoodie", "Turtleneck"];
+  const expressions = ["Normal", "Happy", "Joyful", "Playful", "Surprised"];
+  const eywears = ["None", "None", "None", "None", "Normal Glasses"];
+  const headwears = ["None", "None", "None", "None", "Beanie", "HeadPhones"];
+  const hairList = gender === "Male" ? maleHairs : femaleHairs;
+  const bg = pickRandom(backgrounds, "Solid", rng);
+  const skin = pickRandom(skinColors, "Light Peach", rng);
+  const hair = pickRandom(hairList, gender === "Male" ? "Clean" : "Short", rng);
+  const clothes = pickRandom(clothesList, "Tshirt", rng);
+  const expression = pickRandom(expressions, "Normal", rng);
+  const eyewear = pickRandom(eywears, "None", rng);
+  const headwear = pickRandom(headwears, "None", rng);
+  const hairColorPool = [
+    "Black",
+    "Black",
+    "Brown",
+    "Brown",
+    "Blonde",
+    "White",
+    "Red",
+    "Blue"
+  ];
+  const hairColor = pickRandom(hairColorPool, "Black", rng);
+  const clothesColorPool = [
+    "Blue",
+    "Red",
+    "Green",
+    "Orange",
+    "Purple",
+    "Black",
+    "Yellow",
+    "Pink"
+  ];
+  const clothesColor = pickRandom(clothesColorPool, "Blue", rng);
+  const bgColorPool = ["Blue", "Green", "Purple", "Orange", "Red", "Pink", "Original"];
+  const bgColor = pickRandom(bgColorPool, "Blue", rng);
+  return {
+    selections: {
+      Background: bg,
+      "Hair Back": hair,
+      "Skin Color": skin,
+      "Clothes Back": clothes,
+      "Clothes Front": clothes,
+      Accessories: "None",
+      Headwears: headwear,
+      Eyewear: eyewear,
+      "Facial Expression": expression,
+      Beard: "None",
+      "Hair Front": hair
+    },
+    colors: {
+      "Background Color": bgColor,
+      "Hair Color": hairColor,
+      "Clothes Color": clothesColor,
+      "Accessory Color": "Original",
+      "Headwears Color": "Original",
+      "Eyewear Color": "Original",
+      "Facial Expression Color": "Original"
+    },
+    gender
+  };
+}
+function generateRandomAvatarConfig(options) {
+  return JSON.stringify(generateRandomAvatarState(options));
+}
 
 // src/logic/elo.ts
 var TIERS = [
@@ -1548,6 +2765,212 @@ function reorderObjectKeys(obj, oldIndex, newIndex, length) {
   return newObj;
 }
 
+// src/logic/home.ts
+function mapCognitoLevelToStandardLevel(cognitoLevel) {
+  if (!cognitoLevel) return "HSC+Admission";
+  const normalized = cognitoLevel.trim().toLowerCase();
+  if (normalized === "class_9" || normalized === "class_10" || normalized === "ssc") {
+    return "SSC";
+  }
+  if (normalized === "class_11" || normalized === "class_12" || normalized === "admission" || normalized === "hsc" || normalized === "hsc+admission") {
+    return "HSC+Admission";
+  }
+  if (normalized === "bcs" || normalized === "job") {
+    return "BCS";
+  }
+  return "HSC+Admission";
+}
+function getTimeOfDayGreeting(customHour, lang = "en") {
+  const hour = customHour !== void 0 ? customHour : (/* @__PURE__ */ new Date()).getHours();
+  if (hour >= 5 && hour < 12) {
+    return {
+      greeting: lang === "bn" ? "\u09B6\u09C1\u09AD \u09B8\u0995\u09BE\u09B2" : "Good morning",
+      period: "morning"
+    };
+  }
+  if (hour >= 12 && hour < 17) {
+    return {
+      greeting: lang === "bn" ? "\u09B6\u09C1\u09AD \u09A6\u09C1\u09AA\u09C1\u09B0" : "Good afternoon",
+      period: "afternoon"
+    };
+  }
+  if (hour >= 17 && hour < 21) {
+    return {
+      greeting: lang === "bn" ? "\u09B6\u09C1\u09AD \u09B8\u09A8\u09CD\u09A7\u09CD\u09AF\u09BE" : "Good evening",
+      period: "evening"
+    };
+  }
+  return {
+    greeting: lang === "bn" ? "\u09B6\u09C1\u09AD \u09B0\u09BE\u09A4\u09CD\u09B0\u09BF" : "Good evening",
+    period: "night"
+  };
+}
+function getRecommendedSubjectsForLevel(level, lang = "en") {
+  const isBn = lang === "bn";
+  const normalizedLevel = mapCognitoLevelToStandardLevel(level);
+  if (normalizedLevel === "SSC") {
+    return [
+      {
+        id: "ssc-physics",
+        name: isBn ? "\u09AA\u09A6\u09BE\u09B0\u09CD\u09A5\u09AC\u09BF\u099C\u09CD\u099E\u09BE\u09A8" : "Physics",
+        iconKey: "atom",
+        colorClass: "from-blue-500 to-indigo-600"
+      },
+      {
+        id: "ssc-chemistry",
+        name: isBn ? "\u09B0\u09B8\u09BE\u09DF\u09A8" : "Chemistry",
+        iconKey: "flask",
+        colorClass: "from-emerald-500 to-teal-600"
+      },
+      {
+        id: "ssc-higher-math",
+        name: isBn ? "\u0989\u099A\u09CD\u099A\u09A4\u09B0 \u0997\u09A3\u09BF\u09A4" : "Higher Math",
+        iconKey: "math",
+        colorClass: "from-amber-500 to-orange-600"
+      },
+      {
+        id: "ssc-general-math",
+        name: isBn ? "\u09B8\u09BE\u09A7\u09BE\u09B0\u09A3 \u0997\u09A3\u09BF\u09A4" : "General Math",
+        iconKey: "calculator",
+        colorClass: "from-violet-500 to-purple-600"
+      },
+      {
+        id: "ssc-biology",
+        name: isBn ? "\u099C\u09C0\u09AC\u09AC\u09BF\u099C\u09CD\u099E\u09BE\u09A8" : "Biology",
+        iconKey: "dna",
+        colorClass: "from-rose-500 to-pink-600"
+      },
+      {
+        id: "ssc-bangla",
+        name: isBn ? "\u09AC\u09BE\u0982\u09B2\u09BE" : "Bangla",
+        iconKey: "book",
+        colorClass: "from-cyan-500 to-blue-600"
+      }
+    ];
+  }
+  if (normalizedLevel === "BCS") {
+    return [
+      {
+        id: "bcs-bangladesh-affairs",
+        name: isBn ? "\u09AC\u09BE\u0982\u09B2\u09BE\u09A6\u09C7\u09B6 \u09AC\u09BF\u09B7\u09DF\u09BE\u09AC\u09B2\u09C0" : "Bangladesh Affairs",
+        iconKey: "monument",
+        colorClass: "from-emerald-500 to-green-600"
+      },
+      {
+        id: "bcs-international-affairs",
+        name: isBn ? "\u0986\u09A8\u09CD\u09A4\u09B0\u09CD\u099C\u09BE\u09A4\u09BF\u0995 \u09AC\u09BF\u09B7\u09DF\u09BE\u09AC\u09B2\u09C0" : "International Affairs",
+        iconKey: "world",
+        colorClass: "from-blue-500 to-cyan-600"
+      },
+      {
+        id: "bcs-bangla",
+        name: isBn ? "\u09AC\u09BE\u0982\u09B2\u09BE \u09AD\u09BE\u09B7\u09BE \u0993 \u09B8\u09BE\u09B9\u09BF\u09A4\u09CD\u09AF" : "Bangla Literature",
+        iconKey: "book",
+        colorClass: "from-amber-500 to-orange-600"
+      },
+      {
+        id: "bcs-english",
+        name: isBn ? "\u0987\u0982\u09B0\u09C7\u099C\u09BF \u09AD\u09BE\u09B7\u09BE \u0993 \u09B8\u09BE\u09B9\u09BF\u09A4\u09CD\u09AF" : "English Language",
+        iconKey: "language",
+        colorClass: "from-violet-500 to-purple-600"
+      },
+      {
+        id: "bcs-math-mental-ability",
+        name: isBn ? "\u0997\u09BE\u09A3\u09BF\u09A4\u09BF\u0995 \u0993 \u09AE\u09BE\u09A8\u09B8\u09BF\u0995 \u09A6\u0995\u09CD\u09B7\u09A4\u09BE" : "Math & Mental Ability",
+        iconKey: "brain",
+        colorClass: "from-pink-500 to-rose-600"
+      },
+      {
+        id: "bcs-general-science",
+        name: isBn ? "\u09B8\u09BE\u09A7\u09BE\u09B0\u09A3 \u09AC\u09BF\u099C\u09CD\u099E\u09BE\u09A8 \u0993 \u09AA\u09CD\u09B0\u09AF\u09C1\u0995\u09CD\u09A4\u09BF" : "General Science",
+        iconKey: "atom",
+        colorClass: "from-teal-500 to-emerald-600"
+      }
+    ];
+  }
+  return [
+    {
+      id: "hsc-physics",
+      name: isBn ? "\u09AA\u09A6\u09BE\u09B0\u09CD\u09A5\u09AC\u09BF\u099C\u09CD\u099E\u09BE\u09A8" : "Physics",
+      iconKey: "atom",
+      colorClass: "from-blue-500 to-indigo-600"
+    },
+    {
+      id: "hsc-chemistry",
+      name: isBn ? "\u09B0\u09B8\u09BE\u09DF\u09A8" : "Chemistry",
+      iconKey: "flask",
+      colorClass: "from-emerald-500 to-teal-600"
+    },
+    {
+      id: "hsc-higher-math",
+      name: isBn ? "\u0989\u099A\u09CD\u099A\u09A4\u09B0 \u0997\u09A3\u09BF\u09A4" : "Higher Math",
+      iconKey: "math",
+      colorClass: "from-amber-500 to-orange-600"
+    },
+    {
+      id: "hsc-biology",
+      name: isBn ? "\u099C\u09C0\u09AC\u09AC\u09BF\u099C\u09CD\u099E\u09BE\u09A8" : "Biology",
+      iconKey: "dna",
+      colorClass: "from-rose-500 to-pink-600"
+    },
+    {
+      id: "hsc-ict",
+      name: isBn ? "\u09A4\u09A5\u09CD\u09AF \u0993 \u09AF\u09CB\u0997\u09BE\u09AF\u09CB\u0997 \u09AA\u09CD\u09B0\u09AF\u09C1\u0995\u09CD\u09A4\u09BF" : "ICT",
+      iconKey: "device-laptop",
+      colorClass: "from-cyan-500 to-sky-600"
+    },
+    {
+      id: "hsc-bangla",
+      name: isBn ? "\u09AC\u09BE\u0982\u09B2\u09BE" : "Bangla",
+      iconKey: "book",
+      colorClass: "from-violet-500 to-purple-600"
+    }
+  ];
+}
+function calculateStreakFromDates(activityDates) {
+  if (!activityDates || activityDates.length === 0) {
+    return { streak: 0, isActiveToday: false };
+  }
+  const uniqueDateStrings = Array.from(
+    new Set(
+      activityDates.map((d) => {
+        try {
+          return new Date(d).toISOString().split("T")[0];
+        } catch {
+          return null;
+        }
+      }).filter((d) => Boolean(d))
+    )
+  ).sort((a, b) => a > b ? -1 : 1);
+  if (uniqueDateStrings.length === 0) {
+    return { streak: 0, isActiveToday: false };
+  }
+  const todayStr = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const yesterdayDate = /* @__PURE__ */ new Date();
+  yesterdayDate.setDate(yesterdayDate.getDate() - 1);
+  const yesterdayStr = yesterdayDate.toISOString().split("T")[0];
+  const latestDate = uniqueDateStrings[0];
+  if (!latestDate) {
+    return { streak: 0, isActiveToday: false };
+  }
+  const isActiveToday = latestDate === todayStr;
+  if (latestDate !== todayStr && latestDate !== yesterdayStr) {
+    return { streak: 0, isActiveToday: false };
+  }
+  let streak = 0;
+  const checkDate = new Date(latestDate);
+  for (const dateStr of uniqueDateStrings) {
+    const expectedStr = checkDate.toISOString().split("T")[0];
+    if (dateStr === expectedStr) {
+      streak += 1;
+      checkDate.setDate(checkDate.getDate() - 1);
+    } else {
+      break;
+    }
+  }
+  return { streak, isActiveToday };
+}
+
 // src/logic/import-export.ts
 var MAX_QUESTIONS = 200;
 function parseFields(parts) {
@@ -1752,6 +3175,250 @@ function formatQuestionsToCsv(questions, packSubjectId, packChapterId, packTopic
 ${rows.join("\n")}`;
 }
 
+// src/logic/subscription.ts
+var MANUAL_PAYMENT_CONFIG = {
+  phoneNumber: "01323567688",
+  accountType: "Personal",
+  methods: ["BKASH", "ROCKET"]
+};
+var SUBSCRIPTION_PLANS = {
+  FREE: {
+    id: "FREE",
+    tier: "FREE",
+    titleKey: "upgrade.freeTitle",
+    descKey: "upgrade.freeDesc",
+    pricing: {
+      monthly: 0,
+      quarterly: 0,
+      biannually: 0,
+      annually: 0
+    },
+    aiQuotas: {
+      monthly: { aiEvals: 0, aiQuestions: 0 },
+      quarterly: { aiEvals: 0, aiQuestions: 0 },
+      biannually: { aiEvals: 0, aiQuestions: 0 },
+      annually: { aiEvals: 0, aiQuestions: 0 }
+    }
+  },
+  PRO: {
+    id: "PRO",
+    tier: "PRO",
+    titleKey: "upgrade.proTitle",
+    descKey: "upgrade.proDesc",
+    pricing: {
+      monthly: 149,
+      quarterly: 399,
+      biannually: 699,
+      annually: 999
+    },
+    aiQuotas: {
+      monthly: { aiEvals: 0, aiQuestions: 0 },
+      quarterly: { aiEvals: 0, aiQuestions: 0 },
+      biannually: { aiEvals: 0, aiQuestions: 0 },
+      annually: { aiEvals: 0, aiQuestions: 0 }
+    }
+  },
+  PRO_AI: {
+    id: "PRO_AI",
+    tier: "PRO_AI",
+    titleKey: "upgrade.aiTitle",
+    descKey: "upgrade.aiDesc",
+    pricing: {
+      monthly: 349,
+      quarterly: 899,
+      biannually: 1599,
+      annually: 2499
+    },
+    aiQuotas: {
+      monthly: { aiEvals: 100, aiQuestions: 450 },
+      quarterly: { aiEvals: 280, aiQuestions: 1100 },
+      biannually: { aiEvals: 500, aiQuestions: 2e3 },
+      annually: { aiEvals: 800, aiQuestions: 3e3 }
+    }
+  }
+};
+var AI_EVAL_BOOSTER_PACKS = [
+  {
+    id: "eval_booster_starter",
+    type: "AI_EVAL",
+    amount: 40,
+    price: 69,
+    titleKey: "upgrade.boosters.evalStarterTitle",
+    descKey: "upgrade.boosters.evalStarterDesc"
+  },
+  {
+    id: "eval_booster_standard",
+    type: "AI_EVAL",
+    amount: 100,
+    price: 159,
+    titleKey: "upgrade.boosters.evalStandardTitle",
+    descKey: "upgrade.boosters.evalStandardDesc",
+    badgeKey: "upgrade.popular"
+  },
+  {
+    id: "eval_booster_mega",
+    type: "AI_EVAL",
+    amount: 220,
+    price: 349,
+    titleKey: "upgrade.boosters.evalMegaTitle",
+    descKey: "upgrade.boosters.evalMegaDesc",
+    badgeKey: "upgrade.bestValue"
+  }
+];
+var AI_QUESTION_BOOSTER_PACKS = [
+  {
+    id: "question_booster_drill",
+    type: "AI_QUESTION",
+    amount: 100,
+    price: 39,
+    titleKey: "upgrade.boosters.questionDrillTitle",
+    descKey: "upgrade.boosters.questionDrillDesc"
+  },
+  {
+    id: "question_booster_chapter",
+    type: "AI_QUESTION",
+    amount: 250,
+    price: 99,
+    titleKey: "upgrade.boosters.questionChapterTitle",
+    descKey: "upgrade.boosters.questionChapterDesc",
+    badgeKey: "upgrade.popular"
+  },
+  {
+    id: "question_booster_exam",
+    type: "AI_QUESTION",
+    amount: 700,
+    price: 249,
+    titleKey: "upgrade.boosters.questionExamTitle",
+    descKey: "upgrade.boosters.questionExamDesc",
+    badgeKey: "upgrade.bestValue"
+  }
+];
+function getCycleMultiplier(cycle) {
+  switch (cycle) {
+    case "quarterly":
+      return 3;
+    case "biannually":
+      return 6;
+    case "annually":
+      return 12;
+    case "monthly":
+    default:
+      return 1;
+  }
+}
+function getPlanOriginalPrice(tier, cycle) {
+  const normalizedTier = tier === "AI_ANNUAL" || tier === "AI_MONTHLY" ? "PRO_AI" : tier;
+  const plan = SUBSCRIPTION_PLANS[normalizedTier] || SUBSCRIPTION_PLANS.FREE;
+  const monthlyPrice = plan.pricing.monthly ?? 0;
+  return monthlyPrice * getCycleMultiplier(cycle);
+}
+function getPlanPrice(tier, cycle) {
+  const normalizedTier = tier === "AI_ANNUAL" || tier === "AI_MONTHLY" ? "PRO_AI" : tier;
+  const plan = SUBSCRIPTION_PLANS[normalizedTier] || SUBSCRIPTION_PLANS.FREE;
+  return plan.pricing[cycle] ?? 0;
+}
+function getPlanMonthlyEquivalentPrice(tier, cycle) {
+  const normalizedTier = tier === "AI_ANNUAL" || tier === "AI_MONTHLY" ? "PRO_AI" : tier;
+  const plan = SUBSCRIPTION_PLANS[normalizedTier] || SUBSCRIPTION_PLANS.FREE;
+  const cyclePrice = plan.pricing[cycle] ?? 0;
+  const multiplier = getCycleMultiplier(cycle);
+  return Math.round(cyclePrice / multiplier);
+}
+function getPlanDiscountPercent(cycle) {
+  switch (cycle) {
+    case "quarterly":
+      return 10;
+    case "biannually":
+      return 22;
+    case "annually":
+      return 44;
+    case "monthly":
+    default:
+      return 0;
+  }
+}
+function getPlanAiQuotas(tier, cycle) {
+  const normalizedTier = tier === "AI_ANNUAL" || tier === "AI_MONTHLY" ? "PRO_AI" : tier;
+  const plan = SUBSCRIPTION_PLANS[normalizedTier] || SUBSCRIPTION_PLANS.FREE;
+  return plan.aiQuotas[cycle] ?? { aiEvals: 0, aiQuestions: 0 };
+}
+function isValidBangladeshiPhone(phone) {
+  if (!phone) return false;
+  const cleaned = phone.replace(/[\s\-()]/g, "");
+  const regex = /^(?:\+?88)?01[3-9]\d{8}$/;
+  return regex.test(cleaned);
+}
+function isValidTrxId(trxId) {
+  if (!trxId) return false;
+  const cleaned = trxId.trim();
+  return cleaned.length >= 4 && cleaned.length <= 40;
+}
+function hasProAccess(tier, expiresAt) {
+  if (!tier) return false;
+  const upper = tier.toUpperCase();
+  const isTierPro = upper === "PRO" || upper === "PRO_AI";
+  if (!isTierPro) return false;
+  if (!expiresAt) return true;
+  const expTime = new Date(expiresAt).getTime();
+  if (isNaN(expTime)) return true;
+  return expTime > Date.now();
+}
+function hasAiTierAccess(tier, expiresAt) {
+  if (!tier) return false;
+  const upper = tier.toUpperCase();
+  const isTierAi = upper === "PRO_AI";
+  if (!isTierAi) return false;
+  if (!expiresAt) return true;
+  const expTime = new Date(expiresAt).getTime();
+  if (isNaN(expTime)) return true;
+  return expTime > Date.now();
+}
+var FREE_DAILY_PRACTICE_LIMIT = 30;
+function canExportPack(tier, expiresAt, isCreator) {
+  return Boolean(isCreator || hasProAccess(tier, expiresAt));
+}
+function canAccessMistakeVault(tier, expiresAt, isCreator) {
+  return Boolean(isCreator || hasProAccess(tier, expiresAt));
+}
+function canWatchContestSolution(tier, expiresAt, isCreator) {
+  return Boolean(isCreator || hasProAccess(tier, expiresAt));
+}
+function shouldTrackPracticeProgress(tier, expiresAt, isCreator) {
+  return Boolean(isCreator || hasProAccess(tier, expiresAt));
+}
+function getDailyPracticeLimit(tier, expiresAt) {
+  if (hasProAccess(tier, expiresAt)) return null;
+  return FREE_DAILY_PRACTICE_LIMIT;
+}
+function checkDailyPracticeLimit(dailyCount, lastPracticeDate, tier, expiresAt, todayStr) {
+  if (hasProAccess(tier, expiresAt)) {
+    return {
+      allowed: true,
+      remaining: Infinity,
+      currentCount: dailyCount,
+      isUnlimited: true
+    };
+  }
+  const today = todayStr || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+  const isSameDay = lastPracticeDate ? lastPracticeDate.startsWith(today) : false;
+  const currentCount = isSameDay ? Number.isFinite(dailyCount) ? dailyCount : 0 : 0;
+  const remaining = Math.max(0, FREE_DAILY_PRACTICE_LIMIT - currentCount);
+  const allowed = currentCount < FREE_DAILY_PRACTICE_LIMIT;
+  return {
+    allowed,
+    remaining,
+    currentCount,
+    isUnlimited: false
+  };
+}
+function hasSufficientAiQuestionQuota(quota, requested) {
+  if (requested <= 0) return false;
+  return (quota ?? 0) >= requested;
+}
+function hasSufficientAiEvalQuota(quota) {
+  return (quota ?? 0) > 0;
+}
+
 // src/navigation.ts
 function getActiveTab(pathname) {
   const normalized = pathname.toLowerCase();
@@ -1906,7 +3573,7 @@ function processLatexText(str) {
 }
 
 // src/utils/time.ts
-function convertToBangladeshTime(isoString) {
+function convertToBangladeshTime(isoString, locale = "en-GB") {
   const options = {
     year: "numeric",
     month: "long",
@@ -1916,7 +3583,8 @@ function convertToBangladeshTime(isoString) {
     hour12: true
   };
   const date = new Date(isoString);
-  return date.toLocaleString("en-GB", {
+  const resolvedLocale = locale === "bn" ? "bn-BD" : locale;
+  return date.toLocaleString(resolvedLocale, {
     ...options,
     timeZone: "Asia/Dhaka"
   });
@@ -2008,24 +3676,42 @@ function isLanguage(value) {
 function isDifficulty(value) {
   return ["Easy", "Medium", "Hard"].includes(value);
 }
+function normalizeLevel(value) {
+  if (!value) return "";
+  const clean = value.trim().replace(/\s+/g, "+");
+  const upper = clean.toUpperCase();
+  if (upper === "SSC" || upper.includes("CLASS_9") || upper.includes("CLASS_10")) return "SSC";
+  if (upper === "HSC" || upper === "ADMISSION" || upper === "HSC+ADMISSION" || upper.includes("CLASS_11") || upper.includes("CLASS_12")) return "HSC+Admission";
+  if (upper === "BCS") return "BCS";
+  return clean;
+}
 export {
   AIService,
+  AI_EVAL_BOOSTER_PACKS,
+  AI_QUESTION_BOOSTER_PACKS,
   CLOTHES_COLORS,
   COLOR_HUES,
   ContestService,
   CourseService,
   CurriculumService,
+  FREE_DAILY_PRACTICE_LIMIT,
   HAIR_COLORS,
   INITIAL_AVATAR_DATA,
+  MANUAL_PAYMENT_CONFIG,
   MediaService,
   MediaUrlCache,
   NewsService,
+  NotificationService,
   OrjokClient,
   PackService,
   ProgressService,
   QuestionService,
   RENDER_ORDER,
+  SUBSCRIPTION_PLANS,
+  SubscriptionService,
   UserService,
+  XP_REWARDS,
+  XP_TIERS,
   _resetMediaUrlWarning,
   aggregateChapterMetrics,
   aggregateSubjectMetrics,
@@ -2034,7 +3720,14 @@ export {
   calculateAccuracy,
   calculateDefaultExamMinutes,
   calculateExamTime,
+  calculateStreakFromDates,
   calculateTimeLeft,
+  calculateUnreadCount,
+  calculateXpReward,
+  canAccessMistakeVault,
+  canExportPack,
+  canWatchContestSolution,
+  checkDailyPracticeLimit,
   computeRatingDelta,
   convertToBangladeshTime,
   createOrjokClient,
@@ -2047,18 +3740,41 @@ export {
   formatCurriculumName,
   formatDate,
   formatExamTime,
+  formatLevelUpNotification,
   formatQuestionsToCsv,
   formatQuestionsToText,
+  generateRandomAvatarConfig,
+  generateRandomAvatarState,
   getActiveTab,
   getActualOptionFileName,
   getAllTiers,
+  getAllXpTiers,
   getCanonicalPath,
+  getCycleMultiplier,
+  getDailyPracticeLimit,
   getDhakaNow,
   getEloProgress,
   getEloTier,
+  getLevelFromXp,
+  getPlanAiQuotas,
+  getPlanDiscountPercent,
+  getPlanMonthlyEquivalentPrice,
+  getPlanOriginalPrice,
+  getPlanPrice,
+  getPublicExamsByLevel,
   getRatingForSubject,
+  getRecommendedSubjectsForLevel,
   getRelativeTime,
+  getTimeOfDayGreeting,
+  getXpForLevel,
+  getXpProgress,
+  getXpRequiredForNextLevel,
+  getXpTier,
   getYouTubeId,
+  hasAiTierAccess,
+  hasProAccess,
+  hasSufficientAiEvalQuota,
+  hasSufficientAiQuestionQuota,
   isAuthGatedRoute,
   isCorrectAnswer,
   isDifficulty,
@@ -2068,21 +3784,30 @@ export {
   isLanguageMatch,
   isQuestionLevel,
   isStorageKey,
+  isValidBangladeshiPhone,
   isValidMCQ,
+  isValidTrxId,
   languageOptions,
   levelOptions,
+  mapCognitoLevelToStandardLevel,
+  mergeNotificationTimeline,
   normalizeDifficulty,
+  normalizeLevel,
+  paginateWithAccumulator,
   parseAvatarConfig,
+  parseAvatarConfigWithDefaults,
   parseCsvQuestions,
   parseImageKeys,
   parseTextQuestions,
   processLatexText,
+  publicExamOptions,
   reorderObjectKeys,
   resolveMediaUrl,
   resolveMediaUrls,
   sanitizeFileName,
   scoreExam,
   serializeAvatarConfig,
+  shouldTrackPracticeProgress,
   shuffle,
   shuffleInPlace
 };