@truto/sqlite-builder 1.0.1 → 1.0.2

package/README.md

@@ -17,6 +17,7 @@
 - 🌍 **Universal**: Works in Bun, Node.js, Deno, and modern browsers
 - 🎯 **TypeScript-first**: Full type safety with excellent IDE support
 - 🔧 **Helper functions**: Built-in utilities for identifiers, IN clauses, and more
+- 🔍 **JSON Filter Language**: MongoDB-style JSON filters for WHERE clauses
 - ⚡ **Lightweight**: Minimal bundle size with tree-shaking support
 
 ## 📦 Installation
@@ -41,7 +42,7 @@ pnpm add @truto/sqlite-builder
 
 ```typescript
 import sqlite3 from 'better-sqlite3'
-import { sql } from '@truto/sqlite-builder'
+import { sql, compileFilter } from '@truto/sqlite-builder'
 
 const db = new sqlite3('database.db')
 
@@ -50,14 +51,17 @@ const name = 'Alice'
 const { text, values } = sql`SELECT * FROM users WHERE name = ${name}`
 const users = db.prepare(text).all(...values)
 
-// Complex query with helpers
-const userIds = [1, 2, 3]
+// JSON Filter queries
+const filter = {
+  name: { like: 'John%' },
+  age: { gte: 18, lt: 65 },
+  or: [{ email: { regex: '.*@example.com$' } }, { phone: { exists: false } }],
+}
+
+const { text: whereText, values: whereValues } = compileFilter(filter)
 const query = sql`
-  SELECT u.*, p.title 
-  FROM ${sql.ident('users')} u
-  JOIN ${sql.ident('posts')} p ON u.id = p.user_id
-  WHERE u.id IN ${sql.in(userIds)}
-    AND u.status = ${'active'}
+  SELECT * FROM users
+  WHERE ${sql.raw(whereText)}
 `
 
 const results = db.prepare(query.text).all(...query.values)
@@ -170,6 +174,251 @@ const query = sql`SELECT * FROM users WHERE ${sql.join(conditions, ' AND ')}`
 // Returns: { text: "SELECT * FROM users WHERE name = ? AND age = ? AND active = ?", values: ['John', 30, true] }
 ```
 
