@pineliner/odb-client 1.0.6 → 1.0.7

package/dist/core/http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/core/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9E;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,aAAa;IAajC;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAoD9E;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAqB9B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IAqBrC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;YACW,WAAW;IAgDzB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,UAAU;IAOtD;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;CAGrC"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/core/http-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAmB,WAAW,EAAE,MAAM,aAAa,CAAA;AAG9E;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,aAAa;IAajC;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAqD9E;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAqB9B;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC;IAqBrC;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;YACW,WAAW;IAgDzB;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,UAAU;IAOtD;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,aAAa,CAAC;CAGrC"}

package/dist/database/adapters/bun-sqlite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bun-sqlite.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/bun-sqlite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAGV,eAAe,EAChB,MAAM,UAAU,CAAA;AAEjB;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IACtD,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAS;IACrC,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,eAAe;IAI7B,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IASrD,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAapC"}
+{"version":3,"file":"bun-sqlite.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/bun-sqlite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAGV,eAAe,EAChB,MAAM,UAAU,CAAA;AAYjB;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,eAAe;IACtD,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAS;IACrC,OAAO,CAAC,MAAM,CAAiB;gBAEnB,MAAM,EAAE,eAAe;IAI7B,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IASrD,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAapC"}

package/dist/database/adapters/libsql.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/libsql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAGV,YAAY,EACb,MAAM,UAAU,CAAA;AAEjB;;;GAGG;AACH,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;IACjC,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,YAAY;IAI1B,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAUlD,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAYpC"}
+{"version":3,"file":"libsql.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/libsql.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAGV,YAAY,EACb,MAAM,UAAU,CAAA;AAYjB;;;GAGG;AACH,qBAAa,aAAc,YAAW,eAAe;IACnD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAS;IACjC,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,YAAY;IAI1B,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAUlD,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAYpC"}

package/dist/database/adapters/odblite.d.ts

