api/skill/SkillCollection.js

import SimpleSchema from 'simpl-schema';
import { slugify, Slugs } from '../slug/SlugCollection';
import BaseSlugCollection from '../base/BaseSlugCollection';

/** @namespace api/skill */

/**
 * Represents a specific Skill, such as "Software Engineering".
 * @extends api/base.BaseSlugCollection
 * @memberOf api/skill
 */
class SkillCollection extends BaseSlugCollection {
  /**
   * Creates the Skill collection.
   */
  constructor() {
    super('Skill', new SimpleSchema({
      name: { type: String },
      slugID: { type: SimpleSchema.RegEx.Id },
      description: { type: String },
    }));
  }

  /**
   * Defines a new Skill and its associated Slug.
   * @example
   * Skills.define({ name: 'Software Engineering',
   *                    description: 'Methods for group development of large, high quality software systems',
   * });
   * @param { Object } description Object with keys name, slug, description.
   * Slug must be previously undefined.
   * @throws {Meteor.Error} If the Skill definition includes a defined slug.
   * @returns The newly created docID.
   */
  define({
           name,
           description,
         }) {
    const slug = slugify(name); // we automatically build the slug from the name.
    // Get SlugID, throw error if found.
    const slugID = Slugs.define({ name: slug });
    // Define the Skill and get its ID
    const SkillID = this._collection.insert({
      name, description, slugID,
    });
    // Connect the Slug to this Skill
    Slugs.updateEntityID(slugID, SkillID);
    return SkillID;
  }

  /**
   * Update an Skill.
   * @param docID The docID to be updated.
   * @param name The new name (optional).
   * @param description The new description (optional).
   * @throws { Meteor.Error } If docID is not defined.
   */
  update(docID, {
    name, description,
  }) {
    this.assertDefined(docID);
    const updateData = {};
    if (name) {
      updateData.name = name;
    }
    if (description) {
      updateData.description = description;
    }
    this._collection.update(docID, { $set: updateData });
  }

  /**
   * Remove the Skill.
   * @param instance The docID or slug of the entity to be removed.
   * @throws { Meteor.Error } If Skill is associated with any Challenge.
   */
  removeIt(instance) {
    const docID = this.getID(instance);
    // Check that this Skill is not referenced by any Team, Developer, or Challenge.

    // OK, clear to delete.
    super.removeIt(docID);
  }

  /**
   * Returns an object representing the given Skill.
   * @param docID {string} the ID of the Skill.
   * @return {{name: *, description: *}}
   */
  dumpOne(docID) {
    const doc = this.findDoc(docID);
    const { name, description } = doc;
    return { name, description };
  }
}

/**
 * Singleton instance of the SkillCollection.
 * @type {api/skill.SkillCollection}
 * @memberOf api/skill
 */
export const Skills = new SkillCollection();