@knowlearning/agents 0.9.83 → 0.9.85

package/agents/browser/root.js

@@ -18,7 +18,7 @@ export default options => {
     this.close = () => ws.close()
 
     ws.onopen = () => this.onopen()
-    ws.onmessage = ({ data }) => this.onmessage(data)
+    ws.onmessage = ({ data }) => this.onmessage(data.length === 0 ? null : JSON.parse(data))
     ws.onerror = error => this.onerror && this.onerror(error)
     ws.onclose = error => this.onclose && this.onclose(error)
 

package/agents/generic/index.js

@@ -13,7 +13,7 @@ const POSTGRES_QUERY_TYPE = 'application/json;type=postgres-query'
 const TAG_TYPE = 'application/json;type=tag'
 const DOMAIN_CLAIM_TYPE = 'application/json;type=domain-claim'
 
-export default function Agent({ Connection, token, uuid, fetch, applyPatch, login, logout, reboot }) {
+export default function Agent({ Connection, token, uuid, fetch, applyPatch, login, logout, reboot, handleDomainInteraction }) {
   const states = {}
   const watchers = {}
   const keyToSubscriptionId = {}
@@ -29,7 +29,7 @@ export default function Agent({ Connection, token, uuid, fetch, applyPatch, logi
     reconnect,
     synced,
     environment
-  ] = messageQueue({ token, Connection, watchers, states, applyPatch, log, login, interact, reboot })
+  ] = messageQueue({ token, Connection, watchers, states, applyPatch, log, login, interact, reboot, trigger })
 
   // initialize session
   environment()
@@ -216,6 +216,17 @@ export default function Agent({ Connection, token, uuid, fetch, applyPatch, logi
     })
   }
 
+  const reactions = { child: [] }
+
+  function on(event, reaction) {
+    if (!reactions[event]) throw new Error('Agent can only listen to events of "child"')
+    reactions[event].push(reaction)
+  }
+
+  function trigger(event, data) {
+    reactions[event].forEach(f => f(data))
+  }
+
   return {
     uuid,
     environment,
@@ -235,6 +246,7 @@ export default function Agent({ Connection, token, uuid, fetch, applyPatch, logi
     disconnect,
     reconnect,
     tag,
-    debug
+    debug,
+    on
   }
 }

package/agents/generic/message-queue.js

@@ -1,6 +1,7 @@
 import { validate as isUUID } from 'uuid'
 
 const HEARTBEAT_TIMEOUT = 10000
+const DOMAIN_MESSAGES = { open: true, mutate: true, close: true }
 
 //  transform our custom path implementation to the standard JSONPatch path
 function standardJSONPatch(patch) {
@@ -14,7 +15,7 @@ function sanitizeJSONPatchPathSegment(s) {
   else return s
 }
 
-export default function messageQueue({ token, Connection, watchers, states, applyPatch, log, login, reboot }) {
+export default function messageQueue({ token, Connection, watchers, states, applyPatch, log, login, reboot, handleDomainMessage, trigger }) {
   let connection
   let user
   let authed = false
@@ -124,13 +125,12 @@ export default function messageQueue({ token, Connection, watchers, states, appl
       connection.send({ token: await token(), session })
     }
 
-    connection.onmessage = async data => {
+    connection.onmessage = async message => {
       checkHeartbeat()
-      if (data.length === 0) return // heartbeat
+      if (!message) return // heartbeat
 
       try {
         log('handling message', disconnected, authed)
-        const message = JSON.parse(data)
         log('message', JSON.stringify(message))
 
         if (message.error) console.warn('ERROR RESPONSE', message)
@@ -160,7 +160,10 @@ export default function messageQueue({ token, Connection, watchers, states, appl
           flushMessageQueue()
         }
         else {
-          if (message.si !== undefined) {
+          if (DOMAIN_MESSAGES[message.type]) {
+            handleDomainMessage && handleDomainMessage(message, trigger)
+          }
+          else if (message.si !== undefined) {
             if (responses[message.si]) {
               //  TODO: remove "acknowledged" messages from queue and do accounting with si
               responses[message.si]

package/deno.js

@@ -18,11 +18,43 @@ function Connection() {
   return thisConnection
 }
 
-export default new Agent({
+const children = {}
+const listeners = {}
+
+const agent new Agent({
   Connection,
   token: () => AGENT_TOKEN,
   uuid: () => crypto.randomUUID(),
   fetch,
   applyPatch: fastJSONPatch.applyPatch,
-  reboot: () => Deno.exit(1)
+  reboot: () => Deno.exit(1),
+  handleDomainMessage: ({ type, session, data }, trigger) => {
+    //  this functionality is only implemented for the deno
+    //  agent for now, but this central management of children
+    //  concept probably has a place in the generic agent
+    if (type === 'open') {
+      const child = {
+        on: (eventType, reaction) => {
+          if (!listeners[session]) throw new Error('Error attaching listener, child is closed')
+          if (!listeners[session][eventType]) throw new Error('Only "mutate" and "close" events can be listened to with Agent.on')
+          listeners[session][eventType].push(reaction)
+        }
+      }
+      listeners[session] = { mutate: [], close: [] }
+      children[session] = child
+      trigger('child', child)
+    }
+    else if (type === 'mutate') {
+      listeners[session].mutate.forEach(f => f(data))
+      delete listeners[session]
+      delete children[session]
+    }
+    else if (type === 'close') {
+      listeners[session].close.forEach(f => f(data))
+      delete listeners[session]
+      delete children[session]
+    }
+  }
 })
+
+export default agent

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowlearning/agents",
-  "version": "0.9.83",
+  "version": "0.9.85",
   "description": "API for embedding applications in KnowLearning systems.",
   "main": "node.js",
   "browser": "browser.js",