: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
import { BuiltLogic } from 'kea'
import { languages } from 'monaco-editor'
import type { codeEditorLogicType } from 'lib/monaco/codeEditorLogic'
import { performQuery } from '~/queries/query'
import { setLatestVersionsOnQuery } from '~/queries/schema/query-versions'
import {
AutocompleteCompletionItemKind,
HogLanguage,
HogQLAutocomplete,
NodeKind,
} from '~/queries/schema/schema-general'
import { findStatementAtOffset, splitQueries } from './multiQueryUtils'
import { getContextSourceQuery } from './sourceQueryUtils'
const convertCompletionItemKind = (kind: AutocompleteCompletionItemKind): languages.CompletionItemKind => {
switch (kind) {
case 'Method':
return languages.CompletionItemKind.Method
case 'Function':
return languages.CompletionItemKind.Function
case 'Constructor':
return languages.CompletionItemKind.Constructor
case 'Field':
return languages.CompletionItemKind.Field
case 'Variable':
return languages.CompletionItemKind.Variable
case 'Class':
return languages.CompletionItemKind.Class
case 'Struct':
return languages.CompletionItemKind.Struct
case 'Interface':
return languages.CompletionItemKind.Interface
case 'Module':
return languages.CompletionItemKind.Module
case 'Property':
return languages.CompletionItemKind.Property
case 'Event':
return languages.CompletionItemKind.Event
case 'Operator':
return languages.CompletionItemKind.Operator
case 'Unit':
return languages.CompletionItemKind.Unit
case 'Value':
return languages.CompletionItemKind.Value
case 'Constant':
return languages.CompletionItemKind.Constant
case 'Enum':
return languages.CompletionItemKind.Enum
case 'EnumMember':
return languages.CompletionItemKind.EnumMember
case 'Keyword':
return languages.CompletionItemKind.Keyword
case 'Text':
return languages.CompletionItemKind.Text
case 'Color':
return languages.CompletionItemKind.Color
case 'File':
return languages.CompletionItemKind.File
case 'Reference':
return languages.CompletionItemKind.Reference
case 'Customcolor':
return languages.CompletionItemKind.Customcolor
case 'Folder':
return languages.CompletionItemKind.Folder
case 'TypeParameter':
return languages.CompletionItemKind.TypeParameter
case 'User':
return languages.CompletionItemKind.User
case 'Issue':
return languages.CompletionItemKind.Issue
case 'Snippet':
return languages.CompletionItemKind.Snippet
default:
throw new Error(`Unknown CompletionItemKind: ${kind}`)
}
}
const kindToSortText = (kind: AutocompleteCompletionItemKind, label: string): string => {
if (kind === 'Variable') {
return `1-${label}`
}
if (kind === 'Method' || kind === 'Function') {
return `2-${label}`
}
return `3-${label}`
}
const emptyCompletionList = (): languages.CompletionList => ({
suggestions: [],
incomplete: false,
})
export const hogQLAutocompleteProvider = (type: HogLanguage): languages.CompletionItemProvider => ({
triggerCharacters: [' ', ',', '.', '{'],
provideCompletionItems: async (model, position) => {
const logic: BuiltLogic<codeEditorLogicType> | undefined = (model as any).codeEditorLogic
if (!logic || !logic.isMounted()) {
return emptyCompletionList()
}
const word = model.getWordUntilPosition(position)
const startOffset = model.getOffsetAt({
lineNumber: position.lineNumber,
column: word.startColumn,
})
const endOffset = model.getOffsetAt({
lineNumber: position.lineNumber,
column: word.endColumn,
})
const connectionId =
logic.isMounted() && logic.props.sourceQuery?.kind === NodeKind.HogQLQuery
? (logic.props.sourceQuery.connectionId ?? undefined)
: undefined
const queryText = model.getValue()
const sourceQuery = logic.isMounted() ? getContextSourceQuery(logic.props.sourceQuery, queryText) : undefined
// The server parses the payload as one statement, so a document holding several
// `;`-separated queries fails to parse and comes back with no suggestions at all.
// Send just the statement under the cursor, with the offsets rebased onto it.
// Single-statement documents are still sent whole so a trailing `;` behaves as before.
const statements = type === HogLanguage.hogQL ? splitQueries(queryText, { hogql: true }) : []
const statement =
statements.length > 1
? findStatementAtOffset(queryText, model.getOffsetAt(position), { hogql: true })
: null
const statementOffset = statement?.start ?? 0
const query: HogQLAutocomplete = setLatestVersionsOnQuery(
{
kind: NodeKind.HogQLAutocomplete,
language: type,
// Use the text from the model instead of logic due to a race condition on the logic values updating quick enough
query: statement?.query ?? queryText,
filters: logic.isMounted() ? logic.props.metadataFilters : undefined,
globals: logic.isMounted() ? logic.props.globals : undefined,
sourceQuery,
connectionId,
startPosition: startOffset - statementOffset,
endPosition: endOffset - statementOffset,
},
{ recursion: false }
)
let response: NonNullable<HogQLAutocomplete['response']>
try {
response = await performQuery<HogQLAutocomplete>(query)
} catch {
return emptyCompletionList()
}
const completionItems = response.suggestions
const suggestions = completionItems.map<languages.CompletionItem>((item) => {
const kind = convertCompletionItemKind(item.kind)
// The backend sets sortText when it can rank a suggestion, for example a function
// whose return type fits the comparison being written. Otherwise fall back to kind order.
const sortText = item.sortText ?? kindToSortText(item.kind, item.label)
return {
label: {
label: item.label,
detail: item.detail,
},
documentation: item.documentation,
insertText: item.insertText,
range: {
startLineNumber: position.lineNumber,
endLineNumber: position.lineNumber,
startColumn: word.startColumn,
endColumn: word.endColumn,
},
kind,
sortText,
command:
kind === languages.CompletionItemKind.Function
? {
id: 'cursorLeft',
title: 'Move cursor left',
}
: undefined,
}
})
return {
suggestions,
incomplete: response.incomplete_list,
}
},
})