@digicms/cms/lib/core/registries/hooks.js

An open source headless CMS solution to create and manage your own API. It provides a powerful dashboard and features to make your life easier. Databases supported: MySQL, MariaDB, PostgreSQL, SQLite

'use strict';

const { pickBy } = require('lodash/fp');
const { addNamespace, hasNamespace } = require('../utils');

/**
 * @typedef {import('./hooks').Hook} Hook
 */

const hooksRegistry = () => {
  const hooks = {};

  return {
    /**
     * Returns this list of registered hooks uids
     * @returns {string[]}
     */
    keys() {
      return Object.keys(hooks);
    },

    /**
     * Returns the instance of a hook.
     * @param {string} uid
     * @returns {Hook}
     */
    get(uid) {
      return hooks[uid];
    },

    /**
     * Returns a map with all the hooks in a namespace
     * @param {string} namespace
     * @returns {{ [key: string]: Hook }}
     */
    getAll(namespace) {
      return pickBy((_, uid) => hasNamespace(uid, namespace))(hooks);
    },

    /**
     * Registers a hook
     * @param {string} uid
     * @param {Hook} hook
     */
    set(uid, hook) {
      hooks[uid] = hook;
      return this;
    },

    /**
     * Registers a map of hooks for a specific namespace
     * @param {string} namespace
     * @param {{ [key: string]: Hook }} newHooks
     * @returns
     */
    add(namespace, hooks) {
      for (const hookName of Object.keys(hooks)) {
        const hook = hooks[hookName];
        const uid = addNamespace(hookName, namespace);

        this.set(uid, hook);
      }

      return this;
    },

    /**
     * Wraps a hook to extend it
     * @param {string} uid
     * @param {(hook: Hook) => Hook} extendFn
     */
    extend(uid, extendFn) {
      const currentHook = this.get(uid);

      if (!currentHook) {
        throw new Error(`Hook ${uid} doesn't exist`);
      }

      const newHook = extendFn(currentHook);
      hooks[uid] = newHook;

      return this;
    },
  };
};

module.exports = hooksRegistry;