@@ -2,6 +2,7 @@ import Foundation
22import SwiftUI
33
44@Observable
5+@MainActor
56final class QueryViewModel {
67 var sqlQuery = "" {
78 didSet {
@@ -16,6 +17,8 @@ final class QueryViewModel {
1617 // Build search texts asynchronously
1718 searchTextTask?.cancel()
1819 cachedSearchTexts = []
20+ searchTextGeneration &+= 1
21+ let generation = searchTextGeneration
1922 // Apply the current filter immediately using the inline fallback path
2023 // (the cache was just invalidated). Calling updateFilteredResults()
2124 // rather than `filteredResults = results` avoids briefly showing
@@ -24,26 +27,61 @@ final class QueryViewModel {
2427 // re-applies the filter.
2528 updateFilteredResults()
2629 let snapshot = results
27− searchTextTask = Task {
28− let texts = snapshot.map { record in
29− record.values.map { $0.displayString }.joined(separator: " ")
30− }
31− guard !Task.isCancelled else { return }
32− cachedSearchTexts = texts
33− if !filterText.isEmpty {
34− 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()
3550 }
3651 }
3752 }
3853 }
3954 private var cachedSearchTexts: [String] = []
4055 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
4159 var columns: [String] = []
4260 var columnOrder: [String] = []
4361 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] = []
4472 var autoHiddenColumns: Set<String> = []
4573 /// Column config from a saved query, applied on next query execution.
4674 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?
4785 private var currentStream: String?
4886 var isLoading = false
4987 var errorMessage: String?
@@ -61,10 +99,23 @@ final class QueryViewModel {
6199 var schemaFields: [SchemaField] = []
62100 /// The stream of the most recent `loadSchema` call, used to drop a stale
63101 /// in-flight response when the user rapidly switches streams.
64− private var latestSchemaStream: String?
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?
65108
66109 // Query task for cancellation
67110 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
68119
69120 // Time range
70121 var timeRangeOption: TimeRangeOption = .last1Hour
@@ -161,9 +212,16 @@ final class QueryViewModel {
161212 return columnOrder.filter { !allHidden.contains($0) }
162213 }
163214
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+
164221 func toggleColumnVisibility(_ column: String) {
165222 if hiddenColumns.contains(column) {
166223 hiddenColumns.remove(column)
224+ savedHiddenColumns.remove(column)
167225 } else if autoHiddenColumns.contains(column) {
168226 autoHiddenColumns.remove(column)
169227 } else {
@@ -172,6 +230,7 @@ final class QueryViewModel {
172230 let visibleCount = columnOrder.count - allHidden.count
173231 if visibleCount > 1 {
174232 hiddenColumns.insert(column)
233+ savedHiddenColumns.insert(column)
175234 }
176235 }
177236 saveColumnConfig()
@@ -180,6 +239,7 @@ final class QueryViewModel {
180239
181240 func showAllColumns() {
182241 hiddenColumns.removeAll()
242+ savedHiddenColumns.removeAll()
183243 autoHiddenColumns.removeAll()
184244 saveColumnConfig()
185245 updateSQLColumns()
@@ -209,32 +269,116 @@ final class QueryViewModel {
209269
210270 func resetColumnConfig() {
211271 columnOrder = columns
272+ savedColumnOrder = []
212273 hiddenColumns.removeAll()
274+ savedHiddenColumns.removeAll()
213275 autoHiddenColumns.removeAll()
214276 saveColumnConfig()
215277 updateSQLColumns()
216278 }
217279
218− /// 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).
219282 func updateSQLColumns() {
220− guard let range = SQLTokenizer.selectColumnListRange(in: sqlQuery) else { return }
221−
222− 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) }
223291 guard !visible.isEmpty else { return }
224292
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+
225307 let newColumnList: String
226308 // Use `*` whenever every column is visible, regardless of display order —
227309 // reordering columns (a set-preserving permutation) must not pin the query
228− // to an explicit snapshot that hides newly-appearing fields on re-query.
229− if visible.count == columns.count && Set(visible) == Set(columns) {
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) {
230314 newColumnList = "*"
231315 } else {
232− newColumnList = visible.map { Self.escapeSQLIdentifier($0) }.joined(separator: ", ")
316+ newColumnList = (visible + listedButAbsent).map { Self.escapeSQLIdentifier($0) }.joined(separator: ", ")
233317 }
234318
235319 sqlQuery.replaceSubrange(range, with: newColumnList)
236320 }
237321
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+
238382 // MARK: - Column Configuration Persistence
239383
240384 struct ColumnConfiguration: Codable {
@@ -248,7 +392,16 @@ final class QueryViewModel {
248392
249393 private func saveColumnConfig() {
250394 guard let stream = currentStream else { return }
251− 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))
252405 if let data = try? JSONEncoder().encode(config) {
253406 UserDefaults.standard.set(data, forKey: Self.columnConfigKey(for: stream))
254407 }
@@ -277,7 +430,9 @@ final class QueryViewModel {
277430
278431 guard let config else {
279432 columnOrder = extractedColumns
433+ savedColumnOrder = []
280434 hiddenColumns = []
435+ savedHiddenColumns = []
281436 return
282437 }
283438
@@ -290,7 +445,20 @@ final class QueryViewModel {
290445 merged.append(col)
291446 }
292447 columnOrder = merged
448+ savedColumnOrder = config.order
449+ savedHiddenColumns = config.hidden
293450 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+ }
294462 }
295463
296464 private(set) var filteredResults: [LogRecord] = []
@@ -372,6 +540,13 @@ final class QueryViewModel {
372540
373541 // Cancel any in-flight query
374542 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
375550
376551 isLoading = true
377552 errorMessage = nil
@@ -380,6 +555,16 @@ final class QueryViewModel {
380555 let startTime = CFAbsoluteTimeGetCurrent()
381556
382557 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+ }
383568 do {
384569 try Task.checkCancellation()
385570 let queryResults = try await client.query(sql: sql, startTime: startDate, endTime: endDate)
@@ -389,14 +574,25 @@ final class QueryViewModel {
389574 // cancellation landing just after the check above would otherwise
390575 // let a stale query clobber the newer one's results/columns.
391576 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 }
392580
393581 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
394586 queryDuration = CFAbsoluteTimeGetCurrent() - startTime
395587 resultCount = results.count
396588
397− // Detect if results were likely truncated (only meaningful
398− // for auto-generated queries where we control the LIMIT)
399− 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
400596
401597 // Extract columns in a single pass, with priority fields first,
402598 // then apply any saved column configuration for this stream
@@ -423,12 +619,23 @@ final class QueryViewModel {
423619 return
424620 } catch {
425621 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 }
426625 errorMessage = ParseableError.userFriendlyMessage(for: error)
427626 if let serverError = error as? ParseableError,
428627 case .serverError(_, let msg) = serverError,
429− 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.)
430637 errorRange = SQLTokenizer.errorHighlightRange(
431− line: pos.line, column: pos.column, in: sqlQuery
638+ line: pos.line, column: pos.column, in: sql
432639 )
433640 }
434641 results = []
@@ -438,10 +645,10 @@ final class QueryViewModel {
438645 // report stale column names after the failure.
439646 columnOrder = []
440647 hiddenColumns = []
648+ savedHiddenColumns = []
649+ savedColumnOrder = []
441650 autoHiddenColumns = []
442651 }
443−
444− isLoading = false
445652 }
446653 queryTask = task
447654 await task.value
@@ -512,25 +719,31 @@ final class QueryViewModel {
512719 return empty
513720 }
514721
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.
515725 func exportAsJSON() -> String {
516− guard !results.isEmpty else { return "[]" }
726+ let rows = filteredResults
727+ guard !rows.isEmpty else { return "[]" }
517728 let encoder = JSONEncoder()
518729 encoder.outputFormatting = [.prettyPrinted, .sortedKeys]
519− if let data = try? encoder.encode(Self.projectRecords(results, to: visibleColumns)),
730+ if let data = try? encoder.encode(Self.projectRecords(rows, to: visibleColumns)),
520731 let string = String(data: data, encoding: .utf8) {
521732 return string
522733 }
523734 return "[]"
524735 }
525736
737+ /// Exports the on-screen rows as CSV. Uses `filteredResults` for the same
738+ /// reason as `exportAsJSON`.
526739 func exportAsCSV() -> String {
527− Self.buildCSV(records: results, columns: visibleColumns)
740+ Self.buildCSV(records: filteredResults, columns: visibleColumns)
528741 }
529742
530743 /// Projects each record down to the given columns so JSON export, like CSV,
531744 /// respects hidden columns instead of leaking every field. Safe to call from
532745 /// any thread.
533− static func projectRecords(_ records: [LogRecord], to columns: [String]) -> [LogRecord] {
746+ nonisolated static func projectRecords(_ records: [LogRecord], to columns: [String]) -> [LogRecord] {
534747 // No column list means no restriction (columns not computed yet) — export
535748 // the full records rather than stripping every field to an empty object.
536749 guard !columns.isEmpty else { return records }
@@ -539,7 +752,7 @@ final class QueryViewModel {
539752 }
540753
541754 /// Builds a CSV string from records and columns. Safe to call from any thread.
542− static func buildCSV(records: [LogRecord], columns: [String]) -> String {
755+ nonisolated static func buildCSV(records: [LogRecord], columns: [String]) -> String {
543756 guard !records.isEmpty, !columns.isEmpty else { return "" }
544757
545758 var csv = String()
@@ -565,7 +778,7 @@ final class QueryViewModel {
565778 return csv
566779 }
567780
568− private static func escapeCSV(_ value: String) -> String {
781+ nonisolated private static func escapeCSV(_ value: String) -> String {
569782 // Check at the Unicode scalar level to correctly detect \r and \n
570783 // inside \r\n (CRLF) grapheme clusters, which Swift's String.contains
571784 // treats as a single Character that doesn't match "\r" or "\n" alone.
@@ -600,6 +813,8 @@ final class QueryViewModel {
600813 columns = []
601814 columnOrder = []
602815 hiddenColumns = []
816+ savedHiddenColumns = []
817+ savedColumnOrder = []
603818 autoHiddenColumns = []
604819 currentStream = nil
605820 resultCount = 0
@@ -609,6 +824,11 @@ final class QueryViewModel {
609824 errorRange = nil
610825 resultsTruncated = false
611826 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
612832 }
613833
614834 /// Modifies `sqlQuery` to add a column-value filter condition.
@@ -618,67 +838,139 @@ final class QueryViewModel {
618838 let condition: String
619839 if let value, value != .null {
620840 let literal = value.sqlLiteral
621− 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)"
622848 } else {
623849 condition = exclude ? "\(escapedCol) IS NOT NULL" : "\(escapedCol) IS NULL"
624850 }
625851
626− var sql = sqlQuery.trimmingCharacters(in: .whitespacesAndNewlines)
852+ let sql = sqlQuery.trimmingCharacters(in: .whitespacesAndNewlines)
627853 if sql.isEmpty { return }
628854
629855 // Locate the top-level WHERE and the first trailing clause using the
630856 // tokenizer rather than a raw regex, so keywords inside quoted
631857 // identifiers, string literals, comments, or subqueries are ignored.
632− let tailKeywords: Set<String> = ["ORDER", "GROUP", "HAVING", "LIMIT", "OFFSET"]
858+ let tokens = SQLTokenizer.tokenize(sql)
633859 var depth = 0
634− var whereEnd: String.Index?
635− var tailStart: String.Index?
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?
636867 // Track whether the existing WHERE body has a top-level OR — only then does
637868 // AND-ing a new condition need parentheses to preserve precedence.
638869 var bodyHasTopLevelOr = false
639− for token in SQLTokenizer.tokenize(sql) {
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 }
640902 switch token.kind {
641903 case .leftParen:
642904 depth += 1
643905 case .rightParen:
644906 depth = max(0, depth - 1)
645− case .keyword(let kw) where depth == 0:
646− if kw == "WHERE", whereEnd == nil {
647− whereEnd = token.range.upperBound
648− } else if tailKeywords.contains(kw), tailStart == nil {
649− tailStart = token.range.lowerBound
650− } else if kw == "OR", whereEnd != nil, tailStart == nil {
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 {
651921 bodyHasTopLevelOr = true
652922 }
653923 default:
654924 break
655925 }
656926 }
657−
658− if let whereEnd {
659− // Parenthesize the existing WHERE body before AND-ing the new
660− // condition only when it has a top-level OR, otherwise the OR
661− // silently changes meaning: `WHERE a = 1 OR b = 2` would become
662− // `WHERE a = 1 OR b = 2 AND c = 3`, which SQL binds as
663− // `a = 1 OR (b = 2 AND c = 3)` rather than the intended
664− // `(a = 1 OR b = 2) AND c = 3`. A body without a top-level OR is
665− // left un-parenthesized so simple filters stay readable.
666− let bodyEnd = tailStart ?? sql.endIndex
667− let head = sql[..<whereEnd]
668− let body = sql[whereEnd..<bodyEnd].trimmingCharacters(in: .whitespacesAndNewlines)
669− let tail = sql[bodyEnd...].trimmingCharacters(in: .whitespacesAndNewlines)
670− let wrappedBody = bodyHasTopLevelOr ? "(\(body))" : body
671− sql = "\(head) \(wrappedBody) AND \(condition)"
672− if !tail.isEmpty {
673− sql += " \(tail)"
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...]))"
959+ } else {
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...]))"
674966 }
675− } else if let tailStart {
676− 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...])"
677970 } else {
678− sql += " WHERE \(condition)"
971+ let statementEnd = tokens[lastSignificant].range.upperBound
972+ sqlQuery = "\(sql[..<statementEnd]) WHERE \(condition)\(separated(sql[statementEnd...]))"
679973 }
680−
681− sqlQuery = sql
682974 }
683975
684976 /// Sets the default query for the given stream, returning `true` if the
@@ -702,13 +994,30 @@ final class QueryViewModel {
702994 }
703995
704996 /// Escapes a SQL identifier by doubling internal double-quotes, then wrapping in double-quotes.
705− static func escapeSQLIdentifier(_ identifier: String) -> String {
997+ nonisolated static func escapeSQLIdentifier(_ identifier: String) -> String {
706998 "\"\(identifier.replacingOccurrences(of: "\"", with: "\"\""))\""
707999 }
7081000
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+
7091014 // MARK: - Query History
7101015
7111016 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()
7121021 // Deduplicate consecutive identical queries
7131022 if queryHistory.first?.sql == entry.sql { return }
7141023 queryHistory.insert(entry, at: 0)