+## 🔍 JSON Filter Language
+
+Build complex WHERE clauses using MongoDB-style JSON filters. Perfect for APIs and dynamic queries.
+
+### `compileFilter(filter: JsonFilter): FilterResult`
+
+Compiles a JSON filter object into a parameterized SQL WHERE clause.
+
+```typescript
+import { compileFilter } from '@truto/sqlite-builder'
+
+const filter = {
+  status: 'ACTIVE',
+  age: { gte: 18, lt: 65 },
+}
+
+const result = compileFilter(filter)
+// Returns: { text: '(("status" = ? AND "age" >= ? AND "age" < ?))', values: ['ACTIVE', 18, 65] }
+
+// Use with the main sql template
+const query = sql`
+  SELECT * FROM users
+  WHERE ${sql.raw(result.text)}
+`
+```
+
+### Supported Operators
+
+| Operator Family           | JSON Form                             | SQL Fragment                             | Description                         |
+| ------------------------- | ------------------------------------- | ---------------------------------------- | ----------------------------------- |
+| **Equality**              | `"field": value`                      | `"field" = ?`                            | Direct value comparison             |
+| **Inequality**            | `"field": { "ne": value }`            | `"field" <> ?`                           | Not equal comparison                |
+| **Comparison**            | `"field": { "gt": value }`            | `"field" > ?`                            | Greater than, gte, lt, lte          |
+| **Set Membership**        | `"field": { "in": [1, 2, 3] }`        | `"field" IN (?,?,?)`                     | Value in array                      |
+| **Negative Set**          | `"field": { "nin": [1, 2] }`          | `"field" NOT IN (?,?)`                   | Value not in array                  |
+| **NULL Checks**           | `"field": { "exists": false }`        | `"field" IS NULL`                        | Check for NULL/NOT NULL             |
+| **LIKE Patterns**         | `"field": { "like": "john%" }`        | `"field" LIKE ?`                         | Pattern matching                    |
+| **Case-insensitive LIKE** | `"field": { "ilike": "%DOE%" }`       | `"field" LIKE ? COLLATE NOCASE`          | Case-insensitive patterns           |
+| **Regular Expressions**   | `"field": { "regex": "^[A-Z]+" }`     | `"field" REGEXP ?`                       | Regex patterns (requires extension) |
+| **Logical AND**           | `"and": [filter1, filter2]`           | `(filter1 AND filter2)`                  | All conditions must match           |
+| **Logical OR**            | `"or": [filter1, filter2]`            | `(filter1 OR filter2)`                   | Any condition must match            |
+| **JSON Path**             | `"profile.email": "test@example.com"` | `json_extract("profile", '$.email') = ?` | Query JSON column fields            |
+
+### Filter Examples
+
+#### Basic Operations
+
+```typescript
+// Equality and comparison
+const filter1 = {
+  status: 'ACTIVE',
+  age: { gte: 18, lt: 65 },
+  score: { gt: 80, lte: 100 },
+}
+// SQL: (("status" = ? AND "age" >= ? AND "age" < ? AND "score" > ? AND "score" <= ?))
+
+// Set membership
+const filter2 = {
+  role: { in: ['ADMIN', 'EDITOR'] },
+  department: { nin: ['ARCHIVED', 'DELETED'] },
+}
+// SQL: (("role" IN (?,?) AND "department" NOT IN (?,?)))
+
+// NULL checks
+const filter3 = {
+  email: { exists: true }, // IS NOT NULL
+  deleted_at: { exists: false }, // IS NULL
+}
+// SQL: (("email" IS NOT NULL AND "deleted_at" IS NULL))
+```
+
+#### Pattern Matching
+
+```typescript
+// LIKE patterns
+const filter4 = {
+  username: { like: 'john%' }, // Starts with 'john'
+  email: { ilike: '%@EXAMPLE.COM%' }, // Case-insensitive contains
+}
+// SQL: (("username" LIKE ? AND "email" LIKE ? COLLATE NOCASE))
+
+// Regular expressions (requires REGEXP extension)
+const filter5 = {
+  email: { regex: '^[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\\.[A-Za-z]{2,}$' },
+  phone: { regex: '^\\+1[0-9]{10}$' },
+}
+// SQL: (("email" REGEXP ? AND "phone" REGEXP ?))
+```
+
+#### Logical Operators
+
+```typescript
+// AND operator (explicit)
+const filter6 = {
+  and: [
+    { status: 'ACTIVE' },
+    { age: { gte: 18 } },
+    { country: { in: ['US', 'CA', 'GB'] } },
+  ],
+}
+// SQL: ((("status" = ?) AND ("age" >= ?) AND ("country" IN (?,?,?))))
+
+// OR operator
+const filter7 = {
+  or: [
+    { age: { lt: 18 } }, // Minors
+    { age: { gte: 65 } }, // Seniors
+  ],
+}
+// SQL: ((("age" < ?) OR ("age" >= ?)))
+
+// Mixed AND/OR logic
+const filter8 = {
+  status: 'ACTIVE', // Implicit AND
+  or: [{ tags: { ilike: '%urgent%' } }, { priority: { gte: 8 } }],
+}
+// SQL: (((("tags" LIKE ? COLLATE NOCASE) OR ("priority" >= ?)) AND ("status" = ?)))
+```
+
+#### JSON Path Querying
+
+For SQLite JSON columns, use dot notation to query nested fields:
+
+```typescript
+// Query JSON fields
+const filter9 = {
+  'profile.email': { regex: '.*@example\\.org$' },
+  'profile.age': { gte: 21 },
+  'settings.theme': { in: ['dark', 'light'] },
+  'metadata.tags': { exists: true },
+}
+// SQL: ((json_extract("profile", '$.email') REGEXP ? AND
+//        json_extract("profile", '$.age') >= ? AND
+//        json_extract("settings", '$.theme') IN (?,?) AND
+//        json_extract("metadata", '$.tags') IS NOT NULL))
+
+// Complex nested JSON query
+const filter10 = {
+  and: [
+    { 'user.profile.email': { regex: '.*@company\\.com$' } },
+    { or: [{ 'user.role': 'ADMIN' }, { 'user.permissions.canEdit': true }] },
+  ],
+}
+```
+
+#### Kitchen Sink Examples
+
+Real-world complex filters:
+
+```typescript
+// Active users in specific regions, either minors/seniors or VIP
+const complexFilter = {
+  and: [
+    { status: 'ACTIVE' },
+    { or: [{ age: { lt: 18 } }, { age: { gte: 65 } }, { membership: 'VIP' }] },
+    { country: { in: ['US', 'CA', 'GB'] } },
+    { email: { exists: true } },
+    { 'profile.verified': true },
+  ],
+}
+
+// Content filtering with multiple criteria
+const contentFilter = {
+  name: { like: 'Project%' },
+  category: { nin: ['ARCHIVED', 'DELETED', 'SPAM'] },
+  created_at: { exists: true },
+  or: [
+    { tags: { ilike: '%important%' } },
+    { priority: { gte: 8 } },
+    { 'metadata.featured': true },
+  ],
+}
+```
+
+### Integration with SQL Template
+
+```typescript
+import { sql, compileFilter } from '@truto/sqlite-builder'
+
+// Build the WHERE clause
+const filter = {
+  status: 'ACTIVE',
+  age: { gte: 18 },
+  role: { in: ['USER', 'ADMIN'] },
+}
+
+const whereClause = compileFilter(filter)
+
+// Use in complete query
+const query = sql`
+  SELECT id, name, email, created_at
+  FROM users
+  WHERE ${sql.raw(whereClause.text)}
+  ORDER BY created_at DESC
+  LIMIT ${limit}
+`
+
+// Execute with driver
+const results = db.prepare(query.text).all(...query.values)
+```
+
+### Security & Validation
+
+The JSON filter compiler includes comprehensive security measures:
+
+- **Operator validation**: Only known operators are allowed
+- **Identifier safety**: Field names are validated using the same rules as `sql.ident()`
+- **Array limits**: IN/NIN arrays limited to 999 items (SQLite limitation)
+- **DoS protection**: Nesting depth ≤ 10, total operators ≤ 100
+- **Type validation**: Strict type checking for all operator values
+- **SQL injection prevention**: All values are parameterized
+
+```typescript
+// ❌ These will throw errors
+compileFilter({ age: { unknown: 18 } }) // Unknown operator
+compileFilter({ 'user; DROP TABLE': 'value' }) // Invalid identifier
+compileFilter({ role: { in: [] } }) // Empty array
+compileFilter({ role: { in: new Array(1000).fill('x') } }) // Too large array
+
+// ✅ These are safe and valid
+compileFilter({ age: { gte: 18, lte: 65 } }) // Multiple operators
+compileFilter({ 'profile.email': { exists: true } }) // JSON path
+compileFilter({ or: [{ x: 1 }, { y: 2 }] }) // Logical operators
+```
+
+### REGEXP Extension
+
+To use the `regex` operator, you need to load a REGEXP extension in SQLite:
+
+```typescript
+// With better-sqlite3
+import sqlite3 from 'better-sqlite3'
+
+const db = new sqlite3('database.db')
+
+// Load REGEXP extension (varies by implementation)
+// This is implementation-specific - check your SQLite setup
+db.loadExtension('regexp') // Example - actual method may vary
+
+// Now regex filters work
+const filter = {
+  email: { regex: '^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$' },
+}
+```
+
 ## 🛡️ Security Model
 
 ### What's Protected
@@ -178,6 +427,7 @@ const query = sql`SELECT * FROM users WHERE ${sql.join(conditions, ' AND ')}`
 - **Stacked Queries**: Queries containing `;` followed by additional SQL are rejected
 - **Identifier Safety**: `sql.ident()` validates against ANSI identifier rules
 - **Length Limits**: Queries exceeding 100KB are rejected
+- **Filter Security**: JSON filters validate operators, identifiers, and enforce limits
 
 ### What's Your Responsibility
 
@@ -185,6 +435,7 @@ const query = sql`SELECT * FROM users WHERE ${sql.join(conditions, ' AND ')}`
 - **Validate identifiers before using `sql.ident()`** (though it has built-in validation)
 - **Use `sql.in()` instead of string concatenation** for arrays
 - **Keep your SQLite driver updated**
+- **Load REGEXP extension safely** if using regex filters
 
 ### Supported Value Types
 
