.map()

gun.map()
gun.map(callback)
gun.map(filter)

// Display all todos
gun.get('todos').map().on(function(todo, key){
  console.log('Todo ' + key + ':', todo.text)
})

// One-time read of all items
gun.get('todos').map().once(function(todo, key){
  console.log('Todo ' + key + ':', todo.text)
})

// Render a todo list that updates in realtime
var todosEl = document.getElementById('todos')

gun.get('todos').map().on(function(todo, id){
  var li = document.getElementById(id) || document.createElement('li')
  li.id = id
  li.textContent = todo.text
  
  if(todo.done){
    li.style.textDecoration = 'line-through'
  }
  
  if(!li.parentNode){
    todosEl.appendChild(li)
  }
})

// Iterate over users and their posts
gun.get('users').map().on(function(user, userId){
  console.log('User:', user.name)
  
  gun.get('users').get(userId).get('posts').map().on(function(post){
    console.log('  Post:', post.title)
  })
})

// Filter and transform items
gun.get('todos').map(function(todo, key){
  // Skip completed todos
  if(todo.done) return undefined
  
  // Transform the data
  return {
    id: key,
    text: todo.text,
    priority: todo.priority || 'normal'
  }
}).on(function(transformed){
  console.log('Active todo:', transformed)
})

// Only match keys starting with 'user:'
gun.get('data').map({'.' : 'user:*'}).on(function(user){
  console.log('User:', user)
})

// Match specific pattern
gun.get('events').map({'.' : /2024-.*/}).on(function(event){
  console.log('2024 event:', event)
})

var messagesEl = document.getElementById('messages')

// Listen for new messages
gun.get('chat/room1').get('messages').map().on(function(msg, id){
  var div = document.getElementById(id)
  if(!div){
    div = document.createElement('div')
    div.id = id
    messagesEl.appendChild(div)
  }
  
  div.innerHTML = `
    <strong>${msg.from}</strong>: ${msg.text}
    <span class="time">${new Date(msg.timestamp).toLocaleTimeString()}</span>
  `
})

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

// Count items in a collection
var count = 0
gun.get('items').map().once(function(){
  count++
})

setTimeout(function(){
  console.log('Total items:', count)
}, 100)

// Collect and sort items
var items = []

gun.get('products').map().once(function(product, key){
  items.push({
    id: key,
    name: product.name,
    price: product.price
  })
})

setTimeout(function(){
  // Sort by price
  items.sort((a, b) => a.price - b.price)
  items.forEach(item => console.log(item.name, item.price))
}, 100)

Gun.chain.map = function(cb, opt, t){
  var gun = this, cat = gun._, lex, chain;
  if(Object.plain(cb)){ lex = cb['.']? cb : {'.': cb}; cb = u }
  if(!cb){
    if(chain = cat.each){ return chain }
    (cat.each = chain = gun.chain())._.lex = lex || chain._.lex || cat.lex;
    chain._.nix = gun.back('nix');
    gun.on('in', map, chain._);
    return chain;
  }
  // ... callback version (experimental)
}

function map(msg){ this.to.next(msg);
  var cat = this.as, gun = msg.$, at = gun._, put = msg.put, tmp;
  if(!at.soul && !msg.$$){ return }
  if((tmp = cat.lex) && !String.match(msg.get|| (put||'')['.'], tmp['.'] || tmp['#'] || tmp)){ return }
  Gun.on.link(msg, cat);
}

// ❌ Inefficient - creates many subscriptions
gun.get('items').map().on(function(item){
  gun.get('users').map().on(function(user){
    // N × M subscriptions!
  })
})

// ✅ Better - limit nested subscriptions
gun.get('items').map().once(function(item){
  gun.get('users').get(item.userId).once(function(user){
    console.log(user)
  })
})

// Map over empty set does nothing
gun.get('emptySet').map().on(function(item){
  // Never called if set is empty
})

// To detect empty sets
var found = false
gun.get('mySet').map().once(function(){
  found = true
})

setTimeout(function(){
  if(!found){
    console.log('Set is empty')
  }
}, 100)

// Reusable map reference
var allTodos = gun.get('todos').map()

// Use it multiple times
allTodos.once(function(todo){
  console.log('Todo:', todo)
})

allTodos.on(function(todo){
  updateUI(todo)
})

// Both callbacks receive the same data