brainstem-js 0.2.1

data/.gitignore

@@ -0,0 +1,8 @@
+/.bundle/
+/bin/
+/build/
+/dist/
+/tmp/
+/.idea/
+projectFilesBackup
+pkg

data/.pairs

@@ -0,0 +1,21 @@
+pairs:
+  rn: Roger Neel
+  ac: Andrew Cantino; andrew
+  jm: Jeff Moore
+  cad: Chris Alvarado-Dryden
+  ml: Matthew LaRocca
+  sa: Sufyan Adam
+  bb: Bobby Brown
+  al: Andrew Langdon
+  kd: Katlyn Daniluk
+  jc: Juan-Carlos Medina
+  rg: Reid Gillette
+  aj: Alec Jacobs
+  mc: Michael Chen
+  sc: Sean Crafts
+  cm: Caleb Mingle
+  aa: André Arko
+email:
+  prefix: pair
+  domain: mavenlink.com
+global: true

data/.ruby-gemset

@@ -0,0 +1 @@
+brainstem-js

data/.ruby-version

@@ -0,0 +1 @@
+ruby-1.9.3-p392

data/.tm_properties

@@ -0,0 +1 @@
+exclude = {$exclude,bin,build,dist,tmp,.tm_properties}

data/.travis.yml

@@ -0,0 +1,12 @@
+language: ruby
+rvm: 1.9.3
+
+before_install: gem install bundler
+
+notifications:
+  hipchat: 09a2719b3284ea0d0d247355fa5542@Mavenlink Dev
+
+git:
+  depth: 1
+
+source_key: LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVktLS0tLQpNSUlFcEFJQkFBS0NBUUVBOHBpRjdldDZKM2FmWCt0WDlWRG5HZEt4dDdZZVJVVUh3K29JQVJDekorejBvS3MxCnNwaEUxZlBSQksyUDFMUVV5cngyUThzalgxdnA1NUt6U3lnVWExMFRlUG90VnVWN3hZbVFqTG5FM2FueTJBNXIKMFhXZG4wS2k2cUt5TkVwd2ZJa3JYam8xSmY4SHJ0ajZ5Yi9VTFcySnZxbTBGTTZRNmU1TCtmUGdQN0JqeS9WSApUWHF4UWVRaTVaSVppa2JoeGxoK3RQNVZaM1JMRTF3bEhRdXpESUFZemRFdnFXeEFxYkhvNktyMjJSZzRhaGNPCnNEZ1FGK0drR0h2bjBKTkpmc05Cd3d2YUQ2Y3M5N2pnY045b1VrK1phOFNlbFZhazRjWVhRUk5WaTdPMVdkQnkKSE1xaVNPVjFZdEhSWWdwSFpPaHdYSUdxK3ZhUXVFR21SRzdBY1FJREFRQUJBb0lCQVFDOXBiQ2xjdjFXbG13MwpEd0wrK3RUL0llL2VmeGVnN1RzSjFBMlh6NWRPc2ZYM0dJRHM4ZzUxOTVuQi8zQytSbDB1dEMvOEJYVE1ta3o3CnhIbzNXY2pFdWNsOFBJOXZMQTBiT3RSdXZ0Y0F0bGZxd1ROV1ZvejNNSit0cjZ5Q0ptTlRaK1FvVUhhMkVtM08KS1QrOHNpTEx0S01IRXlGOVZwS0EzZEkxUDRwaUhodlFBdkgzQkdRR3piNW9UczV6RXJnRmZNbEZKWFc0S2NxcApYc1NnWDBjd3d3Nit3WDFLblRGY3lNak9QbTB2MWZSSTdHMGdtOG02VVJrakdVeXhpRXhkTVNEdm5yVEt4ajlvCitIK1NucU14RW5uczJRR1lnSEtnV1ZaSFFBUU9UenBNSVdvNndHODNMMDlyOUo3S1dzZHRwNStKeDNZWWE2eTMKU0tod3NQdGxBb0dCQVAvZTJ2SitCVmpkRXVOSjJibWo4YnlGK2lJd292Vm9FYW4xUExkZ3JJbTNQWkFrLytyMgpiSFV0d0xDVjBSR1l5Z1ZqaW42YmEzUitNM2ptanErM3Z1N0FsVlJNazdvcFVXcjUwanRzbDhhT1k4WkIxTlhuClRlRW5keEswTnBWaWs1VlFhNzBqcmh3NGtmekxhUk9xdUV1SGt6Qk95MXhJeStyUkNMNDMzT1ZmQW9HQkFQSzMKOHNXYm5YRzR0WjdHMU5QVjZ0YXJ5bEt4bFluRnhseG4rUmZueTFHbG1NejU4YW1Jb1F2SnJuSHlSR29xQ2dNOQo4eWJFMmVoVjJFM20wKzUwampDeFNrMjhxbkNybDdnbTdNcjhsVzdGQnZLSUw2NDFsM1pDT3pLSnBKWFdGN1BaCmdYVGplTmduRzliQkljMldBNHpzaGVDK05CRWxidmFkekRrT0hkd3ZBb0dBWkRlZ1lCdzE4ZkZkQllNV2NSeWkKZ1Nta3FDR09vam9wdVB6aDFCMWNWdkJiZjRyT1pmUXcxTkNmeVVwVXdlU3JNK01pQ3FiTE5xeDdjcDR6UXVYZwpOZGxlWTg4K2lVckhwZlBGZ1JydWM0bXYwS1pXTzVYR0xpcnIrM3AwYXB4YW04QU5BdDdud2d2eU9pWmR1S05FClhlanpJSmVzRlRBNkZuWGJTODNMaWxjQ2dZRUExai9kd3VUOGM3ZnlTZmVGUW9DZnpXTFRNMitpYW56ei9mbWgKZmFLVWJMdmFSNFdSOW02dWlmTTdVMFhoY2owdG5YTC93WWNlT3VJY0Q1ZmtGNmMzSkhBN0FLZTdZNzEwTFkvZQprY2VvT0tFZTR0T29Fd1VuYjdKREF2ZFJHeHBpemRUL1d5aTRNVVZFWTZzVHBaLzMvbHVDU2NKYnY0N2xoamdBClg1VEFjdTBDZ1lCRFhnNUF2VHVXTE5pRk91RW5RekhrRmp0N0lwRVVUN2lpZDByMHBJempMVmc1c08zSXRqTkQKNjlvWitIYUlCSVpMWkNQc2lpS2dmQkFIS0xXY3NEQTRnelY2ckpUWDdmdXYvcHZUTk9tdmJlcG5OK0JGd05xdApVU2c5UmxFZ0lFWEE3Q041aVFvb2l2SmFiT3VEREl0NUhiTS9Gd1M0V3QvQVdnQUZkYmpab3c9PQotLS0tLUVORCBSU0EgUFJJVkFURSBLRVktLS0tLQo=

