datahub/wherehows-web/app/components/dataset-deprecation.ts

import Component from '@ember/component';
import { getProperties, computed, set } from '@ember/object';
import ComputedProperty, { oneWay } from '@ember/object/computed';
import { baseCommentEditorOptions } from 'wherehows-web/constants';
import { action } from '@ember-decorators/object';
import { IDatasetView } from 'wherehows-web/typings/api/datasets/dataset';

export default class DatasetDeprecation extends Component {
  tagName = 'div';

  classNames = ['dataset-deprecation-toggle'];

  /**
   * Currently selected date
   * @type {Date}
   * @memberof DatasetAclAccess
   */
  selectedDate: Date = new Date();

  /**
   * Date around which the calendar is centered
   * @type {Date}
   * @memberof DatasetAclAccess
   */
  centeredDate: Date = this.selectedDate;

  /**
   * Date the dataset should be decommissioned
   * @type {IDatasetView.decommissionTime}
   * @memberof DatasetAclAccess
   */
  decommissionTime: IDatasetView['decommissionTime'];

  /**
   * The earliest date a user can select as a decommission date
   * @type {Date}
   * @memberof DatasetAclAccess
   */
  minSelectableDecommissionDate: Date = new Date(Date.now() + 24 * 60 * 60 * 1000);

  /**
   * Flag indicating that the dataset is deprecated or otherwise
   * @type {(null | boolean)}
   * @memberof DatasetDeprecation
   */
  deprecated: null | boolean;

  /**
   * Working reference to the dataset's deprecated flag
   * @memberof DatasetDeprecation
   * @type {ComputedProperty<DatasetDeprecation.deprecated>}
   */
  deprecatedAlias: ComputedProperty<DatasetDeprecation['deprecated']> = oneWay('deprecated');

  /**
   * Note accompanying the deprecation flag change
   * @type {string}
   * @memberof DatasetDeprecation
   */
  deprecationNote: string;

  /**
   * Working reference to the dataset's deprecationNote
   * @memberof DatasetDeprecation
   * @type {ComputedProperty<DatasetDeprecation.deprecationNote>}
   */
  deprecationNoteAlias: ComputedProperty<DatasetDeprecation['deprecationNote']> = oneWay('deprecationNote');

  /**
   * Checks the working / aliased copies of the deprecation properties diverge from the
   * saved versions i.e. deprecationNoteAlias and deprecationAlias
   * @type {ComputedProperty<boolean>}
   * @memberof DatasetDeprecation
   */
  isDirty: ComputedProperty<boolean> = computed(
    'deprecatedAlias',
    'deprecated',
    'deprecationNote',
    'deprecationNoteAlias',
    function(this: DatasetDeprecation) {
      const { deprecatedAlias, deprecated, deprecationNote, deprecationNoteAlias } = getProperties(this, [
        'deprecatedAlias',
        'deprecated',
        'deprecationNote',
        'deprecationNoteAlias'
      ]);

      return deprecatedAlias !== deprecated || deprecationNoteAlias !== deprecationNote;
    }
  );

  /**
   * The external action to be completed when a save is initiated
   * @type {(isDeprecated: boolean, updateDeprecationNode: string, decommissionTime: Date | null) => Promise<void>}
   * @memberof DatasetDeprecation
   */
  onUpdateDeprecation: (
    isDeprecated: boolean,
    updateDeprecationNode: string,
    decommissionTime: Date | null
  ) => Promise<void> | void;

  editorOptions = {
    ...baseCommentEditorOptions,
    placeholder: {
      text: "You may provide a note about this dataset's deprecation status"
    }
  };

  /**
   * Toggles the boolean value of deprecatedAlias
   */
  @action
  toggleDeprecatedStatus(this: DatasetDeprecation) {
    this.toggleProperty('deprecatedAlias');
  }

  /**
   * Handles updates to the decommissionTime attribute
   * @param {Date} decommissionTime date dataset should be decommissioned
   */
  @action
  onDecommissionDateChange(this: DatasetDeprecation, decommissionTime: Date) {
    set(this, 'decommissionTime', new Date(decommissionTime).getTime());
  }

  /**
   * Invokes the save action with the updated values for
   * deprecated decommissionTime, and deprecationNote
   * @return {Promise<void>}
   */
  @action
  async onSave(this: DatasetDeprecation) {
    const { deprecatedAlias, deprecationNoteAlias, decommissionTime } = getProperties(this, [
      'deprecatedAlias',
      'deprecationNoteAlias',
      'decommissionTime'
    ]);
    const { onUpdateDeprecation } = this;

    if (onUpdateDeprecation) {
      const noteValue = deprecatedAlias ? deprecationNoteAlias : '';
      const time = decommissionTime ? new Date(decommissionTime) : null;

      await onUpdateDeprecation(!!deprecatedAlias, noteValue || '', time);
      set(this, 'deprecationNoteAlias', noteValue);
    }
  }
}