@@ -273,6 +524,36 @@ const complexColumns = [
 const complexQuery = sql`SELECT ${sql.join(complexColumns)} FROM users`
 ```
 
+### Dynamic Queries with JSON Filters
+
+```typescript
+import { sql, compileFilter } from '@truto/sqlite-builder'
+
+// API endpoint that accepts JSON filter
+app.get('/api/users', (req, res) => {
+  // User sends filter as JSON
+  const filter = req.body.filter || {}
+
+  // Safely compile to SQL
+  const whereClause = compileFilter(filter)
+
+  const query = sql`
+    SELECT id, name, email, created_at
+    FROM users
+    WHERE ${sql.raw(whereClause.text)}
+    ORDER BY created_at DESC
+    LIMIT ${req.query.limit || 20}
+  `
+
+  const users = db.prepare(query.text).all(...query.values)
+  res.json(users)
+})
+
+// Example API calls:
+// POST /api/users { "filter": { "status": "ACTIVE", "age": { "gte": 18 } } }
+// POST /api/users { "filter": { "or": [{ "role": "ADMIN" }, { "verified": true }] } }
+```
+
 ### Array Identifiers & Qualified Identifiers
 
 The `sql.ident()` function supports simple identifiers, qualified identifiers (table.column), arrays, and mixed arrays with SQL fragments:

package/dist/filter.d.ts

@@ -0,0 +1,6 @@
+import type { FilterResult, JsonFilter } from './types';
+/**
+ * Compile a JSON filter to a SQL WHERE clause
+ */
+export declare function compileFilter(filter: JsonFilter): FilterResult;
+//# sourceMappingURL=filter.d.ts.map

package/dist/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,YAAY,EACZ,UAAU,EACX,MAAM,SAAS,CAAA;AA+UhB;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,CAa9D"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 /**
  * truto-sqlite-builder - Safe, zero-dependency template-literal tag for SQLite queries
  */
+export { compileFilter } from './filter';
 export { sql } from './sql';
-export type { SqlQuery } from './types';
+export type { FilterResult, JsonFilter, SqlQuery } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAC3B,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -149,9 +149,246 @@ sql.in = sqlIn;
 sql.raw = sqlRaw;
 sql.blob = sqlBlob;
 sql.join = sqlJoin;
+
+// src/filter.ts
+var MAX_NESTING_DEPTH = 10;
+var MAX_OPERATORS = 100;
+var VALID_OPERATORS = new Set([
+  "gt",
+  "gte",
+  "lt",
+  "lte",
+  "ne",
+  "in",
+  "nin",
+  "like",
+  "ilike",
+  "regex",
+  "exists",
+  "and",
+  "or"
+]);
+function isJsonPath(field) {
+  return field.includes(".");
+}
+function compileJsonPath(field) {
+  const parts = field.split(".");
+  const columnName = parts[0];
+  const jsonPath = parts.slice(1);
+  if (!columnName || jsonPath.length === 0 || jsonPath.some((part) => !part)) {
+    throw new SyntaxError(`Invalid JSON path: ${field}`);
+  }
+  return {
+    columnName,
+    jsonPath: "$." + jsonPath.join(".")
+  };
+}
+function compileFieldCondition(field, condition, context) {
+  if (condition === null || condition === undefined || typeof condition === "string" || typeof condition === "number" || typeof condition === "boolean" || condition instanceof Date) {
+    context.operatorCount++;
+    if (context.operatorCount > MAX_OPERATORS) {
+      throw new RangeError(`Too many operators (max: ${MAX_OPERATORS})`);
+    }
+    if (isJsonPath(field)) {
+      const { columnName, jsonPath } = compileJsonPath(field);
+      const identFragment2 = sql.ident(columnName);
+      if (condition === null || condition === undefined) {
+        context.values.push(jsonPath);
+        return `(json_extract(${identFragment2.text}, ?) IS NULL)`;
+      } else {
+        context.values.push(jsonPath, sql.value(condition));
+        return `(json_extract(${identFragment2.text}, ?) = ?)`;
+      }
+    } else {
+      const identFragment2 = sql.ident(field);
+      if (condition === null || condition === undefined) {
+        return `(${identFragment2.text} IS NULL)`;
+      } else {
+        context.values.push(sql.value(condition));
+        return `(${identFragment2.text} = ?)`;
+      }
+    }
+  }
+  if (typeof condition !== "object" || condition === null) {
+    throw new TypeError("Condition must be a value or operator object");
+  }
+  const operators = condition;
+  const clauses = [];
+  for (const op of Object.keys(operators)) {
+    if (!VALID_OPERATORS.has(op)) {
+      throw new SyntaxError(`Unknown operator: ${op}`);
+    }
+  }
+  const identFragment = sql.ident(isJsonPath(field) ? compileJsonPath(field).columnName : field);
+  const fieldExpr = isJsonPath(field) ? `json_extract(${identFragment.text}, ?)` : identFragment.text;
+  if (isJsonPath(field)) {
+    context.values.push(compileJsonPath(field).jsonPath);
+  }
+  if ("exists" in operators) {
+    context.operatorCount++;
+    if (context.operatorCount > MAX_OPERATORS) {
+      throw new RangeError(`Too many operators (max: ${MAX_OPERATORS})`);
+    }
+    return operators.exists ? `(${fieldExpr} IS NOT NULL)` : `(${fieldExpr} IS NULL)`;
+  }
+  for (const [op, value] of Object.entries(operators)) {
+    context.operatorCount++;
+    if (context.operatorCount > MAX_OPERATORS) {
+      throw new RangeError(`Too many operators (max: ${MAX_OPERATORS})`);
+    }
+    switch (op) {
+      case "gt":
+        context.values.push(sql.value(value));
+        clauses.push(`${fieldExpr} > ?`);
+        break;
+      case "gte":
+        context.values.push(sql.value(value));
+        clauses.push(`${fieldExpr} >= ?`);
+        break;
+      case "lt":
+        context.values.push(sql.value(value));
+        clauses.push(`${fieldExpr} < ?`);
+        break;
+      case "lte":
+        context.values.push(sql.value(value));
+        clauses.push(`${fieldExpr} <= ?`);
+        break;
+      case "ne":
+        if (value === null || value === undefined) {
+          clauses.push(`${fieldExpr} IS NOT NULL`);
+        } else {
+          context.values.push(sql.value(value));
+          clauses.push(`${fieldExpr} <> ?`);
+        }
+        break;
+      case "in": {
+        if (!Array.isArray(value)) {
+          throw new TypeError("IN operator requires an array");
+        }
+        if (value.length === 0) {
+          throw new TypeError("IN operator cannot be used with empty arrays");
+        }
+        if (value.length > 999) {
+          throw new RangeError("IN operator cannot be used with arrays larger than 999 items");
+        }
+        const inFragment = sql.in(value);
+        context.values.push(...inFragment.values);
+        clauses.push(`${fieldExpr} IN ${inFragment.text}`);
+        break;
+      }
+      case "nin": {
+        if (!Array.isArray(value)) {
+          throw new TypeError("NIN operator requires an array");
+        }
+        if (value.length === 0) {
+          throw new TypeError("NIN operator cannot be used with empty arrays");
+        }
+        if (value.length > 999) {
+          throw new RangeError("NIN operator cannot be used with arrays larger than 999 items");
+        }
+        const ninFragment = sql.in(value);
+        context.values.push(...ninFragment.values);
+        clauses.push(`${fieldExpr} NOT IN ${ninFragment.text}`);
+        break;
+      }
+      case "like":
+        if (typeof value !== "string") {
+          throw new TypeError("LIKE operator requires a string pattern");
+        }
+        context.values.push(value);
+        clauses.push(`${fieldExpr} LIKE ?`);
+        break;
+      case "ilike":
+        if (typeof value !== "string") {
+          throw new TypeError("ILIKE operator requires a string pattern");
+        }
+        context.values.push(value);
+        clauses.push(`${fieldExpr} LIKE ? COLLATE NOCASE`);
+        break;
+      case "regex":
+        if (typeof value !== "string") {
+          throw new TypeError("REGEX operator requires a string pattern");
+        }
+        context.values.push(value);
+        clauses.push(`${fieldExpr} REGEXP ?`);
+        break;
+    }
+  }
+  if (clauses.length === 0) {
+    throw new SyntaxError("Operator object must contain at least one valid operator");
+  }
+  return clauses.length === 1 ? `(${clauses[0]})` : `(${clauses.join(" AND ")})`;
+}
+function compileFilterRecursive(filter, context) {
+  if (context.depth >= MAX_NESTING_DEPTH) {
+    throw new RangeError(`Nesting depth too deep (max: ${MAX_NESTING_DEPTH})`);
+  }
+  if (typeof filter !== "object" || filter === null) {
+    throw new TypeError("Filter must be an object");
+  }
+  context.depth++;
+  const clauses = [];
+  if ("and" in filter && filter.and) {
+    context.operatorCount++;
+    if (context.operatorCount > MAX_OPERATORS) {
+      throw new RangeError(`Too many operators (max: ${MAX_OPERATORS})`);
+    }
+    if (!Array.isArray(filter.and)) {
+      throw new TypeError("AND operator must be an array");
+    }
+    if (filter.and.length === 0) {
+      throw new TypeError("AND operator cannot be used with empty arrays");
+    }
+    const andClauses = filter.and.map((subFilter) => compileFilterRecursive(subFilter, context));
+    clauses.push(`(${andClauses.join(" AND ")})`);
+  }
+  if ("or" in filter && filter.or) {
+    context.operatorCount++;
+    if (context.operatorCount > MAX_OPERATORS) {
+      throw new RangeError(`Too many operators (max: ${MAX_OPERATORS})`);
+    }
+    if (!Array.isArray(filter.or)) {
+      throw new TypeError("OR operator must be an array");
+    }
+    if (filter.or.length === 0) {
+      throw new TypeError("OR operator cannot be used with empty arrays");
+    }
+    const orClauses = filter.or.map((subFilter) => compileFilterRecursive(subFilter, context));
+    clauses.push(`(${orClauses.join(" OR ")})`);
+  }
+  const fieldEntries = Object.entries(filter).filter(([field, condition]) => field !== "and" && field !== "or" && condition !== undefined);
+  for (const [field, condition] of fieldEntries) {
+    if (Array.isArray(condition)) {
+      throw new SyntaxError(`Field '${field}' cannot have array value. Use logical operators 'and'/'or' instead.`);
+    }
+    clauses.push(compileFieldCondition(field, condition, context));
+  }
+  context.depth--;
+  if (clauses.length === 0) {
+    throw new SyntaxError("Filter must contain at least one condition");
+  }
+  if (clauses.length === 1) {
+    return clauses[0];
+  } else {
+    return `(${clauses.join(" AND ")})`;
+  }
+}
+function compileFilter(filter) {
+  const context = {
+    depth: 0,
+    operatorCount: 0,
+    values: []
+  };
+  const text = compileFilterRecursive(filter, context);
+  return Object.freeze({
+    text: `(${text})`,
+    values: Object.freeze([...context.values])
+  });
+}
 export {
-  sql
+  sql,
+  compileFilter
 };
 
-//# debugId=85D99CAC0423D74264756E2164756E21
+//# debugId=62BC5523B4B64F9C64756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,10 +1,11 @@
 {
   "version": 3,
-  "sources": ["../src/sql.ts"],
+  "sources": ["../src/sql.ts", "../src/filter.ts"],
   "sourcesContent": [
-    "import type { SqlFragment, SqlQuery, SqlValue } from './types'\n\n// Maximum query length (100KB)\nconst MAX_QUERY_LENGTH = 102400\n\n// Regex to detect stacked queries (semicolon followed by non-whitespace)\nconst STACKED_QUERY_REGEX = /;[\\s\\S]*\\S/\n\n// ANSI identifier validation - supports qualified identifiers (e.g., table.column)\nconst QUALIFIED_IDENTIFIER_REGEX =\n  /^[A-Za-z_][A-Za-z0-9_]*(\\.[A-Za-z_][A-Za-z0-9_]*)*$/\n\n/**\n * Format a date for SQLite (YYYY-MM-DD HH:MM:SS)\n */\nfunction formatDate(date: Date): string {\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  const hours = String(date.getHours()).padStart(2, '0')\n  const minutes = String(date.getMinutes()).padStart(2, '0')\n  const seconds = String(date.getSeconds()).padStart(2, '0')\n\n  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`\n}\n\n/**\n * Convert a value to its SQLite representation\n */\nfunction sqlValue(value: SqlValue): unknown {\n  if (value === null || value === undefined) {\n    return null\n  }\n\n  if (typeof value === 'string') {\n    return value\n  }\n\n  if (typeof value === 'number' || typeof value === 'boolean') {\n    return value\n  }\n\n  if (value instanceof Date) {\n    return formatDate(value)\n  }\n\n  if (value instanceof Buffer || value instanceof Uint8Array) {\n    throw new TypeError(\n      'Buffer/Uint8Array values must be used with sql.blob() for safe BLOB handling',\n    )\n  }\n\n  throw new TypeError(`Unsupported value type: ${typeof value}`)\n}\n\n/**\n * Validate and quote a SQL identifier or array of identifiers/fragments\n */\nfunction sqlIdent(\n  identifier: string | readonly (string | SqlFragment)[],\n): SqlFragment {\n  // Handle array of identifiers and fragments\n  if (Array.isArray(identifier)) {\n    if (identifier.length === 0) {\n      throw new TypeError('Identifier array cannot be empty')\n    }\n\n    const fragments: SqlFragment[] = []\n\n    for (const item of identifier) {\n      // Handle SqlFragment objects (like sql.raw())\n      if (\n        item &&\n        typeof item === 'object' &&\n        'text' in item &&\n        'values' in item &&\n        typeof (item as Record<string, unknown>).text === 'string' &&\n        Array.isArray((item as Record<string, unknown>).values)\n      ) {\n        fragments.push(item as SqlFragment)\n      } else if (typeof item === 'string') {\n        // Handle string identifiers\n        if (!item) {\n          throw new TypeError('All identifiers must be non-empty strings')\n        }\n\n        if (!QUALIFIED_IDENTIFIER_REGEX.test(item)) {\n          throw new TypeError(\n            `Invalid identifier: ${item}. Must be a valid identifier or qualified identifier (e.g., table.column)`,\n          )\n        }\n\n        fragments.push({\n          text: '\"' + item + '\"',\n          values: [],\n        })\n      } else {\n        throw new TypeError('Array items must be strings or SQL fragments')\n      }\n    }\n\n    // Join all fragments\n    const text = fragments.map((f) => f.text).join(', ')\n    const values = fragments.flatMap((f) => [...f.values])\n\n    return {\n      text,\n      values,\n    }\n  }\n\n  // Handle single identifier (existing behavior)\n  if (!identifier || typeof identifier !== 'string') {\n    throw new TypeError('Identifier must be a non-empty string')\n  }\n\n  if (!QUALIFIED_IDENTIFIER_REGEX.test(identifier)) {\n    throw new TypeError(\n      `Invalid identifier: ${identifier}. Must be a valid identifier or qualified identifier (e.g., table.column)`,\n    )\n  }\n\n  return {\n    text: '\"' + identifier + '\"',\n    values: [],\n  }\n}\n\n/**\n * Create SQL IN clause from array\n */\nfunction sqlIn(array: readonly unknown[]): SqlFragment {\n  if (!Array.isArray(array)) {\n    throw new TypeError('sql.in() requires an array')\n  }\n\n  if (array.length === 0) {\n    throw new TypeError('sql.in() cannot be used with empty arrays')\n  }\n\n  // Soft warning for large arrays\n  if (array.length > 1000) {\n    console.warn(\n      `sql.in(): Large array with ${array.length} items. Consider using temporary tables for better performance.`,\n    )\n  }\n\n  const placeholders = array.map(() => '?').join(',')\n  const values = array.map(sqlValue)\n\n  return {\n    text: `(${placeholders})`,\n    values,\n  }\n}\n\n/**\n * Create raw SQL fragment (DANGEROUS - must not contain user input)\n */\nfunction sqlRaw(rawSql: string): SqlFragment {\n  if (typeof rawSql !== 'string') {\n    throw new TypeError('sql.raw() requires a string')\n  }\n\n  return {\n    text: rawSql,\n    values: [],\n  }\n}\n\n/**\n * Create SQL fragment for BLOB data (for validated binary data)\n */\nfunction sqlBlob(data: Buffer | Uint8Array): SqlFragment {\n  if (!(data instanceof Buffer) && !(data instanceof Uint8Array)) {\n    throw new TypeError('sql.blob() requires a Buffer or Uint8Array')\n  }\n\n  return {\n    text: '?',\n    values: [data],\n  }\n}\n\n/**\n * Join SQL fragments with a separator\n */\nfunction sqlJoin(\n  fragments: readonly SqlFragment[],\n  separator = ', ',\n): SqlFragment {\n  if (!Array.isArray(fragments)) {\n    throw new TypeError('sql.join() requires an array of fragments')\n  }\n\n  if (fragments.length === 0) {\n    return { text: '', values: [] }\n  }\n\n  const text = fragments.map((f: SqlFragment) => f.text).join(separator)\n  const values = fragments.flatMap((f: SqlFragment) => [...f.values])\n\n  return { text, values }\n}\n\n/**\n * Main SQL tagged template function\n */\nfunction sql(strings: TemplateStringsArray, ...values: unknown[]): SqlQuery {\n  // Build the query text and collect values\n  let text = strings[0] || ''\n  const queryValues: unknown[] = []\n\n  for (let i = 0; i < values.length; i++) {\n    const value = values[i]\n\n    // Handle SqlFragment objects (from helper functions)\n    if (\n      value &&\n      typeof value === 'object' &&\n      'text' in value &&\n      'values' in value &&\n      typeof (value as Record<string, unknown>).text === 'string' &&\n      Array.isArray((value as Record<string, unknown>).values)\n    ) {\n      const fragment = value as SqlFragment\n      text += fragment.text\n      queryValues.push(...fragment.values)\n    } else {\n      // Regular value - add placeholder and collect value\n      text += '?'\n      queryValues.push(sqlValue(value as SqlValue))\n    }\n\n    text += strings[i + 1] || ''\n  }\n\n  // Security checks\n  if (text.length > MAX_QUERY_LENGTH) {\n    throw new Error(\n      `Query too long: ${text.length} bytes (max: ${MAX_QUERY_LENGTH})`,\n    )\n  }\n\n  if (STACKED_QUERY_REGEX.test(text)) {\n    throw new Error('Stacked queries are not allowed')\n  }\n\n  // Return frozen result\n  return Object.freeze({\n    text,\n    values: Object.freeze([...queryValues]),\n  })\n}\n\n// Attach helper functions to sql\nsql.value = sqlValue\nsql.ident = sqlIdent\nsql.in = sqlIn\nsql.raw = sqlRaw\nsql.blob = sqlBlob\nsql.join = sqlJoin\n\nexport { sql }\n"
+    "import type { SqlFragment, SqlQuery, SqlValue } from './types'\n\n// Maximum query length (100KB)\nconst MAX_QUERY_LENGTH = 102400\n\n// Regex to detect stacked queries (semicolon followed by non-whitespace)\nconst STACKED_QUERY_REGEX = /;[\\s\\S]*\\S/\n\n// ANSI identifier validation - supports qualified identifiers (e.g., table.column)\nconst QUALIFIED_IDENTIFIER_REGEX =\n  /^[A-Za-z_][A-Za-z0-9_]*(\\.[A-Za-z_][A-Za-z0-9_]*)*$/\n\n/**\n * Format a date for SQLite (YYYY-MM-DD HH:MM:SS)\n */\nfunction formatDate(date: Date): string {\n  const year = date.getFullYear()\n  const month = String(date.getMonth() + 1).padStart(2, '0')\n  const day = String(date.getDate()).padStart(2, '0')\n  const hours = String(date.getHours()).padStart(2, '0')\n  const minutes = String(date.getMinutes()).padStart(2, '0')\n  const seconds = String(date.getSeconds()).padStart(2, '0')\n\n  return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}`\n}\n\n/**\n * Convert a value to its SQLite representation\n */\nfunction sqlValue(value: SqlValue): unknown {\n  if (value === null || value === undefined) {\n    return null\n  }\n\n  if (typeof value === 'string') {\n    return value\n  }\n\n  if (typeof value === 'number' || typeof value === 'boolean') {\n    return value\n  }\n\n  if (value instanceof Date) {\n    return formatDate(value)\n  }\n\n  if (value instanceof Buffer || value instanceof Uint8Array) {\n    throw new TypeError(\n      'Buffer/Uint8Array values must be used with sql.blob() for safe BLOB handling',\n    )\n  }\n\n  throw new TypeError(`Unsupported value type: ${typeof value}`)\n}\n\n/**\n * Validate and quote a SQL identifier or array of identifiers/fragments\n */\nfunction sqlIdent(\n  identifier: string | readonly (string | SqlFragment)[],\n): SqlFragment {\n  // Handle array of identifiers and fragments\n  if (Array.isArray(identifier)) {\n    if (identifier.length === 0) {\n      throw new TypeError('Identifier array cannot be empty')\n    }\n\n    const fragments: SqlFragment[] = []\n\n    for (const item of identifier) {\n      // Handle SqlFragment objects (like sql.raw())\n      if (\n        item &&\n        typeof item === 'object' &&\n        'text' in item &&\n        'values' in item &&\n        typeof (item as Record<string, unknown>).text === 'string' &&\n        Array.isArray((item as Record<string, unknown>).values)\n      ) {\n        fragments.push(item as SqlFragment)\n      } else if (typeof item === 'string') {\n        // Handle string identifiers\n        if (!item) {\n          throw new TypeError('All identifiers must be non-empty strings')\n        }\n\n        if (!QUALIFIED_IDENTIFIER_REGEX.test(item)) {\n          throw new TypeError(\n            `Invalid identifier: ${item}. Must be a valid identifier or qualified identifier (e.g., table.column)`,\n          )\n        }\n\n        fragments.push({\n          text: '\"' + item + '\"',\n          values: [],\n        })\n      } else {\n        throw new TypeError('Array items must be strings or SQL fragments')\n      }\n    }\n\n    // Join all fragments\n    const text = fragments.map((f) => f.text).join(', ')\n    const values = fragments.flatMap((f) => [...f.values])\n\n    return {\n      text,\n      values,\n    }\n  }\n\n  // Handle single identifier (existing behavior)\n  if (!identifier || typeof identifier !== 'string') {\n    throw new TypeError('Identifier must be a non-empty string')\n  }\n\n  if (!QUALIFIED_IDENTIFIER_REGEX.test(identifier)) {\n    throw new TypeError(\n      `Invalid identifier: ${identifier}. Must be a valid identifier or qualified identifier (e.g., table.column)`,\n    )\n  }\n\n  return {\n    text: '\"' + identifier + '\"',\n    values: [],\n  }\n}\n\n/**\n * Create SQL IN clause from array\n */\nfunction sqlIn(array: readonly unknown[]): SqlFragment {\n  if (!Array.isArray(array)) {\n    throw new TypeError('sql.in() requires an array')\n  }\n\n  if (array.length === 0) {\n    throw new TypeError('sql.in() cannot be used with empty arrays')\n  }\n\n  // Soft warning for large arrays\n  if (array.length > 1000) {\n    console.warn(\n      `sql.in(): Large array with ${array.length} items. Consider using temporary tables for better performance.`,\n    )\n  }\n\n  const placeholders = array.map(() => '?').join(',')\n  const values = array.map(sqlValue)\n\n  return {\n    text: `(${placeholders})`,\n    values,\n  }\n}\n\n/**\n * Create raw SQL fragment (DANGEROUS - must not contain user input)\n */\nfunction sqlRaw(rawSql: string): SqlFragment {\n  if (typeof rawSql !== 'string') {\n    throw new TypeError('sql.raw() requires a string')\n  }\n\n  return {\n    text: rawSql,\n    values: [],\n  }\n}\n\n/**\n * Create SQL fragment for BLOB data (for validated binary data)\n */\nfunction sqlBlob(data: Buffer | Uint8Array): SqlFragment {\n  if (!(data instanceof Buffer) && !(data instanceof Uint8Array)) {\n    throw new TypeError('sql.blob() requires a Buffer or Uint8Array')\n  }\n\n  return {\n    text: '?',\n    values: [data],\n  }\n}\n\n/**\n * Join SQL fragments with a separator\n */\nfunction sqlJoin(\n  fragments: readonly SqlFragment[],\n  separator = ', ',\n): SqlFragment {\n  if (!Array.isArray(fragments)) {\n    throw new TypeError('sql.join() requires an array of fragments')\n  }\n\n  if (fragments.length === 0) {\n    return { text: '', values: [] }\n  }\n\n  const text = fragments.map((f: SqlFragment) => f.text).join(separator)\n  const values = fragments.flatMap((f: SqlFragment) => [...f.values])\n\n  return { text, values }\n}\n\n/**\n * Main SQL tagged template function\n */\nfunction sql(strings: TemplateStringsArray, ...values: unknown[]): SqlQuery {\n  // Build the query text and collect values\n  let text = strings[0] || ''\n  const queryValues: unknown[] = []\n\n  for (let i = 0; i < values.length; i++) {\n    const value = values[i]\n\n    // Handle SqlFragment objects (from helper functions)\n    if (\n      value &&\n      typeof value === 'object' &&\n      'text' in value &&\n      'values' in value &&\n      typeof (value as Record<string, unknown>).text === 'string' &&\n      Array.isArray((value as Record<string, unknown>).values)\n    ) {\n      const fragment = value as SqlFragment\n      text += fragment.text\n      queryValues.push(...fragment.values)\n    } else {\n      // Regular value - add placeholder and collect value\n      text += '?'\n      queryValues.push(sqlValue(value as SqlValue))\n    }\n\n    text += strings[i + 1] || ''\n  }\n\n  // Security checks\n  if (text.length > MAX_QUERY_LENGTH) {\n    throw new Error(\n      `Query too long: ${text.length} bytes (max: ${MAX_QUERY_LENGTH})`,\n    )\n  }\n\n  if (STACKED_QUERY_REGEX.test(text)) {\n    throw new Error('Stacked queries are not allowed')\n  }\n\n  // Return frozen result\n  return Object.freeze({\n    text,\n    values: Object.freeze([...queryValues]),\n  })\n}\n\n// Attach helper functions to sql\nsql.value = sqlValue\nsql.ident = sqlIdent\nsql.in = sqlIn\nsql.raw = sqlRaw\nsql.blob = sqlBlob\nsql.join = sqlJoin\n\nexport { sql }\n",
+    "import { sql } from './sql'\nimport type {\n  ComparisonOperators,\n  FieldCondition,\n  FilterResult,\n  JsonFilter,\n} from './types'\n\n// Limits to prevent DoS attacks\nconst MAX_NESTING_DEPTH = 10\nconst MAX_OPERATORS = 100\n\n// Valid operators for validation\nconst VALID_OPERATORS = new Set([\n  'gt',\n  'gte',\n  'lt',\n  'lte',\n  'ne',\n  'in',\n  'nin',\n  'like',\n  'ilike',\n  'regex',\n  'exists',\n  'and',\n  'or',\n])\n\n/**\n * Context for tracking compilation state\n */\ninterface CompileContext {\n  depth: number\n  operatorCount: number\n  values: unknown[]\n}\n\n/**\n * Check if a field name represents a JSON path (contains dots)\n */\nfunction isJsonPath(field: string): boolean {\n  return field.includes('.')\n}\n\n/**\n * Convert a JSON path field to json_extract expression\n */\nfunction compileJsonPath(field: string): {\n  columnName: string\n  jsonPath: string\n} {\n  const parts = field.split('.')\n  const columnName = parts[0]\n  const jsonPath = parts.slice(1)\n\n  if (!columnName || jsonPath.length === 0 || jsonPath.some((part) => !part)) {\n    throw new SyntaxError(`Invalid JSON path: ${field}`)\n  }\n\n  return {\n    columnName,\n    jsonPath: '$.' + jsonPath.join('.'),\n  }\n}\n\n/**\n * Compile a single field condition to SQL\n */\nfunction compileFieldCondition(\n  field: string,\n  condition: FieldCondition,\n  context: CompileContext,\n): string {\n  // Handle direct value (equality)\n  if (\n    condition === null ||\n    condition === undefined ||\n    typeof condition === 'string' ||\n    typeof condition === 'number' ||\n    typeof condition === 'boolean' ||\n    condition instanceof Date\n  ) {\n    context.operatorCount++\n    if (context.operatorCount > MAX_OPERATORS) {\n      throw new RangeError(`Too many operators (max: ${MAX_OPERATORS})`)\n    }\n\n    if (isJsonPath(field)) {\n      const { columnName, jsonPath } = compileJsonPath(field)\n      const identFragment = sql.ident(columnName)\n\n      if (condition === null || condition === undefined) {\n        context.values.push(jsonPath)\n        return `(json_extract(${identFragment.text}, ?) IS NULL)`\n      } else {\n        context.values.push(jsonPath, sql.value(condition))\n        return `(json_extract(${identFragment.text}, ?) = ?)`\n      }\n    } else {\n      const identFragment = sql.ident(field)\n\n      if (condition === null || condition === undefined) {\n        return `(${identFragment.text} IS NULL)`\n      } else {\n        context.values.push(sql.value(condition))\n        return `(${identFragment.text} = ?)`\n      }\n    }\n  }\n\n  // Handle operator object\n  if (typeof condition !== 'object' || condition === null) {\n    throw new TypeError('Condition must be a value or operator object')\n  }\n\n  const operators = condition as ComparisonOperators\n  const clauses: string[] = []\n\n  // Validate all operators are known\n  for (const op of Object.keys(operators)) {\n    if (!VALID_OPERATORS.has(op)) {\n      throw new SyntaxError(`Unknown operator: ${op}`)\n    }\n  }\n\n  const identFragment = sql.ident(\n    isJsonPath(field) ? compileJsonPath(field).columnName : field,\n  )\n  const fieldExpr = isJsonPath(field)\n    ? `json_extract(${identFragment.text}, ?)`\n    : identFragment.text\n\n  // Add JSON path to values if needed\n  if (isJsonPath(field)) {\n    context.values.push(compileJsonPath(field).jsonPath)\n  }\n\n  // Handle exists operator first (it overrides other operators)\n  if ('exists' in operators) {\n    context.operatorCount++\n    if (context.operatorCount > MAX_OPERATORS) {\n      throw new RangeError(`Too many operators (max: ${MAX_OPERATORS})`)\n    }\n\n    return operators.exists\n      ? `(${fieldExpr} IS NOT NULL)`\n      : `(${fieldExpr} IS NULL)`\n  }\n\n  // Handle comparison operators\n  for (const [op, value] of Object.entries(operators)) {\n    context.operatorCount++\n    if (context.operatorCount > MAX_OPERATORS) {\n      throw new RangeError(`Too many operators (max: ${MAX_OPERATORS})`)\n    }\n\n    switch (op) {\n      case 'gt':\n        context.values.push(sql.value(value))\n        clauses.push(`${fieldExpr} > ?`)\n        break\n      case 'gte':\n        context.values.push(sql.value(value))\n        clauses.push(`${fieldExpr} >= ?`)\n        break\n      case 'lt':\n        context.values.push(sql.value(value))\n        clauses.push(`${fieldExpr} < ?`)\n        break\n      case 'lte':\n        context.values.push(sql.value(value))\n        clauses.push(`${fieldExpr} <= ?`)\n        break\n      case 'ne':\n        if (value === null || value === undefined) {\n          clauses.push(`${fieldExpr} IS NOT NULL`)\n        } else {\n          context.values.push(sql.value(value))\n          clauses.push(`${fieldExpr} <> ?`)\n        }\n        break\n      case 'in': {\n        if (!Array.isArray(value)) {\n          throw new TypeError('IN operator requires an array')\n        }\n        if (value.length === 0) {\n          throw new TypeError('IN operator cannot be used with empty arrays')\n        }\n        if (value.length > 999) {\n          throw new RangeError(\n            'IN operator cannot be used with arrays larger than 999 items',\n          )\n        }\n\n        const inFragment = sql.in(value)\n        context.values.push(...inFragment.values)\n        clauses.push(`${fieldExpr} IN ${inFragment.text}`)\n        break\n      }\n      case 'nin': {\n        if (!Array.isArray(value)) {\n          throw new TypeError('NIN operator requires an array')\n        }\n        if (value.length === 0) {\n          throw new TypeError('NIN operator cannot be used with empty arrays')\n        }\n        if (value.length > 999) {\n          throw new RangeError(\n            'NIN operator cannot be used with arrays larger than 999 items',\n          )\n        }\n\n        const ninFragment = sql.in(value)\n        context.values.push(...ninFragment.values)\n        clauses.push(`${fieldExpr} NOT IN ${ninFragment.text}`)\n        break\n      }\n      case 'like':\n        if (typeof value !== 'string') {\n          throw new TypeError('LIKE operator requires a string pattern')\n        }\n        context.values.push(value)\n        clauses.push(`${fieldExpr} LIKE ?`)\n        break\n      case 'ilike':\n        if (typeof value !== 'string') {\n          throw new TypeError('ILIKE operator requires a string pattern')\n        }\n        context.values.push(value)\n        clauses.push(`${fieldExpr} LIKE ? COLLATE NOCASE`)\n        break\n      case 'regex':\n        if (typeof value !== 'string') {\n          throw new TypeError('REGEX operator requires a string pattern')\n        }\n        context.values.push(value)\n        clauses.push(`${fieldExpr} REGEXP ?`)\n        break\n    }\n  }\n\n  if (clauses.length === 0) {\n    throw new SyntaxError(\n      'Operator object must contain at least one valid operator',\n    )\n  }\n\n  return clauses.length === 1 ? `(${clauses[0]})` : `(${clauses.join(' AND ')})`\n}\n\n/**\n * Compile a JSON filter to SQL recursively\n */\nfunction compileFilterRecursive(\n  filter: JsonFilter,\n  context: CompileContext,\n): string {\n  if (context.depth >= MAX_NESTING_DEPTH) {\n    throw new RangeError(`Nesting depth too deep (max: ${MAX_NESTING_DEPTH})`)\n  }\n\n  if (typeof filter !== 'object' || filter === null) {\n    throw new TypeError('Filter must be an object')\n  }\n\n  context.depth++\n  const clauses: string[] = []\n\n  // Handle logical operators first\n  if ('and' in filter && filter.and) {\n    context.operatorCount++\n    if (context.operatorCount > MAX_OPERATORS) {\n      throw new RangeError(`Too many operators (max: ${MAX_OPERATORS})`)\n    }\n\n    if (!Array.isArray(filter.and)) {\n      throw new TypeError('AND operator must be an array')\n    }\n    if (filter.and.length === 0) {\n      throw new TypeError('AND operator cannot be used with empty arrays')\n    }\n\n    const andClauses = filter.and.map((subFilter) =>\n      compileFilterRecursive(subFilter, context),\n    )\n    clauses.push(`(${andClauses.join(' AND ')})`)\n  }\n\n  if ('or' in filter && filter.or) {\n    context.operatorCount++\n    if (context.operatorCount > MAX_OPERATORS) {\n      throw new RangeError(`Too many operators (max: ${MAX_OPERATORS})`)\n    }\n\n    if (!Array.isArray(filter.or)) {\n      throw new TypeError('OR operator must be an array')\n    }\n    if (filter.or.length === 0) {\n      throw new TypeError('OR operator cannot be used with empty arrays')\n    }\n\n    const orClauses = filter.or.map((subFilter) =>\n      compileFilterRecursive(subFilter, context),\n    )\n    clauses.push(`(${orClauses.join(' OR ')})`)\n  }\n\n  // Handle field conditions (implicit AND) - preserve original order\n  const fieldEntries = Object.entries(filter).filter(\n    ([field, condition]) =>\n      field !== 'and' && field !== 'or' && condition !== undefined,\n  )\n\n  for (const [field, condition] of fieldEntries) {\n    // Handle array conditions (for 'and'/'or' at field level)\n    if (Array.isArray(condition)) {\n      throw new SyntaxError(\n        `Field '${field}' cannot have array value. Use logical operators 'and'/'or' instead.`,\n      )\n    }\n\n    clauses.push(\n      compileFieldCondition(field, condition as FieldCondition, context),\n    )\n  }\n\n  context.depth--\n\n  if (clauses.length === 0) {\n    throw new SyntaxError('Filter must contain at least one condition')\n  }\n\n  // Fix: ensure we have at least one clause before accessing clauses[0]\n  if (clauses.length === 1) {\n    return clauses[0]!\n  } else {\n    return `(${clauses.join(' AND ')})`\n  }\n}\n\n/**\n * Compile a JSON filter to a SQL WHERE clause\n */\nexport function compileFilter(filter: JsonFilter): FilterResult {\n  const context: CompileContext = {\n    depth: 0,\n    operatorCount: 0,\n    values: [],\n  }\n\n  const text = compileFilterRecursive(filter, context)\n\n  return Object.freeze({\n    text: `(${text})`,\n    values: Object.freeze([...context.values]),\n  })\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "85D99CAC0423D74264756E2164756E21",
+  "mappings": "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",
+  "debugId": "62BC5523B4B64F9C64756E2164756E21",
   "names": []
 }

