All: Add support for application plugins (#3257)

ReactNativeClient/lib/services/plugins/utils/createViewHandle.ts

@@ -0,0 +1,8 @@
+import uuid from 'lib/uuid';
+import Plugin from '../Plugin';
+
+export type ViewHandle = string;
+
+export default function createViewHandle(plugin:Plugin):ViewHandle {
+	return `plugin-view-${plugin.id}-${uuid.createNano()}`;
+}

ReactNativeClient/lib/services/plugins/utils/executeSandboxCall.ts

@@ -0,0 +1,45 @@
+import Global from '../api/Global';
+
+type EventHandler = (callbackId:string, args:any[]) => void;
+
+function createEventHandlers(arg:any, eventHandler:EventHandler) {
+	if (Array.isArray(arg)) {
+		for (let i = 0; i < arg.length; i++) {
+			arg[i] = createEventHandlers(arg[i], eventHandler);
+		}
+		return arg;
+	} else if (typeof arg === 'string' && arg.indexOf('___plugin_event_') === 0) {
+		const callbackId = arg;
+		return async (...args:any[]) => {
+			const result = await eventHandler(callbackId, args);
+			return result;
+		};
+	} else if (arg === null || arg === undefined) {
+		return arg;
+	} else if (typeof arg === 'object') {
+		for (const n in arg) {
+			arg[n] = createEventHandlers(arg[n], eventHandler);
+		}
+	}
+
+	return arg;
+}
+
+export default async function executeSandboxCall(pluginId:string, sandbox:Global, path:string, args:any[], eventHandler:EventHandler) {
+	const pathFragments = path.split('.');
+
+	let parent:any = null;
+	let fn:any = sandbox;
+
+	if (!fn) throw new Error(`No sandbox for plugin ${pluginId}`); // Sanity check as normally cannot happen
+
+	for (const pathFragment of pathFragments) {
+		parent = fn;
+		fn = fn[pathFragment];
+		if (!fn) throw new Error(`Property or method "${pathFragment}" does not exist in "${path}"`);
+	}
+
+	const convertedArgs = createEventHandlers(args, eventHandler);
+
+	return fn.apply(parent, convertedArgs);
+}

ReactNativeClient/lib/services/plugins/utils/manifestFromObject.ts

@@ -0,0 +1,37 @@
+import { PluginManifest, PluginPermission } from './types';
+
+export default function manifestFromObject(o:any):PluginManifest {
+
+	const getString = (name:string, required:boolean = true, defaultValue:string = ''):string => {
+		if (required && !o[name]) throw new Error(`Missing required field: ${name}`);
+		if (!o[name]) return defaultValue;
+		if (typeof o[name] !== 'string') throw new Error(`Field must be a string: ${name}`);
+		return o[name];
+	};
+
+	const getNumber = (name:string, required:boolean = true):number => {
+		if (required && !o[name]) throw new Error(`Missing required field: ${name}`);
+		if (!o[name]) return 0;
+		if (typeof o[name] !== 'number') throw new Error(`Field must be a number: ${name}`);
+		return o[name];
+	};
+
+	const permissions:PluginPermission[] = [];
+
+	const manifest = {
+		manifest_version: getNumber('manifest_version', true),
+		name: getString('name', true),
+		version: getString('version', true),
+		description: getString('description', false),
+		homepage_url: getString('homepage_url'),
+		permissions: permissions,
+	};
+
+	if (o.permissions) {
+		for (const p of o.permissions) {
+			manifest.permissions.push(p);
+		}
+	}
+
+	return manifest;
+}

ReactNativeClient/lib/services/plugins/utils/mapEventHandlersToIds.ts

@@ -0,0 +1,29 @@
+let eventHandlerIndex_ = 1;
+
+export interface EventHandlers {
+	[key:string]: Function;
+}
+
+export default function mapEventHandlersToIds(arg:any, eventHandlers:EventHandlers) {
+	if (Array.isArray(arg)) {
+		for (let i = 0; i < arg.length; i++) {
+			arg[i] = mapEventHandlersToIds(arg[i], eventHandlers);
+		}
+		return arg;
+	} else if (typeof arg === 'function') {
+		const id = `___plugin_event_${eventHandlerIndex_}`;
+		eventHandlerIndex_++;
+		eventHandlers[id] = arg;
+		return id;
+	} else if (arg === null) {
+		return null;
+	} else if (arg === undefined) {
+		return undefined;
+	} else if (typeof arg === 'object') {
+		for (const n in arg) {
+			arg[n] = mapEventHandlersToIds(arg[n], eventHandlers);
+		}
+	}
+
+	return arg;
+}

ReactNativeClient/lib/services/plugins/utils/types.ts

@@ -0,0 +1,12 @@
+export enum PluginPermission {
+	Model = 'model',
+}
+
+export interface PluginManifest {
+	manifest_version: number,
+	name: string,
+	version: string,
+	description?: string,
+	homepage_url?: string,
+	permissions?: PluginPermission[],
+}

ReactNativeClient/lib/services/plugins/utils/viewIdGen.js

@@ -0,0 +1,8 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+const uuid_1 = require('lib/uuid');
+function viewIdGen(plugin) {
+	return `plugin-view-${plugin.id}-${uuid_1.default.createNano()}`;
+}
+exports.default = viewIdGen;
+// # sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmlld0lkR2VuLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsidmlld0lkR2VuLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQ0EsbUNBQTRCO0FBRTVCLFNBQXdCLFNBQVMsQ0FBQyxNQUFhO0lBQzlDLE9BQU8sZUFBZSxNQUFNLENBQUMsRUFBRSxJQUFJLGNBQUksQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFBO0FBQ3ZELENBQUM7QUFGRCw0QkFFQyJ9