Value(s)

const values = ['email', 'name']

const result = await sql.query(sql`
  INSERT INTO users (email, name) VALUES (${sql.values(values)})
`)

// text: INSERT INTO users (email, name) VALUES ($1, $2)
// values: ['email', 'name']

If the parameter is an object (e.g. a user) the values of the object will be used:

const user = { email: 'email', name: 'name' }

const result = await sql.query(sql`
  INSERT INTO users (email, name) VALUES (${sql.values(user)})
`)

// text: INSERT INTO users (email, name) VALUES ($1, $2)
// values: ['email', 'name']

In that object case it's also possible to give a list of columns, which will be extracted:

const user = { email: 'email', name: 'name', active: true }

const result = await sql.query(sql`
  INSERT INTO users (email, name) 
    VALUES (${sql.values(user, { columns: ['email', 'name'] })})
`)

// text: INSERT INTO users (email, name) VALUES ($1, $2)
// values: ['email', 'name']