etherpad-lite/src/static/js/pluginfw/hooks.js

var plugins = require("ep_etherpad-lite/static/js/pluginfw/plugins");

/* FIXME: Ugly hack, in the future, use same code for server & client */
if (plugins.isClient) {
  var async = require("ep_etherpad-lite/static/js/pluginfw/async");
} else {
  var async = require("async");
}

var hookCallWrapper = function (hook, hook_name, args, cb) {
  if (cb === undefined) cb = function (x) { return x; };
  try {
    return hook.hook_fn(hook_name, args, cb);
  } catch (ex) {
    console.error([hook_name, hook.part.full_name, ex]);
  }
}


/* Don't use Array.concat as it flatterns arrays within the array */
exports.flatten = function (lst) {
  var res = [];
  if (lst != undefined && lst != null) {
    for (var i = 0; i < lst.length; i++) {
      if (lst[i] != undefined && lst[i] != null) {
        for (var j = 0; j < lst[i].length; j++) {
          res.push(lst[i][j]);
	}
      }
    }
  }
  return res;
}

exports.callAll = function (hook_name, args) {
  if (plugins.hooks[hook_name] === undefined) return [];
  return exports.flatten(plugins.hooks[hook_name].map(function (hook) {
    return hookCallWrapper(hook, hook_name, args);
  }));
}

exports.aCallAll = function (hook_name, args, cb) {
  if (plugins.hooks[hook_name] === undefined) cb([]);
  async.map(
    plugins.hooks[hook_name],
    function (hook, cb) {
      hookCallWrapper(hook, hook_name, args, function (res) { cb(null, res); });
    },
    function (err, res) {
      cb(exports.flatten(res));
    }
  );
}

exports.callFirst = function (hook_name, args) {
  if (plugins.hooks[hook_name][0] === undefined) return [];
  return exports.flatten(hookCallWrapper(plugins.hooks[hook_name][0], hook_name, args));
}

exports.aCallFirst = function (hook_name, args, cb) {
  if (plugins.hooks[hook_name][0] === undefined) cb([]);
  hookCallWrapper(plugins.hooks[hook_name][0], hook_name, args, function (res) { cb(exports.flatten(res)); });
}