@orjok/commons 1.1.0 → 1.2.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { D as Difficulty, L as Language, i as Level, j as QuestionType, Q as QuestionObject } from './practice-QnWtC5A7.cjs';
-export { A as AIService, k as AIUsageLog, l as AddQuestionTagInput, C as Chapter, b as CheckParticipationResponse, a as Contest, m as ContestAnswersResponse, n as ContestOption, o as ContestParticipant, p as ContestQuestion, q as ContestQuestionsResponse, r as ContestService, c as Course, s as CourseEnrolled, t as CourseEnrollmentRequest, d as CourseItem, u as CourseItemType, e as CourseLiveExam, v as CourseLiveExamParticipant, w as CourseLiveExamQuestionsResponse, x as CourseService, y as CreateContestInput, z as CreateCourseInput, B as CreateCourseItemInput, E as CreateCourseLiveExamInput, F as CreateCourseResponse, G as CreateCourseVideoInput, H as CreateCourseVideoResponse, I as CreatePackInput, J as CreateQuestionInput, K as CreateQuestionResponse, M as CurriculumService, N as DeleteCourseItemInput, R as EnrollStudentInput, V as EvaluateWrittenAnswerInput, W as EvaluateWrittenAnswerResponse, X as GetSignedFileURLInput, Y as GetSignedURLInput, Z as LeaderboardResponse, _ as ListByCurriculumInput, $ as ListByRandomHashInput, a0 as MediaService, a1 as ModelType, a2 as NewsArticle, a3 as NewsService, a4 as Option, O as OrjokClient, a5 as OrjokClientConfig, P as Pack, a6 as PackExamResults, a7 as PackGroup, a8 as PackReport, a9 as PackService, aa as PackTag, ab as PaginatedList, ac as PaymentStatus, ad as PaymentTransaction, h as PracticeMetrics, ae as ProgressService, af as QuestionReport, ag as QuestionService, ah as QuestionTag, ai as QuestionTracking, aj as QuestionTrackingStatus, ak as QuestionVote, al as SendEnrollmentRequestInput, am as SignedURLResponse, an as SortDirection, ao as StatusIdResponse, ap as StatusResponse, S as Subject, aq as SubmitPackExamInput, ar as Tag, as as Tier, T as Topic, at as TrackPracticeProgressInput, au as UpdateUserAvatarInput, av as UploadImageResponse, aw as UploadVideoToBunnyInput, ax as User, f as UserChapterProgress, ay as UserService, U as UserSubjectProgress, az as UserTopicMetric, g as UserTopicProgress, aA as Verification, aB as VerificationType, aC as VoteInput, aD as VoteType, aE as aggregateChapterMetrics, aF as aggregateSubjectMetrics, aG as aggregateTopicMetrics, aH as calculateAccuracy, aI as createOrjokClient, aJ as isDifficultyMatch, aK as isLanguageMatch, aL as isValidMCQ } from './practice-QnWtC5A7.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";
@@ -25,16 +25,9 @@ type AvatarConfig = Record<string, AvatarConfigItem[]>;
 interface AvatarState {
     selections: Record<string, string>;
     colors: Record<string, string>;
+    gender?: string;
 }
 
-interface SelectOption<T = string> {
-    value: T;
-    label: string;
-}
-declare const levelOptions: SelectOption<Level>[];
-declare const languageOptions: SelectOption<Language>[];
-declare const difficultyOptions: SelectOption<Difficulty>[];
-
 declare const HAIR_COLORS: ColorOption[];
 declare const CLOTHES_COLORS: ColorOption[];
 declare const COLOR_HUES: Record<string, number>;
