@vue-skuilder/db 0.1.31 → 0.1.32-a

package/package.json

@@ -4,7 +4,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.1.31",
+  "version": "0.1.32-a",
   "description": "Database layer for vue-skuilder",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -48,7 +48,7 @@
   },
   "dependencies": {
     "@nilock2/pouchdb-authentication": "^1.0.2",
-    "@vue-skuilder/common": "0.1.31",
+    "@vue-skuilder/common": "0.1.32-a",
     "cross-fetch": "^4.1.0",
     "moment": "^2.29.4",
     "pouchdb": "^9.0.0",

package/src/study/SessionController.ts

@@ -44,6 +44,14 @@ export 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;
+
   // UI Data (let view decide how to render)
   isCorrect: boolean;
   performanceScore?: number; // for shadow color calculation

package/src/study/services/ResponseProcessor.ts

@@ -107,9 +107,11 @@ export class ResponseProcessor {
     try {
       const history = await cardHistory;
 
+      let result: ResponseResult;
+
       // Handle correct responses
       if (cardRecord.isCorrect) {
-        return this.processCorrectResponse(
+        result = this.processCorrectResponse(
           cardRecord,
           history,
           studySessionItem,
@@ -120,7 +122,7 @@ export class ResponseProcessor {
         );
       } else {
         // Handle incorrect responses
-        return this.processIncorrectResponse(
+        result = this.processIncorrectResponse(
           cardRecord,
           history,
           courseRegistrationDoc,
@@ -132,6 +134,24 @@ export class ResponseProcessor {
           sessionViews
         );
       }
+
+      // Apply deferred advancement: record is logged and ELO updated above,
+      // but we suppress navigation so the view retains control of the UI
+      // timeline. StudySession will stash the nextCardAction and wait for
+      // a `ready-to-advance` event from the view.
+      if (cardRecord.deferAdvance && result.shouldLoadNextCard) {
+        logger.info(
+          '[ResponseProcessor] deferAdvance requested — suppressing navigation, action stashed:',
+          { nextCardAction: result.nextCardAction }
+        );
+        result = {
+          ...result,
+          shouldLoadNextCard: false,
+          deferred: true,
+        };
+      }
+
+      return result;
     } catch (e: unknown) {
       logger.error('[ResponseProcessor] Failed to load card history', { e, cardId });
       throw e;