1 files changed, 199 insertions, 0 deletions
diff --git a/www/wiki/resources/src/mediawiki/api/edit.js b/www/wiki/resources/src/mediawiki/api/edit.js
new file mode 100644
index 00000000..21c55c70
--- /dev/null
+++ b/www/wiki/resources/src/mediawiki/api/edit.js
@@ -0,0 +1,199 @@
+/**
+ * @class mw.Api.plugin.edit
+ */
+( function ( mw, $ ) {
+
+	$.extend( mw.Api.prototype, {
+
+		/**
+		 * Post to API with csrf token. If we have no token, get one and try to post.
+		 * If we have a cached token try using that, and if it fails, blank out the
+		 * cached token and start over.
+		 *
+		 * @param {Object} params API parameters
+		 * @param {Object} [ajaxOptions]
+		 * @return {jQuery.Promise} See #post
+		 */
+		postWithEditToken: function ( params, ajaxOptions ) {
+			return this.postWithToken( 'csrf', params, ajaxOptions );
+		},
+
+		/**
+		 * API helper to grab a csrf token.
+		 *
+		 * @return {jQuery.Promise} Received token.
+		 */
+		getEditToken: function () {
+			return this.getToken( 'csrf' );
+		},
+
+		/**
+		 * Create a new page.
+		 *
+		 * Example:
+		 *
+		 *     new mw.Api().create( 'Sandbox',
+		 *         { summary: 'Load sand particles.' },
+		 *         'Sand.'
+		 *     );
+		 *
+		 * @since 1.28
+		 * @param {mw.Title|string} title Page title
+		 * @param {Object} params Edit API parameters
+		 * @param {string} params.summary Edit summary
+		 * @param {string} content
+		 * @return {jQuery.Promise} API response
+		 */
+		create: function ( title, params, content ) {
+			return this.postWithEditToken( $.extend( {
+				action: 'edit',
+				title: String( title ),
+				text: content,
+				formatversion: '2',
+
+				// Protect against errors and conflicts
+				assert: mw.user.isAnon() ? undefined : 'user',
+				createonly: true
+			}, params ) ).then( function ( data ) {
+				return data.edit;
+			} );
+		},
+
+		/**
+		 * Edit an existing page.
+		 *
+		 * To create a new page, use #create() instead.
+		 *
+		 * Simple transformation:
+		 *
+		 *     new mw.Api()
+		 *         .edit( 'Sandbox', function ( revision ) {
+		 *             return revision.content.replace( 'foo', 'bar' );
+		 *         } )
+		 *         .then( function () {
+		 *             console.log( 'Saved! ');
+		 *         } );
+		 *
+		 * Set save parameters by returning an object instead of a string:
+		 *
+		 *     new mw.Api().edit(
+		 *         'Sandbox',
+		 *         function ( revision ) {
+		 *             return {
+		 *                 text: revision.content.replace( 'foo', 'bar' ),
+		 *                 summary: 'Replace "foo" with "bar".',
+		 *                 assert: 'bot',
+		 *                 minor: true
+		 *             };
+		 *         }
+		 *     )
+		 *     .then( function () {
+		 *         console.log( 'Saved! ');
+		 *     } );
+		 *
+		 * Transform asynchronously by returning a promise.
+		 *
+		 *     new mw.Api()
+		 *         .edit( 'Sandbox', function ( revision ) {
+		 *             return Spelling
+		 *                 .corrections( revision.content )
+		 *                 .then( function ( report ) {
+		 *                     return {
+		 *                         text: report.output,
+		 *                         summary: report.changelog
+		 *                     };
+		 *                 } );
+		 *         } )
+		 *         .then( function () {
+		 *             console.log( 'Saved! ');
+		 *         } );
+		 *
+		 * @since 1.28
+		 * @param {mw.Title|string} title Page title
+		 * @param {Function} transform Callback that prepares the edit
+		 * @param {Object} transform.revision Current revision
+		 * @param {string} transform.revision.content Current revision content
+		 * @param {string|Object|jQuery.Promise} transform.return New content, object with edit
+		 *  API parameters, or promise providing one of those.
+		 * @return {jQuery.Promise} Edit API response
+		 */
+		edit: function ( title, transform ) {
+			var basetimestamp, curtimestamp,
+				api = this;
+
+			title = String( title );
+
+			return api.get( {
+				action: 'query',
+				prop: 'revisions',
+				rvprop: [ 'content', 'timestamp' ],
+				titles: [ title ],
+				formatversion: '2',
+				curtimestamp: true
+			} )
+				.then( function ( data ) {
+					var page, revision;
+					if ( !data.query || !data.query.pages ) {
+						return $.Deferred().reject( 'unknown' );
+					}
+					page = data.query.pages[ 0 ];
+					if ( !page || page.invalid ) {
+						return $.Deferred().reject( 'invalidtitle' );
+					}
+					if ( page.missing ) {
+						return $.Deferred().reject( 'nocreate-missing' );
+					}
+					revision = page.revisions[ 0 ];
+					basetimestamp = revision.timestamp;
+					curtimestamp = data.curtimestamp;
+					return transform( {
+						timestamp: revision.timestamp,
+						content: revision.content
+					} );
+				} )
+				.then( function ( params ) {
+					var editParams = typeof params === 'object' ? params : { text: String( params ) };
+					return api.postWithEditToken( $.extend( {
+						action: 'edit',
+						title: title,
+						formatversion: '2',
+
+						// Protect against errors and conflicts
+						assert: mw.user.isAnon() ? undefined : 'user',
+						basetimestamp: basetimestamp,
+						starttimestamp: curtimestamp,
+						nocreate: true
+					}, editParams ) );
+				} )
+				.then( function ( data ) {
+					return data.edit;
+				} );
+		},
+
+		/**
+		 * Post a new section to the page.
+		 *
+		 * @see #postWithEditToken
+		 * @param {mw.Title|string} title Target page
+		 * @param {string} header
+		 * @param {string} message wikitext message
+		 * @param {Object} [additionalParams] Additional API parameters, e.g. `{ redirect: true }`
+		 * @return {jQuery.Promise}
+		 */
+		newSection: function ( title, header, message, additionalParams ) {
+			return this.postWithEditToken( $.extend( {
+				action: 'edit',
+				section: 'new',
+				title: String( title ),
+				summary: header,
+				text: message
+			}, additionalParams ) );
+		}
+	} );
+
+	/**
+	 * @class mw.Api
+	 * @mixins mw.Api.plugin.edit
+	 */
+
+}( mediaWiki, jQuery ) );