var DB = require("second-thought");
DB.connect({db : "test"}, function(err,db){
 
  //you now have access to all of your tables as properties on your db variable:
  //so, assume there's a table called "foo" in your db...
  db.foo.save({name : "Mike"}, function(err,newRecord){
 
    //output the generated ID
    console.log(newRecord.id);
  });
 
});

db.openConnection(function(err,conn){
 
  //this is a ReQL query
  db.foo.eqJoin('bar_id', db.bar).run(conn, function(err,cursor){
 
    //run the joined action and do something interesting
    cursor.toArray(function(err,array){
      //use the array...
 
      //be sure to close the connection!
      conn.close();
    });
 
  });
});
 

//installation of the DB and tables
db.connect({db : "test"}, function(err, db){
  db.install(['foo', 'bar'], function(err,result){
    //tables should be installed now...
  });
});
 
//add a secondary index
db.connect({db : "test"}, function(err,db){
 
  db.foo.index("email", function(err, indexed){
    //indexed == true;
  });
});

 
db.connect({db : "test", function(err,db){
 
  db.foo.query({category : "beer"}, function(err,beers){
    //beers is an array, so have at it
  });
  
  db.foo.contains({field : "name", vals : ["Bob", "Jill"]}, function(err,res){
    //res is two records with the names Bob and Jill
  });
  
  db.foo.first({email : "rob@tekpub.com"}, function(err,rob){
    //hi Rob
  });
 
  db.foo.exists({name : "bill"}, function(err, exists){
    //exists will tell you if it's there
  });
 
  db.foo.destroy({id : "some-id"}, function(err,destroyed){
    //destroyed will be true if something was deleted
  });
 
  db.foo.destroyAll(function(err,destroyed){
    //destroyed is the count of records whacked
  });
 
  db.foo.updateOnly({name : "Stevie"}, "some-id", function(err,result){
    //save will do a full swap of the document, updateOnly will partially update
    //a document so you need to pass the id along
    //result will be true if an update happened
  });
 
});