@vue-skuilder/db 0.2.13 → 0.2.15

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { U as UserDBInterface, s as CourseRegistrationDoc, S as StudySessionItem, W as WeightedCard, R as ReplanHints, h as StudyContentSource, G as GeneratorResult, C as CourseDBInterface } from './contentSource-jSkcOt2s.cjs';
-export { K as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, a4 as CardGenerator, a6 as CardGeneratorFactory, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, H as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, L as CourseRegistration, b as CoursesDBInterface, ad as DocumentUpdater, a5 as GeneratorContext, a7 as LearnableWeight, N as NavigatorConstructor, a0 as NavigatorRole, a1 as NavigatorRoles, $ as Navigators, a8 as OrchestrationContext, j as ScheduledCard, I as SessionTrackingData, Z as StrategyContribution, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, J as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, M as UserOutcomeRecord, B as UsrCrsDataInterface, a9 as computeDeviation, ab as computeEffectiveWeight, aa as computeSpread, ac as createOrchestrationContext, _ as getCardOrigin, P as getRegisteredNavigator, X as getRegisteredNavigatorNames, V as getRegisteredNavigatorRole, r as getStudySource, Q as hasRegisteredNavigator, Y as initializeNavigatorRegistry, a3 as isFilter, a2 as isGenerator, p as isReview, ae as newInterval, O as registerNavigator } from './contentSource-jSkcOt2s.cjs';
-import { D as DataLayerProvider } from './dataLayerProvider-BDClIrFC.cjs';
+import { U as UserDBInterface, s as CourseRegistrationDoc, S as StudySessionItem, W as WeightedCard, R as ReplanHints, h as StudyContentSource, G as GeneratorResult, C as CourseDBInterface } from './contentSource-Brz42x7n.cjs';
+export { K as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, a4 as CardGenerator, a6 as CardGeneratorFactory, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, H as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, L as CourseRegistration, b as CoursesDBInterface, ad as DocumentUpdater, a5 as GeneratorContext, a7 as LearnableWeight, N as NavigatorConstructor, a0 as NavigatorRole, a1 as NavigatorRoles, $ as Navigators, a8 as OrchestrationContext, j as ScheduledCard, I as SessionTrackingData, Z as StrategyContribution, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, J as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, M as UserOutcomeRecord, B as UsrCrsDataInterface, a9 as computeDeviation, ab as computeEffectiveWeight, aa as computeSpread, ac as createOrchestrationContext, _ as getCardOrigin, P as getRegisteredNavigator, X as getRegisteredNavigatorNames, V as getRegisteredNavigatorRole, r as getStudySource, Q as hasRegisteredNavigator, Y as initializeNavigatorRegistry, a3 as isFilter, a2 as isGenerator, p as isReview, ae as newInterval, O as registerNavigator } from './contentSource-Brz42x7n.cjs';
+import { D as DataLayerProvider } from './dataLayerProvider-CpwpT1rM.cjs';
 import { C as CardHistory, c as CardRecord, d as QuestionRecord } from './types-legacy-4tlwHnXo.cjs';
 export { e as CardData, f as CourseListData, h as DataShapeData, g as DisplayableData, D as DocType, b as DocTypePrefixes, F as Field, G as GuestUsername, Q as QualifiedCardID, i as QuestionData, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from './types-legacy-4tlwHnXo.cjs';
 import { SrsBacklogDebug, Loggable } from './core/index.cjs';
@@ -10,7 +10,7 @@ import { S as StaticCourseManifest } from './types-BFUa1pa3.cjs';
 export { A as AttachmentData, C as ChunkMetadata, D as DesignDocument, I as IndexMetadata, a as PackedCourseData, P as PackerConfig } from './types-BFUa1pa3.cjs';
 import { F as FileSystemAdapter } from './index-k9NFHpS1.cjs';
 export { C as CouchDBToStaticPacker, a as FileStats, b as FileSystemError } from './index-k9NFHpS1.cjs';
-import 'moment';
+import moment from 'moment';
 
 /**
  * Service responsible for ELO rating calculations and updates.
@@ -70,6 +70,12 @@ declare class ResponseProcessor {
     private srsService;
     private eloService;
     constructor(srsService: SrsService, eloService: EloService);
+    /**
+     * ELO updates are fired without awaiting so response handling isn't blocked
+     * on DB writes — but an unhandled rejection silently drops the update.
+     * This produces a catch handler that surfaces the failure in logs.
+     */
+    private logEloFailure;
     /**
      * Parses performance data into global score and optional per-tag scores.
      *
@@ -362,6 +368,30 @@ interface SessionDebugSnapshot {
     /** Every card the learner has interacted with this session, draw order. */
     drawnCards: SessionDrawnCardDebug[];
 }
