ember-data-source 2.0.1 → 2.1.0.beta.1

data/dist/ember-data.js

@@ -340,7 +340,10 @@
     */
 
     function ember$data$lib$adapters$errors$$InvalidError(errors) {
-      Ember.assert('`InvalidError` expects json-api formatted errors array.', Ember.isArray(errors || []));
+      if (!Ember.isArray(errors)) {
+        Ember.deprecate('`InvalidError` expects json-api formatted errors.', false, { id: 'ds.errors.invalid-error-expects-json-api-format', until: '2.0.0' });
+        errors = ember$data$lib$adapters$errors$$errorsHashToArray(errors);
+      }
       ember$data$lib$adapters$errors$$AdapterError.call(this, errors, 'The adapter rejected the commit because it was invalid');
     }
 
@@ -577,8 +580,7 @@
           }
         });
         ```
-         @private
-        @method query
+         @method query
         @param {DS.Store} store
         @param {DS.Model} type
         @param {Object} query
@@ -1217,6 +1219,24 @@
     var ember$data$lib$system$map$$MapWithDefault = Ember.MapWithDefault;
 
     var ember$data$lib$system$map$$default = ember$data$lib$system$map$$Map;
+    var ember$data$lib$system$empty$object$$default = ember$data$lib$system$empty$object$$EmptyObject;
+    // This exists because `Object.create(null)` is absurdly slow compared
+    // to `new EmptyObject()`. In either case, you want a null prototype
+    // when you're treating the object instances as arbitrary dictionaries
+    // and don't want your keys colliding with build-in methods on the
+    // default object prototype.
+    var ember$data$lib$system$empty$object$$proto = Object.create(null, {
+      // without this, we will always still end up with (new
+      // EmptyObject()).constructor === Object
+      constructor: {
+        value: undefined,
+        enumerable: false,
+        writable: true
+      }
+    });
+    function ember$data$lib$system$empty$object$$EmptyObject() {}
+
+    ember$data$lib$system$empty$object$$EmptyObject.prototype = ember$data$lib$system$empty$object$$proto;
 
     /**
       The REST adapter allows your store to communicate with an HTTP server by
@@ -1541,7 +1561,8 @@
         of the records for a given type.
          The `findAll` method makes an Ajax (HTTP GET) request to a URL computed by `buildURL`, and returns a
         promise for the resulting payload.
-         @method findAll
+         @private
+        @method findAll
         @param {DS.Store} store
         @param {DS.Model} type
         @param {String} sinceToken
@@ -1567,7 +1588,8 @@
         payload.
          The `query` argument is a simple JavaScript object that will be passed directly
         to the server as parameters.
-         @method query
+         @private
+        @method query
         @param {DS.Store} store
         @param {DS.Model} type
         @param {Object} query
@@ -1591,7 +1613,8 @@
         payload.
          The `query` argument is a simple JavaScript object that will be passed directly
         to the server as parameters.
-         @method queryRecord
+         @private
+        @method queryRecord
         @param {DS.Store} store
         @param {DS.Model} type
         @param {Object} query
@@ -2038,7 +2061,7 @@
     });
 
     function ember$data$lib$adapters$rest$adapter$$parseResponseHeaders(headerStr) {
-      var headers = Object.create(null);
+      var headers = new ember$data$lib$system$empty$object$$default();
       if (!headerStr) {
         return headers;
       }
@@ -2099,44 +2122,6 @@
         return hash;
       },
 
-      /**
-        By default the JSONAPIAdapter will send each find request coming from a `store.find`
-        or from accessing a relationship separately to the server. If your server supports passing
-        ids as a query string, you can set coalesceFindRequests to true to coalesce all find requests
-        within a single runloop.
-         For example, if you have an initial payload of:
-         ```javascript
-        {
-          post: {
-            id: 1,
-            comments: [1, 2]
-          }
-        }
-        ```
-         By default calling `post.get('comments')` will trigger the following requests(assuming the
-        comments haven't been loaded before):
-         ```
-        GET /comments/1
-        GET /comments/2
-        ```
-         If you set coalesceFindRequests to `true` it will instead trigger the following request:
-         ```
-        GET /comments?filter[id]=1,2
-        ```
-         Setting coalesceFindRequests to `true` also works for `store.find` requests and `belongsTo`
-        relationships accessed within the same runloop. If you set `coalesceFindRequests: true`
-         ```javascript
-        store.findRecord('comment', 1);
-        store.findRecord('comment', 2);
-        ```
-         will also send a request to: `GET /comments?filter[id]=1,2`
-         Note: Requests coalescing rely on URL building strategy. So if you override `buildURL` in your app
-        `groupRecordsForFindMany` more likely should be overridden as well in order for coalescing to work.
-         @property coalesceFindRequests
-        @type {boolean}
-      */
-      coalesceFindRequests: false,
-
       /**
         @method findMany
         @param {DS.Store} store
@@ -2182,7 +2167,7 @@
     });
 
     var ember$data$lib$core$$DS = Ember.Namespace.create({
-      VERSION: '2.0.1'
+      VERSION: '2.1.0-beta.1'
     });
 
     if (Ember.libraries) {
@@ -3235,7 +3220,7 @@
         var currentData = ember$data$lib$system$model$model$$get(this._internalModel, '_attributes');
         var inFlightData = ember$data$lib$system$model$model$$get(this._internalModel, '_inFlightAttributes');
         var newData = ember$data$lib$system$model$model$$merge(ember$data$lib$system$model$model$$copy(inFlightData), currentData);
-        var diffData = Object.create(null);
+        var diffData = new ember$data$lib$system$empty$object$$default();
 
         var newDataKeys = Object.keys(newData);
 
@@ -3454,7 +3439,7 @@
 
     var ember$data$lib$system$store$serializer$response$$get = Ember.get;
 
-    /*
+    /**
       This is a helper method that validates a JSON API top-level document
 
       The format of a document is described here:
@@ -3512,7 +3497,7 @@
       return errors;
     }
 
-    /*
+    /**
       This is a helper method that always returns a JSON-API Document.
 
       @method normalizeResponseHelper
@@ -3540,7 +3525,7 @@
       return normalizedResponse;
     }
 
-    /*
+    /**
       Convert the payload from `serializer.extract` to a JSON-API Document.
 
       @method _normalizeSerializerPayload
@@ -3566,7 +3551,7 @@
       return { data: data };
     }
 
-    /*
+    /**
       Convert the payload representing a single record from `serializer.extract` to
       a JSON-API Resource Object.
 
@@ -3652,7 +3637,7 @@
       return { id: '' + value, type: relationshipMeta.type };
     }
 
-    /*
+    /**
       This method converts a JSON-API Resource Object to a format that DS.Store
       understands.
 
@@ -4190,9 +4175,8 @@
     });
 
     var ember$data$lib$system$clone$null$$default = ember$data$lib$system$clone$null$$cloneNull;
-
     function ember$data$lib$system$clone$null$$cloneNull(source) {
-      var clone = Object.create(null);
+      var clone = new ember$data$lib$system$empty$object$$default();
       for (var key in source) {
         clone[key] = source[key];
       }
@@ -4621,10 +4605,10 @@
     */
     function ember$data$lib$system$store$container$instance$cache$$ContainerInstanceCache(container) {
       this._container = container;
-      this._cache = Object.create(null);
+      this._cache = new ember$data$lib$system$empty$object$$default();
     }
 
-    ember$data$lib$system$store$container$instance$cache$$ContainerInstanceCache.prototype = Object.create(null);
+    ember$data$lib$system$store$container$instance$cache$$ContainerInstanceCache.prototype = new ember$data$lib$system$empty$object$$default();
 
     ember$lib$main$$default.merge(ember$data$lib$system$store$container$instance$cache$$ContainerInstanceCache.prototype, {
       get: function (type, preferredKey, fallbacks) {
@@ -4701,7 +4685,6 @@
 
       return original;
     }
-
     var ember$data$lib$system$model$states$$get = Ember.get;
     /*
       This file encapsulates the various states that a record can transition
@@ -5056,7 +5039,7 @@
         },
 
         exit: function (internalModel) {
-          internalModel._inFlightAttributes = Object.create(null);
+          internalModel._inFlightAttributes = new ember$data$lib$system$empty$object$$default();
         }
       }
     };
@@ -5474,7 +5457,6 @@
       this.linkPromise = null;
       this.meta = null;
       this.hasData = false;
-      this.hasLoaded = false;
     }
 
     ember$data$lib$system$relationships$state$relationship$$Relationship.prototype = {
@@ -5659,7 +5641,6 @@
         if (link !== this.link) {
           this.link = link;
           this.linkPromise = null;
-          this.setHasLoaded(false);
           this.record.notifyPropertyChange(this.key);
         }
       },
@@ -5681,35 +5662,13 @@
         //TODO Once we have adapter support, we need to handle updated and canonical changes
         this.computeChanges(records);
         this.setHasData(true);
-        this.setHasLoaded(true);
       },
 
       notifyRecordRelationshipAdded: Ember.K,
       notifyRecordRelationshipRemoved: Ember.K,
 
-      /*
-        `hasData` for a relationship is a flag to indicate if we consider the
-        content of this relationship "known". Snapshots uses this to tell the
-        difference between unknown (`undefined`) or empty (`null`). The reason for
-        this is that we wouldn't want to serialize unknown relationships as `null`
-        as that might overwrite remote state.
-         All relationships for a newly created (`store.createRecord()`) are
-        considered known (`hasData === true`).
-       */
       setHasData: function (value) {
         this.hasData = value;
-      },
-
-      /*
-        `hasLoaded` is a flag to indicate if we have gotten data from the adapter or
-        not when the relationship has a link.
-         This is used to be able to tell when to fetch the link and when to return
-        the local data in scenarios where the local state is considered known
-        (`hasData === true`).
-         Updating the link will automatically set `hasLoaded` to `false`.
-       */
-      setHasLoaded: function (value) {
-        this.hasLoaded = value;
       }
     };
 
@@ -6156,13 +6115,9 @@
       if (this.isAsync) {
         var promise;
         if (this.link) {
-          if (this.hasLoaded) {
-            promise = this.findRecords();
-          } else {
-            promise = this.findLink().then(function () {
-              return _this3.findRecords();
-            });
-          }
+          promise = this.findLink().then(function () {
+            return _this3.findRecords();
+          });
         } else {
           promise = this.findRecords();
         }
@@ -6212,7 +6167,6 @@
         this.removeRecord(this.inverseRecord);
       }
       this.setHasData(true);
-      this.setHasLoaded(true);
     };
 
     ember$data$lib$system$relationships$state$belongs$to$$BelongsToRelationship.prototype.setCanonicalRecord = function (newRecord) {
@@ -6222,7 +6176,6 @@
         this.removeCanonicalRecord(this.inverseRecord);
       }
       this.setHasData(true);
-      this.setHasLoaded(true);
     };
 
     ember$data$lib$system$relationships$state$belongs$to$$BelongsToRelationship.prototype._super$addCanonicalRecord = ember$data$lib$system$relationships$state$relationship$$default.prototype.addCanonicalRecord;
@@ -6319,13 +6272,9 @@
       if (this.isAsync) {
         var promise;
         if (this.link) {
-          if (this.hasLoaded) {
-            promise = this.findRecord();
-          } else {
-            promise = this.findLink().then(function () {
-              return _this2.findRecord();
-            });
-          }
+          promise = this.findLink().then(function () {
+            return _this2.findRecord();
+          });
         } else {
           promise = this.findRecord();
         }
@@ -6363,7 +6312,7 @@
     }
     function ember$data$lib$system$relationships$state$create$$Relationships(record) {
       this.record = record;
-      this.initializedRelationships = Object.create(null);
+      this.initializedRelationships = new ember$data$lib$system$empty$object$$default();
     }
 
     ember$data$lib$system$relationships$state$create$$Relationships.prototype.has = function (key) {
@@ -6379,11 +6328,6 @@
       return relationships[key];
     };
     var ember$data$lib$system$snapshot$$default = ember$data$lib$system$snapshot$$Snapshot;
-
-    /**
-      @module ember-data
-    */
-
     var ember$data$lib$system$snapshot$$get = Ember.get;
 
     /**
@@ -6396,11 +6340,11 @@
     function ember$data$lib$system$snapshot$$Snapshot(internalModel) {
       var _this = this;
 
-      this._attributes = Object.create(null);
-      this._belongsToRelationships = Object.create(null);
-      this._belongsToIds = Object.create(null);
-      this._hasManyRelationships = Object.create(null);
-      this._hasManyIds = Object.create(null);
+      this._attributes = new ember$data$lib$system$empty$object$$default();
+      this._belongsToRelationships = new ember$data$lib$system$empty$object$$default();
+      this._belongsToIds = new ember$data$lib$system$empty$object$$default();
+      this._hasManyRelationships = new ember$data$lib$system$empty$object$$default();
+      this._hasManyIds = new ember$data$lib$system$empty$object$$default();
 
       var record = internalModel.getRecord();
       this.record = record;
@@ -6503,7 +6447,7 @@
         @return {Object} All changed attributes of the current snapshot
       */
       changedAttributes: function () {
-        var changedAttributes = Object.create(null);
+        var changedAttributes = new ember$data$lib$system$empty$object$$default();
         var changedAttributeKeys = Object.keys(this._changedAttributes);
 
         for (var i = 0, _length = changedAttributeKeys.length; i < _length; i++) {
@@ -6699,8 +6643,8 @@
     var ember$data$lib$system$model$internal$model$$get = Ember.get;
     var ember$data$lib$system$model$internal$model$$set = Ember.set;
 
-    var ember$data$lib$system$model$internal$model$$_extractPivotNameCache = Object.create(null);
-    var ember$data$lib$system$model$internal$model$$_splitOnDotCache = Object.create(null);
+    var ember$data$lib$system$model$internal$model$$_extractPivotNameCache = new ember$data$lib$system$empty$object$$default();
+    var ember$data$lib$system$model$internal$model$$_splitOnDotCache = new ember$data$lib$system$empty$object$$default();
 
     function ember$data$lib$system$model$internal$model$$splitOnDot(name) {
       return ember$data$lib$system$model$internal$model$$_splitOnDotCache[name] || (ember$data$lib$system$model$internal$model$$_splitOnDotCache[name] = name.split('.'));
@@ -6716,6 +6660,7 @@
       };
     }
 
+    var ember$data$lib$system$model$internal$model$$guid = 0;
     /**
       `InternalModel` is the Model class that we use internally inside Ember Data to represent models.
       Internal ED methods should only deal with `InternalModel` objects. It is a fast, plain Javascript class.
@@ -6736,18 +6681,19 @@
       this.id = id;
       this.store = store;
       this.container = container;
-      this._data = data || Object.create(null);
+      this._data = data || new ember$data$lib$system$empty$object$$default();
       this.modelName = type.modelName;
       this.dataHasInitialized = false;
       //Look into making this lazy
       this._deferredTriggers = [];
-      this._attributes = Object.create(null);
-      this._inFlightAttributes = Object.create(null);
+      this._attributes = new ember$data$lib$system$empty$object$$default();
+      this._inFlightAttributes = new ember$data$lib$system$empty$object$$default();
       this._relationships = new ember$data$lib$system$relationships$state$create$$default(this);
       this.currentState = ember$data$lib$system$model$states$$default.empty;
       this.isReloading = false;
       this.isError = false;
       this.error = null;
+      this[Ember.GUID_KEY] = ember$data$lib$system$model$internal$model$$guid++ + 'internal-model';
       /*
         implicit relationships are relationship which have not been declared but the inverse side exists on
         another record somewhere
@@ -6769,7 +6715,7 @@
          would have a implicit post relationship in order to be do things like remove ourselves from the post
         when we are deleted
       */
-      this._implicitRelationships = Object.create(null);
+      this._implicitRelationships = new ember$data$lib$system$empty$object$$default();
     }
 
     ember$data$lib$system$model$internal$model$$InternalModel.prototype = {
@@ -6945,7 +6891,7 @@
 
       flushChangedAttributes: function () {
         this._inFlightAttributes = this._attributes;
-        this._attributes = Object.create(null);
+        this._attributes = new ember$data$lib$system$empty$object$$default();
       },
 
       /**
@@ -7008,10 +6954,10 @@
       rollbackAttributes: function () {
         var dirtyKeys = Object.keys(this._attributes);
 
-        this._attributes = Object.create(null);
+        this._attributes = new ember$data$lib$system$empty$object$$default();
 
         if (ember$data$lib$system$model$internal$model$$get(this, 'isError')) {
-          this._inFlightAttributes = Object.create(null);
+          this._inFlightAttributes = new ember$data$lib$system$empty$object$$default();
           this.didCleanError();
         }
 
@@ -7028,7 +6974,7 @@
         }
 
         if (this.isValid()) {
-          this._inFlightAttributes = Object.create(null);
+          this._inFlightAttributes = new ember$data$lib$system$empty$object$$default();
         }
 
         this.send('rolledBack');
@@ -7272,7 +7218,7 @@
           ember$data$lib$system$merge$$default(this._data, data);
         }
 
-        this._inFlightAttributes = Object.create(null);
+        this._inFlightAttributes = new ember$data$lib$system$empty$object$$default();
 
         this.send('didCommit');
         this.updateRecordArraysLater();
@@ -7347,7 +7293,7 @@
             this._attributes[keys[i]] = this._inFlightAttributes[keys[i]];
           }
         }
-        this._inFlightAttributes = Object.create(null);
+        this._inFlightAttributes = new ember$data$lib$system$empty$object$$default();
       },
 
       /**
@@ -7390,7 +7336,7 @@
           var keys = Object.keys(updates);
           var length = keys.length;
 
-          original = ember$data$lib$system$merge$$default(Object.create(null), this._data);
+          original = ember$data$lib$system$merge$$default(new ember$data$lib$system$empty$object$$default(), this._data);
           original = ember$data$lib$system$merge$$default(original, this._inFlightAttributes);
 
           for (i = 0; i < length; i++) {
@@ -7677,7 +7623,7 @@
       createRecord: function (modelName, inputProperties) {
         Ember.assert("Passing classes to store methods has been removed. Please pass a dasherized string instead of " + Ember.inspect(modelName), typeof modelName === 'string');
         var typeClass = this.modelFor(modelName);
-        var properties = ember$data$lib$system$store$$copy(inputProperties) || Object.create(null);
+        var properties = ember$data$lib$system$store$$copy(inputProperties) || new ember$data$lib$system$empty$object$$default();
 
         // If the passed properties do not include a primary key,
         // give the adapter an opportunity to generate one. Typically,
@@ -8408,7 +8354,7 @@
             record.destroy(); // maybe within unloadRecord
           }
 
-          typeMap.metadata = Object.create(null);
+          typeMap.metadata = new ember$data$lib$system$empty$object$$default();
         }
 
         function byType(entry) {
@@ -8462,7 +8408,11 @@
         Ember.assert('Passing classes to store methods has been removed. Please pass a dasherized string instead of ' + Ember.inspect(modelName), typeof modelName === 'string');
 
         if (!Ember.ENV.ENABLE_DS_FILTER) {
-          Ember.assert('The filter API has been moved to a plugin. To enable store.filter using an environment flag, or to use an alternative, you can visit the ember-data-filter addon page. https://github.com/ember-data/ember-data-filter', false);
+          Ember.deprecate('The filter API will be moved into a plugin soon. To enable store.filter using an environment flag, or to use an alternative, you can visit the ember-data-filter addon page', false, {
+            url: 'https://github.com/ember-data/ember-data-filter',
+            id: 'ds.store.filter-deprecated',
+            until: '2.0.0'
+          });
         }
 
         var promise;
@@ -8703,9 +8653,9 @@
         }
 
         typeMap = {
-          idToRecord: Object.create(null),
+          idToRecord: new ember$data$lib$system$empty$object$$default(),
           records: [],
-          metadata: Object.create(null),
+          metadata: new ember$data$lib$system$empty$object$$default(),
           type: typeClass
         };
 
@@ -8954,6 +8904,9 @@
         serializer (the application serializer if it exists).
          Alternatively, `pushPayload` will accept a model type which
         will determine which serializer will process the payload.
+        However, the serializer itself (processing this data via
+        `normalizePayload`) will not know which model it is
+        deserializing.
          ```app/serializers/application.js
         import DS from 'ember-data';
          export default DS.ActiveModelSerializer;
