( function () {
	'use strict';

	/**
	 * This class can save a translation into MediaWiki pages using the
	 * MediaWiki edit WebApi.
	 *
	 * @since 2013.10
	 */
	var TranslationApiStorage = function () {
		// No-op for now. Could take api module as param for example.
	};

	TranslationApiStorage.prototype = {
		/**
		 * Save the translation.
		 *
		 * @param {string} title The title of the page including language code
		 *   to store the translation.
		 * @param {string} translation The translation of the message
		 * @param {string} editSummary The edit summary
		 * @return {jQuery.Promise}
		 */
		save: function ( title, translation, editSummary ) {
			var api = new mw.Api();

			return api.postWithToken( 'csrf', {
				format: 'json',
				formatversion: 2,
				action: 'edit',
				title: title,
				text: translation,
				summary: editSummary,
				errorformat: 'html',
				errorlang: 'uselang',
				errorsuselocal: 1,
				uselang: mw.config.get( 'wgUserLanguage' ),
				// If the session expires, fail the saving instead of saving it
				// as an anonymous user (if anonymous can save).
				// When undefined, the parameter is not included in the request
				assert: mw.user.isAnon() ? undefined : 'user'
			} );
		}
	};

	mw.translate = mw.translate || {};
	/** @private */
	mw.translate.TranslationApiStorage = TranslationApiStorage;
}() );