simple implementation of a single use "ticket", built with mongodb and node.js

npm install mongo-ticket

• autoConnect whether you want mongo-ticket to immediately connect to the database. If set to false you will have to call the connect method directly (default: true)
• collection the name to use for the collection that will store tickets (default: 'mongoTicket')
• stringify whether you want mongo-ticket to try to use JSON.stringify and JSON.parse when storing and retrieving tickets. If false, your object will be sent directly to mongo. (default: true)

You must provide a mongodb connection string as the first argument when creating a new instance of mongo-ticket, then you may optionally provide an options object, and/or a callback

var MongoTicket = require('mongo-ticket');
var mt = new MongoTicket('mongodb://localhost:27017/mydatabase', {
    autoConnect: true,
    collection: 'mycollection',
    stringify: true
}, function (err, db) {
    if (err) // ...

    mongoTicket.set('qwerty', 'keyboard cat', function (err) {
        // ...
    });
});

Later on...

mongoTicket.get('qwerty', function (err, val) {
    if (err) // ....
    console.log(val); // => 'keyboard cat'
});

• connect(callback) connects to the database with the provided mongodb uri. This is called for you unless to specify autoConnect: false in the options
• get(ticket, callback) gets a ticket and removes it if found. The arity of the callback is (error, ticketValue), where error is null unless something went wrong, and ticketValue is the (optionally parsed) value stored in the ticket, or if no ticket was found it is undefined.
• set(ticket, ticketValue, callback) sets ticket with the given value. The callback is passed directly to the mongodb driver's insert method

With the default options mongo-ticket uses the connection string you prvided to create a collection called "mongoTicket" with a schema as follows

{
    _id: ObjectID,
    key: String,
    val: String
}

The collection is given a unique index on key. This ensures you don't have duplicate tickets, and as a side effect lookups are quicker. The stringify options lets you control if the value will be passed through JSON.stringify and JSON.parse before insert and after find. These calls to JSON methods are wrapped in try catch blocks, so you can pass anything you want to set. If you set stringify: false you can pass anything you want, and it goes straight to mongo.