@contractspec/module.learning-journey 1.44.0

package/dist/entities/flashcard.js

@@ -0,0 +1,249 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#region src/entities/flashcard.ts
+/**
+* Card rating enum for SRS.
+*/
+const CardRatingEnum = defineEntityEnum({
+	name: "CardRating",
+	values: [
+		"AGAIN",
+		"HARD",
+		"GOOD",
+		"EASY"
+	],
+	schema: "lssm_learning",
+	description: "Rating for a flashcard review."
+});
+/**
+* Deck entity - collection of flashcards.
+*/
+const DeckEntity = defineEntity({
+	name: "Deck",
+	description: "A collection of flashcards.",
+	schema: "lssm_learning",
+	map: "deck",
+	fields: {
+		id: field.id({ description: "Unique deck identifier" }),
+		ownerId: field.foreignKey({ description: "Deck owner (learner)" }),
+		title: field.string({ description: "Deck title" }),
+		description: field.string({
+			isOptional: true,
+			description: "Deck description"
+		}),
+		category: field.string({
+			isOptional: true,
+			description: "Deck category"
+		}),
+		tags: field.json({
+			isOptional: true,
+			description: "Tags for discovery"
+		}),
+		isPublic: field.boolean({
+			default: false,
+			description: "Whether deck is publicly visible"
+		}),
+		cardCount: field.int({
+			default: 0,
+			description: "Number of cards"
+		}),
+		coverImageUrl: field.string({
+			isOptional: true,
+			description: "Cover image URL"
+		}),
+		orgId: field.string({
+			isOptional: true,
+			description: "Organization scope"
+		}),
+		newCardsPerDay: field.int({
+			default: 20,
+			description: "New cards to introduce per day"
+		}),
+		reviewsPerDay: field.int({
+			default: 100,
+			description: "Maximum reviews per day"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		owner: field.belongsTo("Learner", ["ownerId"], ["id"], { onDelete: "Cascade" }),
+		cards: field.hasMany("Card")
+	},
+	indexes: [
+		index.on(["ownerId"]),
+		index.on(["isPublic", "category"]),
+		index.on(["orgId"])
+	]
+});
+/**
+* Card entity - individual flashcard.
+*/
+const CardEntity = defineEntity({
+	name: "Card",
+	description: "An individual flashcard.",
+	schema: "lssm_learning",
+	map: "card",
+	fields: {
+		id: field.id({ description: "Unique card identifier" }),
+		deckId: field.foreignKey({ description: "Parent deck" }),
+		front: field.string({ description: "Front of card (question)" }),
+		back: field.string({ description: "Back of card (answer)" }),
+		hints: field.json({
+			isOptional: true,
+			description: "Hints for the card"
+		}),
+		explanation: field.string({
+			isOptional: true,
+			description: "Detailed explanation"
+		}),
+		frontMediaUrl: field.string({
+			isOptional: true,
+			description: "Media for front"
+		}),
+		backMediaUrl: field.string({
+			isOptional: true,
+			description: "Media for back"
+		}),
+		audioUrl: field.string({
+			isOptional: true,
+			description: "Audio pronunciation"
+		}),
+		tags: field.json({
+			isOptional: true,
+			description: "Card tags"
+		}),
+		difficulty: field.int({
+			default: 0,
+			description: "Card difficulty (0-5)"
+		}),
+		order: field.int({
+			default: 0,
+			description: "Card order in deck"
+		}),
+		isSuspended: field.boolean({
+			default: false,
+			description: "Whether card is suspended"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		deck: field.belongsTo("Deck", ["deckId"], ["id"], { onDelete: "Cascade" }),
+		reviews: field.hasMany("CardReview"),
+		schedules: field.hasMany("CardSchedule")
+	},
+	indexes: [index.on(["deckId", "order"]), index.on(["isSuspended"])]
+});
+/**
+* CardReview entity - records individual reviews.
+*/
+const CardReviewEntity = defineEntity({
+	name: "CardReview",
+	description: "A single review of a flashcard.",
+	schema: "lssm_learning",
+	map: "card_review",
+	fields: {
+		id: field.id({ description: "Unique review identifier" }),
+		learnerId: field.foreignKey({ description: "Reviewer" }),
+		cardId: field.foreignKey({ description: "Reviewed card" }),
+		rating: field.enum("CardRating", { description: "Review rating" }),
+		responseTimeMs: field.int({
+			isOptional: true,
+			description: "Time to respond in ms"
+		}),
+		intervalBefore: field.int({ description: "Interval before review (days)" }),
+		easeFactorBefore: field.decimal({ description: "Ease factor before review" }),
+		intervalAfter: field.int({ description: "Interval after review (days)" }),
+		easeFactorAfter: field.decimal({ description: "Ease factor after review" }),
+		reviewType: field.string({
+			default: "\"review\"",
+			description: "Type: new, learning, review, relearning"
+		}),
+		reviewedAt: field.dateTime({ description: "When reviewed" }),
+		createdAt: field.createdAt(),
+		learner: field.belongsTo("Learner", ["learnerId"], ["id"], { onDelete: "Cascade" }),
+		card: field.belongsTo("Card", ["cardId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [
+		index.on(["learnerId", "reviewedAt"]),
+		index.on(["cardId", "reviewedAt"]),
+		index.on(["rating"])
+	],
+	enums: [CardRatingEnum]
+});
+/**
+* CardSchedule entity - SRS scheduling per learner/card.
+*/
+const CardScheduleEntity = defineEntity({
+	name: "CardSchedule",
+	description: "SRS schedule for a learner/card pair.",
+	schema: "lssm_learning",
+	map: "card_schedule",
+	fields: {
+		id: field.id({ description: "Unique schedule identifier" }),
+		learnerId: field.foreignKey({ description: "Learner" }),
+		cardId: field.foreignKey({ description: "Card" }),
+		interval: field.int({
+			default: 0,
+			description: "Current interval in days"
+		}),
+		easeFactor: field.decimal({
+			default: 2.5,
+			description: "Ease factor (SM-2)"
+		}),
+		repetitions: field.int({
+			default: 0,
+			description: "Number of successful repetitions"
+		}),
+		nextReviewAt: field.dateTime({ description: "When next review is due" }),
+		lastReviewAt: field.dateTime({
+			isOptional: true,
+			description: "When last reviewed"
+		}),
+		learningStep: field.int({
+			default: 0,
+			description: "Current learning step"
+		}),
+		isGraduated: field.boolean({
+			default: false,
+			description: "Whether card has graduated"
+		}),
+		isRelearning: field.boolean({
+			default: false,
+			description: "Whether card is being relearned"
+		}),
+		lapses: field.int({
+			default: 0,
+			description: "Number of times card was forgotten"
+		}),
+		reviewCount: field.int({
+			default: 0,
+			description: "Total review count"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		learner: field.belongsTo("Learner", ["learnerId"], ["id"], { onDelete: "Cascade" }),
+		card: field.belongsTo("Card", ["cardId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [
+		index.unique(["learnerId", "cardId"], { name: "card_schedule_unique" }),
+		index.on(["learnerId", "nextReviewAt"]),
+		index.on(["nextReviewAt"])
+	]
+});
+const flashcardEntities = [
+	DeckEntity,
+	CardEntity,
+	CardReviewEntity,
+	CardScheduleEntity
+];
+const flashcardEnums = [CardRatingEnum];
+
+//#endregion
+export { CardEntity, CardRatingEnum, CardReviewEntity, CardScheduleEntity, DeckEntity, flashcardEntities, flashcardEnums };
+//# sourceMappingURL=flashcard.js.map

package/dist/entities/flashcard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flashcard.js","names":[],"sources":["../../src/entities/flashcard.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\n\n/**\n * Card rating enum for SRS.\n */\nexport const CardRatingEnum = defineEntityEnum({\n  name: 'CardRating',\n  values: ['AGAIN', 'HARD', 'GOOD', 'EASY'] as const,\n  schema: 'lssm_learning',\n  description: 'Rating for a flashcard review.',\n});\n\n/**\n * Deck entity - collection of flashcards.\n */\nexport const DeckEntity = defineEntity({\n  name: 'Deck',\n  description: 'A collection of flashcards.',\n  schema: 'lssm_learning',\n  map: 'deck',\n  fields: {\n    id: field.id({ description: 'Unique deck identifier' }),\n    ownerId: field.foreignKey({ description: 'Deck owner (learner)' }),\n\n    // Basic info\n    title: field.string({ description: 'Deck title' }),\n    description: field.string({\n      isOptional: true,\n      description: 'Deck description',\n    }),\n\n    // Classification\n    category: field.string({ isOptional: true, description: 'Deck category' }),\n    tags: field.json({ isOptional: true, description: 'Tags for discovery' }),\n\n    // Visibility\n    isPublic: field.boolean({\n      default: false,\n      description: 'Whether deck is publicly visible',\n    }),\n\n    // Stats\n    cardCount: field.int({ default: 0, description: 'Number of cards' }),\n\n    // Media\n    coverImageUrl: field.string({\n      isOptional: true,\n      description: 'Cover image URL',\n    }),\n\n    // Organization scope\n    orgId: field.string({\n      isOptional: true,\n      description: 'Organization scope',\n    }),\n\n    // Settings\n    newCardsPerDay: field.int({\n      default: 20,\n      description: 'New cards to introduce per day',\n    }),\n    reviewsPerDay: field.int({\n      default: 100,\n      description: 'Maximum reviews per day',\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    owner: field.belongsTo('Learner', ['ownerId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n    cards: field.hasMany('Card'),\n  },\n  indexes: [\n    index.on(['ownerId']),\n    index.on(['isPublic', 'category']),\n    index.on(['orgId']),\n  ],\n});\n\n/**\n * Card entity - individual flashcard.\n */\nexport const CardEntity = defineEntity({\n  name: 'Card',\n  description: 'An individual flashcard.',\n  schema: 'lssm_learning',\n  map: 'card',\n  fields: {\n    id: field.id({ description: 'Unique card identifier' }),\n    deckId: field.foreignKey({ description: 'Parent deck' }),\n\n    // Content\n    front: field.string({ description: 'Front of card (question)' }),\n    back: field.string({ description: 'Back of card (answer)' }),\n\n    // Additional content\n    hints: field.json({ isOptional: true, description: 'Hints for the card' }),\n    explanation: field.string({\n      isOptional: true,\n      description: 'Detailed explanation',\n    }),\n\n    // Media\n    frontMediaUrl: field.string({\n      isOptional: true,\n      description: 'Media for front',\n    }),\n    backMediaUrl: field.string({\n      isOptional: true,\n      description: 'Media for back',\n    }),\n    audioUrl: field.string({\n      isOptional: true,\n      description: 'Audio pronunciation',\n    }),\n\n    // Classification\n    tags: field.json({ isOptional: true, description: 'Card tags' }),\n    difficulty: field.int({ default: 0, description: 'Card difficulty (0-5)' }),\n\n    // Ordering\n    order: field.int({ default: 0, description: 'Card order in deck' }),\n\n    // Status\n    isSuspended: field.boolean({\n      default: false,\n      description: 'Whether card is suspended',\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    deck: field.belongsTo('Deck', ['deckId'], ['id'], { onDelete: 'Cascade' }),\n    reviews: field.hasMany('CardReview'),\n    schedules: field.hasMany('CardSchedule'),\n  },\n  indexes: [index.on(['deckId', 'order']), index.on(['isSuspended'])],\n});\n\n/**\n * CardReview entity - records individual reviews.\n */\nexport const CardReviewEntity = defineEntity({\n  name: 'CardReview',\n  description: 'A single review of a flashcard.',\n  schema: 'lssm_learning',\n  map: 'card_review',\n  fields: {\n    id: field.id({ description: 'Unique review identifier' }),\n    learnerId: field.foreignKey({ description: 'Reviewer' }),\n    cardId: field.foreignKey({ description: 'Reviewed card' }),\n\n    // Review result\n    rating: field.enum('CardRating', { description: 'Review rating' }),\n\n    // Time tracking\n    responseTimeMs: field.int({\n      isOptional: true,\n      description: 'Time to respond in ms',\n    }),\n\n    // SRS state before review\n    intervalBefore: field.int({ description: 'Interval before review (days)' }),\n    easeFactorBefore: field.decimal({\n      description: 'Ease factor before review',\n    }),\n\n    // SRS state after review\n    intervalAfter: field.int({ description: 'Interval after review (days)' }),\n    easeFactorAfter: field.decimal({ description: 'Ease factor after review' }),\n\n    // Review type\n    reviewType: field.string({\n      default: '\"review\"',\n      description: 'Type: new, learning, review, relearning',\n    }),\n\n    // Timestamps\n    reviewedAt: field.dateTime({ description: 'When reviewed' }),\n    createdAt: field.createdAt(),\n\n    // Relations\n    learner: field.belongsTo('Learner', ['learnerId'], ['id'], {\n      onDelete: 'Cascade',\n    }),\n    card: field.belongsTo('Card', ['cardId'], ['id'], { onDelete: 'Cascade' }),\n  },\n  indexes: [\n    index.on(['learnerId', 'reviewedAt']),\n    index.on(['cardId', 'reviewedAt']),\n    index.on(['rating']),\n  ],\n  enums: [CardRatingEnum],\n});\n\n/**\n * CardSchedule entity - SRS scheduling per learner/card.\n */\nexport const CardScheduleEntity = defineEntity({\n  name: 'CardSchedule',\n  description: 'SRS schedule for a learner/card pair.',\n  schema: 'lssm_learning',\n  map: 'card_schedule',\n  fields: {\n    id: field.id({ description: 'Unique schedule identifier' }),\n    learnerId: field.foreignKey({ description: 'Learner' }),\n    cardId: field.foreignKey({ description: 'Card' }),\n\n    // SRS state\n    interval: field.int({\n      default: 0,\n      description: 'Current interval in days',\n    }),\n    easeFactor: field.decimal({\n      default: 2.5,\n      description: 'Ease factor (SM-2)',\n    }),\n    repetitions: field.int({\n      default: 0,\n      description: 'Number of successful repetitions',\n    }),\n\n    // Scheduling\n    nextReviewAt: field.dateTime({ description: 'When next review is due' }),\n    lastReviewAt: field.dateTime({\n      isOptional: true,\n      description: 'When last reviewed',\n    }),\n\n    // Learning state\n    learningStep: field.int({\n      default: 0,\n      description: 'Current learning step',\n    }),\n    isGraduated: field.boolean({\n      default: false,\n      description: 'Whether card has graduated',\n    }),\n    isRelearning: field.boolean({\n      default: false,\n      description: 'Whether card is being relearned',\n    }),\n\n    // Stats\n    lapses: field.int({\n      default: 0,\n      description: 'Number of times card was forgotten',\n    }),\n    reviewCount: field.int({ default: 0, description: 'Total review count' }),\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    card: field.belongsTo('Card', ['cardId'], ['id'], { onDelete: 'Cascade' }),\n  },\n  indexes: [\n    index.unique(['learnerId', 'cardId'], { name: 'card_schedule_unique' }),\n    index.on(['learnerId', 'nextReviewAt']),\n    index.on(['nextReviewAt']),\n  ],\n});\n\nexport const flashcardEntities = [\n  DeckEntity,\n  CardEntity,\n  CardReviewEntity,\n  CardScheduleEntity,\n];\n\nexport const flashcardEnums = [CardRatingEnum];\n"],"mappings":"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"}

package/dist/entities/gamification.d.ts

@@ -0,0 +1,238 @@
+import * as _contractspec_lib_schema1239 from "@contractspec/lib.schema";
+
+//#region src/entities/gamification.d.ts
+/**
+ * Achievement type enum.
+ */
+declare const AchievementTypeEnum: _contractspec_lib_schema1239.EntityEnumDef;
+/**
+ * Leaderboard period enum.
+ */
+declare const LeaderboardPeriodEnum: _contractspec_lib_schema1239.EntityEnumDef;
+/**
+ * Achievement entity - defines an achievement.
+ */
+declare const AchievementEntity: _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  key: _contractspec_lib_schema1239.EntityScalarField;
+  name: _contractspec_lib_schema1239.EntityScalarField;
+  description: _contractspec_lib_schema1239.EntityScalarField;
+  icon: _contractspec_lib_schema1239.EntityScalarField;
+  color: _contractspec_lib_schema1239.EntityScalarField;
+  badgeUrl: _contractspec_lib_schema1239.EntityScalarField;
+  type: _contractspec_lib_schema1239.EntityEnumField;
+  category: _contractspec_lib_schema1239.EntityScalarField;
+  rarity: _contractspec_lib_schema1239.EntityScalarField;
+  xpReward: _contractspec_lib_schema1239.EntityScalarField;
+  condition: _contractspec_lib_schema1239.EntityScalarField;
+  order: _contractspec_lib_schema1239.EntityScalarField;
+  isHidden: _contractspec_lib_schema1239.EntityScalarField;
+  isActive: _contractspec_lib_schema1239.EntityScalarField;
+  orgId: _contractspec_lib_schema1239.EntityScalarField;
+  metadata: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  updatedAt: _contractspec_lib_schema1239.EntityScalarField;
+  learnerAchievements: _contractspec_lib_schema1239.EntityRelationField;
+}>;
+/**
+ * LearnerAchievement entity - unlocked achievements.
+ */
+declare const LearnerAchievementEntity: _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  achievementId: _contractspec_lib_schema1239.EntityScalarField;
+  xpEarned: _contractspec_lib_schema1239.EntityScalarField;
+  progress: _contractspec_lib_schema1239.EntityScalarField;
+  currentValue: _contractspec_lib_schema1239.EntityScalarField;
+  targetValue: _contractspec_lib_schema1239.EntityScalarField;
+  unlockedAt: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+  achievement: _contractspec_lib_schema1239.EntityRelationField;
+}>;
+/**
+ * Streak entity - tracks daily learning streaks.
+ */
+declare const StreakEntity: _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  currentStreak: _contractspec_lib_schema1239.EntityScalarField;
+  longestStreak: _contractspec_lib_schema1239.EntityScalarField;
+  lastActivityAt: _contractspec_lib_schema1239.EntityScalarField;
+  lastActivityDate: _contractspec_lib_schema1239.EntityScalarField;
+  freezesRemaining: _contractspec_lib_schema1239.EntityScalarField;
+  freezeUsedAt: _contractspec_lib_schema1239.EntityScalarField;
+  streakHistory: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  updatedAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+}>;
+/**
+ * DailyGoal entity - tracks daily XP goals.
+ */
+declare const DailyGoalEntity: _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  date: _contractspec_lib_schema1239.EntityScalarField;
+  targetXp: _contractspec_lib_schema1239.EntityScalarField;
+  currentXp: _contractspec_lib_schema1239.EntityScalarField;
+  isCompleted: _contractspec_lib_schema1239.EntityScalarField;
+  completedAt: _contractspec_lib_schema1239.EntityScalarField;
+  xpBreakdown: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  updatedAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+}>;
+/**
+ * LeaderboardEntry entity - leaderboard rankings.
+ */
+declare const LeaderboardEntryEntity: _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  periodType: _contractspec_lib_schema1239.EntityEnumField;
+  periodKey: _contractspec_lib_schema1239.EntityScalarField;
+  xp: _contractspec_lib_schema1239.EntityScalarField;
+  rank: _contractspec_lib_schema1239.EntityScalarField;
+  lessonsCompleted: _contractspec_lib_schema1239.EntityScalarField;
+  quizzesPassed: _contractspec_lib_schema1239.EntityScalarField;
+  cardsReviewed: _contractspec_lib_schema1239.EntityScalarField;
+  streakDays: _contractspec_lib_schema1239.EntityScalarField;
+  league: _contractspec_lib_schema1239.EntityScalarField;
+  orgId: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  updatedAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+}>;
+/**
+ * Heart entity - lives system (optional).
+ */
+declare const HeartEntity: _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  current: _contractspec_lib_schema1239.EntityScalarField;
+  max: _contractspec_lib_schema1239.EntityScalarField;
+  lastRefillAt: _contractspec_lib_schema1239.EntityScalarField;
+  nextRefillAt: _contractspec_lib_schema1239.EntityScalarField;
+  refillIntervalMinutes: _contractspec_lib_schema1239.EntityScalarField;
+  infiniteUntil: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  updatedAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+}>;
+/**
+ * XPTransaction entity - XP earning history.
+ */
+declare const XPTransactionEntity: _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  amount: _contractspec_lib_schema1239.EntityScalarField;
+  type: _contractspec_lib_schema1239.EntityScalarField;
+  sourceType: _contractspec_lib_schema1239.EntityScalarField;
+  sourceId: _contractspec_lib_schema1239.EntityScalarField;
+  description: _contractspec_lib_schema1239.EntityScalarField;
+  balanceAfter: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+}>;
+declare const gamificationEntities: (_contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  key: _contractspec_lib_schema1239.EntityScalarField;
+  name: _contractspec_lib_schema1239.EntityScalarField;
+  description: _contractspec_lib_schema1239.EntityScalarField;
+  icon: _contractspec_lib_schema1239.EntityScalarField;
+  color: _contractspec_lib_schema1239.EntityScalarField;
+  badgeUrl: _contractspec_lib_schema1239.EntityScalarField;
+  type: _contractspec_lib_schema1239.EntityEnumField;
+  category: _contractspec_lib_schema1239.EntityScalarField;
+  rarity: _contractspec_lib_schema1239.EntityScalarField;
+  xpReward: _contractspec_lib_schema1239.EntityScalarField;
+  condition: _contractspec_lib_schema1239.EntityScalarField;
+  order: _contractspec_lib_schema1239.EntityScalarField;
+  isHidden: _contractspec_lib_schema1239.EntityScalarField;
+  isActive: _contractspec_lib_schema1239.EntityScalarField;
+  orgId: _contractspec_lib_schema1239.EntityScalarField;
+  metadata: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  updatedAt: _contractspec_lib_schema1239.EntityScalarField;
+  learnerAchievements: _contractspec_lib_schema1239.EntityRelationField;
+}> | _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  achievementId: _contractspec_lib_schema1239.EntityScalarField;
+  xpEarned: _contractspec_lib_schema1239.EntityScalarField;
+  progress: _contractspec_lib_schema1239.EntityScalarField;
+  currentValue: _contractspec_lib_schema1239.EntityScalarField;
+  targetValue: _contractspec_lib_schema1239.EntityScalarField;
+  unlockedAt: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+  achievement: _contractspec_lib_schema1239.EntityRelationField;
+}> | _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  currentStreak: _contractspec_lib_schema1239.EntityScalarField;
+  longestStreak: _contractspec_lib_schema1239.EntityScalarField;
+  lastActivityAt: _contractspec_lib_schema1239.EntityScalarField;
+  lastActivityDate: _contractspec_lib_schema1239.EntityScalarField;
+  freezesRemaining: _contractspec_lib_schema1239.EntityScalarField;
+  freezeUsedAt: _contractspec_lib_schema1239.EntityScalarField;
+  streakHistory: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  updatedAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+}> | _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  date: _contractspec_lib_schema1239.EntityScalarField;
+  targetXp: _contractspec_lib_schema1239.EntityScalarField;
+  currentXp: _contractspec_lib_schema1239.EntityScalarField;
+  isCompleted: _contractspec_lib_schema1239.EntityScalarField;
+  completedAt: _contractspec_lib_schema1239.EntityScalarField;
+  xpBreakdown: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  updatedAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+}> | _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  periodType: _contractspec_lib_schema1239.EntityEnumField;
+  periodKey: _contractspec_lib_schema1239.EntityScalarField;
+  xp: _contractspec_lib_schema1239.EntityScalarField;
+  rank: _contractspec_lib_schema1239.EntityScalarField;
+  lessonsCompleted: _contractspec_lib_schema1239.EntityScalarField;
+  quizzesPassed: _contractspec_lib_schema1239.EntityScalarField;
+  cardsReviewed: _contractspec_lib_schema1239.EntityScalarField;
+  streakDays: _contractspec_lib_schema1239.EntityScalarField;
+  league: _contractspec_lib_schema1239.EntityScalarField;
+  orgId: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  updatedAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+}> | _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  current: _contractspec_lib_schema1239.EntityScalarField;
+  max: _contractspec_lib_schema1239.EntityScalarField;
+  lastRefillAt: _contractspec_lib_schema1239.EntityScalarField;
+  nextRefillAt: _contractspec_lib_schema1239.EntityScalarField;
+  refillIntervalMinutes: _contractspec_lib_schema1239.EntityScalarField;
+  infiniteUntil: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  updatedAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+}> | _contractspec_lib_schema1239.EntitySpec<{
+  id: _contractspec_lib_schema1239.EntityScalarField;
+  learnerId: _contractspec_lib_schema1239.EntityScalarField;
+  amount: _contractspec_lib_schema1239.EntityScalarField;
+  type: _contractspec_lib_schema1239.EntityScalarField;
+  sourceType: _contractspec_lib_schema1239.EntityScalarField;
+  sourceId: _contractspec_lib_schema1239.EntityScalarField;
+  description: _contractspec_lib_schema1239.EntityScalarField;
+  balanceAfter: _contractspec_lib_schema1239.EntityScalarField;
+  createdAt: _contractspec_lib_schema1239.EntityScalarField;
+  learner: _contractspec_lib_schema1239.EntityRelationField;
+}>)[];
+declare const gamificationEnums: _contractspec_lib_schema1239.EntityEnumDef[];
+//#endregion
+export { AchievementEntity, AchievementTypeEnum, DailyGoalEntity, HeartEntity, LeaderboardEntryEntity, LeaderboardPeriodEnum, LearnerAchievementEntity, StreakEntity, XPTransactionEntity, gamificationEntities, gamificationEnums };
+//# sourceMappingURL=gamification.d.ts.map