@@ -1,3 +1,4 @@
+import { ServiceClient } from '../../service/service-client';
 import type { DatabaseAdapter, Connection, ODBLiteConfig } from '../types';
 /**
  * ODB-Lite adapter for DatabaseManager
@@ -6,7 +7,7 @@ import type { DatabaseAdapter, Connection, ODBLiteConfig } from '../types';
 export declare class ODBLiteAdapter implements DatabaseAdapter {
     readonly type: "odblite";
     private config;
-    private serviceClient;
+    serviceClient: ServiceClient;
     constructor(config: ODBLiteConfig);
     connect(config: any): Promise<Connection>;
     disconnect(tenantId?: string): Promise<void>;

package/dist/database/adapters/odblite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"odblite.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/odblite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAGV,aAAa,EACd,MAAM,UAAU,CAAA;AAEjB;;;GAGG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAS;IAClC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,aAAa,CAAe;gBAExB,MAAM,EAAE,aAAa;IAQ3B,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IA2BzC,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAQpC"}
+{"version":3,"file":"odblite.d.ts","sourceRoot":"","sources":["../../../src/database/adapters/odblite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAGV,aAAa,EACd,MAAM,UAAU,CAAA;AAYjB;;;GAGG;AACH,qBAAa,cAAe,YAAW,eAAe;IACpD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAS;IAClC,OAAO,CAAC,MAAM,CAAe;IACtB,aAAa,EAAE,aAAa,CAAA;gBAEvB,MAAM,EAAE,aAAa;IAQ3B,OAAO,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC;IAgCzC,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAQpC"}

package/dist/database/index.d.ts

@@ -1,6 +1,8 @@
 export { DatabaseManager } from './manager';
 export { parseSQL, splitSQLStatements } from './sql-parser';
 export type { ParsedStatements, SQLParserOptions } from './sql-parser';
+export { sql, raw, empty, fragment, join, set, where, convertTemplateToQuery } from './sql-template';
+export type { SqlQuery, SqlFragment } from './sql-template';
 export { BunSQLiteAdapter } from './adapters/bun-sqlite';
 export { LibSQLAdapter } from './adapters/libsql';
 export { ODBLiteAdapter } from './adapters/odblite';

package/dist/database/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAG3C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGnD,YAAY,EAEV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,iBAAiB,EAGjB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,aAAa,EAGb,UAAU,GACX,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/database/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAG3C,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGtE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AACpG,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAGnD,YAAY,EAEV,WAAW,EACX,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,iBAAiB,EAGjB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,aAAa,EAGb,UAAU,GACX,MAAM,SAAS,CAAA"}

package/dist/database/sql-template.d.ts

@@ -0,0 +1,432 @@
+/**
+ * SQL Template Tag Converter - postgres.js Compatible
+ *
+ * Provides postgres.js-style SQL template literals and helper methods
+ * for safe, composable SQL query building.
+ *
+ * ## Basic Usage
+ *
+ * ```typescript
+ * import { getConnection, sql } from '@pineliner/odb-client'
+ *
+ * const db = await getConnection('tenant-id')
+ *
+ * // Simple query with parameters
+ * const users = await db`SELECT * FROM users WHERE id = ${userId}`
+ *
+ * // Use sql() helper for dynamic parts
+ * const columns = ['name', 'email', 'age']
+ * const result = await db`SELECT ${sql(columns)} FROM users`
+ * ```
+ *
+ * ## Supported Patterns (postgres.js Compatible)
+ *
+ * ### 1. Query Parameters (Basic Template Literals)
+ * ```typescript
+ * // Parameters are automatically escaped
+ * await db`SELECT * FROM users WHERE name = ${name} AND age > ${age}`
+ * // → SELECT * FROM users WHERE name = ? AND age = ?  [name, age]
+ * ```
+ *
+ * ### 2. Dynamic Column Selection
+ * ```typescript
+ * const columns = ['name', 'age']
+ *
+ * await db`
+ *   SELECT ${sql(columns)}
+ *   FROM users
+ * `
+ * // → SELECT name, age FROM users
+ * ```
+ *
+ * ### 3. Dynamic Inserts (Single Object)
+ * ```typescript
+ * const user = {
+ *   name: 'Murray',
+ *   age: 68
+ * }
+ *
+ * await db`INSERT INTO users ${sql(user, 'name', 'age')}`
+ * // → INSERT INTO users (name, age) VALUES (?, ?)
+ * //   ["Murray", 68]
+ *
+ * // Columns can also be given with an array
+ * const columns = ['name', 'age']
+ * await db`INSERT INTO users ${sql(user, columns)}`
+ * ```
+ *
+ * ### 4. Bulk Inserts (Array of Objects)
+ * ```typescript
+ * const users = [
+ *   { name: 'Murray', age: 68, garbage: 'ignore' },
+ *   { name: 'Walter', age: 80 }
+ * ]
+ *
+ * await db`INSERT INTO users ${sql(users, 'name', 'age')}`
+ * // → INSERT INTO users (name, age) VALUES (?, ?), (?, ?)
+ * //   ["Murray", 68, "Walter", 80]
+ *
+ * // Omit column names to use all object keys
+ * await db`INSERT INTO users ${sql(users)}`
+ * // → INSERT INTO users (name, age, garbage) VALUES (?, ?, ?), (?, ?, ?)
+ * ```
+ *
+ * ### 5. Dynamic Column Updates
+ * ```typescript
+ * const user = {
+ *   id: 1,
+ *   name: 'Murray',
+ *   age: 68
+ * }
+ *
+ * await db`
+ *   UPDATE users
+ *   SET ${set(user, 'name', 'age')}
+ *   WHERE user_id = ${user.id}
+ * `
+ * // → UPDATE users SET name = ?, age = ? WHERE user_id = ?
+ * //   ["Murray", 68, 1]
+ *
+ * // Or using set() helper
+ * await db`
+ *   UPDATE users
+ *   SET ${set({ name: user.name, age: user.age })}
+ *   WHERE user_id = ${user.id}
+ * `
+ * ```
+ *
+ * ### 6. Multiple Updates in One Query
+ * ```typescript
+ * const users = [
+ *   [1, 'John', 34],
+ *   [2, 'Jane', 27],
+ * ]
+ *
+ * await db`
+ *   UPDATE users
+ *   SET name = update_data.name, age = (update_data.age)::int
+ *   FROM (VALUES ${sql(users)}) AS update_data (id, name, age)
+ *   WHERE users.id = (update_data.id)::int
+ *   RETURNING users.id, users.name, users.age
+ * `
+ * // → UPDATE users SET ... FROM (VALUES (?, ?, ?), (?, ?, ?)) AS update_data ...
+ * //   [1, "John", 34, 2, "Jane", 27]
+ * ```
+ *
+ * ### 7. Dynamic WHERE IN Clause
+ * ```typescript
+ * const users = await db`
+ *   SELECT *
+ *   FROM users
+ *   WHERE age IN ${sql([68, 75, 23])}
+ * `
+ * // → SELECT * FROM users WHERE age IN (?, ?, ?)
+ * //   [68, 75, 23]
+ *
+ * // Or use array directly in template
+ * await db`SELECT * FROM users WHERE age IN ${[68, 75, 23]}`
+ * ```
+ *
+ * ### 8. Dynamic Values in SELECT
+ * ```typescript
+ * const [{ a, b, c }] = await db`
+ *   SELECT *
+ *   FROM (VALUES ${sql(['a', 'b', 'c'])}) AS x(a, b, c)
+ * `
+ * // Note: For VALUES with string literals, use the array directly or wrap in sql()
+ * ```
+ *
+ * ### 9. Conditional Fragments
+ * ```typescript
+ * const isAdmin = true
+ * const minAge = 25
+ *
+ * await db`
+ *   SELECT * FROM users
+ *   WHERE is_active = 1
+ *   ${isAdmin ? fragment`AND role = 'admin'` : empty()}
+ *   ${minAge ? fragment`AND age >= ${minAge}` : empty()}
+ * `
+ * // → SELECT * FROM users WHERE is_active = 1 AND role = 'admin' AND age >= ?
+ * //   [25]
+ * ```
+ *
+ * ### 10. Transactions
+ * ```typescript
+ * await db.begin(async tx => {
+ *   await tx`INSERT INTO users ${sql(user, 'name', 'email')}`
+ *   await tx`UPDATE accounts SET balance = balance - ${amount} WHERE user_id = ${userId}`
+ * })
+ * // Automatically commits on success, rolls back on error
+ * ```
+ *
+ * ### 11. Raw SQL (use with caution)
+ * ```typescript
+ * const tableName = 'users'  // From trusted source only!
+ * await db`SELECT * FROM ${raw(tableName)} WHERE id = ${userId}`
+ * // → SELECT * FROM users WHERE id = ?
+ * //   [userId]
+ * ```
+ *
+ * ### 12. Reusable Fragments
+ * ```typescript
+ * const activeUsers = fragment`is_active = 1 AND is_deleted = 0`
+ * const olderThan = (age: number) => fragment`age > ${age}`
+ *
+ * await db`
+ *   SELECT * FROM users
+ *   WHERE ${activeUsers}
+ *   AND ${olderThan(25)}
+ * `
+ * ```
+ *
+ * ## API Reference
+ *
+ * - `sql(columns: string[])` - Dynamic column list for SELECT
+ * - `sql(object, ...keys)` - INSERT format from single object
+ * - `sql(objects[], ...keys)` - Bulk INSERT from array of objects
+ * - `sql(array[][])` - Bulk insert values (2D array)
+ * - `fragment` `` ` - Template tag for reusable query fragments
+ * - `raw(string)` - Unescaped SQL fragment (dangerous!)
+ * - `empty()` - Empty SQL fragment for conditionals
+ * - `set(object)` - Generate SET clause for UPDATE
+ * - `where(object)` - Generate WHERE clause with AND conditions
+ * - `join(fragments[], separator)` - Combine multiple fragments
+ */
+export interface SqlQuery {
+    sql: string;
+    args: any[];
+}
+export interface SqlFragment {
+    _isSqlFragment: true;
+    sql: string;
+    args: any[];
+}
+/**
+ * Convert template literal to parameterized query
+ *
+ * @param strings - Template literal strings
+ * @param values - Template literal values
+ * @returns Object with sql string and args array
+ *
+ * @example
+ * ```typescript
+ * const query = convertTemplateToQuery(
+ *   ['SELECT * FROM users WHERE id = ', ' AND name = ', ''],
+ *   [userId, userName]
+ * )
+ * // → { sql: "SELECT * FROM users WHERE id = ? AND name = ?", args: [userId, userName] }
+ * ```
+ */
+export declare function convertTemplateToQuery(strings: TemplateStringsArray, values: any[]): SqlQuery;
+/**
+ * sql() helper - postgres.js compatible
+ *
+ * Multi-purpose SQL helper that adapts based on arguments.
+ *
+ * @param value - Array, object, array of objects, or 2D array
+ * @param keys - Optional keys (string[] or ...string)
+ * @returns SQL fragment
+ *
+ * @example Dynamic column selection
+ * ```typescript
+ * sql(['name', 'email', 'age'])
+ * // → "name, email, age"
+ * ```
+ *
+ * @example Single object INSERT
+ * ```typescript
+ * sql({ name: 'John', age: 30 }, 'name', 'age')
+ * // → "(name, age) VALUES (?, ?)" with args ["John", 30]
+ * ```
+ *
+ * @example Single object UPDATE
+ * ```typescript
+ * sql({ name: 'John', age: 30 }, 'name', 'age')
+ * // Context determines if INSERT or UPDATE format
+ * // For UPDATE: "name" = ?, "age" = ? with args ["John", 30]
+ * // For INSERT: (name, age) VALUES (?, ?) with args ["John", 30]
+ * ```
+ *
+ * @example Array of objects (bulk insert)
+ * ```typescript
+ * sql([{ name: 'John', age: 30 }, { name: 'Jane', age: 25 }], 'name', 'age')
+ * // → "(name, age) VALUES (?, ?), (?, ?)" with args ["John", 30, "Jane", 25]
+ * ```
+ *
+ * @example 2D array (bulk insert values)
+ * ```typescript
+ * sql([[1, 'John'], [2, 'Jane']])
+ * // → "(?, ?), (?, ?)" with args [1, "John", 2, "Jane"]
+ * ```
+ *
+ * @example VALUES clause
+ * ```typescript
+ * sql(['a', 'b', 'c'])
+ * // In SELECT context: "a, b, c"
+ * // In VALUES context: You'd use the array directly in template
+ * ```
+ */
+export declare function sql(value: any, ...keys: (string | string[])[]): SqlFragment;
+/**
+ * Create an empty SQL fragment
+ *
+ * Useful for conditional queries where you want to add nothing.
+ *
+ * @returns Empty SQL fragment
+ *
+ * @example
+ * ```typescript
+ * const isFiltered = false
+ * await db`
+ *   SELECT * FROM users
+ *   WHERE is_active = 1
+ *   ${isFiltered ? sql`AND age > 25` : empty()}
+ * `
+ * ```
+ */
+export declare function empty(): SqlFragment;
+/**
+ * Create a raw SQL fragment (use with extreme caution!)
+ *
+ * This bypasses parameterization and inserts the string directly into SQL.
+ * **WARNING**: Can lead to SQL injection if used with untrusted input!
+ *
+ * Only use for:
+ * - Table/column names from trusted sources
+ * - SQL keywords or operators
+ * - Pre-validated identifiers
+ *
+ * @param value - Raw SQL string (must be from trusted source)
+ * @returns SQL fragment with no parameters
+ *
+ * @example Safe usage (trusted table name)
+ * ```typescript
+ * const tableName = 'users'  // From config, not user input!
+ * await db`SELECT * FROM ${raw(tableName)} WHERE id = ${userId}`
+ * ```
+ *
+ * @example UNSAFE - Never do this!
+ * ```typescript
+ * // ❌ DANGEROUS - SQL injection vulnerability!
+ * const userInput = req.query.table  // From user!
+ * await db`SELECT * FROM ${raw(userInput)}`  // Don't do this!
+ * ```
+ */
+export declare function raw(value: string): SqlFragment;
+/**
+ * Create a reusable SQL fragment from template literal
+ *
+ * Useful for building composable query parts that can be reused.
+ *
+ * @param strings - Template literal strings
+ * @param values - Template literal values
+ * @returns SQL fragment that can be embedded in other queries
+ *
+ * @example Basic fragment
+ * ```typescript
+ * const activeUsers = fragment`is_active = 1 AND is_deleted = 0`
+ *
+ * await db`SELECT * FROM users WHERE ${activeUsers}`
+ * await db`SELECT COUNT(*) FROM users WHERE ${activeUsers}`
+ * ```
+ *
+ * @example Parameterized fragment
+ * ```typescript
+ * const olderThan = (age: number) => fragment`age > ${age}`
+ * const youngerThan = (age: number) => fragment`age < ${age}`
+ *
+ * await db`
+ *   SELECT * FROM users
+ *   WHERE ${olderThan(25)} AND ${youngerThan(65)}
+ * `
+ * ```
+ *
+ * @example Complex reusable conditions
+ * ```typescript
+ * const validUser = fragment`
+ *   is_active = 1
+ *   AND is_deleted = 0
+ *   AND is_verified = 1
+ *   AND banned_at IS NULL
+ * `
+ *
+ * const adminUser = fragment`${validUser} AND role = 'admin'`
+ *
+ * await db`SELECT * FROM users WHERE ${adminUser}`
+ * ```
+ */
+export declare function fragment(strings: TemplateStringsArray, ...values: any[]): SqlFragment;
+/**
+ * Combine multiple SQL fragments
+ *
+ * @param fragments - Array of SQL fragments
+ * @param separator - Optional separator (default: ', ')
+ * @returns Combined SQL fragment
+ *
+ * @example
+ * ```typescript
+ * const conditions = [
+ *   sql`age > ${25}`,
+ *   sql`country = ${'US'}`,
+ *   sql`is_active = 1`
+ * ]
+ *
+ * await db`
+ *   SELECT * FROM users
+ *   WHERE ${join(conditions, ' AND ')}
+ * `
+ * ```
+ */
+export declare function join(fragments: SqlFragment[], separator?: string): SqlFragment;
+/**
+ * Create SET clause for UPDATE queries
+ *
+ * @param data - Object with column: value pairs
+ * @param keys - Optional array of keys to include (filters the object)
+ * @returns SQL fragment for SET clause
+ *
+ * @example All keys
+ * ```typescript
+ * const updates = { name: 'John Doe', age: 31, updated_at: new Date() }
+ *
+ * await db`
+ *   UPDATE users
+ *   SET ${set(updates)}
+ *   WHERE id = ${userId}
+ * `
+ * // → UPDATE users SET name = ?, age = ?, updated_at = ? WHERE id = ?
+ * ```
+ *
+ * @example Specific keys only
+ * ```typescript
+ * const user = { id: 1, name: 'Murray', age: 68 }
+ *
+ * await db`
+ *   UPDATE users
+ *   SET ${set(user, 'name', 'age')}
+ *   WHERE user_id = ${user.id}
+ * `
+ * // → UPDATE users SET name = ?, age = ? WHERE user_id = ?
+ * ```
+ */
+export declare function set(data: Record<string, any>, ...keys: string[]): SqlFragment;
+/**
+ * Create WHERE clause from object (AND conditions)
+ *
+ * @param conditions - Object with column: value pairs
+ * @returns SQL fragment for WHERE clause
+ *
+ * @example
+ * ```typescript
+ * const filters = { is_active: 1, role: 'admin', age: 30 }
+ *
+ * await db`
+ *   SELECT * FROM users
+ *   WHERE ${where(filters)}
+ * `
+ * // → SELECT * FROM users WHERE is_active = ? AND role = ? AND age = ?
+ * ```
+ */
+export declare function where(conditions: Record<string, any>): SqlFragment;
+//# sourceMappingURL=sql-template.d.ts.map

