gun/src/HAM.js

/* Based on the Hypothetical Amnesia Machine thought experiment */
function HAM(machineState, incomingState, currentState, incomingValue, currentValue){
	if(machineState < incomingState){
		return {defer: true}; // the incoming value is outside the boundary of the machine's state, it must be reprocessed in another state.
	}
	if(incomingState < currentState){
		return {historical: true}; // the incoming value is within the boundary of the machine's state, but not within the range.

	}
	if(currentState < incomingState){
		return {converge: true, incoming: true}; // the incoming value is within both the boundary and the range of the machine's state.

	}
	if(incomingState === currentState){
		if(Lexical(incomingValue) === Lexical(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(Lexical(incomingValue) < Lexical(currentValue)){ // Lexical only works on simple value types!
			return {converge: true, current: true};
		}
		if(Lexical(currentValue) < Lexical(incomingValue)){ // Lexical only works on simple value types!
			return {converge: true, incoming: true};
		}
	}
	return {err: "you have not properly handled recursion through your data or filtered it as JSON"};
}
if(typeof JSON === 'undefined'){
	throw new Error(
		'JSON is not included in this browser. Please load it first: ' +
		'ajax.cdnjs.com/ajax/libs/json2/20110223/json2.js'
	);
}
var Lexical = JSON.stringify, undefined;
module.exports = HAM;