package/dist/entities/gamification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gamification.d.ts","names":[],"sources":["../../src/entities/gamification.ts"],"sourcesContent":[],"mappings":";;;;;;AAUa,cAAA,mBAYX,EAAA,4BAAA,CAZ8B,aAY9B;AAKF;AAUA;;cAVa,uBAKX,4BAAA,CALgC;;;;cAUrB,gDAAiB;MAgF5B,4BAAA,CAAA;;;;;;;;;;;;;;0DAhF4B;EAAA,KAAA,gDAAA;EAqFjB,QAAA,gDA2CX;EAAA,SAAA,gDAAA;;;;;;;cA3CW,uDAAwB;MA2CnC,4BAAA,CAAA;;;0DA3CmC;EAAA,QAAA,gDAAA;EAgDxB,YAAA,gDA2DX;EAAA,WAAA,gDAAA;;;;;;;;;cA3DW,2CAAY;MA2DvB,4BAAA,CAAA;;+DA3DuB;EAAA,aAAA,gDAAA;EAgEZ,cAAA,gDA6CX;EAAA,gBAAA,gDAAA;;;;;;;;;;;cA7CW,eAAe,+BAAA,UAAA,CAAA;EAAA,EAAA,EA6C1B,4BAAA,CAAA,iBA7C0B;EAkDf,SAAA,gDAoDX;EAAA,IAAA,gDAAA;;;;;;;;;;;;;cApDW,qDAAsB;MAoDjC,4BAAA,CAAA;2DApDiC;EAAA,UAAA,8CAAA;EAyDtB,SAAA,gDA8CX;EAAA,EAAA,gDAAA;;;;;;;;;;;;;AAKF;;cAnDa,0CAAW;MA8CtB,4BAAA,CAAA;;;;;;;;2DAK8B;EAAA,SAAA,gDAAA;EAmDnB,OAAA,kDAQZ;CAAA,CAAA;;;;cA3DY,kDAAmB;MAiD9B,4BAAA,CAAA;;;;;;;;;;;cAEW,oDAAoB;MAQhC,4BAAA,CAAA;;;6DARgC;EAAA,IAAA,gDAAA;;;;;;;;;;;;;;;;;MAAA,4BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUpB,aAAA,gDAAiB;;;;;;;;;;;;;;;;cAAjB,mBAAgE,4BAAA,CAA/C,aAAA"}