ui/suggest-owners-trigger.js

/**
 * @license
 * Copyright (C) 2020 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
import {CodeOwnerService} from './code-owners-service.js';
import {ownerState} from './owner-ui-state.js';

export class SuggestOwnersTrigger extends Polymer.Element {
  static get is() {
    return 'suggest-owners-trigger';
  }

  constructor(props) {
    super(props);
    this.expandSuggestionStateUnsubscriber = undefined;
  }

  static get properties() {
    return {
      change: Object,
      reporting: Object,
      restApi: Object,

      expanded: {
        type: Boolean,
        value: false,
      },
      hidden: {
        type: Boolean,
        value: true,
        reflectToAttribute: true,
      },
    };
  }

  static get observers() {
    return ['onInputChanged(restApi, change)'];
  }

  static get template() {
    return Polymer.html`
        <style include="shared-styles">
          :host {
            display: flex;
          }
          a {
            text-decoration: none;
          }
          gr-button {
            --padding: var(--spacing-xs) var(--spacing-s);
          }
        </style>
        <gr-button
          link
          on-click="toggleControlContent"
          has-tooltip
          title="Suggest owners for your change"
        >
          [[computeButtonText(expanded)]]
        </gr-button>
        <span>
          <a on-click="_reportBugClick" href="https://bugs.chromium.org/p/gerrit/issues/entry?template=code-owners-plugin" target="_blank">
            <iron-icon icon="gr-icons:bug" title="report a problem"></iron-icon>
          </a>
          <a on-click="_reportDocClick" href="https://gerrit.googlesource.com/plugins/code-owners/+/master/resources/Documentation/how-to-use.md" target="_blank">
            <iron-icon icon="gr-icons:help-outline" title="read documentation"></iron-icon>
          </a>
        </span>
      `;
  }

  connectedCallback() {
    super.connectedCallback();
    this.expandSuggestionStateUnsubscriber = ownerState
        .onExpandSuggestionChange(expanded => {
          this.expanded = expanded;
        });
  }

  disconnnectedCallback() {
    super.disconnectedCallback();
    if (this.expandSuggestionStateUnsubscriber) {
      this.expandSuggestionStateUnsubscriber();
      this.expandSuggestionStateUnsubscriber = undefined;
    }
  }

  onInputChanged(restApi, change) {
    if ([restApi, change].includes(undefined)) return;
    this.ownerService = CodeOwnerService.getOwnerService(
        this.restApi,
        this.change
    );

    Promise.all([
      this.ownerService.isCodeOwnerEnabled(),
      this.ownerService.areAllFilesApproved(),
      this.ownerService.getLoggedInUserInitialRole()
    ])
        .then(([enabled, approved, userRole]) => {
          if (enabled) {
            this.hidden = approved;
          } else {
            this.hidden = true;
          }
          this._userRole = userRole;
        });
  }

  toggleControlContent() {
    this.expanded = !this.expanded;
    ownerState.expandSuggestion = this.expanded;
    this.reporting.reportInteraction('toggle-suggest-owners', {
      expanded: this.expanded,
      user_role: this._userRole ? this._userRole : 'UNKNOWN',
    });
  }

  computeButtonText(expanded) {
    return expanded ? 'Hide owners' : 'Suggest owners';
  }

  _reportDocClick() {
    this.reporting.reportInteraction('code-owners-doc-click');
  }

  _reportBugClick() {
    this.reporting.reportInteraction('code-owners-bug-click');
  }
}

customElements.define(SuggestOwnersTrigger.is, SuggestOwnersTrigger);