data/Assetfile

@@ -0,0 +1,79 @@
+require 'rake-pipeline-web-filters'
+require 'jasmine-core'
+
+output "build"
+
+input "vendor/assets/javascripts/brainstem" do
+  match "*.coffee" do
+    coffee_script
+  end
+
+  match "*.js" do
+    minispade :rewrite_requires => true, :module_id_generator => proc { |input|
+      input.path.sub(/\.js$/, '')
+    }, :string => true
+    concat "brainstem.js"
+  end
+end
+
+input "spec" do
+  match "**/*.coffee" do
+    coffee_script
+  end
+
+  match "**/*.js" do
+    reject "support/**/*.js"
+    reject "vendor/**/*.js"
+    reject "helpers/**/*.js"
+    minispade :rewrite_requires => true, :module_id_generator => proc { |input|
+      input.path.sub(/\.js$/, '')
+    }, :string => true
+    concat "specs.js"
+  end
+end
+
+input "spec/support" do
+  match "runner.html" do
+    concat "index.html"
+  end
+
+  match "headless.html" do
+    concat
+  end
+
+  match "**/*.coffee" do
+    coffee_script
+  end
+
+  match "**/*.js" do
+    concat
+  end
+end
+
+input "spec/vendor" do
+  output "build/vendor"
+  match "*.js" do
+    concat
+  end
+end
+
+input "spec/helpers" do
+
+  match "**/*.coffee" do
+    coffee_script
+  end
+
+  match "*.js" do
+    minispade :rewrite_requires => true, :module_id_generator => proc { |input|
+      input.path.sub(/\.js$/, '')
+    }, :string => true
+    concat "helpers.js"
+  end
+end
+
+input Jasmine::Core.path do
+  output "build/jasmine"
+  match /^[^\/]+\.(js|css)$/ do
+    concat
+  end
+end

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'rake-pipeline', :github => 'livingsocial/rake-pipeline', :branch => 'master'
+gem 'rake-pipeline-web-filters', :github => 'wycats/rake-pipeline-web-filters', :branch => 'master'

