Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

7.6 KB
Raw Blame
import { capitalizeFirstLetter } from 'lib/utils/strings'

import { IntegrationKind } from '~/types'

import IconApple from 'public/services/apple_search_ads.png'
import IconAwsS3 from 'public/services/aws-s3.png'
import IconAzureBlob from 'public/services/azure-blob-storage.png'
import IconBingAds from 'public/services/bing-ads.svg'
import IconClickUp from 'public/services/clickup.svg'
import IconCustomerIO from 'public/services/customer-io.png'
import IconDatabricks from 'public/services/databricks.png'
import IconFirebase from 'public/services/firebase.png'
import IconGitHub from 'public/services/github.png'
import IconGitLab from 'public/services/gitlab.png'
import IconGoogleAds from 'public/services/google-ads.png'
import IconGoogleCloudStorage from 'public/services/google-cloud-storage.png'
import IconGoogleCloud from 'public/services/google-cloud.png'
import IconGoogleSearchConsole from 'public/services/google-search-console.svg'
import IconGoogleSheets from 'public/services/google-sheets.svg'
import IconGoogleAnalytics from 'public/services/google_analytics.png'
import IconGoogleCalendar from 'public/services/google_calendar.png'
import IconHelpScout from 'public/services/helpscout.png'
import IconHubspot from 'public/services/hubspot.png'
import IconInstagram from 'public/services/instagram.png'
import IconIntercom from 'public/services/intercom.png'
import IconJira from 'public/services/jira.svg'
import IconLinear from 'public/services/linear.png'
import IconLinkedIn from 'public/services/linkedin.png'
import IconMailjet from 'public/services/mailjet.png'
import IconMetaAds from 'public/services/meta-ads.png'
import IconPardot from 'public/services/pardot.png'
import IconPinterest from 'public/services/pinterest_ads.png'
import IconPostgres from 'public/services/postgres.png'
import IconReddit from 'public/services/reddit.png'
import IconRedshift from 'public/services/redshift.png'
import IconS3Compatible from 'public/services/s3-compatible.png'
import IconSalesforce from 'public/services/salesforce.png'
import IconSlack from 'public/services/slack.png'
import IconSnapchat from 'public/services/snapchat.png'
import IconSnowflake from 'public/services/snowflake.png'
import IconStripe from 'public/services/stripe.png'
import IconTikTok from 'public/services/tiktok.png'
import IconTwilio from 'public/services/twilio.png'
import IconTwitterAds from 'public/services/twitter_ads.png'
import IconVercel from 'public/services/vercel.png'
import IconYouTubeAnalytics from 'public/services/youtube_analytics.png'

/**
 * What a "link an existing installation" banner offered, reported as counts on
 * `integration_link_existing_offered`. `unnamed` counts entries shown by installation id because
 * their account name is missing, which is the case a reader cannot recognize.
 */
export interface IntegrationLinkExistingCounts {
    discoveryId?: string
    installationIds?: string[]
    responseAgeMs?: number
    total: number
    sibling: number
    orphan: number
    unnamed: number
}

/**
 * Where a user started an integration connect flow. Reported as the `surface` property on
 * `integration_connect_clicked`, so these strings are frozen — renaming one silently splits a
 * funnel that already counts the old value.
 *
 * A connect can start from many places, and only some of them are a first connection: the
 * `*_reconnect` and `settings_manage` values cover flows that begin with an integration already
 * in place, which a conversion metric wants to exclude.
 */
export type IntegrationConnectSurface =
    | 'settings'
    | 'settings_manage'
    | 'settings_link_existing'
    | 'integration_landing_page'
    | 'pipeline_config'
    | 'error_banner_reconnect'
    | 'missing_scopes_reconnect'
    | 'warehouse_source_reconnect'
    | 'onboarding_wizard'
    | 'inbox_welcome'
    | 'inbox_report'
    | 'inbox_triage'
    | 'signals_agent_setup'
    | 'task_composer'
    | 'visual_review_settings'
    | 'install_approved_banner'
    | 'unavailable_banner_reconnect'
    | 'webhook_banner_reconnect'