+/** The narrow surface the overlay needs from a SessionController. */
+interface SessionDebugTarget {
+    getDebugSnapshot(): SessionDebugSnapshot;
+}
+/**
+ * The live-session surface available to out-of-tree callers through the
+ * active-controller registry: the debug snapshot, plus the small set of
+ * user-facing session controls a view may need without holding a ref into
+ * the `<StudySession>` component's internals (e.g. wiring a timer's
+ * add-time button from a composable). Keep this narrow — it is not a
+ * general escape hatch to `SessionController`.
+ */
+interface ActiveSessionHandle extends SessionDebugTarget {
+    /** Extend the session clock by `seconds`. */
+    addTime(seconds: number): void;
+}
+/** Called by SessionController's constructor. Pass `null` to deregister. */
+declare function registerActiveController(controller: ActiveSessionHandle | null): void;
+declare function getActiveController(): ActiveSessionHandle | null;
+/**
+ * Toggle the pinned overlay on/off. No-ops (with a console hint) when there is
+ * no DOM, so it is safe to call from any host environment.
+ */
+declare function toggleSessionOverlay(): void;
 
 /**
  * Options for requesting a mid-session replan.
@@ -1460,6 +1490,18 @@ declare function getDataLayer(): DataLayerProvider;
  */
 declare function _resetDataLayer(): Promise<void>;
 
