anear-js-api 1.4.2 → 1.4.3

package/lib/models/AnearEvent.js

@@ -79,6 +79,19 @@ class AnearEvent extends JsonApiResource {
     this.send({ type: "CLOSE" })
   }
 
+  /**
+   * Close the event AND persist the AppM context to ANAPI (app_event_context) as part of shutdown.
+   *
+   * This is intended for "normal close" flows where we want the final AppM context saved
+   * (e.g. for cloning/resume/debugging).
+   *
+   * @param {Object} context - AppM context to persist
+   * @param {Object} resumeEvent - event to send to AppM if this context is later rehydrated and resumed
+   */
+  closeEventWithContext(context, resumeEvent = { type: 'RESUME' }) {
+    this.send({ type: 'CLOSE', appmContext: { context, resumeEvent } })
+  }
+
   restartEvent() {
     this.send({ type: "RESTART" })
   }

package/lib/state_machines/AnearEventMachine.js

@@ -902,13 +902,38 @@ const ActiveEventStatesConfig = {
     closeEvent: {
       id: 'closeEvent',
       entry: ({ context }) => logger.info(`[AEM] Event ${context.anearEvent.id} live → closed`),
-      initial: 'notifyingParticipants',
+      initial: 'savingContextMaybe',
       on: {
         APPM_FINAL: {
           actions: () => logger.debug('[AEM] Ignoring APPM_FINAL during closeEvent.')
         }
       },
       states: {
+        savingContextMaybe: {
+          always: [
+            {
+              guard: ({ event }) => {
+                const c = event?.appmContext?.context
+                return !!(c && typeof c === 'object')
+              },
+              target: 'savingAppEventContext'
+            },
+            { target: 'notifyingParticipants' }
+          ]
+        },
+        savingAppEventContext: {
+          invoke: {
+            src: 'saveAppEventContext',
+            input: ({ context, event }) => ({ context, event }),
+            onDone: {
+              target: 'notifyingParticipants'
+            },
+            onError: {
+              // If save fails, continue closing anyway (best-effort persistence).
+              target: 'notifyingParticipants'
+            }
+          }
+        },
         notifyingParticipants: {
           entry: 'sendParticipantExitEvents',
           always: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "anear-js-api",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "Javascript Developer API for Anear Apps",
   "main": "lib/index.js",
   "scripts": {