@orjok/commons 1.0.2 → 1.1.0

package/dist/index.js

@@ -1,3 +1,20 @@
+import {
+  MediaUrlCache,
+  _resetMediaUrlWarning,
+  aggregateChapterMetrics,
+  aggregateSubjectMetrics,
+  aggregateTopicMetrics,
+  calculateAccuracy,
+  isDifficultyMatch,
+  isLanguageMatch,
+  isStorageKey,
+  isValidMCQ,
+  resolveMediaUrl,
+  resolveMediaUrls,
+  shuffle,
+  shuffleInPlace
+} from "./chunk-ZDGYAVEC.js";
+
 // src/services/user.service.ts
 var UserService = class {
   constructor(network) {
@@ -30,10 +47,10 @@ var UserService = class {
     );
     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 +60,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 +76,7 @@ var UserService = class {
           nextToken
         }
       }`,
-      { owner: userId, nextToken, sortDirection: "DESC" }
+      { owner: userId, limit, nextToken, sortDirection: "DESC" }
     );
     return result.data.listPackByOwnerAndCreatedAt;
   }
@@ -159,6 +176,23 @@ 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 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!) {
@@ -172,6 +206,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!) {
@@ -239,7 +308,7 @@ var QuestionService = class {
         listQuestionObjectBySubjectIdAndCreatedAt(subjectId: $subjectId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
           items {
             id question imageUrl language level difficulty type voteCount
-            verificationStatus owner packId createdAt
+            verificationStatus owner packId subjectId chapterId topicId createdAt
             options { items { id content } }
           }
           nextToken
@@ -261,7 +330,7 @@ var QuestionService = class {
         listQuestionObjectByChapterIdAndCreatedAt(chapterId: $chapterId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
           items {
             id question imageUrl language level difficulty type voteCount
-            verificationStatus owner packId createdAt
+            verificationStatus owner packId subjectId chapterId topicId createdAt
             options { items { id content } }
           }
           nextToken
@@ -283,7 +352,7 @@ var QuestionService = class {
         listQuestionObjectByTopicIdAndCreatedAt(topicId: $topicId, sortDirection: $sortDirection, limit: $limit, nextToken: $nextToken) {
           items {
             id question imageUrl language level difficulty type voteCount
-            verificationStatus owner packId createdAt
+            verificationStatus owner packId subjectId chapterId topicId createdAt
             options { items { id content } }
           }
           nextToken
@@ -368,7 +437,22 @@ 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 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(
@@ -954,13 +1038,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(
@@ -1023,68 +1128,100 @@ var ProgressService = class {
     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 }
       }`,
-      input
+      variables
     );