+declare const REVIEW_TIME_FORMAT: string;
+/**
+ * Build a ScheduledCard `_id` for the given review time.
+ *
+ * The id suffix is not a mere uniquifier: `getReviewstoDate` PARSES the id
+ * (with {@link REVIEW_TIME_FORMAT}) to decide due-ness, so the id is the
+ * datum. Anything that writes or rewrites scheduled-card docs (scheduling,
+ * user-state snapshot rebasing) must construct ids through this helper —
+ * a hand-rolled formatter will get moment's `kk` token (01-24 hours) wrong.
+ */
+declare function makeScheduledCardId(reviewTime: string | Date | moment.Moment): string;
+
 type UserAccountStatus = 'pending_verification' | 'verified' | 'suspended';
 interface Entitlement {
     status: 'trial' | 'paid';
@@ -1479,4 +1521,4 @@ interface CouchDbUserDoc extends PouchDB.Authentication.User {
     entitlements: UserEntitlements;
 }
 
-export { type AggregatedDocument, type AttachmentUploadResult, CardHistory, type CardPresentation, CardRecord, type CouchDbUserDoc, CourseDBInterface, CourseLookup, CourseRegistrationDoc, type CustomQuestionsData, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, GeneratorResult, Loggable, type MigrationOptions, type MigrationResult, type MixerCardInfo, type MixerRunReport, NOT_SET, type OutcomeObserver, type ProcessedDataShape, type ProcessedQuestionData, QuestionRecord, type QueueSnapshot, QuotaRoundRobinMixer, ReplanHints, type ReplanOptions, type ResponseResult, type RestoreProgress, type SessionAction, SessionController, type SessionControls, type SessionOutcome, type SessionRunReport, type SourceBatch, type SourceMixer, type SourceSelectionBreakdown, type SourceSummary, SrsBacklogDebug, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, captureMixerRun, clearStaleSessionDebugState, endSessionTracking, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, initializeDataDirectory, initializeDataLayer, isDataShapeRegistered, isDataShapeSchemaAvailable, isQuestionTypeRegistered, mixerDebugAPI, mountMixerDebugger, mountSessionDebugger, processCustomQuestionsData, recordCardPresentation, registerBlanksCard, registerCustomQuestionTypes, registerDataShape, registerQuestionType, registerSeedData, removeCustomQuestionTypes, removeDataShape, removeQuestionType, sessionDebugAPI, snapshotQueues, startSessionTracking, validateMigration, validateStaticCourse };
+export { type ActiveSessionHandle, type AggregatedDocument, type AttachmentUploadResult, CardHistory, type CardPresentation, CardRecord, type CouchDbUserDoc, CourseDBInterface, CourseLookup, CourseRegistrationDoc, type CustomQuestionsData, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, GeneratorResult, Loggable, type MigrationOptions, type MigrationResult, type MixerCardInfo, type MixerRunReport, NOT_SET, type OutcomeObserver, type ProcessedDataShape, type ProcessedQuestionData, QuestionRecord, type QueueSnapshot, QuotaRoundRobinMixer, REVIEW_TIME_FORMAT, ReplanHints, type ReplanOptions, type ResponseResult, type RestoreProgress, type SessionAction, SessionController, type SessionControls, type SessionDebugSnapshot, type SessionDebugTarget, type SessionDrawnCardDebug, type SessionOutcome, type SessionQueueDebug, type SessionQueueItemDebug, type SessionRunReport, type SourceBatch, type SourceMixer, type SourceSelectionBreakdown, type SourceSummary, SrsBacklogDebug, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, captureMixerRun, clearStaleSessionDebugState, endSessionTracking, ensureAppDataDirectory, getActiveController, getAppDataDirectory, getDataLayer, getDbPath, initializeDataDirectory, initializeDataLayer, isDataShapeRegistered, isDataShapeSchemaAvailable, isQuestionTypeRegistered, makeScheduledCardId, mixerDebugAPI, mountMixerDebugger, mountSessionDebugger, processCustomQuestionsData, recordCardPresentation, registerActiveController, registerBlanksCard, registerCustomQuestionTypes, registerDataShape, registerQuestionType, registerSeedData, removeCustomQuestionTypes, removeDataShape, removeQuestionType, sessionDebugAPI, snapshotQueues, startSessionTracking, toggleSessionOverlay, validateMigration, validateStaticCourse };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { U as UserDBInterface, s as CourseRegistrationDoc, S as StudySessionItem, W as WeightedCard, R as ReplanHints, h as StudyContentSource, G as GeneratorResult, C as CourseDBInterface } from './contentSource-C-0t0y0V.js';
-export { K as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, a4 as CardGenerator, a6 as CardGeneratorFactory, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, H as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, L as CourseRegistration, b as CoursesDBInterface, ad as DocumentUpdater, a5 as GeneratorContext, a7 as LearnableWeight, N as NavigatorConstructor, a0 as NavigatorRole, a1 as NavigatorRoles, $ as Navigators, a8 as OrchestrationContext, j as ScheduledCard, I as SessionTrackingData, Z as StrategyContribution, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, J as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, M as UserOutcomeRecord, B as UsrCrsDataInterface, a9 as computeDeviation, ab as computeEffectiveWeight, aa as computeSpread, ac as createOrchestrationContext, _ as getCardOrigin, P as getRegisteredNavigator, X as getRegisteredNavigatorNames, V as getRegisteredNavigatorRole, r as getStudySource, Q as hasRegisteredNavigator, Y as initializeNavigatorRegistry, a3 as isFilter, a2 as isGenerator, p as isReview, ae as newInterval, O as registerNavigator } from './contentSource-C-0t0y0V.js';
-import { D as DataLayerProvider } from './dataLayerProvider-BB0oi9T0.js';
+import { U as UserDBInterface, s as CourseRegistrationDoc, S as StudySessionItem, W as WeightedCard, R as ReplanHints, h as StudyContentSource, G as GeneratorResult, C as CourseDBInterface } from './contentSource-B1p-vdz7.js';
+export { K as ActivityRecord, A as AdminDBInterface, v as AssignedCard, g as AssignedContent, u as AssignedCourse, t as AssignedTag, a4 as CardGenerator, a6 as CardGeneratorFactory, c as ClassroomDBInterface, F as ClassroomRegistration, E as ClassroomRegistrationDesignation, H as ClassroomRegistrationDoc, e as ContentNavigationStrategyData, f as ContentNavigator, q as ContentSourceID, d as CourseInfo, L as CourseRegistration, b as CoursesDBInterface, ad as DocumentUpdater, a5 as GeneratorContext, a7 as LearnableWeight, N as NavigatorConstructor, a0 as NavigatorRole, a1 as NavigatorRoles, $ as Navigators, a8 as OrchestrationContext, j as ScheduledCard, I as SessionTrackingData, Z as StrategyContribution, i as StudentClassroomDBInterface, k as StudySessionFailedItem, l as StudySessionFailedNewItem, m as StudySessionFailedReviewItem, n as StudySessionNewItem, o as StudySessionReviewItem, T as TeacherClassroomDBInterface, J as UserConfig, z as UserCourseSetting, y as UserCourseSettings, x as UserDBAuthenticator, a as UserDBReader, w as UserDBWriter, M as UserOutcomeRecord, B as UsrCrsDataInterface, a9 as computeDeviation, ab as computeEffectiveWeight, aa as computeSpread, ac as createOrchestrationContext, _ as getCardOrigin, P as getRegisteredNavigator, X as getRegisteredNavigatorNames, V as getRegisteredNavigatorRole, r as getStudySource, Q as hasRegisteredNavigator, Y as initializeNavigatorRegistry, a3 as isFilter, a2 as isGenerator, p as isReview, ae as newInterval, O as registerNavigator } from './contentSource-B1p-vdz7.js';
+import { D as DataLayerProvider } from './dataLayerProvider-BWayUIoK.js';
 import { C as CardHistory, c as CardRecord, d as QuestionRecord } from './types-legacy-4tlwHnXo.js';
 export { e as CardData, f as CourseListData, h as DataShapeData, g as DisplayableData, D as DocType, b as DocTypePrefixes, F as Field, G as GuestUsername, Q as QualifiedCardID, i as QuestionData, S as SkuilderCourseData, a as Tag, T as TagStub, l as log } from './types-legacy-4tlwHnXo.js';
 import { SrsBacklogDebug, Loggable } from './core/index.js';
@@ -10,7 +10,7 @@ import { S as StaticCourseManifest } from './types-CHgpWQAY.js';
 export { A as AttachmentData, C as ChunkMetadata, D as DesignDocument, I as IndexMetadata, a as PackedCourseData, P as PackerConfig } from './types-CHgpWQAY.js';
 import { F as FileSystemAdapter } from './index-BLLT5BYE.js';
 export { C as CouchDBToStaticPacker, a as FileStats, b as FileSystemError } from './index-BLLT5BYE.js';
-import 'moment';
+import moment from 'moment';
 
 /**
  * Service responsible for ELO rating calculations and updates.
@@ -70,6 +70,12 @@ declare class ResponseProcessor {
     private srsService;
     private eloService;
     constructor(srsService: SrsService, eloService: EloService);
+    /**
+     * ELO updates are fired without awaiting so response handling isn't blocked
+     * on DB writes — but an unhandled rejection silently drops the update.
+     * This produces a catch handler that surfaces the failure in logs.
+     */
+    private logEloFailure;
     /**
      * Parses performance data into global score and optional per-tag scores.
      *
@@ -362,6 +368,30 @@ interface SessionDebugSnapshot {
     /** Every card the learner has interacted with this session, draw order. */
     drawnCards: SessionDrawnCardDebug[];
 }
