@vue-skuilder/db 0.1.31 → 0.1.32-a

package/dist/index.d.cts

@@ -321,6 +321,13 @@ type SessionAction = 'dismiss-success' | 'dismiss-failed' | 'marked-failed' | 'd
 interface ResponseResult {
     nextCardAction: Exclude<SessionAction, 'dismiss-error'> | 'none';
     shouldLoadNextCard: boolean;
+    /**
+     * When true, the card requested deferred advancement via `deferAdvance`.
+     * The record was logged and ELO updated, but navigation was suppressed.
+     * StudySession should stash `nextCardAction` and wait for a
+     * `ready-to-advance` event from the card before calling `nextCard()`.
+     */
+    deferred?: boolean;
     isCorrect: boolean;
     performanceScore?: number;
     shouldClearFeedbackShadow: boolean;

package/dist/index.d.ts

@@ -321,6 +321,13 @@ type SessionAction = 'dismiss-success' | 'dismiss-failed' | 'marked-failed' | 'd
 interface ResponseResult {
     nextCardAction: Exclude<SessionAction, 'dismiss-error'> | 'none';
     shouldLoadNextCard: boolean;
+    /**
+     * When true, the card requested deferred advancement via `deferAdvance`.
+     * The record was logged and ELO updated, but navigation was suppressed.
+     * StudySession should stash `nextCardAction` and wait for a
+     * `ready-to-advance` event from the card before calling `nextCard()`.
+     */
+    deferred?: boolean;
     isCorrect: boolean;
     performanceScore?: number;
     shouldClearFeedbackShadow: boolean;

package/dist/index.js

@@ -9425,8 +9425,9 @@ var ResponseProcessor = class {
     }
     try {
       const history = await cardHistory;
+      let result;
       if (cardRecord.isCorrect) {
-        return this.processCorrectResponse(
+        result = this.processCorrectResponse(
           cardRecord,
           history,
           studySessionItem,
@@ -9436,7 +9437,7 @@ var ResponseProcessor = class {
           cardId
         );
       } else {
-        return this.processIncorrectResponse(
+        result = this.processIncorrectResponse(
           cardRecord,
           history,
           courseRegistrationDoc,
@@ -9448,6 +9449,18 @@ var ResponseProcessor = class {
           sessionViews
         );
       }
+      if (cardRecord.deferAdvance && result.shouldLoadNextCard) {
+        logger.info(
+          "[ResponseProcessor] deferAdvance requested \u2014 suppressing navigation, action stashed:",
+          { nextCardAction: result.nextCardAction }
+        );
+        result = {
+          ...result,
+          shouldLoadNextCard: false,
+          deferred: true
+        };
+      }
+      return result;
     } catch (e) {
       logger.error("[ResponseProcessor] Failed to load card history", { e, cardId });
       throw e;