Current File : /home/jvzmxxx/wiki1/extensions/MobileFrontend/resources/mobile.watchstar/WatchstarGateway.js

( function ( M, $ ) {
	/**
	 * API for managing clickable watchstar
	 *
	 * @class WatchstarGateway
	 *
	 * @constructor
	 * @param {mw.Api} api
	 */
	function WatchstarGateway( api ) {
		this.api = api;
	}

	WatchstarGateway.prototype = {
		_cache: {},

		/**
		 * Cache API response
		 * @method
		 * @private
		 * @param {Object} resp Response from the server
		 */
		_loadIntoCache: function ( resp ) {
			var self = this;
			if ( resp.query && resp.query.pages ) {
				Object.keys( resp.query.pages ).forEach( function ( id ) {
					self._cache[ id ] = resp.query.pages[ id ].hasOwnProperty( 'watched' );
				} );
			}
		},
		/**
		 * Loads the watch status for a given list of page ids in bulk
		 * @method
		 * @param {Array} ids A list of page ids
		 * @param {boolean} markAsAllWatched When true will assume all given ids are watched without a lookup.
		 * @return {jQuery.Deferred}
		 */
		loadWatchStatus: function ( ids, markAsAllWatched ) {
			var self = this,
				result = $.Deferred();

			if ( markAsAllWatched ) {
				ids.forEach( function ( id ) {
					self._cache[ id ] = true;
				} );
				result.resolve();
			} else {
				this.api.get( {
					action: 'query',
					prop: 'info',
					inprop: 'watched',
					pageids: ids
				} ).done( function ( resp ) {
					self._loadIntoCache( resp );
					result.resolve();
				} );
			}
			return result;
		},

		/**
		 * Marks whether a given page is watched or not to avoid an API call
		 * @method
		 * @param {Page} page Page view object
		 * @param {boolean} isWatched True if page is watched
		 */
		setWatchedPage: function ( page, isWatched ) {
			this._cache[ page.getId() ] = isWatched;
		},

		/**
		 * Check if a given page is watched
		 * @method
		 * @param {Page} page Page view object
		 * @return {boolean|undefined} undefined when the watch status is not known.
		 */
		isWatchedPage: function ( page ) {
			var id = page.getId();
			return this._cache[id];
		},

		/**
		 * Toggle the watch status of a known page
		 * @method
		 * @param {Page} page Page view object
		 * @return {jQuery.Deferred}
		 */
		toggleStatus: function ( page ) {
			var data,
				self = this,
				id = page.getId();

			data = {
				action: 'watch'
			};
			if ( id !== 0 ) {
				data.pageids = id;
			} else {
				// it's a new page use title instead
				data.title = page.getTitle();
			}

			if ( this.isWatchedPage( page ) ) {
				data.unwatch = true;
			}
			return this.api.postWithToken( 'watch', data ).done( function () {
				var newStatus = !self.isWatchedPage( page );
				self.setWatchedPage( page, newStatus );
				M.emit( 'watched', page, newStatus );
			} );
		}
	};

	M.define( 'mobile.watchstar/WatchstarGateway', WatchstarGateway );

}( mw.mobileFrontend, jQuery ) );