+/** The narrow surface the overlay needs from a SessionController. */
+interface SessionDebugTarget {
+    getDebugSnapshot(): SessionDebugSnapshot;
+}
+/**
+ * The live-session surface available to out-of-tree callers through the
+ * active-controller registry: the debug snapshot, plus the small set of
+ * user-facing session controls a view may need without holding a ref into
+ * the `<StudySession>` component's internals (e.g. wiring a timer's
+ * add-time button from a composable). Keep this narrow — it is not a
+ * general escape hatch to `SessionController`.
+ */
+interface ActiveSessionHandle extends SessionDebugTarget {
+    /** Extend the session clock by `seconds`. */
+    addTime(seconds: number): void;
+}
+/** Called by SessionController's constructor. Pass `null` to deregister. */
+declare function registerActiveController(controller: ActiveSessionHandle | null): void;
+declare function getActiveController(): ActiveSessionHandle | null;
+/**
+ * Toggle the pinned overlay on/off. No-ops (with a console hint) when there is
+ * no DOM, so it is safe to call from any host environment.
+ */
+declare function toggleSessionOverlay(): void;
 
 /**
  * Options for requesting a mid-session replan.
@@ -1460,6 +1490,18 @@ declare function getDataLayer(): DataLayerProvider;
  */
 declare function _resetDataLayer(): Promise<void>;
 
