@routier/core 0.1.0-rc.2 → 0.2.1

package/dist/expressions/index.js

@@ -1,21 +1,27 @@
 var __webpack_modules__ = ({
-"./src/assertions/index.ts": 
-/*!*********************************!*\
-  !*** ./src/assertions/index.ts ***!
-  \*********************************/
-(function (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+"./src/assertions/index.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   assertDate: () => (assertDate),
   assertInstanceOf: () => (assertInstanceOf),
   assertIsArray: () => (assertIsArray),
   assertIsNotNull: () => (assertIsNotNull),
-  assertString: () => (assertString)
+  assertIsNumber: () => (assertIsNumber),
+  assertString: () => (assertString),
+  isComparatorExpression: () => (isComparatorExpression),
+  isEmptyExpression: () => (isEmptyExpression),
+  isExpression: () => (isExpression),
+  isNotParsableExpression: () => (isNotParsableExpression),
+  isOperatorExpression: () => (isOperatorExpression),
+  isPropertyExpression: () => (isPropertyExpression),
+  isValueExpression: () => (isValueExpression)
 });
-/* ESM import */var _utilities__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ../utilities */ "./src/utilities/dates.ts");
+/* import */ var _expressions_constants__rspack_import_1 = __webpack_require__("./src/expressions/constants.ts");
+/* import */ var _utilities__rspack_import_0 = __webpack_require__("./src/utilities/dates.ts");
+
 
 function assertDate(data) {
-    if ((0,_utilities__WEBPACK_IMPORTED_MODULE_0__.isDate)(data) === false) {
+    if ((0,_utilities__rspack_import_0.isDate)(data) === false) {
         throw new TypeError('Value is not a Date');
     }
 }
@@ -45,26 +51,88 @@ function assertInstanceOf(value, Instance) {
         return;
     }
     if (value != null && typeof value === "object" && "constructor" in value) {
-        throw new TypeError(`Value is not instance of type.  Type: ${value.constructor.name}`);
+        throw new TypeError(`value is not instance of type.  Type: ${value.constructor.name}`);
+    }
+    throw new TypeError(`value is not instance of type`);
+}
+function assertIsNumber(value) {
+    if (typeof value !== "number") {
+        throw new TypeError("value is not of type `number`");
     }
-    throw new TypeError(`Value is not instance of type`);
+}
+function isObjectWithType(value) {
+    return typeof value === "object" && value !== null && "type" in value;
+}
+/**
+ * Type guard: narrows `value` to `Expression` when it is an object with a valid `type` property.
+ */
+function isExpression(value) {
+    return isObjectWithType(value) && _expressions_constants__rspack_import_1.EXPRESSION_TYPES.includes(value.type);
+}
+/**
+ * Type guard: narrows `value` to `OperatorExpression` when it is an object with `type === "operator"`.
+ */
+function isOperatorExpression(value) {
+    return isObjectWithType(value) && value.type === "operator";
+}
+/**
+ * Type guard: narrows `value` to `ComparatorExpression` when it is an object with `type === "comparator"`.
+ */
+function isComparatorExpression(value) {
+    return isObjectWithType(value) && value.type === "comparator";
+}
+/**
+ * Type guard: narrows `value` to `PropertyExpression` when it is an object with `type === "property"`.
+ */
+function isPropertyExpression(value) {
+    return isObjectWithType(value) && value.type === "property";
+}
+/**
+ * Type guard: narrows `value` to `ValueExpression` when it is an object with `type === "value"`.
+ */
+function isValueExpression(value) {
+    return isObjectWithType(value) && value.type === "value";
+}
+/**
+ * Type guard: narrows `value` to `EmptyExpression` when it is an object with `type === "empty"`.
+ */
+function isEmptyExpression(value) {
+    return isObjectWithType(value) && value.type === "empty";
+}
+/**
+ * Type guard: narrows `value` to `NotParsableExpression` when it is an object with `type === "not-parsable"`.
+ */
+function isNotParsableExpression(value) {
+    return isObjectWithType(value) && value.type === "not-parsable";
 }
 
 
-}),
-"./src/expressions/parser.ts": 
-/*!***********************************!*\
-  !*** ./src/expressions/parser.ts ***!
-  \***********************************/
-(function (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+},
+"./src/expressions/constants.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+  EXPRESSION_TYPES: () => (EXPRESSION_TYPES)
+});
+const EXPRESSION_TYPES = [
+    "operator",
+    "comparator",
+    "property",
+    "value",
+    "empty",
+    "not-parsable",
+];
+
+
+},
+"./src/expressions/parser.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   combineExpressions: () => (combineExpressions),
   toExpression: () => (toExpression)
 });
