@orjok/commons 1.0.2 → 1.2.0

package/dist/index.d.cts

@@ -1,7 +1,50 @@
-import { Q as QuestionType, a as QuestionObject, D as Difficulty, U as UserChapterProgress, b as UserSubjectProgress, c as UserTopicProgress } from './client-BaOC79Nc.cjs';
-export { A as AIService, d as AIUsageLog, e as AddQuestionTagInput, C as Chapter, f as CheckParticipationResponse, g as Contest, h as ContestAnswersResponse, i as ContestOption, j as ContestParticipant, k as ContestQuestion, l as ContestQuestionsResponse, m as ContestService, n as Course, o as CourseEnrolled, p as CourseEnrollmentRequest, q as CourseItem, r as CourseItemType, s as CourseLiveExam, t as CourseLiveExamParticipant, u as CourseLiveExamQuestionsResponse, v as CourseService, w as CreateContestInput, x as CreateCourseInput, y as CreateCourseItemInput, z as CreateCourseLiveExamInput, B as CreateCourseResponse, E as CreateCourseVideoInput, F as CreateCourseVideoResponse, G as CreatePackInput, H as CreateQuestionInput, I as CreateQuestionResponse, J as CurriculumService, K as DeleteCourseItemInput, L as EnrollStudentInput, M as EvaluateWrittenAnswerInput, N as EvaluateWrittenAnswerResponse, P as GetSignedFileURLInput, R as GetSignedURLInput, S as Language, T as LeaderboardResponse, V as Level, W as ListByCurriculumInput, X as ListByRandomHashInput, Y as MediaService, Z as ModelType, _ as NewsArticle, $ as NewsService, a0 as Option, O as OrjokClient, a1 as OrjokClientConfig, a2 as Pack, a3 as PackExamResults, a4 as PackGroup, a5 as PackReport, a6 as PackService, a7 as PackTag, a8 as PaginatedList, a9 as PaymentStatus, aa as PaymentTransaction, ab as ProgressService, ac as QuestionReport, ad as QuestionService, ae as QuestionTag, af as QuestionTracking, ag as QuestionTrackingStatus, ah as QuestionVote, ai as SendEnrollmentRequestInput, aj as SignedURLResponse, ak as SortDirection, al as StatusIdResponse, am as StatusResponse, an as Subject, ao as SubmitPackExamInput, ap as Tag, aq as Tier, ar as Topic, as as TrackPracticeProgressInput, at as UpdateUserAvatarInput, au as UploadImageResponse, av as UploadVideoToBunnyInput, aw as User, ax as UserService, ay as UserTopicMetric, az as Verification, aA as VerificationType, aB as VoteInput, aC as VoteType, aD as createOrjokClient } from './client-BaOC79Nc.cjs';
-import { S as StorageProvider } from './storage-DLqdJgQt.cjs';
-export { A as AuthProvider, a as AuthSession, G as GraphQLResult, N as NetworkProvider, b as UploadOptions, U as UserAttributes } from './storage-DLqdJgQt.cjs';
+import { k as QuestionType, Q as QuestionObject, D as Difficulty, L as Language, l as Level, m as PaginatedList } from './notification-Ctfy0m05.cjs';
+export { n as AIService, o as AIUsageLog, p as AddQuestionTagInput, A as Announcement, C as Chapter, b as CheckParticipationResponse, a as Contest, q as ContestAnswersResponse, r as ContestOption, s as ContestParticipant, t as ContestQuestion, u as ContestQuestionsResponse, v as ContestService, c as Course, w as CourseEnrolled, x as CourseEnrollmentRequest, d as CourseItem, y as CourseItemType, e as CourseLiveExam, z as CourseLiveExamParticipant, B as CourseLiveExamQuestionsResponse, E as CourseService, F as CreateAnnouncementInput, G as CreateContestInput, H as CreateCourseInput, I as CreateCourseItemInput, J as CreateCourseLiveExamInput, K as CreateCourseResponse, M as CreateCourseVideoInput, R as CreateCourseVideoResponse, V as CreatePackGroupInput, W as CreatePackInput, X as CreateQuestionInput, Y as CreateQuestionResponse, Z as CreateSubscriptionRequestInput, _ as CreateUserNotificationInput, $ as CurriculumService, a0 as DeleteCourseItemInput, a1 as EnrollStudentInput, a2 as EvaluateWrittenAnswerInput, a3 as EvaluateWrittenAnswerResponse, a4 as FormatLevelUpParams, a5 as GetSignedFileURLInput, a6 as GetSignedURLInput, a7 as LeaderboardResponse, a8 as LevelUpNotificationResult, a9 as ListByCurriculumInput, aa as ListByLevelInput, ab as ListByPublicExamInput, ac as ListByRandomHashInput, ad as ListPackGroupsInput, ae as ListSubscriptionRequestsInput, af as ListUsersInput, ag as MediaService, ah as MergeTimelineParams, ai as ModelType, aj as NewsArticle, ak as NewsService, al as NotificationService, N as NotificationTimelineItem, am as Option, O as OrjokClient, an as OrjokClientConfig, P as Pack, ao as PackExamResults, ap as PackGroup, aq as PackReport, ar as PackService, as as PackTag, at as PaymentMethod, au as PaymentStatus, av as PaymentTransaction, h as PracticeMetrics, aw as ProgressService, i as PublicExamOption, ax as QuestionReport, ay as QuestionService, az as QuestionTag, aA as QuestionTracking, aB as QuestionTrackingStatus, aC as QuestionVote, aD as SelectOption, aE as SendEnrollmentRequestInput, aF as SignedURLResponse, aG as SortDirection, aH as StatusIdResponse, aI as StatusResponse, S as Subject, aJ as SubmitPackExamInput, aK as SubscriptionRequest, aL as SubscriptionService, aM as Tag, aN as Tier, T as Topic, aO as TrackPracticeProgressInput, aP as UpdateSubscriptionRequestInput, aQ as UpdateUserAvatarInput, aR as UpdateUserNotificationInput, aS as UpdateUserProfileInput, aT as UploadCourseItemInput, aU as UploadImageResponse, aV as UploadVideoToBunnyInput, aW as User, f as UserChapterProgress, j as UserNotification, aX as UserService, U as UserSubjectProgress, aY as UserTopicMetric, g as UserTopicProgress, aZ as Verification, a_ as VerificationType, a$ as VoteInput, b0 as VoteType, b1 as aggregateChapterMetrics, b2 as aggregateSubjectMetrics, b3 as aggregateTopicMetrics, b4 as calculateAccuracy, b5 as calculateUnreadCount, b6 as createOrjokClient, b7 as difficultyOptions, b8 as formatLevelUpNotification, b9 as getPublicExamsByLevel, ba as isDifficultyMatch, bb as isLanguageMatch, bc as isValidMCQ, bd as languageOptions, be as levelOptions, bf as mergeNotificationTimeline, bg as publicExamOptions } from './notification-Ctfy0m05.cjs';
+import { S as StorageProvider } from './storage-9pK8KwIM.cjs';
+export { b as AuthEventListener, A as AuthProvider, a as AuthSession, G as GraphQLResult, N as NetworkProvider, c as UploadOptions, U as UserAttributes } from './storage-9pK8KwIM.cjs';
+
+type RenderCategory = "Background" | "Hair Back" | "Skin Color Body" | "Skin Color Head" | "Skin Color" | "Clothes Back" | "Clothes Front" | "Accessories" | "Headwears" | "Facial Expression" | "Beard" | "Eyewear" | "Hair Front";
+type UICategory = "Background" | "Hair" | "Skin Color" | "Clothes" | "Accessories" | "Headwears" | "Eyewear" | "Facial Expression" | "Beard";
+interface ColorOption {
+    name: string;
+    filter: string;
+    hex: string;
+    brightness: number;
+}
+interface AvatarConfigItem {
+    raw_name: string;
+    safe_name: string;
+    base_name: string;
+    conditions: string[];
+    is_multicolor: boolean;
+    has_inner_color?: boolean;
+    brightness?: number;
+    hue?: number;
+}
+type AvatarConfig = Record<string, AvatarConfigItem[]>;
+interface AvatarState {
+    selections: Record<string, string>;
+    colors: Record<string, string>;
+    gender?: string;
+}
+
+declare const HAIR_COLORS: ColorOption[];
+declare const CLOTHES_COLORS: ColorOption[];
+declare const COLOR_HUES: Record<string, number>;
+declare const RENDER_ORDER: readonly ["Background", "Hair Back", "Clothes Back", "Skin Color Body", "Clothes Front", "Skin Color Head", "Accessories", "Facial Expression", "Beard", "Hair Front", "Eyewear", "Headwears"];
+declare const INITIAL_AVATAR_DATA: Record<UICategory, string[]>;
+declare function getActualOptionFileName(category: string, baseName: string, config: AvatarConfig, selections: Record<string, string>): AvatarConfigItem | null;
+declare function parseAvatarConfig(configStr: string | null | undefined): AvatarState;
+declare function parseAvatarConfigWithDefaults(configStr: string | null | undefined, seed?: string): AvatarState;
+declare function serializeAvatarConfig(state: AvatarState): string;
+declare function generateRandomAvatarState(options?: {
+    gender?: "Male" | "Female";
+    seed?: string;
+}): AvatarState;
+declare function generateRandomAvatarConfig(options?: {
+    gender?: "Male" | "Female";
+    seed?: string;
+}): string;
 
 interface EloTier {
     name: string;
@@ -35,6 +78,48 @@ declare function parseImageKeys(answer: string): string[];
 declare function buildImageAnswer(keys: string[]): string;
 declare function normalizeDifficulty(raw: string): Difficulty | undefined;
 declare function detectQuestionType(option2: string, option3: string, option4: string): QuestionType;
+declare function isCorrectAnswer(selected: string | null | undefined, correct: string | null | undefined): boolean;
+declare function calculateDefaultExamMinutes(mode: ExamMode, questions: Array<{
+    type?: string | null;
+}>): number;
+declare function reorderObjectKeys<T>(obj: {
+    [key: number]: T;
+}, oldIndex: number, newIndex: number, length: number): {
+    [key: number]: T;
+};
+
+/**
+ * Home Logic Utilities
+ * Supports Signed-In User Homepage customization, greeting, streak calculation, and level mapping.
+ */
+interface SubjectShortcut {
+    id: string;
+    name: string;
+    iconKey: string;
+    colorClass: string;
+}
+/**
+ * Maps Cognito user level string to standard level enum values: "SSC" | "HSC+Admission" | "BCS"
+ */
+declare function mapCognitoLevelToStandardLevel(cognitoLevel?: string | null): string;
+/**
+ * Returns contextual time of day greeting
+ */
+declare function getTimeOfDayGreeting(customHour?: number, lang?: "en" | "bn"): {
+    greeting: string;
+    period: "morning" | "afternoon" | "evening" | "night";
+};
+/**
+ * Returns recommended subject shortcuts for the given level
+ */
+declare function getRecommendedSubjectsForLevel(level: string, lang?: "en" | "bn"): SubjectShortcut[];
+/**
+ * Calculates continuous consecutive active study streak in days
+ */
+declare function calculateStreakFromDates(activityDates: string[]): {
+    streak: number;
+    isActiveToday: boolean;
+};
 
 interface ParsedQuestion {
     id?: string;
@@ -51,6 +136,7 @@ interface ParsedQuestion {
     subjectId?: string;
     chapterId?: string;
     topicId?: string;
+    publicExam?: string;
     type: "MCQ" | "WRITTEN";
     markingInstructions?: string;
     answerImageUrl?: string;
@@ -80,26 +166,228 @@ declare function resolveMediaUrl(value: string | null | undefined, storage: Stor
 declare function resolveMediaUrls<T extends Record<string, unknown>>(obj: T, fields: (keyof T)[], storage: StorageProvider | undefined, cache?: MediaUrlCache): Promise<T>;
 declare function _resetMediaUrlWarning(): void;
 
-interface PracticeMetrics {
-    totalPracticed: number;
-    totalMistakes: number;
-    totalCorrected: number;
-    accuracy: number;
+type BillingCycle = "monthly" | "quarterly" | "biannually" | "annually";
+type SubscriptionTier = "FREE" | "PRO" | "PRO_AI";
+interface PlanCyclePricing {
+    monthly: number;
+    quarterly: number;
+    biannually: number;
+    annually: number;
+}
+interface PlanAiQuotaConfig {
+    monthly: {
+        aiEvals: number;
+        aiQuestions: number;
+    };
+    quarterly: {
+        aiEvals: number;
+        aiQuestions: number;
+    };
+    biannually: {
+        aiEvals: number;
+        aiQuestions: number;
+    };
+    annually: {
+        aiEvals: number;
+        aiQuestions: number;
+    };
+}
+interface SubscriptionPlan {
+    id: SubscriptionTier;
+    tier: SubscriptionTier;
+    titleKey: string;
+    descKey: string;
+    pricing: PlanCyclePricing;
+    aiQuotas: PlanAiQuotaConfig;
+}
+interface TopUpBoosterPack {
+    id: string;
+    type: "AI_EVAL" | "AI_QUESTION";
+    amount: number;
+    price: number;
+    titleKey: string;
+    descKey: string;
+    badgeKey?: string;
+}
+declare const MANUAL_PAYMENT_CONFIG: {
+    phoneNumber: string;
+    accountType: string;
+    methods: readonly ["BKASH", "ROCKET"];
+};
+declare const SUBSCRIPTION_PLANS: Record<SubscriptionTier, SubscriptionPlan>;
+declare const AI_EVAL_BOOSTER_PACKS: TopUpBoosterPack[];
+declare const AI_QUESTION_BOOSTER_PACKS: TopUpBoosterPack[];
+declare function getCycleMultiplier(cycle: BillingCycle): number;
+declare function getPlanOriginalPrice(tier: SubscriptionTier | string, cycle: BillingCycle): number;
+declare function getPlanPrice(tier: SubscriptionTier | string, cycle: BillingCycle): number;
+declare function getPlanMonthlyEquivalentPrice(tier: SubscriptionTier | string, cycle: BillingCycle): number;
+declare function getPlanDiscountPercent(cycle: BillingCycle): number;
+declare function getPlanAiQuotas(tier: SubscriptionTier | string, cycle: BillingCycle): {
+    aiEvals: number;
+    aiQuestions: number;
+};
+declare function isValidBangladeshiPhone(phone: string): boolean;
+declare function isValidTrxId(trxId: string): boolean;
+declare function hasProAccess(tier?: string | null, expiresAt?: string | null): boolean;
+declare function hasAiTierAccess(tier?: string | null, expiresAt?: string | null): boolean;
+declare const FREE_DAILY_PRACTICE_LIMIT = 30;
+declare function canExportPack(tier?: string | null, expiresAt?: string | null, isCreator?: boolean): boolean;
+declare function canAccessMistakeVault(tier?: string | null, expiresAt?: string | null, isCreator?: boolean): boolean;
+declare function canWatchContestSolution(tier?: string | null, expiresAt?: string | null, isCreator?: boolean): boolean;
+declare function shouldTrackPracticeProgress(tier?: string | null, expiresAt?: string | null, isCreator?: boolean): boolean;
+declare function getDailyPracticeLimit(tier?: string | null, expiresAt?: string | null): number | null;
+declare function checkDailyPracticeLimit(dailyCount: number, lastPracticeDate: string | null | undefined, tier?: string | null, expiresAt?: string | null, todayStr?: string): {
+    allowed: boolean;
+    remaining: number;
+    currentCount: number;
+    isUnlimited: boolean;
+};
+declare function hasSufficientAiQuestionQuota(quota: number | null | undefined, requested: number): boolean;
+declare function hasSufficientAiEvalQuota(quota: number | null | undefined): boolean;
+
+/**
+ * @file xp.ts
+ * @description Experience Points (XP) and Level progression logic for the Orjok platform.
+ */
+interface XpTier {
+    id: "novice" | "dedicated" | "skilled" | "master" | "grandmaster" | "legend";
+    minLevel: number;
+    maxLevel: number;
+    nameEn: string;
+    nameBn: string;
+    color: string;
+    badgeBg: string;
+    badgeBorder: string;
+    badgeText: string;
+}
+declare const XP_TIERS: XpTier[];
+declare const XP_REWARDS: {
+    readonly PRACTICE_CORRECT: 10;
+    readonly PRACTICE_ATTEMPT: 2;
+    readonly PACK_EXAM_BASE: 20;
+    readonly PACK_EXAM_CORRECT: 5;
+    readonly PACK_EXAM_HIGH_SCORE_BONUS: 25;
+    readonly CONTEST_PARTICIPATION: 50;
+    readonly CONTEST_TOP_10_BONUS: 100;
+    readonly CONTEST_TOP_25_BONUS: 50;
+    readonly CREATE_QUESTION: 25;
+    readonly CREATE_PACK: 50;
+    readonly VOTE: 2;
+    readonly AI_EVALUATION: 15;
+};
+type XpRewardAction = "practice" | "packExam" | "contest" | "createQuestion" | "createPack" | "vote" | "aiEvaluation";
+interface XpRewardMetadata {
+    isCorrect?: boolean;
+    correctCount?: number;
+    totalQuestions?: number;
+    rank?: number;
+    totalParticipants?: number;
+}
+interface XpProgressInfo {
+    level: number;
+    xp: number;
+    currentLevelXp: number;
+    nextLevelXp: number;
+    xpInLevel: number;
+    xpRequiredForLevel: number;
+    xpToNextLevel: number;
+    progressPercent: number;
+    tier: XpTier;
 }
-declare function aggregateSubjectMetrics(progress: UserSubjectProgress[]): PracticeMetrics;
-declare function aggregateChapterMetrics(progress: UserChapterProgress[]): PracticeMetrics;
-declare function aggregateTopicMetrics(progress: UserTopicProgress[]): PracticeMetrics;
-declare function calculateAccuracy(practiced: number, mistakes: number): number;
+/**
+ * Calculates the total cumulative XP required to reach a specific level.
+ * Formula: 25 * (L^2 + L - 2) = 25 * (L - 1) * (L + 2)
+ * Level 1 = 0 XP
+ * Level 2 = 100 XP
+ * Level 3 = 250 XP
+ * Level 4 = 450 XP
+ * Level 5 = 700 XP
+ * Level 6 = 1000 XP
+ * Level 10 = 2700 XP
+ * Level 20 = 10450 XP
+ * Level 50 = 63700 XP
+ */
+declare function getXpForLevel(level: number): number;
+/**
+ * Calculates the user's level based on cumulative XP.
+ * Derived by inverting: 25 * L^2 + 25 * L - (50 + XP) = 0
+ * L = floor((sqrt(9 + 0.16 * XP) - 1) / 2)
+ */
+declare function getLevelFromXp(xp: number): number;
+/**
+ * Returns the XP required to advance from `level` to `level + 1`.
+ */
+declare function getXpRequiredForNextLevel(level: number): number;
+/**
+ * Returns complete progress details for a given cumulative XP value.
+ */
+declare function getXpProgress(xp: number): XpProgressInfo;
+/**
+ * Returns the tier metadata for a given level.
+ */
+declare function getXpTier(level: number): XpTier;
+/**
+ * Returns all configured XP tiers.
+ */
+declare function getAllXpTiers(): XpTier[];
+/**
+ * Calculates the XP reward for a given user activity.
+ */
+declare function calculateXpReward(action: XpRewardAction, metadata?: XpRewardMetadata): number;
+
+type PrimaryTab = "home" | "learn" | "contests" | "courses" | "profile";
+declare function getActiveTab(pathname: string): PrimaryTab;
+declare function getCanonicalPath(pathname: string): string;
+declare function isAuthGatedRoute(pathname: string): boolean;
 
 declare function shuffle<T>(array: T[]): T[];
 declare function shuffleInPlace<T>(array: T[]): void;
 
 declare function engToBanglaNumber(num: number | string): string;
 
-declare function formatCurriculumName(idString: string, dbName?: string | null): string;
+/**
+ * Splits a bilingual string formatted as "Bangla Name (English Name)"
+ * into the requested language ("bn" or "en").
+ * If the string does not follow the bilingual pattern, returns the clean string.
+ */
+declare function extractBilingualName(name: string, language?: "bn" | "en" | string): string;
+declare function formatCurriculumName(idString: string, dbName?: string | null, language?: "bn" | "en" | string): string;
 
 declare function getRelativeTime(startTime: string | Date, endTime?: string | Date): string;
 
 declare function processLatexText(str: string): string;
 
-export { Difficulty, type EloTier, type ExamConfig, type ExamMode, MediaUrlCache, type ParseResult, type ParsedQuestion, type PracticeMetrics, QuestionObject, QuestionType, type RatingField, StorageProvider, UserChapterProgress, UserSubjectProgress, UserTopicProgress, _resetMediaUrlWarning, aggregateChapterMetrics, aggregateSubjectMetrics, aggregateTopicMetrics, buildImageAnswer, calculateAccuracy, calculateExamTime, computeRatingDelta, detectQuestionType, engToBanglaNumber, filterQuestionsByMode, formatCurriculumName, formatExamTime, formatQuestionsToCsv, formatQuestionsToText, getAllTiers, getEloProgress, getEloTier, getRatingForSubject, getRelativeTime, isImageAnswer, isStorageKey, normalizeDifficulty, parseCsvQuestions, parseImageKeys, parseTextQuestions, processLatexText, resolveMediaUrl, resolveMediaUrls, scoreExam, shuffle, shuffleInPlace };
+interface TimeLeft {
+    days: number;
+    hours: number;
+    minutes: number;
+    seconds: number;
+    isEnded: boolean;
+}
+declare function convertToBangladeshTime(isoString: string, locale?: string): string;
+declare function getDhakaNow(): Date;
+declare function calculateTimeLeft(endTime: string | Date): TimeLeft;
+declare function formatDate(date: Date | string, locale?: string): string;
+
+declare function formatBDT(amount: number): string;
+
+declare function getYouTubeId(url: string | null | undefined): string | null;
+
+declare function sanitizeFileName(name: string): string;
+
+declare function isQuestionLevel(value: unknown): value is Level;
+declare function isLanguage(value: unknown): value is Language;
+declare function isDifficulty(value: unknown): value is Difficulty;
+declare function normalizeLevel(value?: string | null): string;
+
+/**
+ * Accumulates items across paginated GraphQL queries until targetLimit is reached
+ * or nextToken is exhausted (null/undefined).
+ *
+ * This guarantees that even when DynamoDB evaluates filter expressions post-read
+ * and yields fewer than requested items in a single scan batch, the consumer
+ * receives up to `targetLimit` matching items and the exact continuation token.
+ */
+declare function paginateWithAccumulator<T>(fetchPage: (limit: number, nextToken?: string | null) => Promise<PaginatedList<T>>, targetLimit?: number, initialNextToken?: string | null, maxIterations?: number): Promise<PaginatedList<T>>;
+
+export { AI_EVAL_BOOSTER_PACKS, AI_QUESTION_BOOSTER_PACKS, type AvatarConfig, type AvatarConfigItem, type AvatarState, type BillingCycle, CLOTHES_COLORS, COLOR_HUES, type ColorOption, Difficulty, type EloTier, type ExamConfig, type ExamMode, FREE_DAILY_PRACTICE_LIMIT, HAIR_COLORS, INITIAL_AVATAR_DATA, Language, Level, MANUAL_PAYMENT_CONFIG, MediaUrlCache, PaginatedList, type ParseResult, type ParsedQuestion, type PlanAiQuotaConfig, type PlanCyclePricing, type PrimaryTab, QuestionObject, QuestionType, RENDER_ORDER, type RatingField, type RenderCategory, SUBSCRIPTION_PLANS, StorageProvider, type SubjectShortcut, type SubscriptionPlan, type SubscriptionTier, type TimeLeft, type TopUpBoosterPack, type UICategory, XP_REWARDS, XP_TIERS, type XpProgressInfo, type XpRewardAction, type XpRewardMetadata, type XpTier, _resetMediaUrlWarning, buildImageAnswer, calculateDefaultExamMinutes, calculateExamTime, calculateStreakFromDates, calculateTimeLeft, calculateXpReward, canAccessMistakeVault, canExportPack, canWatchContestSolution, checkDailyPracticeLimit, computeRatingDelta, convertToBangladeshTime, detectQuestionType, engToBanglaNumber, extractBilingualName, filterQuestionsByMode, formatBDT, formatCurriculumName, formatDate, formatExamTime, formatQuestionsToCsv, formatQuestionsToText, generateRandomAvatarConfig, generateRandomAvatarState, getActiveTab, getActualOptionFileName, getAllTiers, getAllXpTiers, getCanonicalPath, getCycleMultiplier, getDailyPracticeLimit, getDhakaNow, getEloProgress, getEloTier, getLevelFromXp, getPlanAiQuotas, getPlanDiscountPercent, getPlanMonthlyEquivalentPrice, getPlanOriginalPrice, getPlanPrice, getRatingForSubject, getRecommendedSubjectsForLevel, getRelativeTime, getTimeOfDayGreeting, getXpForLevel, getXpProgress, getXpRequiredForNextLevel, getXpTier, getYouTubeId, hasAiTierAccess, hasProAccess, hasSufficientAiEvalQuota, hasSufficientAiQuestionQuota, isAuthGatedRoute, isCorrectAnswer, isDifficulty, isImageAnswer, isLanguage, isQuestionLevel, isStorageKey, isValidBangladeshiPhone, isValidTrxId, mapCognitoLevelToStandardLevel, normalizeDifficulty, normalizeLevel, paginateWithAccumulator, parseAvatarConfig, parseAvatarConfigWithDefaults, parseCsvQuestions, parseImageKeys, parseTextQuestions, processLatexText, reorderObjectKeys, resolveMediaUrl, resolveMediaUrls, sanitizeFileName, scoreExam, serializeAvatarConfig, shouldTrackPracticeProgress, shuffle, shuffleInPlace };