package/dist/database/sql-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-template.d.ts","sourceRoot":"","sources":["../../src/database/sql-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkMG;AAEH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,GAAG,EAAE,CAAA;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,IAAI,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,GAAG,EAAE,CAAA;CACZ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,MAAM,EAAE,GAAG,EAAE,GACZ,QAAQ,CAyCV;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,GAAG,CACjB,KAAK,EAAE,GAAG,EACV,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,GAC7B,WAAW,CA2Fb;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,IAAI,WAAW,CAMnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAM9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,oBAAoB,EAC7B,GAAG,MAAM,EAAE,GAAG,EAAE,GACf,WAAW,CAMb;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,SAAS,GAAE,MAAa,GAAG,WAAW,CAapF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,GAAG,CACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACzB,GAAG,IAAI,EAAE,MAAM,EAAE,GAChB,WAAW,CAuBb;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,CAclE"}

package/dist/database/sql-template.examples.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SQL Template Examples - postgres.js Compatible Usage
+ *
+ * This file demonstrates all supported postgres.js patterns with our sql-template implementation.
+ * These examples show the exact usage from postgres.js documentation.
+ *
+ * NOTE: This file is for documentation only - not included in build
+ * @file sql-template.examples.ts
+ */
+export {};
+/**
+ * All examples demonstrate postgres.js-compatible patterns:
+ *
+ * ✅ Template literals with automatic parameterization
+ * ✅ sql(columns[]) for dynamic column selection
+ * ✅ sql(object, ...keys) for INSERT statements
+ * ✅ sql(objects[], ...keys) for bulk INSERT
+ * ✅ sql(array[][]) for VALUES clause
+ * ✅ Array values for IN clauses
+ * ✅ set(object, ...keys) for UPDATE SET clauses
+ * ✅ where(object) for WHERE conditions
+ * ✅ fragment`` for reusable query parts
+ * ✅ empty() for conditional fragments
+ * ✅ raw() for unescaped SQL (use carefully!)
+ * ✅ join(fragments[], separator) for combining fragments
+ * ✅ Transactions with begin()
+ */
+//# sourceMappingURL=sql-template.examples.d.ts.map

