Merge pull request #188 from amark/develop

Develop
This commit is contained in:
Mark Nadal 2016-05-13 20:00:02 -06:00
commit d92f885dee
34 changed files with 3095 additions and 1438 deletions

4
.gitignore vendored
View File

@ -4,4 +4,6 @@ npm-debug.log
*.db
.idea/
*.bak
*.new
*.new
src/webpacked.js

View File

@ -1,4 +1,14 @@
# gun [![NPM downloads](https://img.shields.io/npm/dm/gun.svg?style=flat)](https://npmjs.org/package/gun) [![Build Status](https://travis-ci.org/amark/gun.svg?branch=master)](https://travis-ci.org/amark/gun) [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/amark/gun?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
<h1>
<a href="http://gundb.io">
<img src='https://cldup.com/TEy9yGh45l.svg'
width='40%'
alt="gun" />
</a>
</h1>
[![npm](https://img.shields.io/npm/dm/gun.svg)](https://www.npmjs.com/package/gun)
[![Travis](https://img.shields.io/travis/amark/gun/master.svg)](https://travis-ci.org/amark/gun)
[![Gitter](https://img.shields.io/gitter/room/amark/gun.js.svg)](https://gitter.im/amark/gun)
GUN is a realtime, distributed, offline-first, graph database engine. Lightweight and powerful, at just **~9KB** gzipped.

2875
gun.js

File diff suppressed because it is too large Load Diff

View File

@ -1,6 +1,6 @@
{
"name": "gun",
"version": "0.3.8",
"version": "0.3.9",
"description": "Graph engine",
"main": "index.js",
"scripts": {

34
src/HAM.js Normal file
View File

@ -0,0 +1,34 @@
module.exports = function(machineState, incomingState, currentState, incomingValue, currentValue){ // TODO: Lester's comments on roll backs could be vulnerable to divergence, investigate!
if(machineState < incomingState){
// the incoming value is outside the boundary of the machine's state, it must be reprocessed in another state.
return {defer: true};
}
if(incomingState < currentState){
// the incoming value is within the boundary of the machine's state, but not within the range.
return {historical: true};
}
if(currentState < incomingState){
// the incoming value is within both the boundary and the range of the machine's state.
return {converge: true, incoming: true};
}
if(incomingState === currentState){
if(incomingValue === currentValue){ // Note: while these are practically the same, the deltas could be technically different
return {state: true};
}
/*
The following is a naive implementation, but will always work.
Never change it unless you have specific needs that absolutely require it.
If changed, your data will diverge unless you guarantee every peer's algorithm has also been changed to be the same.
As a result, it is highly discouraged to modify despite the fact that it is naive,
because convergence (data integrity) is generally more important.
Any difference in this algorithm must be given a new and different name.
*/
if(String(incomingValue) < String(currentValue)){ // String only works on primitive values!
return {converge: true, current: true};
}
if(String(currentValue) < String(incomingValue)){ // String only works on primitive values!
return {converge: true, incoming: true};
}
}
return {err: "you have not properly handled recursion through your data or filtered it as JSON"};
}

46
src/at.js Normal file
View File

@ -0,0 +1,46 @@
var Gun = require('./gun');
Gun.on.at = function(on){ // On event emitter customized for gun.
var proxy = function(e){ return proxy.e = e, proxy }
proxy.emit = function(at){
if(at.soul){
at.hash = Gun.on.at.hash(at);
//Gun.obj.as(proxy.mem, proxy.e)[at.soul] = at;
Gun.obj.as(proxy.mem, proxy.e)[at.hash] = at;
}
if(proxy.all.cb){ proxy.all.cb(at, proxy.e) }
on(proxy.e).emit(at);
return {chain: function(c){
if(!c || !c._ || !c._.at){ return }
return c._.at(proxy.e).emit(at)
}};
}
proxy.only = function(cb){
if(proxy.only.cb){ return }
return proxy.event(proxy.only.cb = cb);
}
proxy.all = function(cb){
proxy.all.cb = cb;
Gun.obj.map(proxy.mem, function(mem, e){
Gun.obj.map(mem, function(at, i){
cb(at, e);
});
});
}
proxy.event = function(cb, i){
i = on(proxy.e).event(cb, i);
return Gun.obj.map(proxy.mem[proxy.e], function(at){
i.stat = {first: true};
cb.call(i, at);
}), i.stat = {}, i;
}
proxy.map = function(cb, i){
return proxy.event(cb, i);
};
proxy.mem = {};
return proxy;
}
Gun.on.at.hash = function(at){ return (at.at && at.at.soul)? at.at.soul + (at.at.field || '') : at.soul + (at.field || '') }
Gun.on.at.copy = function(at){ return Gun.obj.del(at, 'hash'), Gun.obj.map(at, function(v,f,t){t(f,v)}) }

7
src/bi.js Normal file
View File

@ -0,0 +1,7 @@
// Booleans
module.exports = {
is: function(b){
return (b instanceof Boolean || typeof b == 'boolean');
}
}

11
src/chain.js Normal file
View File

@ -0,0 +1,11 @@
var Gun = require('./gun');
Gun.chain.chain = function(s){
var from = this, gun = !from.back? from : Gun(from);
gun.back = gun.back || from;
gun.__ = gun.__ || from.__;
gun._ = gun._ || {};
gun._.on = gun._.on || Gun.on.create();
gun._.at = gun._.at || Gun.on.at(gun._.on);
return gun;
}

41
src/event.js Normal file
View File

@ -0,0 +1,41 @@
// On event emitter generic javascript utility.
var list = require('./list');
function On(){};
On.create = function(){
var on = function(e){
on.event.e = e;
on.event.s[e] = on.event.s[e] || [];
return on;
};
on.emit = function(a){
var e = on.event.e, s = on.event.s[e], args = arguments, l = args.length;
list.map(s, function(hear, i){
if(!hear.fn){ s.splice(i-1, 0); return; }
if(1 === l){ hear.fn(a); return; }
hear.fn.apply(hear, args);
});
if(!s.length){ delete on.event.s[e] }
}
on.event = function(fn, i){
var s = on.event.s[on.event.e]; if(!s){ return }
var e = {fn: fn, i: i || 0, off: function(){ return !(e.fn = false) }};
return s.push(e), i? s.sort(sort) : i, e;
}
on.event.s = {};
return on;
}
var sort = list.sort('i');
//exports.on = On.create();
//exports.on.create = On.create;
module.exports = On;

6
src/fn.js Normal file
View File

@ -0,0 +1,6 @@
// Functions
module.exports = {
is: function(fn){
return (fn instanceof Function);
}
};

73
src/get.js Normal file
View File

@ -0,0 +1,73 @@
var Gun = require('./gun');
Gun.chain.get = (function(){
Gun.on('operating').event(function(gun, at){
if(!gun.__.by(at.soul).node){ gun.__.by(at.soul).node = gun.__.graph[at.soul] }
if(at.field){ return } // TODO: It would be ideal to reuse HAM's field emit.
gun.__.on(at.soul).emit(at);
});
Gun.on('get').event(function(gun, at, ctx, opt, cb){
if(ctx.halt){ return } // TODO: CLEAN UP with event emitter option?
at.change = at.change || gun.__.by(at.soul).node;
if(opt.raw){ return cb.call(opt.on, at) }
if(!ctx.cb.no){ cb.call(ctx.by.chain, null, Gun.obj.copy(ctx.node || gun.__.by(at.soul).node)) }
gun._.at('soul').emit(at).chain(opt.chain);
},0);
Gun.on('get').event(function(gun, at, ctx){
if(ctx.halt){ ctx.halt = false; return } // TODO: CLEAN UP with event emitter option?
}, Infinity);
return function(lex, cb, opt){ // get opens up a reference to a node and loads it.
var gun = this, ctx = {
opt: opt || {},
cb: cb || function(){},
lex: (Gun.text.is(lex) || Gun.num.is(lex))? Gun.is.rel.ify(lex) : lex,
};
ctx.force = ctx.opt.force;
if(cb !== ctx.cb){ ctx.cb.no = true }
if(!Gun.obj.is(ctx.lex)){ return ctx.cb.call(gun = gun.chain(), {err: Gun.log('Invalid get request!', lex)}), gun }
if(!(ctx.soul = ctx.lex[Gun._.soul])){ return ctx.cb.call(gun = this.chain(), {err: Gun.log('No soul to get!')}), gun } // TODO: With `.all` it'll be okay to not have an exact match!
ctx.by = gun.__.by(ctx.soul);
ctx.by.chain = ctx.by.chain || gun.chain();
function load(lex){
var soul = lex[Gun._.soul];
var cached = gun.__.by(soul).node || gun.__.graph[soul];
if(ctx.force){ ctx.force = false }
else if(cached){ return false }
wire(lex, stream, ctx.opt);
return true;
}
function stream(err, data, info){
//console.log("wire.get <--", err, data);
Gun.on('wire.get').emit(ctx.by.chain, ctx, err, data, info);
if(err){
Gun.log(err.err || err);
ctx.cb.call(ctx.by.chain, err);
return ctx.by.chain._.at('err').emit({soul: ctx.soul, err: err.err || err}).chain(ctx.opt.chain);
}
if(!data){
ctx.cb.call(ctx.by.chain, null);
return ctx.by.chain._.at('null').emit({soul: ctx.soul, not: true}).chain(ctx.opt.chain);
}
if(Gun.obj.empty(data)){ return }
if(err = Gun.union(ctx.by.chain, data).err){
ctx.cb.call(ctx.by.chain, err);
return ctx.by.chain._.at('err').emit({soul: Gun.is.node.soul(data) || ctx.soul, err: err.err || err}).chain(ctx.opt.chain);
}
}
function wire(lex, cb, opt){
Gun.on('get.wire').emit(ctx.by.chain, ctx, lex, cb, opt);
if(Gun.fns.is(gun.__.opt.wire.get)){ return gun.__.opt.wire.get(lex, cb, opt) }
if(!Gun.log.count('no-wire-get')){ Gun.log("Warning! You have no persistence layer to get from!") }
cb(null); // This is in memory success, hardly "success" at all.
}
function on(at){
if(on.ran = true){ ctx.opt.on = this }
if(load(ctx.lex)){ return }
Gun.on('get').emit(ctx.by.chain, at, ctx, ctx.opt, ctx.cb, ctx.lex);
}
ctx.opt.on = (ctx.opt.at || gun.__.at)(ctx.soul).event(on);
ctx.by.chain._.get = ctx.lex;
if(!ctx.opt.ran && !on.ran){ on.call(ctx.opt.on, {soul: ctx.soul}) }
return ctx.by.chain;
}
}());

48
src/gun.js Normal file
View File

@ -0,0 +1,48 @@
function Gun(o){
var gun = this;
if(!Gun.is(gun)){ return new Gun(o) }
if(Gun.is(o)){ return gun }
return gun.opt(o);
}
Gun.version = 0.3;
Gun._ = { // some reserved key words, these are not the only ones.
meta: '_' // all metadata of the node is stored in the meta property on the node.
,soul: '#' // a soul is a UUID of a node but it always points to the "latest" data known.
,field: '.' // a field is a property on a node which points to a value.
,state: '>' // other than the soul, we store HAM metadata.
,'#':'soul'
,'.':'field'
,'=':'value'
,'>':'state'
}
// check to see if it is a GUN instance.
Gun.is = function(gun){
return (gun instanceof Gun);
}
var root = this || {}; // safe for window, global, root, and 'use strict'.
root.console = root.console || {log: function(s){ return s }}; // safe for old browsers
if(typeof window !== "undefined"){
root = window;
window.Gun = Gun;
}
module.exports = Gun;
Gun.log = function(s){
return (!Gun.log.squelch && root.console.log.apply(root.console, arguments)), s;
}
Gun.log.count = function(s){ return Gun.log.count[s] = Gun.log.count[s] || 0, Gun.log.count[s]++ }
/*
var console = {
log: function(s){return root.console.log.apply(root.console, arguments), s},
Log: Gun.log
};
console.debug = function(i, s){ return (Gun.log.debug && i === Gun.log.debug && Gun.log.debug++) && root.console.log.apply(root.console, arguments), s };
*/

109
src/ify.js Normal file
View File

@ -0,0 +1,109 @@
var Gun = require('./gun');
// Javascript to Gun Serializer.
function ify(data, cb, opt){
opt = opt || {};
cb = cb || function(env, cb){ cb(env.at, Gun.is.node.soul(env.at.obj) || Gun.is.node.soul(env.at.node) || Gun.text.random()) };
var end = function(fn){
ctx.end = fn || function(){};
unique(ctx);
}, ctx = {at: {path: [], obj: data}, root: {}, graph: {}, queue: [], seen: [], opt: opt, loop: true};
if(!data){ return ctx.err = {err: Gun.log('Serializer does not have correct parameters.')}, end }
if(ctx.opt.start){ Gun.is.node.soul.ify(ctx.root, ctx.opt.start) }
ctx.at.node = ctx.root;
while(ctx.loop && !ctx.err){
seen(ctx, ctx.at);
map(ctx, cb);
if(ctx.queue.length){
ctx.at = ctx.queue.shift();
} else {
ctx.loop = false;
}
}
return end;
}
function map(ctx, cb){
var u, rel = function(at, soul){
at.soul = at.soul || soul || Gun.is.node.soul(at.obj) || Gun.is.node.soul(at.node);
if(!ctx.opt.pure){
ctx.graph[at.soul] = Gun.is.node.soul.ify(at.node, at.soul);
if(ctx.at.field){
Gun.is.node.state.ify([at.node], at.field, u, ctx.opt.state);
}
}
Gun.list.map(at.back, function(rel){
rel[Gun._.soul] = at.soul;
});
unique(ctx);
}, it;
Gun.obj.map(ctx.at.obj, function(val, field){
ctx.at.val = val;
ctx.at.field = field;
it = cb(ctx, rel, map) || true;
if(field === Gun._.meta){
ctx.at.node[field] = Gun.obj.copy(val); // TODO: BUG! Is this correct?
return;
}
if(String(field).indexOf('.') != -1 || (false && notValidField(field))){ // TODO: BUG! Do later for ACID "consistency" guarantee.
return ctx.err = {err: Gun.log("Invalid field name on '" + ctx.at.path.join('.') + "'!")};
}
if(!Gun.is.val(val)){
var at = {obj: val, node: {}, back: [], path: [field]}, tmp = {}, was;
at.path = (ctx.at.path||[]).concat(at.path || []);
if(!Gun.obj.is(val)){
return ctx.err = {err: Gun.log("Invalid value at '" + at.path.join('.') + "'!" )};
}
if(was = seen(ctx, at)){
tmp[Gun._.soul] = Gun.is.node.soul(was.node) || null;
(was.back = was.back || []).push(ctx.at.node[field] = tmp);
} else {
ctx.queue.push(at);
tmp[Gun._.soul] = null;
at.back.push(ctx.at.node[field] = tmp);
}
} else {
ctx.at.node[field] = Gun.obj.copy(val);
}
});
if(!it){ cb(ctx, rel) }
}
function unique(ctx){
if(ctx.err || (!Gun.list.map(ctx.seen, function(at){
if(!at.soul){ return true }
}) && !ctx.loop)){ return ctx.end(ctx.err, ctx), ctx.end = function(){}; }
}
function seen(ctx, at){
return Gun.list.map(ctx.seen, function(has){
if(at.obj === has.obj){ return has }
}) || (ctx.seen.push(at) && false);
}
ify.wire = function(n, cb, opt){ return Gun.text.is(n)? ify.wire.from(n, cb, opt) : ify.wire.to(n, cb, opt) }
ify.wire.to = function(n, cb, opt){ var t, b;
if(!n || !(t = Gun.is.node.soul(n))){ return null }
cb = cb || function(){};
t = (b = "#'" + JSON.stringify(t) + "'");
Gun.obj.map(n, function(v,f){
if(Gun._.meta === f){ return }
var w = '', s = Gun.is.node.state(n,f);
if(!s){ return }
w += ".'" + JSON.stringify(f) + "'";
w += "='" + JSON.stringify(v) + "'";
w += ">'" + JSON.stringify(s) + "'";
t += w;
w = b + w;
cb(null, w);
});
return t;
}
ify.wire.from = function(n, cb, opt){
if(!n){ return null }
var a = [], s = -1, e = 0, end = 1;
while((e = n.indexOf("'", s + 1)) >= 0){
if(s === e || '\\' === n.charAt(e-1)){}else{
a.push(n.slice(s + 1,e));
s = e;
}
}
return a;
}
Gun.ify = ify;

38
src/index.js Normal file
View File

@ -0,0 +1,38 @@
var Gun = require('./gun');
Gun.fns = require('./fn');
Gun.bi = require('./bi');
Gun.num = require('./num');
Gun.text = require('./text');
Gun.list = require('./list');
Gun.obj = require('./obj');
Gun.time = require('./time');
Gun.schedule = require('./schedule');
var on = require('./event');
Gun.on = on.create();
Gun.on.create = on.create;
Gun.HAM = require('./HAM');
require('./ify');
require('./node');
require('./union');
require('./at');
// chain!
Gun.chain = Gun.prototype;
require('./opt');
require('./chain');
require('./put');
require('./get');
require('./key');
require('./on');
require('./path');
require('./map');
require('./val');
require('./not');
require('./set');
require('./init');
module.exports = Gun;

21
src/init.js Normal file
View File

@ -0,0 +1,21 @@
var Gun = require('./gun');
Gun.chain.init = function(cb, opt){
var gun = this;
gun._.at('null').event(function(at){
if(!at.not){ return } // TODO: BUG! This check is synchronous but it could be asynchronous!
var ctx = {by: gun.__.by(at.soul)};
if(at.field){
if(Gun.obj.has(ctx.by.node, at.field)){ return }
gun._.at('soul').emit({soul: at.soul, field: at.field, not: true});
return;
}
if(at.soul){
if(ctx.by.node){ return }
var soul = Gun.text.random();
gun.__.gun.put(Gun.is.node.soul.ify({}, soul), null, {init: true});
gun.__.gun.key(at.soul, null, soul);
}
}, {raw: true});
return gun;
}

56
src/key.js Normal file
View File

@ -0,0 +1,56 @@
var Gun = require('./gun');
Gun.chain.key = (function(){
Gun.on('put').event(function(gun, at, ctx, opt, cb){
if(opt.key){ return }
Gun.is.graph(ctx.ify.graph, function(node, soul){
var key = {node: gun.__.graph[soul]};
if(!Gun.is.node.soul(key.node, 'key')){ return }
if(!gun.__.by(soul).end){ gun.__.by(soul).end = 1 }
Gun.is.node(key.node, function(rel, s){
rel = ctx.ify.graph[s] = ctx.ify.graph[s] || Gun.is.node.soul.ify({}, s);
Gun.is.node(node, function(v,f){ Gun.is.node.state.ify([rel, node], f, v) });
Gun.obj.del(ctx.ify.graph, soul);
})
});
});
Gun.on('get').event(function(gun, at, ctx, opt, cb){
if(ctx.halt){ return } // TODO: CLEAN UP with event emitter option?
if(opt.key && opt.key.soul){
at.soul = opt.key.soul;
gun.__.by(opt.key.soul).node = Gun.union.ify(gun, opt.key.soul); // TODO: Check performance?
gun.__.by(opt.key.soul).node._['key'] = 'pseudo';
at.change = Gun.is.node.soul.ify(Gun.obj.copy(at.change || gun.__.by(at.soul).node), at.soul, true); // TODO: Check performance?
return;
}
if(!(Gun.is.node.soul(gun.__.graph[at.soul], 'key') === 1)){ return }
var node = at.change || gun.__.graph[at.soul];
function map(rel, soul){ gun.__.gun.get(rel, cb, {key: ctx, chain: opt.chain || gun, force: opt.force}) }
ctx.halt = true;
Gun.is.node(node, map);
},-999);
return function(key, cb, opt){
var gun = this;
opt = Gun.text.is(opt)? {soul: opt} : opt || {};
cb = cb || function(){}; cb.hash = {};
if(!Gun.text.is(key) || !key){ return cb.call(gun, {err: Gun.log('No key!')}), gun }
function index(at){
var ctx = {node: gun.__.graph[at.soul]};
if(at.soul === key || at.key === key){ return }
if(cb.hash[at.hash = at.hash || Gun.on.at.hash(at)]){ return } cb.hash[at.hash] = true;
ctx.obj = (1 === Gun.is.node.soul(ctx.node, 'key'))? Gun.obj.copy(ctx.node) : Gun.obj.put({}, at.soul, Gun.is.rel.ify(at.soul));
Gun.obj.as((ctx.put = Gun.is.node.ify(ctx.obj, key, true))._, 'key', 1);
gun.__.gun.put(ctx.put, function(err, ok){cb.call(this, err, ok)}, {chain: opt.chain, key: true, init: true});
}
if(opt.soul){
index({soul: opt.soul});
return gun;
}
if(gun === gun.back){
cb.call(gun, {err: Gun.log('You have no context to `.key`', key, '!')});
} else {
gun._.at('soul').map(index);
}
return gun;
}
}());

29
src/list.js Normal file
View File

@ -0,0 +1,29 @@
// Arrays
module.exports = {
is: function(l){
return (l instanceof Array);
},
slit: Array.prototype.slice,
// creates a new sort function based off some field
sort: function(k){
return function(A,B){
if(!A || !B){ return 0 }
A = A[k];
B = B[k];
if(A < B){ return -1 }
else if(A > B){ return 1 }
else { return 0 }
}
},
map: function(l, c, _){
return obj.map(l, c, _)
},
// change this to 0 if you want non-logical, non-mathematical, non-matrix, non-convenient array notation
index: 1
}
var obj = require('./obj');

28
src/map.js Normal file
View File

@ -0,0 +1,28 @@
var Gun = require('./gun');
Gun.chain.map = function(cb, opt){
var u, gun = this, chain = gun.chain();
cb = cb || function(){}; cb.hash = {};
opt = Gun.bi.is(opt)? {change: opt} : opt || {};
opt.change = Gun.bi.is(opt.change)? opt.change : true;
function path(err, val, field){
if(err || (val === u)){ return }
cb.call(this, val, field);
}
function each(val, field){
//if(!Gun.is.rel(val)){ path.call(this.gun, null, val, field);return;}
cb.hash[this.soul + field] = cb.hash[this.soul + field] || this.gun.path(field, path, {chain: chain, via: 'map'}); // TODO: path should reuse itself! We shouldn't have to do it ourselves.
// TODO:
// 1. Ability to turn off an event. // automatically happens within path since reusing is manual?
// 2. Ability to pass chain context to fire on. // DONE
// 3. Pseudoness handled for us. // DONE
// 4. Reuse. // MANUALLY DONE
}
function map(at){
var ref = gun.__.by(at.soul).chain || gun;
Gun.is.node(at.change, each, {gun: ref, soul: at.soul});
}
gun.on(map, {raw: true, change: true}); // TODO: ALLOW USER TO DO map change false!
if(gun === gun.back){ Gun.log('You have no context to `.map`!') }
return chain;
}

104
src/node.js Normal file
View File

@ -0,0 +1,104 @@
var Gun = require('./gun');
Gun.is.val = function(v){ // Valid values are a subset of JSON: null, binary, number (!Infinity), text, or a soul relation. Arrays need special algorithms to handle concurrency, so they are not supported directly. Use an extension that supports them if needed but research their problems first.
if(v === null){ return true } // "deletes", nulling out fields.
if(v === Infinity){ return false } // we want this to be, but JSON does not support it, sad face.
if(Gun.bi.is(v) // by "binary" we mean boolean.
|| Gun.num.is(v)
|| Gun.text.is(v)){ // by "text" we mean strings.
return true; // simple values are valid.
}
return Gun.is.rel(v) || false; // is the value a soul relation? Then it is valid and return it. If not, everything else remaining is an invalid data type. Custom extensions can be built on top of these primitives to support other types.
}
Gun.is.rel = function(v){ // this defines whether an object is a soul relation or not, they look like this: {'#': 'UUID'}
if(Gun.obj.is(v)){ // must be an object.
var id;
Gun.obj.map(v, function(s, f){ // map over the object...
if(id){ return id = false } // if ID is already defined AND we're still looping through the object, it is considered invalid.
if(f == Gun._.soul && Gun.text.is(s)){ // the field should be '#' and have a text value.
id = s; // we found the soul!
} else {
return id = false; // if there exists anything else on the object that isn't the soul, then it is considered invalid.
}
});
if(id){ // a valid id was found.
return id; // yay! Return it.
}
}
return false; // the value was not a valid soul relation.
}
Gun.is.rel.ify = function(s){ var r = {}; return Gun.obj.put(r, Gun._.soul, s), r } // convert a soul into a relation and return it.
Gun.is.lex = function(l){ var r = true;
if(!Gun.obj.is(l)){ return false }
Gun.obj.map(l, function(v,f){
if(!Gun.obj.has(Gun._,f) || !(Gun.text.is(v) || Gun.obj.is(v))){ return r = false }
}); // TODO: What if the lex cursor has a document on the match, that shouldn't be allowed!
return r;
}
Gun.is.node = function(n, cb, t){ var s; // checks to see if an object is a valid node.
if(!Gun.obj.is(n)){ return false } // must be an object.
if(s = Gun.is.node.soul(n)){ // must have a soul on it.
return !Gun.obj.map(n, function(v, f){ // we invert this because the way we check for this is via a negation.
if(f == Gun._.meta){ return } // skip over the metadata.
if(!Gun.is.val(v)){ return true } // it is true that this is an invalid node.
if(cb){ cb.call(t, v, f, n) } // optionally callback each field/value.
});
}
return false; // nope! This was not a valid node.
}
Gun.is.node.ify = function(n, s, o){ // convert a shallow object into a node.
o = Gun.bi.is(o)? {force: o} : o || {}; // detect options.
n = Gun.is.node.soul.ify(n, s, o.force); // put a soul on it.
Gun.obj.map(n, function(v, f){ // iterate over each field/value.
if(Gun._.meta === f){ return } // ignore meta.
Gun.is.node.state.ify([n], f, v, o.state = o.state || Gun.time.now()); // and set the state for this field and value on this node.
});
return n; // This will only be a valid node if the object wasn't already deep!
}
Gun.is.node.soul = function(n, s){ return (n && n._ && n._[s || Gun._.soul]) || false } // convenience function to check to see if there is a soul on a node and return it.
Gun.is.node.soul.ify = function(n, s, o){ // put a soul on an object.
n = n || {}; // make sure it exists.
n._ = n._ || {}; // make sure meta exists.
n._[Gun._.soul] = o? s : n._[Gun._.soul] || s || Gun.text.random(); // if it already has a soul then use that instead - unless you force the soul you want with an option.
return n;
}
Gun.is.node.state = function(n, f){ return (f && n && n._ && n._[Gun._.state] && Gun.num.is(n._[Gun._.state][f]))? n._[Gun._.state][f] : false } // convenience function to get the state on a field on a node and return it.
Gun.is.node.state.ify = function(l, f, v, state){ // put a field's state and value on some nodes.
l = Gun.list.is(l)? l : [l]; // handle a list of nodes or just one node.
var l = l.reverse(), d = l[0]; // we might want to inherit the state from the last node in the list.
Gun.list.map(l, function(n, i){ // iterate over each node.
n = n || {}; // make sure it exists.
if(Gun.is.val(v)){ n[f] = v } // if we have a value, then put it.
n._ = n._ || {}; // make sure meta exists.
n = n._[Gun._.state] = n._[Gun._.state] || {}; // make sure HAM state exists.
if(i = d._[Gun._.state][f]){ n[f] = i } // inherit the state!
if(Gun.num.is(state)){ n[f] = state } // or manually set the state.
});
}
Gun.is.graph = function(g, cb, fn, t){ // checks to see if an object is a valid graph.
var exist = false;
if(!Gun.obj.is(g)){ return false } // must be an object.
return !Gun.obj.map(g, function(n, s){ // we invert this because the way we check for this is via a negation.
if(!n || s !== Gun.is.node.soul(n) || !Gun.is.node(n, fn)){ return true } // it is true that this is an invalid graph.
(cb || function(){}).call(t, n, s, function(fn){ // optional callback for each node.
if(fn){ Gun.is.node(n, fn, t) } // where we then have an optional callback for each field/value.
});
exist = true;
}) && exist; // makes sure it wasn't an empty object.
}
Gun.is.graph.ify = function(n){ var s; // wrap a node into a graph.
if(s = Gun.is.node.soul(n)){ // grab the soul from the node, if it is a node.
return Gun.obj.put({}, s, n); // then create and return a graph which has a node on the matching soul property.
}
}

30
src/not.js Normal file
View File

@ -0,0 +1,30 @@
var Gun = require('./gun');
Gun.chain.not = function(cb, opt){
var gun = this, chain = gun.chain();
cb = cb || function(){};
opt = opt || {};
function not(at,e){
if(at.field){
if(Gun.obj.has(gun.__.by(at.soul).node, at.field)){ return Gun.obj.del(at, 'not'), chain._.at(e).emit(at) }
} else
if(at.soul && gun.__.by(at.soul).node){ return Gun.obj.del(at, 'not'), chain._.at(e).emit(at) }
if(!at.not){ return }
var kick = function(next){
if(++kick.c){ return Gun.log("Warning! Multiple `not` resumes!"); }
next._.at.all(function(on ,e){ // TODO: BUG? Switch back to .at? I think .on is actually correct so it doesn't memorize. // TODO: BUG! What about other events?
chain._.at(e).emit(on);
});
};
kick.c = -1
kick.chain = gun.chain();
kick.next = cb.call(kick.chain, opt.raw? at : (at.field || at.soul || at.not), kick);
kick.soul = Gun.text.random();
if(Gun.is(kick.next)){ kick(kick.next) }
kick.chain._.at('soul').emit({soul: kick.soul, field: at.field, not: true, via: 'not'});
}
gun._.at.all(not);
if(gun === gun.back){ Gun.log('You have no context to `.not`!') }
chain._.not = true; // TODO: CLEAN UP! Would be ideal if we could accomplish this in a more elegant way.
return chain;
}

8
src/num.js Normal file
View File

@ -0,0 +1,8 @@
// Numbers
module.exports = {
is: function(n){
return !list.is(n) && (Infinity === n || n - parseFloat(n) + 1 >= 0);
}
}
var list = require('./list');

96
src/obj.js Normal file
View File

@ -0,0 +1,96 @@
// Objects
var fn = require('./fn');
var list = require('./list');
var obj = {
is: function(o) {
return !o || !o.constructor? false
: o.constructor === Object? true
: (!o.constructor.call
|| o.constructor.toString().match(/\[native\ code\]/))
? false : true;
}
}
obj.put = function(o, f, v){
return (o||{})[f] = v, o;
}
obj.del = function(o, k){
if(!o){ return }
o[k] = null;
delete o[k];
return true;
}
obj.ify = function(o){
if(obj.is(o)){ return o }
try{o = JSON.parse(o);
}catch(e){o={}};
return o;
}
// because http://web.archive.org/web/20140328224025/http://jsperf.com/cloning-an-object/2 . It is shockingly faster than anything else, and our data has to be a subset of JSON anyways!
obj.copy = function(o){
return !o? o : JSON.parse(JSON.stringify(o));
}
obj.as = function(b, f, d){
return b[f] = b[f] || (arguments.length >= 3? d : {});
}
obj.has = function(o, t){
return o && Object.prototype.hasOwnProperty.call(o, t);
}
obj.empty = function(o, n){
if(!o){ return true }
return obj.map(o,function(v,i){
if(n && (i === n || (obj.is(n) && obj.has(n, i)))){ return }
if(i){ return true }
})? false : true;
}
obj.map = function(l, c, _){
var u, i = 0, ii = 0, x, r, rr, ll, lle, f = fn.is(c),
t = function(k,v){
if(2 === arguments.length){
rr = rr || {};
rr[k] = v;
return;
} rr = rr || [];
rr.push(k);
};
if(Object.keys && obj.is(l)){
ll = Object.keys(l); lle = true;
}
if(list.is(l) || ll){
x = (ll || l).length;
for(;i < x; i++){
ii = (i + list.index);
if(f){
r = lle? c.call(_ || this, l[ll[i]], ll[i], t) : c.call(_ || this, l[i], ii, t);
if(r !== u){ return r }
} else {
//if(Type.test.is(c,l[i])){ return ii } // should implement deep equality testing!
if(c === l[lle? ll[i] : i]){ return ll? ll[i] : ii } // use this for now
}
}
} else {
for(i in l){
if(f){
if(obj.has(l,i)){
r = _? c.call(_, l[i], i, t) : c(l[i], i, t);
if(r !== u){ return r }
}
} else {
//if(a.test.is(c,l[i])){ return i } // should implement deep equality testing!
if(c === l[i]){ return i } // use this for now
}
}
}
return f? rr : list.index? 0 : -1;
}
module.exports = obj;

20
src/on.js Normal file
View File

@ -0,0 +1,20 @@
var Gun = require('./gun');
Gun.chain.on = function(cb, opt){ // on subscribes to any changes on the souls.
var gun = this, u;
opt = Gun.obj.is(opt)? opt : {change: opt};
cb = cb || function(){};
function map(at){
opt.on = opt.on || this;
var ctx = {by: gun.__.by(at.soul)}, change = ctx.by.node;
if(opt.on.stat && opt.on.stat.first){ (at = Gun.on.at.copy(at)).change = ctx.by.node }
if(opt.raw){ return cb.call(opt.on, at) }
if(opt.once){ this.off() }
if(opt.change){ change = at.change }
if(!opt.empty && Gun.obj.empty(change, Gun._.meta)){ return }
cb.call(ctx.by.chain || gun, Gun.obj.copy(at.field? change[at.field] : change), at.field || (at.at && at.at.field));
};
opt.on = gun._.at('soul').map(map);
if(gun === gun.back){ Gun.log('You have no context to `.on`!') }
return gun;
}

25
src/opt.js Normal file
View File

@ -0,0 +1,25 @@
var Gun = require('./gun');
Gun.chain.opt = function(opt, stun){
opt = opt || {};
var gun = this, root = (gun.__ && gun.__.gun)? gun.__.gun : (gun._ = gun.__ = {gun: gun}).gun.chain(); // if root does not exist, then create a root chain.
root.__.by = root.__.by || function(f){ return gun.__.by[f] = gun.__.by[f] || {} };
root.__.graph = root.__.graph || {};
root.__.opt = root.__.opt || {};
root.__.opt.wire = root.__.opt.wire || {};
if(Gun.text.is(opt)){ opt = {peers: opt} }
if(Gun.list.is(opt)){ opt = {peers: opt} }
if(Gun.text.is(opt.peers)){ opt.peers = [opt.peers] }
if(Gun.list.is(opt.peers)){ opt.peers = Gun.obj.map(opt.peers, function(n,f,m){ m(n,{}) }) }
root.__.opt.peers = opt.peers || gun.__.opt.peers || {};
Gun.obj.map(opt.wire, function(h, f){
if(!Gun.fns.is(h)){ return }
root.__.opt.wire[f] = h;
});
Gun.obj.map(['key', 'on', 'path', 'map', 'not', 'init'], function(f){
if(!opt[f]){ return }
root.__.opt[f] = opt[f] || root.__.opt[f];
});
if(!stun){ Gun.on('opt').emit(root, opt) }
return gun;
}

90
src/path.js Normal file
View File

@ -0,0 +1,90 @@
var Gun = require('./gun');
Gun.chain.path = (function(){
Gun.on('get').event(function(gun, at, ctx, opt, cb, lex){
if(ctx.halt){ return } // TODO: CLEAN UP with event emitter option?
if(opt.path){ at.at = opt.path }
var xtc = {soul: lex[Gun._.soul], field: lex[Gun._.field]};
xtc.change = at.change || gun.__.by(at.soul).node;
if(xtc.field){ // TODO: future feature!
if(!Gun.obj.has(xtc.change, xtc.field)){ return }
ctx.node = Gun.is.node.soul.ify({}, at.soul); // TODO: CLEAN UP! ctx.node usage.
Gun.is.node.state.ify([ctx.node, xtc.change], xtc.field, xtc.change[xtc.field]);
at.change = ctx.node; at.field = xtc.field;
}
},-99);
Gun.on('get').event(function(gun, at, ctx, opt, cb, lex){
if(ctx.halt){ return } // TODO: CLEAN UP with event emitter option?
var xtc = {}; xtc.change = at.change || gun.__.by(at.soul).node;
if(!opt.put){ // TODO: CLEAN UP be nice if path didn't have to worry about this.
Gun.is.node(xtc.change, function(v,f){
var fat = Gun.on.at.copy(at); fat.field = f; fat.value = v;
Gun.obj.del(fat, 'at'); // TODO: CLEAN THIS UP! It would be nice in every other function every where else it didn't matter whether there was a cascading at.at.at.at or not, just and only whether the current context as a field or should rely on a previous field. But maybe that is the gotcha right there?
fat.change = fat.change || xtc.change;
if(v = Gun.is.rel(fat.value)){ fat = {soul: v, at: fat} }
gun._.at('path:' + f).emit(fat).chain(opt.chain);
});
}
if(!ctx.end){
ctx.end = gun._.at('end').emit(at).chain(opt.chain);
}
},99);
return function(path, cb, opt){
opt = opt || {};
cb = cb || (function(){ var cb = function(){}; cb.no = true; return cb }()); cb.hash = {};
var gun = this, chain = gun.chain(), f, c, u;
if(!Gun.list.is(path)){ if(!Gun.text.is(path)){ if(!Gun.num.is(path)){ // if not a list, text, or number
return cb.call(chain, {err: Gun.log("Invalid path '" + path + "'!")}), chain; // then complain
} else { return this.path(path + '', cb, opt) } } else { return this.path(path.split('.'), cb, opt) } } // else coerce upward to a list.
if(gun === gun.back){
cb.call(chain, opt.put? null : {err: Gun.log('You have no context to `.path`', path, '!')});
return chain;
}
gun._.at('path:' + path[0]).event(function(at){
if(opt.done){ this.off(); return } // TODO: BUG - THIS IS A FIX FOR A BUG! TEST #"context no double emit", COMMENT THIS LINE OUT AND SEE IT FAIL!
var ctx = {soul: at.soul, field: at.field, by: gun.__.by(at.soul)}, field = path[0];
var on = Gun.obj.as(cb.hash, at.hash, {off: function(){}});
if(at.soul === on.soul){ return }
else { on.off() }
if(ctx.rel = (Gun.is.rel(at.value) || Gun.is.rel(at.at && at.at.value))){
if(opt.put && 1 === path.length){
return cb.call(ctx.by.chain || chain, null, Gun.is.node.soul.ify({}, ctx.rel));
}
var get = function(err, node){
if(!err && 1 !== path.length){ return }
cb.call(this, err, node, field);
};
ctx.opt = {chain: opt.chain || chain, put: opt.put, path: {soul: (at.at && at.at.soul) || at.soul, field: field }};
gun.__.gun.get(ctx.rel || at.soul, cb.no? null : get, ctx.opt);
(opt.on = cb.hash[at.hash] = on = ctx.opt.on).soul = at.soul; // TODO: BUG! CB getting reused as the hash point for multiple paths potentially! Could cause problems!
return;
}
if(1 === path.length){ cb.call(ctx.by.chain || chain, null, at.value, ctx.field) }
chain._.at('soul').emit(at).chain(opt.chain);
});
gun._.at('null').only(function(at){
if(!at.field){ return }
if(at.not){
gun.put({}, null, {init: true});
if(opt.init || gun.__.opt.init){ return }
}
(at = Gun.on.at.copy(at)).field = path[0];
at.not = true;
chain._.at('null').emit(at).chain(opt.chain);
});
gun._.at('end').event(function(at){
this.off();
if(at.at && at.at.field === path[0]){ return } // TODO: BUG! THIS FIXES SO MANY PROBLEMS BUT DOES IT CATCH VARYING SOULS EDGE CASE?
var ctx = {by: gun.__.by(at.soul)};
if(Gun.obj.has(ctx.by.node, path[0])){ return }
(at = Gun.on.at.copy(at)).field = path[0];
at.not = true;
cb.call(ctx.by.chain || chain, null);
chain._.at('null').emit(at).chain(opt.chain);
});
if(path.length > 1){
(c = chain.path(path.slice(1), cb, opt)).back = gun;
}
return c || chain;
}
}());

98
src/put.js Normal file
View File

@ -0,0 +1,98 @@
var Gun = require('./gun');
Gun.chain.put = function(val, cb, opt){
opt = opt || {};
cb = cb || function(){}; cb.hash = {};
var gun = this, chain = gun.chain(), tmp = {val: val}, drift = Gun.time.now();
function put(at){
var val = tmp.val;
var ctx = {obj: val}; // prep the value for serialization
ctx.soul = at.field? at.soul : (at.at && at.at.soul) || at.soul; // figure out where we are
ctx.field = at.field? at.field : (at.at && at.at.field) || at.field; // did we come from some where?
if(Gun.is(val)){
if(!ctx.field){ return cb.call(chain, {err: ctx.err = Gun.log('No field to link node to!')}), chain._.at('err').emit(ctx.err) }
return val.val(function(node){
var soul = Gun.is.node.soul(node);
if(!soul){ return cb.call(chain, {err: ctx.err = Gun.log('Only a node can be linked! Not "' + node + '"!')}), chain._.at('err').emit(ctx.err) }
tmp.val = Gun.is.rel.ify(soul);
put(at);
});
}
if(cb.hash[at.hash = at.hash || Gun.on.at.hash(at)]){ return } // if we have already seen this hash...
cb.hash[at.hash] = true; // else mark that we're processing the data (failure to write could still occur).
ctx.by = chain.__.by(ctx.soul);
ctx.not = at.not || (at.at && at.at.not);
Gun.obj.del(at, 'not'); Gun.obj.del(at.at || at, 'not'); // the data is no longer not known! // TODO: BUG! It could have been asynchronous by the time we now delete these properties. Don't other parts of the code assume their deletion is synchronous?
if(ctx.field){ Gun.obj.as(ctx.obj = {}, ctx.field, val) } // if there is a field, then data is actually getting put on the parent.
else if(!Gun.obj.is(val)){ return cb.call(chain, ctx.err = {err: Gun.log("No node exists to put " + (typeof val) + ' "' + val + '" in!')}), chain._.at('err').emit(ctx.err) } // if the data is a primitive and there is no context for it yet, then we have an error.
// TODO: BUG? gun.get(key).path(field).put() isn't doing it as pseudo.
function soul(env, cb, map){ var eat;
if(!env || !(eat = env.at) || !env.at.node){ return }
if(!eat.node._){ eat.node._ = {} }
if(!eat.node._[Gun._.state]){ eat.node._[Gun._.state] = {} }
if(!Gun.is.node.soul(eat.node)){
if(ctx.obj === eat.obj){
Gun.obj.as(env.graph, eat.soul = Gun.obj.as(eat.node._, Gun._.soul, Gun.is.node.soul(eat.obj) || ctx.soul), eat.node);
cb(eat, eat.soul);
} else {
var path = function(err, node){
if(path.opt && path.opt.on && path.opt.on.off){ path.opt.on.off() }
if(path.opt.done){ return }
path.opt.done = true;
if(err){ env.err = err }
eat.soul = Gun.is.node.soul(node) || Gun.is.node.soul(eat.obj) || Gun.is.node.soul(eat.node) || Gun.text.random();
Gun.obj.as(env.graph, Gun.obj.as(eat.node._, Gun._.soul, eat.soul), eat.node);
cb(eat, eat.soul);
}; path.opt = {put: true};
(ctx.not)? path() : ((at.field || at.at)? gun.back : gun).path(eat.path || [], path, path.opt);
}
}
if(!eat.field){ return }
eat.node._[Gun._.state][eat.field] = drift;
}
function end(err, ify){
ctx.ify = ify;
Gun.on('put').emit(chain, at, ctx, opt, cb, val);
if(err || ify.err){ return cb.call(chain, err || ify.err), chain._.at('err').emit(err || ify.err) } // check for serialization error, emit if so.
if(err = Gun.union(chain, ify.graph, {end: false, soul: function(soul){
if(chain.__.by(soul).end){ return }
Gun.union(chain, Gun.is.node.soul.ify({}, soul)); // fire off an end node if there hasn't already been one, to comply with the wire spec.
}}).err){ return cb.call(chain, err), chain._.at('err').emit(err) } // now actually union the serialized data, emit error if any occur.
if(Gun.fns.is(end.wire = chain.__.opt.wire.put)){
var wcb = function(err, ok, info){
if(err){ return Gun.log(err.err || err), cb.call(chain, err), chain._.at('err').emit(err) }
return cb.call(chain, err, ok);
}
end.wire(ify.graph, wcb, opt);
} else {
if(!Gun.log.count('no-wire-put')){ Gun.log("Warning! You have no persistence layer to save to!") }
cb.call(chain, null); // This is in memory success, hardly "success" at all.
}
if(ctx.field){
return gun.back.path(ctx.field, null, {chain: opt.chain || chain});
}
if(ctx.not){
return gun.__.gun.get(ctx.soul, null, {chain: opt.chain || chain});
}
chain.get(ctx.soul, null, {chain: opt.chain || chain, at: gun._.at })
}
Gun.ify(ctx.obj, soul, {pure: true})(end); // serialize the data!
}
if(gun === gun.back){ // if we are the root chain...
put({soul: Gun.is.node.soul(val) || Gun.text.random(), not: true}); // then cause the new chain to save data!
} else { // else if we are on an existing chain then...
gun._.at('soul').map(put); // put data on every soul that flows through this chain.
var back = function(gun){
if(back.get || gun.back === gun || gun._.not){ return } // TODO: CLEAN UP! Would be ideal to accomplish this in a more ideal way.
if(gun._.get){ back.get = true }
gun._.at('null').event(function(at){
if(opt.init || gun.__.opt.init){ return Gun.log("Warning! You have no context to `.put`", val, "!") }
gun.init();
}, -999);
return back(gun.back);
};
if(!opt.init && !gun.__.opt.init){ back(gun) }
}
chain.back = gun.back;
return chain;
}

44
src/schedule.js Normal file
View File

@ -0,0 +1,44 @@
// Generic javascript scheduler utility.
var fn = require('./fn');
var list = require('./list');
var time = require('./time');
var schedule = function(state, cb){ // maybe use lru-cache?
schedule.waiting.push({when: state, event: cb || function(){}});
if(schedule.soonest < state){ return }
schedule.set(state);
}
schedule.waiting = [];
schedule.soonest = Infinity;
schedule.sort = list.sort('when');
schedule.set = function(future){
if(Infinity <= (schedule.soonest = future)){ return }
var now = time.now(); // WAS time.is() TODO: Hmmm, this would make it hard for every gun instance to have their own version of time.
future = (future <= now)? 0 : (future - now);
clearTimeout(schedule.id);
schedule.id = setTimeout(schedule.check, future);
}
schedule.check = function(){
var now = time.now(), soonest = Infinity; // WAS time.is() TODO: Same as above about time. Hmmm.
schedule.waiting.sort(schedule.sort);
schedule.waiting = list.map(schedule.waiting, function(wait, i, map){
if(!wait){ return }
if(wait.when <= now){
if(fn.is(wait.event)){
setTimeout(function(){ wait.event() },0);
}
} else {
soonest = (soonest < wait.when)? soonest : wait.when;
map(wait);
}
}) || [];
schedule.set(soonest);
}
module.exports = schedule;

16
src/set.js Normal file
View File

@ -0,0 +1,16 @@
var Gun = require('./gun');
Gun.chain.set = function(item, cb, opt){
var gun = this, ctx = {}, chain;
cb = cb || function(){};
if(!Gun.is(item)){ return cb.call(gun, {err: Gun.log('Set only supports node references currently!')}), gun } // TODO: Bug? Should we return not gun on error?
(ctx.chain = item.chain()).back = gun;
ctx.chain._ = item._;
item.val(function(node){ // TODO: BUG! Return proxy chain with back = list.
if(ctx.done){ return } ctx.done = true;
var put = {}, soul = Gun.is.node.soul(node);
if(!soul){ return cb.call(gun, {err: Gun.log('Only a node can be linked! Not "' + node + '"!')}) }
gun.put(Gun.obj.put(put, soul, Gun.is.rel.ify(soul)), cb, opt);
});
return ctx.chain;
}

298
src/tab.js Normal file
View File

@ -0,0 +1,298 @@
;(function(Tab){
if(typeof window === "undefined"){ return }
if(!window.JSON){ throw new Error("Include JSON first: ajax.cdnjs.com/ajax/libs/json2/20110223/json2.js") } // for old IE use
;(function(exports){
function s(){}
s.put = function(key, val, cb){ try{ store.setItem(key, Gun.text.ify(val)) }catch(e){if(cb)cb(e)} }
s.get = function(key, cb){ /*setTimeout(function(){*/ try{ cb(null, Gun.obj.ify(store.getItem(key) || null)) }catch(e){cb(e)} /*},1)*/}
s.del = function(key){ return store.removeItem(key) }
var store = this.localStorage || {setItem: function(){}, removeItem: function(){}, getItem: function(){}};
exports.store = s;
}.bind(this || module)(Tab));
Gun.on('opt').event(function(gun, opt){
opt = opt || {};
var tab = gun.tab = gun.tab || {};
tab.store = tab.store || Tab.store;
tab.request = tab.request || request;
tab.request.s = tab.request.s || {};
tab.headers = opt.headers || {};
tab.headers['gun-sid'] = tab.headers['gun-sid'] || Gun.text.random(); // stream id
tab.prefix = tab.prefix || opt.prefix || 'gun/';
tab.get = tab.get || function(lex, cb, opt){
if(!lex){ return }
var soul = lex[Gun._.soul];
if(!soul){ return }
cb = cb || function(){};
(opt.headers = Gun.obj.copy(tab.headers)).id = tab.msg();
(function local(soul, cb){
tab.store.get(tab.prefix + soul, function(err, data){
if(!data){ return } // let the peers handle no data.
if(err){ return cb(err) }
cb(err, cb.node = data); // node
cb(err, Gun.is.node.soul.ify({}, Gun.is.node.soul(data))); // end
cb(err, {}); // terminate
});
}(soul, cb));
if(!(cb.local = opt.local)){
tab.request.s[opt.headers.id] = tab.error(cb, "Error: Get failed!", function(reply){
setTimeout(function(){ tab.put(Gun.is.graph.ify(reply.body), function(){}, {local: true, peers: {}}) },1); // and flush the in memory nodes of this graph to localStorage after we've had a chance to union on it.
});
Gun.obj.map(opt.peers || gun.__.opt.peers, function(peer, url){ var p = {};
tab.request(url, lex, tab.request.s[opt.headers.id], opt);
cb.peers = true;
});
var node = gun.__.graph[soul];
if(node){
tab.put(Gun.is.graph.ify(node));
}
} tab.peers(cb);
}
tab.put = tab.put || function(graph, cb, opt){
//console.log("SAVE", graph);
cb = cb || function(){};
opt = opt || {};
(opt.headers = Gun.obj.copy(tab.headers)).id = tab.msg();
Gun.is.graph(graph, function(node, soul){
if(!gun.__.graph[soul]){ return }
tab.store.put(tab.prefix + soul, gun.__.graph[soul], function(err){if(err){ cb({err: err}) }});
});
if(!(cb.local = opt.local)){
tab.request.s[opt.headers.id] = tab.error(cb, "Error: Put failed!");
Gun.obj.map(opt.peers || gun.__.opt.peers, function(peer, url){
tab.request(url, graph, tab.request.s[opt.headers.id], opt);
cb.peers = true;
});
} tab.peers(cb);
}
tab.error = function(cb, error, fn){
return function(err, reply){
reply.body = reply.body || reply.chunk || reply.end || reply.write;
if(err || !reply || (err = reply.body && reply.body.err)){
return cb({err: Gun.log(err || error) });
}
if(fn){ fn(reply) }
cb(null, reply.body);
}
}
tab.peers = function(cb, o){
if(Gun.text.is(cb)){ return (o = {})[cb] = {}, o }
if(cb && !cb.peers){ setTimeout(function(){
if(!cb.local){ if(!Gun.log.count('no-peers')){ Gun.log("Warning! You have no peers to connect to!") } }
if(!(cb.graph || cb.node)){ cb(null) }
},1)}
}
tab.msg = tab.msg || function(id){
if(!id){
return tab.msg.debounce[id = Gun.text.random(9)] = Gun.time.is(), id;
}
clearTimeout(tab.msg.clear);
tab.msg.clear = setTimeout(function(){
var now = Gun.time.is();
Gun.obj.map(tab.msg.debounce, function(t,id){
if(now - t < 1000 * 60 * 5){ return }
Gun.obj.del(tab.msg.debounce, id);
});
},500);
if(id = tab.msg.debounce[id]){
return tab.msg.debounce[id] = Gun.time.is(), id;
}
};
tab.msg.debounce = tab.msg.debounce || {};
tab.server = tab.server || function(req, res){
if(!req || !res || !req.body || !req.headers || !req.headers.id){ return }
if(tab.request.s[req.headers.rid]){ return tab.request.s[req.headers.rid](null, req) }
if(tab.msg(req.headers.id)){ return }
// TODO: Re-emit message to other peers if we have any non-overlaping ones.
if(req.headers.rid){ return } // no need to process
if(Gun.is.lex(req.body)){ return tab.server.get(req, res) }
else { return tab.server.put(req, res) }
}
tab.server.json = 'application/json';
tab.server.regex = gun.__.opt.route = gun.__.opt.route || opt.route || /^\/gun/i;
tab.server.get = function(req, cb){
var soul = req.body[Gun._.soul], node;
if(!(node = gun.__.graph[soul])){ return }
var reply = {headers: {'Content-Type': tab.server.json, rid: req.headers.id, id: tab.msg()}};
cb({headers: reply.headers, body: node});
}
tab.server.put = function(req, cb){
var reply = {headers: {'Content-Type': tab.server.json, rid: req.headers.id, id: tab.msg()}}, keep;
if(!req.body){ return cb({headers: reply.headers, body: {err: "No body"}}) }
if(!Gun.obj.is(req.body, function(node, soul){
if(gun.__.graph[soul]){ return true }
})){ return }
if(req.err = Gun.union(gun, req.body, function(err, ctx){
if(err){ return cb({headers: reply.headers, body: {err: err || "Union failed."}}) }
var ctx = ctx || {}; ctx.graph = {};
Gun.is.graph(req.body, function(node, soul){ ctx.graph[soul] = gun.__.graph[soul] });
gun.__.opt.wire.put(ctx.graph, function(err, ok){
if(err){ return cb({headers: reply.headers, body: {err: err || "Failed."}}) }
cb({headers: reply.headers, body: {ok: ok || "Persisted."}});
}, {local: true, peers: {}});
}).err){ cb({headers: reply.headers, body: {err: req.err || "Union failed."}}) }
}
Gun.obj.map(gun.__.opt.peers, function(){ // only create server if peers and do it once by returning immediately.
return (tab.server.able = tab.server.able || tab.request.createServer(tab.server) || true);
});
gun.__.opt.wire.get = gun.__.opt.wire.get || tab.get;
gun.__.opt.wire.put = gun.__.opt.wire.put || tab.put;
gun.__.opt.wire.key = gun.__.opt.wire.key || tab.key;
});
var request = (function(){
function r(base, body, cb, opt){
opt = opt || (base.length? {base: base} : base);
opt.base = opt.base || base;
opt.body = opt.body || body;
cb = cb || function(){};
if(!opt.base){ return }
r.transport(opt, cb);
}
r.createServer = function(fn){ r.createServer.s.push(fn) }
r.createServer.ing = function(req, cb){
var i = r.createServer.s.length;
while(i--){ (r.createServer.s[i] || function(){})(req, cb) }
}
r.createServer.s = [];
r.back = 2; r.backoff = 2;
r.transport = function(opt, cb){
//Gun.log("TRANSPORT:", opt);
if(r.ws(opt, cb)){ return }
r.jsonp(opt, cb);
}
r.ws = function(opt, cb){
var ws, WS = window.WebSocket || window.mozWebSocket || window.webkitWebSocket;
if(!WS){ return }
if(ws = r.ws.peers[opt.base]){
if(!ws.readyState){ return setTimeout(function(){ r.ws(opt, cb) },10), true }
var req = {};
if(opt.headers){ req.headers = opt.headers }
if(opt.body){ req.body = opt.body }
if(opt.url){ req.url = opt.url }
req.headers = req.headers || {};
r.ws.cbs[req.headers['ws-rid'] = 'WS' + (+ new Date()) + '.' + Math.floor((Math.random()*65535)+1)] = function(err,res){
if(res.body || res.end){ delete r.ws.cbs[req.headers['ws-rid']] }
cb(err,res);
}
ws.send(JSON.stringify(req));
return true;
}
if(ws === false){ return }
ws = r.ws.peers[opt.base] = new WS(opt.base.replace('http','ws'));
ws.onopen = function(o){ r.back = 2; r.ws(opt, cb) };
ws.onclose = window.onbeforeunload = function(c){
if(!c){ return }
if(ws && ws.close instanceof Function){ ws.close() }
if(1006 === c.code){ // websockets cannot be used
/*ws = r.ws.peers[opt.base] = false; // 1006 has mixed meanings, therefore we can no longer respect it.
r.transport(opt, cb);
return;*/
}
ws = r.ws.peers[opt.base] = null; // this will make the next request try to reconnect
setTimeout(function(){
r.ws(opt, function(){}); // opt here is a race condition, is it not? Does this matter?
}, r.back *= r.backoff);
};
ws.onmessage = function(m){
if(!m || !m.data){ return }
var res;
try{res = JSON.parse(m.data);
}catch(e){ return }
if(!res){ return }
res.headers = res.headers || {};
if(res.headers['ws-rid']){ return (r.ws.cbs[res.headers['ws-rid']]||function(){})(null, res) }
//Gun.log("We have a pushed message!", res);
if(res.body){ r.createServer.ing(res, function(res){ r(opt.base, null, null, res)}) } // emit extra events.
};
ws.onerror = function(e){ Gun.log(e); };
return true;
}
r.ws.peers = {};
r.ws.cbs = {};
r.jsonp = function(opt, cb){
//Gun.log("jsonp send", opt);
r.jsonp.ify(opt, function(url){
//Gun.log(url);
if(!url){ return }
r.jsonp.send(url, function(reply){
//Gun.log("jsonp reply", reply);
cb(null, reply);
r.jsonp.poll(opt, reply);
}, opt.jsonp);
});
}
r.jsonp.send = function(url, cb, id){
var js = document.createElement('script');
js.src = url;
window[js.id = id] = function(res){
cb(res);
cb.id = js.id;
js.parentNode.removeChild(js);
window[cb.id] = null; // TODO: BUG: This needs to handle chunking!
try{delete window[cb.id];
}catch(e){}
}
js.async = true;
document.getElementsByTagName('head')[0].appendChild(js);
return js;
}
r.jsonp.poll = function(opt, res){
if(!opt || !opt.base || !res || !res.headers || !res.headers.poll){ return }
(r.jsonp.poll.s = r.jsonp.poll.s || {})[opt.base] = r.jsonp.poll.s[opt.base] || setTimeout(function(){ // TODO: Need to optimize for Chrome's 6 req limit?
//Gun.log("polling again");
var o = {base: opt.base, headers: {pull: 1}};
r.each(opt.headers, function(v,i){ o.headers[i] = v })
r.jsonp(o, function(err, reply){
delete r.jsonp.poll.s[opt.base];
while(reply.body && reply.body.length && reply.body.shift){ // we're assuming an array rather than chunk encoding. :(
var res = reply.body.shift();
//Gun.log("-- go go go", res);
if(res && res.body){ r.createServer.ing(res, function(){ r(opt.base, null, null, res) }) } // emit extra events.
}
});
}, res.headers.poll);
}
r.jsonp.ify = function(opt, cb){
var uri = encodeURIComponent, q = '?';
if(opt.url && opt.url.pathname){ q = opt.url.pathname + q; }
q = opt.base + q;
r.each((opt.url||{}).query, function(v, i){ q += uri(i) + '=' + uri(v) + '&' });
if(opt.headers){ q += uri('`') + '=' + uri(JSON.stringify(opt.headers)) + '&' }
if(r.jsonp.max < q.length){ return cb() }
q += uri('jsonp') + '=' + uri(opt.jsonp = 'P'+Math.floor((Math.random()*65535)+1));
if(opt.body){
q += '&';
var w = opt.body, wls = function(w,l,s){
return uri('%') + '=' + uri(w+'-'+(l||w)+'/'+(s||w)) + '&' + uri('$') + '=';
}
if(typeof w != 'string'){
w = JSON.stringify(w);
q += uri('^') + '=' + uri('json') + '&';
}
w = uri(w);
var i = 0, l = w.length
, s = r.jsonp.max - (q.length + wls(l.toString()).length);
if(s < 0){ return cb() }
while(w){
cb(q + wls(i, (i = i + s), l) + w.slice(0, i));
w = w.slice(i);
}
} else {
cb(q);
}
}
r.jsonp.max = 2000;
r.each = function(obj, cb){
if(!obj || !cb){ return }
for(var i in obj){
if(obj.hasOwnProperty(i)){
cb(obj[i], i);
}
}
}
return r;
}());
}({}));

50
src/text.js Normal file
View File

@ -0,0 +1,50 @@
// Strings
var list = require('./list');
var obj = require('./obj');
var text = {
is: function(t){
return (typeof t == 'string');
}
}
text.ify = function(t){
if(text.is(t)){ return t }
if(typeof JSON !== "undefined"){ return JSON.stringify(t) }
return (t && t.toString)? t.toString() : t;
}
text.random = function(l, c){
var s = '';
l = l || 24; // you are not going to make a 0 length random number, so no need to check type
c = c || '0123456789ABCDEFGHIJKLMNOPQRSTUVWXZabcdefghijklmnopqrstuvwxyz';
while(l > 0){ s += c.charAt(Math.floor(Math.random() * c.length)); l-- }
return s;
}
text.match = function(t, o){ var r = false;
t = t || '';
o = text.is(o)? {'=': o} : o || {}; // {'~', '=', '*', '<', '>', '+', '-', '?', '!'} // ignore uppercase, exactly equal, anything after, lexically larger, lexically lesser, added in, subtacted from, questionable fuzzy match, and ends with.
if(obj.has(o,'~')){ t = t.toLowerCase() }
if(obj.has(o,'=')){ return t === o['='] }
if(obj.has(o,'*')){ if(t.slice(0, o['*'].length) === o['*']){ r = true; t = t.slice(o['*'].length) } else { return false }}
if(obj.has(o,'!')){ if(t.slice(-o['!'].length) === o['!']){ r = true } else { return false }}
if(obj.has(o,'+')){
if(list.map(list.is(o['+'])? o['+'] : [o['+']], function(m){
if(t.indexOf(m) >= 0){ r = true } else { return true }
})){ return false }
}
if(obj.has(o,'-')){
if(list.map(list.is(o['-'])? o['-'] : [o['-']], function(m){
if(t.indexOf(m) < 0){ r = true } else { return true }
})){ return false }
}
if(obj.has(o,'>')){ if(t > o['>']){ r = true } else { return false }}
if(obj.has(o,'<')){ if(t < o['<']){ r = true } else { return false }}
function fuzzy(t,f){ var n = -1, i = 0, c; for(;c = f[i++];){ if(!~(n = t.indexOf(c, n+1))){ return false }} return true } // via http://stackoverflow.com/questions/9206013/javascript-fuzzy-search
if(obj.has(o,'?')){ if(fuzzy(t, o['?'])){ r = true } else { return false }} // change name!
return r;
}
module.exports = text;

13
src/time.js Normal file
View File

@ -0,0 +1,13 @@
// Time
var time = {
is: function(t){
return t? t instanceof Date : (+new Date().getTime());
},
now: function(t){
// TODO: BUG! Causes lots of terrible problems.
return ((t=t||time.is()) > (time.now.last || -Infinity)? (time.now.last = t) : time.now(t + 1)) + (time.now.drift || 0); // TODO: BUG? Should this go on the inside?
}
}
module.exports = time;

123
src/union.js Normal file
View File

@ -0,0 +1,123 @@
var Gun = require('./gun');
Gun.union = function(gun, prime, cb, opt){ // merge two graphs into the first.
var opt = opt || Gun.obj.is(cb)? cb : {};
var ctx = {graph: gun.__.graph, count: 0};
ctx.cb = function(){
cb = Gun.fns.is(cb)? cb() && null : null;
}
if(!ctx.graph){ ctx.err = {err: Gun.log("No graph!") } }
if(!prime){ ctx.err = {err: Gun.log("No data to merge!") } }
if(ctx.soul = Gun.is.node.soul(prime)){ prime = Gun.is.graph.ify(prime) }
if(!Gun.is.graph(prime, null, function(val, field, node){ var meta;
if(!Gun.num.is(Gun.is.node.state(node, field))){
return ctx.err = {err: Gun.log("No state on '" + field + "'!") }
}
}) || ctx.err){ return ctx.err = ctx.err || {err: Gun.log("Invalid graph!", prime)}, ctx }
function emit(at){
Gun.on('operating').emit(gun, at);
}
(function union(graph, prime){
var prime = Gun.obj.map(prime, function(n,s,t){t(n)}).sort(function(A,B){
var s = Gun.is.node.soul(A);
if(graph[s]){ return 1 }
return 0;
});
ctx.count += 1;
ctx.err = Gun.list.map(prime, function(node, soul){
soul = Gun.is.node.soul(node);
if(!soul){ return {err: Gun.log("Soul missing or mismatching!")} }
ctx.count += 1;
var vertex = graph[soul];
if(!vertex){ graph[soul] = vertex = Gun.is.node.ify({}, soul) }
Gun.union.HAM(vertex, node, function(vertex, field, val, state){
Gun.on('historical').emit(gun, {soul: soul, field: field, value: val, state: state, change: node});
gun.__.on('historical').emit({soul: soul, field: field, change: node});
}, function(vertex, field, val, state){
if(!vertex){ return }
var change = Gun.is.node.soul.ify({}, soul);
if(field){
Gun.is.node.state.ify([vertex, change, node], field, val);
}
emit({soul: soul, field: field, value: val, state: state, change: change});
}, function(vertex, field, val, state){
Gun.on('deferred').emit(gun, {soul: soul, field: field, value: val, state: state, change: node});
})(function(){
emit({soul: soul, change: node});
if(opt.soul){ opt.soul(soul) }
if(!(ctx.count -= 1)){ ctx.cb() }
}); // TODO: BUG? Handle error!
});
ctx.count -= 1;
})(ctx.graph, prime);
if(!ctx.count){ ctx.cb() }
return ctx;
}
Gun.union.ify = function(gun, prime, cb, opt){
if(gun){ gun = (gun.__ && gun.__.graph)? gun.__.graph : gun }
if(Gun.text.is(prime)){
if(gun && gun[prime]){
prime = gun[prime];
} else {
return Gun.is.node.ify({}, prime);
}
}
var vertex = Gun.is.node.soul.ify({}, Gun.is.node.soul(prime)), prime = Gun.is.graph.ify(prime) || prime;
if(Gun.is.graph(prime, null, function(val, field){ var node;
function merge(a, f, v){ Gun.is.node.state.ify(a, f, v) }
if(Gun.is.rel(val)){ node = gun? gun[field] || prime[field] : prime[field] }
Gun.union.HAM(vertex, node, function(){}, function(vert, f, v){
merge([vertex, node], f, v);
}, function(){})(function(err){
if(err){ merge([vertex], field, val) }
})
})){ return vertex }
}
Gun.union.HAM = function(vertex, delta, lower, now, upper){
upper.max = -Infinity;
now.end = true;
delta = delta || {};
vertex = vertex || {};
Gun.obj.map(delta._, function(v,f){
if(Gun._.state === f || Gun._.soul === f){ return }
vertex._[f] = v;
});
if(!Gun.is.node(delta, function update(incoming, field){
now.end = false;
var ctx = {incoming: {}, current: {}}, state;
ctx.drift = Gun.time.now(); // DANGEROUS!
ctx.incoming.value = Gun.is.rel(incoming) || incoming;
ctx.current.value = Gun.is.rel(vertex[field]) || vertex[field];
ctx.incoming.state = Gun.num.is(ctx.tmp = ((delta._||{})[Gun._.state]||{})[field])? ctx.tmp : -Infinity;
ctx.current.state = Gun.num.is(ctx.tmp = ((vertex._||{})[Gun._.state]||{})[field])? ctx.tmp : -Infinity;
upper.max = ctx.incoming.state > upper.max? ctx.incoming.state : upper.max;
state = Gun.HAM(ctx.drift, ctx.incoming.state, ctx.current.state, ctx.incoming.value, ctx.current.value);
if(state.err){
root.console.log(".!HYPOTHETICAL AMNESIA MACHINE ERR!.", state.err); // this error should never happen.
return;
}
if(state.state || state.historical || state.current){
lower.call(state, vertex, field, incoming, ctx.incoming.state);
return;
}
if(state.incoming){
now.call(state, vertex, field, incoming, ctx.incoming.state);
return;
}
if(state.defer){
upper.wait = true;
upper.call(state, vertex, field, incoming, ctx.incoming.state); // signals that there are still future modifications.
Gun.schedule(ctx.incoming.state, function(){
update(incoming, field);
if(ctx.incoming.state === upper.max){ (upper.last || function(){})() }
});
}
})){ return function(fn){ if(fn){ fn({err: 'Not a node!'}) } } }
if(now.end){ now.call({}, vertex) } // TODO: Should HAM handle empty updates? YES.
return function(fn){
upper.last = fn || function(){};
if(!upper.wait){ upper.last() }
}
}

32
src/val.js Normal file
View File

@ -0,0 +1,32 @@
var Gun = require('./gun');
Gun.chain.val = (function(){
Gun.on('get.wire').event(function(gun, ctx){
if(!ctx.soul){ return } var end;
(end = gun.__.by(ctx.soul)).end = (end.end || -1); // TODO: CLEAN UP! This should be per peer!
},-999);
Gun.on('wire.get').event(function(gun, ctx, err, data){
if(err || !ctx.soul){ return }
if(data && !Gun.obj.empty(data, Gun._.meta)){ return }
var end = gun.__.by(ctx.soul);
end.end = (!end.end || end.end < 0)? 1 : end.end + 1;
},-999);
return function(cb, opt){
var gun = this, args = Gun.list.slit.call(arguments);
cb = Gun.fns.is(cb)? cb : function(val, field){ root.console.log.apply(root.console, args.concat([field && (field += ':'), val])) }; cb.hash = {};
opt = opt || {};
function val(at){
var ctx = {by: gun.__.by(at.soul), at: at.at || at}, node = ctx.by.node, field = ctx.at.field, hash = Gun.on.at.hash({soul: ctx.at.key || ctx.at.soul, field: field});
if(cb.hash[hash]){ return }
if(at.field && Gun.obj.has(node, at.field)){
return cb.hash[hash] = true, cb.call(ctx.by.chain || gun, Gun.obj.copy(node[at.field]), at.field);
}
if(!opt.empty && Gun.obj.empty(node, Gun._.meta)){ return } // TODO: CLEAN UP! .on already does this without the .raw!
if(ctx.by.end < 0){ return }
return cb.hash[hash] = true, cb.call(ctx.by.chain || gun, Gun.obj.copy(node), field);
}
gun.on(val, {raw: true});
if(gun === gun.back){ Gun.log('You have no context to `.val`!') }
return gun;
}
}());

View File

@ -2,8 +2,9 @@
root = env.window? env.window : root;
env.window && root.localStorage && root.localStorage.clear();
//root.Gun = root.Gun || require('../gun');
root.Gun = root.Gun || require('../gun');
root.Gun = root.Gun || require('../src/index');
}(this));
//Gun.log.squelch = true;
var gleak = {globals: {}, check: function(){ // via tobyho
var leaked = []
@ -3796,6 +3797,49 @@ describe('Gun', function(){
done(); done.c = 1;
});
});
it("get context", function(done){ // TODO: HUH?????? This was randomly causing errors?
var gun = Gun();
var ref = gun.get('ctx/lol').get('ctx/foo').put({hello: 'world'});
gun.get('ctx/lol').val(function(implicit){
done.fail = true;
expect(implicit).to.not.be.ok();
});
gun.get('ctx/lol').not(function(){
done.please = true;
});
gun.get('ctx/foo').val(function(data){
expect(data.hello).to.be('world');
expect(done.fail).to.not.be.ok();
expect(done.please).to.be.ok();
done();
});
});
it.skip("chaining val", function(done){ // Not implemented yet!
var gun = Gun();
gun.get('users').set(gun.put({name: 'alice'}));
gun.get('users').set(gun.put({name: 'bob'}));;
gun.get('users').val().map(function(person){
if(person.name === 'alice'){
done.alice = true;
}
if(person.name === 'bob'){
done.bob = true;
}
if(person.name === 'carl'){
done.carl = true;
}
});
gun.get('users').set(gun.put({name: 'carl'}));
setTimeout(function(){
console.log('wha?', done.alice, done.bob, done.carl);
expect(done.alice).to.be.ok();
expect(done.bob).to.be.ok();
expect(done.carl).to.not.be.ok();
done();
},10);
});
});
describe('Streams', function(){