: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.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
// Side-effect import: register all integration setups
import './integrationSetups'
import { useActions, useValues } from 'kea'
import { useEffect, useId, useRef } from 'react'
import { IconExternal, IconTrash, IconX } from '@posthog/icons'
import { LemonBanner, LemonButton, LemonMenu, LemonSkeleton } from '@posthog/lemon-ui'
import api from 'lib/api'
import { useIntegrationManagementRestriction } from 'lib/integrations/integrationPermissions'
import { integrationsLogic } from 'lib/integrations/integrationsLogic'
import { IntegrationView } from 'lib/integrations/IntegrationView'
import { getIntegrationNameFromKind } from 'lib/integrations/utils'
import { eventUsageLogic } from 'lib/utils/eventUsageLogic'
import { urls } from 'scenes/urls'
import { findIntegrationByFormValue, matchesIntegrationIdValue } from './integrationLookup'
import { getIntegrationSetup } from './integrationSetupRegistry'
export type IntegrationConfigureProps = {
value?: number
onChange?: (value: number | null) => void
redirectUrl?: string
schema?: { requiredScopes?: string }
integration?: string
beforeRedirect?: () => void
allowClear?: boolean
}
export function IntegrationChoice({
onChange,
value,
schema,
integration,
redirectUrl,
beforeRedirect,
allowClear = true,
}: IntegrationConfigureProps): JSX.Element | null {
const { integrationsLoading, integrations, newIntegrationModalKind, newIntegrationModalId, slackAvailable } =
useValues(integrationsLogic)
const { newGoogleCloudKey, openNewIntegrationModal, closeNewIntegrationModal, deleteIntegration } =
useActions(integrationsLogic)
const { reportIntegrationConnectClicked } = useActions(eventUsageLogic)
// A project member can create an integration, but only a project admin can overwrite one. An
// OAuth connect upserts on the provider account id, so a member who picks an account that is
// already connected goes through the provider's whole flow and then gets a 403 at the callback.
// Setup-modal kinds report the same error inside the modal, so they stay open to members.
const integrationManagementRestriction = useIntegrationManagementRestriction()
const kind = integration
// Identifies this specific picker. Several IntegrationChoice pickers can share a kind (a
// Redshift export has separate aws-s3 fields for the bucket and the authorization), so the
// shared modal open-state is matched on this id to route completion back to the right picker.
const modalId = useId()
const integrationsOfKind = integrations?.filter((x) => x.kind === kind)
const integrationKind = findIntegrationByFormValue(integrationsOfKind, value)
// The stored value points to an integration that's no longer available (deleted, or
// re-installed under a new ID). We deliberately do NOT auto-substitute here — that
// would silently mask the missing reference and let stale config keep flowing through
// saves. The UI surfaces a warning below instead so the user picks explicitly.
const valueIsMissing = !integrationsLoading && !!value && !!integrations && !integrationKind
// Fire at most once: the consumer's write may take a full state round-trip before it flows
// back into `value`, and re-dispatching on every render in that window can amplify into an
// infinite update loop (React #185).
const autoSelected = useRef(false)
useEffect(() => {
if (!integrationsLoading && !value && integrationsOfKind?.length && !autoSelected.current) {
autoSelected.current = true
onChange?.(integrationsOfKind[0].id)
}
}, [integrationsLoading, onChange, integrationsOfKind?.length, value, integrationsOfKind])
if (!kind) {
return null
}
if (integrationsLoading) {
return <LemonSkeleton className="h-10" />
}
const kindName = getIntegrationNameFromKind(kind)
function uploadKey(kindForUpload: string): void {
const input = document.createElement('input')
input.type = 'file'
input.accept = '.json'
input.onchange = async (e) => {
const file = (e.target as HTMLInputElement).files?.[0]
if (!file) {
return
}
newGoogleCloudKey(kindForUpload, file, (integ) => onChange?.(integ.id))
}
input.click()
}
const handleModalComplete = (integrationId?: number): void => {
if (typeof integrationId === 'number') {
onChange?.(integrationId)
}
closeNewIntegrationModal()
}
const setupDef = getIntegrationSetup(kind)
const SetupModalComponent = setupDef?.SetupModal
// When the instance doesn't have OAuth credentials for this kind, /integrations/authorize
// 400s with "Kind not configured". Send users to the settings page instead.
const oauthUnavailable = kind === 'slack' && !slackAvailable
const setupMenuItem = setupDef
? setupDef.menuItem({ kind, openModal: (modalKind) => openNewIntegrationModal(modalKind, modalId), uploadKey })
: oauthUnavailable
? {
to: urls.settings('project-integrations'),
targetBlank: true,
sideIcon: <IconExternal />,
label: `${kindName} is not configured on this instance`,
}
: {
to: api.integrations.authorizeUrl({ kind, next: redirectUrl }),
disableClientSideRouting: true,
onClick: () => {
reportIntegrationConnectClicked(kind, kind, 'pipeline_config')
beforeRedirect?.()
},
label: integrationsOfKind?.length
? `Connect to a different integration for ${kindName}`
: `Connect to ${kindName}`,
disabledReason: integrationManagementRestriction ?? undefined,
}
const button = (
<LemonMenu
items={[
integrationsOfKind?.length
? {
items: [
...(integrationsOfKind?.map((integ) => ({
icon: (
<img
src={integ.icon_url}
alt={`${integ.display_name} icon`}
className="w-6 h-6 rounded"
/>
),
onClick: () => onChange?.(integ.id),
active: matchesIntegrationIdValue(integ.id, value),
label: integ.display_name,
})) || []),
],
}
: null,
{ items: [setupMenuItem] },
{
items: [
{
to: urls.settings('project-integrations'),
targetBlank: true,
label: 'Manage integrations',
sideIcon: <IconExternal />,
},
value && allowClear
? {
onClick: () => onChange?.(null),
label: 'Clear selection',
sideIcon: <IconX />,
}
: null,
integrationKind
? {
onClick: () => {
deleteIntegration(integrationKind.id)
},
label: 'Disconnect integration',
status: 'danger' as const,
sideIcon: <IconTrash />,
}
: null,
],
},
]}
>
{integrationKind ? (
<LemonButton type="secondary">Change</LemonButton>
) : (
<LemonButton type="secondary">Choose {kindName} connection</LemonButton>
)}
</LemonMenu>
)
return (
<>
{integrationKind ? (
<IntegrationView schema={schema} integration={integrationKind} suffix={button} hideWebhookReconnect />
) : valueIsMissing ? (
<div className="flex flex-col gap-2">
<LemonBanner type="warning">
The previously selected {kindName} connection (ID: {value}) is no longer available, so this will
fail when it runs. Pick a different connection or clear the selection.
</LemonBanner>
{button}
</div>
) : (
button
)}
{/* Render only this picker's own-kind modal, and only while this picker is the opener.
Sibling pickers can share a kind, and the setup-modal logics are singletons —
mounting more than one lets a submit's onComplete resolve to the last-rendered
picker and write the new id into the wrong field. */}
{SetupModalComponent && newIntegrationModalKind === kind && newIntegrationModalId === modalId ? (
<SetupModalComponent
isOpen
kind={kind}
integration={integrationKind || undefined}
onComplete={handleModalComplete}
onClose={closeNewIntegrationModal}
/>
) : null}
</>
)
}