@@ -9093,9 +9046,15 @@
         @param {String} modelName
         @return DS.Adapter
       */
-      adapterFor: function (modelName) {
+      adapterFor: function (modelOrClass) {
+        var modelName;
 
-        Ember.assert("Passing classes to store.adapterFor has been removed. Please pass a dasherized string instead of " + Ember.inspect(modelName), typeof modelName === 'string');
+        if (typeof modelOrClass === 'string') {
+          modelName = modelOrClass;
+        } else {
+          Ember.deprecate("Passing classes to store methods has been removed. Please pass a dasherized string instead of " + Ember.inspect(modelName), false, { id: 'ds.store.passing-classes-deprecated', until: '2.0.0' });
+          modelName = modelOrClass.modelName;
+        }
 
         return this.lookupAdapter(modelName);
       },
@@ -9125,9 +9084,15 @@
         @param {String} modelName the record to serialize
         @return {DS.Serializer}
       */
-      serializerFor: function (modelName) {
+      serializerFor: function (modelOrClass) {
+        var modelName;
 
-        Ember.assert("Passing classes to store.serializerFor has been removed. Please pass a dasherized string instead of " + Ember.inspect(modelName), typeof modelName === 'string');
+        if (typeof modelOrClass === 'string') {
+          modelName = modelOrClass;
+        } else {
+          Ember.deprecate("Passing classes to store methods has been removed. Please pass a dasherized string instead of " + Ember.inspect(modelName), false, { id: 'ds.store.passing-classes-deprecated', until: '2.0.0' });
+          modelName = modelOrClass.modelName;
+        }
 
         var fallbacks = ['application', this.adapterFor(modelName).get('defaultSerializer'), '-default'];
 
@@ -9973,6 +9938,28 @@
         return ember$data$lib$system$normalize$model$name$$default(key);
       },
 
+      /**
+        You can use this method to normalize all payloads, regardless of whether they
+        represent single records or an array.
+         For example, you might want to remove some extraneous data from the payload:
+         ```app/serializers/application.js
+        import DS from 'ember-data';
+         export default DS.JSONSerializer.extend({
+          normalizePayload: function(payload) {
+            delete payload.version;
+            delete payload.status;
+            return payload;
+          }
+        });
+        ```
+         @method normalizePayload
+        @param {Object} payload
+        @return {Object} the normalized payload
+      */
+      normalizePayload: function (payload) {
+        return payload;
+      },
+
       /**
         @method normalizeAttributes
         @private
@@ -10616,8 +10603,8 @@
     var ember$inflector$lib$lib$system$inflector$$capitalize = ember$lib$main$$default.String.capitalize;
 
     var ember$inflector$lib$lib$system$inflector$$BLANK_REGEX = /^\s*$/;
-    var ember$inflector$lib$lib$system$inflector$$LAST_WORD_DASHED_REGEX = /([\w/-]+[_/\s-])([a-z\d]+$)/;
-    var ember$inflector$lib$lib$system$inflector$$LAST_WORD_CAMELIZED_REGEX = /([\w/\s-]+)([A-Z][a-z\d]*$)/;
+    var ember$inflector$lib$lib$system$inflector$$LAST_WORD_DASHED_REGEX = /([\w/-]+[_/-\s])([a-z\d]+$)/;
+    var ember$inflector$lib$lib$system$inflector$$LAST_WORD_CAMELIZED_REGEX = /([\w/-\s]+)([A-Z][a-z\d]*$)/;
     var ember$inflector$lib$lib$system$inflector$$CAMELIZED_REGEX = /[A-Z][a-z\d]*$/;
 
     function ember$inflector$lib$lib$system$inflector$$loadUncountable(rules, uncountable) {
@@ -13791,7 +13778,7 @@
       },
 
       inverseMap: Ember.computed(function () {
-        return Object.create(null);
+        return new ember$data$lib$system$empty$object$$default();
       }),
 
       /**