@truto/sqlite-builder 2.0.2-canary.13 → 2.0.2-canary.21

package/README.md

@@ -1,225 +1,28 @@
-
-// Dynamic column selection (simplified with array support)
-const columns = ['id', 'name', 'email']
-const selectQuery = sql`SELECT ${sql.ident(columns)} FROM users`
-
-// Alternative approach for more complex column expressions
-const complexColumns = [
-  sql.ident('id'),
-  sql.ident('name'),
-  sql.raw('UPPER(email) as email_upper'),
-]
-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 and interpolate directly. Filter values and the
-  // LIMIT value are collected in order into query.values.
-  const query = sql`
-    SELECT id, name, email, created_at
-    FROM users
-    WHERE ${compileFilter(filter)}
-    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 }] } }
+const results = db.prepare(complexQuery.text).all(...complexQuery.values)
 ```
 
-### Array Identifiers & Qualified Identifiers
+#### Kitchen Sink Examples
 
-The `sql.ident()` function supports simple identifiers, qualified identifiers (table.column), arrays, and mixed arrays with SQL fragments:
+Real-world complex filters:
 
 ```typescript
-// ✅ Simple identifiers
-const table = 'users'
-const column = 'name'
-const simpleQuery = sql`SELECT ${sql.ident(column)} FROM ${sql.ident(table)}`
-// Result: SELECT "name" FROM "users"
-
-// ✅ Qualified identifiers (table.column)
-const qualifiedQuery = sql`SELECT ${sql.ident('u.name')}, ${sql.ident('p.title')} FROM users u JOIN posts p ON u.id = p.user_id`
-// Result: SELECT "u"."name", "p"."title" FROM users u JOIN posts p ON u.id = p.user_id
-
-// ✅ Pure identifier arrays (clean and concise)
-const columns = ['id', 'name', 'email', 'created_at']
-const arrayQuery = sql`SELECT ${sql.ident(columns)} FROM users`
-// Result: SELECT "id", "name", "email", "created_at" FROM users
-
-// ✅ Mixed qualified and simple identifiers in arrays
-const mixedColumns = ['u.id', 'name', 'u.email', 'p.title', 'created_at']
-const mixedQuery = sql`SELECT ${sql.ident(mixedColumns)} FROM users u LEFT JOIN posts p ON u.id = p.user_id`
-// Result: SELECT "u"."id", "name", "u"."email", "p"."title", "created_at" FROM users u LEFT JOIN posts p ON u.id = p.user_id
-
-// ✅ NEW: Mixed arrays with identifiers and SQL fragments
-const mixedColumns = [
-  'id',
-  'name',
-  sql.raw('UPPER(email) as email_upper'),
-  sql.raw('COUNT(*) as total'),
-]
-const mixedQuery = sql`SELECT ${sql.ident(mixedColumns)} FROM users GROUP BY id, name, email`
-// Result: SELECT "id", "name", UPPER(email) as email_upper, COUNT(*) as total FROM users GROUP BY id, name, email
-
-// ✅ Mixed arrays with parameterized fragments
-const status = 'premium'
-const dynamicColumns = [
-  'id',
-  'name',
-  sql`CASE WHEN status = ${status} THEN 'Premium User' ELSE 'Regular User' END as user_type`,
-  sql.raw('created_at'),
-]
-const parameterizedQuery = sql`SELECT ${sql.ident(dynamicColumns)} FROM users WHERE active = ${true}`
-// Combines identifiers, raw SQL, and parameterized values seamlessly
-
-// ✅ Works great for INSERT statements
-const insertData = { name: 'John', email: 'john@example.com', age: 30 }
-const insertColumns = Object.keys(insertData)
-const insertValues = Object.values(insertData)
-const insertQuery = sql`
-  INSERT INTO users (${sql.ident(insertColumns)}) 
-  VALUES (${insertValues[0]}, ${insertValues[1]}, ${insertValues[2]})
-`
-
-// ✅ Dynamic column selection
-const userFields = ['name', 'email']
-const includeTimestamps = true
-if (includeTimestamps) {
-  userFields.push('created_at', 'updated_at')
+// 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 },
+  ],
 }
-const dynamicQuery = sql`SELECT ${sql.ident(userFields)} FROM users`
-
-// 🆚 OLD: Manual joining approach (still works, but much more verbose)
-const oldWay = sql`SELECT ${sql.join([
-  sql.ident('id'),
-  sql.ident('name'),
-  sql.raw('UPPER(email) as email_upper'),
-])} FROM users`
-```
-
-### Complex Joins
-
-```typescript
-const getUsersWithPosts = sql`
-  SELECT 
-    ${sql.ident('u')}.id,
-    ${sql.ident('u')}.name,
-    COUNT(${sql.ident('p')}.id) as post_count
-  FROM ${sql.ident('users')} u
-  LEFT JOIN ${sql.ident('posts')} p ON u.id = p.user_id
-  WHERE u.created_at > ${startDate}
-    AND u.status IN ${sql.in(['active', 'premium'])}
-  GROUP BY u.id
-  HAVING post_count > ${minPosts}
-  ORDER BY post_count DESC
-  LIMIT ${limit}
-`
-
-// For simpler cases, you can use array identifiers directly
-const getUsers = sql`
-  SELECT ${sql.ident(['id', 'name', 'email', 'created_at'])}
-  FROM ${sql.ident('users')}
-  WHERE status = ${'active'}
-`
-```
-
-### Transactions
-
-```typescript
-// Works great with better-sqlite3 transactions
-const insertUsers = db.transaction((users) => {
-  const stmt = db.prepare(
-    sql`
-    INSERT INTO users (name, email) 
-    VALUES (?, ?)
-  `.text,
-  )
-
-  for (const user of users) {
-    const { values } = sql`${user.name}, ${user.email}`
-    stmt.run(...values)
-  }
-})
-
-insertUsers([
-  { name: 'Alice', email: 'alice@example.com' },
-  { name: 'Bob', email: 'bob@example.com' },
-])
-```
-
-## 🧪 Testing
-
-```bash
-# Run tests
-bun run test
-
-# Run tests in watch mode
-bun run dev
-
-# Run tests with coverage
-bun run test:coverage
-
-# Run tests with UI
-bun run test:ui
-```
-
-## 🤝 Contributing
-
-We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
-
-### Development Setup
-
-```bash
-git clone https://github.com/truto/truto-sqlite-builder.git
-cd truto-sqlite-builder
-bun install
-bun run dev  # Start tests in watch mode
-```
-
-### Release Process
-
-We use [changesets](https://github.com/changesets/changesets) for version management:
-
-```bash
-# Add a changeset
-bunx changeset
-
-# Release
-bunx changeset version
-bun run build
-git commit -am "Release"
-git push --follow-tags
-```
-
-## 🔒 Security Policy
-
-If you discover a security vulnerability, please email eng@truto.one or create an issue.
-
-## 📄 License
-
-MIT © [Truto](https://github.com/trutohq)
-
-## 💡 Inspiration
-
-This library was inspired by:
-
-- [sql-template-strings](https://github.com/felixfbecker/sql-template-strings)
-- [slonik](https://github.com/gajus/slonik)
-- [Postgres.js](https://github.com/porsager/postgres)
 
-Built with ❤️ for the SQLite community.
+// 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 },

package/package.json

@@ -1 +1 @@
-{"name":"@truto/sqlite-builder","version":"2.0.2-canary.13","description":"debug canary","license":"MIT","main":"index.js"}
+{"name":"@truto/sqlite-builder","version":"2.0.2-canary.21","description":"debug canary","license":"MIT","main":"index.js"}