123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604 |
- import {Fragment} from 'react';
- import type {RouteComponentProps} from 'react-router';
- import {browserHistory} from 'react-router';
- import styled from '@emotion/styled';
- import debounce from 'lodash/debounce';
- import groupBy from 'lodash/groupBy';
- import startCase from 'lodash/startCase';
- import * as qs from 'query-string';
- import DocIntegrationAvatar from 'sentry/components/avatar/docIntegrationAvatar';
- import DeprecatedAsyncComponent from 'sentry/components/deprecatedAsyncComponent';
- import SelectControl from 'sentry/components/forms/controls/selectControl';
- import HookOrDefault from 'sentry/components/hookOrDefault';
- import ExternalLink from 'sentry/components/links/externalLink';
- import Panel from 'sentry/components/panels/panel';
- import PanelBody from 'sentry/components/panels/panelBody';
- import SearchBar from 'sentry/components/searchBar';
- import SentryAppIcon from 'sentry/components/sentryAppIcon';
- import SentryDocumentTitle from 'sentry/components/sentryDocumentTitle';
- import {t, tct} from 'sentry/locale';
- import {space} from 'sentry/styles/space';
- import type {
- AppOrProviderOrPlugin,
- DocIntegration,
- Integration,
- IntegrationProvider,
- Organization,
- PluginWithProjectList,
- SentryApp,
- SentryAppInstallation,
- } from 'sentry/types';
- import {uniq} from 'sentry/utils/array/uniq';
- import type {Fuse} from 'sentry/utils/fuzzySearch';
- import {createFuzzySearch} from 'sentry/utils/fuzzySearch';
- import {
- getAlertText,
- getCategoriesForIntegration,
- getIntegrationStatus,
- getSentryAppInstallStatus,
- isDocIntegration,
- isPlugin,
- isSentryApp,
- trackIntegrationAnalytics,
- } from 'sentry/utils/integrationUtil';
- import withOrganization from 'sentry/utils/withOrganization';
- import SettingsPageHeader from 'sentry/views/settings/components/settingsPageHeader';
- import PermissionAlert from 'sentry/views/settings/organization/permissionAlert';
- import CreateIntegrationButton from 'sentry/views/settings/organizationIntegrations/createIntegrationButton';
- import ReinstallAlert from 'sentry/views/settings/organizationIntegrations/reinstallAlert';
- import {POPULARITY_WEIGHT} from './constants';
- import IntegrationRow from './integrationRow';
- const FirstPartyIntegrationAlert = HookOrDefault({
- hookName: 'component:first-party-integration-alert',
- defaultComponent: () => null,
- });
- const fuseOptions = {
- threshold: 0.3,
- location: 0,
- distance: 100,
- includeScore: true as const,
- keys: ['slug', 'key', 'name', 'id'],
- };
- type Props = RouteComponentProps<{}, {}> & {
- hideHeader: boolean;
- organization: Organization;
- };
- type State = {
- appInstalls: SentryAppInstallation[] | null;
- config: {providers: IntegrationProvider[]} | null;
- displayedList: AppOrProviderOrPlugin[];
- docIntegrations: DocIntegration[] | null;
- integrations: Integration[] | null;
- list: AppOrProviderOrPlugin[];
- orgOwnedApps: SentryApp[] | null;
- plugins: PluginWithProjectList[] | null;
- publishedApps: SentryApp[] | null;
- searchInput: string;
- selectedCategory: string;
- extraApp?: SentryApp;
- fuzzy?: Fuse<AppOrProviderOrPlugin>;
- };
- const TEXT_SEARCH_ANALYTICS_DEBOUNCE_IN_MS = 1000;
- export class IntegrationListDirectory extends DeprecatedAsyncComponent<
- Props & DeprecatedAsyncComponent['props'],
- State & DeprecatedAsyncComponent['state']
- > {
- // Some integrations require visiting a different website to add them. When
- // we come back to the tab we want to show our integrations as soon as we can.
- shouldReload = true;
- reloadOnVisible = true;
- shouldReloadOnVisible = true;
- getDefaultState() {
- return {
- ...super.getDefaultState(),
- list: [],
- displayedList: [],
- selectedCategory: '',
- };
- }
- onLoadAllEndpointsSuccess() {
- const {publishedApps, orgOwnedApps, extraApp, plugins, docIntegrations} = this.state;
- const published = publishedApps || [];
- // If we have an extra app in state from query parameter, add it as org owned app
- if (orgOwnedApps !== null && extraApp) {
- orgOwnedApps.push(extraApp);
- }
- // we don't want the app to render twice if its the org that created
- // the published app.
- const orgOwned = orgOwnedApps?.filter(
- app => !published.find(p => p.slug === app.slug)
- );
- /**
- * We should have three sections:
- * 1. Public apps and integrations available to everyone
- * 2. Unpublished apps available to that org
- * 3. Internal apps available to that org
- */
- const combined = ([] as AppOrProviderOrPlugin[])
- .concat(published)
- .concat(orgOwned ?? [])
- .concat(this.providers)
- .concat(plugins ?? [])
- .concat(docIntegrations ?? []);
- const list = this.sortIntegrations(combined);
- const {searchInput, selectedCategory} = this.getFilterParameters();
- this.setState({list, searchInput, selectedCategory}, () => {
- this.updateDisplayedList();
- this.trackPageViewed();
- });
- }
- trackPageViewed() {
- // count the number of installed apps
- const {integrations, publishedApps, plugins} = this.state;
- const integrationsInstalled = new Set();
- // add installed integrations
- integrations?.forEach((integration: Integration) => {
- integrationsInstalled.add(integration.provider.key);
- });
- // add sentry apps
- publishedApps?.filter(this.getAppInstall).forEach((sentryApp: SentryApp) => {
- integrationsInstalled.add(sentryApp.slug);
- });
- // add plugins
- plugins?.forEach((plugin: PluginWithProjectList) => {
- if (plugin.projectList.length) {
- integrationsInstalled.add(plugin.slug);
- }
- });
- trackIntegrationAnalytics(
- 'integrations.index_viewed',
- {
- integrations_installed: integrationsInstalled.size,
- view: 'integrations_directory',
- organization: this.props.organization,
- },
- {startSession: true}
- );
- }
- getEndpoints(): ReturnType<DeprecatedAsyncComponent['getEndpoints']> {
- const {organization} = this.props;
- const baseEndpoints: ([string, string, any] | [string, string])[] = [
- ['config', `/organizations/${organization.slug}/config/integrations/`],
- [
- 'integrations',
- `/organizations/${organization.slug}/integrations/`,
- {query: {includeConfig: 0}},
- ],
- ['orgOwnedApps', `/organizations/${organization.slug}/sentry-apps/`],
- ['publishedApps', '/sentry-apps/', {query: {status: 'published'}}],
- ['appInstalls', `/organizations/${organization.slug}/sentry-app-installations/`],
- ['plugins', `/organizations/${organization.slug}/plugins/configs/`],
- ['docIntegrations', '/doc-integrations/'],
- ];
- /**
- * optional app to load for super users
- * should only be done for unpublished integrations from another org
- * but no checks are in place to ensure the above condition
- */
- const extraAppSlug = new URLSearchParams(this.props.location.search).get('extra_app');
- if (extraAppSlug) {
- baseEndpoints.push(['extraApp', `/sentry-apps/${extraAppSlug}/`]);
- }
- return baseEndpoints;
- }
- // State
- get unmigratableReposByOrg() {
- // Group by [GitHub|BitBucket|VSTS] Org name
- return groupBy(this.state.unmigratableRepos, repo => repo.name.split('/')[0]);
- }
- get providers(): IntegrationProvider[] {
- return this.state.config?.providers ?? [];
- }
- getAppInstall = (app: SentryApp) =>
- this.state.appInstalls?.find(i => i.app.slug === app.slug);
- // Returns 0 if uninstalled, 1 if pending, and 2 if installed
- getInstallValue(integration: AppOrProviderOrPlugin) {
- const {integrations} = this.state;
- if (isPlugin(integration)) {
- return integration.projectList.length > 0 ? 2 : 0;
- }
- if (isSentryApp(integration)) {
- const install = this.getAppInstall(integration);
- if (install) {
- return install.status === 'pending' ? 1 : 2;
- }
- return 0;
- }
- if (isDocIntegration(integration)) {
- return 0;
- }
- return integrations?.find(i => i.provider.key === integration.key) ? 2 : 0;
- }
- getInstallStatuses(integrations: Integration[]) {
- const statusList = integrations?.map(getIntegrationStatus);
- // if we have conflicting statuses, we have a priority order
- if (statusList.includes('active')) {
- return 'Installed';
- }
- if (statusList.includes('disabled')) {
- return 'Disabled';
- }
- if (statusList.includes('pending_deletion')) {
- return 'Pending Deletion';
- }
- return 'Not Installed';
- }
- getPopularityWeight = (integration: AppOrProviderOrPlugin) => {
- if (isSentryApp(integration) || isDocIntegration(integration)) {
- return integration?.popularity ?? 1;
- }
- return POPULARITY_WEIGHT[integration.slug] ?? 1;
- };
- sortByName = (a: AppOrProviderOrPlugin, b: AppOrProviderOrPlugin) =>
- a.slug.localeCompare(b.slug);
- sortByPopularity = (a: AppOrProviderOrPlugin, b: AppOrProviderOrPlugin) => {
- const weightA = this.getPopularityWeight(a);
- const weightB = this.getPopularityWeight(b);
- return weightB - weightA;
- };
- sortByInstalled = (a: AppOrProviderOrPlugin, b: AppOrProviderOrPlugin) =>
- this.getInstallValue(b) - this.getInstallValue(a);
- sortIntegrations(integrations: AppOrProviderOrPlugin[]) {
- return integrations.sort((a: AppOrProviderOrPlugin, b: AppOrProviderOrPlugin) => {
- // sort by whether installed first
- const diffWeight = this.sortByInstalled(a, b);
- if (diffWeight !== 0) {
- return diffWeight;
- }
- // then sort by popularity
- const diffPop = this.sortByPopularity(a, b);
- if (diffPop !== 0) {
- return diffPop;
- }
- // then sort by name
- return this.sortByName(a, b);
- });
- }
- async componentDidUpdate(_: Props, prevState: State) {
- if (this.state.list.length !== prevState.list.length) {
- await this.createSearch();
- }
- }
- async createSearch() {
- const {list} = this.state;
- this.setState({
- fuzzy: await createFuzzySearch(list || [], fuseOptions),
- });
- }
- debouncedTrackIntegrationSearch = debounce((search: string, numResults: number) => {
- trackIntegrationAnalytics('integrations.directory_item_searched', {
- view: 'integrations_directory',
- search_term: search,
- num_results: numResults,
- organization: this.props.organization,
- });
- }, TEXT_SEARCH_ANALYTICS_DEBOUNCE_IN_MS);
- /**
- * Get filter parameters and guard against `qs.parse` returning arrays.
- */
- getFilterParameters = (): {searchInput: string; selectedCategory: string} => {
- const {category, search} = qs.parse(this.props.location.search);
- const selectedCategory = Array.isArray(category) ? category[0] : category || '';
- const searchInput = Array.isArray(search) ? search[0] : search || '';
- return {searchInput, selectedCategory};
- };
- /**
- * Update the query string with the current filter parameter values.
- */
- updateQueryString = () => {
- const {searchInput, selectedCategory} = this.state;
- const searchString = qs.stringify({
- ...qs.parse(this.props.location.search),
- search: searchInput ? searchInput : undefined,
- category: selectedCategory ? selectedCategory : undefined,
- });
- browserHistory.replace({
- pathname: this.props.location.pathname,
- search: searchString ? `?${searchString}` : undefined,
- });
- };
- /**
- * Filter the integrations list by ANDing together the search query and the category select.
- */
- updateDisplayedList = (): AppOrProviderOrPlugin[] => {
- const {fuzzy, list, searchInput, selectedCategory} = this.state;
- let displayedList = list;
- if (searchInput && fuzzy) {
- const searchResults = fuzzy.search(searchInput);
- displayedList = this.sortIntegrations(searchResults.map(i => i.item));
- }
- if (selectedCategory) {
- displayedList = displayedList.filter(integration =>
- getCategoriesForIntegration(integration).includes(selectedCategory)
- );
- }
- this.setState({displayedList});
- return displayedList;
- };
- handleSearchChange = (value: string) => {
- this.setState({searchInput: value}, () => {
- this.updateQueryString();
- const result = this.updateDisplayedList();
- if (value) {
- this.debouncedTrackIntegrationSearch(value, result.length);
- }
- });
- };
- onCategorySelect = ({value: category}: {value: string}) => {
- this.setState({selectedCategory: category}, () => {
- this.updateQueryString();
- this.updateDisplayedList();
- if (category) {
- trackIntegrationAnalytics('integrations.directory_category_selected', {
- view: 'integrations_directory',
- category,
- organization: this.props.organization,
- });
- }
- });
- };
- getCategoryLabel = (value: string) => {
- if (value === 'api') {
- return 'API';
- }
- return startCase(value);
- };
- // Rendering
- renderProvider = (provider: IntegrationProvider) => {
- const {organization} = this.props;
- // find the integration installations for that provider
- const integrations =
- this.state.integrations?.filter(i => i.provider.key === provider.key) ?? [];
- return (
- <IntegrationRow
- key={`row-${provider.key}`}
- data-test-id="integration-row"
- organization={organization}
- type="firstParty"
- slug={provider.slug}
- displayName={provider.name}
- status={this.getInstallStatuses(integrations)}
- publishStatus="published"
- configurations={integrations.length}
- categories={getCategoriesForIntegration(provider)}
- alertText={getAlertText(integrations)}
- resolveText={t('Update Now')}
- customAlert={
- <FirstPartyIntegrationAlert integrations={integrations} wrapWithContainer />
- }
- />
- );
- };
- renderPlugin = (plugin: PluginWithProjectList) => {
- const {organization} = this.props;
- const isLegacy = plugin.isHidden;
- const displayName = `${plugin.name} ${isLegacy ? '(Legacy)' : ''}`;
- // hide legacy integrations if we don't have any projects with them
- if (isLegacy && !plugin.projectList.length) {
- return null;
- }
- return (
- <IntegrationRow
- key={`row-plugin-${plugin.id}`}
- data-test-id="integration-row"
- organization={organization}
- type="plugin"
- slug={plugin.slug}
- displayName={displayName}
- status={plugin.projectList.length ? 'Installed' : 'Not Installed'}
- publishStatus="published"
- configurations={plugin.projectList.length}
- categories={getCategoriesForIntegration(plugin)}
- plugin={plugin}
- />
- );
- };
- // render either an internal or non-internal app
- renderSentryApp = (app: SentryApp) => {
- const {organization} = this.props;
- const status = getSentryAppInstallStatus(this.getAppInstall(app));
- const categories = getCategoriesForIntegration(app);
- return (
- <IntegrationRow
- key={`sentry-app-row-${app.slug}`}
- data-test-id="integration-row"
- organization={organization}
- type="sentryApp"
- slug={app.slug}
- displayName={app.name}
- status={status}
- publishStatus={app.status}
- configurations={0}
- categories={categories}
- customIcon={<SentryAppIcon sentryApp={app} size={36} />}
- />
- );
- };
- renderDocIntegration = (doc: DocIntegration) => {
- const {organization} = this.props;
- return (
- <IntegrationRow
- key={`doc-int-${doc.slug}`}
- data-test-id="integration-row"
- organization={organization}
- type="docIntegration"
- slug={doc.slug}
- displayName={doc.name}
- publishStatus="published"
- configurations={0}
- categories={getCategoriesForIntegration(doc)}
- customIcon={<DocIntegrationAvatar docIntegration={doc} size={36} />}
- />
- );
- };
- renderIntegration = (integration: AppOrProviderOrPlugin) => {
- if (isSentryApp(integration)) {
- return this.renderSentryApp(integration);
- }
- if (isPlugin(integration)) {
- return this.renderPlugin(integration);
- }
- if (isDocIntegration(integration)) {
- return this.renderDocIntegration(integration);
- }
- return this.renderProvider(integration);
- };
- renderBody() {
- const {organization} = this.props;
- const {displayedList, list, searchInput, selectedCategory, integrations} = this.state;
- const title = t('Integrations');
- const categoryList = uniq(list.flatMap(getCategoriesForIntegration)).sort();
- return (
- <Fragment>
- <SentryDocumentTitle title={title} orgSlug={organization.slug} />
- {!this.props.hideHeader && (
- <SettingsPageHeader
- title={title}
- body={
- <ActionContainer>
- <SelectControl
- name="select-categories"
- onChange={this.onCategorySelect}
- value={selectedCategory}
- options={[
- {value: '', label: t('All Categories')},
- ...categoryList.map(category => ({
- value: category,
- label: this.getCategoryLabel(category),
- })),
- ]}
- />
- <SearchBar
- query={searchInput || ''}
- onChange={this.handleSearchChange}
- placeholder={t('Filter Integrations...')}
- aria-label={t('Filter')}
- width="100%"
- data-test-id="search-bar"
- />
- </ActionContainer>
- }
- action={<CreateIntegrationButton analyticsView="integrations_directory" />}
- />
- )}
- <PermissionAlert access={['org:integrations']} />
- <ReinstallAlert integrations={integrations} />
- <Panel>
- <PanelBody data-test-id="integration-panel">
- {displayedList.length ? (
- displayedList.map(this.renderIntegration)
- ) : (
- <EmptyResultsContainer>
- <EmptyResultsBody>
- {tct('No Integrations found for "[searchTerm]".', {
- searchTerm: searchInput,
- })}
- </EmptyResultsBody>
- <EmptyResultsBodyBold>
- {t("Not seeing what you're looking for?")}
- </EmptyResultsBodyBold>
- <EmptyResultsBody>
- {tct('[link:Build it on the Sentry Integration Platform.]', {
- link: (
- <ExternalLink href="https://docs.sentry.io/product/integrations/integration-platform/" />
- ),
- })}
- </EmptyResultsBody>
- </EmptyResultsContainer>
- )}
- </PanelBody>
- </Panel>
- </Fragment>
- );
- }
- }
- const ActionContainer = styled('div')`
- display: grid;
- grid-template-columns: 240px auto;
- gap: ${space(2)};
- `;
- const EmptyResultsContainer = styled('div')`
- height: 200px;
- display: flex;
- flex-direction: column;
- align-items: center;
- justify-content: center;
- `;
- const EmptyResultsBody = styled('div')`
- font-size: 16px;
- line-height: 28px;
- color: ${p => p.theme.gray300};
- padding-bottom: ${space(2)};
- `;
- const EmptyResultsBodyBold = styled(EmptyResultsBody)`
- font-weight: bold;
- `;
- export default withOrganization(IntegrationListDirectory);
|