-/* ESM import */var _utilities__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ../utilities */ "./src/utilities/logger.ts");
-/* ESM import */var _assertions__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ../assertions */ "./src/assertions/index.ts");
-/* ESM import */var _types__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./types */ "./src/expressions/types.ts");
+/* import */ var _utilities__rspack_import_2 = __webpack_require__("./src/utilities/logger.ts");
+/* import */ var _assertions__rspack_import_1 = __webpack_require__("./src/assertions/index.ts");
+/* import */ var _types__rspack_import_0 = __webpack_require__("./src/expressions/types.ts");
 
 
 
@@ -80,67 +148,67 @@ const MULTI_LINE_COMMENT_REGEX = /\/\*[\s\S]*?\*\//g;
 const WHITESPACE_REGEX = /\s+/g;
 // need to have negated + strict
 const comparators = {
-    startsWith: new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    startsWith: new _types__rspack_import_0.ComparatorExpression({
         comparator: "starts-with",
         negated: false,
         strict: false
     }),
-    endsWith: new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    endsWith: new _types__rspack_import_0.ComparatorExpression({
         comparator: "ends-with",
         negated: false,
         strict: false
     }),
-    includes: new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    includes: new _types__rspack_import_0.ComparatorExpression({
         comparator: "includes",
         negated: false,
         strict: false
     }),
-    "==": new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    "==": new _types__rspack_import_0.ComparatorExpression({
         comparator: "equals",
         negated: false,
         strict: false
     }),
-    "===": new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    "===": new _types__rspack_import_0.ComparatorExpression({
         comparator: "equals",
         negated: false,
         strict: true
     }),
-    "!=": new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    "!=": new _types__rspack_import_0.ComparatorExpression({
         comparator: "equals",
         negated: true,
         strict: false
     }),
-    "!==": new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    "!==": new _types__rspack_import_0.ComparatorExpression({
         comparator: "equals",
         negated: true,
         strict: true
     }),
-    ">=": new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    ">=": new _types__rspack_import_0.ComparatorExpression({
         comparator: "greater-than-equals",
         negated: false,
         strict: false
     }),
-    ">==": new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    ">==": new _types__rspack_import_0.ComparatorExpression({
         comparator: "greater-than-equals",
         negated: false,
         strict: true
     }),
-    "<=": new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    "<=": new _types__rspack_import_0.ComparatorExpression({
         comparator: "less-than-equals",
         negated: false,
         strict: false
     }),
-    "<==": new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    "<==": new _types__rspack_import_0.ComparatorExpression({
         comparator: "less-than-equals",
         negated: false,
         strict: true
     }),
-    ">": new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    ">": new _types__rspack_import_0.ComparatorExpression({
         comparator: "greater-than",
         negated: false,
         strict: false
     }),
-    "<": new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    "<": new _types__rspack_import_0.ComparatorExpression({
         comparator: "less-than",
         negated: false,
         strict: false
@@ -156,7 +224,7 @@ const ERROR_MESSAGES = {
 };
 const STRINGIFIED_COMPARE_OPERATORS = ["true", "false"];
 const parseUnknown = (value) => {
-    (0,_assertions__WEBPACK_IMPORTED_MODULE_1__.assertString)(value);
+    (0,_assertions__rspack_import_1.assertString)(value);
     return JSON.parse(value);
 };
 const combineExpressions = (...expressions) => {
@@ -170,7 +238,7 @@ const combineExpressions = (...expressions) => {
     let result = expressions[0];
     // Loop through remaining expressions and combine them
     for (let i = 1; i < expressions.length; i++) {
-        result = new _types__WEBPACK_IMPORTED_MODULE_0__.OperatorExpression({
+        result = new _types__rspack_import_0.OperatorExpression({
             operator: "&&",
             left: result,
             right: expressions[i]
@@ -215,13 +283,13 @@ const toExpression = (schema, fn, params) => {
         return parseExpressionToTree(schema, expression, parameterData);
     }
     catch (error) {
-        _utilities__WEBPACK_IMPORTED_MODULE_2__.logger.warn("Error parsing expression", {
+        _utilities__rspack_import_2.logger.warn("Error parsing expression", {
             error,
             collectionName: schema.collectionName,
             params,
             selector: stringifiedFunction
         });
-        return _types__WEBPACK_IMPORTED_MODULE_0__.Expression.NOT_PARSABLE;
+        return _types__rspack_import_0.Expression.NOT_PARSABLE;
     }
 };
 const parseExpressionToTree = (schema, expression, params) => {
@@ -280,7 +348,7 @@ const parseExpressionToTree = (schema, expression, params) => {
         if (operator) {
             const left = exp.slice(0, splitIndex).trim();
             const right = exp.slice(splitIndex + 2).trim();
-            return new _types__WEBPACK_IMPORTED_MODULE_0__.OperatorExpression({
+            return new _types__rspack_import_0.OperatorExpression({
                 operator,
                 left: parse(left),
                 right: parse(right)
@@ -394,7 +462,7 @@ const parseCondition = (schema, expression, params) => {
             }
             else {
                 // For other methods, return NOT_PARSABLE for now
-                return _types__WEBPACK_IMPORTED_MODULE_0__.Expression.NOT_PARSABLE;
+                return _types__rspack_import_0.Expression.NOT_PARSABLE;
             }
         }
         else {
@@ -471,7 +539,7 @@ const parseCondition = (schema, expression, params) => {
         const valueTransformMatch = transformMethodMatch[4].match(/^([^)]+)\.(toLowerCase|toUpperCase|toLocaleLowerCase|toLocaleUpperCase)\(\)$/);
         if (valueTransformMatch) {
             // Create a new ValueExpression with the base value and transformer
-            value = new _types__WEBPACK_IMPORTED_MODULE_0__.ValueExpression({
+            value = new _types__rspack_import_0.ValueExpression({
                 value: valueTransformMatch[1].replace(/^["']|["']$/g, '') // Remove quotes
             });
             // Set transformer and locale based on the method
@@ -600,7 +668,7 @@ const getComparator = (value) => {
         throw new Error(ERROR_MESSAGES.COMPARATOR_NOT_FOUND(value));
     }
     // Return a new instance to avoid modifying the cached one
-    return new _types__WEBPACK_IMPORTED_MODULE_0__.ComparatorExpression({
+    return new _types__rspack_import_0.ComparatorExpression({
         comparator: comparator.comparator,
         negated: comparator.negated,
         strict: comparator.strict
@@ -608,28 +676,28 @@ const getComparator = (value) => {
 };
 const getValue = (value, params) => {
     // Early return for string literals
-    if (value.startsWith("\'") || value.startsWith("\"")) {
-        return new _types__WEBPACK_IMPORTED_MODULE_0__.ValueExpression({
-            value: value.replace(/\"|\'/g, "")
+    if (value.startsWith("'") || value.startsWith("\"")) {
+        return new _types__rspack_import_0.ValueExpression({
+            value: value.replace(/"|'/g, "")
         });
     }
     // Early return for null/undefined
     if (value === "null") {
-        return new _types__WEBPACK_IMPORTED_MODULE_0__.ValueExpression({ value: null });
+        return new _types__rspack_import_0.ValueExpression({ value: null });
     }
     if (value === "undefined" || value === "void 0") {
-        return new _types__WEBPACK_IMPORTED_MODULE_0__.ValueExpression({ value: undefined });
+        return new _types__rspack_import_0.ValueExpression({ value: undefined });
     }
     // Optimized number parsing with early return
     const numValue = +value;
     if (!isNaN(numValue) && isFinite(numValue)) {
-        return new _types__WEBPACK_IMPORTED_MODULE_0__.ValueExpression({ value: numValue });
+        return new _types__rspack_import_0.ValueExpression({ value: numValue });
     }
     // Handle parameter paths if params are provided
     if (params != null) {
         // Check if this is a parameter path (starts with params.name)
         if (value.startsWith(params.name)) {
-            return new _types__WEBPACK_IMPORTED_MODULE_0__.ValueExpression({
+            return new _types__rspack_import_0.ValueExpression({
                 value: getValueFromParams(value, params)
             });
         }
@@ -641,16 +709,16 @@ const getValue = (value, params) => {
                 const potentialParamPath = paramMatch[1];
                 try {
                     const paramValue = getValueFromParams(`${params.name}.${potentialParamPath}`, params);
-                    return new _types__WEBPACK_IMPORTED_MODULE_0__.ValueExpression({ value: paramValue });
+                    return new _types__rspack_import_0.ValueExpression({ value: paramValue });
                 }
-                catch (e) {
+                catch {
                     // Not a parameter path, continue with normal parsing
                 }
             }
         }
     }
     if (STRINGIFIED_COMPARE_OPERATORS.includes(value)) {
-        return new _types__WEBPACK_IMPORTED_MODULE_0__.ValueExpression({ value });
+        return new _types__rspack_import_0.ValueExpression({ value });
     }
     if (isNaN(numValue)) {
         // value is a variable passed in by the dev, we cannot evaluate it's value
@@ -661,7 +729,7 @@ Example: .where(([x, params]) => x.id === params.id, { id: someVar.id })
 Issue At: ${value}`);
     }
     // Default case: return as-is
-    return new _types__WEBPACK_IMPORTED_MODULE_0__.ValueExpression({ value });
+    return new _types__rspack_import_0.ValueExpression({ value });
 };
 const getValueFromParams = (value, params) => {
     const split = value.split('.');
@@ -730,7 +798,7 @@ const getProperty = (schema, value, params) => {
                             throw new Error(ERROR_MESSAGES.PROPERTY_NOT_FOUND(value));
                         }
                     }
-                    catch (e) {
+                    catch {
                         // Not a valid parameter path, continue to error
                         throw new Error(ERROR_MESSAGES.PROPERTY_NOT_FOUND(value));
                     }
@@ -764,16 +832,288 @@ const getProperty = (schema, value, params) => {
     if (found == null) {
         throw new Error(ERROR_MESSAGES.PROPERTY_NOT_FOUND(value));
     }
-    return new _types__WEBPACK_IMPORTED_MODULE_0__.PropertyExpression({ property: found });
+    return new _types__rspack_import_0.PropertyExpression({ property: found });
+};
+
+
+},
+"./src/expressions/sql.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+  getDialect: () => (getDialect),
+  toSql: () => (toSql)
+});
+/* import */ var _assertions__rspack_import_0 = __webpack_require__("./src/assertions/index.ts");
+
+const DIALECTS = {
+    sqlite: {
+        quoteIdentifier(name) {
+            return `"${name.replace(/"/g, '""')}"`;
+        },
+        getPlaceholder(_i) {
+            return "?";
+        },
+        stringMatchKind: "GLOB",
+        likeEscapeClause() {
+            return "";
+        },
+    },
+    postgresql: {
+        quoteIdentifier(name) {
+            return `"${name.replace(/"/g, '""')}"`;
+        },
+        getPlaceholder(i) {
+            return `$${i + 1}`;
+        },
+        stringMatchKind: "LIKE",
+        likeEscapeClause() {
+            return " ESCAPE E'\\\\'";
+        },
+    },
+    mysql: {
+        quoteIdentifier(name) {
+            return "`" + name.replace(/`/g, "``") + "`";
+        },
+        getPlaceholder(_i) {
+            return "?";
+        },
+        stringMatchKind: "LIKE",
+        likeEscapeClause() {
+            return " ESCAPE '\\\\'";
+        },
+    },
+    mssql: {
+        quoteIdentifier(name) {
+            return "[" + name.replace(/]/g, "]]") + "]";
+        },
+        getPlaceholder(i) {
+            return `@p${i + 1}`;
+        },
+        stringMatchKind: "LIKE",
+        likeEscapeClause() {
+            return " ESCAPE '\\\\'";
+        },
+    },
+};
+function getDialect(name) {
+    const d = DIALECTS[name];
+    if (!d)
+        throw new Error(`Unknown SQL dialect: ${name}`);
+    return d;
+}
+function escapeLikeLiteral(value) {
+    return value.replace(/\\/g, "\\\\").replace(/%/g, "\\%").replace(/_/g, "\\_");
+}
+function escapeGlobLiteral(value) {
+    return value.replace(/\\/g, "\\\\").replace(/\*/g, "\\*").replace(/\?/g, "\\?");
+}
+function escapeForPattern(value, kind) {
+    return kind === "LIKE" ? escapeLikeLiteral(value) : escapeGlobLiteral(value);
+}
+function buildPattern(escapedValue, match, kind) {
+    if (kind === "LIKE") {
+        switch (match) {
+            case "contains":
+                return `%${escapedValue}%`;
+            case "starts-with":
+                return `${escapedValue}%`;
+            case "ends-with":
+                return `%${escapedValue}`;
+        }
+    }
+    switch (match) {
+        case "contains":
+            return `*${escapedValue}*`;
+        case "starts-with":
+            return `${escapedValue}*`;
+        case "ends-with":
+            return `*${escapedValue}`;
+    }
+}
+function getPropertyValueSides(cmp) {
+    const propLeft = cmp.left && (0,_assertions__rspack_import_0.isPropertyExpression)(cmp.left) ? cmp.left : null;
+    const propRight = cmp.right && (0,_assertions__rspack_import_0.isPropertyExpression)(cmp.right) ? cmp.right : null;
+    const valLeft = cmp.left && (0,_assertions__rspack_import_0.isValueExpression)(cmp.left) ? cmp.left.value : null;
+    const valRight = cmp.right && (0,_assertions__rspack_import_0.isValueExpression)(cmp.right) ? cmp.right.value : null;
+    return { propLeft, propRight, valLeft, valRight };
+}
+function getEqualsCase(value, columnOnLeft, columnOnRight) {
+    if (value === null && columnOnLeft)
+        return "null-column-left";
+    if (value === null && columnOnRight)
+        return "null-column-right";
+    if (value !== null && columnOnLeft)
+        return "value-column-left";
+    if (value !== null && columnOnRight)
+        return "value-column-right";
+    return null;
+}
+function equalsNullColumnLeft(ctx) {
+    return ctx.negated ? `${ctx.col} IS NOT NULL` : `${ctx.col} IS NULL`;
+}
+function equalsNullColumnRight(ctx) {
+    ctx.params.push(null);
+    const ph = ctx.placeholder();
+    return ctx.negated ? `${ph} IS NOT NULL` : `${ph} IS NULL`;
+}
+function equalsValueColumnLeft(ctx) {
+    ctx.params.push(ctx.value);
+    const ph = ctx.placeholder();
+    return ctx.negated ? `${ctx.col} != ${ph}` : `${ctx.col} = ${ph}`;
+}
+function equalsValueColumnRight(ctx) {
+    ctx.params.push(ctx.value);
+    const ph = ctx.placeholder();
+    return ctx.negated ? `${ph} != ${ctx.col}` : `${ph} = ${ctx.col}`;
+}
+const EQUALS_STRATEGIES = {
+    "null-column-left": equalsNullColumnLeft,
+    "null-column-right": equalsNullColumnRight,
+    "value-column-left": equalsValueColumnLeft,
+    "value-column-right": equalsValueColumnRight,
 };
+// --- String-pattern comparison (includes / starts-with / ends-with) ---
+function renderStringPatternComparison(cmp, d, params, placeholder) {
+    const { propLeft, propRight, valLeft, valRight } = getPropertyValueSides(cmp);
+    const kind = d.stringMatchKind;
+    if (cmp.comparator === "includes") {
+        const col = propLeft && valRight !== null
+            ? d.quoteIdentifier(propLeft.property.name)
+            : propRight && valLeft !== null
+                ? d.quoteIdentifier(propRight.property.name)
+                : null;
+        const value = valRight !== null ? valRight : valLeft;
+        if (col === null) {
+            throw new Error("Complex expressions not supported for includes operations");
+        }
+        if (Array.isArray(value)) {
+            const placeholders = value.map(() => placeholder()).join(", ");
+            params.push(...value);
+            return cmp.negated ? `${col} NOT IN (${placeholders})` : `${col} IN (${placeholders})`;
+        }
+        const escaped = escapeForPattern(String(value), kind);
+        const pattern = buildPattern(escaped, "contains", kind);
+        params.push(pattern);
+        const ph = placeholder();
+        const op = kind === "GLOB" ? "GLOB" : "LIKE";
+        const escape = kind === "LIKE" ? d.likeEscapeClause() : "";
+        if (propLeft && valRight !== null) {
+            return cmp.negated ? `${col} NOT ${op} ${ph}${escape}` : `${col} ${op} ${ph}${escape}`;
+        }
+        return cmp.negated ? `${ph} NOT ${op} ${col}${escape}` : `${ph} ${op} ${col}${escape}`;
+    }
+    const col = propLeft && valRight !== null
+        ? d.quoteIdentifier(propLeft.property.name)
+        : propRight && valLeft !== null
+            ? d.quoteIdentifier(propRight.property.name)
+            : null;
+    const value = valRight !== null ? String(valRight) : valLeft !== null ? String(valLeft) : null;
+    if (col === null || value === null) {
+        throw new Error(`Complex expressions not supported for ${cmp.comparator} operations`);
+    }
+    const escaped = escapeForPattern(value, kind);
+    const pattern = buildPattern(escaped, cmp.comparator === "starts-with" ? "starts-with" : "ends-with", kind);
+    params.push(pattern);
+    const ph = placeholder();
+    const op = kind === "GLOB" ? "GLOB" : "LIKE";
+    const escape = kind === "LIKE" ? d.likeEscapeClause() : "";
+    if (propLeft && valRight !== null) {
+        return cmp.negated ? `${col} NOT ${op} ${ph}${escape}` : `${col} ${op} ${ph}${escape}`;
+    }
+    return cmp.negated ? `${ph} NOT ${op} ${col}${escape}` : `${ph} ${op} ${col}${escape}`;
+}
+// --- Generic comparison ---
+function renderGenericComparison(cmp, walk) {
+    const leftExpr = walk(cmp.left);
+    const rightExpr = walk(cmp.right);
+    switch (cmp.comparator) {
+        case "equals":
+            return cmp.negated ? `${leftExpr} != ${rightExpr}` : `${leftExpr} = ${rightExpr}`;
+        case "greater-than":
+            return cmp.negated ? `${leftExpr} <= ${rightExpr}` : `${leftExpr} > ${rightExpr}`;
+        case "greater-than-equals":
+            return cmp.negated ? `${leftExpr} < ${rightExpr}` : `${leftExpr} >= ${rightExpr}`;
+        case "less-than":
+            return cmp.negated ? `${leftExpr} >= ${rightExpr}` : `${leftExpr} < ${rightExpr}`;
+        case "less-than-equals":
+            return cmp.negated ? `${leftExpr} > ${rightExpr}` : `${leftExpr} <= ${rightExpr}`;
+        default:
+            throw new Error(`Unsupported comparator: ${cmp.comparator}`);
+    }
+}
+/**
+ * Converts an Expression to a SQL WHERE clause and bound parameters for the given dialect.
+ */
+function toSql(expr, dialect) {
+    const d = typeof dialect === "string" ? getDialect(dialect) : dialect;
+    const params = [];
+    let paramIndex = 0;
+    function placeholder() {
+        const p = d.getPlaceholder(paramIndex);
+        paramIndex += 1;
+        return p;
+    }
+    /** Visitor: map each expression node type to a SQL fragment. */
+    function walk(e) {
+        if ((0,_assertions__rspack_import_0.isOperatorExpression)(e)) {
+            const left = e.left ? walk(e.left) : "";
+            const right = e.right ? walk(e.right) : "";
+            const sqlOp = e.operator === "&&" ? "AND" : e.operator === "||" ? "OR" : e.operator;
+            return `(${left} ${sqlOp} ${right})`;
+        }
+        if ((0,_assertions__rspack_import_0.isComparatorExpression)(e)) {
+            const cmp = e;
+            const isStringPattern = cmp.comparator === "starts-with" ||
+                cmp.comparator === "ends-with" ||
+                cmp.comparator === "includes";
+            if (isStringPattern) {
+                /* String pattern: includes / starts-with / ends-with → one renderer. */
+                return renderStringPatternComparison(cmp, d, params, placeholder);
+            }
+            if (cmp.comparator === "equals") {
+                /* Equals: Strategy per (column-side, null vs value) case. */
+                const { propLeft, propRight, valLeft, valRight } = getPropertyValueSides(cmp);
+                const col = propLeft && (valRight !== undefined || propRight)
+                    ? d.quoteIdentifier(propLeft.property.name)
+                    : propRight && (valLeft !== undefined || propLeft)
+                        ? d.quoteIdentifier(propRight.property.name)
+                        : null;
+                const value = valRight !== undefined ? valRight : valLeft;
+                const columnOnLeft = Boolean(propLeft && cmp.right && (0,_assertions__rspack_import_0.isValueExpression)(cmp.right));
+                const columnOnRight = Boolean(propRight && cmp.left && (0,_assertions__rspack_import_0.isValueExpression)(cmp.left));
+                if (col !== null && value !== undefined) {
+                    const caseKey = getEqualsCase(value, columnOnLeft, columnOnRight);
+                    if (caseKey !== null) {
+                        const strategy = EQUALS_STRATEGIES[caseKey];
+                        return strategy({
+                            col,
+                            value,
+                            negated: cmp.negated,
+                            params,
+                            placeholder,
+                        });
+                    }
+                }
+            }
+            /* Generic: walk both sides and emit comparison operator. */
+            return renderGenericComparison(cmp, walk);
+        }
+        if ((0,_assertions__rspack_import_0.isPropertyExpression)(e)) {
+            return d.quoteIdentifier(e.property.name);
+        }
+        if ((0,_assertions__rspack_import_0.isValueExpression)(e)) {
+            params.push(e.value);
+            return placeholder();
+        }
+        throw new Error(`Unknown expression type: ${e.type}`);
+    }
+    const where = walk(expr);
+    return { where, params };
+}
 
 
-}),
-"./src/expressions/types.ts": 
-/*!**********************************!*\
-  !*** ./src/expressions/types.ts ***!
-  \**********************************/
-(function (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+},
+"./src/expressions/types.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   ComparatorExpression: () => (ComparatorExpression),
@@ -879,17 +1219,12 @@ class ValueExpression extends Expression {
 }
 
 
-}),
-"./src/expressions/utils.ts": 
-/*!**********************************!*\
-  !*** ./src/expressions/utils.ts ***!
-  \**********************************/
-(function (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+},
+"./src/expressions/utils.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   forEach: () => (forEach),
-  getProperties: () => (getProperties),
-  isPropertyExpression: () => (isPropertyExpression)
+  getProperties: () => (getProperties)
 });
 /**
  * Extracts all properties referenced in an expression
@@ -914,9 +1249,6 @@ function getProperties(expression) {
     traverse(expression);
     return properties;
 }
-function isPropertyExpression(expression) {
-    return expression.type === "property";
-}
 function forEach(expression, callback) {
     function traverse(expr) {
         // Call the callback for this expression
@@ -941,12 +1273,8 @@ function forEach(expression, callback) {
 }
 
 
-}),
-"./src/utilities/dates.ts": 
-/*!********************************!*\
-  !*** ./src/utilities/dates.ts ***!
-  \********************************/
-(function (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+},
+"./src/utilities/dates.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   isDate: () => (isDate)
@@ -962,26 +1290,33 @@ const isDate = (data) => {
 };
 
 
-}),
-"./src/utilities/logger.ts": 
-/*!*********************************!*\
-  !*** ./src/utilities/logger.ts ***!
-  \*********************************/
-(function (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+},
+"./src/utilities/logger.ts"(__unused_rspack_module, __webpack_exports__, __webpack_require__) {
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
   logger: () => (logger)
 });
-const isDevelopment = () => {
-    if (typeof process === 'undefined' || process.env == null) {
-        return false;
+/**
+ * Enable logging by setting `globalThis.__ROUTIER_DEBUG__ = true` before any routier code runs.
+ */
+const shouldLog = () => {
+    if (typeof globalThis !== 'undefined') {
+        const g = globalThis;
+        if (g.__ROUTIER_DEBUG__ === true)
+            return true;
     }
-    const env = "development"?.toLowerCase();
-    return env === 'dev' || env === 'development' || env === 'test';
+    if (typeof process !== 'undefined' && process.env != null) {
+        const debug = process.env.DEBUG;
+        if (debug === 'routier' || debug === '*')
+            return true;
+        const env = "development"?.toLowerCase();
+        if (env === 'dev' || env === 'development' || env === 'test')
+            return true;
+    }
+    return false;
 };
-const shouldLog = isDevelopment();
 const tryLog = (type, ...args) => {
-    if (shouldLog) {
+    if (shouldLog()) {
         console[type](...args);
     }
 };
@@ -1007,10 +1342,9 @@ const logger = {
 };
 
 
-}),
+},
 
 });
-/************************************************************************/
 // The module cache
 var __webpack_module_cache__ = {};
 
@@ -1034,7 +1368,6 @@ return module.exports;
 
 }
 
-/************************************************************************/
 // webpack/runtime/define_property_getters
 (() => {
 __webpack_require__.d = (exports, definition) => {
@@ -1059,32 +1392,33 @@ __webpack_require__.r = (exports) => {
 	Object.defineProperty(exports, '__esModule', { value: true });
 };
 })();
-/************************************************************************/
 var __webpack_exports__ = {};
 // This entry needs to be wrapped in an IIFE because it needs to be isolated against other modules in the chunk.
 (() => {
-
-/*!**********************************!*\
-  !*** ./src/expressions/index.ts ***!
-  \**********************************/
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-  ComparatorExpression: () => (/* reexport safe */ _types__WEBPACK_IMPORTED_MODULE_1__.ComparatorExpression),
-  EmptyExpression: () => (/* reexport safe */ _types__WEBPACK_IMPORTED_MODULE_1__.EmptyExpression),
-  Expression: () => (/* reexport safe */ _types__WEBPACK_IMPORTED_MODULE_1__.Expression),
-  NotParsableExpression: () => (/* reexport safe */ _types__WEBPACK_IMPORTED_MODULE_1__.NotParsableExpression),
-  OperatorExpression: () => (/* reexport safe */ _types__WEBPACK_IMPORTED_MODULE_1__.OperatorExpression),
-  PropertyExpression: () => (/* reexport safe */ _types__WEBPACK_IMPORTED_MODULE_1__.PropertyExpression),
-  ValueExpression: () => (/* reexport safe */ _types__WEBPACK_IMPORTED_MODULE_1__.ValueExpression),
-  combineExpressions: () => (/* reexport safe */ _parser__WEBPACK_IMPORTED_MODULE_0__.combineExpressions),
-  forEach: () => (/* reexport safe */ _utils__WEBPACK_IMPORTED_MODULE_2__.forEach),
-  getProperties: () => (/* reexport safe */ _utils__WEBPACK_IMPORTED_MODULE_2__.getProperties),
-  isPropertyExpression: () => (/* reexport safe */ _utils__WEBPACK_IMPORTED_MODULE_2__.isPropertyExpression),
-  toExpression: () => (/* reexport safe */ _parser__WEBPACK_IMPORTED_MODULE_0__.toExpression)
+  ComparatorExpression: () => (/* reexport safe */ _types__rspack_import_2.ComparatorExpression),
+  EXPRESSION_TYPES: () => (/* reexport safe */ _constants__rspack_import_4.EXPRESSION_TYPES),
+  EmptyExpression: () => (/* reexport safe */ _types__rspack_import_2.EmptyExpression),
+  Expression: () => (/* reexport safe */ _types__rspack_import_2.Expression),
+  NotParsableExpression: () => (/* reexport safe */ _types__rspack_import_2.NotParsableExpression),
+  OperatorExpression: () => (/* reexport safe */ _types__rspack_import_2.OperatorExpression),
+  PropertyExpression: () => (/* reexport safe */ _types__rspack_import_2.PropertyExpression),
+  ValueExpression: () => (/* reexport safe */ _types__rspack_import_2.ValueExpression),
+  combineExpressions: () => (/* reexport safe */ _parser__rspack_import_0.combineExpressions),
+  forEach: () => (/* reexport safe */ _utils__rspack_import_3.forEach),
+  getDialect: () => (/* reexport safe */ _sql__rspack_import_1.getDialect),
+  getProperties: () => (/* reexport safe */ _utils__rspack_import_3.getProperties),
+  toExpression: () => (/* reexport safe */ _parser__rspack_import_0.toExpression),
+  toSql: () => (/* reexport safe */ _sql__rspack_import_1.toSql)
 });
-/* ESM import */var _parser__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./parser */ "./src/expressions/parser.ts");
-/* ESM import */var _types__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./types */ "./src/expressions/types.ts");
-/* ESM import */var _utils__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(/*! ./utils */ "./src/expressions/utils.ts");
+/* import */ var _parser__rspack_import_0 = __webpack_require__("./src/expressions/parser.ts");
+/* import */ var _sql__rspack_import_1 = __webpack_require__("./src/expressions/sql.ts");
+/* import */ var _types__rspack_import_2 = __webpack_require__("./src/expressions/types.ts");
+/* import */ var _utils__rspack_import_3 = __webpack_require__("./src/expressions/utils.ts");
+/* import */ var _constants__rspack_import_4 = __webpack_require__("./src/expressions/constants.ts");
+
+
 
 
 
@@ -1092,6 +1426,7 @@ __webpack_require__.d(__webpack_exports__, {
 })();
 
 var __webpack_exports__ComparatorExpression = __webpack_exports__.ComparatorExpression;
+var __webpack_exports__EXPRESSION_TYPES = __webpack_exports__.EXPRESSION_TYPES;
 var __webpack_exports__EmptyExpression = __webpack_exports__.EmptyExpression;
 var __webpack_exports__Expression = __webpack_exports__.Expression;
 var __webpack_exports__NotParsableExpression = __webpack_exports__.NotParsableExpression;
@@ -1100,9 +1435,10 @@ var __webpack_exports__PropertyExpression = __webpack_exports__.PropertyExpressi
 var __webpack_exports__ValueExpression = __webpack_exports__.ValueExpression;
 var __webpack_exports__combineExpressions = __webpack_exports__.combineExpressions;
 var __webpack_exports__forEach = __webpack_exports__.forEach;
+var __webpack_exports__getDialect = __webpack_exports__.getDialect;
 var __webpack_exports__getProperties = __webpack_exports__.getProperties;
-var __webpack_exports__isPropertyExpression = __webpack_exports__.isPropertyExpression;
 var __webpack_exports__toExpression = __webpack_exports__.toExpression;
-export { __webpack_exports__ComparatorExpression as ComparatorExpression, __webpack_exports__EmptyExpression as EmptyExpression, __webpack_exports__Expression as Expression, __webpack_exports__NotParsableExpression as NotParsableExpression, __webpack_exports__OperatorExpression as OperatorExpression, __webpack_exports__PropertyExpression as PropertyExpression, __webpack_exports__ValueExpression as ValueExpression, __webpack_exports__combineExpressions as combineExpressions, __webpack_exports__forEach as forEach, __webpack_exports__getProperties as getProperties, __webpack_exports__isPropertyExpression as isPropertyExpression, __webpack_exports__toExpression as toExpression };
+var __webpack_exports__toSql = __webpack_exports__.toSql;
+export { __webpack_exports__ComparatorExpression as ComparatorExpression, __webpack_exports__EXPRESSION_TYPES as EXPRESSION_TYPES, __webpack_exports__EmptyExpression as EmptyExpression, __webpack_exports__Expression as Expression, __webpack_exports__NotParsableExpression as NotParsableExpression, __webpack_exports__OperatorExpression as OperatorExpression, __webpack_exports__PropertyExpression as PropertyExpression, __webpack_exports__ValueExpression as ValueExpression, __webpack_exports__combineExpressions as combineExpressions, __webpack_exports__forEach as forEach, __webpack_exports__getDialect as getDialect, __webpack_exports__getProperties as getProperties, __webpack_exports__toExpression as toExpression, __webpack_exports__toSql as toSql };
 
 //# sourceMappingURL=index.js.map