.val()

gun.val(callback)
gun.val(callback, options)

// Read a value (same as .once())
gun.get('user/alice').get('name').val(function(name){
  console.log('Name:', name)
})

// Equivalent to:
gun.get('user/alice').get('name').once(function(name){
  console.log('Name:', name)
})

// More intuitive naming for getting values
gun.get('settings').get('theme').val(function(theme){
  applyTheme(theme)
})

// Reads clearer than .once() in some contexts
gun.get('score').val(function(score){
  updateScoreboard(score)
})

// .val() returns a chainable reference
gun.get('user')
   .get('profile')
   .val(function(profile){
     console.log('Profile:', profile)
   })
   .get('avatar')
   .val(function(avatar){
     console.log('Avatar:', avatar)
   })

// Typical implementation (not from source)
Gun.chain.val = function(cb, opt){
  return this.once(cb, opt)
}

// ✅ Good use cases:
// Quick value reads
gun.get('config').get('apiKey').val(cb)

// Form population
gun.get('user').get('email').val(function(email){
  document.getElementById('email').value = email
})

// ❌ Use .once() instead for:
// Production code (more stable)
gun.get('critical/data').once(cb)

// ❌ Use .on() instead for:
// Realtime updates
gun.get('live/data').on(cb)

// This warning appears when using .val()
Gun.log.once("valonce", 
  "Chainable val is experimental, its behavior and API may " +
  "change moving forward. Please play with it and report bugs " +
  "and ideas on how to improve it."
)

// Instead of:
gun.get('data').val(function(data){
  console.log(data)
})

// Use:
gun.get('data').once(function(data){
  console.log(data)
})

// The callback's 'this' is the gun chain
gun.get('user').val(function(user){
  console.log('User:', user)
  console.log('Chain:', this)  // Gun chain reference
  
  // Can access metadata
  console.log('Key:', this._.get)
  console.log('Soul:', this._.soul)
})

// Promisify .val() for async/await
function promiseVal(gun) {
  return new Promise(function(resolve, reject){
    gun.val(function(data){
      resolve(data)
    })
  })
}

// Use with async/await
async function getData() {
  var value = await promiseVal(gun.get('data'))
  console.log('Value:', value)
  return value
}