diff --git a/addon/-private/system/model/model.js b/addon/-private/system/model/model.js index 2685f5d8960..2c3b0a65852 100644 --- a/addon/-private/system/model/model.js +++ b/addon/-private/system/model/model.js @@ -117,6 +117,7 @@ var Model = Ember.Object.extend(Ember.Evented, { }); ``` + @since 1.13.0 @property hasDirtyAttributes @type {Boolean} @readOnly @@ -688,6 +689,7 @@ var Model = Ember.Object.extend(Ember.Evented, { record.get('name'); // 'Untitled Document' ``` + @since 1.13.0 @method rollbackAttributes */ rollbackAttributes() { diff --git a/addon/-private/system/store.js b/addon/-private/system/store.js index b083a475993..236ae592223 100644 --- a/addon/-private/system/store.js +++ b/addon/-private/system/store.js @@ -564,6 +564,7 @@ Store = Service.extend({ See [peekRecord](#method_peekRecord) to get the cached version of a record. + @since 1.13.0 @method findRecord @param {String} modelName @param {(String|Integer)} id @@ -877,6 +878,7 @@ Store = Service.extend({ post.get('id'); // 1 ``` + @since 1.13.0 @method peekRecord @param {String} modelName @param {String|Integer} id @@ -1068,6 +1070,7 @@ Store = Service.extend({ This method returns a promise, which is resolved with a `RecordArray` once the server returns. + @since 1.13.0 @method query @param {String} modelName @param {any} query an opaque query to be used by the adapter @@ -1180,6 +1183,7 @@ Store = Service.extend({ }); ``` + @since 1.13.0 @method queryRecord @param {String} modelName @param {any} query an opaque query to be used by the adapter @@ -1342,6 +1346,7 @@ Store = Service.extend({ See [query](#method_query) to only get a subset of records from the server. + @since 1.13.0 @method findAll @param {String} modelName @param {Object} options @@ -1422,6 +1427,7 @@ Store = Service.extend({ var localPosts = store.peekAll('post'); ``` + @since 1.13.0 @method peekAll @param {String} modelName @return {DS.RecordArray} diff --git a/addon/adapter.js b/addon/adapter.js index 2d1800b934c..93407617004 100644 --- a/addon/adapter.js +++ b/addon/adapter.js @@ -513,6 +513,7 @@ export default Ember.Object.extend({ By default this hook returns `false`, as most UIs should not block user interactions while waiting on data update. + @since 1.13.0 @method shouldReloadRecord @param {DS.Store} store @param {DS.Snapshot} snapshot @@ -560,6 +561,7 @@ export default Ember.Object.extend({ is empty (meaning that there are no records locally available yet), otherwise it returns `false`. + @since 1.13.0 @method shouldReloadAll @param {DS.Store} store @param {DS.SnapshotRecordArray} snapshotRecordArray @@ -598,6 +600,7 @@ export default Ember.Object.extend({ By default this hook returns `true` so the data for the record is updated in the background. + @since 1.13.0 @method shouldBackgroundReloadRecord @param {DS.Store} store @param {DS.Snapshot} snapshot @@ -636,6 +639,7 @@ export default Ember.Object.extend({ By default this method returns `true`, indicating that a background reload should always be triggered. + @since 1.13.0 @method shouldBackgroundReloadAll @param {DS.Store} store @param {DS.SnapshotRecordArray} snapshotRecordArray diff --git a/addon/adapters/json-api.js b/addon/adapters/json-api.js index 7fd59392376..87a817b88ef 100644 --- a/addon/adapters/json-api.js +++ b/addon/adapters/json-api.js @@ -7,6 +7,7 @@ import RESTAdapter from "ember-data/adapters/rest"; import isEnabled from 'ember-data/-private/features'; /** + @since 1.13.0 @class JSONAPIAdapter @constructor @namespace DS diff --git a/addon/adapters/rest.js b/addon/adapters/rest.js index ebfc66aede8..2415c0d7419 100644 --- a/addon/adapters/rest.js +++ b/addon/adapters/rest.js @@ -409,6 +409,7 @@ var RESTAdapter = Adapter.extend(BuildURLMixin, { This method performs an HTTP `GET` request with the id provided as part of the query string. + @since 1.13.0 @method findRecord @param {DS.Store} store @param {DS.Model} type @@ -515,6 +516,7 @@ var RESTAdapter = Adapter.extend(BuildURLMixin, { The `query` argument is a simple JavaScript object that will be passed directly to the server as parameters. + @since 1.13.0 @method queryRecord @param {DS.Store} store @param {DS.Model} type @@ -899,6 +901,7 @@ var RESTAdapter = Adapter.extend(BuildURLMixin, { returned from the server using the serializer's `extractErrors` method. + @since 1.13.0 @method handleResponse @param {Number} status @param {Object} headers @@ -940,6 +943,7 @@ var RESTAdapter = Adapter.extend(BuildURLMixin, { Default `handleResponse` implementation uses this hook to decide if the response is a success. + @since 1.13.0 @method isSuccess @param {Number} status @param {Object} headers @@ -954,6 +958,7 @@ var RESTAdapter = Adapter.extend(BuildURLMixin, { Default `handleResponse` implementation uses this hook to decide if the response is a an invalid error. + @since 1.13.0 @method isInvalid @param {Number} status @param {Object} headers @@ -1157,6 +1162,7 @@ var RESTAdapter = Adapter.extend(BuildURLMixin, { shortenedPayload].join('\n'); }, + // @since 2.5.0 buildQuery(snapshot) { let query = {}; diff --git a/addon/serializer.js b/addon/serializer.js index 4ace384ad03..1601766770d 100644 --- a/addon/serializer.js +++ b/addon/serializer.js @@ -43,6 +43,7 @@ export default Ember.Object.extend({ http://jsonapi.org/format/#document-structure + @since 1.13.0 @method normalizeResponse @param {DS.Store} store @param {DS.Model} primaryModelClass diff --git a/addon/serializers/json-api.js b/addon/serializers/json-api.js index 46867299232..fd7b5b0b9e5 100644 --- a/addon/serializers/json-api.js +++ b/addon/serializers/json-api.js @@ -93,6 +93,7 @@ var dasherize = Ember.String.dasherize; to the format that the Ember Data store expects. + @since 1.13.0 @class JSONAPISerializer @namespace DS @extends DS.JSONSerializer diff --git a/addon/serializers/json.js b/addon/serializers/json.js index 0833e0bc1ae..29ee9ad0dc5 100644 --- a/addon/serializers/json.js +++ b/addon/serializers/json.js @@ -225,6 +225,7 @@ var JSONSerializer = Serializer.extend({ }); ``` + @since 1.13.0 @method normalizeResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -259,6 +260,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeFindRecordResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -272,6 +274,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeQueryRecordResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -285,6 +288,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeFindAllResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -298,6 +302,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeFindBelongsToResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -311,6 +316,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeFindHasManyResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -324,6 +330,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeFindManyResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -337,6 +344,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeQueryResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -350,6 +358,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeCreateRecordResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -363,6 +372,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeDeleteRecordResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -376,6 +386,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeUpdateRecordResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -389,6 +400,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeSaveResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -402,6 +414,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeSingleResponse @param {DS.Store} store @param {DS.Model} primaryModelClass @@ -415,6 +428,7 @@ var JSONSerializer = Serializer.extend({ }, /** + @since 1.13.0 @method normalizeArrayResponse @param {DS.Store} store @param {DS.Model} primaryModelClass