anear-js-api 0.6.4 → 0.6.5

package/lib/models/AnearEvent.js

@@ -47,6 +47,10 @@ class AnearEvent extends JsonApiResource {
     this.send("CLOSE")
   }
 
+  restartEvent() {
+    this.send("RESTART")
+  }
+
   pauseEvent(context, resumeEvent = { type: 'RESUME' }) {
     // Persist via AEM and acknowledge with PAUSED
     this.send('PAUSE', { appmContext: { context, resumeEvent } })

package/lib/state_machines/AnearEventMachine.js

@@ -133,6 +133,7 @@ const DeferredStates = [
   'ACTION',
   'CANCEL',
   'CLOSE',
+  'RESTART',
   'SAVE',
   'PAUSE'
 ]
@@ -144,6 +145,10 @@ const ActiveEventGlobalEvents = {
     // the AnearParticipantMachine has hit its final state
     actions: ['cleanupExitingParticipant']
   },
+  RESTART: {
+    // Hosted apps can request a rewind back to ANNOUNCE without terminating the event.
+    target: '#activeEvent.restartEvent'
+  },
   CLOSE: {
     // AppM has reached a final state or explicitly called closeEvent()
     // initiate orderly shutdown
@@ -702,6 +707,18 @@ const ActiveEventStatesConfig = {
         }
       }
     },
+    restartEvent: {
+      id: 'restartEvent',
+      deferred: DeferredStatesPlus('RENDER_DISPLAY'),
+      invoke: {
+        src: 'restartAndGetAttachedSpectators',
+        onDone: {
+          actions: ['sendSpectatorEnterToAppEventMachine', 'sendRestartedAckToAppMachine'],
+          target: '#waitingToStart'
+        },
+        onError: '#activeEvent.failure'
+      }
+    },
     closeEvent: {
       id: 'closeEvent',
       initial: 'notifyingParticipants',
@@ -1154,6 +1171,11 @@ const AnearEventMachineStatesConfig = eventId => ({
 
 const AnearEventMachineFunctions = ({
   actions: {
+    sendRestartedAckToAppMachine: (context, _event) => {
+      if (context.appEventMachine) {
+        context.appEventMachine.send('RESTARTED')
+      }
+    },
     sendPausedAckToAppMachine: (context, _event) => {
       if (context.appEventMachine) {
         context.appEventMachine.send('PAUSED')
@@ -1701,6 +1723,28 @@ const AnearEventMachineFunctions = ({
       const [_, members] = await Promise.all([transitionPromise, membersPromise])
       return members
     },
+    restartAndGetAttachedSpectators: async (context, _event) => {
+      // Restart is a developer-only transition that rewinds the event back to ANNOUNCE
+      // without terminating the event or detaching channels.
+      await AnearApi.transitionEvent(context.anearEvent.id, 'restart')
+
+      const publishPromise = RealtimeMessaging.publish(
+        context.eventChannel,
+        'EVENT_TRANSITION',
+        { content: { state: 'announce' } }
+      )
+
+      // If there is no spectators channel (event/app does not support spectators),
+      // just publish the transition and return an empty spectator list.
+      if (!context.spectatorsDisplayChannel) {
+        await publishPromise
+        return []
+      }
+
+      const members = await RealtimeMessaging.getPresenceOnChannel(context.spectatorsDisplayChannel)
+      await publishPromise
+      return members
+    },
     transitionToLive: (context, event) => {
       return AnearApi.transitionEvent(context.anearEvent.id, 'live')
     },

package/package.json

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