Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fresh Documents on your node server
JavaScript
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
test
LICENSE.txt
README.markdown
index.js
package.json

README.markdown

FreshDocuments - MongoDB ODM v0.0.3

FreshDocs makes sure that your documents never get stale

First, an example!

//Get a document
var document = Documents.findById("some object id value")
document.update({title: "A title for out collaborative thing"})

document.on("update", function() {
  //this will log "A better title, for our collaborative thing"          
  console.log(document.get("title"))
})

Meanwhile, someone else...

var document = Documents.findById("some object id value")
document.update({title: "A better title, for our collaborative thing"})

But hey! What about collections!

Right, it wouldn't be very useful if your documents stayed up to date, but not your collections!

Another Example!

var documents = Documents.find({awesome: true})

documents.on("add", function(newDocument) {
  console.log(newDocument.get("title"))
}

Meanwhile

Document.create({title: "An awesome document", awesome: true})

Updated for you like magic!

Validations

So you need to validate your data? Cool, we can do that.

When you're creating a FreshDocument instance, you just pass the validation middleware in with your validations

var Things = FreshDocuments("things", 
                             Validations({ title: 
                                           { length: { between: [4, 100]
                                                     , message: "Invalid length"}}})) 

Blam your titles have to be between 4 and 100 characters

Embedded Documents

Embedding documents is easy with the Embed middleware. var OtherThing = FreshDocuments("others") var Things = FreshDocuments("things", Embed({other: OtherThing}) //one other thing

var Things = FreshDocuments("things", 
                             Embed({others: [OtherThing]}) //many other things

Documentation

Yes, the documentation is pretty bad right now, It'll get updated as soon as the api stabilizes. :-D

Known Problems (that will be fixed)

  • It's not super efficient for high numbers of collections (linear search)
  • Nothing gets GC'd, yeah...badness
  • get and set functions are teh lamez
  • buggy and generally inefficient
  • The test suite will randomly fail about 1/50 runs, I havent seen this problem when used in actual use

Contributing

Any contributions are welcome, features, ideas, bugs, criticism. I would be especially grateful for feedback on the api.

Thanks

Thanks to Chad Seibert and Brian Goslinga (qbg on github) for help with brainstorming and implementation details

Also thanks to marcello3d for making the awesome Mongolian https://github.com/marcello3d/node-mongolian mongodb driver

Something went wrong with that request. Please try again.