@orjok/commons 1.0.2 → 1.2.0

package/dist/index.js

@@ -1,3 +1,37 @@
+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-B4UJE3F4.js";
+
 // src/services/user.service.ts
 var UserService = class {
   constructor(network) {
@@ -8,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 }
@@ -20,20 +55,23 @@ 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;
   }
-  async getQuestions(userId, nextToken) {
+  async getQuestions(userId, nextToken, limit = 10) {
     const result = await this.network.query(
-      `query ListUserQuestions($owner: ID!, $nextToken: String, $sortDirection: ModelSortDirection) {
-        listQuestionObjectByOwnerAndCreatedAt(owner: $owner, sortDirection: $sortDirection, nextToken: $nextToken) {
+      `query ListUserQuestions($owner: ID!, $limit: Int, $nextToken: String, $sortDirection: ModelSortDirection) {
+        listQuestionObjectByOwnerAndCreatedAt(owner: $owner, limit: $limit, sortDirection: $sortDirection, nextToken: $nextToken) {
           items {
             id question imageUrl language level difficulty type voteCount
             verificationStatus owner packId createdAt
@@ -43,14 +81,14 @@ var UserService = class {
           nextToken
         }
       }`,
-      { owner: userId, nextToken, sortDirection: "DESC" }
+      { owner: userId, limit, nextToken, sortDirection: "DESC" }
     );
     return result.data.listQuestionObjectByOwnerAndCreatedAt;
   }
-  async getPacks(userId, nextToken) {
+  async getPacks(userId, nextToken, limit = 10) {
     const result = await this.network.query(
-      `query ListUserPacks($owner: ID!, $nextToken: String, $sortDirection: ModelSortDirection) {
-        listPackByOwnerAndCreatedAt(owner: $owner, sortDirection: $sortDirection, nextToken: $nextToken) {
+      `query ListUserPacks($owner: ID!, $limit: Int, $nextToken: String, $sortDirection: ModelSortDirection) {
+        listPackByOwnerAndCreatedAt(owner: $owner, limit: $limit, sortDirection: $sortDirection, nextToken: $nextToken) {
           items {
             id name language level difficulty questionCount automaticNumbering
             owner subjectId chapterId topicId verificationStatus createdAt
@@ -59,7 +97,7 @@ var UserService = class {
           nextToken
         }
       }`,
-      { owner: userId, nextToken, sortDirection: "DESC" }
+      { owner: userId, limit, nextToken, sortDirection: "DESC" }
     );
     return result.data.listPackByOwnerAndCreatedAt;
   }
@@ -90,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) {
@@ -99,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
         }
       }`,
@@ -112,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 } }
@@ -126,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 } }
@@ -159,11 +248,28 @@ var QuestionService = class {
     );
     return result.data.listQuestionObjectByPackIdAndOrder.items[0]?.id ?? null;
   }
+  async listByPack(packId, limit = 200, sortDirection = "ASC", nextToken) {
+    const result = await this.network.query(
+      `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 publicExam difficulty type
+            markingInstructions voteCount owner packId subjectId chapterId topicId order createdAt
+            options { items { id content } }
+            tags { items { id tagId } }
+          }
+          nextToken
+        }
+      }`,
+      { packId, sortDirection, limit, nextToken }
+    );
+    return result.data.listQuestionObjectByPackIdAndOrder;
+  }
   async update(id, fields) {
     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 } }
         }
@@ -172,6 +278,41 @@ var QuestionService = class {
     );
     return result.data.updateQuestionObject;
   }
+  async updateOption(id, content) {
+    const result = await this.network.mutate(
+      `mutation UpdateOption($input: UpdateOptionInput!) {
+        updateOption(input: $input) {
+          id
+          content
+        }
+      }`,
+      { input: { id, content } }
+    );
+    return result.data.updateOption;
+  }
+  async createOption(input) {
+    const result = await this.network.mutate(
+      `mutation CreateOption($input: CreateOptionInput!) {
+        createOption(input: $input) {
+          id
+          content
+        }
+      }`,
+      { input }
+    );
+    return result.data.createOption;
+  }
+  async deleteOption(id) {
+    const result = await this.network.mutate(
+      `mutation DeleteOption($input: DeleteOptionInput!) {
+        deleteOption(input: $input) {
+          id
+        }
+      }`,
+      { input: { id } }
+    );
+    return result.data.deleteOption;
+  }
   async delete(id) {
     const result = await this.network.mutate(
       `mutation DeleteQuestion($input: DeleteQuestionObjectInput!) {
@@ -228,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 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 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 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("_");
@@ -305,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 } }
           }
@@ -316,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
@@ -325,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
         }
       }`,
@@ -338,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 }
@@ -352,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 } }
@@ -368,13 +797,33 @@ var PackService = class {
       }`,
       { id }
     );