data/Gemfile.lock

@@ -0,0 +1,50 @@
+GIT
+  remote: git://github.com/livingsocial/rake-pipeline.git
+  revision: 27718232227eddd029466b2968f0880c10a18fb4
+  branch: master
+  specs:
+    rake-pipeline (0.8.0)
+      json
+      rake (~> 10.0.0)
+      thor
+
+GIT
+  remote: git://github.com/wycats/rake-pipeline-web-filters.git
+  revision: d83f54cc0d4e53f9833c31851964e3d8ba00f66a
+  branch: master
+  specs:
+    rake-pipeline-web-filters (0.6.0)
+      rack
+      rake-pipeline (~> 0.6)
+
+PATH
+  remote: .
+  specs:
+    brainstem-js (0.2.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    coffee-script (2.2.0)
+      coffee-script-source
+      execjs
+    coffee-script-source (1.4.0)
+    execjs (1.4.0)
+      multi_json (~> 1.0)
+    jasmine-core (1.3.1)
+    json (1.7.6)
+    multi_json (1.5.0)
+    rack (1.5.0)
+    rake (10.0.3)
+    thor (0.16.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  brainstem-js!
+  bundler (~> 1.2)
+  coffee-script (~> 2.2)
+  jasmine-core (~> 1.3.1)
+  rake-pipeline!
+  rake-pipeline-web-filters!

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Mavenlink
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,143 @@
+# Brainstem.js
+
+[Brainstem](https://github.com/mavenlink/brainstem) is designed to power rich APIs in Rails. The Brainstem gem provides a presenter library that handles converting ActiveRecord objects into structured JSON and a set of API abstractions that allow users to request sorts, filters, and association loads, allowing for simpler implementations, fewer requests, and smaller responses.
+
+The Brainstem.js library is a companion library for Backbone.js that makes integration with Brainstem APIs a breeze.  Brainstem.js adds an identity map and relational models to Backbone.
+
+## Why Brainstem.js?
+
+* Speaks natively to Brainstem APIs
+* Adds relational models in Backbone, allowing you to setup has_one, has_many, and belongs_to relationships.
+* Provides an Identity Map to avoid loading already-available records.
+* Supports Brainstem side-loading of multiple objects for fast, single-request workflows.
+* Interprets the Brainstem results array and hashes for you, abstracting away the JSON protocol.
+* Written in CoffeeScript.
+
+## Usage
+
+If you're in Rails, just add `brainstem-js` to your Gemfile and require `brainstem` in `application.js`.
+
+We have a [comprehensive demo available](https://github.com/mavenlink/brainstem-demo-rails).  We recommend that you start there.
+
+What follows is an overview.
+
+### StorageManager
+
+The `Brianstem.StorageManager` is in charge of loading data over the API, as well as returning already cached data.  We recommend setting one up in a singleton App class.
+
+	class Application
+	  constructor: ->
+	    @data = new Brainstem.StorageManager()
+	    @data.addCollection 'widgets', Collections.Widgets
+	    @data.addCollection 'locations', Collections.Locations
+	    @data.addCollection 'features', Collections.Features
+	    @homeRouter = new Routers.WidgetsRouter()
+	
+	$ ->
+	  window.base = new Application()
+	  Backbone.history.start(root: "/")
+
+At the moment, the global StorageManager *must* be available at `window.base.data`.  For this reason, we recommend making a singleton instance of an `Application` class for holding your `StorageManager` and any other shared resources.
+
+### Brainstem.Models and Brainstem.Collections
+
+Once you have a StorageManager, you should setup some `Brainstem.Models` and `Brainstem.Collections`:
+
+	window.Models ?= {}
+	window.Collections ?= {}
+	
+	class Models.Widget extends Brainstem.Model
+	  paramRoot: 'widget'
+	  brainstemKey: 'widgets'
+	  urlRoot: '/api/v1/widgets'
+	
+	  @associations:
+	    features: ["features"]
+	    location: "locations"
+	
+	class Collections.Widgets extends Brainstem.Collection
+	  model: Models.Widget
+	  url: '/api/v1/widgets'
+	
+	class Models.Feature extends Brainstem.Model
+	  paramRoot: 'feature'
+	  brainstemKey: 'features'
+	  urlRoot: '/api/v1/features'
+	
+	  @associations:
+	    widgets: ["widgets"]
+	
+	class Collections.Features extends Brainstem.Collection
+	  model: Models.Feature
+	  url: '/api/v1/features'
+
+Use the `@associations` class method to declare the mapping between association names and `StorageManager` collections where the data can be located.  Arrays indicate has_many relationships.  Other than a few additions, these are just Backbone Models and Collections.
+
+### Backbone.Views
+
+Now that you have models, collections, and a `StorageManager`, it's time to load some data (probably in Backbone.Views).  For example:
+
+	class Views.Widgets.IndexView extends Backbone.View
+	  template: JST["backbone/templates/widgets/index"]
+	
+	  initialize: ->
+	    @collection = base.data.loadCollection "widgets", include: ["location", "features"], order: 'updated_at:desc'
+	    @collection.bind 'reset', @addAll
+	    @collection.bind 'remove', @addAll
+	
+	  render: =>
+	    @$el.html @template()
+	
+	    if @collection.loaded
+	      @addAll()
+	    else
+	      @$("#widgets-list").text "Just a moment..."
+	
+	    return this
+	
+	  addAll: =>
+	    @$("#widgets-list").empty()
+	    @collection.each(@addOne)
+	    @addLocations()
+	
+	  addOne: (model) =>
+	    view = new Views.Widgets.WidgetView(model: model)
+	    @$("#widgets-list").append view.render().el
+
+And finally, in your templates, you can access the relational data just like you'd normally access model data in Backbone.
+
+    @model.get('location').get('name')
+    
+    for feature in @model.get('features').models:
+    
+Etc.
+
+## Development
+
+We're always open to pull requests!
+
+### Dependencies
+
+  - PhantomJS. If you're on OS X, run `brew install phantomjs`.
+
+### Running Specs
+
+To run the specs on the command line, run:
+
+    bundle exec rake
+
+To run the specs in a server with live code reloading and compilation:
+
+    bundle exec rake server
+
+To develop your application against a local checkout of brainstem-js, we suggest using Bundler's local gems:
+
+    bundle config local.brainstem-js ~/workspace/brainstem-js
+
+And when you're done, run:
+
+    bundle config --delete local.brainstem-js
+    
+# License
+
+Brainstem and Brainstem.js were created by Mavenlink, Inc. and are available under the MIT License.

data/Rakefile

@@ -0,0 +1,25 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+task :clean do
+  sh "rakep clean"
+end
+
+task :build do
+  sh "rakep build"
+end
+
+task :spec => :build do
+  begin
+    exec *%w(phantomjs build/headless.js build/headless.html)
+  rescue Errno::ENOENT => e
+    puts "Couldn't find phantomjs."
+    abort "You didn't run `brew install phantomjs`, did you?"
+  end
+end
+
+task :server => :clean do
+  exec "rakep server"
+end
+
+task :default => :spec

data/brainstemjs.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'brainstem/js/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "brainstem-js"
+  gem.version       = Brainstem::Js::VERSION
+  gem.authors       = ["Mavenlink"]
+  gem.email         = ["opensource@mavenlink.com"]
+  gem.description   = %q{The Brainstem API adapter library for Backbone.js}
+  gem.summary       = %q{Easily connect Backbone.js with Brainstem APIs.  Get relational models in Backbone.}
+  gem.homepage      = "http://github.com/mavenlink/brainstem-js"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ["lib"]
+
+  gem.add_development_dependency 'bundler', '~> 1.2'
+  gem.add_development_dependency 'coffee-script', '~> 2.2'
+  gem.add_development_dependency 'jasmine-core', '~> 1.3.1'
+  gem.add_development_dependency 'rake-pipeline-web-filters', '~> 0.6.0'
+end

data/lib/brainstem/js/engine.rb

@@ -0,0 +1,5 @@
+module Brainstemjs
+  class Rails < ::Rails::Engine
+    # So Rails will add vendor to the asset pipeline
+  end 
+end

data/lib/brainstem/js/version.rb

@@ -0,0 +1,5 @@
+module Brainstem
+  module Js
+    VERSION = "0.2.1"
+  end
+end

data/lib/brainstem/js.rb

@@ -0,0 +1,10 @@
+require "brainstem/js/version"
+require "brainstem/js/engine" if defined?(::Rails::Engine)
+
+module Brainstem
+  module Js
+    def self.path
+      File.expand_path("../../../vendor/assets/javascripts/brainstem", __FILE__)
+    end
+  end
+end

data/spec/brainstem-collection-spec.coffee

@@ -0,0 +1,141 @@
+describe 'Brainstem.Collection', ->
+  collection = updateArray = null
+
+  beforeEach ->
+    collection = new Brainstem.Collection([{id: 2, title: "1"}, {id: 3, title: "2"}, {title: "3"}])
+    updateArray = [{id: 2, title: "1 new"}, {id: 4, title: "this is new"}]
+
+  describe 'update', ->
+    it "works with an array", ->
+      collection.update updateArray
+      expect(collection.get(2).get('title')).toEqual "1 new"
+      expect(collection.get(3).get('title')).toEqual "2"
+      expect(collection.get(4).get('title')).toEqual "this is new"
+
+    it "works with a collection", ->
+      newCollection = new Brainstem.Collection(updateArray)
+      collection.update newCollection
+      expect(collection.get(2).get('title')).toEqual "1 new"
+      expect(collection.get(3).get('title')).toEqual "2"
+      expect(collection.get(4).get('title')).toEqual "this is new"
+
+    it "should update copies of the model that are already in the collection", ->
+      model = collection.get(2)
+      spy = jasmine.createSpy()
+      model.bind "change:title", spy
+      collection.update updateArray
+      expect(model.get('title')).toEqual "1 new"
+      expect(spy).toHaveBeenCalled()
+
+  describe "loadNextPage", ->
+    it "loads the next page of data for a collection that has previously been loaded in the storage manager, returns the collection and whether it thinks there is another page or not", ->
+      respondWith server, "/api/time_entries?per_page=2&page=1", resultsFrom: "time_entries", data: { time_entries: [buildTimeEntry(), buildTimeEntry()] }
+      respondWith server, "/api/time_entries?per_page=2&page=2", resultsFrom: "time_entries", data: { time_entries: [buildTimeEntry(), buildTimeEntry()] }
+      respondWith server, "/api/time_entries?per_page=2&page=3", resultsFrom: "time_entries", data: { time_entries: [buildTimeEntry()] }
+      collection = base.data.loadCollection "time_entries", perPage: 2
+      expect(collection.length).toEqual 0
+      server.respond()
+      expect(collection.length).toEqual 2
+      expect(collection.lastFetchOptions.page).toEqual 1
+
+      spy = jasmine.createSpy()
+      collection.loadNextPage success: spy
+      server.respond()
+      expect(spy).toHaveBeenCalledWith(collection, true)
+      expect(collection.lastFetchOptions.page).toEqual 2
+      expect(collection.length).toEqual 4
+
+      spy = jasmine.createSpy()
+      collection.loadNextPage success: spy
+      expect(collection.length).toEqual 4
+      server.respond()
+      expect(spy).toHaveBeenCalledWith(collection, false)
+      expect(collection.lastFetchOptions.page).toEqual 3
+      expect(collection.length).toEqual 5
+
+  describe "reload", ->
+    it "reloads the collection with the original params", ->
+      respondWith server, "/api/posts?include=replies&parents_only=true&per_page=5&page=1", resultsFrom: "posts", data: { posts: [buildPost(message: "old post", reply_ids: [])] }
+      collection = base.data.loadCollection "posts", include: ["replies"], filters: { parents_only: "true" }, perPage: 5
+      server.respond()
+      expect(collection.lastFetchOptions.page).toEqual 1
+      expect(collection.lastFetchOptions.perPage).toEqual 5
+      expect(collection.lastFetchOptions.include).toEqual ["replies"]
+      server.responses = []
+      respondWith server, "/api/posts?include=replies&parents_only=true&per_page=5&page=1", resultsFrom: "posts", data: { posts: [buildPost(message: "new post", reply_ids: [])] }
+      expect(collection.models[0].get("message")).toEqual "old post"
+      resetCounter = jasmine.createSpy("resetCounter")
+      loadedCounter = jasmine.createSpy("loadedCounter")
+      callback = jasmine.createSpy("callback spy")
+      collection.bind "reset", resetCounter
+      collection.bind "loaded", loadedCounter
+
+      collection.reload success: callback
+
+      expect(collection.loaded).toBe false
+      expect(collection.length).toEqual 0
+      server.respond()
+      expect(collection.length).toEqual 1
+      expect(collection.models[0].get("message")).toEqual "new post"
+      expect(resetCounter.callCount).toEqual 1
+      expect(loadedCounter.callCount).toEqual 1
+      expect(callback).toHaveBeenCalledWith(collection)
+
+  describe "getWithAssocation", ->
+    it "defaults to the regular get", ->
+      spyOn(collection, 'get')
+      collection.getWithAssocation(10)
+      expect(collection.get).toHaveBeenCalledWith(10)
+
+  describe 'setLoaded', ->
+    it "should set the values of @loaded", ->
+      collection.setLoaded true
+      expect(collection.loaded).toEqual(true)
+      collection.setLoaded false
+      expect(collection.loaded).toEqual(false)
+
+    it "triggers 'loaded' when becoming true", ->
+      spy = jasmine.createSpy()
+      collection.bind "loaded", spy
+      collection.setLoaded false
+      expect(spy).not.toHaveBeenCalled()
+      collection.setLoaded true
+      expect(spy).toHaveBeenCalled()
+
+    it "doesn't trigger loaded if trigger: false is provided", ->
+      spy = jasmine.createSpy()
+      collection.bind "loaded", spy
+      collection.setLoaded true, trigger: false
+      expect(spy).not.toHaveBeenCalled()
+
+    it "returns self", ->
+      spy = jasmine.createSpy()
+      collection.bind "loaded", spy
+      collection.setLoaded true
+      expect(spy).toHaveBeenCalledWith(collection)
+
+  describe "toServerJSON", ->
+    it "calls through to toJSON", ->
+      spy = spyOn(collection, 'toJSON')
+      collection.toServerJSON()
+      expect(spy).toHaveBeenCalled()
+
+  describe "ordering and filtering", ->
+    beforeEach ->
+      collection = new Brainstem.Collection([
+        new Brainstem.Model(id: 2, title: "Alpha", updated_at: 2,  cool: false),
+        new Brainstem.Model(id: 3, title: "Beta",  updated_at: 10, cool: true),
+        new Brainstem.Model(id: 4, title: "Gamma", updated_at: 5,  cool: false),
+        new Brainstem.Model(id: 6, title: "Gamma", updated_at: 5,  cool: false),
+        new Brainstem.Model(id: 5, title: "Gamma", updated_at: 4,  cool: true)
+      ])
+
+    describe "@getComparatorWithIdFailover", ->
+      it "returns a comparator that works for numerical ordering of unix timestamps, failing over to id when they're the same", ->
+        newCollection = new Brainstem.Collection collection.models, comparator: Brainstem.Collection.getComparatorWithIdFailover("updated_at:desc")
+        newCollection.sort()
+        expect(newCollection.pluck("id")).toEqual [3, 6, 4, 5, 2]
+
+        newCollection = new Brainstem.Collection collection.models, comparator: Brainstem.Collection.getComparatorWithIdFailover("updated_at:asc")
+        newCollection.sort()
+        expect(newCollection.pluck("id")).toEqual [2, 5, 4, 6, 3]