circuits

A simple socket-io framework for client and server communcation around CRUD operations

Usage

install using npm

npm install circuits

Basic client server example source

# port to listen to 
testPort = 8001
# create a server 
httpServer = http.Server()
# instantiate a Circuits server with a controller router 
server = new Server httpServer, (controller)->
    switch controller
        # match against the requested router to a specific one 
        # every router needs to implement the CRUD operation  
        # it needs to support 
        when 'echo' then {
                "read" : (message, id, cb)-> 
                    # the first argument for the callback is  
                    cb(null,message)
            }
 
 
httpServer.listen testPort
 
client = sioc.connect("http://localhost:#{testPort}")
 
client.on 'connect', ->
    client.emit Operation, 'echo', CRUD.read, 'any bats in here?',(err, data)->
        if (data == 'any bats in here?')
            console.log 'No bats here I guess..'
            process.exit()

ToDo: Example using Circuits with a Backbone model Example using Circuits with a Backbone collection Example using Circuits with Express framework

Whats in the box?

create Circuits server instance

new circuits.Server( httpServer, controllerResolver, [acl, redisHost, redisDB, redis, redisPort, circuitChannel] )

• httpServer instance of require('http').Server
• controllerResolver function that returns an object with mapping to CRUD operation for provided controller name
• acl the ACL object, if none provided it allowes everything
• redisHost IP address of your redis (default is "127.0.0.1")
• redisDB redis db to use (default is 10 )
• redisPort redis port (deault is 6379)
• circuitChannel name space for communication between Circuits instances

messages

circuits.Messages is a map of String => String of supported Circuits messages

the Operation message is a request for a message to be dispatched to respective controller on the server

arguments

required operation params for the different CRUD operations

CRUD.create

CRUD.read

CRUD.update

CRUD.delete

CRUD operations

circuits.CRUD

is simply a map of String => String of
create, read,update, delete and patch

ACL

circuits.ACL constructor arguments

example of a controller+crud group rules

{
    "MyModel" : {
        "create" : ["public"],
        "read" : ["public"],
        "update" : ["users"],
        "delete" : []
    },
    "SecretModel" : {
        "create" : ["users"],
        "read" : ["users"],
        "update" : ["users"],
        "delete" : ["users"]
    }
}

is simply an object mapping controllers to respective allowed crud operations

High Level Design