Fixes #76.

Author: jmdobry

.jshintrc

@@ -1,34 +1,39 @@
 {
-	"node": false,
-	"browser": true,
-	"es5": true,
-	"esnext": true,
-	"bitwise": true,
-	"camelcase": true,
-	"curly": true,
-	"eqeqeq": true,
-	"immed": true,
-	"indent": 2,
-	"latedef": true,
-	"newcap": true,
-	"noarg": true,
-	"quotmark": "single",
-	"regexp": true,
-	"undef": true,
-	"unused": true,
-	"strict": true,
-	"trailing": true,
-	"smarttabs": true,
-	"predef": [
-		"inject",
-		"describe",
-		"it",
-		"beforeEach",
-		"afterEach",
-		"assert",
-		"require",
-		"module",
-		"exports",
-		"angular"
-	]
+  "node": false,
+  "browser": true,
+  "es5": true,
+  "esnext": true,
+  "bitwise": true,
+  "camelcase": true,
+  "curly": true,
+  "eqeqeq": true,
+  "immed": true,
+  "indent": 2,
+  "latedef": true,
+  "newcap": true,
+  "noarg": true,
+  "quotmark": "single",
+  "regexp": true,
+  "undef": true,
+  "unused": true,
+  "strict": false,
+  "trailing": true,
+  "smarttabs": true,
+  "globals": {
+    "inject": true,
+    "describe": true,
+    "it": true,
+    "beforeEach": true,
+    "afterEach": true,
+    "assert": true,
+    "startInjector": true,
+    "DS": true,
+    "fail": true,
+    "$httpBackend": true,
+    "console": true,
+    "require": true,
+    "module": true,
+    "exports": true,
+    "angular": true
+  }
 }

CHANGELOG.md

@@ -1,3 +1,8 @@
+##### 0.10.0 - 24 June 2014
+
+###### Breaking API changes
+- #76 - Queries and filtering. See [TRANSITION.md](https://github.com/jmdobry/angular-data/blob/master/TRANSITION.md).
+
 ##### 0.9.1 - 30 May 2014
 
 ###### Backwards compatible bug fixes

README.md

@@ -2,8 +2,8 @@
 
 __Data store for Angular.js.__
 
-__Latest Release:__ [0.9.1](http://angular-data.codetrain.io/)
-__master:__ [0.9.1](http://angular-data-next.codetrain.io/)
+__Latest Release:__ [0.9.1](http://angular-data.pseudobry.com/)
+__master:__ [0.9.1](http://angular-data-next.pseudobry.com/)
 
 Angular-data is in a pre-1.0.0 development stage; the API is fluctuating, not a lot of tests yet, etc.
 

TRANSITION.md

@@ -0,0 +1,94 @@
+### 0.9.x. ---> 0.10.0 - 24 June 2014
+
+#### Breaking API changes
+##### #76 - Queries and filtering.
+
+###### Before
+```javascript
+DS.findAll('post', {
+  query: {
+    where: {
+      name: 'John'
+    }
+  }
+})
+```
+
+###### After
+```javascript
+DS.findAll('post', {
+  where: {
+    name: 'John'
+  }
+})
+```
+
+###### Before
+```javascript
+DS.filter('post', {
+  query: {
+    where: {
+      name: 'John'
+    }
+  }
+})
+```
+
+###### After
+```javascript
+DS.filter('post', {
+  where: {
+    name: 'John'
+  }
+})
+```
+
+###### Before
+```javascript
+// override how DS.filter handles the "where" clause
+DSProvider.defaults.filter = function (resourceName, where, attrs) {
+  // return true to keep the item in the result set
+  // return false to exclude it
+};
+```
+
+###### After
+```javascript
+// override how DS.filter handles the "where", "skip", "limit" and "orderBy" clauses
+DSProvider.defaults.filter = function (collection, resourceName, params, options) {
+  // examine params and
+  // decide whether to exclude items, skip items, start from an offset, or sort the items
+  
+  // see the [default implementation that ships with angular-data](https://github.com/jmdobry/angular-data/blob/master/src/datastore/index.js#L12) 
+  // overriding this method is useful when our server only understands a certain
+  // params format and you want angular-data's filter to behave the same as your server
+  
+  // angular-data looks for the following fields:
+  // - where
+  // - skip (or offset)
+  // - limit
+  // - orderBy (or sort)
+  
+  // return the filtered collection
+};
+```
+
+###### Before
+```javascript
+DSHttpAdapter.defaults.queryTransform = function (resourceName, query) {
+  // the second argument was the "query" field of the "params" passed in the DSHttpAdapter method
+  // return the transformed query
+};
+```
+
+###### After
+```javascript
+// This is useful when you don't want to implement the filter method above
+// and instead rely on angular-data's expectation of where, skip, limit, orderBy, etc.
+// This transform is useful when you want to change the where, skip, limit, orderBy, etc. fields
+// into something your server understands.
+DSHttpAdapter.defaults.queryTransform = function (resourceName, params) {
+  // the second argument is now the whole "params" object passed in the DSHttpAdapter method
+  // return the transformed params
+};
+```

bower.json

@@ -2,8 +2,8 @@
   "author": "Jason Dobry",
   "name": "angular-data",
   "description": "Data store for Angular.js.",
-  "version": "0.9.1",
-  "homepage": "http://angular-data.codetrain.io/",
+  "version": "0.10.0",
+  "homepage": "http://angular-data.pseudobry.com/",
   "repository": {
     "type": "git",
     "url": "git://github.com/jmdobry/angular-data.git"