# # An object that holds all applied operations. # # @note The HistoryBuffer is commonly abbreviated to HB. # class HistoryBuffer # # Creates an empty HB. # @param {Object} user_id Creator of the HB. # constructor: (@user_id)-> @operation_counter = {} @buffer = {} @change_listeners = [] # # Get the user id with wich the History Buffer was initialized. # getUserId: ()-> @user_id # # Get the operation counter that describes the current state of the document. # getOperationCounter: ()-> res = {} for user,ctn of @operation_counter res[user] = ctn res _encode: ()-> json = [] for u_name,user of @buffer for o_number,o of user if not isNaN(parseInt(o_number)) json.push o._encode() json # # Get the number of operations that were created by a user. # Accordingly you will get the next operation number that is expected from that user. # This will increment the operation counter. # getNextOperationIdentifier: (user_id)-> if not user_id? user_id = @user_id if not @operation_counter[user_id]? @operation_counter[user_id] = 0 uid = { 'creator' : user_id 'op_number' : @operation_counter[user_id] } @operation_counter[user_id]++ uid # Retrieve an operation from a unique id. getOperation: (uid)-> if uid instanceof Object @buffer[uid.creator]?[uid.op_number] else if not uid? else throw new Error "This type of uid is not defined!" # Add an operation to the HB. Note that this will not link it against # other operations (it wont executed) addOperation: (o)-> if not @buffer[o.creator]? @buffer[o.creator] = {} if not @operation_counter[o.creator]? @operation_counter[o.creator] = 0 #if @operation_counter[o.creator] isnt o.op_number and typeof o.op_number is 'number' # throw new Error "You don't receive operations in the proper order. Try counting like this 0,1,2,3,4,.. ;)" if @buffer[o.creator][o.op_number]? throw new Error "You must not overwrite operations!" @buffer[o.creator][o.op_number] = o if typeof o.op_number is 'number' and o.creator isnt @getUserId() @operation_counter[o.creator]++ o module.exports = HistoryBuffer