🪢 Open source agent evals & observability: Trace, evaluate, and improve LLM applications with one open platform.
TypeScript analyticsautogenevaluationlangchainlarge-language-modelsllama-indexllmllm-evaluationllm-observabilityllmopsmonitoringobservabilityopen-sourceopenaiplaygroundprompt-engineeringprompt-managementself-hostedycombinator
import { zodResolver } from "@hookform/resolvers/zod";
import {
validateExportSource,
type ExportSourceContext,
} from "@langfuse/shared";
import { ExternalLink } from "@langfuse/icons";
import { useMemo } from "react";
import { useWatch } from "react-hook-form";
import { type z } from "zod";
import { Alert } from "@/src/components/design-system/Alert/Alert";
import { ConfirmationDialogController } from "@/src/components/design-system/ConfirmationDialogController/ConfirmationDialogController";
import { CustomTooltip } from "@/src/components/design-system/CustomTooltip/CustomTooltip";
import { createForm } from "@/src/components/design-system/factories/createForm";
import { Input } from "@/src/components/design-system/Input/Input";
import { PasswordInput } from "@/src/components/design-system/PasswordInput/PasswordInput";
import { SelectInput } from "@/src/components/design-system/SelectInput/SelectInput";
import { SwitchInput } from "@/src/components/design-system/SwitchInput/SwitchInput";
import {
getExportSourceFieldState,
getExportSourceUnavailableMessage,
isExportSourceSelectable,
} from "@/src/features/analytics-integrations/exportSource";
import { posthogIntegrationFormSchema } from "@/src/features/posthog-integration/types";
import { areDestinationUrlsEquivalent } from "@/src/features/automations/destinationUrl";
type PostHogIntegrationFormInput = z.input<typeof posthogIntegrationFormSchema>;
export type PostHogIntegrationFormValues = z.output<
typeof posthogIntegrationFormSchema
>;
const PostHogForm = createForm<
PostHogIntegrationFormInput,
PostHogIntegrationFormValues
>();
const { useForm } = PostHogForm;
type PostHogIntegrationFormProps = {
actionState: "idle" | "saving" | "resetting";
configurationState: "new" | "configured";
defaultValues: Required<PostHogIntegrationFormValues>;
// Required to validate the selected export source against deployment policy.
exportSourceContext: ExportSourceContext;
onReset: () => void | Promise<void>;
onSubmit: (values: PostHogIntegrationFormValues) => void;
projectApiKeyDisplay?: string;
resetError?: string;
};
function getApiKeyDescription(
configurationState: PostHogIntegrationFormProps["configurationState"],
isHostnameChanged: boolean,
): string | undefined {
if (isHostnameChanged) {
return "Enter the API key again when changing the hostname.";
}
if (configurationState === "configured") {
return "Leave blank to keep the current API key.";
}
return undefined;
}
export function PostHogIntegrationForm({
actionState,
configurationState,
defaultValues,
exportSourceContext,
onReset,
onSubmit,
projectApiKeyDisplay,
resetError,
}: PostHogIntegrationFormProps) {
const { options: exportSourceOptions, showField: showExportSourceField } =
getExportSourceFieldState(defaultValues.exportSource, exportSourceContext);
const formSchema = useMemo(
() =>
posthogIntegrationFormSchema.superRefine((data, ctx) => {
if (configurationState === "new" && !data.posthogProjectApiKey) {
ctx.addIssue({
code: "custom",
path: ["posthogProjectApiKey"],
message: "PostHog Project API Key is required",
});
}
if (
configurationState === "configured" &&
!data.posthogProjectApiKey &&
!areDestinationUrlsEquivalent(
data.posthogHostname,
defaultValues.posthogHostname,
)
) {
ctx.addIssue({
code: "custom",
path: ["posthogProjectApiKey"],
message:
"PostHog Project API Key is required when changing the hostname",
});
}
if (!isExportSourceSelectable(data.exportSource, exportSourceContext)) {
ctx.addIssue({
code: "custom",
path: ["exportSource"],
message:
"This export source is not available on this deployment. Select an available export source to save.",
});
}
}),
[configurationState, defaultValues.posthogHostname, exportSourceContext],
);
const form = useForm({
resolver: zodResolver(formSchema),
defaultValues,
});
const exportSource = useWatch({
control: form.control,
name: "exportSource",
});
const posthogHostname = useWatch({
control: form.control,
name: "posthogHostname",
});
const isHostnameChanged =
configurationState === "configured" &&
!areDestinationUrlsEquivalent(
posthogHostname,
defaultValues.posthogHostname,
);
const apiKeyDescription = getApiKeyDescription(
configurationState,
isHostnameChanged,
);
const exportSourceValidation = exportSource
? validateExportSource(exportSource, exportSourceContext)
: ({ ok: true } as const);
return (
<ConfirmationDialogController
title="Reset PostHog integration?"
text="This resets the PostHog integration for this project."
confirmLabel="Reset integration"
variant="destructive"
disabled={configurationState === "new"}
loading={actionState === "resetting"}
error={resetError}
onConfirm={onReset}
>
{({ openDialog }) => (
<PostHogForm
form={form}
onSubmit={onSubmit}
actions={[
{
id: "save",
type: "submit",
text: "Save",
loading: actionState === "saving",
},
{
id: "reset",
type: "button",
text: "Reset",
variant: "ghost",
disabled: configurationState === "new",
onClick: openDialog,
},
]}
>
<PostHogForm.Field
name="posthogHostname"
label="Posthog Hostname"
description="US region: https://us.posthog.com; EU region: https://eu.posthog.com"
>
{(field) => (
<Input
id={field.id}
name={field.name}
value={field.value}
onBlur={field.onBlur}
onChange={field.onChange}
ref={field.ref}
aria-describedby={field.inputDescribedById}
aria-invalid={Boolean(field.error)}
error={Boolean(field.error)}
/>
)}
</PostHogForm.Field>
<PostHogForm.Field
name="posthogProjectApiKey"
label="Posthog Project API Key"
description={apiKeyDescription}
>
{(field) => (
<PasswordInput
id={field.id}
name={field.name}
value={field.value}
onBlur={field.onBlur}
onChange={field.onChange}
ref={field.ref}
aria-describedby={field.inputDescribedById}
aria-invalid={Boolean(field.error)}
error={Boolean(field.error)}
placeholder={
configurationState === "configured"
? projectApiKeyDisplay
: undefined
}
/>
)}
</PostHogForm.Field>
{showExportSourceField ? (
<CustomTooltip
placement="bottom"
content={
<div className="space-y-2 py-1.5">
{exportSourceOptions.map((option) => (
<div key={option.value} className="space-y-0.5">
<div className="font-bold">{option.label}</div>
<div className="text-muted-foreground text-xs">
{option.description}
</div>
</div>
))}
<div className="border-t pt-2">
<a
href="https://langfuse.com/integrations/analytics/posthog#migrate-export-source"
target="_blank"
rel="noopener noreferrer"
className="text-muted-foreground hover:text-primary inline-flex items-center gap-1 text-xs hover:underline"
>
For further information see
<ExternalLink size="sm" />
</a>
</div>
</div>
}
>
{({ getTriggerProps }) => (
<PostHogForm.Field
name="exportSource"
label="Export Source"
description="Choose which data sources to export to PostHog. Scores are always included."
registerLabelTooltip={getTriggerProps}
>
{(field) => (
<SelectInput
id={field.id}
value={field.value}
onValueChange={field.onChange}
aria-describedby={field.inputDescribedById}
aria-invalid={Boolean(field.error)}
error={Boolean(field.error)}
placeholder="Select data to export"
options={exportSourceOptions.map((option) => {
if (option.unavailable) {
return {
value: option.value,
label: `${option.label} (not available on this deployment)`,
disabled: true as const,
disabledReason: "Not available on this deployment.",
};
}
return { value: option.value, label: option.label };
})}
/>
)}
</PostHogForm.Field>
)}
</CustomTooltip>
) : null}
{!exportSourceValidation.ok ? (
<Alert variant="destructive">
<Alert.Title>
Saved export source is no longer available
</Alert.Title>
<Alert.Description>
{getExportSourceUnavailableMessage(
exportSourceValidation.reason,
)}
</Alert.Description>
</Alert>
) : null}
<PostHogForm.Field name="enabled" label="Enabled">
{(field) => (
<SwitchInput
id={field.id}
description="Send data to PostHog while this integration is active."
name={field.name}
checked={field.value}
onBlur={field.onBlur}
onCheckedChange={field.onChange}
ref={field.ref}
aria-describedby={field.inputDescribedById}
aria-invalid={Boolean(field.error)}
/>
)}
</PostHogForm.Field>
</PostHogForm>
)}
</ConfirmationDialogController>
);
}