bare-rpc 1.0.0 → 1.1.0

package/index.d.ts

@@ -23,6 +23,16 @@ declare const constants: {
   }
 }
 
+interface RPCIncomingEvent {
+  readonly rpc: RPC
+  readonly command: number
+  readonly data: Buffer | null
+}
+
+declare class RPCIncomingEvent {
+  constructor(rpc: RPC, command: number, data: Buffer)
+}
+
 interface RPCIncomingRequest {
   readonly rpc: RPC
   readonly id: number
@@ -41,6 +51,18 @@ declare class RPCIncomingRequest {
   constructor(rpc: RPC, id: number, command: number, data: Buffer)
 }
 
+interface RPCOutgoingEvent {
+  readonly rpc: RPC
+  readonly command: number
+  readonly sent: boolean
+
+  send(data?: Buffer | string | null, encoding?: BufferEncoding): void
+}
+
+declare class RPCOutgoingEvent {
+  constructor(rpc: RPC, command: number)
+}
+
 interface RPCOutgoingRequest {
   readonly rpc: RPC
   readonly id: number
@@ -57,7 +79,7 @@ interface RPCOutgoingRequest {
 }
 
 declare class RPCOutgoingRequest {
-  constructor(rpc: RPC, command: number)
+  constructor(rpc: RPC, id: number, command: number)
 }
 
 declare class RPCIncomingStream extends Readable {
@@ -79,6 +101,7 @@ declare class RPCOutgoingStream extends Writable {
 }
 
 interface RPC {
+  event(command: number): RPCOutgoingEvent
   request(command: number): RPCOutgoingRequest
 }
 
@@ -91,6 +114,8 @@ declare class RPC {
 
 declare namespace RPC {
   export {
+    type RPCIncomingEvent as IncomingEvent,
+    type RPCOutgoingEvent as OutgoingEvent,
     type RPCIncomingRequest as IncomingRequest,
     type RPCOutgoingRequest as OutgoingRequest,
     type RPCIncomingStream as IncomingStream,

package/index.js

@@ -3,8 +3,10 @@ const b4a = require('b4a')
 const c = require('compact-encoding')
 const m = require('./lib/messages')
 const { type: t, stream: s } = require('./lib/constants')
+const IncomingEvent = require('./lib/incoming-event')
 const IncomingRequest = require('./lib/incoming-request')
 const IncomingStream = require('./lib/incoming-stream')
+const OutgoingEvent = require('./lib/outgoing-event')
 const OutgoingRequest = require('./lib/outgoing-request')
 const OutgoingStream = require('./lib/outgoing-stream')
 const CommandRouter = require('./lib/command-router')
@@ -43,6 +45,10 @@ module.exports = exports = class RPC {
       .on('drain', this._ondrain)
   }
 
+  event(command) {
+    return new OutgoingEvent(this, command)
+  }
+
   request(command) {
     return new OutgoingRequest(this, ++this._id, command)
   }
@@ -60,6 +66,16 @@ module.exports = exports = class RPC {
     }
   }
 
+  _sendEvent(request, data = null) {
+    this._sendMessage({
+      type: t.REQUEST,
+      id: 0,
+      command: request.command,
+      stream: 0,
+      data
+    })
+  }
+
   _sendRequest(request, data = null) {
     this._outgoingRequests.set(request.id, request)
 
@@ -201,19 +217,23 @@ module.exports = exports = class RPC {
 
     switch (message.type) {
       case t.REQUEST:
-        const request = new IncomingRequest(
-          this,
-          message.id,
-          message.command,
-          message.data
-        )
+        const request =
+          message.id === 0
+            ? new IncomingEvent(this, message.command, message.data)
+            : new IncomingRequest(
+                this,
+                message.id,
+                message.command,
+                message.data
+              )
 
         try {
           await this._onrequest(request)
         } catch (err) {
           safetyCatch(err)
 
-          this._sendError(request, err)
+          if (message.id) this._sendError(request, err)
+          else this._stream.destroy(err)
         }
         break
       case t.RESPONSE:

package/lib/incoming-event.js

@@ -0,0 +1,7 @@
+module.exports = class RPCIncomingEvent {
+  constructor(rpc, command, data) {
+    this.rpc = rpc
+    this.command = command
+    this.data = data
+  }
+}

package/lib/outgoing-event.js

@@ -0,0 +1,27 @@
+const c = require('compact-encoding')
+const errors = require('./errors')
+
+module.exports = class RPCOutgoingEvent {
+  constructor(rpc, command) {
+    this.rpc = rpc
+    this.command = command
+    this.sent = false
+  }
+
+  send(data, encoding) {
+    if (this.sent) {
+      throw errors.ALREADY_SENT('Event has already been sent')
+    }
+
+    encoding =
+      encoding && encoding !== 'buffer'
+        ? c.from(encoding)
+        : typeof data === 'string'
+          ? c.raw.utf8
+          : null
+
+    this.sent = true
+
+    this.rpc._sendEvent(this, encoding ? c.encode(encoding, data) : data)
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bare-rpc",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "librpc ABI compatible RPC for Bare",
   "exports": {
     ".": {