feat: support dialect-aware query conditions

[atzoum]

Description

Introducing the following methods.

// QueryCondition returns a dialect-specific query condition sql string for the provided identifier, operator and value(s).
//
// E.g. QueryCondition("age", "gt", 18) returns "age > 18"
//
// Each operator has a different number of arguments, e.g. [eq] requires one argument, [in] requires at least one argument, etc.
// See [op] package for the list of supported operators
QueryCondition(identifier, operator string, args ...any) (sql string, err error)

// TimestampAdd returns an expression that adds the interval to the timestamp value.
// The value can either be a string literal (column, timestamp, function etc.) or a [time.Time] value.
TimestampAdd(timeValue any, interval int, unit string) (Expression, error)

// DateAdd returns an expression that adds the interval to the date value.
// The value can either be a string literal (column, timestamp, function etc.) or a [time.Time] value.
// Values are cast to [DATE].
DateAdd(dateValue any, interval int, unit string) (Expression, error)

Using goqu internally which:

• Provides proper go type(s) recognition in parameters (int, float, string, time.Time, etc.)
• It properly escapes special characters from string values (')
• It handles differences in warehouse dialects seamlessly eg. bool_col IS TRUE vs bool_col = 'TRUE'.

Linear Ticket

resolves PRO-3401

Security

• The code changed/added as part of this pull request won't create any security issues with how the software is being used.

[codecov]

Codecov Report

Attention: Patch coverage is 96.31068% with 19 lines in your changes missing coverage. Please review.

Project coverage is 87.04%. Comparing base (8cab1fd) to head (da28b2b).
Report is 1 commits behind head on main.

Files with missing lines	Patch %	Lines
sqlconnect/internal/base/goqu_dialect.go	89.14%	13 Missing and 1 partial ⚠️
sqlconnect/op/operator.go	0.00%	5 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #180      +/-   ##
==========================================
+ Coverage   85.58%   87.04%   +1.46%     
==========================================
  Files          78       87       +9     
  Lines        3343     3851     +508     
==========================================
+ Hits         2861     3352     +491     
- Misses        328      345      +17     
  Partials      154      154              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[shubhammehra4]

LGTM

[sprksh]

The key nbfinterval is not clear to me. Can we give it a clearer name?

[atzoum]

Open to suggestions! nbf prefix stands for not before.

[sprksh]

Instead can we have something like
beforeintervalbounded & beforeintervalunbounded
afterintervalbounded & afterintervalunbounded

[sprksh]

Also, we can use camelCase or snake case operators. Will make things much clearer. Especially in case we are using bigger ones.

[atzoum]

imo operators should be kept small and case insensitive

[atzoum]

what about:
gti --> gt an interval
gtei --> gte an interval
lti --> less than an interval
ltei --> less than an interval
betweeni --> between an interval

[atzoum]

Another option would be to keep using gt, gte, lt, lte, between, etc. and allow a special value format for intervals, e.g. "now-1d"

[atzoum]

finally, we can just keep ti simple for now and name it inlast

[sprksh]

Went through the code and tests. Looks great.

[sprksh]

For Between, Should we think of some way to specify left and right bounded/unbounded conditions.

[sprksh]

Also NotBetween