.on()

gun.on(callback)
gun.on(callback, options)

// Listen for changes
gun.get('user/alice').on(function(data, key){
  console.log('Alice updated:', data)
})

// Update triggers the callback
gun.get('user/alice').put({ name: 'Alice Smith' })
// Console: "Alice updated: { name: 'Alice Smith', ... }"

// Listen to a specific property
gun.get('user/alice').get('name').on(function(name){
  console.log('Name changed to:', name)
})

// Listen to nested objects
gun.get('user/alice').get('settings').on(function(settings){
  console.log('Settings updated:', settings)
})

// Only fire on changes, skip initial value
gun.get('counter').on(function(count){
  console.log('Counter changed:', count)
}, true)  // or { change: true }

// First read won't trigger callback
gun.get('counter').once(function(count){
  console.log('Initial value:', count)  // This fires
})

// Store reference to unsubscribe later
var ref = gun.get('messages').on(function(msg){
  console.log('New message:', msg)
})

// Later, stop listening
ref.off()

// Or use the event parameter
gun.get('messages').on(function(msg, key, message, event){
  console.log('Message:', msg)
  
  // Unsubscribe after first message
  event.off()
})

// Listen for new messages
gun.get('chat/room1').get('messages').map().on(function(message){
  displayMessage({
    from: message.from,
    text: message.text,
    time: message.timestamp
  })
})

// Send a message
gun.get('chat/room1').get('messages').set({
  from: 'alice',
  text: 'Hello everyone!',
  timestamp: Date.now()
})

// Two-way sync with form input
var input = document.getElementById('username')

// Listen for remote changes
gun.get('user/alice').get('name').on(function(name){
  if(input.value !== name){
    input.value = name  // Update input from remote
  }
})

// Send local changes
input.addEventListener('input', function(){
  gun.get('user/alice').get('name').put(input.value)
})

Gun.chain.on = function(tag, arg, eas, as){
  var gun = this, cat = gun._, root = cat.root, act, off, id, tmp;
  if(typeof tag === 'string'){
    if(!arg){ return cat.on(tag) }
    act = cat.on(tag, arg, eas || cat, as);
    if(eas && eas.$){
      (eas.subs || (eas.subs = [])).push(act);
    }
    return gun;
  }
  var opt = arg;
  (opt = (true === opt)? {change: true} : opt || {}).not = 1; opt.on = 1;
  var wait = {};
  gun.get(tag, opt);
  return gun;
}

// ⚠️ Memory leak - listener never removed
setInterval(function(){
  gun.get('data').on(function(data){
    console.log(data)
  })
}, 1000)

// ✅ Good - clean up references
var ref = gun.get('data').on(function(data){
  console.log(data)
})

// Later:
ref.off()  // Remove listener