+declare const REVIEW_TIME_FORMAT: string;
+/**
+ * Build a ScheduledCard `_id` for the given review time.
+ *
+ * The id suffix is not a mere uniquifier: `getReviewstoDate` PARSES the id
+ * (with {@link REVIEW_TIME_FORMAT}) to decide due-ness, so the id is the
+ * datum. Anything that writes or rewrites scheduled-card docs (scheduling,
+ * user-state snapshot rebasing) must construct ids through this helper —
+ * a hand-rolled formatter will get moment's `kk` token (01-24 hours) wrong.
+ */
+declare function makeScheduledCardId(reviewTime: string | Date | moment.Moment): string;
+
 type UserAccountStatus = 'pending_verification' | 'verified' | 'suspended';
 interface Entitlement {
     status: 'trial' | 'paid';
@@ -1479,4 +1521,4 @@ interface CouchDbUserDoc extends PouchDB.Authentication.User {
     entitlements: UserEntitlements;
 }
 
-export { type AggregatedDocument, type AttachmentUploadResult, CardHistory, type CardPresentation, CardRecord, type CouchDbUserDoc, CourseDBInterface, CourseLookup, CourseRegistrationDoc, type CustomQuestionsData, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, GeneratorResult, Loggable, type MigrationOptions, type MigrationResult, type MixerCardInfo, type MixerRunReport, NOT_SET, type OutcomeObserver, type ProcessedDataShape, type ProcessedQuestionData, QuestionRecord, type QueueSnapshot, QuotaRoundRobinMixer, ReplanHints, type ReplanOptions, type ResponseResult, type RestoreProgress, type SessionAction, SessionController, type SessionControls, type SessionOutcome, type SessionRunReport, type SourceBatch, type SourceMixer, type SourceSelectionBreakdown, type SourceSummary, SrsBacklogDebug, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, captureMixerRun, clearStaleSessionDebugState, endSessionTracking, ensureAppDataDirectory, getAppDataDirectory, getDataLayer, getDbPath, initializeDataDirectory, initializeDataLayer, isDataShapeRegistered, isDataShapeSchemaAvailable, isQuestionTypeRegistered, mixerDebugAPI, mountMixerDebugger, mountSessionDebugger, processCustomQuestionsData, recordCardPresentation, registerBlanksCard, registerCustomQuestionTypes, registerDataShape, registerQuestionType, registerSeedData, removeCustomQuestionTypes, removeDataShape, removeQuestionType, sessionDebugAPI, snapshotQueues, startSessionTracking, validateMigration, validateStaticCourse };
+export { type ActiveSessionHandle, type AggregatedDocument, type AttachmentUploadResult, CardHistory, type CardPresentation, CardRecord, type CouchDbUserDoc, CourseDBInterface, CourseLookup, CourseRegistrationDoc, type CustomQuestionsData, DEFAULT_MIGRATION_OPTIONS, type DataLayerConfig, DataLayerProvider, type DocumentCounts, ENV, type Entitlement, FileSystemAdapter, GeneratorResult, Loggable, type MigrationOptions, type MigrationResult, type MixerCardInfo, type MixerRunReport, NOT_SET, type OutcomeObserver, type ProcessedDataShape, type ProcessedQuestionData, QuestionRecord, type QueueSnapshot, QuotaRoundRobinMixer, REVIEW_TIME_FORMAT, ReplanHints, type ReplanOptions, type ResponseResult, type RestoreProgress, type SessionAction, SessionController, type SessionControls, type SessionDebugSnapshot, type SessionDebugTarget, type SessionDrawnCardDebug, type SessionOutcome, type SessionQueueDebug, type SessionQueueItemDebug, type SessionRunReport, type SourceBatch, type SourceMixer, type SourceSelectionBreakdown, type SourceSummary, SrsBacklogDebug, StaticCourseManifest, type StaticCourseValidation, StaticToCouchDBMigrator, StudyContentSource, StudySessionItem, type StudySessionRecord, TagFilteredContentSource, type UserAccountStatus, UserDBInterface, type UserEntitlements, type ValidationIssue, type ValidationResult, WeightedCard, _resetDataLayer, captureMixerRun, clearStaleSessionDebugState, endSessionTracking, ensureAppDataDirectory, getActiveController, getAppDataDirectory, getDataLayer, getDbPath, initializeDataDirectory, initializeDataLayer, isDataShapeRegistered, isDataShapeSchemaAvailable, isQuestionTypeRegistered, makeScheduledCardId, mixerDebugAPI, mountMixerDebugger, mountSessionDebugger, processCustomQuestionsData, recordCardPresentation, registerActiveController, registerBlanksCard, registerCustomQuestionTypes, registerDataShape, registerQuestionType, registerSeedData, removeCustomQuestionTypes, removeDataShape, removeQuestionType, sessionDebugAPI, snapshotQueues, startSessionTracking, toggleSessionOverlay, validateMigration, validateStaticCourse };

package/dist/index.js

@@ -243,6 +243,9 @@ var init_dataDirectory = __esm({
 });
 
 // src/impl/common/userDBHelpers.ts
+function makeScheduledCardId(reviewTime) {
+  return DocTypePrefixes["SCHEDULED_CARD" /* SCHEDULED_CARD */] + import_moment.default.utc(reviewTime).format(REVIEW_TIME_FORMAT);
+}
 function hexEncode(str) {
   let hex;
   let returnStr = "";
@@ -298,7 +301,7 @@ function scheduleCardReviewLocal(userDB, review) {
   const now = import_moment.default.utc();
   logger.info(`Scheduling for review in: ${review.time.diff(now, "h") / 24} days`);
   void userDB.put({
-    _id: DocTypePrefixes["SCHEDULED_CARD" /* SCHEDULED_CARD */] + review.time.format(REVIEW_TIME_FORMAT),
+    _id: makeScheduledCardId(review.time),
     cardId: review.card_id,
     reviewTime: review.time.toISOString(),
     courseId: review.course_id,
@@ -8008,9 +8011,9 @@ Currently logged-in as ${this._username}.`
           }
         }).map((r) => r.doc);
       }
-      async getReviewsForcast(daysCount) {
+      async getReviewsForcast(daysCount, course_id) {
         const time = import_moment6.default.utc().add(daysCount, "days");
-        return this.getReviewstoDate(time);
+        return this.getReviewstoDate(time, course_id);
       }
       async getPendingReviews(course_id) {
         const now = import_moment6.default.utc();
@@ -10577,6 +10580,7 @@ __export(index_exports, {
   NavigatorRoles: () => NavigatorRoles,
   Navigators: () => Navigators,
   QuotaRoundRobinMixer: () => QuotaRoundRobinMixer,
+  REVIEW_TIME_FORMAT: () => REVIEW_TIME_FORMAT,
   SessionController: () => SessionController,
   StaticToCouchDBMigrator: () => StaticToCouchDBMigrator,
   TagFilteredContentSource: () => TagFilteredContentSource,
@@ -10597,6 +10601,7 @@ __export(index_exports, {
   docIsDeleted: () => docIsDeleted,
   endSessionTracking: () => endSessionTracking,
   ensureAppDataDirectory: () => ensureAppDataDirectory,
+  getActiveController: () => getActiveController,
   getActivePipeline: () => getActivePipeline,
   getAppDataDirectory: () => getAppDataDirectory,
   getCardHistoryID: () => getCardHistoryID,
@@ -10622,6 +10627,7 @@ __export(index_exports, {
   isQuestionTypeRegistered: () => isQuestionTypeRegistered,
   isReview: () => isReview,
   log: () => log,
+  makeScheduledCardId: () => makeScheduledCardId,
   mixerDebugAPI: () => mixerDebugAPI,
   mountMixerDebugger: () => mountMixerDebugger,
   mountPipelineDebugger: () => mountPipelineDebugger,
@@ -10633,6 +10639,7 @@ __export(index_exports, {
   processCustomQuestionsData: () => processCustomQuestionsData,
   recordCardPresentation: () => recordCardPresentation,
   recordUserOutcome: () => recordUserOutcome,
+  registerActiveController: () => registerActiveController,
   registerBlanksCard: () => registerBlanksCard,
   registerCustomQuestionTypes: () => registerCustomQuestionTypes,
   registerDataShape: () => registerDataShape,
@@ -10647,6 +10654,7 @@ __export(index_exports, {
   sessionDebugAPI: () => sessionDebugAPI,
   snapshotQueues: () => snapshotQueues,
   startSessionTracking: () => startSessionTracking,
+  toggleSessionOverlay: () => toggleSessionOverlay,
   updateLearningState: () => updateLearningState,
   updateStrategyWeight: () => updateStrategyWeight,
   userDBDebugAPI: () => userDBDebugAPI,
@@ -11109,13 +11117,18 @@ var EloService = class {
       logger.warn(`k value interpretation not currently implemented`);
     }
     const courseDB = this.dataLayer.getCourseDB(currentCard.card.course_id);
-    const userElo = (0, import_common23.toCourseElo)(
-      userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo
-    );
+    const courseReg = userCourseRegDoc.courses.find((c) => c.courseID === course_id);
+    if (!courseReg) {
+      logger.error(
+        `[EloService] No registration for course ${course_id} on user's registration doc \u2014 skipping ELO update for card ${card_id}. (Is the user registered for this course?)`
+      );
+      return;
+    }
+    const userElo = (0, import_common23.toCourseElo)(courseReg.elo);
     const cardElo = (await courseDB.getCardEloData([currentCard.card.card_id]))[0];
     if (cardElo && userElo) {
       const eloUpdate = (0, import_common23.adjustCourseScores)(userElo, cardElo, userScore);
-      userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo = eloUpdate.userElo;
+      courseReg.elo = eloUpdate.userElo;
       const results = await Promise.allSettled([
         this.user.updateUserElo(course_id, eloUpdate.userElo),
         courseDB.updateCardElo(card_id, eloUpdate.cardElo)
@@ -11160,9 +11173,14 @@ var EloService = class {
    */
   async updateUserAndCardEloPerTag(taggedPerformance, course_id, card_id, userCourseRegDoc, currentCard) {
     const courseDB = this.dataLayer.getCourseDB(currentCard.card.course_id);
-    const userElo = (0, import_common23.toCourseElo)(
-      userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo
-    );
+    const courseReg = userCourseRegDoc.courses.find((c) => c.courseID === course_id);
+    if (!courseReg) {
+      logger.error(
+        `[EloService] No registration for course ${course_id} on user's registration doc \u2014 skipping per-tag ELO update for card ${card_id}. (Is the user registered for this course?)`
+      );
+      return;
+    }
+    const userElo = (0, import_common23.toCourseElo)(courseReg.elo);
     const [cardEloResults, cardTagsMap] = await Promise.all([
       courseDB.getCardEloData([currentCard.card.card_id]),
       courseDB.getAppliedTagsBatch([card_id])
@@ -11178,7 +11196,7 @@ var EloService = class {
     }
     if (cardElo && userElo) {
       const eloUpdate = (0, import_common23.adjustCourseScoresPerTag)(userElo, cardElo, enriched);
-      userCourseRegDoc.courses.find((c) => c.courseID === course_id).elo = eloUpdate.userElo;
+      courseReg.elo = eloUpdate.userElo;
       const results = await Promise.allSettled([
         this.user.updateUserElo(course_id, eloUpdate.userElo),
         courseDB.updateCardElo(card_id, eloUpdate.cardElo)
@@ -11225,6 +11243,14 @@ var ResponseProcessor = class {
     this.srsService = srsService;
     this.eloService = eloService;
   }
+  /**
+   * ELO updates are fired without awaiting so response handling isn't blocked
+   * on DB writes — but an unhandled rejection silently drops the update.
+   * This produces a catch handler that surfaces the failure in logs.
+   */
+  logEloFailure(context, cardId) {
+    return (e) => logger.error(`[ResponseProcessor] ELO update failed (${context}) for ${cardId}:`, e);
+  }
   /**
    * Parses performance data into global score and optional per-tag scores.
    *
@@ -11342,17 +11368,11 @@ var ResponseProcessor = class {
           cardId,
           courseRegistrationDoc,
           currentCard
-        );
+        ).catch(this.logEloFailure("correct per-tag", cardId));
       } else {
         const userScore = 0.5 + globalScore / 2;
         if (history.records.length === 1) {
-          void this.eloService.updateUserAndCardElo(
-            userScore,
-            courseId,
-            cardId,
-            courseRegistrationDoc,
-            currentCard
-          );
+          void this.eloService.updateUserAndCardElo(userScore, courseId, cardId, courseRegistrationDoc, currentCard).catch(this.logEloFailure("correct", cardId));
         } else {
           const k = Math.ceil(32 / history.records.length);
           void this.eloService.updateUserAndCardElo(
@@ -11362,7 +11382,7 @@ var ResponseProcessor = class {
             courseRegistrationDoc,
             currentCard,
             k
-          );
+          ).catch(this.logEloFailure("correct repeat-view", cardId));
         }
         logger.info(
           `[FirstContactElo] correct first-attempt ELO update (score=${userScore.toFixed(3)}) for ${cardId} (historyLen=${history.records.length}, priorAttemps=${cardRecord.priorAttemps})`
@@ -11403,7 +11423,7 @@ var ResponseProcessor = class {
           cardId,
           courseRegistrationDoc,
           currentCard
-        );
+        ).catch(this.logEloFailure("incorrect per-tag", cardId));
         logger.info(
           `[FirstContactElo] incorrect first-attempt per-tag ELO update for ${cardId} (historyLen=${history.records.length}, priorAttemps=${cardRecord.priorAttemps}, tags=${Object.keys(taggedPerformance).length - 1})`
         );
@@ -11415,7 +11435,7 @@ var ResponseProcessor = class {
           cardId,
           courseRegistrationDoc,
           currentCard
-        );
+        ).catch(this.logEloFailure("incorrect", cardId));
         logger.info(
           `[FirstContactElo] incorrect first-attempt ELO update (score=0) for ${cardId} (historyLen=${history.records.length}, priorAttemps=${cardRecord.priorAttemps})`
         );
@@ -11436,15 +11456,9 @@ var ResponseProcessor = class {
               cardId,
               courseRegistrationDoc,
               currentCard
-            );
+            ).catch(this.logEloFailure("dismiss-failed per-tag", cardId));
           } else {
-            void this.eloService.updateUserAndCardElo(
-              0,
-              courseId,
-              cardId,
-              courseRegistrationDoc,
-              currentCard
-            );
+            void this.eloService.updateUserAndCardElo(0, courseId, cardId, courseRegistrationDoc, currentCard).catch(this.logEloFailure("dismiss-failed", cardId));
           }
           logger.info(
             `[FirstContactElo] dismiss-failed final ELO penalty for ${cardId} (historyLen=${history.records.length}, sessionViews=${sessionViews})`
@@ -15263,6 +15277,7 @@ init_TagFilteredContentSource();
 
 // src/index.ts
 init_factory();
+init_userDBHelpers();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ContentNavigator,
@@ -15281,6 +15296,7 @@ init_factory();
   NavigatorRoles,
   Navigators,
   QuotaRoundRobinMixer,
+  REVIEW_TIME_FORMAT,
   SessionController,
   StaticToCouchDBMigrator,
   TagFilteredContentSource,
@@ -15301,6 +15317,7 @@ init_factory();
   docIsDeleted,
   endSessionTracking,
   ensureAppDataDirectory,
+  getActiveController,
   getActivePipeline,
   getAppDataDirectory,
   getCardHistoryID,
@@ -15326,6 +15343,7 @@ init_factory();
   isQuestionTypeRegistered,
   isReview,
   log,
+  makeScheduledCardId,
   mixerDebugAPI,
   mountMixerDebugger,
   mountPipelineDebugger,
@@ -15337,6 +15355,7 @@ init_factory();
   processCustomQuestionsData,
   recordCardPresentation,
   recordUserOutcome,
+  registerActiveController,
   registerBlanksCard,
   registerCustomQuestionTypes,
   registerDataShape,
@@ -15351,6 +15370,7 @@ init_factory();
   sessionDebugAPI,
   snapshotQueues,
   startSessionTracking,
+  toggleSessionOverlay,
   updateLearningState,
   updateStrategyWeight,
   userDBDebugAPI,