-    return result.data.trackPracticeProgress;
+    return result.data?.trackPracticeProgress || { status: "success" };
   }
   async getSubjectProgress(userId) {
-    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;
+    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) {
-    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;
+    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) {
-    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;
+    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) {
-    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;
+    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) {
-    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 }
-        }
-      }`,
-      { userId, filter: { status: { eq: "MISTAKE" } } }
-    );
-    return result.data.listQuestionTrackingByUserIdAndSubjectId.items;
+    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: "MISTAKE" } } }
+      );
+      return result.data?.listQuestionTrackingByUserIdAndQuestionId?.items || result.data?.listQuestionTrackingsByUserIdAndQuestionId?.items || result.data?.listQuestionTrackings?.items || [];
+    } catch (e) {
+      console.error("Error fetching mistaken questions:", e);
+      return [];
+    }
   }
 };
 
@@ -1147,6 +1284,7 @@ var NewsService = class {
 var OrjokClient = class {
   constructor(config) {
     this.auth = config.authProvider;
+    this.storage = config.storageProvider;
     this.users = new UserService(config.networkProvider);
     this.questions = new QuestionService(config.networkProvider);
     this.packs = new PackService(config.networkProvider);
@@ -1163,6 +1301,118 @@ function createOrjokClient(config) {
   return new OrjokClient(config);
 }
 
+// src/types/select-options.ts
+var levelOptions = [
+  { value: "SSC", label: "SSC" },
+  { value: "HSC+Admission", label: "HSC/Admission" },
+  { value: "BCS", label: "BCS" }
+];
+var languageOptions = [
+  { value: "Bangla", label: "Bangla" },
+  { value: "English", label: "English" },
+  { value: "Any", label: "Any" }
+];
+var difficultyOptions = [
+  { value: "Easy", label: "Easy" },
+  { value: "Medium", label: "Medium" },
+  { value: "Hard", label: "Hard" }
+];
+
+// src/logic/avatar.ts
+var HAIR_COLORS = [
+  { name: "Original", filter: "none", hex: "#e2e8f0", brightness: 1 },
+  { 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 || {}
+    };
+  } catch {
+    return { selections: {}, colors: {} };
+  }
+}
+function serializeAvatarConfig(state) {
+  return JSON.stringify(state);
+}
+
 // src/logic/elo.ts
 var TIERS = [
   { name: "Iron", minRating: 0, maxRating: 799, color: "#6B7280" },
@@ -1263,6 +1513,40 @@ 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/import-export.ts
 var MAX_QUESTIONS = 200;
@@ -1468,126 +1752,37 @@ 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;
-    }
-    return entry.url;
+// src/navigation.ts
+function getActiveTab(pathname) {
+  const normalized = pathname.toLowerCase();
+  if (normalized.startsWith("/contests") || normalized.startsWith("/contest")) {
+    return "contests";
   }
-  set(key, url) {
-    this.cache.set(key, { url, expiresAt: Date.now() + this.ttlMs });
+  if (normalized.startsWith("/courses") || normalized.startsWith("/course") || normalized.startsWith("/exams")) {
+    return "courses";
   }
-  clear() {
-    this.cache.clear();
+  if (normalized.startsWith("/profile") || normalized.startsWith("/dashboard") || normalized.startsWith("/edit-profile")) {
+    return "profile";
   }
-};
-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;
+  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";
   }
-  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;
+  return "home";
 }
-
-// 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);
-}
-
-// 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]];
-  }
-  return result;
+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 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 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 +1795,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,11 +1904,119 @@ function processLatexText(str) {
   result += remainingText.replace(/\\n/g, "\n");
   return result;
 }
+
+// src/utils/time.ts
+function convertToBangladeshTime(isoString) {
+  const options = {
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+    hour: "numeric",
+    minute: "numeric",
+    hour12: true
+  };
+  const date = new Date(isoString);
+  return date.toLocaleString("en-GB", {
+    ...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);
+}
 export {
   AIService,
+  CLOTHES_COLORS,
+  COLOR_HUES,
   ContestService,
   CourseService,
   CurriculumService,
+  HAIR_COLORS,
+  INITIAL_AVATAR_DATA,
   MediaService,
   MediaUrlCache,
   NewsService,
@@ -1685,6 +2024,7 @@ export {
   PackService,
   ProgressService,
   QuestionService,
+  RENDER_ORDER,
   UserService,
   _resetMediaUrlWarning,
   aggregateChapterMetrics,
@@ -1692,31 +2032,57 @@ export {
   aggregateTopicMetrics,
   buildImageAnswer,
   calculateAccuracy,
+  calculateDefaultExamMinutes,
   calculateExamTime,
+  calculateTimeLeft,
   computeRatingDelta,
+  convertToBangladeshTime,
   createOrjokClient,
   detectQuestionType,
+  difficultyOptions,
   engToBanglaNumber,
+  extractBilingualName,
   filterQuestionsByMode,
+  formatBDT,
   formatCurriculumName,
+  formatDate,
   formatExamTime,
   formatQuestionsToCsv,
   formatQuestionsToText,
+  getActiveTab,
+  getActualOptionFileName,
   getAllTiers,
+  getCanonicalPath,
+  getDhakaNow,
   getEloProgress,
   getEloTier,
   getRatingForSubject,
   getRelativeTime,
+  getYouTubeId,
+  isAuthGatedRoute,
+  isCorrectAnswer,
+  isDifficulty,
+  isDifficultyMatch,
   isImageAnswer,
+  isLanguage,
+  isLanguageMatch,
+  isQuestionLevel,
   isStorageKey,
+  isValidMCQ,
+  languageOptions,
+  levelOptions,
   normalizeDifficulty,
+  parseAvatarConfig,
   parseCsvQuestions,
   parseImageKeys,
   parseTextQuestions,
   processLatexText,
+  reorderObjectKeys,
   resolveMediaUrl,
   resolveMediaUrls,
+  sanitizeFileName,
   scoreExam,
+  serializeAvatarConfig,
   shuffle,
   shuffleInPlace
 };