@doenet/v06-to-v07 0.7.20-dev.321 → 0.7.20-dev.324

package/{index-D7QB7nkv.js → index-Bf9-6Dgz.js}

@@ -40963,7 +40963,7 @@ async function cidFromArrayBuffer(data) {
       await crypto.subtle.digest("SHA-256", new Uint8Array());
       digest = (data2) => crypto.subtle.digest("SHA-256", data2);
     } catch (e22) {
-      const sha256 = (await import("./sha256-C0vj3HDn-BWgi3hyU-CUhpeiV-.js").then((n2) => n2.s)).default;
+      const sha256 = (await import("./sha256-C0vj3HDn-BqmkOZ2t-j7M8ytAj.js").then((n2) => n2.s)).default;
       digest = (data2) => sha256(data2, {
         asBytes: true
       });
@@ -64640,13 +64640,14 @@ class StatePersistence {
       await this.saveChangesToDatabase(true);
     }
   }
-  async saveState(overrideThrottle = false, onSubmission = false) {
-    this.saveDocStateTimeoutID = null;
+  /**
+   * Build the serialized document-state payload — the shape
+   * `reportScoreAndState` delivers to hosts and `DocViewer`'s
+   * `initialState` accepts back.
+   */
+  buildDocStatePayload(onSubmission = false) {
     const core2 = this.core;
-    if (!core2.flags.allowSaveState && !core2.flags.allowLocalState) {
-      return;
-    }
-    let coreStateString = JSON.stringify(
+    const coreStateString = JSON.stringify(
       core2.cumulativeStateVariableChanges,
       serializedComponentsReplacer
     );
@@ -64657,6 +64658,29 @@ class StatePersistence {
         serializedComponentsReplacer
       );
     }
+    return {
+      payload: {
+        cid: core2.cid,
+        coreInfo: core2.coreInfoString,
+        coreState: coreStateString,
+        rendererState: rendererStateString,
+        initializeCounters: core2.initializeCounters,
+        docId: core2.docId,
+        attemptNumber: core2.attemptNumber,
+        activityId: core2.activityId,
+        onSubmission
+      },
+      coreStateString,
+      rendererStateString
+    };
+  }
+  async saveState(overrideThrottle = false, onSubmission = false) {
+    this.saveDocStateTimeoutID = null;
+    const core2 = this.core;
+    if (!core2.flags.allowSaveState && !core2.flags.allowLocalState) {
+      return;
+    }
+    const { payload, coreStateString, rendererStateString } = this.buildDocStatePayload(onSubmission);
     if (core2.flags.allowLocalState) {
       await set(
         `${core2.activityId}|${core2.docId}|${core2.attemptNumber}|${core2.cid}`,
@@ -64671,20 +64695,30 @@ class StatePersistence {
     if (!core2.flags.allowSaveState) {
       return;
     }
-    this.docStateToBeSavedToDatabase = {
-      cid: core2.cid,
-      coreInfo: core2.coreInfoString,
-      coreState: coreStateString,
-      rendererState: rendererStateString,
-      initializeCounters: core2.initializeCounters,
-      docId: core2.docId,
-      attemptNumber: core2.attemptNumber,
-      activityId: core2.activityId,
-      onSubmission
-    };
+    this.docStateToBeSavedToDatabase = payload;
     this.changesToBeSaved = true;
     await this.saveChangesToDatabase(overrideThrottle);
   }
+  /**
+   * Flush-state-on-demand (Doenet/DoenetML#1440): push any pending changes
+   * through the normal `reportScoreAndState` pipeline (via `saveImmediately`)
+   * so a persistence host saves them right away — exactly as it does for a
+   * routine autosave, with no knowledge that a flush occurred. Reports honor
+   * the `allowSaveState`/`allowLocalState` flags, so nothing is emitted when
+   * saving is off (there is no persistence host to receive it).
+   *
+   * Returns whether this viewer held any state: `false` before document
+   * generation has produced `coreInfoString` (the viewer holds nothing
+   * beyond what it was initialized with, so tearing it down loses nothing
+   * either way).
+   */
+  async flushState() {
+    if (!this.core.coreInfoString) {
+      return false;
+    }
+    await this.saveImmediately();
+    return true;
+  }
   async saveChangesToDatabase(overrideThrottle = false) {
     if (!this.changesToBeSaved) {
       return;
@@ -68191,6 +68225,26 @@ class Core {
   async saveImmediately() {
     return this.statePersistence.saveImmediately();
   }
+  /**
+   * Flush-state-on-demand (Doenet/DoenetML#1440): wait briefly for
+   * in-flight action processing to settle (the same bounded wait
+   * `terminate` uses), then push any pending state through the normal
+   * `reportScoreAndState` pipeline so a persistence host saves it. Returns
+   * whether the viewer held any state. Hosts use this to unmount the
+   * document losslessly.
+   */
+  async flushState() {
+    if (this.processQueue.processing) {
+      const pause100 = () => new Promise((resolve) => setTimeout(resolve, 100));
+      for (let i2 = 0; i2 < 10; i2++) {
+        await pause100();
+        if (!this.processQueue.processing) {
+          break;
+        }
+      }
+    }
+    return this.statePersistence.flushState();
+  }
   async saveState(overrideThrottle = false, onSubmission = false) {
     return this.statePersistence.saveState(overrideThrottle, onSubmission);
   }
@@ -227406,6 +227460,16 @@ let PublicDoenetMLCore$1 = class PublicDoenetMLCore2 {
   async saveImmediately() {
     await this.core?.saveImmediately();
   }
+  /**
+   * Flush-state-on-demand (Doenet/DoenetML#1440): after letting in-flight
+   * updates settle, push any pending state through the normal
+   * `reportScoreAndState` pipeline so a persistence host saves it, letting a
+   * host unmount this document losslessly. Returns whether the viewer held
+   * any state (`false` when the core/document has not been created yet).
+   */
+  async flushState() {
+    return await this.core?.flushState() ?? false;
+  }
 };
 const AFFECTED_ATTRIBUTES = [
   "target",
@@ -229299,4 +229363,4 @@ export {
   getDefaultExportFromCjs as g,
   updateSyntaxFromV06toV07 as u
 };
-//# sourceMappingURL=index-D7QB7nkv.js.map
+//# sourceMappingURL=index-Bf9-6Dgz.js.map