@@ -42,7 +35,16 @@ declare const RENDER_ORDER: readonly ["Background", "Hair Back", "Clothes Back",
 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;
@@ -86,6 +88,39 @@ declare function reorderObjectKeys<T>(obj: {
     [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;
     imageUrl?: string;
@@ -101,6 +136,7 @@ interface ParsedQuestion {
     subjectId?: string;
     chapterId?: string;
     topicId?: string;
+    publicExam?: string;
     type: "MCQ" | "WRITTEN";
     markingInstructions?: string;
     answerImageUrl?: string;
@@ -130,6 +166,175 @@ 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;
 
+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;
+}
+/**
+ * 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;
@@ -159,7 +364,7 @@ interface TimeLeft {
     seconds: number;
     isEnded: boolean;
 }
-declare function convertToBangladeshTime(isoString: string): string;
+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;
@@ -173,5 +378,16 @@ 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 { type AvatarConfig, type AvatarConfigItem, type AvatarState, CLOTHES_COLORS, COLOR_HUES, type ColorOption, Difficulty, type EloTier, type ExamConfig, type ExamMode, HAIR_COLORS, INITIAL_AVATAR_DATA, Language, Level, MediaUrlCache, type ParseResult, type ParsedQuestion, type PrimaryTab, QuestionObject, QuestionType, RENDER_ORDER, type RatingField, type RenderCategory, type SelectOption, StorageProvider, type TimeLeft, type UICategory, _resetMediaUrlWarning, buildImageAnswer, calculateDefaultExamMinutes, calculateExamTime, calculateTimeLeft, computeRatingDelta, convertToBangladeshTime, detectQuestionType, difficultyOptions, engToBanglaNumber, extractBilingualName, filterQuestionsByMode, formatBDT, formatCurriculumName, formatDate, formatExamTime, formatQuestionsToCsv, formatQuestionsToText, getActiveTab, getActualOptionFileName, getAllTiers, getCanonicalPath, getDhakaNow, getEloProgress, getEloTier, getRatingForSubject, getRelativeTime, getYouTubeId, isAuthGatedRoute, isCorrectAnswer, isDifficulty, isImageAnswer, isLanguage, isQuestionLevel, isStorageKey, languageOptions, levelOptions, normalizeDifficulty, parseAvatarConfig, parseCsvQuestions, parseImageKeys, parseTextQuestions, processLatexText, reorderObjectKeys, resolveMediaUrl, resolveMediaUrls, sanitizeFileName, scoreExam, serializeAvatarConfig, shuffle, shuffleInPlace };
+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 };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { D as Difficulty, L as Language, i as Level, j as QuestionType, Q as QuestionObject } from './practice-Dh2Tv80G.js';
-export { A as AIService, k as AIUsageLog, l as AddQuestionTagInput, C as Chapter, b as CheckParticipationResponse, a as Contest, m as ContestAnswersResponse, n as ContestOption, o as ContestParticipant, p as ContestQuestion, q as ContestQuestionsResponse, r as ContestService, c as Course, s as CourseEnrolled, t as CourseEnrollmentRequest, d as CourseItem, u as CourseItemType, e as CourseLiveExam, v as CourseLiveExamParticipant, w as CourseLiveExamQuestionsResponse, x as CourseService, y as CreateContestInput, z as CreateCourseInput, B as CreateCourseItemInput, E as CreateCourseLiveExamInput, F as CreateCourseResponse, G as CreateCourseVideoInput, H as CreateCourseVideoResponse, I as CreatePackInput, J as CreateQuestionInput, K as CreateQuestionResponse, M as CurriculumService, N as DeleteCourseItemInput, R as EnrollStudentInput, V as EvaluateWrittenAnswerInput, W as EvaluateWrittenAnswerResponse, X as GetSignedFileURLInput, Y as GetSignedURLInput, Z as LeaderboardResponse, _ as ListByCurriculumInput, $ as ListByRandomHashInput, a0 as MediaService, a1 as ModelType, a2 as NewsArticle, a3 as NewsService, a4 as Option, O as OrjokClient, a5 as OrjokClientConfig, P as Pack, a6 as PackExamResults, a7 as PackGroup, a8 as PackReport, a9 as PackService, aa as PackTag, ab as PaginatedList, ac as PaymentStatus, ad as PaymentTransaction, h as PracticeMetrics, ae as ProgressService, af as QuestionReport, ag as QuestionService, ah as QuestionTag, ai as QuestionTracking, aj as QuestionTrackingStatus, ak as QuestionVote, al as SendEnrollmentRequestInput, am as SignedURLResponse, an as SortDirection, ao as StatusIdResponse, ap as StatusResponse, S as Subject, aq as SubmitPackExamInput, ar as Tag, as as Tier, T as Topic, at as TrackPracticeProgressInput, au as UpdateUserAvatarInput, av as UploadImageResponse, aw as UploadVideoToBunnyInput, ax as User, f as UserChapterProgress, ay as UserService, U as UserSubjectProgress, az as UserTopicMetric, g as UserTopicProgress, aA as Verification, aB as VerificationType, aC as VoteInput, aD as VoteType, aE as aggregateChapterMetrics, aF as aggregateSubjectMetrics, aG as aggregateTopicMetrics, aH as calculateAccuracy, aI as createOrjokClient, aJ as isDifficultyMatch, aK as isLanguageMatch, aL as isValidMCQ } from './practice-Dh2Tv80G.js';
-import { S as StorageProvider } from './storage-DLqdJgQt.js';
-export { A as AuthProvider, a as AuthSession, G as GraphQLResult, N as NetworkProvider, b as UploadOptions, U as UserAttributes } from './storage-DLqdJgQt.js';
+import { k as QuestionType, Q as QuestionObject, D as Difficulty, L as Language, l as Level, m as PaginatedList } from './notification-BoqtkNrc.js';
+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-BoqtkNrc.js';
+import { S as StorageProvider } from './storage-9pK8KwIM.js';
+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.js';
 
 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";
@@ -25,16 +25,9 @@ type AvatarConfig = Record<string, AvatarConfigItem[]>;
 interface AvatarState {
     selections: Record<string, string>;
     colors: Record<string, string>;
+    gender?: string;
 }
 
-interface SelectOption<T = string> {
-    value: T;
-    label: string;
-}
-declare const levelOptions: SelectOption<Level>[];
-declare const languageOptions: SelectOption<Language>[];
-declare const difficultyOptions: SelectOption<Difficulty>[];
-
 declare const HAIR_COLORS: ColorOption[];
 declare const CLOTHES_COLORS: ColorOption[];
 declare const COLOR_HUES: Record<string, number>;
@@ -42,7 +35,16 @@ declare const RENDER_ORDER: readonly ["Background", "Hair Back", "Clothes Back",
 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;
@@ -86,6 +88,39 @@ declare function reorderObjectKeys<T>(obj: {
     [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;
     imageUrl?: string;
@@ -101,6 +136,7 @@ interface ParsedQuestion {
     subjectId?: string;
     chapterId?: string;
     topicId?: string;
+    publicExam?: string;
     type: "MCQ" | "WRITTEN";
     markingInstructions?: string;
     answerImageUrl?: string;
@@ -130,6 +166,175 @@ 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;
 
+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;
+}
+/**
+ * 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;
@@ -159,7 +364,7 @@ interface TimeLeft {
     seconds: number;
     isEnded: boolean;
 }
-declare function convertToBangladeshTime(isoString: string): string;
+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;
@@ -173,5 +378,16 @@ 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 { type AvatarConfig, type AvatarConfigItem, type AvatarState, CLOTHES_COLORS, COLOR_HUES, type ColorOption, Difficulty, type EloTier, type ExamConfig, type ExamMode, HAIR_COLORS, INITIAL_AVATAR_DATA, Language, Level, MediaUrlCache, type ParseResult, type ParsedQuestion, type PrimaryTab, QuestionObject, QuestionType, RENDER_ORDER, type RatingField, type RenderCategory, type SelectOption, StorageProvider, type TimeLeft, type UICategory, _resetMediaUrlWarning, buildImageAnswer, calculateDefaultExamMinutes, calculateExamTime, calculateTimeLeft, computeRatingDelta, convertToBangladeshTime, detectQuestionType, difficultyOptions, engToBanglaNumber, extractBilingualName, filterQuestionsByMode, formatBDT, formatCurriculumName, formatDate, formatExamTime, formatQuestionsToCsv, formatQuestionsToText, getActiveTab, getActualOptionFileName, getAllTiers, getCanonicalPath, getDhakaNow, getEloProgress, getEloTier, getRatingForSubject, getRelativeTime, getYouTubeId, isAuthGatedRoute, isCorrectAnswer, isDifficulty, isImageAnswer, isLanguage, isQuestionLevel, isStorageKey, languageOptions, levelOptions, normalizeDifficulty, parseAvatarConfig, parseCsvQuestions, parseImageKeys, parseTextQuestions, processLatexText, reorderObjectKeys, resolveMediaUrl, resolveMediaUrls, sanitizeFileName, scoreExam, serializeAvatarConfig, shuffle, shuffleInPlace };
+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 };