statebus 7.0.3 → 7.0.6

package/{servers.js → server-library.js}

@@ -37,7 +37,7 @@ function set_options (bus, options) {
         }
 }
 
-function import_server (bus, options)
+function import_server (bus, make_statebus, options)
 {   var extra_methods = {
 
     serve: function serve (options) {
@@ -76,23 +76,6 @@ function import_server (bus, options)
         try { bus.http.use(require('compression')())
               console.log('Enabled http compression!') } catch (e) {}
 
-
-        // Initialize new clients with an id.  We put the client id on
-        // req.client, and also in a cookie for the browser to see.
-        if (bus.options.client)
-            bus.express.use(function (req, res, next) {
-                req.client = require('cookie').parse(req.headers.cookie || '').client
-                if (!req.client) {
-                    req.client = (Math.random().toString(36).substring(2)
-                                  + Math.random().toString(36).substring(2)
-                                  + Math.random().toString(36).substring(2))
-            
-                    res.setHeader('Set-Cookie', 'client=' + req.client
-                                  + '; Expires=21 Oct 2025 00:0:00 GMT;')
-                }
-                next()
-            })
-
         // Initialize file sync
         ; (bus.options.sync_files || []).forEach( x => {
             if (require('fs').existsSync(x.fs_path || x.state_path))
@@ -122,17 +105,17 @@ function import_server (bus, options)
             // Now handle backup handlers
             if (count === 0) {
 
-                // A set to master without a to_set defined should be
+                // A set to master without a setter defined should be
                 // automatically reflected to all clients.
-                if (method === 'to_set') {
+                if (method === 'setter') {
                     bus.set.fire(arg, t)
                     bus.route(arg.key, 'on_set_sync', arg, t)
                     count++
                 }
 
-                // A get to master without a to_get defined should go to
+                // A get to master without a getter defined should go to
                 // the database, if we have one.
-                if (method === 'to_get') {
+                if (method === 'getter') {
                     bus.db_get(key)
                     // This basically renders the count useless-- you probably
                     // don't want to wrap this route() with another route().
@@ -165,33 +148,40 @@ function import_server (bus, options)
             || req.method === 'OPTIONS')
             free_the_cors(req, res)
 
+        // Initialize new clients with an id.  We put the client id on
+        // req.client, and also in a cookie for the browser to see.
+        req.peer = //req.headers.peer ||
+            require('cookie').parse(req.headers.cookie || '').peer
+        if (!req.peer) {
+            req.peer = (Math.random().toString(36).substring(2)
+                        + Math.random().toString(36).substring(2)
+                        + Math.random().toString(36).substring(2))
+
+            res.setHeader('Set-Cookie', 'peer=' + req.peer
+                          + '; Expires=21 Oct 2055 00:0:00 GMT;')
+        }
+
+        // Handle the GET or PUT request!
         if (req.method === 'GET') {
+            var key = req.path.substr(1)
 
             // Make a temporary client bus
             var cbus = bus.bus_for_http_client(req, res)
-            var cb
-            function end_it_all () {
-                cbus.forget(key, cb)
-                cbus.delete_bus()
-                res.end()
-            }
 
             braidify(req, res)
             if (req.subscribe)
-                res.startSubscription({ onClose: end_it_all })
+                res.startSubscription({ onClose: end_subscription })
             else
                 res.statusCode = 200
 
             // We only return JSON
             res.setHeader('Content-Type', 'application/json')
 
-            // Do the get
-            // cbus.honk = 'statelog'
-            var key = req.path.substr(1)
-            cbus.get(key, cb = (o) => {
-                var body = to_http_body(o)
+            // console.log('http_in: doing cbus.get(', key, ')')
 
-                // If we're braiding, send via subscription
+            var send_to_client = (o, t) => {
+                // console.trace('http_in: Sending update of', key)
+                var body = to_http_body(o)
 
                 // Note: if body === undefined, we need to send the
                 // equivalent of a 404.  This is missing in braid spec:
@@ -200,14 +190,35 @@ function import_server (bus, options)
 
                 // And shut down the connection if there's no subscription
                 if (!req.subscribe)
-                    end_it_all()
-            })
+                    end_subscription()
+            }
+
+            function end_subscription () {
+                cbus.forget(key, send_to_client)
+                res.end()
+                cbus.http_unsubscribe(req)
+
+                let peer = req.headers.peer
+                if (cbus.http_callbacks)
+                    delete cbus.http_callbacks[JSON.stringify({peer, key})]
+            }
+
+            // If we have a peer id, then register this callback at that peer,
+            // so it can avoid getting its own PUT versions echoed back to
+            // itself.
+            if (req.headers.peer) {
+                if (!cbus.http_callbacks)
+                    cbus.http_callbacks = {}
+                let peer = req.headers.peer
+                cbus.http_callbacks[JSON.stringify({peer, key})]
+                    = send_to_client
+            }
+
+            // And issue the get!
+            cbus.get(key, send_to_client)
         }
 
         else if (req.method === 'PUT') {
-            // Make a temporary client bus
-            var cbus = bus.bus_for_http_client(req, res)
-
             // Maybe the new state is expressed in patches
             if (req.headers.patches) {
                 console.error("We don't actually handle PUT patches yet")
@@ -234,9 +245,31 @@ function import_server (bus, options)
                         res.end()
                         return
                     }
-                    cbus.set(obj)
+
+                    // Make a temporary client bus
+                    var cbus = bus.bus_for_http_client(req, res)
+                    var t = {
+                        version: req.version || cbus.new_version(),
+                        parents: req.parents
+                    }
+
+                    // If the peer declares itself, let's remember it so that
+                    // we don't send it echoes
+                    if (req.headers.peer) {
+                        let peer = req.headers.peer,
+                            key = obj.key
+                        var cb = cbus.http_callbacks[
+                            JSON.stringify({peer, key})
+                        ]
+                        if (cb) cb.has_seen(cbus, key, t.version)
+                    }
+
+                    // Now send the version to the bus!
+                    cbus.set(obj, t)
+
                     res.statusCode = 200
                     res.end()
+                    cbus.http_unsubscribe(req)
                 })
             }
         }
@@ -246,16 +279,39 @@ function import_server (bus, options)
 
     bus_for_http_client: function (req, res) {
         var bus = this
-        if (!bus.bus_for_http_client.counter)
+        if (!bus.bus_for_http_client.counter) {
             bus.bus_for_http_client.counter = 0
-        var cbus = require('./statebus')()
+            bus.bus_for_http_client.busses = {}
+        }
+
+        // If this client has a peer ID, and we've got a bus for that peer,
+        // then re-use it!
+        if (req.peer && bus.bus_for_http_client.busses[req.peer]) {
+            var cbus = bus.bus_for_http_client.busses[req.peer]
+            cbus.client_ip = req.connection.remoteAddress
+            cbus.num_subscriptions++
+            return cbus
+        }
+
+        // Otherwise, create a new bus
+        var cbus = make_statebus()
         cbus.label = 'client_http' + bus.bus_for_http_client.counter++
         cbus.master = bus
+        cbus.num_subscriptions = 1
+        cbus.http_unsubscribe = (req) => {
+            cbus.num_subscriptions--
+            if (cbus.num_subscriptions === 0) {
+                // log('Last subscription! Killing client bus!')
+                cbus.delete_bus()
+                delete bus.bus_for_http_client.busses[req.peer]
+            }
+        }
+        bus.bus_for_http_client.busses[req.peer] = cbus
 
-        // Log in as the client
+        // And log into it as the client
         cbus.serves_auth({remoteAddress: req.connection.remoteAddress}, bus)
         bus.options.client(cbus)
-        cbus.set({key: 'current_user', client: req.client})
+        cbus.set({key: 'current_user', val: {client: req.peer}})
         return cbus
     },
 
@@ -358,7 +414,7 @@ function import_server (bus, options)
         // var client_busses = {}  // XXX work in progress
         var log = master.log
         if (client_bus_func) {
-            master.set({key: 'connections'}) // Clean out old sessions
+            master.set({key: 'connections', val: {}}) // Clean out old sessions
             var connections = master.get('connections')
         }
         var s = require('sockjs').createServer({
@@ -376,11 +432,11 @@ function import_server (bus, options)
                 //  - When disconnecting, decrement the number, and if it gets
                 //    to zero, delete the client bus.
 
-                connections[conn.id] = {client: conn.id, // client is deprecated
-                                        id: conn.id}
+                connections.val[conn.id] = {client: conn.id, // client is deprecated
+                                            id: conn.id}
                 master.set(connections)
 
-                var client = require('./statebus')()
+                var client = make_statebus()
                 client.label = 'client' + client_num++
                 master.label = master.label || 'master'
                 client.master = master
@@ -489,7 +545,7 @@ function import_server (bus, options)
                 for (var key in our_gets_in)
                     client.forget(key, sockjs_pubber)
                 if (client_bus_func) {
-                    delete connections[conn.id]; master.set(connections)
+                    delete connections.val[conn.id]; master.set(connections)
                     master.delete('connection/' + conn.id)
                     client.delete_bus()
                 }
@@ -499,7 +555,7 @@ function import_server (bus, options)
             if (client_bus_func && !master.options.__secure) {
 
                 // A connection
-                client('connection/*').to_get = function (key, star) {
+                client('connection/*').getter = function (key, star) {
                     var result = bus.clone(master.get(key))
                     if (master.options.connections.include_users && result.user)
                         result.user = client.get(result.user.key)
@@ -507,7 +563,7 @@ function import_server (bus, options)
                     result.client = star  // Deprecated.  Delete this line in v7.
                     return result
                 }
-                client('connection/*').to_set = function (o, star, t) {
+                client('connection/*').setter = function (o, star, t) {
                     // Check permissions before editing
                     if (star !== conn.id && !master.options.connections.edit_others) {
                         t.abort()
@@ -519,7 +575,7 @@ function import_server (bus, options)
                 }
 
                 // Your connection
-                client('connection').to_get = function () {
+                client('connection').getter = function () {
                     // subscribe to changes in authentication
                     client.get('current_user')
 
@@ -527,22 +583,22 @@ function import_server (bus, options)
                     delete result.key
                     return result
                 }
-                client('connection').to_set = function (o) {
+                client('connection').setter = function (o) {
                     o = client.clone(o)
                     o.key = 'connection/' + conn.id
                     client.set(o)
                 }
 
                 // All connections
-                client('connections').to_set = function noop (t) {t.abort()}
-                client('connections').to_get = function () {
+                client('connections').setter = function noop (t) {t.abort()}
+                client('connections').getter = function () {
                     var result = []
-                    var conns = master.get('connections')
+                    var conns = master.get('connections').val
                     for (var connid in conns)
                         if (connid !== 'key')
                             result.push(client.get('connection/' + connid))
                     
-                    return {all: result}
+                    return {val: result}
                 }
             }
         })
@@ -558,13 +614,6 @@ function import_server (bus, options)
         WebSocket = require('websocket').w3cwebsocket
         return new WebSocket(url + '/' + bus.options.websocket_path + '/websocket')
     },
-    client_creds: function client_creds (server_url) {
-        // Right now the server just creates a different random id each time
-        // it connects.
-        return {clientid: (Math.random().toString(36).substring(2)
-                           + Math.random().toString(36).substring(2)
-                           + Math.random().toString(36).substring(2))}
-    },
 
     file_store: (function () {
         // Make a database
@@ -646,7 +695,7 @@ function import_server (bus, options)
             }
             on_set.priority = true
             bus(prefix).on_set = on_set
-            bus(prefix).to_delete = function (key) {
+            bus(prefix).deleter = function (key) {
                 delete db[key]
                 if (active) save_later()
             }
@@ -712,7 +761,7 @@ function import_server (bus, options)
             return decodeURIComponent(k.replace('%2E', '.'))
         }
 
-        bus(prefix).to_get = function (key, t) {
+        bus(prefix).getter = function (key, t) {
             firebase_ref.child(encode_firebase_key(key)).on('value', function (x) {
                 t.done(x.val() || {})
             }, function (err) { t.abort() })
@@ -722,19 +771,19 @@ function import_server (bus, options)
             firebase_ref.child(encode_firebase_key(o.key)).set(o)
         }
 
-        // bus(prefix).to_set = function (o, t) {
+        // bus(prefix).setter = function (o, t) {
         //     firebase_ref.child(encode_firebase_key(o.key)).set(o, (err) => {
         //         err ? t.abort() : t.done()
         //     })
         // }
 
-        bus(prefix).to_delete = function (key, t) {
+        bus(prefix).deleter = function (key, t) {
             firebase_ref.child(encode_firebase_key(key)).set(null, (err) => {
                 err ? t.abort() : t.done()
             })
         }
 
-        bus(prefix).to_forget = function (key, t) {
+        bus(prefix).forgetter = function (key, t) {
             firebase_ref.child(encode_firebase_key(key)).off()
         }
     },
@@ -826,7 +875,7 @@ function import_server (bus, options)
                                                 : o))
 
                 // Publish this to the bus
-                bus.set.fire(obj, {to_get: true})
+                bus.set.fire(obj, {getter: true})
             })
         }
 
@@ -855,13 +904,13 @@ function import_server (bus, options)
         if (opts.set_sync) {
             var old_route = bus.route
             bus.route = function (key, method, arg, t) {
-                if (method === 'to_set') on_set(arg)
+                if (method === 'setter') on_set(arg)
                 return old_route(key, method, arg, t)
             }
         } else
             bus(prefix).on_set_sync = on_set
 
-        bus(prefix).to_delete = function (key) {
+        bus(prefix).deleter = function (key) {
             if (opts.use_transactions && !open_transaction){
                 console.time('save db')
                 db.prepare('BEGIN TRANSACTION').run()
@@ -959,7 +1008,7 @@ function import_server (bus, options)
         }
         pg_set.priority = true
         bus(opts.prefix).on_set = pg_set
-        bus(opts.prefix).to_delete = function (key) {
+        bus(opts.prefix).deleter = function (key) {
             db.query('delete from store where key = $1', [key])
         }
 
@@ -1019,7 +1068,7 @@ function import_server (bus, options)
         bus.usage_log_nots = nots
 
         // Aggregate all accesses by day, to get daily active users
-        bus('usage').to_get = () => {
+        bus('usage').getter = () => {
             bus.get('time/' + refresh_interval)
             var days = []
             var last_day
@@ -1058,7 +1107,7 @@ function import_server (bus, options)
             return {_: days}
         }
 
-        bus('recent_hits/*').to_get = (rest) => {
+        bus('recent_hits/*').getter = (rest) => {
             bus.get('time/' + refresh_interval)
             var result = []
             for (var row of db.prepare('select * from usage where '
@@ -1074,7 +1123,7 @@ function import_server (bus, options)
             return {_: result}
         }
 
-        bus('recent_referers/*').to_get = (rest) => {
+        bus('recent_referers/*').getter = (rest) => {
             bus.get('time/' + refresh_interval)
             var result = []
             for (var row of db.prepare('select * from usage where '
@@ -1123,7 +1172,7 @@ function import_server (bus, options)
             return times
         }
 
-        bus('socket_load_times').to_get = () => {
+        bus('socket_load_times').getter = () => {
             return {_: sock_open_times()}
         }
     },
@@ -1135,21 +1184,21 @@ function import_server (bus, options)
     },
 
     time () {
-        if (bus('time*').to_get.length > 0)
+        if (bus('time*').getter.length > 0)
             // Then it's already installed
             return
 
         // Time ticker
         var timeouts = {}
         bus('time*', {
-            to_get: (key, rest, t) => {
+            getter: (key, rest, t) => {
                 if (key === 'time') rest = '/1000'
                 timeout = parseInt(rest.substr(1))
                 function f () { bus.set.fire({key: key, val: Date.now()}) }
                 timeouts[key] = setInterval(f, timeout)
                 f()
             },
-            to_forget: (key, rest) => {
+            forgetter: (key, rest) => {
                 if (key === 'time') key = 'time/1000'
                 clearTimeout(timeouts[key])
             }
@@ -1220,8 +1269,8 @@ function import_server (bus, options)
         //  - Is there security hole if users have a ? or a / in their name?
         //  - Make the master.posts/ state not require /
         //  - Make standard url tools for optional slashes, and ? query params
-        //  - Should a e.g. client to_set abort if it calls set that aborts?
-        //    - e.g. if master('posts*').to_set aborts
+        //  - Should a e.g. client setter abort if it calls set that aborts?
+        //    - e.g. if master('posts*').setter aborts
 
         // Helpers
         function get_posts (args) {
@@ -1276,15 +1325,15 @@ function import_server (bus, options)
         // }
 
         // Define state on master
-        if (master('posts_for/*').to_get.length === 0) {
+        if (master('posts_for/*').getter.length === 0) {
             // Get posts for each user
-            master('posts_for/*').to_get = (json) => {
+            master('posts_for/*').getter = (json) => {
                 watch_for_dirt('posts-for/' + json.for)
                 return {_: get_posts(json)}
             }
             // Saving any post will dirty the list for all users mentioned in
             // the post
-            master('post/*').to_set = (old, New, t) => {
+            master('post/*').setter = (old, New, t) => {
                 // To do: diff the cc, to, and from lists, and only dirty
                 // posts_for people who have been changed
 
@@ -1310,40 +1359,40 @@ function import_server (bus, options)
         }
 
         function user_addy (u) {
+            console.error('fix this! not ported to v7 links')
             return u.name + '@' + opts.domain
         }
         function current_addy () {
             var c = client.get('current_user')
-            return c.logged_in ? user_addy(c.user) : 'public'
+            console.error('fix this! not ported to v7 links')
+            return c.val.logged_in ? user_addy(c.val.user) : 'public'
         }
         function is_author (post) {
             var from = post._.from
-            var c = client.get('current_user')
             return from.includes(current_addy())
         }
         function can_see (post) {
-            var c = client.get('current_user')
+            console.error('fix this! not ported to v7')
             var allowed = post._.to.concat(post._.cc).concat(post._.from)
             return allowed.includes(current_addy()) || allowed.includes('public')
         }
-        var drtbus = master//require('./statebus')()
+        var drtbus = master//make_statebus()
         function dirty (key) { drtbus.set({key: 'dirty-'+key, n: Math.random()}) }
         function watch_for_dirt (key) { drtbus.get('dirty-'+key) }
 
-        client('current_email').to_get = () => {
+        client('current_email').getter = () => {
             return {_: current_addy()}
         }
 
         // Define state on client
-        client('posts*').to_get = (k, rest) => {
+        client('posts*').getter = (k, rest) => {
             var args = bus.parse(rest.substr(1))
-            var c = client.get('current_user')
             args.for = current_addy()
             var e = master.get('posts_for/' + JSON.stringify(args))
             return {_: master.clone(e._).map(x=>client.get(x.key))}
         }
 
-        client('post/*').to_get = (k) => {
+        client('post/*').getter = (k) => {
             var e = master.clone(master.get(k))
             if (!e._) return {}
             if (!can_see(e))
@@ -1355,7 +1404,7 @@ function import_server (bus, options)
             return e
         }
 
-        client('post/*').to_set = (o, t) => {
+        client('post/*').setter = (o, t) => {
             if (!(client.validate(o, {key: 'string',
                                      _: {to: 'array',
                                          cc: 'array',
@@ -1390,7 +1439,7 @@ function import_server (bus, options)
             t.done()
         }
 
-        client('post/*').to_delete = (key, o, t) => {
+        client('post/*').deleter = (key, o, t) => {
             // Validate
             if (!is_author(o)) {
                 console.error('User', current_addy(),
@@ -1414,14 +1463,14 @@ function import_server (bus, options)
             t.done()
         }
 
-        client('friends').to_get = t => {
-            return {_: (master.get('users').all||[])
+        client('friends').getter = t => {
+            return {_: (master.get('users').val||[])
                     .map(u=>client.get('email/' + user_addy(u)))
                     .concat([client.get('email/public')])
             }
         }
 
-        client('email/*').to_get = (rest) => {
+        client('email/*').getter = (rest) => {
             var m = rest.match(email_regex)
             var result = {address: rest}
             if (rest === 'public') {
@@ -1444,7 +1493,7 @@ function import_server (bus, options)
 
     sqlite_query_server: function sqlite_query_server (db) {
         var get = bus.get
-        bus('table_columns/*').to_get =
+        bus('table_columns/*').getter =
             function get_table_columns (key, rest) {
                 if (typeof key !== 'string')
                     console.log(handlers.hash)
@@ -1467,7 +1516,7 @@ function import_server (bus, options)
             }
 
 
-        bus('table_foreign_keys/*').to_get =
+        bus('table_foreign_keys/*').getter =
             function table_foreign_keys (key, rest) {
                 var table_name = rest
                 var foreign_keys = get('sql/PRAGMA foreign_key_list(' + table_name + ')').rows
@@ -1479,7 +1528,7 @@ function import_server (bus, options)
                 return result
             }
 
-        bus('sql/*').to_get =
+        bus('sql/*').getter =
             function sql (key, rest) {
                 get('time/60000')
                 var query = rest
@@ -1556,7 +1605,7 @@ function import_server (bus, options)
         // ************************
 
         // Getting the whole table, or a single row
-        bus(table_name + '*').to_get = function (key, rest) {
+        bus(table_name + '*').getter = function (key, rest) {
             if (rest === '')
                 // Return the whole table
                 return render_table()
@@ -1576,7 +1625,7 @@ function import_server (bus, options)
         }
 
         // Saving a row
-        bus(table_name + '/*').to_set = function (obj, rest) {
+        bus(table_name + '/*').setter = function (obj, rest) {
             var columns = table_columns.columns
             var key = remapped_keys.keys[obj.key] || obj.key
 
@@ -1602,7 +1651,7 @@ function import_server (bus, options)
         }
 
         // Inserting a new row
-        bus('new/' + table_name + '/*').to_set = function (obj) {
+        bus('new/' + table_name + '/*').setter = function (obj) {
             var columns = table_columns.columns
             var stmt = ('insert into ' + table_name + ' (' + columns.join(',')
                         + ') values (' + new Array(columns.length).join('?,') + '?)')
@@ -1621,7 +1670,7 @@ function import_server (bus, options)
         }
 
         // Deleting a row
-        bus(table_name + '/*').to_delete = function (key, rest) {
+        bus(table_name + '/*').deleter = function (key, rest) {
             if (remapped_keys.keys[key]) {
                 var old_key = key
                 var new_key = remapped_keys.keys[key]
@@ -1643,72 +1692,84 @@ function import_server (bus, options)
 
     serves_auth: function serves_auth (conn, master) {
         var client = this // to keep me straight while programming
-
-        function logout (key) {
+        function logout (user_key) {
             var clients = master.get('logged_in_clients')
-            for (var k in clients)
-                if (k !== 'key')
-                    if (Object.keys(clients[k]).length === 0) {
-                        client.log('Found a deleted user. Removing.', k, clients[k])
-                        delete clients[k]
-                        master.set(clients)
-                    } else if (clients[k].key === key) {
-                        client.log('Logging out!', k, clients[k])
-                        delete clients[k]
-                        master.set(clients)
-                    }
+            clients.val = clients.val || {}
+
+            for (var k in clients.val) {
+                // We used to encounter stray deleted accounts that hadn't
+                // gotten properly garbage collected, and I added some code
+                // here to remove them.
+                //
+                // However, it was a bit kludgy, and I'm rewriting the code
+                // now, and not sure if this problem still occurs.  Will watch
+                // and see.  Meanwhile, I'm commenting the code out.
+                //
+                // if (Object.keys(clients.val[k]).length === 0) {
+                //     client.log('Found a deleted user. Removing.', k, clients.val[k])
+                //     delete clients.val[k]
+                //     master.set(clients)
+                // }
+                if (clients.val[k].link === user_key) {
+                    client.log('Logging out!', k, clients.val[k])
+                    delete clients.val[k]
+                    master.set(clients)
+                }
+            }
         }
 
         // Initialize master
         if (!master.auth_initialized) {
-            master('users/passwords').to_get = function (k) {
-                master.log('users/passwords.to_get: Computing!')
-                var result = {key: 'users/passwords'}
+
+            // A hash for fast lookup of a user's password
+            master('users/passwords').getter = function (k) {
+                // We compute it from the 'users' state
+                master.log('users/passwords.getter: Computing!')
+                var result = {key: 'users/passwords', val: {}}
                 var users = master.get('users')
-                users.all = users.all || []
-                for (var i=0; i<users.all.length; i++) {
-                    var u = master.get(users.all[i])
-                    if (!(u.login || u.name)) {
-                        console.error('upass: this user has bogus name/login', u.key, u.name, u.login)
+                users.val = users.val || []
+                for (var i=0; i<users.val.length; i++) {
+                    var u = master.get(users.val[i].link)
+                    if (!(u.val.login || u.val.name)) {
+                        console.error('upass: this user has bogus name/login', u.key, u.val.name, u.val.login)
                         continue
                     }
-                    var login = (u.login || u.name).toLowerCase()
+                    var login = (u.val.login || u.val.name).toLowerCase()
                     console.assert(login, 'Missing login for user', u)
-                    if (result.hasOwnProperty(login)) {
+                    if (result.val.hasOwnProperty(login)) {
                         console.error("upass: this user's name is bogus, dude.", u.key)
                         continue
                     }
-                    result[login] = {user: u.key, pass: u.pass}
+                    result.val[login] = {user: u.key, pass: u.val.pass}
                 }
                 return result
             }
             master.auth_initialized = true
             master.get('users/passwords')
 
-            master('user/*').to_delete = (key, t) => {
+            master('user/*').deleter = (key, t) => {
                 master.log('Deleteinggg!!!', key)
                 // Remove from users.all
                 var users = master.get('users')
-                users.all = users.all.filter(u => u.key && u.key !== key)
+                users.val = users.val.filter(u => u.link && u.link !== key)
                 master.set(users)
 
                 // Log out
                 master.log('Logging out', key)
                 logout(key)
 
-                // Remove connection
-                master.log('Removing connections for', key)
-                var conns = master.get('connections')
-                for (var k in conns) {
-                    console.log('Trying key', k)
-                    if (k !== 'key')
-                        if (conns[k].user && !conns[k].user.key) {
-                            console.log('Cleaning keyless user', conss[k].user)
-                            delete conns[k].user
-                            master.set(conns)
-                            continue
-                        }
-                }
+                // // Remove connection
+                // master.log('Removing connections for', key)
+                // var conns = master.get('connections')
+                // for (var k in conns.val) {
+                //     console.log('Trying key', k)
+                //     if (conns.val[k].user && !conns.val[k].user.key) {
+                //         console.log('Cleaning keyless user', conss.val[k].user)
+                //         delete conns.val[k].user
+                //         master.set(conns)
+                //         continue
+                //     }
+                // }
 
                 master.log('Dirtying users/passwords for', key)
                 master.dirty('users/passwords')
@@ -1720,9 +1781,9 @@ function import_server (bus, options)
 
         // Authentication functions
         function authenticate (login, pass) {
-            var userpass = master.get('users/passwords')[login.toLowerCase()]
+            var userpass = master.get('users/passwords').val[login.toLowerCase()]
             master.log('authenticate: we see', {
-                passwords: master.get('users/passwords'),
+                passwords: master.get('users/passwords').val,
                 hash_to_match: userpass && userpass.pass,
                 password_guess: pass
             })
@@ -1733,7 +1794,7 @@ function import_server (bus, options)
 
             // console.log('comparing passwords', pass, userpass.pass)
             if (require('bcrypt-nodejs').compareSync(pass, userpass.pass))
-                return master.get(userpass.user)
+                return userpass.user
         }
         function create_account (params) {
             if (typeof (params.login || params.name) !== 'string')
@@ -1746,7 +1807,7 @@ function import_server (bus, options)
                 throw 'invalid name, login, pass, or email'
 
             var passes = master.get('users/passwords')
-            if (passes.hasOwnProperty(login))
+            if (passes.val.hasOwnProperty(login))
                 throw 'there is already a user with that login or name'
 
             // Hash password
@@ -1766,60 +1827,81 @@ function import_server (bus, options)
                 key = 'user/' + Math.random().toString(36).substring(7,13)
 
             // Make account object
-            var new_account = {key: key,
-                               name: params.name,
-                               login: params.login,
-                               pass: params.pass,
-                               email: params.email }
-            for (var k in new_account) if (!new_account[k]) delete new_account[k]
+            var new_account = {
+                key: key, val: {
+                    name: params.name,
+                    login: params.login,
+                    pass: params.pass,
+                    email: params.email
+                }
+            }
+            for (var k in new_account.val)    // Clean out falsy fields
+                if (!new_account.val[k])
+                    delete new_account.val[k]
             master.set(new_account)
 
             var users = master.get('users')
-            users.all = users.all || []
-            users.all.push(new_account)
-            passes[login] = {user: new_account.key, pass: new_account.pass}
+            users.val = users.val || []
+            users.val.push({link: new_account.key})
+            passes.val[login] = {user: new_account.key, pass: new_account.val.pass}
             master.set(users)
             master.set(passes)
         }
 
         // Current User
-        client('current_user').to_get = function (k) {
-            client.log('* getting: current_user')
-            if (!conn.client) return
-            var u = master.get('logged_in_clients')[conn.client]
-            u = u && user_obj(u.key, true)
-            return {user: u || null, logged_in: !!u}
+        client('current_user').getter = function (k) {
+            if (!conn.client)
+                return {val: {error: 'no client'}}
+
+            var u = (master.get('logged_in_clients').val || {})[conn.client]
+            var result = {val: {user: u || null, logged_in: !!u}}
+            return result
         }
 
-        client('current_user').to_set = function (o, t) {
+        client('current_user').setter = function (o, t) {
+            var val = o.val
+            if (typeof val !== 'object') {
+                console.error('current_user: set to something not an object:', val)
+                t.abort()
+                return
+            }
             function error (msg) {
+                console.error(msg)
                 client.set.abort(o)
                 var c = client.get('current_user')
-                c.error = msg
+                c.val.error = msg
                 client.set.fire(c)
             }
 
             client.log('* saving: current_user!')
-            if (o.client && !conn.client) {
+            if (val.client && !conn.client) {
                 // Set the client
-                conn.client = o.client
-                client.client_id = o.client
+                //
+                //   Note: Should this code be moved upstream, when creating a
+                //         client bus?
+                conn.client = val.client
+                client.client_id = val.client
                 client.client_ip = conn.remoteAddress
 
-                if (conn.id) {
-                    var connections = master.get('connections')
-                    connections[conn.id].user = master.get('logged_in_clients')[conn.client]
-                    master.set(connections)
-                }
+                // if (conn.id) {
+                //     var connections = master.get('connections')
+                //     var logged_in_user =
+                //         (master.get('logged_in_clients').val || {})[conn.client]
+
+                //     if (logged_in_user) {
+                //         connections.val[conn.id].user = {link: user.link}
+                //         master.set(connections)
+                //     }
+                // }
             }
             else {
-                if (o.create_account) {
+                if (val.create_account) {
                     client.log('current_user: creating account')
                     try {
-                        create_account(o.create_account)
+                        create_account(val.create_account)
                         client.log('Success creating account!')
                         var cu = client.get('current_user')
-                        cu.create_account = null
+                        cu.val.create_account = null
                         client.set.fire(cu)
                     } catch (e) {
                         error('Cannot create that account because ' + e)
@@ -1827,29 +1909,29 @@ function import_server (bus, options)
                     }
                 }
 
-                if (o.login_as && conn.id) {
+                if (val.login_as) {
                     // Then client is trying to log in
-                    client.log('current_user: trying to log in')
-                    var creds = o.login_as
+                    var creds = val.login_as
                     var login = creds.login || creds.name
                     if (login && creds.pass) {
                         // With a username and password
-                        var u = authenticate(login, creds.pass)
+                        var user_key = authenticate(login, creds.pass)
 
-                        client.log('auth said:', u)
-                        if (u) {
+                        client.log('auth said:', user_key)
+                        if (user_key) {
                             // Success!
                             // Associate this user with this session
                             // user.log('Logging the user in!', u)
 
                             var clients     = master.get('logged_in_clients')
-                            var connections = master.get('connections')
+                            // var connections = master.get('connections')
 
-                            clients[conn.client]      = u
-                            connections[conn.id].user = u
+                            clients.val = clients.val || {}
+                            clients.val[conn.client]  = {link: user_key}
+                            // connections.val[conn.id].user = {link: user_key}
 
                             master.set(clients)
-                            master.set(connections)
+                            // master.set(connections)
 
                             client.log('current_user: success logging in!')
                         }
@@ -1864,38 +1946,41 @@ function import_server (bus, options)
                     }
                 }
 
-                else if (o.logout && conn.id) {
+                else if (val.logout) {
                     client.log('current_user: logging out')
                     var clients = master.get('logged_in_clients')
-                    var connections = master.get('connections')
+                    // var connections = master.get('connections')
 
-                    delete clients[conn.client]
-                    connections[conn.id].user = null
+                    clients.val = clients.val || {}
+                    delete clients.val[conn.client]
+                    // connections.val[conn.id].user = null
 
                     master.set(clients)
-                    master.set(connections)
+                    // master.set(connections)
                 }
             }
 
             t.reget()
         }
-        client('current_user').to_delete = function () {}
+        client('current_user').deleter = function () {}
 
         // Users have closet space at /user/<name>/*
         var closet_space_key = /^(user\/[^\/]+)\/.*/
         var private_closet_space_key = /^user\/[^\/]+\/private.*/
 
         // User
-        client('user/*').to_set = function (o, t) {
+        client('user/*').setter = function (o, t) {
             var c = client.get('current_user')
             var user_key = o.key.match(/^user\/([^\/]+)/)
             user_key = user_key && ('user/' + user_key[1])
 
-            // Only the current user can touch themself.
-            if (!c.logged_in || c.user.key !== user_key) {
-                client.log('Only the current user can touch themself.',
-                           {logged_in: c.logged_in, as: c.user && c.user.key,
-                            touching: user_key})
+            // Only the current user can touch himself.
+            if (!c.val.logged_in || c.val.user.link !== user_key) {
+                client.log('Only the current user can touch himself.', {
+                    logged_in: c.val.logged_in,
+                    as: c.val.user && c.val.user.link,
+                    touching: user_key
+                })
                 client.set.abort(o)
                 return
             }
@@ -1911,9 +1996,14 @@ function import_server (bus, options)
             console.assert(o.key.match(/^user\/[^\/]+$/))
 
             // Validate types
-            if (!client.validate(o, {key: 'string', '?login': 'string', '?name': 'string',
-                                     '?pass': 'string', '?email': 'string', /*'?pic': 'string',*/
-                                     '*':'*'})) {
+            if (!client.validate(o, {key: 'string',
+                                     val: {
+                                         '?login': 'string',
+                                         '?name': 'string',
+                                         '?pass': 'string',
+                                         '?email': 'string',
+                                         /*'?pic': 'string',*/
+                                         '*':'*'}})) {
                 client.log('This user change fails validation.')
                 client.set.abort(o)
                 return
@@ -1924,7 +2014,7 @@ function import_server (bus, options)
             //  • That resulting login must be unique across all users
 
             // There must be at least a login or a name
-            var login = o.login || o.name
+            var login = o.val.login || o.val.name
             if (!login) {
                 client.log('User must have a login or a name')
                 client.set.abort(o)
@@ -1935,26 +2025,26 @@ function import_server (bus, options)
             var userpass = master.get('users/passwords')
 
             // Validate that the login/name is not changed to something clobberish
-            var old_login = u.login || u.name
+            var old_login = u.val.login || u.val.name
             if (old_login.toLowerCase() !== login.toLowerCase()
                 && userpass.hasOwnProperty(login)) {
                 client.log('The login', login, 'is already taken. Aborting.')
                 client.set.abort(o)         // Abort
 
                 o = client.get(o.key)      // Add error message
-                o.error = 'The login "' + login + '" is already taken'
+                o.val.error = 'The login "' + login + '" is already taken'
                 client.set.fire(o)
 
                 return                       // And exit
             }
 
             // Now we can update login and name
-            u.login = o.login
-            u.name = o.name
+            u.val.login = o.val.login
+            u.val.name = o.val.name
 
             // Hash password
-            o.pass = o.pass && require('bcrypt-nodejs').hashSync(o.pass)
-            u.pass = o.pass || u.pass
+            o.val.pass = o.val.pass && require('bcrypt-nodejs').hashSync(o.val.pass)
+            u.val.pass = o.val.pass || u.val.pass
 
             // // Users can have pictures (remove this soon)
             // // Bug: if user changes name, this picture's url doesn't change.
@@ -1973,24 +2063,24 @@ function import_server (bus, options)
 
             // For anything else, go ahead and add it to the user object
             var protected = {key:1, name:1, /*pic:1,*/ pass:1}
-            for (var k in o)
+            for (var k in o.val)
                 if (!protected.hasOwnProperty(k))
-                    u[k] = o[k]
-            for (var k in u)
-                if (!protected.hasOwnProperty(k) && !o.hasOwnProperty(k))
-                    delete u[k]
+                    u.val[k] = o.val[k]
+            for (var k in u.val)
+                if (!protected.hasOwnProperty(k) && !o.val.hasOwnProperty(k))
+                    delete u.val[k]
 
             master.set(u)
         }
-        client('user/*').to_get = function user_getter (k) {
+        client('user/*').getter = function user_getter (k) {
             var c = client.get('current_user')
-            client.log('* getting:', k, 'as', c.user)
+            client.log('* getting:', k, 'as', c.val.user)
 
             // Users have closet space at /user/<name>/*
             if (k.match(closet_space_key)) {
                 var obj_user = k.match(closet_space_key)[1]
                 if (k.match(private_closet_space_key)
-                    && (!c.user || obj_user !== c.user.key)) {
+                    && (!c.val.user || obj_user !== c.val.user.link)) {
                     client.log('hiding private closet data')
                     return {}
                 }
@@ -1999,26 +2089,27 @@ function import_server (bus, options)
             }
 
             // Otherwise return the actual user
-            return user_obj(k, c.logged_in && c.user.key === k)
+            return user_obj(k, c.val.logged_in && c.val.user.link === k)
         }
-        client('user/*').to_delete = function () {}
+        client('user/*').deleter = function () {}
         function user_obj (k, logged_in) {
             var o = master.clone(master.get(k))
             if (k.match(/^user\/([^\/]+)\/private\/(.*)$/))
                 return logged_in ? o : {key: k}
-            
-            delete o.pass
-            if (!logged_in) {delete o.email; delete o.login}
+
+            o.val = o.val || {}
+            delete o.val.pass
+            if (!logged_in) {delete o.val.email; delete o.val.login}
             return o
         }
 
         // Blacklist sensitive stuff on master, in case we have a shadow set up
         var blacklist = 'users users/passwords logged_in_clients'.split(' ')
         for (var i=0; i<blacklist.length; i++) {
-            client(blacklist[i]).to_get  = function () {}
-            client(blacklist[i]).to_set   = function () {}
-            client(blacklist[i]).to_delete = function () {}
-            client(blacklist[i]).to_forget = function () {}
+            client(blacklist[i]).getter  = function () {}
+            client(blacklist[i]).setter   = function () {}
+            client(blacklist[i]).deleter = function () {}
+            client(blacklist[i]).forgetter = function () {}
         }
     },
 
@@ -2027,14 +2118,14 @@ function import_server (bus, options)
         var was_logged_in = undefined
 
         function client_prefix (current_user) {
-            return 'client/' + (current_user.logged_in
-                                 ? current_user.user.key.substr('user/'.length)
+            return 'client/' + (current_user.val.logged_in
+                                 ? current_user.val.user.link.substr('user/'.length)
                                  : client.client_id) + '/'
         }
 
-        function copy_client_to_user(client, user) {
+        function copy_client_to_user(client, user_key) {
             var old_prefix = 'client/' + client.client_id
-            var new_prefix = 'client/' + user.key.substr('user/'.length)
+            var new_prefix = 'client/' + user_key.substr('user/'.length)
 
             var keys = client.master.get('persisted_keys/' + client.client_id)
             if (!keys.val) return
@@ -2080,13 +2171,13 @@ function import_server (bus, options)
         client(_=>{
             var c = client.get('current_user')
             if (client.loading()) return
-            if (was_logged_in == false && c.logged_in)
+            if (was_logged_in == false && c.val.logged_in)
                 // User just logged in!  Let's copy his stuff over
-                copy_client_to_user(client, c.user)
-            was_logged_in = c.logged_in
+                copy_client_to_user(client, c.val.user.link)
+            was_logged_in = c.val.logged_in
         })
 
-        client(prefix_to_sync).to_get = function (key) {
+        client(prefix_to_sync).getter = function (key) {
             var c = client.get('current_user')
             if (client.loading()) return
             var prefix = client_prefix(c)
@@ -2103,7 +2194,7 @@ function import_server (bus, options)
             return obj
         }
 
-        client(prefix_to_sync).to_set = function (obj) {
+        client(prefix_to_sync).setter = function (obj) {
             if (validate && !validate(obj)) {
                 console.warn('Validation failed on', obj)
                 client.set.abort(obj)
@@ -2131,7 +2222,7 @@ function import_server (bus, options)
             p_keys && client.master.set(p_keys)
         }
 
-        client(prefix_to_sync).to_delete = function (k) {
+        client(prefix_to_sync).deleter = function (k) {
             k = client_prefix(client.get('current_user')) + k
             client.master.delete(k)
 
@@ -2141,7 +2232,7 @@ function import_server (bus, options)
         }
 
         function client_persisted_keys () {
-            if (client.get('current_user').logged_in) return
+            if (client.get('current_user').val.logged_in) return
             var result = client.master.get('persisted_keys/' + client.client_id)
             if (result && !result.val) result.val = {}
             return result
@@ -2157,19 +2248,19 @@ function import_server (bus, options)
             // to the global cache
             if (count === 0) {
                 count++
-                if (method === 'to_get')
+                if (method === 'getter')
                     bus.run_handler(function get_from_master (k) {
                         // console.log('DEFAULT GETting', k)
                         var r = master_bus.get(k)
                         // console.log('DEFAULT GETted', r)
                         bus.set.fire(r, {version: master_bus.versions[r.key]})
                         }, method, arg)
-                else if (method === 'to_set')
+                else if (method === 'setter')
                     bus.run_handler(function set_to_master (o, t) {
                         // console.log('DEFAULT ROUTE', t)
                         master_bus.set(bus.clone(o), t)
                     }, method, arg, {t: t})
-                else if (method == 'to_delete')
+                else if (method == 'deleter')
                     bus.run_handler(function delete_from_master (k, t) {
                         master_bus.delete(k)
                         return 'done'
@@ -2223,7 +2314,7 @@ function import_server (bus, options)
     // file or recursive directory structure at fs_path
     sync_files: function sync_files (state_path, file_path) {
         // To do:
-        //  - Hook up a to_delete handler
+        //  - Hook up a deleter handler
         //    - recursively remove directories if all files gone
 
         console.assert(state_path.substr(-1) !== '*'
@@ -2234,7 +2325,7 @@ function import_server (bus, options)
         var buffer = {}
         var full_file_path = require('path').join(__dirname, file_path)
 
-        bus(state_path + '*').to_get = (rest) => {
+        bus(state_path + '*').getter = (rest) => {
             // We DO want to handle:
             //   - "foo"
             //   - "foo/*"
@@ -2260,7 +2351,7 @@ function import_server (bus, options)
             return {_:f}
         }
 
-        bus(state_path + '/*').to_set = (o, rest, t) => {
+        bus(state_path + '/*').setter = (o, rest, t) => {
             if (rest.length>0 && rest[0] !== '/') return
             var f = Buffer.from(o._, 'base64')
             require('fs').writeFile(file_path + rest, f,
@@ -2274,10 +2365,10 @@ function import_server (bus, options)
     // Installs a GET handler at route that gets state from a getter function
     // Note: Makes too many textbusses.  Should re-use one.
     http_serve: function http_serve (route, getter) {
-        var textbus = require('./statebus')()
+        var textbus = make_statebus()
         textbus.label = 'textbus'
         var watched = new Set()
-        textbus('*').to_get = (filename, old) => {
+        textbus('*').getter = (filename, old) => {
             return {etag: Math.random() + '',
                     _: getter(filename)}
         }
@@ -2353,7 +2444,7 @@ function import_server (bus, options)
     },
 
     serve_wiki: () => {
-        bus('edit/*').to_get = () => ({_: require('./extras/wiki.coffee').code})
+        bus('edit/*').getter = () => ({_: require('./extras/wiki.coffee').code})
     },
 
     unix_socket_repl: function (filename) {
@@ -2500,7 +2591,7 @@ module.exports.import_module = function (statebus) {
 
     statebus.serve = function serve (options) {
         var bus = statebus()
-        require('./servers').run_server(bus, options)
+        require('./server-library').run_server(bus, options)
         return bus
     }