@@ -2,36 +2,86 @@ import Foundation
22import SwiftUI
33
44@Observable
5+@MainActor
56final class QueryViewModel {
6− var sqlQuery = ""
7+ var sqlQuery = "" {
8+ didSet {
9+ // Editing the query invalidates any error underline, whose offsets
10+ // were computed against the previous text. Clearing here keeps a
11+ // late-arriving highlight from landing on the wrong position.
12+ if sqlQuery != oldValue { errorRange = nil }
13+ }
14+ }
715 var results: [LogRecord] = [] {
816 didSet {
9− // Show all results immediately
10− filteredResults = results
1117 // Build search texts asynchronously
1218 searchTextTask?.cancel()
1319 cachedSearchTexts = []
20+ searchTextGeneration &+= 1
21+ let generation = searchTextGeneration
22+ // Apply the current filter immediately using the inline fallback path
23+ // (the cache was just invalidated). Calling updateFilteredResults()
24+ // rather than `filteredResults = results` avoids briefly showing
25+ // unfiltered rows while a filter is active, and avoids leaving a stale
26+ // unfiltered set if the async rebuild below is cancelled before it
27+ // re-applies the filter.
28+ updateFilteredResults()
1429 let snapshot = results
15− searchTextTask = Task {
16− let texts = snapshot.map { record in
17− record.values.map { $0.displayString }.joined(separator: " ")
18− }
19− guard !Task.isCancelled else { return }
20− cachedSearchTexts = texts
21− if !filterText.isEmpty {
22− updateFilteredResults()
30+ // The class is @MainActor, so this Task inherits main-actor isolation —
31+ // its mutations of cachedSearchTexts/filteredResults are safely serialized
32+ // with SwiftUI reads. Only the pure (and potentially large) displayString
33+ // mapping is pushed off-main via Task.detached so it doesn't block the UI.
34+ searchTextTask = Task { [weak self] in
35+ let texts = await Task.detached(priority: .userInitiated) {
36+ snapshot.map { record in
37+ record.values.map { $0.displayString }.joined(separator: " ")
38+ }
39+ }.value
40+ guard let self, !Task.isCancelled else { return }
41+ // Reject a stale write: if `results` was reassigned while this task
42+ // was awaiting, a newer didSet bumped the generation. Task.isCancelled
43+ // alone isn't sufficient because two re-queries producing result sets
44+ // of identical count would otherwise let this stale, same-length
45+ // cachedSearchTexts slip past updateFilteredResults's count guard.
46+ guard generation == self.searchTextGeneration else { return }
47+ self.cachedSearchTexts = texts
48+ if !self.filterText.isEmpty {
49+ self.updateFilteredResults()
2350 }
2451 }
2552 }
2653 }
2754 private var cachedSearchTexts: [String] = []
2855 private var searchTextTask: Task<Void, Never>?
56+ /// Bumped on every `results` reassignment so the async search-text builder can
57+ /// detect it was superseded and drop a stale write (see results.didSet).
58+ private var searchTextGeneration = 0
2959 var columns: [String] = []
3060 var columnOrder: [String] = []
3161 var hiddenColumns: Set<String> = []
62+ /// The full persisted set of hidden columns for the current stream, including
63+ /// ones absent from the current result. Hiding a column drops it from the
64+ /// SELECT list, so it's missing from the very next result and `hiddenColumns`
65+ /// (only the columns present) forgets it — the next save would then erase the
66+ /// preference. This keeps the intent, mirroring LiveTailViewModel.
67+ private(set) var savedHiddenColumns: Set<String> = []
68+ /// The persisted column order including columns absent from the current
69+ /// result (the order counterpart of `savedHiddenColumns`), so saving doesn't
70+ /// drop a hidden column's position and it returns to its place when shown.
71+ private var savedColumnOrder: [String] = []
3272 var autoHiddenColumns: Set<String> = []
3373 /// Column config from a saved query, applied on next query execution.
3474 var pendingColumnConfig: ColumnConfiguration?
75+
76+ /// The connection and stream the editor text and results belong to. The view
77+ /// model outlives QueryView (switching tabs keeps the query), so the view
78+ /// compares this on appear to catch a stream/server change made while another
79+ /// tab was showing.
80+ struct BoundContext: Equatable {
81+ let connectionID: UUID?
82+ let stream: String
83+ }
84+ var boundContext: BoundContext?
3585 private var currentStream: String?
3686 var isLoading = false
3787 var errorMessage: String?
@@ -47,9 +97,25 @@ final class QueryViewModel {
4797
4898 // Schema fields for autocomplete
4999 var schemaFields: [SchemaField] = []
100+ /// The stream of the most recent `loadSchema` call, used to drop a stale
101+ /// in-flight response when the user rapidly switches streams.
102+ private(set) var latestSchemaStream: String?
103+ /// The stream of the most recent `executeQuery` call. Defense-in-depth
104+ /// alongside `queryGeneration`/task cancellation: drops a stale in-flight
105+ /// query response if a newer query for a different stream supersedes it
106+ /// without going through the normal cancel path.
107+ private var latestQueryStream: String?
50108
51109 // Query task for cancellation
52110 private var queryTask: Task<Void, Never>?
111+ /// Bumped at the start of every `executeQuery`. The task captures this value
112+ /// and only clears `isLoading` on exit if it's still the active query — so a
113+ /// superseded query's late cleanup doesn't drop the loading indicator that
114+ /// the newer query set. Without this, `isLoading = false` had to live in
115+ /// every caller of `cancel()` (cancelQuery, clearResults, superseding
116+ /// executeQuery) and a future cancel path that forgot to set it would wedge
117+ /// the spinner indefinitely.
118+ private var queryGeneration = 0
53119
54120 // Time range
55121 var timeRangeOption: TimeRangeOption = .last1Hour
@@ -58,7 +124,10 @@ final class QueryViewModel {
58124
59125 // Query history
60126 var queryHistory: [QueryHistoryEntry] = []
61− var historyIsFull = false
127+ // Derived from the (always-trimmed) history so it stays correct after a
128+ // restored full history is loaded at launch, not just after an in-session
129+ // overflow. `addToHistory` trims to `maxHistory`, so count never exceeds it.
130+ var historyIsFull: Bool { queryHistory.count >= Self.maxHistory }
62131 private static let maxHistory = 50
63132
64133 struct QueryHistoryEntry: Identifiable, Codable, Sendable {
@@ -143,9 +212,16 @@ final class QueryViewModel {
143212 return columnOrder.filter { !allHidden.contains($0) }
144213 }
145214
215+ /// Whether any column is hidden — including saved-hidden columns that aren't
216+ /// in the current result, which "Show All" can bring back.
217+ var hasHiddenColumns: Bool {
218+ !hiddenColumns.isEmpty || !autoHiddenColumns.isEmpty || !savedHiddenColumns.isEmpty
219+ }
220+
146221 func toggleColumnVisibility(_ column: String) {
147222 if hiddenColumns.contains(column) {
148223 hiddenColumns.remove(column)
224+ savedHiddenColumns.remove(column)
149225 } else if autoHiddenColumns.contains(column) {
150226 autoHiddenColumns.remove(column)
151227 } else {
@@ -154,6 +230,7 @@ final class QueryViewModel {
154230 let visibleCount = columnOrder.count - allHidden.count
155231 if visibleCount > 1 {
156232 hiddenColumns.insert(column)
233+ savedHiddenColumns.insert(column)
157234 }
158235 }
159236 saveColumnConfig()
@@ -162,6 +239,7 @@ final class QueryViewModel {
162239
163240 func showAllColumns() {
164241 hiddenColumns.removeAll()
242+ savedHiddenColumns.removeAll()
165243 autoHiddenColumns.removeAll()
166244 saveColumnConfig()
167245 updateSQLColumns()
@@ -178,36 +256,129 @@ final class QueryViewModel {
178256 let toIndex = columnOrder.firstIndex(of: targetColumn),
179257 fromIndex != toIndex else { return }
180258 let item = columnOrder.remove(at: fromIndex)
181− columnOrder.insert(item, at: toIndex)
259+ // Match the drop-indicator semantics: a rightward move (fromIndex < toIndex)
260+ // lands the column *after* the target, a leftward move lands it *before*.
261+ // After removing an earlier element the target shifts down by one, so
262+ // inserting at `toIndex` lands after the target for rightward moves; for
263+ // leftward moves the target is unshifted and `toIndex` lands before it.
264+ let adjusted = toIndex
265+ columnOrder.insert(item, at: adjusted)
182266 saveColumnConfig()
183267 updateSQLColumns()
184268 }
185269
186270 func resetColumnConfig() {
187271 columnOrder = columns
272+ savedColumnOrder = []
188273 hiddenColumns.removeAll()
274+ savedHiddenColumns.removeAll()
189275 autoHiddenColumns.removeAll()
190276 saveColumnConfig()
191277 updateSQLColumns()
192278 }
193279
194− /// Rewrites the SELECT clause of `sqlQuery` to reflect the current `visibleColumns`.
280+ /// Rewrites the SELECT clause of `sqlQuery` to reflect the user's column
281+ /// choices (order and hidden columns; auto-hidden columns stay display-only).
195282 func updateSQLColumns() {
196− guard let range = SQLTokenizer.selectColumnListRange(in: sqlQuery) else { return }
197−
198− let visible = visibleColumns
283+ guard let range = SQLTokenizer.selectColumnListRange(in: sqlQuery),
284+ let currentList = Self.parseColumnList(sqlQuery[range]) else { return }
285+
286+ // Project the user's choices only. `autoHiddenColumns` is a display
287+ // heuristic for the current rows (the field is empty in all of them);
288+ // baking it into the SQL would stop the field from ever being fetched
289+ // again, even for a time range where it has values.
290+ let visible = columnOrder.filter { !hiddenColumns.contains($0) }
199291 guard !visible.isEmpty else { return }
200292
293+ // Columns an explicit list names that aren't in the results: Parseable
294+ // omits all-null fields from query JSON, so a sparse listed field can be
295+ // missing from `columns`. Keep it (unless the user hid it) rather than
296+ // silently dropping it from the SELECT on the next rewrite.
297+ var listedButAbsent: [String] = []
298+ var excludesHiddenColumn = false
299+ if case .identifiers(let names) = currentList {
300+ let present = Set(columns)
301+ listedButAbsent = names.filter { !present.contains($0) && !savedHiddenColumns.contains($0) }
302+ // A column the user hid is absent from these results precisely
303+ // because this list was narrowed to exclude it.
304+ excludesHiddenColumn = !savedHiddenColumns.isSubset(of: present)
305+ }
306+
201307 let newColumnList: String
202− if visible == columns {
308+ // Use `*` whenever every column is visible, regardless of display order —
309+ // reordering columns (a set-preserving permutation) must not pin the query
310+ // to an explicit snapshot that hides newly-appearing fields on re-query —
311+ // unless the list is explicit because it leaves out a hidden column, which
312+ // `*` would fetch again.
313+ if !excludesHiddenColumn && visible.count == columns.count && Set(visible) == Set(columns) {
203314 newColumnList = "*"
204315 } else {
205− newColumnList = visible.map { Self.escapeSQLIdentifier($0) }.joined(separator: ", ")
316+ newColumnList = (visible + listedButAbsent).map { Self.escapeSQLIdentifier($0) }.joined(separator: ", ")
206317 }
207318
208319 sqlQuery.replaceSubrange(range, with: newColumnList)
209320 }
210321
322+ enum ColumnListShape: Equatable {
323+ case star
324+ /// Plain column references, as the column names they resolve to.
325+ case identifiers([String])
326+ }
327+
328+ /// Parses a SELECT list the column manager can regenerate without changing
329+ /// what the query computes: `*`, or a comma-separated list of plain column
330+ /// references. Anything else — aggregates, expressions, aliases
331+ /// (`count(*) AS n`), qualified names — returns nil: rewriting it with `*` or
332+ /// bare result keys would break the query, so the column manager then only
333+ /// hides/reorders client-side.
334+ nonisolated static func parseColumnList(_ list: Substring) -> ColumnListShape? {
335+ let tokens = SQLTokenizer.tokenize(String(list)).filter { !$0.kind.isTrivia }
336+ if tokens.count == 1, tokens[0].kind == .star { return .star }
337+ guard tokens.count % 2 == 1 else { return nil }
338+ var names: [String] = []
339+ for (index, token) in tokens.enumerated() {
340+ if index % 2 == 1 {
341+ guard token.kind == .comma else { return nil }
342+ continue
343+ }
344+ switch token.kind {
345+ // DataFusion folds unquoted identifiers to lowercase.
346+ case .identifier(let name): names.append(name.lowercased())
347+ case .quotedIdentifier(let name): names.append(name)
348+ default: return nil
349+ }
350+ }
351+ return .identifiers(names)
352+ }
353+
354+ /// Inserts `newColumns` into `order`, placing each one that appears in
355+ /// `reference` (a saved order) right after its nearest saved predecessor
356+ /// that's already placed — or first if none is — and appending the rest.
357+ /// Used to keep the positions of columns that are absent for a while.
358+ nonisolated static func mergedColumnOrder(
359+ _ order: [String], inserting newColumns: [String], reference: [String]
360+ ) -> [String] {
361+ var result = order
362+ let referenceIndex = Dictionary(reference.enumerated().map { ($1, $0) }, uniquingKeysWith: { first, _ in first })
363+ let pending = newColumns.filter { referenceIndex[$0] == nil }
364+ let positioned = newColumns
365+ .filter { referenceIndex[$0] != nil }
366+ .sorted { referenceIndex[$0]! < referenceIndex[$1]! }
367+ for column in positioned where !result.contains(column) {
368+ let savedIndex = referenceIndex[column]!
369+ let predecessor = reference[..<savedIndex].reversed().first { result.contains($0) }
370+ if let predecessor, let position = result.firstIndex(of: predecessor) {
371+ result.insert(column, at: position + 1)
372+ } else {
373+ result.insert(column, at: 0)
374+ }
375+ }
376+ for column in pending where !result.contains(column) {
377+ result.append(column)
378+ }
379+ return result
380+ }
381+
211382 // MARK: - Column Configuration Persistence
212383
213384 struct ColumnConfiguration: Codable {
@@ -221,7 +392,16 @@ final class QueryViewModel {
221392
222393 private func saveColumnConfig() {
223394 guard let stream = currentStream else { return }
224− let config = ColumnConfiguration(order: columnOrder, hidden: hiddenColumns)
395+ // Persist the full intended hidden set and order, not just the currently
396+ // present columns (see `savedHiddenColumns` / `savedColumnOrder`).
397+ let present = Set(columnOrder)
398+ let order = Self.mergedColumnOrder(
399+ columnOrder,
400+ inserting: savedColumnOrder.filter { !present.contains($0) },
401+ reference: savedColumnOrder
402+ )
403+ savedColumnOrder = order
404+ let config = ColumnConfiguration(order: order, hidden: savedHiddenColumns.union(hiddenColumns))
225405 if let data = try? JSONEncoder().encode(config) {
226406 UserDefaults.standard.set(data, forKey: Self.columnConfigKey(for: stream))
227407 }
@@ -250,7 +430,9 @@ final class QueryViewModel {
250430
251431 guard let config else {
252432 columnOrder = extractedColumns
433+ savedColumnOrder = []
253434 hiddenColumns = []
435+ savedHiddenColumns = []
254436 return
255437 }
256438
@@ -263,7 +445,20 @@ final class QueryViewModel {
263445 merged.append(col)
264446 }
265447 columnOrder = merged
448+ savedColumnOrder = config.order
449+ savedHiddenColumns = config.hidden
266450 hiddenColumns = config.hidden.intersection(extractedSet)
451+
452+ // The `visibleCount > 1` guard in toggleColumnVisibility only covers
453+ // user toggles. A saved config can hide every currently-extracted column
454+ // (e.g. the stream's schema shrank so only previously-hidden columns
455+ // remain), which would render the results table with zero columns and
456+ // leave `updateSQLColumns` early-returning on the empty case. Keep at
457+ // least the first column visible. Mirrors LiveTailViewModel.updateColumns.
458+ if !columnOrder.isEmpty, hiddenColumns.count >= columnOrder.count,
459+ let firstColumn = columnOrder.first {
460+ hiddenColumns.remove(firstColumn)
461+ }
267462 }
268463
269464 private(set) var filteredResults: [LogRecord] = []
@@ -286,8 +481,22 @@ final class QueryViewModel {
286481 filteredResults = results
287482 } else {
288483 let text = filterText
289− filteredResults = zip(results, cachedSearchTexts).compactMap { record, searchText in
290− searchText.localizedCaseInsensitiveContains(text) ? record : nil
484+ // The search-text cache is built asynchronously, so it may be empty
485+ // or stale when the filter changes. `zip` would silently truncate to
486+ // the shorter sequence and drop matching rows, so only use the cache
487+ // when it lines up with the current results; otherwise compute the
488+ // search text inline for correctness.
489+ if cachedSearchTexts.count == results.count {
490+ filteredResults = zip(results, cachedSearchTexts).compactMap { record, searchText in
491+ searchText.localizedCaseInsensitiveContains(text) ? record : nil
492+ }
493+ } else {
494+ filteredResults = results.filter { record in
495+ record.values
496+ .map { $0.displayString }
497+ .joined(separator: " ")
498+ .localizedCaseInsensitiveContains(text)
499+ }
291500 }
292501 }
293502 }
@@ -331,6 +540,13 @@ final class QueryViewModel {
331540
332541 // Cancel any in-flight query
333542 queryTask?.cancel()
543+ // Bump the generation so the in-flight task's cleanup can detect that
544+ // it has been superseded and skip its `isLoading = false` (which would
545+ // otherwise race with the `isLoading = true` below and briefly drop
546+ // the loading indicator during this query).
547+ queryGeneration &+= 1
548+ let generation = queryGeneration
549+ latestQueryStream = stream
334550
335551 isLoading = true
336552 errorMessage = nil
@@ -339,18 +555,44 @@ final class QueryViewModel {
339555 let startTime = CFAbsoluteTimeGetCurrent()
340556
341557 let task = Task {
558+ // Always clear the spinner on exit when this is still the active
559+ // query. The defer runs on every path (success, error, and the
560+ // cancellation cases that previously returned before reaching the
561+ // trailing `isLoading = false`), so the spinner can never wedge
562+ // even if a new cancel path is added without resetting it.
563+ defer {
564+ if generation == queryGeneration {
565+ isLoading = false
566+ }
567+ }
342568 do {
343569 try Task.checkCancellation()
344570 let queryResults = try await client.query(sql: sql, startTime: startDate, endTime: endDate)
345571 try Task.checkCancellation()
572+ // Re-check before committing. A superseding executeQuery() cancels
573+ // this task (queryTask?.cancel()) before starting the next one, but
574+ // cancellation landing just after the check above would otherwise
575+ // let a stale query clobber the newer one's results/columns.
576+ guard !Task.isCancelled else { return }
577+ // Drop the response if a newer query (possibly for a different
578+ // stream) has since been launched without cancelling this task.
579+ guard latestQueryStream == stream else { return }
346580
347581 results = queryResults
582+ // Drop any prior row selection: the new result set reassigns row
583+ // identities, so a retained selectedLogEntry would either dangle or
584+ // value-match an unrelated row, leaving a stale detail inspector.
585+ selectedLogEntry = nil
348586 queryDuration = CFAbsoluteTimeGetCurrent() - startTime
349587 resultCount = results.count
350588
351− // Detect if results were likely truncated (only meaningful
352− // for auto-generated queries where we control the LIMIT)
353− resultsTruncated = usedAutoLimit && results.count == limit
589+ // Detect if results were likely truncated. We know the cap for
590+ // auto-generated queries; for user-entered SQL (which includes the
591+ // default query `setDefaultQuery` writes into the editor — the common
592+ // stream-selection path), parse a trailing `LIMIT n` so the indicator
593+ // still fires when the row count lands exactly on the limit.
594+ let effectiveLimit = usedAutoLimit ? limit : Self.trailingLimit(in: sql)
595+ resultsTruncated = effectiveLimit.map { results.count == $0 } ?? false
354596
355597 // Extract columns in a single pass, with priority fields first,
356598 // then apply any saved column configuration for this stream
@@ -377,19 +619,36 @@ final class QueryViewModel {
377619 return
378620 } catch {
379621 guard !Task.isCancelled else { return }
622+ // Same supersession guard as the success path: a stale failed
623+ // query must not clobber a newer query's state.
624+ guard latestQueryStream == stream else { return }
380625 errorMessage = ParseableError.userFriendlyMessage(for: error)
381626 if let serverError = error as? ParseableError,
382627 case .serverError(_, let msg) = serverError,
383− let pos = SQLErrorPosition.parse(from: msg) {
628+ let pos = SQLErrorPosition.parse(from: msg),
629+ sqlQuery == sql {
630+ // The server's line/column is relative to the *submitted* SQL.
631+ // Only map it back into the editor when the editor still holds
632+ // that same text — if the user edited the query while it was in
633+ // flight, the position no longer corresponds to what's displayed
634+ // and would underline an unrelated span. (`sqlQuery`'s didSet
635+ // already cleared errorRange on that edit, so leaving it nil here
636+ // keeps the editor unmarked.)
384637 errorRange = SQLTokenizer.errorHighlightRange(
385− line: pos.line, column: pos.column, in: sqlQuery
638+ line: pos.line, column: pos.column, in: sql
386639 )
387640 }
388641 results = []
389642 columns = []
643+ // Drop the previous query's column layout too, otherwise derived
644+ // state like `visibleColumns` (and a CSV export reading it) would
645+ // report stale column names after the failure.
646+ columnOrder = []
647+ hiddenColumns = []
648+ savedHiddenColumns = []
649+ savedColumnOrder = []
650+ autoHiddenColumns = []
390651 }
391−
392− isLoading = false
393652 }
394653 queryTask = task
395654 await task.value
@@ -406,14 +665,20 @@ final class QueryViewModel {
406665
407666 @MainActor
408667 func loadSchema(client: ParseableClient?, stream: String?) async {
668+ latestSchemaStream = stream
409669 guard let client, let stream else {
410670 schemaFields = []
411671 return
412672 }
413673 do {
414674 let schema = try await client.getStreamSchema(stream: stream)
675+ // A newer load (e.g. a rapid stream switch) may have superseded this
676+ // one; only commit if this is still the stream last requested,
677+ // otherwise we'd show the wrong stream's fields in autocomplete.
678+ guard latestSchemaStream == stream else { return }
415679 schemaFields = schema.fields
416680 } catch {
681+ guard latestSchemaStream == stream else { return }
417682 // Schema load is best-effort; don't surface errors
418683 schemaFields = []
419684 }
@@ -443,7 +708,9 @@ final class QueryViewModel {
443708 var empty = Set(columns)
444709 for record in records {
445710 if empty.isEmpty { break }
446− for column in empty {
711+ // Iterate a snapshot: mutating `empty` while iterating it directly
712+ // is undefined behavior and can skip elements or trap.
713+ for column in Array(empty) {
447714 if let value = record[column], value != .null, value != .string("") {
448715 empty.remove(column)
449716 }
@@ -452,23 +719,40 @@ final class QueryViewModel {
452719 return empty
453720 }
454721
722+ /// Exports the on-screen rows as JSON. Uses `filteredResults` (not the full
723+ /// `results`) so the output matches what the user sees with an active result
724+ /// filter, mirroring the view's export path.
455725 func exportAsJSON() -> String {
456− guard !results.isEmpty else { return "[]" }
726+ let rows = filteredResults
727+ guard !rows.isEmpty else { return "[]" }
457728 let encoder = JSONEncoder()
458729 encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
459− if let data = try? encoder.encode(results),
730+ if let data = try? encoder.encode(Self.projectRecords(rows, to: visibleColumns)),
460731 let string = String(data: data, encoding: .utf8) {
461732 return string
462733 }
463734 return "[]"
464735 }
465736
737+ /// Exports the on-screen rows as CSV. Uses `filteredResults` for the same
738+ /// reason as `exportAsJSON`.
466739 func exportAsCSV() -> String {
467− Self.buildCSV(records: results, columns: visibleColumns)
740+ Self.buildCSV(records: filteredResults, columns: visibleColumns)
741+ }
742+
743+ /// Projects each record down to the given columns so JSON export, like CSV,
744+ /// respects hidden columns instead of leaking every field. Safe to call from
745+ /// any thread.
746+ nonisolated static func projectRecords(_ records: [LogRecord], to columns: [String]) -> [LogRecord] {
747+ // No column list means no restriction (columns not computed yet) — export
748+ // the full records rather than stripping every field to an empty object.
749+ guard !columns.isEmpty else { return records }
750+ let allowed = Set(columns)
751+ return records.map { record in record.filter { allowed.contains($0.key) } }
468752 }
469753
470754 /// Builds a CSV string from records and columns. Safe to call from any thread.
471− static func buildCSV(records: [LogRecord], columns: [String]) -> String {
755+ nonisolated static func buildCSV(records: [LogRecord], columns: [String]) -> String {
472756 guard !records.isEmpty, !columns.isEmpty else { return "" }
473757
474758 var csv = String()
@@ -494,7 +778,7 @@ final class QueryViewModel {
494778 return csv
495779 }
496780
497− private static func escapeCSV(_ value: String) -> String {
781+ nonisolated private static func escapeCSV(_ value: String) -> String {
498782 // Check at the Unicode scalar level to correctly detect \r and \n
499783 // inside \r\n (CRLF) grapheme clusters, which Swift's String.contains
500784 // treats as a single Character that doesn't match "\r" or "\n" alone.
@@ -508,10 +792,29 @@ final class QueryViewModel {
508792 }
509793
510794 func clearResults() {
795+ // Cancel any in-flight work first. Without this, a query still running
796+ // when the user switches streams or disconnects would pass its post-await
797+ // cancellation check (it was never cancelled) and write its results +
798+ // persist a column config for the *old* stream after this reset.
799+ queryTask?.cancel()
800+ queryTask = nil
801+ searchTextTask?.cancel()
802+ searchTextTask = nil
803+ filterTask?.cancel()
804+ filterTask = nil
805+
806+ // The in-flight query was cancelled above, so its task returns via the
807+ // CancellationError path and never reaches `isLoading = false`. Reset it
808+ // here, otherwise deselecting the stream / disconnecting (which calls
809+ // clearResults with no follow-up query) leaves the spinner stuck on.
810+ isLoading = false
811+
511812 results = []
512813 columns = []
513814 columnOrder = []
514815 hiddenColumns = []
816+ savedHiddenColumns = []
817+ savedColumnOrder = []
515818 autoHiddenColumns = []
516819 currentStream = nil
517820 resultCount = 0
@@ -521,6 +824,11 @@ final class QueryViewModel {
521824 errorRange = nil
522825 resultsTruncated = false
523826 schemaFields = []
827+ // Keep the stream trackers consistent with the cleared schema/results so
828+ // a later reload guard never sees a non-nil stream paired with empty data.
829+ latestSchemaStream = nil
830+ latestQueryStream = nil
831+ boundContext = nil
524832 }
525833
526834 /// Modifies `sqlQuery` to add a column-value filter condition.
@@ -530,51 +838,139 @@ final class QueryViewModel {
530838 let condition: String
531839 if let value, value != .null {
532840 let literal = value.sqlLiteral
533− condition = exclude ? "\(escapedCol) <> \(literal)" : "\(escapedCol) = \(literal)"
841+ // Exclude with `IS DISTINCT FROM`, not `<>`: under SQL's three-valued
842+ // logic `NULL <> 'x'` is NULL, so `<>` also dropped every row where the
843+ // column is missing/NULL — common for sparse fields — which "exclude
844+ // this value" doesn't ask for (the live-tail exclude keeps them too).
845+ condition = exclude
846+ ? "\(escapedCol) IS DISTINCT FROM \(literal)"
847+ : "\(escapedCol) = \(literal)"
534848 } else {
535849 condition = exclude ? "\(escapedCol) IS NOT NULL" : "\(escapedCol) IS NULL"
536850 }
537851
538− var sql = sqlQuery.trimmingCharacters(in: .whitespacesAndNewlines)
852+ let sql = sqlQuery.trimmingCharacters(in: .whitespacesAndNewlines)
539853 if sql.isEmpty { return }
540854
541855 // Locate the top-level WHERE and the first trailing clause using the
542856 // tokenizer rather than a raw regex, so keywords inside quoted
543857 // identifiers, string literals, comments, or subqueries are ignored.
544− let tailKeywords: Set<String> = ["ORDER", "GROUP", "HAVING", "LIMIT", "OFFSET"]
858+ let tokens = SQLTokenizer.tokenize(sql)
545859 var depth = 0
546− var whereEnd: String.Index?
547− var tailStart: String.Index?
548− for token in SQLTokenizer.tokenize(sql) {
860+ // WHERE and the trailing clauses only follow the top-level FROM. Keywords
861+ // before it belong to the SELECT list — e.g. a field named `offset` or
862+ // `limit` (which the tokenizer reports as keywords) — and must not be
863+ // mistaken for clause starts.
864+ var fromSeen = false
865+ var whereIndex: Int?
866+ var tailIndex: Int?
867+ // Track whether the existing WHERE body has a top-level OR — only then does
868+ // AND-ing a new condition need parentheses to preserve precedence.
869+ var bodyHasTopLevelOr = false
870+ // The last token that is actual SQL — not whitespace, a comment, or a
871+ // statement-terminating `;`. New text is spliced in right after such
872+ // tokens (never at the raw end of the string), so a trailing `;` or a
873+ // trailing `-- comment` stays at the end instead of swallowing the
874+ // appended condition: `... LIMIT 10;` must not become `... LIMIT 10; WHERE`,
875+ // and `... -- note` must not become `... -- note WHERE <commented out>`.
876+ func isSignificant(_ token: SQLTokenizer.Token) -> Bool {
877+ !token.kind.isTrivia && token.kind != .other(";")
878+ }
879+ func nextSignificantKind(after index: Int) -> SQLTokenizer.TokenKind? {
880+ tokens[(index + 1)...].first(where: { isSignificant($0) })?.kind
881+ }
882+ // Whether the keyword at `index` actually opens a trailing clause. ORDER and
883+ // GROUP must be followed by BY (so `WITHIN GROUP (…)` or a column named
884+ // `order` doesn't count), and LIMIT/OFFSET by their row count (so a column
885+ // named `offset` in `WHERE offset > 5` doesn't cut the WHERE body short).
886+ func startsTrailingClause(_ keyword: String, at index: Int) -> Bool {
887+ switch keyword {
888+ case "ORDER", "GROUP":
889+ return nextSignificantKind(after: index) == .keyword("BY")
890+ case "LIMIT", "OFFSET":
891+ if case .number = nextSignificantKind(after: index) { return true }
892+ return false
893+ case "HAVING":
894+ return true
895+ default:
896+ return false
897+ }
898+ }
899+ var lastSignificant: Int?
900+ for (idx, token) in tokens.enumerated() {
901+ if isSignificant(token) { lastSignificant = idx }
549902 switch token.kind {
550903 case .leftParen:
551904 depth += 1
552905 case .rightParen:
553906 depth = max(0, depth - 1)
554− case .keyword(let kw) where depth == 0:
555− if kw == "WHERE", whereEnd == nil {
556− whereEnd = token.range.upperBound
557− } else if tailKeywords.contains(kw), tailStart == nil {
558− tailStart = token.range.lowerBound
907+ case .keyword("FROM") where depth == 0:
908+ fromSeen = true
909+ case .keyword(let kw) where depth == 0 && fromSeen:
910+ if kw == "WHERE", whereIndex == nil {
911+ whereIndex = idx
912+ // A trailing clause seen *before* the WHERE (e.g. the GROUP BY of
913+ // the first SELECT in `... GROUP BY a UNION ALL SELECT ... WHERE`)
914+ // doesn't end this WHERE's body. Keeping it would make the body
915+ // range run backwards (a trapping `Range`), so look for the
916+ // body's end afresh after the WHERE.
917+ tailIndex = nil
918+ } else if tailIndex == nil, startsTrailingClause(kw, at: idx) {
919+ tailIndex = idx
920+ } else if kw == "OR", whereIndex != nil, tailIndex == nil {
921+ bodyHasTopLevelOr = true
559922 }
560923 default:
561924 break
562925 }
563926 }
564−
565− if let whereEnd {
566− if let tailStart, tailStart > whereEnd {
567− sql.insert(contentsOf: "AND \(condition) ", at: tailStart)
927+ // Nothing but comments/semicolons — there's no statement to filter.
928+ guard let lastSignificant else { return }
929+
930+ // Each branch rebuilds the query from slices of the original text, keeping
931+ // the user's line breaks: joining pieces with single spaces would pull the
932+ // text after a `-- comment` onto the comment's line and comment it out.
933+ // Text spliced directly in front of another token (`(a = 1)ORDER BY`) needs
934+ // a space so the two don't fuse (`... IS NULLORDER BY`).
935+ func separated(_ rest: Substring) -> String {
936+ guard let next = rest.first, !next.isWhitespace, next != ";" else { return String(rest) }
937+ return " " + rest
938+ }
939+ if let whereIndex {
940+ // The WHERE body runs up to the first trailing clause, or to the end
941+ // of the statement. Only its significant tokens bound the splice, so a
942+ // comment between the body and ORDER BY stays after the new condition.
943+ let bodyEndIndex = tailIndex ?? (lastSignificant + 1)
944+ let bodyIndices = (whereIndex + 1)..<bodyEndIndex
945+ if let first = bodyIndices.first(where: { isSignificant(tokens[$0]) }),
946+ let last = bodyIndices.last(where: { isSignificant(tokens[$0]) }) {
947+ // Parenthesize the existing WHERE body before AND-ing the new
948+ // condition only when it has a top-level OR, otherwise the OR
949+ // silently changes meaning: `WHERE a = 1 OR b = 2` would become
950+ // `WHERE a = 1 OR b = 2 AND c = 3`, which SQL binds as
951+ // `a = 1 OR (b = 2 AND c = 3)` rather than the intended
952+ // `(a = 1 OR b = 2) AND c = 3`. A body without a top-level OR is
953+ // left un-parenthesized so simple filters stay readable.
954+ let bodyStart = tokens[first].range.lowerBound
955+ let bodyEnd = tokens[last].range.upperBound
956+ let body = sql[bodyStart..<bodyEnd]
957+ let wrappedBody = bodyHasTopLevelOr ? "(\(body))" : String(body)
958+ sqlQuery = "\(sql[..<bodyStart])\(wrappedBody) AND \(condition)\(separated(sql[bodyEnd...]))"
568959 } else {
569− sql += " AND \(condition)"
960+ // An empty WHERE body (e.g. a half-written `... WHERE` with no
961+ // condition yet, or `WHERE` immediately followed by ORDER/GROUP/
962+ // LIMIT) would otherwise produce `WHERE AND <condition>` — a
963+ // dangling AND with no left operand. Drop the AND in that case.
964+ let whereEnd = tokens[whereIndex].range.upperBound
965+ sqlQuery = "\(sql[..<whereEnd]) \(condition)\(separated(sql[whereEnd...]))"
570966 }
571− } else if let tailStart {
572− sql.insert(contentsOf: "WHERE \(condition) ", at: tailStart)
967+ } else if let tailIndex {
968+ let tailStart = tokens[tailIndex].range.lowerBound
969+ sqlQuery = "\(sql[..<tailStart])WHERE \(condition) \(sql[tailStart...])"
573970 } else {
574− sql += " WHERE \(condition)"
971+ let statementEnd = tokens[lastSignificant].range.upperBound
972+ sqlQuery = "\(sql[..<statementEnd]) WHERE \(condition)\(separated(sql[statementEnd...]))"
575973 }
576−
577− sqlQuery = sql
578974 }
579975
580976 /// Sets the default query for the given stream, returning `true` if the
@@ -598,19 +994,35 @@ final class QueryViewModel {
598994 }
599995
600996 /// Escapes a SQL identifier by doubling internal double-quotes, then wrapping in double-quotes.
601− static func escapeSQLIdentifier(_ identifier: String) -> String {
997+ nonisolated static func escapeSQLIdentifier(_ identifier: String) -> String {
602998 "\"\(identifier.replacingOccurrences(of: "\"", with: "\"\""))\""
603999 }
6041000
1001+ /// Extracts the row cap from a trailing `LIMIT n` clause (tolerating a trailing
1002+ /// semicolon/whitespace), used to detect when a result set was truncated.
1003+ /// Returns nil when there's no recognizable trailing `LIMIT` — e.g. when the
1004+ /// query uses `LIMIT n OFFSET m` — so we never report a false truncation.
1005+ nonisolated static func trailingLimit(in sql: String) -> Int? {
1006+ let pattern = #"(?i)\bLIMIT\s+(\d+)\s*;?\s*$"#
1007+ guard let regex = try? NSRegularExpression(pattern: pattern) else { return nil }
1008+ let range = NSRange(sql.startIndex..<sql.endIndex, in: sql)
1009+ guard let match = regex.firstMatch(in: sql, range: range),
1010+ let numberRange = Range(match.range(at: 1), in: sql) else { return nil }
1011+ return Int(sql[numberRange])
1012+ }
1013+
6051014 // MARK: - Query History
6061015
6071016 private func addToHistory(_ entry: QueryHistoryEntry) {
1017+ // Start from what's persisted, not this instance's copy: a model created
1018+ // earlier (e.g. one whose query finished after a reconnect replaced it)
1019+ // would otherwise overwrite newer entries saved by the current one.
1020+ queryHistory = Self.loadHistory()
6081021 // Deduplicate consecutive identical queries
6091022 if queryHistory.first?.sql == entry.sql { return }
6101023 queryHistory.insert(entry, at: 0)
6111024 if queryHistory.count > Self.maxHistory {
6121025 queryHistory = Array(queryHistory.prefix(Self.maxHistory))
613− historyIsFull = true
6141026 }
6151027 Self.saveHistory(queryHistory)
6161028 }