-    return result.data.getPack;
+    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) {
+          if (orderA === 0) return 1;
+          if (orderB === 0) return -1;
+          return orderA - orderB;
+        }
+        const timeA = a.createdAt ? new Date(a.createdAt).getTime() : 0;
+        const timeB = b.createdAt ? new Date(b.createdAt).getTime() : 0;
+        return timeA - timeB;
+      });
+    }
+    return pack;
   }
   async update(id, fields) {
     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
         }
       }`,
@@ -384,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(
@@ -409,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) {
@@ -426,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
         }
@@ -440,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 }
@@ -448,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
@@ -878,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
@@ -945,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
@@ -954,13 +1892,34 @@ var MediaService = class {
     this.storage = storage;
   }
   async uploadImage(questionId, image) {
-    const result = await this.network.mutate(
-      `mutation UploadImage($questionId: ID!, $image: String!) {
-        uploadImage(questionId: $questionId, image: $image) { status imageUrl }
-      }`,
-      { questionId, image }
-    );
-    return result.data.uploadImage;
+    const payloadLength = image ? image.length : 0;
+    console.log(`[MediaService.uploadImage] Initiating upload mutation: questionId="${questionId}", payloadLength=${payloadLength} chars`);
+    try {
+      const result = await this.network.mutate(
+        `mutation UploadImage($questionId: ID!, $image: String!) {
+          uploadImage(questionId: $questionId, image: $image) { status imageUrl }
+        }`,
+        { questionId, image }
+      );
+      if (result.errors && result.errors.length > 0) {
+        console.error(
+          `[MediaService.uploadImage] GraphQL errors returned for questionId "${questionId}":`,
+          JSON.stringify(result.errors, null, 2)
+        );
+      }
+      const response = result.data?.uploadImage;
+      if (!response) {
+        console.error(`[MediaService.uploadImage] No uploadImage object returned in GraphQL response for questionId "${questionId}". Full result:`, result);
+      } else if (response.status === "Error" || response.status === "error" || !response.imageUrl) {
+        console.error(`[MediaService.uploadImage] Backend returned error status or missing imageUrl for questionId "${questionId}":`, response);
+      } else {
+        console.log(`[MediaService.uploadImage] Upload mutation success for questionId "${questionId}": imageUrl="${response.imageUrl}"`);
+      }
+      return response;
+    } catch (err) {
+      console.error(`[MediaService.uploadImage] Network/GraphQL mutation failed for questionId "${questionId}":`, err);
+      throw err;
+    }
   }
   async deleteImage(imageUrl) {
     const result = await this.network.mutate(
@@ -997,149 +1956,449 @@ var MediaService = class {
     if (!this.storage) throw new Error("StorageProvider not configured");
     return this.storage.uploadFile(path, data, options);
   }
-  async createVideo(input) {
+  async createVideo(input) {
+    const result = await this.network.query(
+      `query CreateCourseVideo($courseId: ID!, $fileName: String!, $fileType: String!) {
+        createCourseVideo(courseId: $courseId, fileName: $fileName, fileType: $fileType) { status videoId }
+      }`,
+      input
+    );
+    return result.data.createCourseVideo;
+  }
+  async uploadVideoToBunny(input) {
+    const result = await this.network.mutate(
+      `mutation UploadR2VideoToBunny($key: String!, $videoId: String!, $fileType: String!) {
+        uploadR2VideoToBunny(key: $key, videoId: $videoId, fileType: $fileType) { status }
+      }`,
+      input
+    );
+    return result.data.uploadR2VideoToBunny;
+  }
+};
+
+// src/services/progress.service.ts
+var ProgressService = class {
+  constructor(network) {
+    this.network = network;
+  }
+  async track(input) {
+    const variables = {
+      questionId: input.questionId,
+      isCorrect: input.isCorrect,
+      subjectId: input.subjectId ?? null,
+      chapterId: input.chapterId ?? null,
+      topicId: input.topicId ?? null
+    };
+    const result = await this.network.mutate(
+      `mutation TrackProgress($questionId: ID!, $isCorrect: Boolean!, $subjectId: ID, $chapterId: ID, $topicId: ID) {
+        trackPracticeProgress(questionId: $questionId, isCorrect: $isCorrect, subjectId: $subjectId, chapterId: $chapterId, topicId: $topicId) { status }
+      }`,
+      variables
+    );
+    return result.data?.trackPracticeProgress || { status: "success" };
+  }
+  async getSubjectProgress(userId) {
+    try {
+      const result = await this.network.query(
+        `query ListSubjectProgress($userId: String!) {
+          listUserSubjectProgressByUserIdAndSubjectId(userId: $userId) {
+            items { id userId subjectId practicedCount mistakeCount correctedCount accuracyScore }
+          }
+        }`,
+        { userId }
+      );
+      return result.data?.listUserSubjectProgressByUserIdAndSubjectId?.items || result.data?.listUserSubjectProgressesByUserIdAndSubjectId?.items || [];
+    } catch (e) {
+      console.error("Error fetching subject progress:", e);
+      return [];
+    }
+  }
+  async getChapterProgress(userId) {
+    try {
+      const result = await this.network.query(
+        `query ListChapterProgress($userId: String!) {
+          listUserChapterProgressByUserIdAndChapterId(userId: $userId) {
+            items { id userId chapterId practicedCount mistakeCount correctedCount accuracyScore }
+          }
+        }`,
+        { userId }
+      );
+      return result.data?.listUserChapterProgressByUserIdAndChapterId?.items || result.data?.listUserChapterProgressesByUserIdAndChapterId?.items || [];
+    } catch (e) {
+      console.error("Error fetching chapter progress:", e);
+      return [];
+    }
+  }
+  async getTopicProgress(userId) {
+    try {
+      const result = await this.network.query(
+        `query ListTopicProgress($userId: String!) {
+          listUserTopicProgressByUserIdAndTopicId(userId: $userId) {
+            items { id userId topicId practicedCount mistakeCount correctedCount accuracyScore }
+          }
+        }`,
+        { userId }
+      );
+      return result.data?.listUserTopicProgressByUserIdAndTopicId?.items || result.data?.listUserTopicProgressesByUserIdAndTopicId?.items || [];
+    } catch (e) {
+      console.error("Error fetching topic progress:", e);
+      return [];
+    }
+  }
+  async getTopicMetrics(userId) {
+    try {
+      const result = await this.network.query(
+        `query ListTopicMetrics($filter: ModelUserTopicMetricFilterInput) {
+          listUserTopicMetrics(filter: $filter) {
+            items { id userId topicId totalAttempted totalCorrect accuracy }
+          }
+        }`,
+        { filter: { userId: { eq: userId } } }
+      );
+      return result.data?.listUserTopicMetrics?.items || [];
+    } catch (e) {
+      console.error("Error fetching topic metrics:", e);
+      return [];
+    }
+  }
+  async getMistakenQuestions(userId, status = "MISTAKE") {
+    try {
+      const result = await this.network.query(
+        `query ListMistakes($userId: String!, $filter: ModelQuestionTrackingFilterInput) {
+          listQuestionTrackingByUserIdAndQuestionId(userId: $userId, filter: $filter) {
+            items { id userId questionId subjectId chapterId topicId status attempts }
+          }
+        }`,
+        { userId, filter: { status: { eq: status } } }
+      );
+      return result.data?.listQuestionTrackingByUserIdAndQuestionId?.items || result.data?.listQuestionTrackingsByUserIdAndQuestionId?.items || result.data?.listQuestionTrackings?.items || [];
+    } catch (e) {
+      console.error("Error fetching mistaken questions:", e);
+      return [];
+    }
+  }
+  async getCorrectedQuestions(userId) {
+    return this.getMistakenQuestions(userId, "CORRECTED");
+  }
+};
+
+// src/services/ai.service.ts
+var AIService = class {
+  constructor(network) {
+    this.network = network;
+  }
+  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) {
+          score maxScore feedback isCorrect markingExplanation improvementFeedback subquestions markLocation
+        }
+      }`,
+      input
+    );
+    return result.data.evaluateWrittenAnswer;
+  }
+};
+
+// src/services/news.service.ts
+var NewsService = class {
+  constructor(network) {
+    this.network = network;
+  }
+  async create(title, content, image, category, excerpt) {
+    const result = await this.network.mutate(
+      `mutation CreateNews($input: CreateNewsArticleInput!) {
+        createNewsArticle(input: $input) { id title content image category excerpt createdAt updatedAt }
+      }`,
+      { input: { title, content, image, category, excerpt } }
+    );
+    return result.data.createNewsArticle;
+  }
+  async list(nextToken) {
     const result = await this.network.query(
-      `query CreateCourseVideo($courseId: ID!, $fileName: String!, $fileType: String!) {
-        createCourseVideo(courseId: $courseId, fileName: $fileName, fileType: $fileType) { status videoId }
+      `query ListNews($nextToken: String) {
+        listNewsArticles(nextToken: $nextToken) {
+          items { id title content image category excerpt createdAt updatedAt }
+          nextToken
+        }
       }`,
-      input
+      { nextToken }
     );
-    return result.data.createCourseVideo;
+    return result.data.listNewsArticles;
   }
-  async uploadVideoToBunny(input) {
-    const result = await this.network.mutate(
-      `mutation UploadR2VideoToBunny($key: String!, $videoId: String!, $fileType: String!) {
-        uploadR2VideoToBunny(key: $key, videoId: $videoId, fileType: $fileType) { status }
+  async get(id) {
+    const result = await this.network.query(
+      `query GetNews($id: ID!) {
+        getNewsArticle(id: $id) { id title content image category excerpt createdAt updatedAt }
       }`,
-      input
+      { id }
     );
-    return result.data.uploadR2VideoToBunny;
+    return result.data.getNewsArticle;
   }
 };
 
-// src/services/progress.service.ts
-var ProgressService = class {
+// src/services/notification.service.ts
+var NotificationService = class {
   constructor(network) {
     this.network = network;
   }
-  async track(input) {
-    const result = await this.network.mutate(
-      `mutation TrackProgress($questionId: ID!, $isCorrect: Boolean!, $subjectId: ID, $chapterId: ID, $topicId: ID) {
-        trackPracticeProgress(questionId: $questionId, isCorrect: $isCorrect, subjectId: $subjectId, chapterId: $chapterId, topicId: $topicId) { status }
+  /**
+   * 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
+        }
       }`,
-      input
+      { limit, nextToken }
     );
-    return result.data.trackPracticeProgress;
+    return result.data.listAnnouncements ?? { items: [], nextToken: null };
   }
-  async getSubjectProgress(userId) {
+  /**
+   * List announcements by category.
+   */
+  async listAnnouncementsByCategory(category = "ANNOUNCEMENT", limit = 20, nextToken) {
     const result = await this.network.query(
-      `query ListSubjectProgress($userId: String!) {
-        listUserSubjectProgressByUserIdAndSubjectId(userId: $userId) {
-          items { id userId subjectId practicedCount mistakeCount correctedCount accuracyScore }
+      `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
         }
       }`,
-      { userId }
+      { category, limit, nextToken, sortDirection: "DESC" }
     );
-    return result.data.listUserSubjectProgressByUserIdAndSubjectId.items;
+    return result.data.listAnnouncementByCategoryAndCreatedAt ?? {
+      items: [],
+      nextToken: null
+    };
   }
-  async getChapterProgress(userId) {
-    const result = await this.network.query(
-      `query ListChapterProgress($userId: String!) {
-        listUserChapterProgressByUserIdAndChapterId(userId: $userId) {
-          items { id userId chapterId practicedCount mistakeCount correctedCount accuracyScore }
+  /**
+   * 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 }
       }`,
-      { userId }
+      { input: { id } }
     );
-    return result.data.listUserChapterProgressByUserIdAndChapterId.items;
+    return Boolean(result.data.deleteAnnouncement?.id);
   }
-  async getTopicProgress(userId) {
+  /**
+   * List user notifications for a specific user ID.
+   */
+  async listUserNotifications(userId, limit = 20, nextToken) {
     const result = await this.network.query(
-      `query ListTopicProgress($userId: String!) {
-        listUserTopicProgressByUserIdAndTopicId(userId: $userId) {
-          items { id userId topicId practicedCount mistakeCount correctedCount accuracyScore }
+      `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 }
+      { userId, limit, nextToken, sortDirection: "DESC" }
     );
-    return result.data.listUserTopicProgressByUserIdAndTopicId.items;
+    return result.data.listUserNotificationByUserIdAndCreatedAt ?? {
+      items: [],
+      nextToken: null
+    };
   }
-  async getTopicMetrics(userId) {
-    const result = await this.network.query(
-      `query ListTopicMetrics($filter: ModelUserTopicMetricFilterInput) {
-        listUserTopicMetrics(filter: $filter) {
-          items { id userId topicId totalAttempted totalCorrect accuracy }
+  /**
+   * 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
         }
       }`,
-      { filter: { userId: { eq: userId } } }
+      {
+        input: {
+          ...input,
+          isRead: false
+        }
+      }
     );
-    return result.data.listUserTopicMetrics.items;
+    return result.data.createUserNotification;
   }
-  async getMistakenQuestions(userId) {
-    const result = await this.network.query(
-      `query ListMistakes($userId: String!, $filter: ModelQuestionTrackingFilterInput) {
-        listQuestionTrackingByUserIdAndSubjectId(userId: $userId, filter: $filter) {
-          items { id userId questionId subjectId chapterId topicId status attempts }
+  /**
+   * 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
         }
       }`,
-      { userId, filter: { status: { eq: "MISTAKE" } } }
+      {
+        input: {
+          id,
+          isRead: true,
+          readAt: now
+        }
+      }
     );
-    return result.data.listQuestionTrackingByUserIdAndSubjectId.items;
+    return result.data.updateUserNotification;
   }
-};
-
-// src/services/ai.service.ts
-var AIService = class {
-  constructor(network) {
-    this.network = network;
+  /**
+   * 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);
   }
-  async evaluateWrittenAnswer(input) {
-    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) {
-          score maxScore feedback isCorrect markingExplanation improvementFeedback subquestions markLocation
-        }
+  /**
+   * 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
+      { input: { id: userId, lastReadAnnouncementAt: timestamp } }
     );
-    return result.data.evaluateWrittenAnswer;
+    return Boolean(result.data.updateUser?.id);
   }
 };
 
-// src/services/news.service.ts
-var NewsService = class {
+// src/services/subscription.service.ts
+var SubscriptionService = class {
   constructor(network) {
     this.network = network;
   }
-  async create(title, content, image, category, excerpt) {
+  async createRequest(input) {
     const result = await this.network.mutate(
-      `mutation CreateNews($input: CreateNewsArticleInput!) {
-        createNewsArticle(input: $input) { id title content image category excerpt createdAt updatedAt }
+      `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: { title, content, image, category, excerpt } }
+      { input }
     );
-    return result.data.createNewsArticle;
+    return result.data.createSubscriptionRequest;
   }
-  async list(nextToken) {
+  async getRequest(id) {
     const result = await this.network.query(
-      `query ListNews($nextToken: String) {
-        listNewsArticles(nextToken: $nextToken) {
-          items { id title content image category excerpt createdAt updatedAt }
-          nextToken
+      `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
         }
       }`,
-      { nextToken }
+      { id }
     );
-    return result.data.listNewsArticles;
+    return result.data.getSubscriptionRequest;
   }
-  async get(id) {
+  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 GetNews($id: ID!) {
-        getNewsArticle(id: $id) { id title content image category excerpt createdAt updatedAt }
+      `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
+        }
       }`,
-      { id }
+      { limit, nextToken: input.nextToken, filter: input.filter }
     );
-    return result.data.getNewsArticle;
+    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;
   }
 };
 
@@ -1147,6 +2406,8 @@ var NewsService = class {
 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);
     this.packs = new PackService(config.networkProvider);
@@ -1157,12 +2418,218 @@ 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/logic/avatar.ts
+var HAIR_COLORS = [
+  { name: "Original", filter: "none", hex: "#e2e8f0", brightness: 1 },
+  { name: "White", filter: "grayscale(100%) brightness(500%)", hex: "#ffffff", brightness: 2 },
+  { name: "Black", filter: "grayscale(100%) brightness(40%)", hex: "#1a202c", brightness: 0.15 },
+  { name: "Brown", filter: "sepia(100%) saturate(300%) hue-rotate(330deg) brightness(80%)", hex: "#7b3f00", brightness: 0.35 },
+  { name: "Blonde", filter: "sepia(100%) saturate(400%) hue-rotate(20deg) brightness(130%)", hex: "#e6c27a", brightness: 0.8 },
+  { name: "Red", filter: "sepia(100%) saturate(500%) hue-rotate(320deg) brightness(90%)", hex: "#9b2c2c", brightness: 0.4 },
+  { name: "Blue", filter: "sepia(100%) saturate(500%) hue-rotate(180deg) brightness(90%)", hex: "#2b6cb0", brightness: 0.4 },
+  { name: "Green", filter: "sepia(100%) saturate(400%) hue-rotate(80deg) brightness(90%)", hex: "#2f855a", brightness: 0.45 }
+];
+var CLOTHES_COLORS = [
+  { name: "Original", filter: "none", hex: "#e2e8f0", brightness: 1 },
+  { name: "White", filter: "grayscale(100%) brightness(500%)", hex: "#ffffff", brightness: 2 },
+  { name: "Black", filter: "grayscale(100%) brightness(30%)", hex: "#1a202c", brightness: 0.12 },
+  { name: "Red", filter: "sepia(100%) saturate(500%) hue-rotate(320deg)", hex: "#c53030", brightness: 0.45 },
+  { name: "Orange", filter: "sepia(100%) saturate(500%) hue-rotate(350deg)", hex: "#dd6b20", brightness: 0.55 },
+  { name: "Yellow", filter: "sepia(100%) saturate(500%) hue-rotate(20deg) brightness(120%)", hex: "#d69e2e", brightness: 0.8 },
+  { name: "Green", filter: "sepia(100%) saturate(500%) hue-rotate(80deg)", hex: "#38a169", brightness: 0.55 },
+  { name: "Blue", filter: "sepia(100%) saturate(500%) hue-rotate(180deg)", hex: "#3182ce", brightness: 0.45 },
+  { name: "Purple", filter: "sepia(100%) saturate(500%) hue-rotate(240deg)", hex: "#805ad5", brightness: 0.45 },
+  { name: "Pink", filter: "sepia(100%) saturate(400%) hue-rotate(290deg)", hex: "#d53f8c", brightness: 0.55 }
+];
+var COLOR_HUES = {
+  Original: 0,
+  Red: 0,
+  Orange: 24,
+  Yellow: 45,
+  Green: 140,
+  Blue: 210,
+  Purple: 270,
+  Pink: 320,
+  Brown: 25,
+  Blonde: 45
+};
+var RENDER_ORDER = [
+  "Background",
+  "Hair Back",
+  "Clothes Back",
+  "Skin Color Body",
+  "Clothes Front",
+  "Skin Color Head",
+  "Accessories",
+  "Facial Expression",
+  "Beard",
+  "Hair Front",
+  "Eyewear",
+  "Headwears"
+];
+var INITIAL_AVATAR_DATA = {
+  Background: [],
+  Hair: [],
+  "Skin Color": [],
+  Clothes: [],
+  Accessories: [],
+  Headwears: [],
+  Eyewear: [],
+  "Facial Expression": [],
+  Beard: []
+};
+function getActualOptionFileName(category, baseName, config, selections) {
+  if (baseName === "None") return null;
+  const items = config[category] || [];
+  const matched = items.filter((item) => item.base_name === baseName);
+  if (matched.length === 0) return null;
+  for (const item of matched) {
+    if (item.conditions && item.conditions.length > 0) {
+      const allMet = item.conditions.every((cond) => {
+        return Object.values(selections).some(
+          (sel) => sel && (sel.includes(cond) || cond.includes(sel))
+        );
+      });
+      if (allMet) return item;
+    }
+  }
+  return matched.find((item) => !item.conditions || item.conditions.length === 0) || matched[0] || null;
+}
+function parseAvatarConfig(configStr) {
+  if (!configStr) {
+    return { selections: {}, colors: {} };
+  }
+  try {
+    const parsed = JSON.parse(configStr);
+    return {
+      selections: parsed.selections || {},
+      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 = [
   { name: "Iron", minRating: 0, maxRating: 799, color: "#6B7280" },
@@ -1263,6 +2730,246 @@ function detectQuestionType(option2, option3, option4) {
   }
   return "MCQ";
 }
+function isCorrectAnswer(selected, correct) {
+  if (!selected || !correct) return false;
+  const selTrim = String(selected).trim();
+  const corrTrim = String(correct).trim();
+  if (selTrim === corrTrim) return true;
+  const selNum = Number(selTrim);
+  const corrNum = Number(corrTrim);
+  if (!isNaN(selNum) && !isNaN(corrNum) && selNum === corrNum) {
+    return true;
+  }
+  return false;
+}
+function calculateDefaultExamMinutes(mode, questions) {
+  const mcqCount = questions.filter((q) => q.type !== "WRITTEN").length;
+  const writtenCount = questions.filter((q) => q.type === "WRITTEN").length;
+  if (mode === "MCQ") return Math.max(1, mcqCount * 1);
+  if (mode === "WRITTEN") return Math.max(1, writtenCount * 10);
+  return Math.max(1, mcqCount * 1 + writtenCount * 10);
+}
+function reorderObjectKeys(obj, oldIndex, newIndex, length) {
+  const arr = [];
+  for (let i = 0; i < length; i++) {
+    arr.push(obj[i]);
+  }
+  const [movedItem] = arr.splice(oldIndex, 1);
+  arr.splice(newIndex, 0, movedItem);
+  const newObj = {};
+  arr.forEach((item, idx) => {
+    if (item !== void 0) {
+      newObj[idx] = item;
+    }
+  });
+  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;
@@ -1468,126 +3175,281 @@ function formatQuestionsToCsv(questions, packSubjectId, packChapterId, packTopic
 ${rows.join("\n")}`;
 }
 
-// src/logic/media-url.ts
-function isStorageKey(value) {
-  return !value.startsWith("http://") && !value.startsWith("https://");
-}
-var MediaUrlCache = class {
-  constructor(ttlMs = 50 * 60 * 1e3) {
-    this.cache = /* @__PURE__ */ new Map();
-    this.ttlMs = ttlMs;
-  }
-  get(key) {
-    const entry = this.cache.get(key);
-    if (!entry) return void 0;
-    if (Date.now() >= entry.expiresAt) {
-      this.cache.delete(key);
-      return void 0;
+// 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 }
     }
-    return entry.url;
+  },
+  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"
   }
-  set(key, url) {
-    this.cache.set(key, { url, expiresAt: Date.now() + this.ttlMs });
+];
+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"
   }
-  clear() {
-    this.cache.clear();
+];
+function getCycleMultiplier(cycle) {
+  switch (cycle) {
+    case "quarterly":
+      return 3;
+    case "biannually":
+      return 6;
+    case "annually":
+      return 12;
+    case "monthly":
+    default:
+      return 1;
   }
-};
-var warnedNoStorage = false;
-async function resolveMediaUrl(value, storage, cache) {
-  if (!value || value.length === 0) return null;
-  if (!isStorageKey(value)) return value;
-  if (cache) {
-    const cached = cache.get(value);
-    if (cached) return cached;
-  }
-  if (!storage) {
-    if (!warnedNoStorage) {
-      warnedNoStorage = true;
-      console.warn("@orjok/commons: resolveMediaUrl called without a StorageProvider \u2014 returning raw key");
-    }
-    return value;
-  }
-  const { url } = await storage.getFileUrl(value);
-  cache?.set(value, url);
-  return url;
-}
-async function resolveMediaUrls(obj, fields, storage, cache) {
-  const copy = { ...obj };
-  await Promise.all(
-    fields.map(async (field) => {
-      const val = copy[field];
-      if (typeof val === "string") {
-        copy[field] = await resolveMediaUrl(val, storage, cache);
-      }
-    })
-  );
-  return copy;
 }
-function _resetMediaUrlWarning() {
-  warnedNoStorage = false;
+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);
 }
-
-// src/logic/practice.ts
-function aggregateSubjectMetrics(progress) {
-  let totalPracticed = 0;
-  let totalMistakes = 0;
-  let totalCorrected = 0;
-  for (const p of progress) {
-    totalPracticed += p.practicedCount ?? 0;
-    totalMistakes += p.mistakeCount ?? 0;
-    totalCorrected += p.correctedCount ?? 0;
-  }
-  const accuracy = totalPracticed > 0 ? Math.round((totalPracticed - totalMistakes) / totalPracticed * 100) : 0;
-  return { totalPracticed, totalMistakes, totalCorrected, accuracy };
-}
-function aggregateChapterMetrics(progress) {
-  let totalPracticed = 0;
-  let totalMistakes = 0;
-  let totalCorrected = 0;
-  for (const p of progress) {
-    totalPracticed += p.practicedCount ?? 0;
-    totalMistakes += p.mistakeCount ?? 0;
-    totalCorrected += p.correctedCount ?? 0;
-  }
-  const accuracy = totalPracticed > 0 ? Math.round((totalPracticed - totalMistakes) / totalPracticed * 100) : 0;
-  return { totalPracticed, totalMistakes, totalCorrected, accuracy };
-}
-function aggregateTopicMetrics(progress) {
-  let totalPracticed = 0;
-  let totalMistakes = 0;
-  let totalCorrected = 0;
-  for (const p of progress) {
-    totalPracticed += p.practicedCount ?? 0;
-    totalMistakes += p.mistakeCount ?? 0;
-    totalCorrected += p.correctedCount ?? 0;
-  }
-  const accuracy = totalPracticed > 0 ? Math.round((totalPracticed - totalMistakes) / totalPracticed * 100) : 0;
-  return { totalPracticed, totalMistakes, totalCorrected, accuracy };
-}
-function calculateAccuracy(practiced, mistakes) {
-  if (practiced <= 0) return 0;
-  return Math.round((practiced - mistakes) / practiced * 100);
+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;
 }
-
-// src/utils/shuffle.ts
-function shuffle(array) {
-  const result = [...array];
-  let currentIndex = result.length;
-  while (currentIndex !== 0) {
-    const randomIndex = Math.floor(Math.random() * currentIndex);
-    currentIndex--;
-    [result[currentIndex], result[randomIndex]] = [result[randomIndex], result[currentIndex]];
+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;
   }
-  return result;
 }
-function shuffleInPlace(array) {
-  let currentIndex = array.length;
-  while (currentIndex !== 0) {
-    const randomIndex = Math.floor(Math.random() * currentIndex);
-    currentIndex--;
-    [array[currentIndex], array[randomIndex]] = [array[randomIndex], array[currentIndex]];
+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();
+  if (normalized.startsWith("/contests") || normalized.startsWith("/contest")) {
+    return "contests";
   }
+  if (normalized.startsWith("/courses") || normalized.startsWith("/course") || normalized.startsWith("/exams")) {
+    return "courses";
+  }
+  if (normalized.startsWith("/profile") || normalized.startsWith("/dashboard") || normalized.startsWith("/edit-profile")) {
+    return "profile";
+  }
+  if (normalized.startsWith("/learn") || normalized.startsWith("/practice") || normalized.startsWith("/questions") || normalized.startsWith("/question") || normalized.startsWith("/bank") || normalized.startsWith("/question-bank") || normalized.startsWith("/packs") || normalized.startsWith("/pack") || normalized.startsWith("/taxonomy") || normalized.startsWith("/explore")) {
+    return "learn";
+  }
+  return "home";
+}
+function getCanonicalPath(pathname) {
+  const normalized = pathname.toLowerCase();
+  if (normalized === "/explore/questions") return "/learn/questions";
+  if (normalized === "/explore/packs") return "/learn/packs";
+  if (normalized === "/question-bank") return "/learn/bank";
+  if (normalized === "/contest/all") return "/contests";
+  if (normalized === "/dashboard") return "/profile";
+  if (normalized === "/edit-profile") return "/profile/edit";
+  return pathname;
+}
+function isAuthGatedRoute(pathname) {
+  const normalized = pathname.toLowerCase();
+  const isProtectedPath = normalized.includes("/exam") || normalized.includes("/enroll") || normalized.startsWith("/profile") || normalized.startsWith("/dashboard") || normalized.startsWith("/edit-profile") || normalized.startsWith("/avatar-creator") || normalized.startsWith("/practice");
+  return isProtectedPath;
 }
 
 // src/utils/bangla-numbers.ts
@@ -1600,15 +3462,51 @@ function engToBanglaNumber(num) {
 }
 
 // src/utils/format-curriculum.ts
-function formatCurriculumName(idString, dbName) {
-  if (dbName) return dbName;
+function extractBilingualName(name, language) {
+  if (!name) return "";
+  const trimmed = name.trim();
+  const match = trimmed.match(/^(.*?)\s*[\(\[（]\s*([^\)\]）]+)\s*[\)\]）]\s*$/);
+  if (!match) {
+    return trimmed;
+  }
+  const part1 = match[1]?.trim() || "";
+  const part2 = match[2]?.trim() || "";
+  if (!part1 && !part2) return trimmed;
+  if (!part1) return part2;
+  if (!part2) return part1;
+  const hasBengali = (text) => /[\u0980-\u09FF]/.test(text);
+  const isPart1Bengali = hasBengali(part1);
+  const isPart2Bengali = hasBengali(part2);
+  let banglaPart = part1;
+  let englishPart = part2;
+  if (!isPart1Bengali && isPart2Bengali) {
+    banglaPart = part2;
+    englishPart = part1;
+  } else {
+    banglaPart = part1;
+    englishPart = part2;
+  }
+  const lang = language?.toLowerCase();
+  if (lang === "en") {
+    return englishPart || banglaPart || trimmed;
+  }
+  if (lang === "bn") {
+    return banglaPart || englishPart || trimmed;
+  }
+  return trimmed;
+}
+function formatCurriculumName(idString, dbName, language) {
+  if (dbName) {
+    return extractBilingualName(dbName, language);
+  }
   if (!idString) return "";
   const namePart = idString.split("::")[0] ?? "";
   const clean = namePart.replace(/[-_]/g, " ");
-  return clean.split(/\s+/).map((word) => {
+  const formatted = clean.split(/\s+/).map((word) => {
     if (!word) return "";
     return word.charAt(0).toUpperCase() + word.slice(1);
   }).join(" ");
+  return extractBilingualName(formatted, language);
 }
 
 // src/utils/relative-time.ts
@@ -1673,50 +3571,243 @@ function processLatexText(str) {
   result += remainingText.replace(/\\n/g, "\n");
   return result;
 }
+
+// src/utils/time.ts
+function convertToBangladeshTime(isoString, locale = "en-GB") {
+  const options = {
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+    hour: "numeric",
+    minute: "numeric",
+    hour12: true
+  };
+  const date = new Date(isoString);
+  const resolvedLocale = locale === "bn" ? "bn-BD" : locale;
+  return date.toLocaleString(resolvedLocale, {
+    ...options,
+    timeZone: "Asia/Dhaka"
+  });
+}
+function getDhakaNow() {
+  const now = /* @__PURE__ */ new Date();
+  const parts = new Intl.DateTimeFormat("en-CA", {
+    timeZone: "Asia/Dhaka",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: false
+  }).formatToParts(now);
+  const get = (type) => parts.find((p) => p.type === type)?.value ?? "00";
+  return /* @__PURE__ */ new Date(`${get("year")}-${get("month")}-${get("day")}T${get("hour")}:${get("minute")}:${get("second")}`);
+}
+function calculateTimeLeft(endTime) {
+  const target = new Date(endTime).getTime();
+  const now = (/* @__PURE__ */ new Date()).getTime();
+  const difference = target - now;
+  if (difference <= 0 || isNaN(difference)) {
+    return {
+      days: 0,
+      hours: 0,
+      minutes: 0,
+      seconds: 0,
+      isEnded: true
+    };
+  }
+  return {
+    days: Math.floor(difference / (1e3 * 60 * 60 * 24)),
+    hours: Math.floor(difference / (1e3 * 60 * 60) % 24),
+    minutes: Math.floor(difference / 1e3 / 60 % 60),
+    seconds: Math.floor(difference / 1e3 % 60),
+    isEnded: false
+  };
+}
+function formatDate(date, locale = "en-GB") {
+  const d = typeof date === "string" ? new Date(date) : date;
+  return d.toLocaleDateString(locale, {
+    day: "2-digit",
+    month: "short",
+    year: "numeric"
+  });
+}
+
+// src/utils/currency.ts
+function formatBDT(amount) {
+  return amount.toLocaleString("en-US");
+}
+
+// src/utils/url.ts
+function getYouTubeId(url) {
+  if (!url) return null;
+  const regExp = /^.*(youtu.be\/|v\/|u\/\w\/|embed\/|watch\?v=|[?&]v=)([^#&?]*).*/;
+  const match = url.match(regExp);
+  return match && match[2]?.length === 11 ? match[2] : null;
+}
+
+// src/utils/file.ts
+function sanitizeFileName(name) {
+  return name.replace(/[\s,]+/g, "_");
+}
+
+// src/utils/guards.ts
+function isQuestionLevel(value) {
+  return [
+    "One",
+    "Two",
+    "Three",
+    "Four",
+    "Five",
+    "Six",
+    "Seven",
+    "Eight",
+    "SSC",
+    "HSC",
+    "Admission",
+    "HSC+Admission",
+    "BCS"
+  ].includes(value);
+}
+function isLanguage(value) {
+  return ["Bangla", "English", "Any"].includes(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,
   aggregateTopicMetrics,
   buildImageAnswer,
   calculateAccuracy,
+  calculateDefaultExamMinutes,
   calculateExamTime,
+  calculateStreakFromDates,
+  calculateTimeLeft,
+  calculateUnreadCount,
+  calculateXpReward,
+  canAccessMistakeVault,
+  canExportPack,
+  canWatchContestSolution,
+  checkDailyPracticeLimit,
   computeRatingDelta,
+  convertToBangladeshTime,
   createOrjokClient,
   detectQuestionType,
+  difficultyOptions,
   engToBanglaNumber,
+  extractBilingualName,
   filterQuestionsByMode,
+  formatBDT,
   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,
+  isDifficultyMatch,
   isImageAnswer,
+  isLanguage,
+  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
 };