package/dist/database/sql-template.examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-template.examples.d.ts","sourceRoot":"","sources":["../../src/database/sql-template.examples.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;;AAkVH;;;;;;;;;;;;;;;;GAgBG"}

package/dist/database/types.d.ts

@@ -17,9 +17,15 @@ export interface QueryResult<T = any> {
 /**
  * Unified database connection interface
  * All backends implement this through adapters
+ *
+ * postgres.js-compatible API:
+ * - sql`...` returns rows array directly (not QueryResult)
+ * - sql() can be called as helper function for fragments
+ * - sql.empty(), sql.raw(), etc. are available as helper methods
  */
 export interface Connection {
-    sql<T = any>(strings: TemplateStringsArray, ...values: any[]): Promise<QueryResult<T>>;
+    sql<T = any>(strings: TemplateStringsArray, ...values: any[]): Promise<T[]>;
+    sql(value: any, ...keys: string[]): any;
     query<T = any>(sql: string, params?: any[]): Promise<QueryResult<T>>;
     execute(sql: string | {
         sql: string;
@@ -29,6 +35,7 @@ export interface Connection {
     transaction<T>(fn: (tx: Connection) => Promise<T>): Promise<T>;
     begin<T>(fn: (tx: Connection) => Promise<T>): Promise<T>;
     close(): Promise<void>;
+    createORM?(): any;
     databaseHash?: string;
     databaseName?: string;
 }

package/dist/database/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/database/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/database/types.ts"],"names":[],"mappings":"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"}