@contractspec/module.learning-journey 1.44.0

package/dist/entities/gamification.js

@@ -0,0 +1,392 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#region src/entities/gamification.ts
+/**
+* Achievement type enum.
+*/
+const AchievementTypeEnum = defineEntityEnum({
+	name: "AchievementType",
+	values: [
+		"MILESTONE",
+		"STREAK",
+		"SKILL",
+		"SOCIAL",
+		"SPECIAL",
+		"SEASONAL"
+	],
+	schema: "lssm_learning",
+	description: "Type of achievement."
+});
+/**
+* Leaderboard period enum.
+*/
+const LeaderboardPeriodEnum = defineEntityEnum({
+	name: "LeaderboardPeriod",
+	values: [
+		"DAILY",
+		"WEEKLY",
+		"MONTHLY",
+		"ALL_TIME"
+	],
+	schema: "lssm_learning",
+	description: "Leaderboard time period."
+});
+/**
+* Achievement entity - defines an achievement.
+*/
+const AchievementEntity = defineEntity({
+	name: "Achievement",
+	description: "An achievement that can be unlocked.",
+	schema: "lssm_learning",
+	map: "achievement",
+	fields: {
+		id: field.id({ description: "Unique achievement identifier" }),
+		key: field.string({
+			isUnique: true,
+			description: "Achievement key"
+		}),
+		name: field.string({ description: "Achievement name" }),
+		description: field.string({ description: "Achievement description" }),
+		icon: field.string({
+			isOptional: true,
+			description: "Icon name or URL"
+		}),
+		color: field.string({
+			isOptional: true,
+			description: "Display color"
+		}),
+		badgeUrl: field.string({
+			isOptional: true,
+			description: "Badge image URL"
+		}),
+		type: field.enum("AchievementType", {
+			default: "MILESTONE",
+			description: "Achievement type"
+		}),
+		category: field.string({
+			isOptional: true,
+			description: "Achievement category"
+		}),
+		rarity: field.string({
+			default: "\"common\"",
+			description: "Rarity: common, rare, epic, legendary"
+		}),
+		xpReward: field.int({
+			default: 50,
+			description: "XP awarded"
+		}),
+		condition: field.json({ description: "Unlock condition" }),
+		order: field.int({
+			default: 0,
+			description: "Display order"
+		}),
+		isHidden: field.boolean({
+			default: false,
+			description: "Hide until unlocked"
+		}),
+		isActive: field.boolean({
+			default: true,
+			description: "Whether achievement is active"
+		}),
+		orgId: field.string({
+			isOptional: true,
+			description: "Organization scope"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		learnerAchievements: field.hasMany("LearnerAchievement")
+	},
+	indexes: [
+		index.on(["type"]),
+		index.on(["category"]),
+		index.on(["isActive"]),
+		index.on(["orgId"])
+	],
+	enums: [AchievementTypeEnum]
+});
+/**
+* LearnerAchievement entity - unlocked achievements.
+*/
+const LearnerAchievementEntity = defineEntity({
+	name: "LearnerAchievement",
+	description: "An achievement unlocked by a learner.",
+	schema: "lssm_learning",
+	map: "learner_achievement",
+	fields: {
+		id: field.id({ description: "Unique record identifier" }),
+		learnerId: field.foreignKey({ description: "Learner" }),
+		achievementId: field.foreignKey({ description: "Achievement" }),
+		xpEarned: field.int({
+			default: 0,
+			description: "XP earned"
+		}),
+		progress: field.int({
+			default: 100,
+			description: "Progress percentage"
+		}),
+		currentValue: field.int({
+			isOptional: true,
+			description: "Current value towards goal"
+		}),
+		targetValue: field.int({
+			isOptional: true,
+			description: "Target value for completion"
+		}),
+		unlockedAt: field.dateTime({ description: "When unlocked" }),
+		createdAt: field.createdAt(),
+		learner: field.belongsTo("Learner", ["learnerId"], ["id"], { onDelete: "Cascade" }),
+		achievement: field.belongsTo("Achievement", ["achievementId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [
+		index.unique(["learnerId", "achievementId"], { name: "learner_achievement_unique" }),
+		index.on(["learnerId", "unlockedAt"]),
+		index.on(["achievementId"])
+	]
+});
+/**
+* Streak entity - tracks daily learning streaks.
+*/
+const StreakEntity = defineEntity({
+	name: "Streak",
+	description: "Tracks daily learning streaks.",
+	schema: "lssm_learning",
+	map: "streak",
+	fields: {
+		id: field.id({ description: "Unique streak identifier" }),
+		learnerId: field.foreignKey({ description: "Learner" }),
+		currentStreak: field.int({
+			default: 0,
+			description: "Current streak days"
+		}),
+		longestStreak: field.int({
+			default: 0,
+			description: "Longest streak ever"
+		}),
+		lastActivityAt: field.dateTime({
+			isOptional: true,
+			description: "Last learning activity"
+		}),
+		lastActivityDate: field.string({
+			isOptional: true,
+			description: "Last activity date (YYYY-MM-DD)"
+		}),
+		freezesRemaining: field.int({
+			default: 0,
+			description: "Streak freezes available"
+		}),
+		freezeUsedAt: field.dateTime({
+			isOptional: true,
+			description: "When last freeze was used"
+		}),
+		streakHistory: field.json({
+			isOptional: true,
+			description: "Historical streak data"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		learner: field.belongsTo("Learner", ["learnerId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [
+		index.unique(["learnerId"], { name: "streak_learner_unique" }),
+		index.on(["currentStreak"]),
+		index.on(["longestStreak"])
+	]
+});
+/**
+* DailyGoal entity - tracks daily XP goals.
+*/
+const DailyGoalEntity = defineEntity({
+	name: "DailyGoal",
+	description: "Daily XP goal tracking.",
+	schema: "lssm_learning",
+	map: "daily_goal",
+	fields: {
+		id: field.id({ description: "Unique goal identifier" }),
+		learnerId: field.foreignKey({ description: "Learner" }),
+		date: field.string({ description: "Date (YYYY-MM-DD)" }),
+		targetXp: field.int({ description: "Target XP for the day" }),
+		currentXp: field.int({
+			default: 0,
+			description: "XP earned today"
+		}),
+		isCompleted: field.boolean({
+			default: false,
+			description: "Whether goal was met"
+		}),
+		completedAt: field.dateTime({
+			isOptional: true,
+			description: "When goal was completed"
+		}),
+		xpBreakdown: field.json({
+			isOptional: true,
+			description: "XP sources breakdown"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		learner: field.belongsTo("Learner", ["learnerId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [index.unique(["learnerId", "date"], { name: "daily_goal_unique" }), index.on(["date", "isCompleted"])]
+});
+/**
+* LeaderboardEntry entity - leaderboard rankings.
+*/
+const LeaderboardEntryEntity = defineEntity({
+	name: "LeaderboardEntry",
+	description: "Leaderboard entry for a learner.",
+	schema: "lssm_learning",
+	map: "leaderboard_entry",
+	fields: {
+		id: field.id({ description: "Unique entry identifier" }),
+		learnerId: field.foreignKey({ description: "Learner" }),
+		periodType: field.enum("LeaderboardPeriod", { description: "Period type" }),
+		periodKey: field.string({ description: "Period key (e.g., 2024-W01)" }),
+		xp: field.int({
+			default: 0,
+			description: "XP earned in period"
+		}),
+		rank: field.int({
+			isOptional: true,
+			description: "Rank in leaderboard"
+		}),
+		lessonsCompleted: field.int({
+			default: 0,
+			description: "Lessons completed"
+		}),
+		quizzesPassed: field.int({
+			default: 0,
+			description: "Quizzes passed"
+		}),
+		cardsReviewed: field.int({
+			default: 0,
+			description: "Cards reviewed"
+		}),
+		streakDays: field.int({
+			default: 0,
+			description: "Streak days in period"
+		}),
+		league: field.string({
+			isOptional: true,
+			description: "League tier"
+		}),
+		orgId: field.string({
+			isOptional: true,
+			description: "Organization scope"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		learner: field.belongsTo("Learner", ["learnerId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [
+		index.unique([
+			"learnerId",
+			"periodType",
+			"periodKey"
+		], { name: "leaderboard_entry_unique" }),
+		index.on([
+			"periodType",
+			"periodKey",
+			"xp"
+		]),
+		index.on([
+			"orgId",
+			"periodType",
+			"periodKey",
+			"xp"
+		])
+	],
+	enums: [LeaderboardPeriodEnum]
+});
+/**
+* Heart entity - lives system (optional).
+*/
+const HeartEntity = defineEntity({
+	name: "Heart",
+	description: "Lives/hearts system for quiz attempts.",
+	schema: "lssm_learning",
+	map: "heart",
+	fields: {
+		id: field.id({ description: "Unique heart record identifier" }),
+		learnerId: field.foreignKey({ description: "Learner" }),
+		current: field.int({
+			default: 5,
+			description: "Current hearts"
+		}),
+		max: field.int({
+			default: 5,
+			description: "Maximum hearts"
+		}),
+		lastRefillAt: field.dateTime({
+			isOptional: true,
+			description: "Last refill time"
+		}),
+		nextRefillAt: field.dateTime({
+			isOptional: true,
+			description: "Next refill time"
+		}),
+		refillIntervalMinutes: field.int({
+			default: 240,
+			description: "Minutes between refills"
+		}),
+		infiniteUntil: field.dateTime({
+			isOptional: true,
+			description: "Infinite hearts until"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		learner: field.belongsTo("Learner", ["learnerId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [index.unique(["learnerId"], { name: "heart_learner_unique" }), index.on(["nextRefillAt"])]
+});
+/**
+* XPTransaction entity - XP earning history.
+*/
+const XPTransactionEntity = defineEntity({
+	name: "XPTransaction",
+	description: "Record of XP earned or spent.",
+	schema: "lssm_learning",
+	map: "xp_transaction",
+	fields: {
+		id: field.id({ description: "Unique transaction identifier" }),
+		learnerId: field.foreignKey({ description: "Learner" }),
+		amount: field.int({ description: "XP amount (positive = earned, negative = spent)" }),
+		type: field.string({ description: "Transaction type (lesson, quiz, streak, achievement, etc.)" }),
+		sourceType: field.string({
+			isOptional: true,
+			description: "Source entity type"
+		}),
+		sourceId: field.string({
+			isOptional: true,
+			description: "Source entity ID"
+		}),
+		description: field.string({
+			isOptional: true,
+			description: "Human-readable description"
+		}),
+		balanceAfter: field.int({ description: "Total XP after transaction" }),
+		createdAt: field.createdAt(),
+		learner: field.belongsTo("Learner", ["learnerId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [
+		index.on(["learnerId", "createdAt"]),
+		index.on(["type"]),
+		index.on(["sourceType", "sourceId"])
+	]
+});
+const gamificationEntities = [
+	AchievementEntity,
+	LearnerAchievementEntity,
+	StreakEntity,
+	DailyGoalEntity,
+	LeaderboardEntryEntity,
+	HeartEntity,
+	XPTransactionEntity
+];
+const gamificationEnums = [AchievementTypeEnum, LeaderboardPeriodEnum];
+
+//#endregion
+export { AchievementEntity, AchievementTypeEnum, DailyGoalEntity, HeartEntity, LeaderboardEntryEntity, LeaderboardPeriodEnum, LearnerAchievementEntity, StreakEntity, XPTransactionEntity, gamificationEntities, gamificationEnums };
+//# sourceMappingURL=gamification.js.map

package/dist/entities/gamification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gamification.js","names":[],"sources":["../../src/entities/gamification.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\n\n/**\n * Achievement type enum.\n */\nexport const AchievementTypeEnum = defineEntityEnum({\n  name: 'AchievementType',\n  values: [\n    'MILESTONE',\n    'STREAK',\n    'SKILL',\n    'SOCIAL',\n    'SPECIAL',\n    'SEASONAL',\n  ] as const,\n  schema: 'lssm_learning',\n  description: 'Type of achievement.',\n});\n\n/**\n * Leaderboard period enum.\n */\nexport const LeaderboardPeriodEnum = defineEntityEnum({\n  name: 'LeaderboardPeriod',\n  values: ['DAILY', 'WEEKLY', 'MONTHLY', 'ALL_TIME'] as const,\n  schema: 'lssm_learning',\n  description: 'Leaderboard time period.',\n});\n\n/**\n * Achievement entity - defines an achievement.\n */\nexport const AchievementEntity = defineEntity({\n  name: 'Achievement',\n  description: 'An achievement that can be unlocked.',\n  schema: 'lssm_learning',\n  map: 'achievement',\n  fields: {\n    id: field.id({ description: 'Unique achievement identifier' }),\n\n    // Basic info\n    key: field.string({ isUnique: true, description: 'Achievement key' }),\n    name: field.string({ description: 'Achievement name' }),\n    description: field.string({ description: 'Achievement description' }),\n\n    // Display\n    icon: field.string({ isOptional: true, description: 'Icon name or URL' }),\n    color: field.string({ isOptional: true, description: 'Display color' }),\n    badgeUrl: field.string({\n      isOptional: true,\n      description: 'Badge image URL',\n    }),\n\n    // Classification\n    type: field.enum('AchievementType', {\n      default: 'MILESTONE',\n      description: 'Achievement type',\n    }),\n    category: field.string({\n      isOptional: true,\n      description: 'Achievement category',\n    }),\n    rarity: field.string({\n      default: '\"common\"',\n      description: 'Rarity: common, rare, epic, legendary',\n    }),\n\n    // Rewards\n    xpReward: field.int({ default: 50, description: 'XP awarded' }),\n\n    // Conditions (JSON DSL for checking)\n    condition: field.json({ description: 'Unlock condition' }),\n\n    // Ordering\n    order: field.int({ default: 0, description: 'Display order' }),\n\n    // Status\n    isHidden: field.boolean({\n      default: false,\n      description: 'Hide until unlocked',\n    }),\n    isActive: field.boolean({\n      default: true,\n      description: 'Whether achievement is active',\n    }),\n\n    // Organization scope\n    orgId: field.string({\n      isOptional: true,\n      description: 'Organization scope',\n    }),\n\n    // Metadata\n    metadata: field.json({\n      isOptional: true,\n      description: 'Additional metadata',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    learnerAchievements: field.hasMany('LearnerAchievement'),\n  },\n  indexes: [\n    index.on(['type']),\n    index.on(['category']),\n    index.on(['isActive']),\n    index.on(['orgId']),\n  ],\n  enums: [AchievementTypeEnum],\n});\n\n/**\n * LearnerAchievement entity - unlocked achievements.\n */\nexport const LearnerAchievementEntity = defineEntity({\n  name: 'LearnerAchievement',\n  description: 'An achievement unlocked by a learner.',\n  schema: 'lssm_learning',\n  map: 'learner_achievement',\n  fields: {\n    id: field.id({ description: 'Unique record identifier' }),\n    learnerId: field.foreignKey({ description: 'Learner' }),\n    achievementId: field.foreignKey({ description: 'Achievement' }),\n\n    // XP\n    xpEarned: field.int({ default: 0, description: 'XP earned' }),\n\n    // Progress (for multi-stage achievements)\n    progress: field.int({ default: 100, description: 'Progress percentage' }),\n    currentValue: field.int({\n      isOptional: true,\n      description: 'Current value towards goal',\n    }),\n    targetValue: field.int({\n      isOptional: true,\n      description: 'Target value for completion',\n    }),\n\n    // Timestamps\n    unlockedAt: field.dateTime({ description: 'When unlocked' }),\n    createdAt: field.createdAt(),\n\n    // Relations\n    learner: field.belongsTo('Learner', ['learnerId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n    achievement: field.belongsTo('Achievement', ['achievementId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n  },\n  indexes: [\n    index.unique(['learnerId', 'achievementId'], {\n      name: 'learner_achievement_unique',\n    }),\n    index.on(['learnerId', 'unlockedAt']),\n    index.on(['achievementId']),\n  ],\n});\n\n/**\n * Streak entity - tracks daily learning streaks.\n */\nexport const StreakEntity = defineEntity({\n  name: 'Streak',\n  description: 'Tracks daily learning streaks.',\n  schema: 'lssm_learning',\n  map: 'streak',\n  fields: {\n    id: field.id({ description: 'Unique streak identifier' }),\n    learnerId: field.foreignKey({ description: 'Learner' }),\n\n    // Streak data\n    currentStreak: field.int({\n      default: 0,\n      description: 'Current streak days',\n    }),\n    longestStreak: field.int({\n      default: 0,\n      description: 'Longest streak ever',\n    }),\n\n    // Activity tracking\n    lastActivityAt: field.dateTime({\n      isOptional: true,\n      description: 'Last learning activity',\n    }),\n    lastActivityDate: field.string({\n      isOptional: true,\n      description: 'Last activity date (YYYY-MM-DD)',\n    }),\n\n    // Streak protection\n    freezesRemaining: field.int({\n      default: 0,\n      description: 'Streak freezes available',\n    }),\n    freezeUsedAt: field.dateTime({\n      isOptional: true,\n      description: 'When last freeze was used',\n    }),\n\n    // History\n    streakHistory: field.json({\n      isOptional: true,\n      description: 'Historical streak data',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    learner: field.belongsTo('Learner', ['learnerId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n  },\n  indexes: [\n    index.unique(['learnerId'], { name: 'streak_learner_unique' }),\n    index.on(['currentStreak']),\n    index.on(['longestStreak']),\n  ],\n});\n\n/**\n * DailyGoal entity - tracks daily XP goals.\n */\nexport const DailyGoalEntity = defineEntity({\n  name: 'DailyGoal',\n  description: 'Daily XP goal tracking.',\n  schema: 'lssm_learning',\n  map: 'daily_goal',\n  fields: {\n    id: field.id({ description: 'Unique goal identifier' }),\n    learnerId: field.foreignKey({ description: 'Learner' }),\n\n    // Date\n    date: field.string({ description: 'Date (YYYY-MM-DD)' }),\n\n    // Goal\n    targetXp: field.int({ description: 'Target XP for the day' }),\n    currentXp: field.int({ default: 0, description: 'XP earned today' }),\n\n    // Status\n    isCompleted: field.boolean({\n      default: false,\n      description: 'Whether goal was met',\n    }),\n    completedAt: field.dateTime({\n      isOptional: true,\n      description: 'When goal was completed',\n    }),\n\n    // Breakdown\n    xpBreakdown: field.json({\n      isOptional: true,\n      description: 'XP sources breakdown',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    learner: field.belongsTo('Learner', ['learnerId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n  },\n  indexes: [\n    index.unique(['learnerId', 'date'], { name: 'daily_goal_unique' }),\n    index.on(['date', 'isCompleted']),\n  ],\n});\n\n/**\n * LeaderboardEntry entity - leaderboard rankings.\n */\nexport const LeaderboardEntryEntity = defineEntity({\n  name: 'LeaderboardEntry',\n  description: 'Leaderboard entry for a learner.',\n  schema: 'lssm_learning',\n  map: 'leaderboard_entry',\n  fields: {\n    id: field.id({ description: 'Unique entry identifier' }),\n    learnerId: field.foreignKey({ description: 'Learner' }),\n\n    // Period\n    periodType: field.enum('LeaderboardPeriod', { description: 'Period type' }),\n    periodKey: field.string({ description: 'Period key (e.g., 2024-W01)' }),\n\n    // Stats\n    xp: field.int({ default: 0, description: 'XP earned in period' }),\n    rank: field.int({ isOptional: true, description: 'Rank in leaderboard' }),\n\n    // Breakdown\n    lessonsCompleted: field.int({\n      default: 0,\n      description: 'Lessons completed',\n    }),\n    quizzesPassed: field.int({ default: 0, description: 'Quizzes passed' }),\n    cardsReviewed: field.int({ default: 0, description: 'Cards reviewed' }),\n    streakDays: field.int({ default: 0, description: 'Streak days in period' }),\n\n    // League (optional grouping)\n    league: field.string({ isOptional: true, description: 'League tier' }),\n\n    // Organization scope\n    orgId: field.string({\n      isOptional: true,\n      description: 'Organization scope',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    learner: field.belongsTo('Learner', ['learnerId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n  },\n  indexes: [\n    index.unique(['learnerId', 'periodType', 'periodKey'], {\n      name: 'leaderboard_entry_unique',\n    }),\n    index.on(['periodType', 'periodKey', 'xp']),\n    index.on(['orgId', 'periodType', 'periodKey', 'xp']),\n  ],\n  enums: [LeaderboardPeriodEnum],\n});\n\n/**\n * Heart entity - lives system (optional).\n */\nexport const HeartEntity = defineEntity({\n  name: 'Heart',\n  description: 'Lives/hearts system for quiz attempts.',\n  schema: 'lssm_learning',\n  map: 'heart',\n  fields: {\n    id: field.id({ description: 'Unique heart record identifier' }),\n    learnerId: field.foreignKey({ description: 'Learner' }),\n\n    // Hearts\n    current: field.int({ default: 5, description: 'Current hearts' }),\n    max: field.int({ default: 5, description: 'Maximum hearts' }),\n\n    // Refill\n    lastRefillAt: field.dateTime({\n      isOptional: true,\n      description: 'Last refill time',\n    }),\n    nextRefillAt: field.dateTime({\n      isOptional: true,\n      description: 'Next refill time',\n    }),\n\n    // Settings\n    refillIntervalMinutes: field.int({\n      default: 240,\n      description: 'Minutes between refills',\n    }),\n    infiniteUntil: field.dateTime({\n      isOptional: true,\n      description: 'Infinite hearts until',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    learner: field.belongsTo('Learner', ['learnerId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n  },\n  indexes: [\n    index.unique(['learnerId'], { name: 'heart_learner_unique' }),\n    index.on(['nextRefillAt']),\n  ],\n});\n\n/**\n * XPTransaction entity - XP earning history.\n */\nexport const XPTransactionEntity = defineEntity({\n  name: 'XPTransaction',\n  description: 'Record of XP earned or spent.',\n  schema: 'lssm_learning',\n  map: 'xp_transaction',\n  fields: {\n    id: field.id({ description: 'Unique transaction identifier' }),\n    learnerId: field.foreignKey({ description: 'Learner' }),\n\n    // Transaction\n    amount: field.int({\n      description: 'XP amount (positive = earned, negative = spent)',\n    }),\n    type: field.string({\n      description: 'Transaction type (lesson, quiz, streak, achievement, etc.)',\n    }),\n\n    // Source\n    sourceType: field.string({\n      isOptional: true,\n      description: 'Source entity type',\n    }),\n    sourceId: field.string({\n      isOptional: true,\n      description: 'Source entity ID',\n    }),\n\n    // Description\n    description: field.string({\n      isOptional: true,\n      description: 'Human-readable description',\n    }),\n\n    // Balance\n    balanceAfter: field.int({ description: 'Total XP after transaction' }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n\n    // Relations\n    learner: field.belongsTo('Learner', ['learnerId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n  },\n  indexes: [\n    index.on(['learnerId', 'createdAt']),\n    index.on(['type']),\n    index.on(['sourceType', 'sourceId']),\n  ],\n});\n\nexport const gamificationEntities = [\n  AchievementEntity,\n  LearnerAchievementEntity,\n  StreakEntity,\n  DailyGoalEntity,\n  LeaderboardEntryEntity,\n  HeartEntity,\n  XPTransactionEntity,\n];\n\nexport const gamificationEnums = [AchievementTypeEnum, LeaderboardPeriodEnum];\n"],"mappings":"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"}