export const ICONS: Record<IntegrationKind, any> = {
    slack: IconSlack,
    salesforce: IconSalesforce,
    hubspot: IconHubspot,
    'google-pubsub': IconGoogleCloud,
    'google-cloud-storage': IconGoogleCloudStorage,
    'google-cloud-service-account': IconGoogleCloud,
    'google-ads': IconGoogleAds,
    'google-analytics': IconGoogleAnalytics,
    'google-calendar': IconGoogleCalendar,
    'google-search-console': IconGoogleSearchConsole,
    'google-sheets': IconGoogleSheets,
    snapchat: IconSnapchat,
    stripe: IconStripe,
    intercom: IconIntercom,
    helpscout: IconHelpScout,
    'linkedin-ads': IconLinkedIn,
    email: IconMailjet,
    linear: IconLinear,
    github: IconGitHub,
    gitlab: IconGitLab,
    'meta-ads': IconMetaAds,
    instagram: IconInstagram,
    twilio: IconTwilio,
    clickup: IconClickUp,
    'reddit-ads': IconReddit,
    'twitter-ads': IconTwitterAds,
    databricks: IconDatabricks,
    'tiktok-ads': IconTikTok,
    'bing-ads': IconBingAds,
    vercel: IconVercel,
    'azure-blob': IconAzureBlob,
    firebase: IconFirebase,
    jira: IconJira,
    'pinterest-ads': IconPinterest,
    pardot: IconPardot,
    'customerio-app': IconCustomerIO,
    'customerio-webhook': IconCustomerIO,
    'customerio-track': IconCustomerIO,
    apns: IconApple,
    'apple-ads': IconApple,
    postgresql: IconPostgres,
    'aws-s3': IconAwsS3,
    'aws-redshift': IconRedshift,
    's3-compatible': IconS3Compatible,
    snowflake: IconSnowflake,
    'youtube-analytics': IconYouTubeAnalytics,
}

// Brand marks that are solid black/monochrome on a transparent background — they vanish against a dark
// surface, so invert them in dark mode (`dark:invert`) wherever the integration icon is rendered.
export const DARK_MODE_INVERT_ICON_KINDS = new Set<IntegrationKind>(['apns', 'apple-ads', 'github'])

export const getIntegrationNameFromKind = (kind: string): string => {
    switch (kind) {
        case 'google-pubsub':
            return 'Google Cloud Pub/Sub'
        case 'google-cloud-storage':
            return 'Google Cloud Storage'
        case 'google-ads':
            return 'Google Ads'
        case 'google-analytics':
            return 'Google Analytics'
        case 'google-calendar':
            return 'Google Calendar'
        case 'google-search-console':
            return 'Google Search Console'
        case 'google-cloud-service-account':
            return 'Google Cloud service account'
        case 'apple-ads':
            return 'Apple Ads'
        case 'linkedin-ads':
            return 'LinkedIn Ads'
        case 'meta-ads':
            return 'Meta Ads'
        case 'reddit-ads':
            return 'Reddit Ads'
        case 'twitter-ads':
            return 'X Ads'
        case 'tiktok-ads':
            return 'TikTok Ads'
        case 'bing-ads':
            return 'Bing Ads'
        case 'azure-blob':
            return 'Azure Blob Storage'
        case 'pinterest-ads':
            return 'Pinterest Ads'
        case 'email':
            return 'email'
        case 'github':
            return 'GitHub'
        case 'helpscout':
            return 'Help Scout'
        case 'firebase':
            return 'Firebase'
        case 'apns':
            return 'Apple Push Notification Service'
        case 'postgresql':
            return 'PostgreSQL'
        case 'aws-s3':
            return 'AWS S3'
        // Named after the batch export destination users already see, not the `aws-` kind prefix.
        case 'aws-redshift':
            return 'Redshift'
        case 's3-compatible':
            return 'S3-compatible storage'
        case 'youtube-analytics':
            return 'YouTube Analytics'
        default:
            return capitalizeFirstLetter(kind)
    }
}