package/dist/types.d.ts

@@ -16,4 +16,58 @@ export interface SqlFragment {
     readonly text: string;
     readonly values: readonly unknown[];
 }
+/**
+ * Comparison operators for JSON filters
+ */
+export interface ComparisonOperators {
+    /** Greater than */
+    gt?: SqlValue;
+    /** Greater than or equal */
+    gte?: SqlValue;
+    /** Less than */
+    lt?: SqlValue;
+    /** Less than or equal */
+    lte?: SqlValue;
+    /** Not equal */
+    ne?: SqlValue;
+    /** IN array */
+    in?: readonly SqlValue[];
+    /** NOT IN array */
+    nin?: readonly SqlValue[];
+    /** LIKE pattern */
+    like?: string;
+    /** Case-insensitive LIKE */
+    ilike?: string;
+    /** Regular expression pattern */
+    regex?: string;
+    /** Field exists check (true = IS NOT NULL, false = IS NULL) */
+    exists?: boolean;
+}
+/**
+ * A field condition can be a direct value or an object with operators
+ */
+export type FieldCondition = SqlValue | ComparisonOperators;
+/**
+ * Logical operators for combining filters
+ */
+export interface LogicalOperators {
+    /** All conditions must match */
+    and?: readonly JsonFilter[];
+    /** Any condition must match */
+    or?: readonly JsonFilter[];
+}
+/**
+ * A JSON filter for compiling to SQL WHERE clauses
+ * Can be a field-to-condition mapping with implicit AND, or explicit logical operators
+ */
+export type JsonFilter = LogicalOperators & {
+    [field: string]: FieldCondition | readonly JsonFilter[] | undefined;
+};
+/**
+ * Result of compiling a JSON filter to SQL
+ */
+export interface FilterResult {
+    readonly text: string;
+    readonly values: readonly unknown[];
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,IAAI,GACJ,MAAM,GACN,UAAU,CAAA;AAEd;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,GACT,IAAI,GACJ,MAAM,GACN,UAAU,CAAA;AAEd;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,QAAQ,CAAA;IACd,gBAAgB;IAChB,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,yBAAyB;IACzB,GAAG,CAAC,EAAE,QAAQ,CAAA;IACd,gBAAgB;IAChB,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,eAAe;IACf,EAAE,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;IACxB,mBAAmB;IACnB,GAAG,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;IACzB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,mBAAmB,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,GAAG,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;IAC3B,+BAA+B;IAC/B,EAAE,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;CAC3B;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,gBAAgB,GAAG;IAC1C,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,UAAU,EAAE,GAAG,SAAS,CAAA;CACpE,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CACpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truto/sqlite-builder",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Safe, zero-dependency template-literal tag for SQLite queries in any JS environment",
   "keywords": [
     "sqlite",