User:Kashmiri/Flash.js

/*global mw:true */ /* This is my personal javascript library which I call Flash */ /* Copyright (c) 2012-2013 Kangaroopower under the MIT License */ /* It can: a) gather virtually all tokens (save patrol and perhaps some WMF specific ones) 	b) do virtually any action save WMF ones like pagetriage and articlefeedback c) Perform queries (limited for now, to be expanded in the next version)

/* DISCLAIMER: BEFORE 1.0 IT CAN AND WILL GO THROUGH CHANGES THAT MAY BREAK THE API */ $(function {

//Constants var QUERY = 1, ACTION = 2, SPECIAL = 3;

//Version var version = "0.94.4 Hydra";

//Holds all the modules var modules = {};

/*** CONSTRUCTORS ***/

//This is called once, by the Flash variable at the bottom of this script //we could technically do everything in the Flash_main class //but I prefer to have new instances for each new request //we also process version calls in here because version is a static variable //and making a new module just for that would waste a bunch of unnecessary memory var Flash_main = function { this.go = function (module) { return (module === 'version' ? version : new door(module)); };	};

//door is the class that actually executes the request //The reason that we cant do the code in Flash_main is because if we executed the queries //there then all the requests would go through one instance of the class because the Flash_main //object is only created once. Instead, in Flash_main, all we do is create a new door from which //all the code is executed, so there is a new instance of the door class for each request var door = function (module) { module = (module === 'delete' ? 'del' : module); this.token = ''; this.module = module; this.reqType = modules[module].reqType; this.params = {}; this.callback = function {}; this.failure = function {}; };

/*** PRIVATE FUNCTIONS ***/

/* Logs stuff */ var log = (window.console && function {		var args = Array.prototype.slice.call(arguments);		args.unshift('Flash:');		return window.console.log.apply(window.console, args);	}) || $.noop;

/* Does ajax call to API */ var ajax = function (type, url, token, cb, onfail, extraInfo) { var realcb;

type = type.toLowerCase; extraInfo = extraInfo || {}; onfail = onfail || function {};

if (type === "get") { realcb = token; } else if (type === "post") { realcb = cb;

if (token !== false) { extraInfo.token = token; }		}

$.ajax({			url: mw.util.wikiScript('api')+url+'&format=json',			type: type.toUpperCase,			dataType: 'json',			data: extraInfo		}).done(function (data) {			realcb(data);		}).fail(function (data) {			onfail(data);		}); };

/* Checks for most modern type of storage */ var storageCheck = function (sStorage) { var ret;

sStorage = sStorage || false;

if (sStorage) { if (typeof sessionStorage !== "undefined") { ret = 'sessionStorage'; } else if (typeof globalStorage !== "undefined") { ret = 'globalStorage'; } else { ret = false; }		} else { if (typeof localStorage !== "undefined") { ret = 'localStorage'; } else if (typeof globalStorage !== "undefined") { ret = 'globalStorage'; } else { ret = 'cookie'; }		}

return ret; };

/* Start Token calls */

/* This gets all tokens that are accessible from ?action=tokens */ var getToken = function(module, targ, url, callback, failure, extra) { log("Module:", module);

module = module.toLowerCase; module = module === 'del' ? 'delete' : module; module = module === 'preferences' ? 'options' : module;

// verification if (module.match(/(rollback|userrights|undelete)/)) specialToken(module, targ, url, callback, failure, extra); if (!module.match(/(edit|delete|protect|move|block|options|unblock|email|import|watch)/)) return false; // go		var tURL = '?action=tokens&type='+module; ajax("get", tURL, function (data) {			var token = data.tokens[module+"token"];			ajax("post", url, token, callback, failure, extra);		}); };

/* This gets tokens not accessible from ?action=tokens */ var specialToken = function(module, targ, url, callback, failure, extra) { var token; extra = extra || {};

// verify if (module.match(/(rollback|undelete|userrights)/i) === null) return false; //go switch (module) { case 'rollback': var rbtURL = '?action=query&prop=revisions&rvtoken=rollback&indexpageids=1&titles='+targ; ajax('get', rbtURL, function (data) {					token = data.query.pages[data.query.pageids[0]].revisions[0].rollbacktoken;					ajax("post", url, token, callback, failure, extra);				}); break; case 'undelete': var detURL = '?action=query&list=deletedrevs&titles='+targ+'&drprop=token'; ajax('get', detURL, function (data) {					token = data.query.deletedrevs[0].token;					ajax("post", url, token, callback, failure, extra);				}); break; case 'userrights': var urURL = '?action=query&list=users&ustoken=userrights&indexpageids=1&ucusers='+targ; ajax('get', urURL, function (data) {					token = data.query.users[0].userrightstoken;					ajax("post", url, token, callback, failure, extra);				}); break; default: token = false; break; }		};

/*** DOOR FUNCTIONS ***/

/* Load arguments */ door.prototype.load = function (params) { this.params = params; return this; };

/* Load success callback */ door.prototype.wait = function (cb) { var checkedCB = (typeof cb !== "undefined" && typeof cb === "function") ? cb : function {}; this.callback = checkedCB; return this; };

/* Load callback */ door.prototype.fail = function (cb) { var checkedCB = (typeof cb !== "undefined" && typeof cb === "function") ? cb : function {}; this.failure = checkedCB; return this; };

/* Runs query/action */ door.prototype.run = function { var targ = typeof this.params.targ !== "undefined" ? this.params.targ : '', rlmodule = this.module === 'delete' ? 'del' : this.module;

if (this.reqType === ACTION) { modules[rlmodule].run(this.params, rlmodule, this.callback, this.failure, targ); } else if (this.reqType === QUERY || this.reqType === SPECIAL) { modules[this.module].run(this.params, this.callback, this.failure); }	};

/*** MODULES BEGIN ***/

/* Start Action modules */ modules.edit = { reqType: ACTION, run: function (params, module, callback, failure, targ) { var minor = 'notminor=true', twhere = 'text', command = params.command || '', extra = {};

if (command !== '') command = '&' + command; if (typeof params.isMinor !== "undefined" && params.isMinor === true) minor = 'minor=true'; if (typeof params.where !== "undefined" && (params.where === "appendtext" || params.where === "prependtext")) twhere = params.where; //Action var eURL = '?action=edit&title='+params.targ+'&summary='+params.summary+'&'+minor+command; extra[twhere] = params.text; getToken(module, targ, eURL, callback, failure, extra); }	};

modules.rollback = { reqType: ACTION, run: function (params, module, callback, failure, targ) { var rbURL = '?action=rollback&title='+params.targ+'&user='+params.user, command = params.command || '';

if (command !== '') command = '&' + command; if (typeof params.summary !== "undefined" && params.summary !== false) rbURL += '&summary=' + params.summary; rbURL += command;

//Action getToken(module, targ, rbURL, callback, failure); }	};

modules.del = { reqType: ACTION, run: function (params, module, callback, failure, targ) { var deURL = '?action=delete&title='+params.targ+'&reason='+params.summary, command = params.command || '';

if (command !== '') command = '&' + command; deURL += command;

//Action getToken(module, targ, deURL, callback, failure); }	};

modules.protect = { reqType: ACTION, run: function (params, module, callback, failure, targ) { var cascade = '', exp = 'never', command = params.command || '';

if (command !== '') command = '&' + command; if (typeof params.cascading !== "undefined" && params.cascading === true) cascade = "&cascade"; if (typeof params.expiry !== "undefined" && params.expiry !== false) exp = params.expiry; //Action var prURL = '?action=protect&title='+params.targ+'&protections='+params.level+cascade+'&expiry='+exp+'&reason='+params.summary+command; getToken(module, targ, prURL, callback, failure); }	};

modules.move = { reqType: ACTION, run: function (params, module, callback, failure, targ) { // params var talk = '', sub = '', command = params.command || '';

if (command !== '') command = '&' + command; if (typeof params.mTalk !== "undefined" && params.mTalk === true) talk = '&movetalk'; if (typeof params.mSub !== "undefined" && params.mSub === true) sub = '&movesubpages'; //Action var mURL = '?action=move&from='+params.targ+'&to='+params.to+'&reason='+params.summary+sub+talk+command; getToken(module, targ, mURL, callback, failure); }	};

modules.userrights = { reqType: ACTION, run: function (params, module, callback, failure, targ) { // params var add = '', rm = '', command = params.command || '';

if (command !== '') command = '&' + command; if (typeof params.adds !== "undefined" && params.adds !== false) add = '&add='+params.adds; if (typeof params.remove !== "undefined" && params.remove !== false) rm = '&remove'+params.remove; //Action var urURL = '?action=userrights&user='+params.targ+add+rm+'&reason='+params.summary+command; getToken(module, targ, urURL, callback, failure); }	};

modules.block = { reqType: ACTION, run: function (params, module, callback, failure, targ) { //params var expiry = 'never', nemail = '', ablock = '', atalk = '', ncreate = '', anononly = '', command = params.command || '';

if (command !== '') command = '&' + command; if (typeof params.expire !== "undefined" && params.expire !== false) expiry = params.expire; if (typeof params.noemail !== "undefined" && params.noemail === true) nemail = '&noemail'; if (typeof params.autoblock !== "undefined" && params.autoblock === true) ablock = '&autoblock'; if (typeof params.allowtalk !== "undefined" && params.allowtalk === true) atalk = '&allowusertalk'; if (typeof params.nocreate !== "undefined" && params.nocreate === true) ncreate = '&nocreate'; if (typeof params.onlyanon !== "undefined" && params.onlyanon === true) anononly = '&anononly'; //Action var blURL = '?action=block&user='+params.targ+'&expiry='+expiry+'&reason='+params.summary+nemail+ablock+atalk+ncreate+anononly+command; getToken(module, targ, blURL, callback, failure); }	};

modules.email = { reqType: ACTION, run: function (params, module, callback, failure, targ) { var emURL = '?action=emailuser&target='+params.targ+'&subject='+params.subject, command = params.command || '', extra = {};

if (command !== '') command = '&' + command; if (typeof params.ccme !== "undefined" && params.ccme === true) emURL += '&ccme'; emURL += command; //Action extra.text = params.text; getToken(module, targ, emURL, callback, failure, extra); }	};

modules.unblock = { reqType: ACTION, run: function (params, module, callback, failure, targ) { var ubURL = '?action=unblock&user='+params.user+'&reason='+params.summary, command = params.command || '';

if (command !== '') command = '&' + command; ubURL += command;

//Action getToken(module, targ, ubURL, callback, failure); }	};

modules.undelete = { reqType: ACTION, run: function (params, module, callback, failure, targ) { //params var timestamp = '', command = params.command || '';

if (command !== '') command = '&' + command; if (typeof params.timestamps !== "undefined" && params.timestamps !== false) timestamp = '&timestamps='+params.timestamps; //Action var udURL = '?action=undelete&title='+params.targ+'&reason='+params.summary+timestamp+command; getToken(module, targ, udURL, callback, failure); }	};

modules.preferences = { reqType: ACTION, run: function (params, module, callback, failure, targ) { //params var reset = '', keyValue = '', change = '', command = params.command || '';

if (command !== '') command = '&' + command; if (typeof params.reset !== "undefined") { if (params.reset === true) reset = '&reset'; else reset = '&resetkinds=' + params.reset; }			if (typeof params.change !== "undefined") change = '&change='+params.change; if (typeof params.key !== "undefined" && typeof params.value !== "undefined") keyValue = '&optionname='+params.key+'&optionvalue='+params.value; //Action var opURL = '?action=options'+reset+keyValue+change+command; getToken(module, targ, opURL, callback, failure); }	};

modules.purge = { reqType: ACTION, run: function (params, module, callback, failure, targ) { var pURL = '?action=purge&titles='+ params.titles, command = params.command || '';

if (command !== '') command = '&' + command; pURL += command;

//Action getToken(module, targ, pURL, callback, failure); }	};

modules.watch = { reqType: ACTION, run: function (params, module, callback, failure, targ) { var wURL = '?action=watch&title='+ params.targ, command = params.command || '';

if (params.unwatch !== "undefined" && params.unwatch === true) wURL += '&unwatch'; if (command !== '') command = '&' + command; wURL += command;

//Action getToken(module, targ, wURL, callback, failure); }	};

modules.unwatch = { reqType: ACTION, run: function (params, module, callback, failure, targ) { params.unwatch = true; modules.watch.run(params, 'watch', callback, failure, targ); }	};

modules.login = { reqType: ACTION, run: function (params) { //NOTE: Flash DOES NOT SAVE EITHER YOUR USERNAME OR PASSWORD //For script developers- Flash doesn't allow for a callback argument on this ajax("post", '?action=login&lgname='+params.username+'&lgpassword='+params.password, false, function (data) {				ajax("post", '?action=login&lgtoken='+data.login.token+'&lgname='+params.username+'&lgpassword='+params.password, false, document.location.reload);			}); }	};

modules.logout = { reqType: ACTION, run: function (params, module, callback, failure) { ajax("post", '?action=logout', false, callback, failure); }	};

/* Start Special Modules */

//Store data modules.storage = { reqType: SPECIAL, run: function (params, callback) { var type, sStorage = params.sessionOnly || false, goodModes = ['get', 'set', 'remove'], res;

type = storageCheck(sStorage);

if ($.inArray(params.mode, goodModes) <= -1) { callback(false); return; }

if (type === 'localStorage' || type === 'sessionStorage') { res = window[type][params.mode + 'Item'](params.key, params.value); callback(res || true); } else if (type === 'globalStorage') { res = window.globalStorage[window.location.hostname][params.mode + 'Item'](params.key, params.value); callback(res || true); } else if (type === 'cookie') { //Cookie stuff is from quirksmode if (params.mode === 'set') { var expires;

if (typeof params.days !== undefined) { var date = new Date; date.setTime(date.getTime + (params.days*24*60*60*1000)); expires = "; expires=" + date.toGMTString; } else { expires = ""; }					document.cookie = params.key + "=" + params.value + expires + "; path=/"; callback(true); } else if (params.mode === 'get') { var nameEQ = params.name + "=", ca = document.cookie.split(';'); for(var i = 0; i < ca.length; i++) { var c = ca[i]; while (c.charAt(0) === ' ') c = c.substring(1, c.length); if (c.indexOf(nameEQ) === 0) { callback(c.substring(nameEQ.length, c.length)); break; }					}					callback(false); } else if (params.mode !== 'remove') { var expires, date = new Date; date.setTime(date.getTime+(-1*24*60*60*1000)); expires = "; expires="+date.toGMTString;

document.cookie = params.key + "=" + params.value + expires + "; path=/"; callback(true); }			} else { callback(false); }

if (params.server !== "undefined" && params.server === true) { modules.preferences({key: params.key, value: params.value}, 'preferences', function (res) {					callback(res);				}, function {}); }		}	};

/* Start Query Modules */ modules.exists = { reqType: QUERY, run: function (params, callback, failure) { ajax("get", '?action=query&prop=info&indexpageids=1&titles='+params.targ, function (data) {				if (data.query.pages[data.query.pageids].missing === '') callback(false);				else callback(true);			}, failure); }	};

modules.getCreator = { reqType: QUERY, run: function (params, callback, failure) { modules.exists.run({targ: params.targ}, function (data) {				if (data === false) {					callback(false);				} else {					ajax("get", '?action=query&prop=revisions&indexpageids=1&titles='+params.targ+'&rvlimit=1&rvprop=user&rvdir=newer', function (data) { var creator = data.query.pages[data.query.pageids[0]].revisions[0].user; callback(creator); });				}			}, failure); }	};

modules.getUserContribs = { reqType: QUERY, run: function (params, callback, failure) { ajax("get", '?action=query&list=usercontribs&uclimit='+params.number+'&ucuser='+params.user+'&ucprop=ids|title|flags|timestamp|comment', callback, failure); }	};

modules.getUserGroups = { reqType: QUERY, run: function (params, callback, failure) { if (params.user === mw.config.get('wgUserName')) { if (typeof params.group !== "undefined") { callback(($.inArray(params.group, mw.config.get('wgUserGroups')) !== -1)); } else { callback(mw.config.get('wgUserGroups')); }			} else { ajax("get", '?action=query&list=users&usprop=groups&ususers=' + encodeURIComponent(params.user), function (data) {					if (typeof params.group !== "undefined") {						callback(($.inArray(params.group, data.query.users[0].groups) !== -1));					} else {						callback(data.query.users[0].groups);					}				}, failure); }		}	};

modules.getPage = { reqType: QUERY, run: function (params, callback, failure) { // verification params.revisions = params.revisions || 1; if (params.revisions > 500) params.revisions = 500; if (typeof params.properties === "undefined") params.properties = 'user|content|ids|timestamp|comment'; // go			ajax("get", '?action=query&prop=revisions&titles='+params.targ+'&rvprop='+params.properties+'&rvlimit='+params.revisions+'&indexpageids=1', function (data) {				if (data.query.pageids[0] === "-1") { 					callback(false);				} else {					var info = data.query.pages[data.query.pageids[0]], 					res = {						title: info.title					};					for (var i = 0; i < info.revisions.length; i++) { // for each revision						res[i] = {};

// get user if (params.properties.match(/user/i) !== null) { res[i].user = info.revisions[i].user; }

// get content if (params.properties.match(/content/i) !== null) { res[i].content = info.revisions[i]['*']; }

// get timestamp if (params.properties.match(/timestamp/i) !== null) { res[i].timestamp = info.revisions[i].timestamp; }

// get summary if (params.properties.match(/comment/i) !== null) { res[i].summary = info.revisions[i].comment; }

// get size if (params.properties.match(/size/i) !== null) { res[i].size = info.revisions[i].size; }

// get ids if (params.properties.match(/ids/i) !== null) { res[i].ids = { revid: info.revisions[i].revid, parentid: info.revisions[i].parentid };						}					}					callback(res); }			}, failure);		}	};

//Meta query. Accepts a url and spits out the output modules.question = { reqType: QUERY, run: function (params, callback, failure) { ajax("get", params, callback, failure); }	};

/*** RUN CODE ***/

//init is the only instance of Flash_main //Then Flash becaomes the go function for init //When Flash is called it executes the code in Flash_main.prototype.go, //which creates a new door as explained earlier in the code var init = new Flash_main; window.Flash = init.go;

log('loaded version ' + version); });