Ghost/core/server/services/url/Resource.js

const EventEmitter = require('events').EventEmitter;
const logging = require('@tryghost/logging');
const errors = require('@tryghost/errors');

/**
 * Resource cache.
 */
class Resource extends EventEmitter {
    /**
     * @param {('posts'|'pages'|'tags'|'authors')} type - of the resource
     * @param {Object} obj - object data to store
     */
    constructor(type, obj) {
        super();

        this.data = {};
        this.config = {
            type: type,
            reserved: false
        };

        Object.assign(this.data, obj);
    }

    /**
     * @description Get the type of the resource e.g. posts, users ...
     * @returns {String} type
     */
    getType() {
        return this.config.type;
    }

    /**
     * @description Reserve a resource.
     *
     * This happens if a url generator's conditions matches a resource.
     * We have to reserve resources, because otherwise resources can appear in multiple url structures.
     */
    reserve() {
        if (!this.config.reserved) {
            this.config.reserved = true;
        } else {
            logging.error(new errors.InternalServerError({
                message: 'Resource is already taken. This should not happen.',
                code: 'URLSERVICE_RESERVE_RESOURCE'
            }));
        }
    }

    /**
     * @description Release a resource.
     *
     * This happens if conditions of a url generator no longer matches a resource.
     * e.g. change a post to a page.
     */
    release() {
        this.config.reserved = false;
    }

    /**
     * @description Check whether a resource is reserved.
     * @returns {boolean}
     */
    isReserved() {
        return this.config.reserved === true;
    }

    /**
     * @description Update the resource cache.
     *
     * Emit update to subscribers - observer pattern.
     * e.g. url generator will listen on it's own resource's.
     *
     * @param {Object} obj - raw resource data
     */
    update(obj) {
        Object.assign(this.data, obj);

        if (!this.isReserved()) {
            return;
        }

        this.emit('updated', this);
    }

    /**
     * @description Remove a resource.
     *
     * The fn is only useful to emit the action/event right now.
     *
     * CASE: url generator needs to know if one of it's resources/url should be removed.
     */
    remove() {
        // CASE: do not emit, if it is not reserved, because nobody will listen on events.
        if (!this.isReserved()) {
            return;
        }

        this.emit('removed', this);
    }
}

module.exports = Resource;